[deliverable/linux.git] / include / linux / dvb / frontend.h

/*
 * 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 <linux/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_CAN_MULTISTREAM		= 0x4000000,  /* frontend supports multistream filtering */
	FE_CAN_TURBO_FEC		= 0x8000000,  /* frontend supports "turbo fec modulation" */
	FE_CAN_2G_MODULATION		= 0x10000000, /* frontend supports "2nd generation modulation" (DVB-S2) */
	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;			/* DEPRECATED. Use DTV_ENUM_DELSYS instead */
	__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;


/**
 * enum fe_status - enumerates the possible frontend status
 * @FE_HAS_SIGNAL:	found something above the noise level
 * @FE_HAS_CARRIER:	found a DVB signal
 * @FE_HAS_VITERBI:	FEC is stable
 * @FE_HAS_SYNC:	found sync bytes
 * @FE_HAS_LOCK:	everything's working
 * @FE_TIMEDOUT:	no lock within the last ~2 seconds
 * @FE_REINIT:		frontend was reinitialized, application is recommended
 *			to reset DiSEqC, tone and parameters
 */

typedef enum fe_status {
	FE_HAS_SIGNAL		= 0x01,
	FE_HAS_CARRIER		= 0x02,
	FE_HAS_VITERBI		= 0x04,
	FE_HAS_SYNC		= 0x08,
	FE_HAS_LOCK		= 0x10,
	FE_TIMEDOUT		= 0x20,
	FE_REINIT		= 0x40,
} fe_status_t;

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,
	FEC_2_5,
} 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,
	PSK_8,
	APSK_16,
	APSK_32,
	DQPSK,
	QAM_4_NR,
} fe_modulation_t;

typedef enum fe_transmit_mode {
	TRANSMISSION_MODE_2K,
	TRANSMISSION_MODE_8K,
	TRANSMISSION_MODE_AUTO,
	TRANSMISSION_MODE_4K,
	TRANSMISSION_MODE_1K,
	TRANSMISSION_MODE_16K,
	TRANSMISSION_MODE_32K,
	TRANSMISSION_MODE_C1,
	TRANSMISSION_MODE_C3780,
} fe_transmit_mode_t;

#if defined(__DVB_CORE__) || !defined (__KERNEL__)
typedef enum fe_bandwidth {
	BANDWIDTH_8_MHZ,
	BANDWIDTH_7_MHZ,
	BANDWIDTH_6_MHZ,
	BANDWIDTH_AUTO,
	BANDWIDTH_5_MHZ,
	BANDWIDTH_10_MHZ,
	BANDWIDTH_1_712_MHZ,
} fe_bandwidth_t;
#endif

typedef enum fe_guard_interval {
	GUARD_INTERVAL_1_32,
	GUARD_INTERVAL_1_16,
	GUARD_INTERVAL_1_8,
	GUARD_INTERVAL_1_4,
	GUARD_INTERVAL_AUTO,
	GUARD_INTERVAL_1_128,
	GUARD_INTERVAL_19_128,
	GUARD_INTERVAL_19_256,
	GUARD_INTERVAL_PN420,
	GUARD_INTERVAL_PN595,
	GUARD_INTERVAL_PN945,
} fe_guard_interval_t;


typedef enum fe_hierarchy {
	HIERARCHY_NONE,
	HIERARCHY_1,
	HIERARCHY_2,
	HIERARCHY_4,
	HIERARCHY_AUTO
} fe_hierarchy_t;

enum fe_interleaving {
	INTERLEAVING_NONE,
	INTERLEAVING_AUTO,
	INTERLEAVING_240,
	INTERLEAVING_720,
};

#if defined(__DVB_CORE__) || !defined (__KERNEL__)
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;
};
#endif

/* S2API Commands */
#define DTV_UNDEFINED		0
#define DTV_TUNE		1
#define DTV_CLEAR		2
#define DTV_FREQUENCY		3
#define DTV_MODULATION		4
#define DTV_BANDWIDTH_HZ	5
#define DTV_INVERSION		6
#define DTV_DISEQC_MASTER	7
#define DTV_SYMBOL_RATE		8
#define DTV_INNER_FEC		9
#define DTV_VOLTAGE		10
#define DTV_TONE		11
#define DTV_PILOT		12
#define DTV_ROLLOFF		13
#define DTV_DISEQC_SLAVE_REPLY	14

