| /* |
| * frontend.h |
| * |
| * Copyright (C) 2000 Marcus Metzler <marcus@convergence.de> |
| * Ralph Metzler <ralph@convergence.de> |
| * Holger Waechtler <holger@convergence.de> |
| * Andre Draszik <ad@convergence.de> |
| * for convergence integrated media GmbH |
| * |
| * This program is free software; you can redistribute it and/or |
| * modify it under the terms of the GNU Lesser General Public License |
| * as published by the Free Software Foundation; either version 2.1 |
| * of the License, or (at your option) any later version. |
| * |
| * This program is distributed in the hope that it will be useful, |
| * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| * GNU General Public License for more details. |
| * |
| * You should have received a copy of the GNU Lesser General Public License |
| * along with this program; if not, write to the Free Software |
| * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. |
| * |
| */ |
| |
| #ifndef _DVBFRONTEND_H_ |
| #define _DVBFRONTEND_H_ |
| |
| #include <asm/types.h> |
| |
| |
| typedef enum fe_type { |
| FE_QPSK, |
| FE_QAM, |
| FE_OFDM, |
| FE_ATSC |
| } fe_type_t; |
| |
| |
| typedef enum fe_caps { |
| FE_IS_STUPID = 0, |
| FE_CAN_INVERSION_AUTO = 0x1, |
| FE_CAN_FEC_1_2 = 0x2, |
| FE_CAN_FEC_2_3 = 0x4, |
| FE_CAN_FEC_3_4 = 0x8, |
| FE_CAN_FEC_4_5 = 0x10, |
| FE_CAN_FEC_5_6 = 0x20, |
| FE_CAN_FEC_6_7 = 0x40, |
| FE_CAN_FEC_7_8 = 0x80, |
| FE_CAN_FEC_8_9 = 0x100, |
| FE_CAN_FEC_AUTO = 0x200, |
| FE_CAN_QPSK = 0x400, |
| FE_CAN_QAM_16 = 0x800, |
| FE_CAN_QAM_32 = 0x1000, |
| FE_CAN_QAM_64 = 0x2000, |
| FE_CAN_QAM_128 = 0x4000, |
| FE_CAN_QAM_256 = 0x8000, |
| FE_CAN_QAM_AUTO = 0x10000, |
| FE_CAN_TRANSMISSION_MODE_AUTO = 0x20000, |
| FE_CAN_BANDWIDTH_AUTO = 0x40000, |
| FE_CAN_GUARD_INTERVAL_AUTO = 0x80000, |
| FE_CAN_HIERARCHY_AUTO = 0x100000, |
| FE_CAN_8VSB = 0x200000, |
| FE_CAN_16VSB = 0x400000, |
| FE_HAS_EXTENDED_CAPS = 0x800000, // We need more bitspace for newer APIs, indicate this. |
| FE_NEEDS_BENDING = 0x20000000, // not supported anymore, don't use (frontend requires frequency bending) |
| FE_CAN_RECOVER = 0x40000000, // frontend can recover from a cable unplug automatically |
| FE_CAN_MUTE_TS = 0x80000000 // frontend can stop spurious TS data output |
| } fe_caps_t; |
| |
| |
| struct dvb_frontend_info { |
| char name[128]; |
| fe_type_t type; |
| __u32 frequency_min; |
| __u32 frequency_max; |
| __u32 frequency_stepsize; |
| __u32 frequency_tolerance; |
| __u32 symbol_rate_min; |
| __u32 symbol_rate_max; |
| __u32 symbol_rate_tolerance; /* ppm */ |
| __u32 notifier_delay; /* DEPRECATED */ |
| fe_caps_t caps; |
| }; |
| |
| |
| /** |
| * Check out the DiSEqC bus spec available on http://www.eutelsat.org/ for |
| * the meaning of this struct... |
| */ |
| struct dvb_diseqc_master_cmd { |
| __u8 msg [6]; /* { framing, address, command, data [3] } */ |
| __u8 msg_len; /* valid values are 3...6 */ |
| }; |
| |
| |
| struct dvb_diseqc_slave_reply { |
| __u8 msg [4]; /* { framing, data [3] } */ |
| __u8 msg_len; /* valid values are 0...4, 0 means no msg */ |
| int timeout; /* return from ioctl after timeout ms with */ |
| }; /* errorcode when no message was received */ |
| |
| |
| typedef enum fe_sec_voltage { |
| SEC_VOLTAGE_13, |
| SEC_VOLTAGE_18, |
| SEC_VOLTAGE_OFF |
| } fe_sec_voltage_t; |
| |
| |
| typedef enum fe_sec_tone_mode { |
| SEC_TONE_ON, |
| SEC_TONE_OFF |
| } fe_sec_tone_mode_t; |
| |
| |
| typedef enum fe_sec_mini_cmd { |
| SEC_MINI_A, |
| SEC_MINI_B |
| } fe_sec_mini_cmd_t; |
| |
| |
| typedef enum fe_status { |
| FE_HAS_SIGNAL = 0x01, /* found something above the noise level */ |
| FE_HAS_CARRIER = 0x02, /* found a DVB signal */ |
| FE_HAS_VITERBI = 0x04, /* FEC is stable */ |
| FE_HAS_SYNC = 0x08, /* found sync bytes */ |
| FE_HAS_LOCK = 0x10, /* everything's working... */ |
| FE_TIMEDOUT = 0x20, /* no lock within the last ~2 seconds */ |
| FE_REINIT = 0x40 /* frontend was reinitialized, */ |
| } fe_status_t; /* application is recommended to reset */ |
| /* DiSEqC, tone and parameters */ |
| |
| typedef enum fe_spectral_inversion { |
| INVERSION_OFF, |
| INVERSION_ON, |
| INVERSION_AUTO |
| } fe_spectral_inversion_t; |
| |
| |
| typedef enum fe_code_rate { |
| FEC_NONE = 0, |
| FEC_1_2, |
| FEC_2_3, |
| FEC_3_4, |
| FEC_4_5, |
| FEC_5_6, |
| FEC_6_7, |
| FEC_7_8, |
| FEC_8_9, |
| FEC_AUTO, |
| FEC_3_5, |
| FEC_9_10, |
| } fe_code_rate_t; |
| |
| |
| typedef enum fe_modulation { |
| QPSK, |
| QAM_16, |
| QAM_32, |
| QAM_64, |
| QAM_128, |
| QAM_256, |
| QAM_AUTO, |
| VSB_8, |
| VSB_16, |
| _8PSK, |
| _16APSK, |
| NBC_QPSK, |
| DQPSK, |
| } fe_modulation_t; |
| |
| typedef enum fe_transmit_mode { |
| TRANSMISSION_MODE_2K, |
| TRANSMISSION_MODE_8K, |
| TRANSMISSION_MODE_AUTO |
| } fe_transmit_mode_t; |
| |
| typedef enum fe_bandwidth { |
| BANDWIDTH_8_MHZ, |
| BANDWIDTH_7_MHZ, |
| BANDWIDTH_6_MHZ, |
| BANDWIDTH_AUTO |
| } fe_bandwidth_t; |
| |
| |
| typedef enum fe_guard_interval { |
| GUARD_INTERVAL_1_32, |
| GUARD_INTERVAL_1_16, |
| GUARD_INTERVAL_1_8, |
| GUARD_INTERVAL_1_4, |
| GUARD_INTERVAL_AUTO |
| } fe_guard_interval_t; |
| |
| |
| typedef enum fe_hierarchy { |
| HIERARCHY_NONE, |
| HIERARCHY_1, |
| HIERARCHY_2, |
| HIERARCHY_4, |
| HIERARCHY_AUTO |
| } fe_hierarchy_t; |
| |
| |
| struct dvb_qpsk_parameters { |
| __u32 symbol_rate; /* symbol rate in Symbols per second */ |
| fe_code_rate_t fec_inner; /* forward error correction (see above) */ |
| }; |
| |
| struct dvb_qam_parameters { |
| __u32 symbol_rate; /* symbol rate in Symbols per second */ |
| fe_code_rate_t fec_inner; /* forward error correction (see above) */ |
| fe_modulation_t modulation; /* modulation type (see above) */ |
| }; |
| |
| struct dvb_vsb_parameters { |
| fe_modulation_t modulation; /* modulation type (see above) */ |
| }; |
| |
| struct dvb_ofdm_parameters { |
| fe_bandwidth_t bandwidth; |
| fe_code_rate_t code_rate_HP; /* high priority stream code rate */ |
| fe_code_rate_t code_rate_LP; /* low priority stream code rate */ |
| fe_modulation_t constellation; /* modulation type (see above) */ |
| fe_transmit_mode_t transmission_mode; |
| fe_guard_interval_t guard_interval; |
| fe_hierarchy_t hierarchy_information; |
| }; |
| |
| |
| struct dvb_frontend_parameters { |
| __u32 frequency; /* (absolute) frequency in Hz for QAM/OFDM/ATSC */ |
| /* intermediate frequency in kHz for QPSK */ |
| fe_spectral_inversion_t inversion; |
| union { |
| struct dvb_qpsk_parameters qpsk; |
| struct dvb_qam_parameters qam; |
| struct dvb_ofdm_parameters ofdm; |
| struct dvb_vsb_parameters vsb; |
| } u; |
| }; |
| |
| |
| struct dvb_frontend_event { |
| fe_status_t status; |
| struct dvb_frontend_parameters parameters; |
| }; |
| |
| /* TODO: Turn this into a series of defines, so future maintainers |
| * don't insert random new commands and break backwards |
| * binary compatability. |
| */ |
| typedef enum dtv_cmd_types { |
| DTV_UNDEFINED, |
| DTV_TUNE, |
| DTV_CLEAR, |
| |
| DTV_FREQUENCY, |
| DTV_MODULATION, |
| |
| /* XXX PB: I would like to have field which describes the |
| * bandwidth of a channel in Hz or kHz - maybe we can remove the |
| * DTV_BANDWIDTH now and put a compat layer */ |
| DTV_BANDWIDTH_HZ, |
| |
| DTV_INVERSION, |
| DTV_DISEQC_MASTER, |
| DTV_SYMBOL_RATE, |
| DTV_INNER_FEC, |
| DTV_VOLTAGE, |
| DTV_TONE, |
| DTV_PILOT, |
| DTV_ROLLOFF, |
| |
| DTV_DISEQC_SLAVE_REPLY, |
| |
| /* Basic enumeration set for querying unlimited capabilities */ |
| DTV_FE_CAPABILITY_COUNT, |
| DTV_FE_CAPABILITY, |
| |
| /* New commands are always appended */ |
| DTV_DELIVERY_SYSTEM, |
| } dtv_cmd_types_t; |
| |
| typedef enum fe_pilot { |
| PILOT_ON, |
| PILOT_OFF, |
| PILOT_AUTO, |
| } fe_pilot_t; |
| |
| typedef enum fe_rolloff { |
| ROLLOFF_20, |
| ROLLOFF_25, |
| ROLLOFF_35, |
| ROLLOFF_AUTO, |
| } fe_rolloff_t; |
| |
| typedef enum fe_delivery_system { |
| SYS_UNDEFINED, |
| SYS_DVBC_ANNEX_AC, |
| SYS_DVBC_ANNEX_B, |
| SYS_DVBT, |
| SYS_DVBS, |
| SYS_DVBS2, |
| SYS_DVBH, |
| SYS_ISDBT, |
| SYS_ISDBS, |
| SYS_ISDBC, |
| SYS_ATSC, |
| SYS_ATSCMH, |
| SYS_DMBTH, |
| SYS_CMMB, |
| SYS_DAB, |
| } fe_delivery_system_t; |
| |
| struct dtv_cmds_h { |
| char *name; /* A display name for debugging purposes */ |
| |
| __u32 cmd; /* A unique ID */ |
| |
| /* Flags */ |
| __u32 set:1; /* Either a set or get property */ |
| __u32 buffer:1; /* Does this property use the buffer? */ |
| __u32 reserved:30; /* Align */ |
| }; |
| |
| struct dtv_property { |
| __u32 cmd; |
| __u32 reserved[3]; |
| union { |
| __u32 data; |
| struct { |
| __u8 data[32]; |
| __u32 len; |
| __u32 reserved1[3]; |
| void *reserved2; |
| } buffer; |
| } u; |
| } __attribute__ ((packed)); |
| |
| /* No more than 16 properties during any given ioctl */ |
| struct dtv_properties { |
| __u32 num; |
| struct dtv_property *props; |
| }; |
| |
| #define DTV_IOCTL_MAX_MSGS 64 |
| |
| #define FE_SET_PROPERTY _IOW('o', 82, struct dtv_properties) |
| #define FE_GET_PROPERTY _IOR('o', 83, struct dtv_properties) |
| |
| |
| /** |
| * 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. |
| */ |
| #define FE_TUNE_MODE_ONESHOT 0x01 |
| |
| |
| #define FE_GET_INFO _IOR('o', 61, struct dvb_frontend_info) |
| |
| #define FE_DISEQC_RESET_OVERLOAD _IO('o', 62) |
| #define FE_DISEQC_SEND_MASTER_CMD _IOW('o', 63, struct dvb_diseqc_master_cmd) |
| #define FE_DISEQC_RECV_SLAVE_REPLY _IOR('o', 64, struct dvb_diseqc_slave_reply) |
| #define FE_DISEQC_SEND_BURST _IO('o', 65) /* fe_sec_mini_cmd_t */ |
| |
| #define FE_SET_TONE _IO('o', 66) /* fe_sec_tone_mode_t */ |
| #define FE_SET_VOLTAGE _IO('o', 67) /* fe_sec_voltage_t */ |
| #define FE_ENABLE_HIGH_LNB_VOLTAGE _IO('o', 68) /* int */ |
| |
| #define FE_READ_STATUS _IOR('o', 69, fe_status_t) |
| #define FE_READ_BER _IOR('o', 70, __u32) |
| #define FE_READ_SIGNAL_STRENGTH _IOR('o', 71, __u16) |
| #define FE_READ_SNR _IOR('o', 72, __u16) |
| #define FE_READ_UNCORRECTED_BLOCKS _IOR('o', 73, __u32) |
| |
| #define FE_SET_FRONTEND _IOW('o', 76, struct dvb_frontend_parameters) |
| #define FE_GET_FRONTEND _IOR('o', 77, struct dvb_frontend_parameters) |
| #define FE_SET_FRONTEND_TUNE_MODE _IO('o', 81) /* unsigned int */ |
| #define FE_GET_EVENT _IOR('o', 78, struct dvb_frontend_event) |
| |
| #define FE_DISHNETWORK_SEND_LEGACY_CMD _IO('o', 80) /* unsigned int */ |
| |
| #endif /*_DVBFRONTEND_H_*/ |