1 .. -*- coding: utf-8; mode: rst -*-
11 Sets/resets the generation of the continuous 22kHz tone.
17 .. c:function:: int ioctl( int fd, int request, enum fe_sec_tone_mode *tone )
23 File descriptor returned by :ref:`open() <frontend_f_open>`.
29 pointer to enum :ref:`fe_sec_tone_mode <fe-sec-tone-mode>`
35 This ioctl is used to set the generation of the continuous 22kHz tone.
36 This call requires read/write permissions.
38 Usually, satellite antenna subsystems require that the digital TV device
39 to send a 22kHz tone in order to select between high/low band on some
40 dual-band LNBf. It is also used to send signals to DiSEqC equipment, but
41 this is done using the DiSEqC ioctls.
43 NOTE: if more than one device is connected to the same antenna, setting
44 a tone may interfere on other devices, as they may lose the capability
45 of selecting the band. So, it is recommended that applications would
46 change to SEC_TONE_OFF when the device is not used.
50 On success 0 is returned, on error -1 and the ``errno`` variable is set
51 appropriately. The generic error codes are described at the
52 :ref:`Generic Error Codes <gen-errors>` chapter.
55 .. _fe-sec-tone-mode-t:
63 .. flat-table:: enum fe_sec_tone_mode
80 - Sends a 22kHz tone burst to the antenna
88 - Don't send a 22kHz tone to the antenna (except if the
89 FE_DISEQC_* ioctls are called)
94 .. ------------------------------------------------------------------------------
95 .. This file was automatically converted from DocBook-XML with the dbxml
96 .. library (https://github.com/return42/sphkerneldoc). The origin XML comes
97 .. from the linux kernel, refer to:
99 .. * https://github.com/torvalds/linux/tree/master/Documentation/DocBook
100 .. ------------------------------------------------------------------------------