/* Basic enumeration set for querying unlimited capabilities */
#define DTV_FE_CAPABILITY_COUNT	15
#define DTV_FE_CAPABILITY	16
#define DTV_DELIVERY_SYSTEM	17

/* ISDB-T and ISDB-Tsb */
#define DTV_ISDBT_PARTIAL_RECEPTION	18
#define DTV_ISDBT_SOUND_BROADCASTING	19

#define DTV_ISDBT_SB_SUBCHANNEL_ID	20
#define DTV_ISDBT_SB_SEGMENT_IDX	21
#define DTV_ISDBT_SB_SEGMENT_COUNT	22

#define DTV_ISDBT_LAYERA_FEC			23
#define DTV_ISDBT_LAYERA_MODULATION		24
#define DTV_ISDBT_LAYERA_SEGMENT_COUNT		25
#define DTV_ISDBT_LAYERA_TIME_INTERLEAVING	26

#define DTV_ISDBT_LAYERB_FEC			27
#define DTV_ISDBT_LAYERB_MODULATION		28
#define DTV_ISDBT_LAYERB_SEGMENT_COUNT		29
#define DTV_ISDBT_LAYERB_TIME_INTERLEAVING	30

#define DTV_ISDBT_LAYERC_FEC			31
#define DTV_ISDBT_LAYERC_MODULATION		32
#define DTV_ISDBT_LAYERC_SEGMENT_COUNT		33
#define DTV_ISDBT_LAYERC_TIME_INTERLEAVING	34

#define DTV_API_VERSION		35

#define DTV_CODE_RATE_HP	36
#define DTV_CODE_RATE_LP	37
#define DTV_GUARD_INTERVAL	38
#define DTV_TRANSMISSION_MODE	39
#define DTV_HIERARCHY		40

#define DTV_ISDBT_LAYER_ENABLED	41

#define DTV_STREAM_ID		42
#define DTV_ISDBS_TS_ID_LEGACY	DTV_STREAM_ID
#define DTV_DVBT2_PLP_ID_LEGACY	43

#define DTV_ENUM_DELSYS		44

/* ATSC-MH */
#define DTV_ATSCMH_FIC_VER		45
#define DTV_ATSCMH_PARADE_ID		46
#define DTV_ATSCMH_NOG			47
#define DTV_ATSCMH_TNOG			48
#define DTV_ATSCMH_SGN			49
#define DTV_ATSCMH_PRC			50
#define DTV_ATSCMH_RS_FRAME_MODE	51
#define DTV_ATSCMH_RS_FRAME_ENSEMBLE	52
#define DTV_ATSCMH_RS_CODE_MODE_PRI	53
#define DTV_ATSCMH_RS_CODE_MODE_SEC	54
#define DTV_ATSCMH_SCCC_BLOCK_MODE	55
#define DTV_ATSCMH_SCCC_CODE_MODE_A	56
#define DTV_ATSCMH_SCCC_CODE_MODE_B	57
#define DTV_ATSCMH_SCCC_CODE_MODE_C	58
#define DTV_ATSCMH_SCCC_CODE_MODE_D	59

#define DTV_INTERLEAVING			60
#define DTV_LNA					61

#define DTV_MAX_COMMAND				DTV_LNA

typedef enum fe_pilot {
	PILOT_ON,
	PILOT_OFF,
	PILOT_AUTO,
} fe_pilot_t;

typedef enum fe_rolloff {
	ROLLOFF_35, /* Implied value in DVB-S, default for DVB-S2 */
	ROLLOFF_20,
	ROLLOFF_25,
	ROLLOFF_AUTO,
} fe_rolloff_t;

typedef enum fe_delivery_system {
	SYS_UNDEFINED,
	SYS_DVBC_ANNEX_A,
	SYS_DVBC_ANNEX_B,
	SYS_DVBT,
	SYS_DSS,
	SYS_DVBS,
	SYS_DVBS2,
	SYS_DVBH,
	SYS_ISDBT,
	SYS_ISDBS,
	SYS_ISDBC,
	SYS_ATSC,
	SYS_ATSCMH,
	SYS_DTMB,
	SYS_CMMB,
	SYS_DAB,
	SYS_DVBT2,
	SYS_TURBO,
	SYS_DVBC_ANNEX_C,
} fe_delivery_system_t;

/* backward compatibility */
#define SYS_DVBC_ANNEX_AC	SYS_DVBC_ANNEX_A
#define SYS_DMBTH SYS_DTMB /* DMB-TH is legacy name, use DTMB instead */

/* ATSC-MH */

