Name

FE_SET_TONE — Sets/resets the generation of the continuous 22kHz tone.

Synopsis

int ioctl(int fd,
 int request,
 enum fe_sec_tone_mode *tone);
 

Arguments

fd

File descriptor returned by open().

request

FE_SET_TONE

tone

pointer to enum fe_sec_tone_mode

Description

This ioctl is used to set the generation of the continuous 22kHz tone. This call requires read/write permissions.

Usually, satellite antenna subsystems require that the digital TV device to send a 22kHz tone in order to select between high/low band on some dual-band LNBf. It is also used to send signals to DiSEqC equipment, but this is done using the DiSEqC ioctls.

NOTE: if more than one device is connected to the same antenna, setting a tone may interfere on other devices, as they may lose the capability of selecting the band. So, it is recommended that applications would change to SEC_TONE_OFF when the device is not used.

RETURN VALUE

On success 0 is returned, on error -1 and the errno variable is set appropriately. The generic error codes are described at the Generic Error Codes chapter.

enum fe_sec_tone_mode

Table 9.23. enum fe_sec_tone_mode

IDDescription
SEC_TONE_ONSends a 22kHz tone burst to the antenna
SEC_TONE_OFFDon't send a 22kHz tone to the antenna (except if the FE_DISEQC_* ioctls are called)