1/* 2 * dvb_frontend.h 3 * 4 * Copyright (C) 2001 convergence integrated media GmbH 5 * Copyright (C) 2004 convergence GmbH 6 * 7 * Written by Ralph Metzler 8 * Overhauled by Holger Waechtler 9 * Kernel I2C stuff by Michael Hunold <hunold@convergence.de> 10 * 11 * This program is free software; you can redistribute it and/or 12 * modify it under the terms of the GNU Lesser General Public License 13 * as published by the Free Software Foundation; either version 2.1 14 * of the License, or (at your option) any later version. 15 * 16 * This program is distributed in the hope that it will be useful, 17 * but WITHOUT ANY WARRANTY; without even the implied warranty of 18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 19 * GNU General Public License for more details. 20 * 21 22 * You should have received a copy of the GNU Lesser General Public License 23 * along with this program; if not, write to the Free Software 24 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. 25 * 26 */ 27 28#ifndef _DVB_FRONTEND_H_ 29#define _DVB_FRONTEND_H_ 30 31#include <linux/types.h> 32#include <linux/sched.h> 33#include <linux/ioctl.h> 34#include <linux/i2c.h> 35#include <linux/module.h> 36#include <linux/errno.h> 37#include <linux/delay.h> 38#include <linux/mutex.h> 39#include <linux/slab.h> 40 41#include <linux/dvb/frontend.h> 42 43#include "dvbdev.h" 44 45struct dvb_frontend_tune_settings { 46 int min_delay_ms; 47 int step_size; 48 int max_drift; 49 struct dvb_frontend_parameters parameters; 50}; 51 52struct dvb_frontend; 53 54struct dvb_tuner_info { 55 char name[128]; 56 57 u32 frequency_min; 58 u32 frequency_max; 59 u32 frequency_step; 60 61 u32 bandwidth_min; 62 u32 bandwidth_max; 63 u32 bandwidth_step; 64}; 65 66struct analog_parameters { 67 unsigned int frequency; 68 unsigned int mode; 69 unsigned int audmode; 70 u64 std; 71}; 72 73enum dvbfe_modcod { 74 DVBFE_MODCOD_DUMMY_PLFRAME = 0, 75 DVBFE_MODCOD_QPSK_1_4, 76 DVBFE_MODCOD_QPSK_1_3, 77 DVBFE_MODCOD_QPSK_2_5, 78 DVBFE_MODCOD_QPSK_1_2, 79 DVBFE_MODCOD_QPSK_3_5, 80 DVBFE_MODCOD_QPSK_2_3, 81 DVBFE_MODCOD_QPSK_3_4, 82 DVBFE_MODCOD_QPSK_4_5, 83 DVBFE_MODCOD_QPSK_5_6, 84 DVBFE_MODCOD_QPSK_8_9, 85 DVBFE_MODCOD_QPSK_9_10, 86 DVBFE_MODCOD_8PSK_3_5, 87 DVBFE_MODCOD_8PSK_2_3, 88 DVBFE_MODCOD_8PSK_3_4, 89 DVBFE_MODCOD_8PSK_5_6, 90 DVBFE_MODCOD_8PSK_8_9, 91 DVBFE_MODCOD_8PSK_9_10, 92 DVBFE_MODCOD_16APSK_2_3, 93 DVBFE_MODCOD_16APSK_3_4, 94 DVBFE_MODCOD_16APSK_4_5, 95 DVBFE_MODCOD_16APSK_5_6, 96 DVBFE_MODCOD_16APSK_8_9, 97 DVBFE_MODCOD_16APSK_9_10, 98 DVBFE_MODCOD_32APSK_3_4, 99 DVBFE_MODCOD_32APSK_4_5, 100 DVBFE_MODCOD_32APSK_5_6, 101 DVBFE_MODCOD_32APSK_8_9, 102 DVBFE_MODCOD_32APSK_9_10, 103 DVBFE_MODCOD_RESERVED_1, 104 DVBFE_MODCOD_BPSK_1_3, 105 DVBFE_MODCOD_BPSK_1_4, 106 DVBFE_MODCOD_RESERVED_2 107}; 108 109enum tuner_param { 110 DVBFE_TUNER_FREQUENCY = (1 << 0), 111 DVBFE_TUNER_TUNERSTEP = (1 << 1), 112 DVBFE_TUNER_IFFREQ = (1 << 2), 113 DVBFE_TUNER_BANDWIDTH = (1 << 3), 114 DVBFE_TUNER_REFCLOCK = (1 << 4), 115 DVBFE_TUNER_IQSENSE = (1 << 5), 116 DVBFE_TUNER_DUMMY = (1 << 31) 117}; 118 119/* 120 * ALGO_HW: (Hardware Algorithm) 121 * ---------------------------------------------------------------- 122 * Devices that support this algorithm do everything in hardware 123 * and no software support is needed to handle them. 124 * Requesting these devices to LOCK is the only thing required, 125 * device is supposed to do everything in the hardware. 126 * 127 * ALGO_SW: (Software Algorithm) 128 * ---------------------------------------------------------------- 129 * These are dumb devices, that require software to do everything 130 * 131 * ALGO_CUSTOM: (Customizable Agorithm) 132 * ---------------------------------------------------------------- 133 * Devices having this algorithm can be customized to have specific 134 * algorithms in the frontend driver, rather than simply doing a 135 * software zig-zag. In this case the zigzag maybe hardware assisted 136 * or it maybe completely done in hardware. In all cases, usage of 137 * this algorithm, in conjunction with the search and track 138 * callbacks, utilizes the driver specific algorithm. 139 * 140 * ALGO_RECOVERY: (Recovery Algorithm) 141 * ---------------------------------------------------------------- 142 * These devices have AUTO recovery capabilities from LOCK failure 143 */ 144enum dvbfe_algo { 145 DVBFE_ALGO_HW = (1 << 0), 146 DVBFE_ALGO_SW = (1 << 1), 147 DVBFE_ALGO_CUSTOM = (1 << 2), 148 DVBFE_ALGO_RECOVERY = (1 << 31) 149}; 150 151struct tuner_state { 152 u32 frequency; 153 u32 tunerstep; 154 u32 ifreq; 155 u32 bandwidth; 156 u32 iqsense; 157 u32 refclock; 158}; 159 160/* 161 * search callback possible return status 162 * 163 * DVBFE_ALGO_SEARCH_SUCCESS 164 * The frontend search algorithm completed and returned successfully 165 * 166 * DVBFE_ALGO_SEARCH_ASLEEP 167 * The frontend search algorithm is sleeping 168 * 169 * DVBFE_ALGO_SEARCH_FAILED 170 * The frontend search for a signal failed 171 * 172 * DVBFE_ALGO_SEARCH_INVALID 173 * The frontend search algorith was probably supplied with invalid 174 * parameters and the search is an invalid one 175 * 176 * DVBFE_ALGO_SEARCH_ERROR 177 * The frontend search algorithm failed due to some error 178 * 179 * DVBFE_ALGO_SEARCH_AGAIN 180 * The frontend search algorithm was requested to search again 181 */ 182enum dvbfe_search { 183 DVBFE_ALGO_SEARCH_SUCCESS = (1 << 0), 184 DVBFE_ALGO_SEARCH_ASLEEP = (1 << 1), 185 DVBFE_ALGO_SEARCH_FAILED = (1 << 2), 186 DVBFE_ALGO_SEARCH_INVALID = (1 << 3), 187 DVBFE_ALGO_SEARCH_AGAIN = (1 << 4), 188 DVBFE_ALGO_SEARCH_ERROR = (1 << 31), 189}; 190 191 192struct dvb_tuner_ops { 193 194 struct dvb_tuner_info info; 195 196 int (*release)(struct dvb_frontend *fe); 197 int (*init)(struct dvb_frontend *fe); 198 int (*sleep)(struct dvb_frontend *fe); 199 200 /** This is for simple PLLs - set all parameters in one go. */ 201 int (*set_params)(struct dvb_frontend *fe, struct dvb_frontend_parameters *p); 202 int (*set_analog_params)(struct dvb_frontend *fe, struct analog_parameters *p); 203 204 /** This is support for demods like the mt352 - fills out the supplied buffer with what to write. */ 205 int (*calc_regs)(struct dvb_frontend *fe, struct dvb_frontend_parameters *p, u8 *buf, int buf_len); 206 207 /** This is to allow setting tuner-specific configs */ 208 int (*set_config)(struct dvb_frontend *fe, void *priv_cfg); 209 210 int (*get_frequency)(struct dvb_frontend *fe, u32 *frequency); 211 int (*get_bandwidth)(struct dvb_frontend *fe, u32 *bandwidth); 212 213#define TUNER_STATUS_LOCKED 1 214#define TUNER_STATUS_STEREO 2 215 int (*get_status)(struct dvb_frontend *fe, u32 *status); 216 int (*get_rf_strength)(struct dvb_frontend *fe, u16 *strength); 217 218 /** These are provided separately from set_params in order to facilitate silicon 219 * tuners which require sophisticated tuning loops, controlling each parameter separately. */ 220 int (*set_frequency)(struct dvb_frontend *fe, u32 frequency); 221 int (*set_bandwidth)(struct dvb_frontend *fe, u32 bandwidth); 222 223 /* 224 * These are provided separately from set_params in order to facilitate silicon 225 * tuners which require sophisticated tuning loops, controlling each parameter separately. 226 */ 227 int (*set_state)(struct dvb_frontend *fe, enum tuner_param param, struct tuner_state *state); 228 int (*get_state)(struct dvb_frontend *fe, enum tuner_param param, struct tuner_state *state); 229}; 230 231struct analog_demod_info { 232 char *name; 233}; 234 235struct analog_demod_ops { 236 237 struct analog_demod_info info; 238 239 void (*set_params)(struct dvb_frontend *fe, 240 struct analog_parameters *params); 241 int (*has_signal)(struct dvb_frontend *fe); 242 int (*is_stereo)(struct dvb_frontend *fe); 243 int (*get_afc)(struct dvb_frontend *fe); 244 void (*tuner_status)(struct dvb_frontend *fe); 245 void (*standby)(struct dvb_frontend *fe); 246 void (*release)(struct dvb_frontend *fe); 247 int (*i2c_gate_ctrl)(struct dvb_frontend *fe, int enable); 248 249 /** This is to allow setting tuner-specific configuration */ 250 int (*set_config)(struct dvb_frontend *fe, void *priv_cfg); 251}; 252 253struct dvb_frontend_ops { 254 255 struct dvb_frontend_info info; 256 257 void (*release)(struct dvb_frontend* fe); 258 void (*release_sec)(struct dvb_frontend* fe); 259 260 int (*init)(struct dvb_frontend* fe); 261 int (*sleep)(struct dvb_frontend* fe); 262 263 int (*write)(struct dvb_frontend* fe, u8* buf, int len); 264 265 /* if this is set, it overrides the default swzigzag */ 266 int (*tune)(struct dvb_frontend* fe, 267 struct dvb_frontend_parameters* params, 268 unsigned int mode_flags, 269 unsigned int *delay, 270 fe_status_t *status); 271 /* get frontend tuning algorithm from the module */ 272 enum dvbfe_algo (*get_frontend_algo)(struct dvb_frontend *fe); 273 274 /* these two are only used for the swzigzag code */ 275 int (*set_frontend)(struct dvb_frontend* fe, struct dvb_frontend_parameters* params); 276 int (*get_tune_settings)(struct dvb_frontend* fe, struct dvb_frontend_tune_settings* settings); 277 278 int (*get_frontend)(struct dvb_frontend* fe, struct dvb_frontend_parameters* params); 279 280 int (*read_status)(struct dvb_frontend* fe, fe_status_t* status); 281 int (*read_ber)(struct dvb_frontend* fe, u32* ber); 282 int (*read_signal_strength)(struct dvb_frontend* fe, u16* strength); 283 int (*read_snr)(struct dvb_frontend* fe, u16* snr); 284 int (*read_ucblocks)(struct dvb_frontend* fe, u32* ucblocks); 285 286 int (*diseqc_reset_overload)(struct dvb_frontend* fe); 287 int (*diseqc_send_master_cmd)(struct dvb_frontend* fe, struct dvb_diseqc_master_cmd* cmd); 288 int (*diseqc_recv_slave_reply)(struct dvb_frontend* fe, struct dvb_diseqc_slave_reply* reply); 289 int (*diseqc_send_burst)(struct dvb_frontend* fe, fe_sec_mini_cmd_t minicmd); 290 int (*set_tone)(struct dvb_frontend* fe, fe_sec_tone_mode_t tone); 291 int (*set_voltage)(struct dvb_frontend* fe, fe_sec_voltage_t voltage); 292 int (*enable_high_lnb_voltage)(struct dvb_frontend* fe, long arg); 293 int (*dishnetwork_send_legacy_command)(struct dvb_frontend* fe, unsigned long cmd); 294 int (*i2c_gate_ctrl)(struct dvb_frontend* fe, int enable); 295 int (*ts_bus_ctrl)(struct dvb_frontend* fe, int acquire); 296 297 /* These callbacks are for devices that implement their own 298 * tuning algorithms, rather than a simple swzigzag 299 */ 300 enum dvbfe_search (*search)(struct dvb_frontend *fe, struct dvb_frontend_parameters *p); 301 int (*track)(struct dvb_frontend *fe, struct dvb_frontend_parameters *p); 302 303 struct dvb_tuner_ops tuner_ops; 304 struct analog_demod_ops analog_ops; 305 306 int (*set_property)(struct dvb_frontend* fe, struct dtv_property* tvp); 307 int (*get_property)(struct dvb_frontend* fe, struct dtv_property* tvp); 308}; 309 310#define MAX_EVENT 8 311 312struct dvb_fe_events { 313 struct dvb_frontend_event events[MAX_EVENT]; 314 int eventw; 315 int eventr; 316 int overflow; 317 wait_queue_head_t wait_queue; 318 struct mutex mtx; 319}; 320 321struct dtv_frontend_properties { 322 323 /* Cache State */ 324 u32 state; 325 326 u32 frequency; 327 fe_modulation_t modulation; 328 329 fe_sec_voltage_t voltage; 330 fe_sec_tone_mode_t sectone; 331 fe_spectral_inversion_t inversion; 332 fe_code_rate_t fec_inner; 333 fe_transmit_mode_t transmission_mode; 334 u32 bandwidth_hz; /* 0 = AUTO */ 335 fe_guard_interval_t guard_interval; 336 fe_hierarchy_t hierarchy; 337 u32 symbol_rate; 338 fe_code_rate_t code_rate_HP; 339 fe_code_rate_t code_rate_LP; 340 341 fe_pilot_t pilot; 342 fe_rolloff_t rolloff; 343 344 fe_delivery_system_t delivery_system; 345 346 /* ISDB-T specifics */ 347 u8 isdbt_partial_reception; 348 u8 isdbt_sb_mode; 349 u8 isdbt_sb_subchannel; 350 u32 isdbt_sb_segment_idx; 351 u32 isdbt_sb_segment_count; 352 u8 isdbt_layer_enabled; 353 struct { 354 u8 segment_count; 355 fe_code_rate_t fec; 356 fe_modulation_t modulation; 357 u8 interleaving; 358 } layer[3]; 359 360 /* ISDB-T specifics */ 361 u32 isdbs_ts_id; 362}; 363 364struct dvb_frontend { 365 struct dvb_frontend_ops ops; 366 struct dvb_adapter *dvb; 367 void *demodulator_priv; 368 void *tuner_priv; 369 void *frontend_priv; 370 void *sec_priv; 371 void *analog_demod_priv; 372 struct dtv_frontend_properties dtv_property_cache; 373#define DVB_FRONTEND_COMPONENT_TUNER 0 374 int (*callback)(void *adapter_priv, int component, int cmd, int arg); 375 int id; 376}; 377 378extern int dvb_register_frontend(struct dvb_adapter *dvb, 379 struct dvb_frontend *fe); 380 381extern int dvb_unregister_frontend(struct dvb_frontend *fe); 382 383extern void dvb_frontend_detach(struct dvb_frontend *fe); 384 385extern void dvb_frontend_reinitialise(struct dvb_frontend *fe); 386 387extern void dvb_frontend_sleep_until(struct timeval *waketime, u32 add_usec); 388extern s32 timeval_usec_diff(struct timeval lasttime, struct timeval curtime); 389 390#endif 391