enum atscmh_sccc_block_mode {
	ATSCMH_SCCC_BLK_SEP      = 0,
	ATSCMH_SCCC_BLK_COMB     = 1,
	ATSCMH_SCCC_BLK_RES      = 2,
};

enum atscmh_sccc_code_mode {
	ATSCMH_SCCC_CODE_HLF     = 0,
	ATSCMH_SCCC_CODE_QTR     = 1,
	ATSCMH_SCCC_CODE_RES     = 2,
};

enum atscmh_rs_frame_ensemble {
	ATSCMH_RSFRAME_ENS_PRI   = 0,
	ATSCMH_RSFRAME_ENS_SEC   = 1,
};

enum atscmh_rs_frame_mode {
	ATSCMH_RSFRAME_PRI_ONLY  = 0,
	ATSCMH_RSFRAME_PRI_SEC   = 1,
	ATSCMH_RSFRAME_RES       = 2,
};

enum atscmh_rs_code_mode {
	ATSCMH_RSCODE_211_187    = 0,
	ATSCMH_RSCODE_223_187    = 1,
	ATSCMH_RSCODE_235_187    = 2,
	ATSCMH_RSCODE_RES        = 3,
};

#define NO_STREAM_ID_FILTER	(~0U)
#define LNA_AUTO                (~0U)

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;
	int result;
} __attribute__ ((packed));

/* num of properties cannot exceed DTV_IOCTL_MAX_MSGS per ioctl */
#define DTV_IOCTL_MAX_MSGS 64

struct dtv_properties {
	__u32 num;
	struct dtv_property *props;
};

#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_*/
Commit	Line	Data
1da177e4 LT	1	/*
	2	* frontend.h
	3	*
	4	* Copyright (C) 2000 Marcus Metzler <marcus@convergence.de>
	5	* Ralph Metzler <ralph@convergence.de>
	6	* Holger Waechtler <holger@convergence.de>
	7	* Andre Draszik <ad@convergence.de>
	8	* for convergence integrated media GmbH
	9	*
	10	* This program is free software; you can redistribute it and/or
	11	* modify it under the terms of the GNU Lesser General Public License
	12	* as published by the Free Software Foundation; either version 2.1
	13	* of the License, or (at your option) any later version.
	14	*
	15	* This program is distributed in the hope that it will be useful,
	16	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	17	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	18	* GNU General Public License for more details.
	19	*
	20	* You should have received a copy of the GNU Lesser General Public License
	21	* along with this program; if not, write to the Free Software
	22	* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
	23	*
	24	*/
	25
	26	#ifndef _DVBFRONTEND_H_
	27	#define _DVBFRONTEND_H_
	28
