Qsphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextChinese (Simplified)}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget>/translations/zh_CN/userspace-api/media/v4l/ext-ctrls-rf-tunermodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget>/translations/zh_TW/userspace-api/media/v4l/ext-ctrls-rf-tunermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget>/translations/it_IT/userspace-api/media/v4l/ext-ctrls-rf-tunermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget>/translations/ja_JP/userspace-api/media/v4l/ext-ctrls-rf-tunermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget>/translations/ko_KR/userspace-api/media/v4l/ext-ctrls-rf-tunermodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget>/translations/sp_SP/userspace-api/media/v4l/ext-ctrls-rf-tunermodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageEnglishuh1h hh _documenthsourceNlineNubhcomment)}(h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-laterh]h8SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhX/var/lib/git/docbuild/linux/Documentation/userspace-api/media/v4l/ext-ctrls-rf-tuner.rsthKubhtarget)}(h.. _rf-tuner-controls:h]h}(h]h ]h"]h$]h&]refidrf-tuner-controlsuh1hhKhhhhhhubhsection)}(hhh](htitle)}(hRF Tuner Control Referenceh]hRF Tuner Control Reference}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh paragraph)}(h_The RF Tuner (RF_TUNER) class includes controls for common features of devices having RF tuner.h]h_The RF Tuner (RF_TUNER) class includes controls for common features of devices having RF tuner.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hXPIn this context, RF tuner is radio receiver circuit between antenna and demodulator. It receives radio frequency (RF) from the antenna and converts that received signal to lower intermediate frequency (IF) or baseband frequency (BB). Tuners that could do baseband output are often called Zero-IF tuners. Older tuners were typically simple PLL tuners inside a metal box, while newer ones are highly integrated chips without a metal box "silicon tuners". These controls are mostly applicable for new feature rich silicon tuners, just because older tuners does not have much adjustable features.h]hXTIn this context, RF tuner is radio receiver circuit between antenna and demodulator. It receives radio frequency (RF) from the antenna and converts that received signal to lower intermediate frequency (IF) or baseband frequency (BB). Tuners that could do baseband output are often called Zero-IF tuners. Older tuners were typically simple PLL tuners inside a metal box, while newer ones are highly integrated chips without a metal box “silicon tuners”. These controls are mostly applicable for new feature rich silicon tuners, just because older tuners does not have much adjustable features.}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh)}(hFor more information about RF tuners see `Tuner (radio) `__ and `RF front end `__ from Wikipedia.h](h)For more information about RF tuners see }(hhhhhNhNubh reference)}(hB`Tuner (radio) `__h]h Tuner (radio)}(hhhhhNhNubah}(h]h ]h"]h$]h&]name Tuner (radio)refuri.http://en.wikipedia.org/wiki/Tuner_%28radio%29uh1hhhubh and }(hhhhhNhNubh)}(h<`RF front end `__h]h RF front end}(hjhhhNhNubah}(h]h ]h"]h$]h&]name RF front endj)http://en.wikipedia.org/wiki/RF_front_enduh1hhhubh from Wikipedia.}(hhhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h.. _rf-tuner-control-id:h]h}(h]h ]h"]h$]h&]hrf-tuner-control-iduh1hhKhhhhhhubh)}(hhh](h)}(hRF_TUNER Control IDsh]hRF_TUNER Control IDs}(hj>hhhNhNubah}(h]h ]h"]h$]h&]uh1hhj;hhhhhKubhdefinition_list)}(hhh](hdefinition_list_item)}(h``V4L2_CID_RF_TUNER_CLASS (class)`` The RF_TUNER class descriptor. Calling :ref:`VIDIOC_QUERYCTRL` for this control will return a description of this control class. h](hterm)}(h#``V4L2_CID_RF_TUNER_CLASS (class)``h]hliteral)}(hj[h]hV4L2_CID_RF_TUNER_CLASS (class)}(hj_hhhNhNubah}(h]h ]h"]h$]h&]uh1j]hjYubah}(h]h ]h"]h$]h&]uh1jWhhhK$hjSubh definition)}(hhh]h)}(hThe RF_TUNER class descriptor. Calling :ref:`VIDIOC_QUERYCTRL` for this control will return a description of this control class.h](h'The RF_TUNER class descriptor. Calling }(hjwhhhNhNubh)}(h:ref:`VIDIOC_QUERYCTRL`h]hinline)}(hjh]hVIDIOC_QUERYCTRL}(hjhhhNhNubah}(h]h ](xrefstdstd-refeh"]h$]h&]uh1jhjubah}(h]h ]h"]h$]h&]refdoc*userspace-api/media/v4l/ext-ctrls-rf-tuner refdomainjreftyperef refexplicitrefwarn reftargetvidioc_queryctrluh1hhhhK"hjwubhB for this control will return a description of this control class.}(hjwhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhK"hjtubah}(h]h ]h"]h$]h&]uh1jrhjSubeh}(h]h ]h"]h$]h&]uh1jQhhhK$hjNubjR)}(h``V4L2_CID_RF_TUNER_BANDWIDTH_AUTO (boolean)`` Enables/disables tuner radio channel bandwidth configuration. In automatic mode bandwidth configuration is performed by the driver. h](jX)}(h.``V4L2_CID_RF_TUNER_BANDWIDTH_AUTO (boolean)``h]j^)}(hjh]h*V4L2_CID_RF_TUNER_BANDWIDTH_AUTO (boolean)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j]hjubah}(h]h ]h"]h$]h&]uh1jWhhhK(hjubjs)}(hhh]h)}(hEnables/disables tuner radio channel bandwidth configuration. In automatic mode bandwidth configuration is performed by the driver.h]hEnables/disables tuner radio channel bandwidth configuration. In automatic mode bandwidth configuration is performed by the driver.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK'hjubah}(h]h ]h"]h$]h&]uh1jrhjubeh}(h]h ]h"]h$]h&]uh1jQhhhK(hjNhhubjR)}(hX9``V4L2_CID_RF_TUNER_BANDWIDTH (integer)`` Filter(s) on tuner signal path are used to filter signal according to receiving party needs. Driver configures filters to fulfill desired bandwidth requirement. Used when V4L2_CID_RF_TUNER_BANDWIDTH_AUTO is not set. Unit is in Hz. The range and step are driver-specific. h](jX)}(h)``V4L2_CID_RF_TUNER_BANDWIDTH (integer)``h]j^)}(hjh]h%V4L2_CID_RF_TUNER_BANDWIDTH (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j]hjubah}(h]h ]h"]h$]h&]uh1jWhhhK/hjubjs)}(hhh]h)}(hXFilter(s) on tuner signal path are used to filter signal according to receiving party needs. Driver configures filters to fulfill desired bandwidth requirement. Used when V4L2_CID_RF_TUNER_BANDWIDTH_AUTO is not set. Unit is in Hz. The range and step are driver-specific.h]hXFilter(s) on tuner signal path are used to filter signal according to receiving party needs. Driver configures filters to fulfill desired bandwidth requirement. Used when V4L2_CID_RF_TUNER_BANDWIDTH_AUTO is not set. Unit is in Hz. The range and step are driver-specific.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK+hj ubah}(h]h ]h"]h$]h&]uh1jrhjubeh}(h]h ]h"]h$]h&]uh1jQhhhK/hjNhhubjR)}(h```V4L2_CID_RF_TUNER_LNA_GAIN_AUTO (boolean)`` Enables/disables LNA automatic gain control (AGC) h](jX)}(h-``V4L2_CID_RF_TUNER_LNA_GAIN_AUTO (boolean)``h]j^)}(hj0h]h)V4L2_CID_RF_TUNER_LNA_GAIN_AUTO (boolean)}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1j]hj.ubah}(h]h ]h"]h$]h&]uh1jWhhhK2hj*ubjs)}(hhh]h)}(h1Enables/disables LNA automatic gain control (AGC)h]h1Enables/disables LNA automatic gain control (AGC)}(hjHhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK2hjEubah}(h]h ]h"]h$]h&]uh1jrhj*ubeh}(h]h ]h"]h$]h&]uh1jQhhhK2hjNhhubjR)}(hd``V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO (boolean)`` Enables/disables mixer automatic gain control (AGC) h](jX)}(h/``V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO (boolean)``h]j^)}(hjhh]h+V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO (boolean)}(hjjhhhNhNubah}(h]h ]h"]h$]h&]uh1j]hjfubah}(h]h ]h"]h$]h&]uh1jWhhhK5hjbubjs)}(hhh]h)}(h3Enables/disables mixer automatic gain control (AGC)h]h3Enables/disables mixer automatic gain control (AGC)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK5hj}ubah}(h]h ]h"]h$]h&]uh1jrhjbubeh}(h]h ]h"]h$]h&]uh1jQhhhK5hjNhhubjR)}(h^``V4L2_CID_RF_TUNER_IF_GAIN_AUTO (boolean)`` Enables/disables IF automatic gain control (AGC) h](jX)}(h,``V4L2_CID_RF_TUNER_IF_GAIN_AUTO (boolean)``h]j^)}(hjh]h(V4L2_CID_RF_TUNER_IF_GAIN_AUTO (boolean)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j]hjubah}(h]h ]h"]h$]h&]uh1jWhhhK8hjubjs)}(hhh]h)}(h0Enables/disables IF automatic gain control (AGC)h]h0Enables/disables IF automatic gain control (AGC)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK8hjubah}(h]h ]h"]h$]h&]uh1jrhjubeh}(h]h ]h"]h$]h&]uh1jQhhhK8hjNhhubjR)}(hX``V4L2_CID_RF_TUNER_RF_GAIN (integer)`` The RF amplifier is the very first amplifier on the receiver signal path, just right after the antenna input. The difference between the LNA gain and the RF gain in this document is that the LNA gain is integrated in the tuner chip while the RF gain is a separate chip. There may be both RF and LNA gain controls in the same device. The range and step are driver-specific. h](jX)}(h'``V4L2_CID_RF_TUNER_RF_GAIN (integer)``h]j^)}(hjh]h#V4L2_CID_RF_TUNER_RF_GAIN (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j]hjubah}(h]h ]h"]h$]h&]uh1jWhhhK@hjubjs)}(hhh]h)}(hXtThe RF amplifier is the very first amplifier on the receiver signal path, just right after the antenna input. The difference between the LNA gain and the RF gain in this document is that the LNA gain is integrated in the tuner chip while the RF gain is a separate chip. There may be both RF and LNA gain controls in the same device. The range and step are driver-specific.h]hXtThe RF amplifier is the very first amplifier on the receiver signal path, just right after the antenna input. The difference between the LNA gain and the RF gain in this document is that the LNA gain is integrated in the tuner chip while the RF gain is a separate chip. There may be both RF and LNA gain controls in the same device. The range and step are driver-specific.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK;hjubah}(h]h ]h"]h$]h&]uh1jrhjubeh}(h]h ]h"]h$]h&]uh1jQhhhK@hjNhhubjR)}(hXs``V4L2_CID_RF_TUNER_LNA_GAIN (integer)`` LNA (low noise amplifier) gain is first gain stage on the RF tuner signal path. It is located very close to tuner antenna input. Used when ``V4L2_CID_RF_TUNER_LNA_GAIN_AUTO`` is not set. See ``V4L2_CID_RF_TUNER_RF_GAIN`` to understand how RF gain and LNA gain differs from the each others. The range and step are driver-specific. h](jX)}(h(``V4L2_CID_RF_TUNER_LNA_GAIN (integer)``h]j^)}(hjh]h$V4L2_CID_RF_TUNER_LNA_GAIN (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j]hjubah}(h]h ]h"]h$]h&]uh1jWhhhKHhj ubjs)}(hhh]h)}(hXILNA (low noise amplifier) gain is first gain stage on the RF tuner signal path. It is located very close to tuner antenna input. Used when ``V4L2_CID_RF_TUNER_LNA_GAIN_AUTO`` is not set. See ``V4L2_CID_RF_TUNER_RF_GAIN`` to understand how RF gain and LNA gain differs from the each others. The range and step are driver-specific.h](hLNA (low noise amplifier) gain is first gain stage on the RF tuner signal path. It is located very close to tuner antenna input. Used when }(hj(hhhNhNubj^)}(h#``V4L2_CID_RF_TUNER_LNA_GAIN_AUTO``h]hV4L2_CID_RF_TUNER_LNA_GAIN_AUTO}(hj0hhhNhNubah}(h]h ]h"]h$]h&]uh1j]hj(ubh is not set. See }(hj(hhhNhNubj^)}(h``V4L2_CID_RF_TUNER_RF_GAIN``h]hV4L2_CID_RF_TUNER_RF_GAIN}(hjBhhhNhNubah}(h]h ]h"]h$]h&]uh1j]hj(ubhm to understand how RF gain and LNA gain differs from the each others. The range and step are driver-specific.}(hj(hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKChj%ubah}(h]h ]h"]h$]h&]uh1jrhj ubeh}(h]h ]h"]h$]h&]uh1jQhhhKHhjNhhubjR)}(hX``V4L2_CID_RF_TUNER_MIXER_GAIN (integer)`` Mixer gain is second gain stage on the RF tuner signal path. It is located inside mixer block, where RF signal is down-converted by the mixer. Used when ``V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO`` is not set. The range and step are driver-specific. h](jX)}(h*``V4L2_CID_RF_TUNER_MIXER_GAIN (integer)``h]j^)}(hjlh]h&V4L2_CID_RF_TUNER_MIXER_GAIN (integer)}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1j]hjjubah}(h]h ]h"]h$]h&]uh1jWhhhKNhjfubjs)}(hhh]h)}(hMixer gain is second gain stage on the RF tuner signal path. It is located inside mixer block, where RF signal is down-converted by the mixer. Used when ``V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO`` is not set. The range and step are driver-specific.h](hMixer gain is second gain stage on the RF tuner signal path. It is located inside mixer block, where RF signal is down-converted by the mixer. Used when }(hjhhhNhNubj^)}(h%``V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO``h]h!V4L2_CID_RF_TUNER_MIXER_GAIN_AUTO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j]hjubh4 is not set. The range and step are driver-specific.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKKhjubah}(h]h ]h"]h$]h&]uh1jrhjfubeh}(h]h ]h"]h$]h&]uh1jQhhhKNhjNhhubjR)}(hX4``V4L2_CID_RF_TUNER_IF_GAIN (integer)`` IF gain is last gain stage on the RF tuner signal path. It is located on output of RF tuner. It controls signal level of intermediate frequency output or baseband output. Used when ``V4L2_CID_RF_TUNER_IF_GAIN_AUTO`` is not set. The range and step are driver-specific. h](jX)}(h'``V4L2_CID_RF_TUNER_IF_GAIN (integer)``h]j^)}(hjh]h#V4L2_CID_RF_TUNER_IF_GAIN (integer)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j]hjubah}(h]h ]h"]h$]h&]uh1jWhhhKUhjubjs)}(hhh]h)}(hX IF gain is last gain stage on the RF tuner signal path. It is located on output of RF tuner. It controls signal level of intermediate frequency output or baseband output. Used when ``V4L2_CID_RF_TUNER_IF_GAIN_AUTO`` is not set. The range and step are driver-specific.h](hIF gain is last gain stage on the RF tuner signal path. It is located on output of RF tuner. It controls signal level of intermediate frequency output or baseband output. Used when }(hjhhhNhNubj^)}(h"``V4L2_CID_RF_TUNER_IF_GAIN_AUTO``h]hV4L2_CID_RF_TUNER_IF_GAIN_AUTO}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j]hjubh4 is not set. The range and step are driver-specific.}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKQhjubah}(h]h ]h"]h$]h&]uh1jrhjubeh}(h]h ]h"]h$]h&]uh1jQhhhKUhjNhhubjR)}(h``V4L2_CID_RF_TUNER_PLL_LOCK (boolean)`` Is synthesizer PLL locked? RF tuner is receiving given frequency when that control is set. This is a read-only control.h](jX)}(h(``V4L2_CID_RF_TUNER_PLL_LOCK (boolean)``h]j^)}(hjh]h$V4L2_CID_RF_TUNER_PLL_LOCK (boolean)}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j]hjubah}(h]h ]h"]h$]h&]uh1jWhhhKXhjubjs)}(hhh]h)}(hwIs synthesizer PLL locked? RF tuner is receiving given frequency when that control is set. This is a read-only control.h]hwIs synthesizer PLL locked? RF tuner is receiving given frequency when that control is set. This is a read-only control.}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKXhjubah}(h]h ]h"]h$]h&]uh1jrhjubeh}(h]h ]h"]h$]h&]uh1jQhhhKXhjNhhubeh}(h]h ]h"]h$]h&]uh1jLhj;hhhhhNubeh}(h](rf-tuner-control-idsj:eh ]h"](rf_tuner control idsrf-tuner-control-ideh$]h&]uh1hhhhhhhhKexpect_referenced_by_name}j>j0sexpect_referenced_by_id}j:j0subeh}(h](rf-tuner-control-referenceheh ]h"](rf tuner control referencerf-tuner-controlseh$]h&]uh1hhhhhhhhKjA}jKhsjC}hhsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(hN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerjserror_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}(h]haj:]j0aunameids}(jKhjJjGj>j:j=j:u nametypes}(jKjJj>j=uh}(hhjGhj:j;j:j;u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}Rparse_messages]transform_messages](hsystem_message)}(hhh]h)}(hhh]h7Hyperlink target "rf-tuner-controls" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOsourcehlineKuh1jubj)}(hhh]h)}(hhh]h9Hyperlink target "rf-tuner-control-id" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypejsourcehlineKuh1jube transformerN include_log] decorationNhhub.