1<title>DVB Frontend API</title> 2 3<para>The DVB frontend device controls the tuner and DVB demodulator 4hardware. It can be accessed through <emphasis 5role="tt">/dev/dvb/adapter0/frontend0</emphasis>. Data types and and 6ioctl definitions can be accessed by including <emphasis 7role="tt">linux/dvb/frontend.h</emphasis> in your application.</para> 8 9<para>DVB frontends come in three varieties: DVB-S (satellite), DVB-C 10(cable) and DVB-T (terrestrial). Transmission via the internet (DVB-IP) 11is not yet handled by this API but a future extension is possible. For 12DVB-S the frontend device also supports satellite equipment control 13(SEC) via DiSEqC and V-SEC protocols. The DiSEqC (digital SEC) 14specification is available from 15<ulink url="http://www.eutelsat.com/satellites/4_5_5.html">Eutelsat</ulink>.</para> 16 17<para>Note that the DVB API may also be used for MPEG decoder-only PCI 18cards, in which case there exists no frontend device.</para> 19 20<section id="frontend_types"> 21<title>Frontend Data Types</title> 22 23<section id="fe-type-t"> 24<title>Frontend type</title> 25 26<para>For historical reasons, frontend types are named by the type of modulation used in 27transmission. The fontend types are given by fe_type_t type, defined as:</para> 28 29<table pgwide="1" frame="none" id="fe-type"> 30<title>Frontend types</title> 31<tgroup cols="3"> 32 &cs-def; 33 <thead> 34 <row> 35 <entry>fe_type</entry> 36 <entry>Description</entry> 37 <entry><link linkend="DTV-DELIVERY-SYSTEM">DTV_DELIVERY_SYSTEM</link> equivalent type</entry> 38 </row> 39 </thead> 40 <tbody valign="top"> 41 <row> 42 <entry id="FE_QPSK"><constant>FE_QPSK</constant></entry> 43 <entry>For DVB-S standard</entry> 44 <entry><constant>SYS_DVBS</constant></entry> 45 </row> 46 <row> 47 <entry id="FE_QAM"><constant>FE_QAM</constant></entry> 48 <entry>For DVB-C annex A standard</entry> 49 <entry><constant>SYS_DVBC_ANNEX_A</constant></entry> 50 </row> 51 <row> 52 <entry id="FE_OFDM"><constant>FE_OFDM</constant></entry> 53 <entry>For DVB-T standard</entry> 54 <entry><constant>SYS_DVBT</constant></entry> 55 </row> 56 <row> 57 <entry id="FE_ATSC"><constant>FE_ATSC</constant></entry> 58 <entry>For ATSC standard (terrestrial) or for DVB-C Annex B (cable) used in US.</entry> 59 <entry><constant>SYS_ATSC</constant> (terrestrial) or <constant>SYS_DVBC_ANNEX_B</constant> (cable)</entry> 60 </row> 61</tbody></tgroup></table> 62 63<para>Newer formats like DVB-S2, ISDB-T, ISDB-S and DVB-T2 are not described at the above, as they're 64supported via the new <link linkend="FE_GET_SET_PROPERTY">FE_GET_PROPERTY/FE_GET_SET_PROPERTY</link> ioctl's, using the <link linkend="DTV-DELIVERY-SYSTEM">DTV_DELIVERY_SYSTEM</link> parameter. 65</para> 66 67<para>The usage of this field is deprecated, as it doesn't report all supported standards, and 68will provide an incomplete information for frontends that support multiple delivery systems. 69Please use <link linkend="DTV-ENUM-DELSYS">DTV_ENUM_DELSYS</link> instead.</para> 70</section> 71 72<section id="fe-caps-t"> 73<title>frontend capabilities</title> 74 75<para>Capabilities describe what a frontend can do. Some capabilities can only be supported for 76a specific frontend type.</para> 77<programlisting> 78 typedef enum fe_caps { 79 FE_IS_STUPID = 0, 80 FE_CAN_INVERSION_AUTO = 0x1, 81 FE_CAN_FEC_1_2 = 0x2, 82 FE_CAN_FEC_2_3 = 0x4, 83 FE_CAN_FEC_3_4 = 0x8, 84 FE_CAN_FEC_4_5 = 0x10, 85 FE_CAN_FEC_5_6 = 0x20, 86 FE_CAN_FEC_6_7 = 0x40, 87 FE_CAN_FEC_7_8 = 0x80, 88 FE_CAN_FEC_8_9 = 0x100, 89 FE_CAN_FEC_AUTO = 0x200, 90 FE_CAN_QPSK = 0x400, 91 FE_CAN_QAM_16 = 0x800, 92 FE_CAN_QAM_32 = 0x1000, 93 FE_CAN_QAM_64 = 0x2000, 94 FE_CAN_QAM_128 = 0x4000, 95 FE_CAN_QAM_256 = 0x8000, 96 FE_CAN_QAM_AUTO = 0x10000, 97 FE_CAN_TRANSMISSION_MODE_AUTO = 0x20000, 98 FE_CAN_BANDWIDTH_AUTO = 0x40000, 99 FE_CAN_GUARD_INTERVAL_AUTO = 0x80000, 100 FE_CAN_HIERARCHY_AUTO = 0x100000, 101 FE_CAN_8VSB = 0x200000, 102 FE_CAN_16VSB = 0x400000, 103 FE_HAS_EXTENDED_CAPS = 0x800000, 104 FE_CAN_MULTISTREAM = 0x4000000, 105 FE_CAN_TURBO_FEC = 0x8000000, 106 FE_CAN_2G_MODULATION = 0x10000000, 107 FE_NEEDS_BENDING = 0x20000000, 108 FE_CAN_RECOVER = 0x40000000, 109 FE_CAN_MUTE_TS = 0x80000000 110 } fe_caps_t; 111</programlisting> 112</section> 113 114<section id="dvb-frontend-info"> 115<title>frontend information</title> 116 117<para>Information about the frontend ca be queried with 118 <link linkend="FE_GET_INFO">FE_GET_INFO</link>.</para> 119 120<programlisting> 121 struct dvb_frontend_info { 122 char name[128]; 123 fe_type_t type; 124 uint32_t frequency_min; 125 uint32_t frequency_max; 126 uint32_t frequency_stepsize; 127 uint32_t frequency_tolerance; 128 uint32_t symbol_rate_min; 129 uint32_t symbol_rate_max; 130 uint32_t symbol_rate_tolerance; /⋆ ppm ⋆/ 131 uint32_t notifier_delay; /⋆ ms ⋆/ 132 fe_caps_t caps; 133 }; 134</programlisting> 135</section> 136 137<section id="dvb-diseqc-master-cmd"> 138<title>diseqc master command</title> 139 140<para>A message sent from the frontend to DiSEqC capable equipment.</para> 141<programlisting> 142 struct dvb_diseqc_master_cmd { 143 uint8_t msg [6]; /⋆ { framing, address, command, data[3] } ⋆/ 144 uint8_t msg_len; /⋆ valid values are 3...6 ⋆/ 145 }; 146</programlisting> 147</section> 148<section role="subsection" id="dvb-diseqc-slave-reply"> 149<title>diseqc slave reply</title> 150 151<para>A reply to the frontend from DiSEqC 2.0 capable equipment.</para> 152<programlisting> 153 struct dvb_diseqc_slave_reply { 154 uint8_t msg [4]; /⋆ { framing, data [3] } ⋆/ 155 uint8_t msg_len; /⋆ valid values are 0...4, 0 means no msg ⋆/ 156 int timeout; /⋆ return from ioctl after timeout ms with ⋆/ 157 }; /⋆ errorcode when no message was received ⋆/ 158</programlisting> 159</section> 160 161<section id="fe-sec-voltage-t"> 162<title>diseqc slave reply</title> 163<para>The voltage is usually used with non-DiSEqC capable LNBs to switch the polarzation 164(horizontal/vertical). When using DiSEqC epuipment this voltage has to be switched 165consistently to the DiSEqC commands as described in the DiSEqC spec.</para> 166<programlisting> 167 typedef enum fe_sec_voltage { 168 SEC_VOLTAGE_13, 169 SEC_VOLTAGE_18 170 } fe_sec_voltage_t; 171</programlisting> 172</section> 173 174<section id="fe-sec-tone-mode-t"> 175<title>SEC continuous tone</title> 176 177<para>The continuous 22KHz tone is usually used with non-DiSEqC capable LNBs to switch the 178high/low band of a dual-band LNB. When using DiSEqC epuipment this voltage has to 179be switched consistently to the DiSEqC commands as described in the DiSEqC 180spec.</para> 181<programlisting> 182 typedef enum fe_sec_tone_mode { 183 SEC_TONE_ON, 184 SEC_TONE_OFF 185 } fe_sec_tone_mode_t; 186</programlisting> 187</section> 188 189<section id="fe-sec-mini-cmd-t"> 190<title>SEC tone burst</title> 191 192<para>The 22KHz tone burst is usually used with non-DiSEqC capable switches to select 193between two connected LNBs/satellites. When using DiSEqC epuipment this voltage has to 194be switched consistently to the DiSEqC commands as described in the DiSEqC 195spec.</para> 196<programlisting> 197 typedef enum fe_sec_mini_cmd { 198 SEC_MINI_A, 199 SEC_MINI_B 200 } fe_sec_mini_cmd_t; 201</programlisting> 202 203<para></para> 204</section> 205 206<section id="fe-status-t"> 207<title>frontend status</title> 208<para>Several functions of the frontend device use the fe_status data type defined 209by</para> 210<programlisting> 211typedef enum fe_status { 212 FE_HAS_SIGNAL = 0x01, 213 FE_HAS_CARRIER = 0x02, 214 FE_HAS_VITERBI = 0x04, 215 FE_HAS_SYNC = 0x08, 216 FE_HAS_LOCK = 0x10, 217 FE_TIMEDOUT = 0x20, 218 FE_REINIT = 0x40, 219} fe_status_t; 220</programlisting> 221<para>to indicate the current state and/or state changes of the frontend hardware: 222</para> 223 224<informaltable><tgroup cols="2"><tbody> 225<row> 226<entry align="char">FE_HAS_SIGNAL</entry> 227<entry align="char">The frontend has found something above the noise level</entry> 228</row><row> 229<entry align="char">FE_HAS_CARRIER</entry> 230<entry align="char">The frontend has found a DVB signal</entry> 231</row><row> 232<entry align="char">FE_HAS_VITERBI</entry> 233<entry align="char">The frontend FEC inner coding (Viterbi, LDPC or other inner code) is stable</entry> 234</row><row> 235<entry align="char">FE_HAS_SYNC</entry> 236<entry align="char">Synchronization bytes was found</entry> 237</row><row> 238<entry align="char">FE_HAS_LOCK</entry> 239<entry align="char">The DVB were locked and everything is working</entry> 240</row><row> 241<entry align="char">FE_TIMEDOUT</entry> 242<entry align="char">no lock within the last about 2 seconds</entry> 243</row><row> 244<entry align="char">FE_REINIT</entry> 245<entry align="char">The frontend was reinitialized, application is 246recommended to reset DiSEqC, tone and parameters</entry> 247</row> 248</tbody></tgroup></informaltable> 249 250</section> 251 252<section id="dvb-frontend-parameters"> 253<title>frontend parameters</title> 254<para>The kind of parameters passed to the frontend device for tuning depend on 255the kind of hardware you are using.</para> 256<para>The struct <constant>dvb_frontend_parameters</constant> uses an 257union with specific per-system parameters. However, as newer delivery systems 258required more data, the structure size weren't enough to fit, and just 259extending its size would break the existing applications. So, those parameters 260were replaced by the usage of <link linkend="FE_GET_SET_PROPERTY"> 261<constant>FE_GET_PROPERTY/FE_SET_PROPERTY</constant></link> ioctl's. The 262new API is flexible enough to add new parameters to existing delivery systems, 263and to add newer delivery systems.</para> 264<para>So, newer applications should use <link linkend="FE_GET_SET_PROPERTY"> 265<constant>FE_GET_PROPERTY/FE_SET_PROPERTY</constant></link> instead, in 266order to be able to support the newer System Delivery like DVB-S2, DVB-T2, 267DVB-C2, ISDB, etc.</para> 268<para>All kinds of parameters are combined as an union in the FrontendParameters structure: 269<programlisting> 270struct dvb_frontend_parameters { 271 uint32_t frequency; /⋆ (absolute) frequency in Hz for QAM/OFDM ⋆/ 272 /⋆ intermediate frequency in kHz for QPSK ⋆/ 273 fe_spectral_inversion_t inversion; 274 union { 275 struct dvb_qpsk_parameters qpsk; 276 struct dvb_qam_parameters qam; 277 struct dvb_ofdm_parameters ofdm; 278 struct dvb_vsb_parameters vsb; 279 } u; 280}; 281</programlisting></para> 282<para>In the case of QPSK frontends the <constant>frequency</constant> field specifies the intermediate 283frequency, i.e. the offset which is effectively added to the local oscillator frequency (LOF) of 284the LNB. The intermediate frequency has to be specified in units of kHz. For QAM and 285OFDM frontends the <constant>frequency</constant> specifies the absolute frequency and is given in Hz. 286</para> 287 288<section id="dvb-qpsk-parameters"> 289<title>QPSK parameters</title> 290<para>For satellite QPSK frontends you have to use the <constant>dvb_qpsk_parameters</constant> structure:</para> 291<programlisting> 292 struct dvb_qpsk_parameters { 293 uint32_t symbol_rate; /⋆ symbol rate in Symbols per second ⋆/ 294 fe_code_rate_t fec_inner; /⋆ forward error correction (see above) ⋆/ 295 }; 296</programlisting> 297</section> 298<section id="dvb-qam-parameters"> 299<title>QAM parameters</title> 300<para>for cable QAM frontend you use the <constant>dvb_qam_parameters</constant> structure:</para> 301<programlisting> 302 struct dvb_qam_parameters { 303 uint32_t symbol_rate; /⋆ symbol rate in Symbols per second ⋆/ 304 fe_code_rate_t fec_inner; /⋆ forward error correction (see above) ⋆/ 305 fe_modulation_t modulation; /⋆ modulation type (see above) ⋆/ 306 }; 307</programlisting> 308</section> 309<section id="dvb-vsb-parameters"> 310<title>VSB parameters</title> 311<para>ATSC frontends are supported by the <constant>dvb_vsb_parameters</constant> structure:</para> 312<programlisting> 313struct dvb_vsb_parameters { 314 fe_modulation_t modulation; /⋆ modulation type (see above) ⋆/ 315}; 316</programlisting> 317</section> 318<section id="dvb-ofdm-parameters"> 319<title>OFDM parameters</title> 320<para>DVB-T frontends are supported by the <constant>dvb_ofdm_parameters</constant> structure:</para> 321<programlisting> 322 struct dvb_ofdm_parameters { 323 fe_bandwidth_t bandwidth; 324 fe_code_rate_t code_rate_HP; /⋆ high priority stream code rate ⋆/ 325 fe_code_rate_t code_rate_LP; /⋆ low priority stream code rate ⋆/ 326 fe_modulation_t constellation; /⋆ modulation type (see above) ⋆/ 327 fe_transmit_mode_t transmission_mode; 328 fe_guard_interval_t guard_interval; 329 fe_hierarchy_t hierarchy_information; 330 }; 331</programlisting> 332</section> 333<section id="fe-spectral-inversion-t"> 334<title>frontend spectral inversion</title> 335<para>The Inversion field can take one of these values: 336</para> 337<programlisting> 338typedef enum fe_spectral_inversion { 339 INVERSION_OFF, 340 INVERSION_ON, 341 INVERSION_AUTO 342} fe_spectral_inversion_t; 343</programlisting> 344<para>It indicates if spectral inversion should be presumed or not. In the automatic setting 345(<constant>INVERSION_AUTO</constant>) the hardware will try to figure out the correct setting by 346itself. 347</para> 348</section> 349<section id="fe-code-rate-t"> 350<title>frontend code rate</title> 351<para>The possible values for the <constant>fec_inner</constant> field used on 352<link linkend="dvb-qpsk-parameters"><constant>struct dvb_qpsk_parameters</constant></link> and 353<link linkend="dvb-qam-parameters"><constant>struct dvb_qam_parameters</constant></link> are: 354</para> 355<programlisting> 356typedef enum fe_code_rate { 357 FEC_NONE = 0, 358 FEC_1_2, 359 FEC_2_3, 360 FEC_3_4, 361 FEC_4_5, 362 FEC_5_6, 363 FEC_6_7, 364 FEC_7_8, 365 FEC_8_9, 366 FEC_AUTO, 367 FEC_3_5, 368 FEC_9_10, 369} fe_code_rate_t; 370</programlisting> 371<para>which correspond to error correction rates of 1/2, 2/3, etc., no error correction or auto 372detection. 373</para> 374</section> 375<section id="fe-modulation-t"> 376<title>frontend modulation type for QAM, OFDM and VSB</title> 377<para>For cable and terrestrial frontends, e. g. for 378<link linkend="dvb-qam-parameters"><constant>struct dvb_qpsk_parameters</constant></link>, 379<link linkend="dvb-ofdm-parameters"><constant>struct dvb_qam_parameters</constant></link> and 380<link linkend="dvb-vsb-parameters"><constant>struct dvb_qam_parameters</constant></link>, 381it needs to specify the quadrature modulation mode which can be one of the following: 382</para> 383<programlisting> 384 typedef enum fe_modulation { 385 QPSK, 386 QAM_16, 387 QAM_32, 388 QAM_64, 389 QAM_128, 390 QAM_256, 391 QAM_AUTO, 392 VSB_8, 393 VSB_16, 394 PSK_8, 395 APSK_16, 396 APSK_32, 397 DQPSK, 398 } fe_modulation_t; 399</programlisting> 400</section> 401<section> 402<title>More OFDM parameters</title> 403<section id="fe-transmit-mode-t"> 404<title>Number of carriers per channel</title> 405<programlisting> 406typedef enum fe_transmit_mode { 407 TRANSMISSION_MODE_2K, 408 TRANSMISSION_MODE_8K, 409 TRANSMISSION_MODE_AUTO, 410 TRANSMISSION_MODE_4K, 411 TRANSMISSION_MODE_1K, 412 TRANSMISSION_MODE_16K, 413 TRANSMISSION_MODE_32K, 414 } fe_transmit_mode_t; 415</programlisting> 416</section> 417<section id="fe-bandwidth-t"> 418<title>frontend bandwidth</title> 419<programlisting> 420typedef enum fe_bandwidth { 421 BANDWIDTH_8_MHZ, 422 BANDWIDTH_7_MHZ, 423 BANDWIDTH_6_MHZ, 424 BANDWIDTH_AUTO, 425 BANDWIDTH_5_MHZ, 426 BANDWIDTH_10_MHZ, 427 BANDWIDTH_1_712_MHZ, 428} fe_bandwidth_t; 429</programlisting> 430</section> 431<section id="fe-guard-interval-t"> 432<title>frontend guard inverval</title> 433<programlisting> 434typedef enum fe_guard_interval { 435 GUARD_INTERVAL_1_32, 436 GUARD_INTERVAL_1_16, 437 GUARD_INTERVAL_1_8, 438 GUARD_INTERVAL_1_4, 439 GUARD_INTERVAL_AUTO, 440 GUARD_INTERVAL_1_128, 441 GUARD_INTERVAL_19_128, 442 GUARD_INTERVAL_19_256, 443} fe_guard_interval_t; 444</programlisting> 445</section> 446<section id="fe-hierarchy-t"> 447<title>frontend hierarchy</title> 448<programlisting> 449typedef enum fe_hierarchy { 450 HIERARCHY_NONE, 451 HIERARCHY_1, 452 HIERARCHY_2, 453 HIERARCHY_4, 454 HIERARCHY_AUTO 455 } fe_hierarchy_t; 456</programlisting> 457</section> 458</section> 459 460</section> 461 462<section id="dvb-frontend-event"> 463<title>frontend events</title> 464 <programlisting> 465 struct dvb_frontend_event { 466 fe_status_t status; 467 struct dvb_frontend_parameters parameters; 468 }; 469</programlisting> 470 </section> 471</section> 472 473 474<section id="frontend_fcalls"> 475<title>Frontend Function Calls</title> 476 477<section id="frontend_f_open"> 478<title>open()</title> 479<para>DESCRIPTION</para> 480<informaltable><tgroup cols="1"><tbody><row> 481<entry align="char"> 482<para>This system call opens a named frontend device (/dev/dvb/adapter0/frontend0) 483 for subsequent use. Usually the first thing to do after a successful open is to 484 find out the frontend type with <link linkend="FE_GET_INFO">FE_GET_INFO</link>.</para> 485<para>The device can be opened in read-only mode, which only allows monitoring of 486 device status and statistics, or read/write mode, which allows any kind of use 487 (e.g. performing tuning operations.) 488</para> 489<para>In a system with multiple front-ends, it is usually the case that multiple devices 490 cannot be open in read/write mode simultaneously. As long as a front-end 491 device is opened in read/write mode, other open() calls in read/write mode will 492 either fail or block, depending on whether non-blocking or blocking mode was 493 specified. A front-end device opened in blocking mode can later be put into 494 non-blocking mode (and vice versa) using the F_SETFL command of the fcntl 495 system call. This is a standard system call, documented in the Linux manual 496 page for fcntl. When an open() call has succeeded, the device will be ready 497 for use in the specified mode. This implies that the corresponding hardware is 498 powered up, and that other front-ends may have been powered down to make 499 that possible.</para> 500</entry> 501 </row></tbody></tgroup></informaltable> 502 503<para>SYNOPSIS</para> 504<informaltable><tgroup cols="1"><tbody><row><entry 505 align="char"> 506<para>int open(const char ⋆deviceName, int flags);</para> 507</entry> 508 </row></tbody></tgroup></informaltable> 509<para>PARAMETERS 510</para> 511<informaltable><tgroup cols="2"><tbody><row><entry 512 align="char"> 513<para>const char 514 *deviceName</para> 515</entry><entry 516 align="char"> 517<para>Name of specific video device.</para> 518</entry> 519 </row><row><entry 520 align="char"> 521<para>int flags</para> 522</entry><entry 523 align="char"> 524<para>A bit-wise OR of the following flags:</para> 525</entry> 526 </row><row><entry 527 align="char"> 528</entry><entry 529 align="char"> 530<para>O_RDONLY read-only access</para> 531</entry> 532 </row><row><entry 533 align="char"> 534</entry><entry 535 align="char"> 536<para>O_RDWR read/write access</para> 537</entry> 538 </row><row><entry 539 align="char"> 540</entry><entry 541 align="char"> 542<para>O_NONBLOCK open in non-blocking mode</para> 543</entry> 544 </row><row><entry 545 align="char"> 546</entry><entry 547 align="char"> 548<para>(blocking mode is the default)</para> 549</entry> 550 </row></tbody></tgroup></informaltable> 551<para>RETURN VALUE</para> 552<informaltable><tgroup cols="2"><tbody><row><entry 553 align="char"> 554<para>ENODEV</para> 555</entry><entry 556 align="char"> 557<para>Device driver not loaded/available.</para> 558</entry> 559 </row><row><entry 560 align="char"> 561<para>EINTERNAL</para> 562</entry><entry 563 align="char"> 564<para>Internal error.</para> 565</entry> 566 </row><row><entry 567 align="char"> 568<para>EBUSY</para> 569</entry><entry 570 align="char"> 571<para>Device or resource busy.</para> 572</entry> 573 </row><row><entry 574 align="char"> 575<para>EINVAL</para> 576</entry><entry 577 align="char"> 578<para>Invalid argument.</para> 579</entry> 580 </row></tbody></tgroup></informaltable> 581</section> 582 583<section id="frontend_f_close"> 584<title>close()</title> 585<para>DESCRIPTION 586</para> 587<informaltable><tgroup cols="1"><tbody><row><entry 588 align="char"> 589<para>This system call closes a previously opened front-end device. After closing 590 a front-end device, its corresponding hardware might be powered down 591 automatically.</para> 592</entry> 593 </row></tbody></tgroup></informaltable> 594<para>SYNOPSIS 595</para> 596<informaltable><tgroup cols="1"><tbody><row><entry 597 align="char"> 598<para>int close(int fd);</para> 599</entry> 600 </row></tbody></tgroup></informaltable> 601<para>PARAMETERS 602</para> 603<informaltable><tgroup cols="2"><tbody><row><entry 604 align="char"> 605<para>int fd</para> 606</entry><entry 607 align="char"> 608<para>File descriptor returned by a previous call to open().</para> 609</entry> 610 </row></tbody></tgroup></informaltable> 611<para>RETURN VALUE</para> 612<informaltable><tgroup cols="2"><tbody><row><entry 613 align="char"> 614<para>EBADF</para> 615</entry><entry 616 align="char"> 617<para>fd is not a valid open file descriptor.</para> 618</entry> 619 </row></tbody></tgroup></informaltable> 620</section> 621 622<section id="FE_READ_STATUS"> 623<title>FE_READ_STATUS</title> 624<para>DESCRIPTION 625</para> 626<informaltable><tgroup cols="1"><tbody><row><entry 627 align="char"> 628<para>This ioctl call returns status information about the front-end. This call only 629 requires read-only access to the device.</para> 630</entry> 631 </row></tbody></tgroup></informaltable> 632<para>SYNOPSIS 633</para> 634<informaltable><tgroup cols="1"><tbody><row><entry 635 align="char"> 636<para>int ioctl(int fd, int request = <link linkend="FE_READ_STATUS">FE_READ_STATUS</link>, 637 fe_status_t ⋆status);</para> 638</entry> 639 </row></tbody></tgroup></informaltable> 640<para>PARAMETERS 641</para> 642 643<informaltable><tgroup cols="2"><tbody><row><entry 644 align="char"> 645<para>int fd</para> 646</entry><entry 647 align="char"> 648<para>File descriptor returned by a previous call to open().</para> 649</entry> 650 </row><row><entry 651 align="char"> 652<para>int request</para> 653</entry><entry 654 align="char"> 655<para>Equals <link linkend="FE_READ_STATUS">FE_READ_STATUS</link> for this command.</para> 656</entry> 657 </row><row><entry 658 align="char"> 659<para>struct fe_status_t 660 *status</para> 661</entry><entry 662 align="char"> 663<para>Points to the location where the front-end status word is 664 to be stored.</para> 665</entry> 666 </row></tbody></tgroup></informaltable> 667<para>RETURN VALUE</para> 668<informaltable><tgroup cols="2"><tbody><row><entry 669 align="char"> 670<para>EBADF</para> 671</entry><entry 672 align="char"> 673<para>fd is not a valid open file descriptor.</para> 674</entry> 675 </row><row><entry 676 align="char"> 677<para>EFAULT</para> 678</entry><entry 679 align="char"> 680<para>status points to invalid address.</para> 681</entry> 682 </row></tbody></tgroup></informaltable> 683</section> 684 685<section id="FE_READ_BER"> 686<title>FE_READ_BER</title> 687<para>DESCRIPTION 688</para> 689<informaltable><tgroup cols="1"><tbody><row><entry 690 align="char"> 691<para>This ioctl call returns the bit error rate for the signal currently 692 received/demodulated by the front-end. For this command, read-only access to 693 the device is sufficient.</para> 694</entry> 695 </row></tbody></tgroup></informaltable> 696<para>SYNOPSIS 697</para> 698<informaltable><tgroup cols="1"><tbody><row><entry 699 align="char"> 700<para>int ioctl(int fd, int request = <link linkend="FE_READ_BER">FE_READ_BER</link>, 701 uint32_t ⋆ber);</para> 702</entry> 703 </row></tbody></tgroup></informaltable> 704<para>PARAMETERS 705</para> 706<informaltable><tgroup cols="2"><tbody><row><entry 707 align="char"> 708<para>int fd</para> 709</entry><entry 710 align="char"> 711<para>File descriptor returned by a previous call to open().</para> 712</entry> 713 </row><row><entry 714 align="char"> 715<para>int request</para> 716</entry><entry 717 align="char"> 718<para>Equals <link linkend="FE_READ_BER">FE_READ_BER</link> for this command.</para> 719</entry> 720 </row><row><entry 721 align="char"> 722<para>uint32_t *ber</para> 723</entry><entry 724 align="char"> 725<para>The bit error rate is stored into *ber.</para> 726</entry> 727 </row></tbody></tgroup></informaltable> 728 729&return-value-dvb; 730</section> 731 732<section id="FE_READ_SNR"> 733<title>FE_READ_SNR</title> 734 735<para>DESCRIPTION 736</para> 737<informaltable><tgroup cols="1"><tbody><row><entry 738 align="char"> 739<para>This ioctl call returns the signal-to-noise ratio for the signal currently received 740 by the front-end. For this command, read-only access to the device is sufficient.</para> 741</entry> 742 </row></tbody></tgroup></informaltable> 743<para>SYNOPSIS 744</para> 745<informaltable><tgroup cols="1"><tbody><row><entry 746 align="char"> 747<para>int ioctl(int fd, int request = <link linkend="FE_READ_SNR">FE_READ_SNR</link>, uint16_t 748 ⋆snr);</para> 749</entry> 750 </row></tbody></tgroup></informaltable> 751<para>PARAMETERS 752</para> 753<informaltable><tgroup cols="2"><tbody><row><entry 754 align="char"> 755<para>int fd</para> 756</entry><entry 757 align="char"> 758<para>File descriptor returned by a previous call to open().</para> 759</entry> 760 </row><row><entry 761 align="char"> 762<para>int request</para> 763</entry><entry 764 align="char"> 765<para>Equals <link linkend="FE_READ_SNR">FE_READ_SNR</link> for this command.</para> 766</entry> 767 </row><row><entry 768 align="char"> 769<para>uint16_t *snr</para> 770</entry><entry 771 align="char"> 772<para>The signal-to-noise ratio is stored into *snr.</para> 773</entry> 774 </row></tbody></tgroup></informaltable> 775 776&return-value-dvb; 777</section> 778 779<section id="FE_READ_SIGNAL_STRENGTH"> 780<title>FE_READ_SIGNAL_STRENGTH</title> 781<para>DESCRIPTION 782</para> 783<informaltable><tgroup cols="1"><tbody><row><entry 784 align="char"> 785<para>This ioctl call returns the signal strength value for the signal currently received 786 by the front-end. For this command, read-only access to the device is sufficient.</para> 787</entry> 788 </row></tbody></tgroup></informaltable> 789<para>SYNOPSIS 790</para> 791<informaltable><tgroup cols="1"><tbody><row><entry 792 align="char"> 793<para>int ioctl( int fd, int request = 794 <link linkend="FE_READ_SIGNAL_STRENGTH">FE_READ_SIGNAL_STRENGTH</link>, uint16_t ⋆strength);</para> 795</entry> 796 </row></tbody></tgroup></informaltable> 797 798<para>PARAMETERS 799</para> 800<informaltable><tgroup cols="2"><tbody><row><entry 801 align="char"> 802<para>int fd</para> 803</entry><entry 804 align="char"> 805<para>File descriptor returned by a previous call to open().</para> 806</entry> 807 </row><row><entry 808 align="char"> 809<para>int request</para> 810</entry><entry 811 align="char"> 812<para>Equals <link linkend="FE_READ_SIGNAL_STRENGTH">FE_READ_SIGNAL_STRENGTH</link> for this 813 command.</para> 814</entry> 815 </row><row><entry 816 align="char"> 817<para>uint16_t *strength</para> 818</entry><entry 819 align="char"> 820<para>The signal strength value is stored into *strength.</para> 821</entry> 822 </row></tbody></tgroup></informaltable> 823 824&return-value-dvb; 825</section> 826 827<section id="FE_READ_UNCORRECTED_BLOCKS"> 828<title>FE_READ_UNCORRECTED_BLOCKS</title> 829<para>DESCRIPTION 830</para> 831<informaltable><tgroup cols="1"><tbody><row><entry 832 align="char"> 833<para>This ioctl call returns the number of uncorrected blocks detected by the device 834 driver during its lifetime. For meaningful measurements, the increment in block 835 count during a specific time interval should be calculated. For this command, 836 read-only access to the device is sufficient.</para> 837</entry> 838 </row><row><entry 839 align="char"> 840<para>Note that the counter will wrap to zero after its maximum count has been 841 reached.</para> 842</entry> 843 </row></tbody></tgroup></informaltable> 844<para>SYNOPSIS 845</para> 846<informaltable><tgroup cols="1"><tbody><row><entry 847 align="char"> 848<para>int ioctl( int fd, int request = 849 <link linkend="FE_READ_UNCORRECTED_BLOCKS">FE_READ_UNCORRECTED_BLOCKS</link>, uint32_t ⋆ublocks);</para> 850</entry> 851 </row></tbody></tgroup></informaltable> 852<para>PARAMETERS 853</para> 854<informaltable><tgroup cols="2"><tbody><row><entry 855 align="char"> 856<para>int fd</para> 857</entry><entry 858 align="char"> 859<para>File descriptor returned by a previous call to open().</para> 860</entry> 861 </row><row><entry 862 align="char"> 863<para>int request</para> 864</entry><entry 865 align="char"> 866<para>Equals <link linkend="FE_READ_UNCORRECTED_BLOCKS">FE_READ_UNCORRECTED_BLOCKS</link> for this 867 command.</para> 868</entry> 869 </row><row><entry 870 align="char"> 871<para>uint32_t *ublocks</para> 872</entry><entry 873 align="char"> 874<para>The total number of uncorrected blocks seen by the driver 875 so far.</para> 876</entry> 877 </row></tbody></tgroup></informaltable> 878 879&return-value-dvb; 880</section> 881 882<section id="FE_SET_FRONTEND"> 883<title>FE_SET_FRONTEND</title> 884<para>DESCRIPTION 885</para> 886<informaltable><tgroup cols="1"><tbody><row><entry 887 align="char"> 888<para>This ioctl call starts a tuning operation using specified parameters. The result 889 of this call will be successful if the parameters were valid and the tuning could 890 be initiated. The result of the tuning operation in itself, however, will arrive 891 asynchronously as an event (see documentation for <link linkend="FE_GET_EVENT">FE_GET_EVENT</link> and 892 FrontendEvent.) If a new <link linkend="FE_SET_FRONTEND">FE_SET_FRONTEND</link> operation is initiated before 893 the previous one was completed, the previous operation will be aborted in favor 894 of the new one. This command requires read/write access to the device.</para> 895</entry> 896 </row></tbody></tgroup></informaltable> 897 898<para>SYNOPSIS 899</para> 900<informaltable><tgroup cols="1"><tbody><row><entry 901 align="char"> 902<para>int ioctl(int fd, int request = <link linkend="FE_SET_FRONTEND">FE_SET_FRONTEND</link>, 903 struct dvb_frontend_parameters ⋆p);</para> 904</entry> 905 </row></tbody></tgroup></informaltable> 906<para>PARAMETERS 907</para> 908<informaltable><tgroup cols="2"><tbody><row><entry 909 align="char"> 910<para>int fd</para> 911</entry><entry 912 align="char"> 913<para>File descriptor returned by a previous call to open().</para> 914</entry> 915 </row><row><entry 916 align="char"> 917<para>int request</para> 918</entry><entry 919 align="char"> 920<para>Equals <link linkend="FE_SET_FRONTEND">FE_SET_FRONTEND</link> for this command.</para> 921</entry> 922 </row><row><entry 923 align="char"> 924<para>struct 925 dvb_frontend_parameters 926 *p</para> 927</entry><entry 928 align="char"> 929<para>Points to parameters for tuning operation.</para> 930</entry> 931 </row></tbody></tgroup></informaltable> 932 933&return-value-dvb; 934<informaltable><tgroup cols="2"><tbody><row><entry 935 align="char"> 936<para>EINVAL</para> 937</entry><entry 938 align="char"> 939<para>Maximum supported symbol rate reached.</para> 940</entry> 941</row></tbody></tgroup></informaltable> 942</section> 943 944<section id="FE_GET_FRONTEND"> 945<title>FE_GET_FRONTEND</title> 946<para>DESCRIPTION 947</para> 948<informaltable><tgroup cols="1"><tbody><row><entry 949 align="char"> 950<para>This ioctl call queries the currently effective frontend parameters. For this 951 command, read-only access to the device is sufficient.</para> 952</entry> 953 </row></tbody></tgroup></informaltable> 954 955<para>SYNOPSIS 956</para> 957<informaltable><tgroup cols="1"><tbody><row><entry 958 align="char"> 959<para>int ioctl(int fd, int request = <link linkend="FE_GET_FRONTEND">FE_GET_FRONTEND</link>, 960 struct dvb_frontend_parameters ⋆p);</para> 961</entry> 962 </row></tbody></tgroup></informaltable> 963 964<para>PARAMETERS 965</para> 966<informaltable><tgroup cols="2"><tbody><row><entry 967 align="char"> 968<para>int fd</para> 969</entry><entry 970 align="char"> 971<para>File descriptor returned by a previous call to open().</para> 972</entry> 973 </row><row><entry 974 align="char"> 975<para>int request</para> 976</entry><entry 977 align="char"> 978<para>Equals <link linkend="FE_SET_FRONTEND">FE_SET_FRONTEND</link> for this command.</para> 979</entry> 980 </row><row><entry 981 align="char"> 982<para>struct 983 dvb_frontend_parameters 984 *p</para> 985</entry><entry 986 align="char"> 987<para>Points to parameters for tuning operation.</para> 988</entry> 989 </row></tbody></tgroup></informaltable> 990 991&return-value-dvb; 992<informaltable><tgroup cols="2"><tbody><row><entry 993 align="char"> 994<para>EINVAL</para> 995</entry><entry 996 align="char"> 997<para>Maximum supported symbol rate reached.</para> 998</entry> 999 </row></tbody></tgroup></informaltable> 1000 1001</section> 1002 1003<section id="FE_GET_EVENT"> 1004<title>FE_GET_EVENT</title> 1005<para>DESCRIPTION 1006</para> 1007<informaltable><tgroup cols="1"><tbody><row><entry 1008 align="char"> 1009<para>This ioctl call returns a frontend event if available. If an event is not 1010 available, the behavior depends on whether the device is in blocking or 1011 non-blocking mode. In the latter case, the call fails immediately with errno 1012 set to EWOULDBLOCK. In the former case, the call blocks until an event 1013 becomes available.</para> 1014</entry> 1015 </row><row><entry 1016 align="char"> 1017<para>The standard Linux poll() and/or select() system calls can be used with the 1018 device file descriptor to watch for new events. For select(), the file descriptor 1019 should be included in the exceptfds argument, and for poll(), POLLPRI should 1020 be specified as the wake-up condition. Since the event queue allocated is 1021 rather small (room for 8 events), the queue must be serviced regularly to avoid 1022 overflow. If an overflow happens, the oldest event is discarded from the queue, 1023 and an error (EOVERFLOW) occurs the next time the queue is read. After 1024 reporting the error condition in this fashion, subsequent 1025 <link linkend="FE_GET_EVENT">FE_GET_EVENT</link> 1026 calls will return events from the queue as usual.</para> 1027</entry> 1028 </row><row><entry 1029 align="char"> 1030<para>For the sake of implementation simplicity, this command requires read/write 1031 access to the device.</para> 1032</entry> 1033 </row></tbody></tgroup></informaltable> 1034 1035<para>SYNOPSIS 1036</para> 1037<informaltable><tgroup cols="1"><tbody><row><entry 1038 align="char"> 1039<para>int ioctl(int fd, int request = QPSK_GET_EVENT, 1040 struct dvb_frontend_event ⋆ev);</para> 1041</entry> 1042 </row></tbody></tgroup></informaltable> 1043 1044<para>PARAMETERS 1045</para> 1046<informaltable><tgroup cols="2"><tbody><row><entry 1047 align="char"> 1048<para>int fd</para> 1049</entry><entry 1050 align="char"> 1051<para>File descriptor returned by a previous call to open().</para> 1052</entry> 1053 </row><row><entry 1054 align="char"> 1055<para>int request</para> 1056</entry><entry 1057 align="char"> 1058<para>Equals <link linkend="FE_GET_EVENT">FE_GET_EVENT</link> for this command.</para> 1059</entry> 1060 </row><row><entry 1061 align="char"> 1062<para>struct 1063 dvb_frontend_event 1064 *ev</para> 1065</entry><entry 1066 align="char"> 1067<para>Points to the location where the event,</para> 1068</entry> 1069 </row><row><entry 1070 align="char"> 1071</entry><entry 1072 align="char"> 1073<para>if any, is to be stored.</para> 1074</entry> 1075 </row></tbody></tgroup></informaltable> 1076 1077&return-value-dvb; 1078<informaltable><tgroup cols="2"><tbody><row><entry 1079 align="char"> 1080<para>EWOULDBLOCK</para> 1081</entry><entry 1082 align="char"> 1083<para>There is no event pending, and the device is in 1084 non-blocking mode.</para> 1085</entry> 1086 </row><row><entry 1087 align="char"> 1088<para>EOVERFLOW</para> 1089</entry><entry 1090 align="char"> 1091<para>Overflow in event queue - one or more events were lost.</para> 1092</entry> 1093</row></tbody></tgroup></informaltable> 1094</section> 1095 1096<section id="FE_GET_INFO"> 1097<title>FE_GET_INFO</title> 1098<para>DESCRIPTION 1099</para> 1100<informaltable><tgroup cols="1"><tbody><row><entry 1101 align="char"> 1102<para>This ioctl call returns information about the front-end. This call only requires 1103 read-only access to the device.</para> 1104</entry> 1105 </row></tbody></tgroup></informaltable> 1106<para>SYNOPSIS 1107</para> 1108 1109<informaltable><tgroup cols="1"><tbody><row><entry 1110 align="char"> 1111<para> int ioctl(int fd, int request = <link linkend="FE_GET_INFO">FE_GET_INFO</link>, struct 1112 dvb_frontend_info ⋆info);</para> 1113</entry> 1114 </row></tbody></tgroup></informaltable> 1115<para>PARAMETERS 1116</para> 1117 1118<informaltable><tgroup cols="2"><tbody><row><entry 1119 align="char"> 1120<para>int fd</para> 1121</entry><entry 1122 align="char"> 1123<para>File descriptor returned by a previous call to open().</para> 1124</entry> 1125 </row><row><entry 1126 align="char"> 1127<para>int request</para> 1128</entry><entry 1129 align="char"> 1130<para>Equals <link linkend="FE_GET_INFO">FE_GET_INFO</link> for this command.</para> 1131</entry> 1132 </row><row><entry 1133 align="char"> 1134<para>struct 1135 dvb_frontend_info 1136 *info</para> 1137</entry><entry 1138 align="char"> 1139<para>Points to the location where the front-end information is 1140 to be stored.</para> 1141</entry> 1142 </row></tbody></tgroup></informaltable> 1143&return-value-dvb; 1144</section> 1145 1146<section id="FE_DISEQC_RESET_OVERLOAD"> 1147<title>FE_DISEQC_RESET_OVERLOAD</title> 1148<para>DESCRIPTION 1149</para> 1150<informaltable><tgroup cols="1"><tbody><row><entry 1151 align="char"> 1152<para>If the bus has been automatically powered off due to power overload, this ioctl 1153 call restores the power to the bus. The call requires read/write access to the 1154 device. This call has no effect if the device is manually powered off. Not all 1155 DVB adapters support this ioctl.</para> 1156</entry> 1157 </row></tbody></tgroup></informaltable> 1158 1159<para>SYNOPSIS 1160</para> 1161<informaltable><tgroup cols="1"><tbody><row><entry 1162 align="char"> 1163<para>int ioctl(int fd, int request = 1164 <link linkend="FE_DISEQC_RESET_OVERLOAD">FE_DISEQC_RESET_OVERLOAD</link>);</para> 1165</entry> 1166 </row></tbody></tgroup></informaltable> 1167<para>PARAMETERS 1168</para> 1169<informaltable><tgroup cols="2"><tbody><row><entry 1170 align="char"> 1171<para>int fd</para> 1172</entry><entry 1173 align="char"> 1174<para>File descriptor returned by a previous call to open().</para> 1175</entry> 1176 </row><row><entry 1177 align="char"> 1178<para>int request</para> 1179</entry><entry 1180 align="char"> 1181<para>Equals <link linkend="FE_DISEQC_RESET_OVERLOAD">FE_DISEQC_RESET_OVERLOAD</link> for this 1182 command.</para> 1183</entry> 1184 </row></tbody></tgroup></informaltable> 1185 1186&return-value-dvb; 1187</section> 1188 1189<section id="FE_DISEQC_SEND_MASTER_CMD"> 1190<title>FE_DISEQC_SEND_MASTER_CMD</title> 1191<para>DESCRIPTION 1192</para> 1193<informaltable><tgroup cols="1"><tbody><row><entry 1194 align="char"> 1195<para>This ioctl call is used to send a a DiSEqC command.</para> 1196</entry> 1197 </row></tbody></tgroup></informaltable> 1198<para>SYNOPSIS 1199</para> 1200<informaltable><tgroup cols="1"><tbody><row><entry 1201 align="char"> 1202<para>int ioctl(int fd, int request = 1203 <link linkend="FE_DISEQC_SEND_MASTER_CMD">FE_DISEQC_SEND_MASTER_CMD</link>, struct 1204 dvb_diseqc_master_cmd ⋆cmd);</para> 1205</entry> 1206 </row></tbody></tgroup></informaltable> 1207 1208<para>PARAMETERS 1209</para> 1210<informaltable><tgroup cols="2"><tbody><row><entry 1211 align="char"> 1212<para>int fd</para> 1213</entry><entry 1214 align="char"> 1215<para>File descriptor returned by a previous call to open().</para> 1216</entry> 1217 </row><row><entry 1218 align="char"> 1219<para>int request</para> 1220</entry><entry 1221 align="char"> 1222<para>Equals <link linkend="FE_DISEQC_SEND_MASTER_CMD">FE_DISEQC_SEND_MASTER_CMD</link> for this 1223 command.</para> 1224</entry> 1225 </row><row><entry 1226 align="char"> 1227<para>struct 1228 dvb_diseqc_master_cmd 1229 *cmd</para> 1230</entry><entry 1231 align="char"> 1232<para>Pointer to the command to be transmitted.</para> 1233</entry> 1234 </row></tbody></tgroup></informaltable> 1235 1236&return-value-dvb; 1237</section> 1238 1239<section id="FE_DISEQC_RECV_SLAVE_REPLY"> 1240<title>FE_DISEQC_RECV_SLAVE_REPLY</title> 1241<para>DESCRIPTION 1242</para> 1243<informaltable><tgroup cols="1"><tbody><row><entry 1244 align="char"> 1245<para>This ioctl call is used to receive reply to a DiSEqC 2.0 command.</para> 1246</entry> 1247 </row></tbody></tgroup></informaltable> 1248 1249<para>SYNOPSIS 1250</para> 1251<informaltable><tgroup cols="1"><tbody><row><entry 1252 align="char"> 1253<para>int ioctl(int fd, int request = 1254 <link linkend="FE_DISEQC_RECV_SLAVE_REPLY">FE_DISEQC_RECV_SLAVE_REPLY</link>, struct 1255 dvb_diseqc_slave_reply ⋆reply);</para> 1256</entry> 1257 </row></tbody></tgroup></informaltable> 1258 1259<para>PARAMETERS 1260</para> 1261<informaltable><tgroup cols="2"><tbody><row><entry 1262 align="char"> 1263<para>int fd</para> 1264</entry><entry 1265 align="char"> 1266<para>File descriptor returned by a previous call to open().</para> 1267</entry> 1268 </row><row><entry 1269 align="char"> 1270<para>int request</para> 1271</entry><entry 1272 align="char"> 1273<para>Equals <link linkend="FE_DISEQC_RECV_SLAVE_REPLY">FE_DISEQC_RECV_SLAVE_REPLY</link> for this 1274 command.</para> 1275</entry> 1276 </row><row><entry 1277 align="char"> 1278<para>struct 1279 dvb_diseqc_slave_reply 1280 *reply</para> 1281</entry><entry 1282 align="char"> 1283<para>Pointer to the command to be received.</para> 1284</entry> 1285 </row></tbody></tgroup></informaltable> 1286&return-value-dvb; 1287</section> 1288 1289<section id="FE_DISEQC_SEND_BURST"> 1290<title>FE_DISEQC_SEND_BURST</title> 1291<para>DESCRIPTION 1292</para> 1293<informaltable><tgroup cols="1"><tbody><row><entry 1294 align="char"> 1295<para>This ioctl call is used to send a 22KHz tone burst.</para> 1296</entry> 1297 </row></tbody></tgroup></informaltable> 1298 1299<para>SYNOPSIS 1300</para> 1301<informaltable><tgroup cols="1"><tbody><row><entry 1302 align="char"> 1303<para>int ioctl(int fd, int request = 1304 <link linkend="FE_DISEQC_SEND_BURST">FE_DISEQC_SEND_BURST</link>, fe_sec_mini_cmd_t burst);</para> 1305</entry> 1306 </row></tbody></tgroup></informaltable> 1307 1308<para>PARAMETERS 1309</para> 1310<informaltable><tgroup cols="2"><tbody><row><entry 1311 align="char"> 1312<para>int fd</para> 1313</entry><entry 1314 align="char"> 1315<para>File descriptor returned by a previous call to open().</para> 1316</entry> 1317 </row><row><entry 1318 align="char"> 1319<para>int request</para> 1320</entry><entry 1321 align="char"> 1322<para>Equals <link linkend="FE_DISEQC_SEND_BURST">FE_DISEQC_SEND_BURST</link> for this command.</para> 1323</entry> 1324 </row><row><entry 1325 align="char"> 1326<para>fe_sec_mini_cmd_t 1327 burst</para> 1328</entry><entry 1329 align="char"> 1330<para>burst A or B.</para> 1331</entry> 1332 </row></tbody></tgroup></informaltable> 1333 1334&return-value-dvb; 1335</section> 1336 1337<section id="FE_SET_TONE"> 1338<title>FE_SET_TONE</title> 1339<para>DESCRIPTION 1340</para> 1341<informaltable><tgroup cols="1"><tbody><row><entry 1342 align="char"> 1343<para>This call is used to set the generation of the continuous 22kHz tone. This call 1344 requires read/write permissions.</para> 1345</entry> 1346 </row></tbody></tgroup></informaltable> 1347<para>SYNOPSIS 1348</para> 1349<informaltable><tgroup cols="1"><tbody><row><entry 1350 align="char"> 1351<para>int ioctl(int fd, int request = <link linkend="FE_SET_TONE">FE_SET_TONE</link>, 1352 fe_sec_tone_mode_t tone);</para> 1353</entry> 1354 </row></tbody></tgroup></informaltable> 1355<para>PARAMETERS 1356</para> 1357<informaltable><tgroup cols="2"><tbody><row><entry 1358 align="char"> 1359<para>int fd</para> 1360</entry><entry 1361 align="char"> 1362<para>File descriptor returned by a previous call to open().</para> 1363</entry> 1364 </row><row><entry 1365 align="char"> 1366<para>int request</para> 1367</entry><entry 1368 align="char"> 1369<para>Equals <link linkend="FE_SET_TONE">FE_SET_TONE</link> for this command.</para> 1370</entry> 1371 </row><row><entry 1372 align="char"> 1373<para>fe_sec_tone_mode_t 1374 tone</para> 1375</entry><entry 1376 align="char"> 1377<para>The requested tone generation mode (on/off).</para> 1378</entry> 1379 </row></tbody></tgroup></informaltable> 1380&return-value-dvb; 1381</section> 1382 1383<section id="FE_SET_VOLTAGE"> 1384<title>FE_SET_VOLTAGE</title> 1385<para>DESCRIPTION 1386</para> 1387<informaltable><tgroup cols="1"><tbody><row><entry 1388 align="char"> 1389<para>This call is used to set the bus voltage. This call requires read/write 1390 permissions.</para> 1391</entry> 1392 </row></tbody></tgroup></informaltable> 1393<para>SYNOPSIS 1394</para> 1395<informaltable><tgroup cols="1"><tbody><row><entry 1396 align="char"> 1397<para>int ioctl(int fd, int request = <link linkend="FE_SET_VOLTAGE">FE_SET_VOLTAGE</link>, 1398 fe_sec_voltage_t voltage);</para> 1399</entry> 1400 </row></tbody></tgroup></informaltable> 1401 1402<para>PARAMETERS 1403</para> 1404<informaltable><tgroup cols="2"><tbody><row><entry 1405 align="char"> 1406<para>int fd</para> 1407</entry><entry 1408 align="char"> 1409<para>File descriptor returned by a previous call to open().</para> 1410</entry> 1411 </row><row><entry 1412 align="char"> 1413<para>int request</para> 1414</entry><entry 1415 align="char"> 1416<para>Equals <link linkend="FE_SET_VOLTAGE">FE_SET_VOLTAGE</link> for this command.</para> 1417</entry> 1418 </row><row><entry 1419 align="char"> 1420<para>fe_sec_voltage_t 1421 voltage</para> 1422</entry><entry 1423 align="char"> 1424<para>The requested bus voltage.</para> 1425</entry> 1426 </row></tbody></tgroup></informaltable> 1427 1428&return-value-dvb; 1429</section> 1430 1431<section id="FE_ENABLE_HIGH_LNB_VOLTAGE"> 1432<title>FE_ENABLE_HIGH_LNB_VOLTAGE</title> 1433<para>DESCRIPTION 1434</para> 1435<informaltable><tgroup cols="1"><tbody><row><entry 1436 align="char"> 1437<para>If high != 0 enables slightly higher voltages instead of 13/18V (to compensate 1438 for long cables). This call requires read/write permissions. Not all DVB 1439 adapters support this ioctl.</para> 1440</entry> 1441 </row></tbody></tgroup></informaltable> 1442 1443<para>SYNOPSIS 1444</para> 1445<informaltable><tgroup cols="1"><tbody><row><entry 1446 align="char"> 1447<para>int ioctl(int fd, int request = 1448 <link linkend="FE_ENABLE_HIGH_LNB_VOLTAGE">FE_ENABLE_HIGH_LNB_VOLTAGE</link>, int high);</para> 1449</entry> 1450 </row></tbody></tgroup></informaltable> 1451 1452<para>PARAMETERS 1453</para> 1454<informaltable><tgroup cols="2"><tbody><row><entry 1455 align="char"> 1456<para>int fd</para> 1457</entry><entry 1458 align="char"> 1459<para>File descriptor returned by a previous call to open().</para> 1460</entry> 1461 </row><row><entry 1462 align="char"> 1463<para>int request</para> 1464</entry><entry 1465 align="char"> 1466<para>Equals <link linkend="FE_SET_VOLTAGE">FE_SET_VOLTAGE</link> for this command.</para> 1467</entry> 1468 </row><row><entry 1469 align="char"> 1470<para>int high</para> 1471</entry><entry 1472 align="char"> 1473<para>The requested bus voltage.</para> 1474</entry> 1475 </row></tbody></tgroup></informaltable> 1476 1477&return-value-dvb; 1478</section> 1479 1480<section id="FE_SET_FRONTEND_TUNE_MODE"> 1481<title>FE_SET_FRONTEND_TUNE_MODE</title> 1482<para>DESCRIPTION</para> 1483<informaltable><tgroup cols="1"><tbody><row> 1484<entry align="char"> 1485<para>Allow setting tuner mode flags to the frontend.</para> 1486</entry> 1487</row></tbody></tgroup></informaltable> 1488 1489<para>SYNOPSIS</para> 1490<informaltable><tgroup cols="1"><tbody><row> 1491<entry align="char"> 1492<para>int ioctl(int fd, int request = 1493<link linkend="FE_SET_FRONTEND_TUNE_MODE">FE_SET_FRONTEND_TUNE_MODE</link>, unsigned int flags);</para> 1494</entry> 1495</row></tbody></tgroup></informaltable> 1496 1497<para>PARAMETERS</para> 1498<informaltable><tgroup cols="2"><tbody><row> 1499<entry align="char"> 1500 <para>unsigned int flags</para> 1501</entry> 1502<entry align="char"> 1503<para> 1504FE_TUNE_MODE_ONESHOT When set, this flag will disable any zigzagging or other "normal" tuning behaviour. Additionally, there will be no automatic monitoring of the lock status, and hence no frontend events will be generated. If a frontend device is closed, this flag will be automatically turned off when the device is reopened read-write. 1505</para> 1506</entry> 1507 </row></tbody></tgroup></informaltable> 1508 1509&return-value-dvb; 1510</section> 1511 1512<section id="FE_DISHNETWORK_SEND_LEGACY_CMD"> 1513 <title>FE_DISHNETWORK_SEND_LEGACY_CMD</title> 1514<para>DESCRIPTION</para> 1515<informaltable><tgroup cols="1"><tbody><row> 1516<entry align="char"> 1517<para>WARNING: This is a very obscure legacy command, used only at stv0299 driver. Should not be used on newer drivers.</para> 1518<para>It provides a non-standard method for selecting Diseqc voltage on the frontend, for Dish Network legacy switches.</para> 1519<para>As support for this ioctl were added in 2004, this means that such dishes were already legacy in 2004.</para> 1520</entry> 1521</row></tbody></tgroup></informaltable> 1522 1523<para>SYNOPSIS</para> 1524<informaltable><tgroup cols="1"><tbody><row> 1525<entry align="char"> 1526<para>int ioctl(int fd, int request = 1527 <link linkend="FE_DISHNETWORK_SEND_LEGACY_CMD">FE_DISHNETWORK_SEND_LEGACY_CMD</link>, unsigned long cmd);</para> 1528</entry> 1529</row></tbody></tgroup></informaltable> 1530 1531<para>PARAMETERS</para> 1532<informaltable><tgroup cols="2"><tbody><row> 1533<entry align="char"> 1534 <para>unsigned long cmd</para> 1535</entry> 1536<entry align="char"> 1537<para> 1538sends the specified raw cmd to the dish via DISEqC. 1539</para> 1540</entry> 1541 </row></tbody></tgroup></informaltable> 1542 1543&return-value-dvb; 1544</section> 1545 1546</section> 1547 1548&sub-dvbproperty; 1549