de189f07	29	#include <linux/types.h>
1da177e4 LT	30
	31	typedef enum fe_type {
	32	FE_QPSK,
	33	FE_QAM,
	34	FE_OFDM,
	35	FE_ATSC
	36	} fe_type_t;
	37
	38
	39	typedef enum fe_caps {
	40	FE_IS_STUPID = 0,
	41	FE_CAN_INVERSION_AUTO = 0x1,
	42	FE_CAN_FEC_1_2 = 0x2,
	43	FE_CAN_FEC_2_3 = 0x4,
	44	FE_CAN_FEC_3_4 = 0x8,
	45	FE_CAN_FEC_4_5 = 0x10,
	46	FE_CAN_FEC_5_6 = 0x20,
	47	FE_CAN_FEC_6_7 = 0x40,
	48	FE_CAN_FEC_7_8 = 0x80,
	49	FE_CAN_FEC_8_9 = 0x100,
	50	FE_CAN_FEC_AUTO = 0x200,
	51	FE_CAN_QPSK = 0x400,
	52	FE_CAN_QAM_16 = 0x800,
	53	FE_CAN_QAM_32 = 0x1000,
	54	FE_CAN_QAM_64 = 0x2000,
	55	FE_CAN_QAM_128 = 0x4000,
	56	FE_CAN_QAM_256 = 0x8000,
	57	FE_CAN_QAM_AUTO = 0x10000,
	58	FE_CAN_TRANSMISSION_MODE_AUTO = 0x20000,
	59	FE_CAN_BANDWIDTH_AUTO = 0x40000,
	60	FE_CAN_GUARD_INTERVAL_AUTO = 0x80000,
	61	FE_CAN_HIERARCHY_AUTO = 0x100000,
	62	FE_CAN_8VSB = 0x200000,
	63	FE_CAN_16VSB = 0x400000,
e4cda3e0	64	FE_HAS_EXTENDED_CAPS = 0x800000, /* We need more bitspace for newer APIs, indicate this. */
287cefd0	65	FE_CAN_MULTISTREAM = 0x4000000, /* frontend supports multistream filtering */
f6a20eb1	66	FE_CAN_TURBO_FEC = 0x8000000, /* frontend supports "turbo fec modulation" */
e4cda3e0 MCC	67	FE_CAN_2G_MODULATION = 0x10000000, /* frontend supports "2nd generation modulation" (DVB-S2) */
	68	FE_NEEDS_BENDING = 0x20000000, /* not supported anymore, don't use (frontend requires frequency bending) */
	69	FE_CAN_RECOVER = 0x40000000, /* frontend can recover from a cable unplug automatically */
	70	FE_CAN_MUTE_TS = 0x80000000 /* frontend can stop spurious TS data output */
1da177e4 LT	71	} fe_caps_t;
	72
	73
	74	struct dvb_frontend_info {
	75	char name[128];
cd7d494d	76	fe_type_t type; /* DEPRECATED. Use DTV_ENUM_DELSYS instead */
1da177e4 LT	77	__u32 frequency_min;
	78	__u32 frequency_max;
	79	__u32 frequency_stepsize;
	80	__u32 frequency_tolerance;
	81	__u32 symbol_rate_min;
	82	__u32 symbol_rate_max;
	83	__u32 symbol_rate_tolerance; /* ppm */
	84	__u32 notifier_delay; /* DEPRECATED */
	85	fe_caps_t caps;
	86	};
	87
	88
	89	/**
	90	* Check out the DiSEqC bus spec available on http://www.eutelsat.org/ for
	91	* the meaning of this struct...
	92	*/
	93	struct dvb_diseqc_master_cmd {
	94	__u8 msg [6]; /* { framing, address, command, data [3] } */
	95	__u8 msg_len; /* valid values are 3...6 */
	96	};
	97
	98
	99	struct dvb_diseqc_slave_reply {
	100	__u8 msg [4]; /* { framing, data [3] } */
	101	__u8 msg_len; /* valid values are 0...4, 0 means no msg */
	102	int timeout; /* return from ioctl after timeout ms with */
	103	}; /* errorcode when no message was received */
	104
	105
	106	typedef enum fe_sec_voltage {
	107	SEC_VOLTAGE_13,
	108	SEC_VOLTAGE_18,
	109	SEC_VOLTAGE_OFF
	110	} fe_sec_voltage_t;
	111
	112
	113	typedef enum fe_sec_tone_mode {
	114	SEC_TONE_ON,
	115	SEC_TONE_OFF
	116	} fe_sec_tone_mode_t;
	117
	118
	119	typedef enum fe_sec_mini_cmd {
	120	SEC_MINI_A,
	121	SEC_MINI_B
	122	} fe_sec_mini_cmd_t;
	123
	124
0d27bbfe MCC	125	/**
	126	* enum fe_status - enumerates the possible frontend status
	127	* @FE_HAS_SIGNAL: found something above the noise level
	128	* @FE_HAS_CARRIER: found a DVB signal
	129	* @FE_HAS_VITERBI: FEC is stable
	130	* @FE_HAS_SYNC: found sync bytes
	131	* @FE_HAS_LOCK: everything's working
	132	* @FE_TIMEDOUT: no lock within the last ~2 seconds
	133	* @FE_REINIT: frontend was reinitialized, application is recommended
	134	* to reset DiSEqC, tone and parameters
	135	*/
	136
1da177e4	137	typedef enum fe_status {
0d27bbfe MCC	138	FE_HAS_SIGNAL = 0x01,
	139	FE_HAS_CARRIER = 0x02,
	140	FE_HAS_VITERBI = 0x04,
	141	FE_HAS_SYNC = 0x08,
	142	FE_HAS_LOCK = 0x10,
	143	FE_TIMEDOUT = 0x20,
	144	FE_REINIT = 0x40,
	145	} fe_status_t;
1da177e4 LT	146
	147	typedef enum fe_spectral_inversion {
	148	INVERSION_OFF,
	149	INVERSION_ON,
	150	INVERSION_AUTO
	151	} fe_spectral_inversion_t;
	152
	153
	154	typedef enum fe_code_rate {
	155	FEC_NONE = 0,
	156	FEC_1_2,
	157	FEC_2_3,
	158	FEC_3_4,
	159	FEC_4_5,
	160	FEC_5_6,
	161	FEC_6_7,
	162	FEC_7_8,
	163	FEC_8_9,
6b73eeaf ST	164	FEC_AUTO,
	165	FEC_3_5,
	166	FEC_9_10,
224b6642	167	FEC_2_5,
1da177e4 LT	168	} fe_code_rate_t;
	169
	170
	171	typedef enum fe_modulation {
	172	QPSK,
	173	QAM_16,
	174	QAM_32,
	175	QAM_64,
	176	QAM_128,
	177	QAM_256,
	178	QAM_AUTO,
	179	VSB_8,
6b73eeaf	180	VSB_16,
0a6393ae ST	181	PSK_8,
0a6393ae ST	182	APSK_16,
97854829	183	APSK_32,
6b73eeaf	184	DQPSK,
224b6642	185	QAM_4_NR,
1da177e4 LT	186	} fe_modulation_t;
	187
	188	typedef enum fe_transmit_mode {
	189	TRANSMISSION_MODE_2K,
	190	TRANSMISSION_MODE_8K,
b6e760f3	191	TRANSMISSION_MODE_AUTO,
94d56ffa AO	192	TRANSMISSION_MODE_4K,
	193	TRANSMISSION_MODE_1K,
	194	TRANSMISSION_MODE_16K,
	195	TRANSMISSION_MODE_32K,
224b6642 AP	196	TRANSMISSION_MODE_C1,
224b6642 AP	197	TRANSMISSION_MODE_C3780,
1da177e4 LT	198	} fe_transmit_mode_t;
1da177e4 LT	199
8de8594a	200	#if defined(__DVB_CORE__) \|\| !defined (__KERNEL__)
1da177e4 LT	201	typedef enum fe_bandwidth {
	202	BANDWIDTH_8_MHZ,
	203	BANDWIDTH_7_MHZ,
	204	BANDWIDTH_6_MHZ,
94d56ffa AO	205	BANDWIDTH_AUTO,
	206	BANDWIDTH_5_MHZ,
	207	BANDWIDTH_10_MHZ,
	208	BANDWIDTH_1_712_MHZ,
1da177e4	209	} fe_bandwidth_t;
8de8594a	210	#endif
1da177e4 LT	211
	212	typedef enum fe_guard_interval {
	213	GUARD_INTERVAL_1_32,
	214	GUARD_INTERVAL_1_16,
	215	GUARD_INTERVAL_1_8,
	216	GUARD_INTERVAL_1_4,
94d56ffa AO	217	GUARD_INTERVAL_AUTO,
	218	GUARD_INTERVAL_1_128,
	219	GUARD_INTERVAL_19_128,
	220	GUARD_INTERVAL_19_256,
224b6642 AP	221	GUARD_INTERVAL_PN420,
	222	GUARD_INTERVAL_PN595,
	223	GUARD_INTERVAL_PN945,
1da177e4 LT	224	} fe_guard_interval_t;
	225
	226
	227	typedef enum fe_hierarchy {
	228	HIERARCHY_NONE,
	229	HIERARCHY_1,
	230	HIERARCHY_2,
	231	HIERARCHY_4,
	232	HIERARCHY_AUTO
	233	} fe_hierarchy_t;
	234
224b6642 AP	235	enum fe_interleaving {
224b6642 AP	236	INTERLEAVING_NONE,
8746adda	237	INTERLEAVING_AUTO,
224b6642 AP	238	INTERLEAVING_240,
	239	INTERLEAVING_720,
	240	};
1da177e4	241
8de8594a	242	#if defined(__DVB_CORE__) \|\| !defined (__KERNEL__)
1da177e4 LT	243	struct dvb_qpsk_parameters {
	244	__u32 symbol_rate; /* symbol rate in Symbols per second */
	245	fe_code_rate_t fec_inner; /* forward error correction (see above) */
	246	};
	247
	248	struct dvb_qam_parameters {
	249	__u32 symbol_rate; /* symbol rate in Symbols per second */
	250	fe_code_rate_t fec_inner; /* forward error correction (see above) */
	251	fe_modulation_t modulation; /* modulation type (see above) */
	252	};
	253
	254	struct dvb_vsb_parameters {
	255	fe_modulation_t modulation; /* modulation type (see above) */
	256	};
	257
	258	struct dvb_ofdm_parameters {
	259	fe_bandwidth_t bandwidth;
	260	fe_code_rate_t code_rate_HP; /* high priority stream code rate */
	261	fe_code_rate_t code_rate_LP; /* low priority stream code rate */
	262	fe_modulation_t constellation; /* modulation type (see above) */
	263	fe_transmit_mode_t transmission_mode;
	264	fe_guard_interval_t guard_interval;
	265	fe_hierarchy_t hierarchy_information;
	266	};
	267
	268
	269	struct dvb_frontend_parameters {
	270	__u32 frequency; /* (absolute) frequency in Hz for QAM/OFDM/ATSC */
	271	/* intermediate frequency in kHz for QPSK */
	272	fe_spectral_inversion_t inversion;
	273	union {
	274	struct dvb_qpsk_parameters qpsk;
	275	struct dvb_qam_parameters qam;
	276	struct dvb_ofdm_parameters ofdm;
	277	struct dvb_vsb_parameters vsb;
	278	} u;
	279	};
	280
1da177e4 LT	281	struct dvb_frontend_event {
	282	fe_status_t status;
	283	struct dvb_frontend_parameters parameters;
	284	};
8de8594a	285	#endif
1da177e4	286
459702bf ST	287	/* S2API Commands */
	288	#define DTV_UNDEFINED 0
	289	#define DTV_TUNE 1
	290	#define DTV_CLEAR 2
	291	#define DTV_FREQUENCY 3
	292	#define DTV_MODULATION 4
	293	#define DTV_BANDWIDTH_HZ 5
	294	#define DTV_INVERSION 6
	295	#define DTV_DISEQC_MASTER 7
	296	#define DTV_SYMBOL_RATE 8
	297	#define DTV_INNER_FEC 9
	298	#define DTV_VOLTAGE 10
	299	#define DTV_TONE 11
	300	#define DTV_PILOT 12
	301	#define DTV_ROLLOFF 13
	302	#define DTV_DISEQC_SLAVE_REPLY 14
	303
	304	/* Basic enumeration set for querying unlimited capabilities */
	305	#define DTV_FE_CAPABILITY_COUNT 15
	306	#define DTV_FE_CAPABILITY 16
	307	#define DTV_DELIVERY_SYSTEM 17
	308
b6e760f3 PB	309	/* ISDB-T and ISDB-Tsb */
	310	#define DTV_ISDBT_PARTIAL_RECEPTION 18
	311	#define DTV_ISDBT_SOUND_BROADCASTING 19
6b73eeaf	312
b6e760f3 PB	313	#define DTV_ISDBT_SB_SUBCHANNEL_ID 20
	314	#define DTV_ISDBT_SB_SEGMENT_IDX 21
	315	#define DTV_ISDBT_SB_SEGMENT_COUNT 22
	316
	317	#define DTV_ISDBT_LAYERA_FEC 23
	318	#define DTV_ISDBT_LAYERA_MODULATION 24
	319	#define DTV_ISDBT_LAYERA_SEGMENT_COUNT 25
	320	#define DTV_ISDBT_LAYERA_TIME_INTERLEAVING 26
	321
	322	#define DTV_ISDBT_LAYERB_FEC 27
	323	#define DTV_ISDBT_LAYERB_MODULATION 28
	324	#define DTV_ISDBT_LAYERB_SEGMENT_COUNT 29
	325	#define DTV_ISDBT_LAYERB_TIME_INTERLEAVING 30
	326
	327	#define DTV_ISDBT_LAYERC_FEC 31
	328	#define DTV_ISDBT_LAYERC_MODULATION 32
	329	#define DTV_ISDBT_LAYERC_SEGMENT_COUNT 33
	330	#define DTV_ISDBT_LAYERC_TIME_INTERLEAVING 34
	331
	332	#define DTV_API_VERSION 35
	333
	334	#define DTV_CODE_RATE_HP 36
	335	#define DTV_CODE_RATE_LP 37
	336	#define DTV_GUARD_INTERVAL 38
	337	#define DTV_TRANSMISSION_MODE 39
	338	#define DTV_HIERARCHY 40
	339
	340	#define DTV_ISDBT_LAYER_ENABLED 41
	341
287cefd0 EP	342	#define DTV_STREAM_ID 42
	343	#define DTV_ISDBS_TS_ID_LEGACY DTV_STREAM_ID
	344	#define DTV_DVBT2_PLP_ID_LEGACY 43
94d56ffa	345
ba2780c7 MA	346	#define DTV_ENUM_DELSYS 44
ba2780c7 MA	347
ca689488 MK	348	/* ATSC-MH */
	349	#define DTV_ATSCMH_FIC_VER 45
	350	#define DTV_ATSCMH_PARADE_ID 46
	351	#define DTV_ATSCMH_NOG 47
	352	#define DTV_ATSCMH_TNOG 48
	353	#define DTV_ATSCMH_SGN 49
	354	#define DTV_ATSCMH_PRC 50
	355	#define DTV_ATSCMH_RS_FRAME_MODE 51
	356	#define DTV_ATSCMH_RS_FRAME_ENSEMBLE 52
	357	#define DTV_ATSCMH_RS_CODE_MODE_PRI 53
	358	#define DTV_ATSCMH_RS_CODE_MODE_SEC 54
	359	#define DTV_ATSCMH_SCCC_BLOCK_MODE 55
	360	#define DTV_ATSCMH_SCCC_CODE_MODE_A 56
	361	#define DTV_ATSCMH_SCCC_CODE_MODE_B 57
	362	#define DTV_ATSCMH_SCCC_CODE_MODE_C 58
	363	#define DTV_ATSCMH_SCCC_CODE_MODE_D 59
ca689488	364
224b6642	365	#define DTV_INTERLEAVING 60
8a2697ab	366	#define DTV_LNA 61
224b6642	367
8a2697ab	368	#define DTV_MAX_COMMAND DTV_LNA
82d7669d	369
6b73eeaf ST	370	typedef enum fe_pilot {
	371	PILOT_ON,
	372	PILOT_OFF,
	373	PILOT_AUTO,
	374	} fe_pilot_t;
	375
	376	typedef enum fe_rolloff {
a52f68c6	377	ROLLOFF_35, /* Implied value in DVB-S, default for DVB-S2 */
6b73eeaf ST	378	ROLLOFF_20,
6b73eeaf ST	379	ROLLOFF_25,
6b73eeaf ST	380	ROLLOFF_AUTO,
	381	} fe_rolloff_t;
	382
	383	typedef enum fe_delivery_system {
	384	SYS_UNDEFINED,
bf3b8400	385	SYS_DVBC_ANNEX_A,
6b73eeaf ST	386	SYS_DVBC_ANNEX_B,
6b73eeaf ST	387	SYS_DVBT,
5ba4ecc8	388	SYS_DSS,
6b73eeaf ST	389	SYS_DVBS,
	390	SYS_DVBS2,
	391	SYS_DVBH,
	392	SYS_ISDBT,
	393	SYS_ISDBS,
	394	SYS_ISDBC,
	395	SYS_ATSC,
	396	SYS_ATSCMH,
224b6642	397	SYS_DTMB,
6b73eeaf ST	398	SYS_CMMB,
6b73eeaf ST	399	SYS_DAB,
94d56ffa	400	SYS_DVBT2,
83dc314b	401	SYS_TURBO,
bf3b8400	402	SYS_DVBC_ANNEX_C,
6b73eeaf ST	403	} fe_delivery_system_t;
6b73eeaf ST	404
224b6642	405	/* backward compatibility */
bf3b8400	406	#define SYS_DVBC_ANNEX_AC SYS_DVBC_ANNEX_A
224b6642	407	#define SYS_DMBTH SYS_DTMB /* DMB-TH is legacy name, use DTMB instead */
bf3b8400	408
ca689488 MK	409	/* ATSC-MH */
	410
	411	enum atscmh_sccc_block_mode {
	412	ATSCMH_SCCC_BLK_SEP = 0,
	413	ATSCMH_SCCC_BLK_COMB = 1,
	414	ATSCMH_SCCC_BLK_RES = 2,
	415	};
	416
	417	enum atscmh_sccc_code_mode {
	418	ATSCMH_SCCC_CODE_HLF = 0,
	419	ATSCMH_SCCC_CODE_QTR = 1,
	420	ATSCMH_SCCC_CODE_RES = 2,
	421	};
	422
	423	enum atscmh_rs_frame_ensemble {
	424	ATSCMH_RSFRAME_ENS_PRI = 0,
	425	ATSCMH_RSFRAME_ENS_SEC = 1,
	426	};
	427
	428	enum atscmh_rs_frame_mode {
	429	ATSCMH_RSFRAME_PRI_ONLY = 0,
	430	ATSCMH_RSFRAME_PRI_SEC = 1,
	431	ATSCMH_RSFRAME_RES = 2,
	432	};
	433
	434	enum atscmh_rs_code_mode {
	435	ATSCMH_RSCODE_211_187 = 0,
	436	ATSCMH_RSCODE_223_187 = 1,
	437	ATSCMH_RSCODE_235_187 = 2,
	438	ATSCMH_RSCODE_RES = 3,
	439	};
	440
287cefd0	441	#define NO_STREAM_ID_FILTER (~0U)
8a2697ab	442	#define LNA_AUTO (~0U)
bf3b8400	443
56f0680a	444	struct dtv_cmds_h {
6b73eeaf ST	445	char name; / A display name for debugging purposes */
	446
	447	__u32 cmd; /* A unique ID */
	448
	449	/* Flags */
	450	__u32 set:1; /* Either a set or get property */
	451	__u32 buffer:1; /* Does this property use the buffer? */
	452	__u32 reserved:30; /* Align */
	453	};
	454
e7fee0f3	455	struct dtv_property {
6b73eeaf	456	__u32 cmd;
e7fee0f3	457	__u32 reserved[3];
6b73eeaf ST	458	union {
	459	__u32 data;
	460	struct {
	461	__u8 data[32];
	462	__u32 len;
e7fee0f3 ST	463	__u32 reserved1[3];
e7fee0f3 ST	464	void *reserved2;
6b73eeaf ST	465	} buffer;
6b73eeaf ST	466	} u;
d48cb402	467	int result;
e7fee0f3	468	} __attribute__ ((packed));
6b73eeaf	469
cc7d705e BP	470	/* num of properties cannot exceed DTV_IOCTL_MAX_MSGS per ioctl */
	471	#define DTV_IOCTL_MAX_MSGS 64
	472
e7fee0f3 ST	473	struct dtv_properties {
	474	__u32 num;
	475	struct dtv_property *props;
	476	};
	477
e7fee0f3 ST	478	#define FE_SET_PROPERTY _IOW('o', 82, struct dtv_properties)
e7fee0f3 ST	479	#define FE_GET_PROPERTY _IOR('o', 83, struct dtv_properties)
6b73eeaf	480
1da177e4	481
36cb557a AQ	482	/**
	483	* When set, this flag will disable any zigzagging or other "normal" tuning
	484	* behaviour. Additionally, there will be no automatic monitoring of the lock
	485	* status, and hence no frontend events will be generated. If a frontend device
	486	* is closed, this flag will be automatically turned off when the device is
	487	* reopened read-write.
	488	*/
	489	#define FE_TUNE_MODE_ONESHOT 0x01
	490
1da177e4 LT	491
	492	#define FE_GET_INFO _IOR('o', 61, struct dvb_frontend_info)
	493
	494	#define FE_DISEQC_RESET_OVERLOAD _IO('o', 62)
	495	#define FE_DISEQC_SEND_MASTER_CMD _IOW('o', 63, struct dvb_diseqc_master_cmd)
	496	#define FE_DISEQC_RECV_SLAVE_REPLY _IOR('o', 64, struct dvb_diseqc_slave_reply)
	497	#define FE_DISEQC_SEND_BURST _IO('o', 65) /* fe_sec_mini_cmd_t */
	498
	499	#define FE_SET_TONE _IO('o', 66) /* fe_sec_tone_mode_t */
	500	#define FE_SET_VOLTAGE _IO('o', 67) /* fe_sec_voltage_t */
	501	#define FE_ENABLE_HIGH_LNB_VOLTAGE _IO('o', 68) /* int */
	502
	503	#define FE_READ_STATUS _IOR('o', 69, fe_status_t)
	504	#define FE_READ_BER _IOR('o', 70, __u32)
	505	#define FE_READ_SIGNAL_STRENGTH _IOR('o', 71, __u16)
	506	#define FE_READ_SNR _IOR('o', 72, __u16)
	507	#define FE_READ_UNCORRECTED_BLOCKS _IOR('o', 73, __u32)
	508
	509	#define FE_SET_FRONTEND _IOW('o', 76, struct dvb_frontend_parameters)
	510	#define FE_GET_FRONTEND _IOR('o', 77, struct dvb_frontend_parameters)
36cb557a	511	#define FE_SET_FRONTEND_TUNE_MODE _IO('o', 81) /* unsigned int */
1da177e4 LT	512	#define FE_GET_EVENT _IOR('o', 78, struct dvb_frontend_event)
	513
	514	#define FE_DISHNETWORK_SEND_LEGACY_CMD _IO('o', 80) /* unsigned int */
	515
	516	#endif /_DVBFRONTEND_H_/