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 45 /* 46 * Maximum number of Delivery systems per frontend. It 47 * should be smaller or equal to 32 48 */ 49 #define MAX_DELSYS 8 50 51 struct dvb_frontend_tune_settings { 52 int min_delay_ms; 53 int step_size; 54 int max_drift; 55 }; 56 57 struct dvb_frontend; 58 59 struct dvb_tuner_info { 60 char name[128]; 61 62 u32 frequency_min; 63 u32 frequency_max; 64 u32 frequency_step; 65 66 u32 bandwidth_min; 67 u32 bandwidth_max; 68 u32 bandwidth_step; 69 }; 70 71 struct analog_parameters { 72 unsigned int frequency; 73 unsigned int mode; 74 unsigned int audmode; 75 u64 std; 76 }; 77 78 enum dvbfe_modcod { 79 DVBFE_MODCOD_DUMMY_PLFRAME = 0, 80 DVBFE_MODCOD_QPSK_1_4, 81 DVBFE_MODCOD_QPSK_1_3, 82 DVBFE_MODCOD_QPSK_2_5, 83 DVBFE_MODCOD_QPSK_1_2, 84 DVBFE_MODCOD_QPSK_3_5, 85 DVBFE_MODCOD_QPSK_2_3, 86 DVBFE_MODCOD_QPSK_3_4, 87 DVBFE_MODCOD_QPSK_4_5, 88 DVBFE_MODCOD_QPSK_5_6, 89 DVBFE_MODCOD_QPSK_8_9, 90 DVBFE_MODCOD_QPSK_9_10, 91 DVBFE_MODCOD_8PSK_3_5, 92 DVBFE_MODCOD_8PSK_2_3, 93 DVBFE_MODCOD_8PSK_3_4, 94 DVBFE_MODCOD_8PSK_5_6, 95 DVBFE_MODCOD_8PSK_8_9, 96 DVBFE_MODCOD_8PSK_9_10, 97 DVBFE_MODCOD_16APSK_2_3, 98 DVBFE_MODCOD_16APSK_3_4, 99 DVBFE_MODCOD_16APSK_4_5, 100 DVBFE_MODCOD_16APSK_5_6, 101 DVBFE_MODCOD_16APSK_8_9, 102 DVBFE_MODCOD_16APSK_9_10, 103 DVBFE_MODCOD_32APSK_3_4, 104 DVBFE_MODCOD_32APSK_4_5, 105 DVBFE_MODCOD_32APSK_5_6, 106 DVBFE_MODCOD_32APSK_8_9, 107 DVBFE_MODCOD_32APSK_9_10, 108 DVBFE_MODCOD_RESERVED_1, 109 DVBFE_MODCOD_BPSK_1_3, 110 DVBFE_MODCOD_BPSK_1_4, 111 DVBFE_MODCOD_RESERVED_2 112 }; 113 114 enum tuner_param { 115 DVBFE_TUNER_FREQUENCY = (1 << 0), 116 DVBFE_TUNER_TUNERSTEP = (1 << 1), 117 DVBFE_TUNER_IFFREQ = (1 << 2), 118 DVBFE_TUNER_BANDWIDTH = (1 << 3), 119 DVBFE_TUNER_REFCLOCK = (1 << 4), 120 DVBFE_TUNER_IQSENSE = (1 << 5), 121 DVBFE_TUNER_DUMMY = (1 << 31) 122 }; 123 124 /* 125 * ALGO_HW: (Hardware Algorithm) 126 * ---------------------------------------------------------------- 127 * Devices that support this algorithm do everything in hardware 128 * and no software support is needed to handle them. 129 * Requesting these devices to LOCK is the only thing required, 130 * device is supposed to do everything in the hardware. 131 * 132 * ALGO_SW: (Software Algorithm) 133 * ---------------------------------------------------------------- 134 * These are dumb devices, that require software to do everything 135 * 136 * ALGO_CUSTOM: (Customizable Agorithm) 137 * ---------------------------------------------------------------- 138 * Devices having this algorithm can be customized to have specific 139 * algorithms in the frontend driver, rather than simply doing a 140 * software zig-zag. In this case the zigzag maybe hardware assisted 141 * or it maybe completely done in hardware. In all cases, usage of 142 * this algorithm, in conjunction with the search and track 143 * callbacks, utilizes the driver specific algorithm. 144 * 145 * ALGO_RECOVERY: (Recovery Algorithm) 146 * ---------------------------------------------------------------- 147 * These devices have AUTO recovery capabilities from LOCK failure 148 */ 149 enum dvbfe_algo { 150 DVBFE_ALGO_HW = (1 << 0), 151 DVBFE_ALGO_SW = (1 << 1), 152 DVBFE_ALGO_CUSTOM = (1 << 2), 153 DVBFE_ALGO_RECOVERY = (1 << 31) 154 }; 155 156 struct tuner_state { 157 u32 frequency; 158 u32 tunerstep; 159 u32 ifreq; 160 u32 bandwidth; 161 u32 iqsense; 162 u32 refclock; 163 }; 164 165 /* 166 * search callback possible return status 167 * 168 * DVBFE_ALGO_SEARCH_SUCCESS 169 * The frontend search algorithm completed and returned successfully 170 * 171 * DVBFE_ALGO_SEARCH_ASLEEP 172 * The frontend search algorithm is sleeping 173 * 174 * DVBFE_ALGO_SEARCH_FAILED 175 * The frontend search for a signal failed 176 * 177 * DVBFE_ALGO_SEARCH_INVALID 178 * The frontend search algorith was probably supplied with invalid 179 * parameters and the search is an invalid one 180 * 181 * DVBFE_ALGO_SEARCH_ERROR 182 * The frontend search algorithm failed due to some error 183 * 184 * DVBFE_ALGO_SEARCH_AGAIN 185 * The frontend search algorithm was requested to search again 186 */ 187 enum dvbfe_search { 188 DVBFE_ALGO_SEARCH_SUCCESS = (1 << 0), 189 DVBFE_ALGO_SEARCH_ASLEEP = (1 << 1), 190 DVBFE_ALGO_SEARCH_FAILED = (1 << 2), 191 DVBFE_ALGO_SEARCH_INVALID = (1 << 3), 192 DVBFE_ALGO_SEARCH_AGAIN = (1 << 4), 193 DVBFE_ALGO_SEARCH_ERROR = (1 << 31), 194 }; 195 196 197 struct dvb_tuner_ops { 198 199 struct dvb_tuner_info info; 200 201 int (*release)(struct dvb_frontend *fe); 202 int (*init)(struct dvb_frontend *fe); 203 int (*sleep)(struct dvb_frontend *fe); 204 int (*suspend)(struct dvb_frontend *fe); 205 int (*resume)(struct dvb_frontend *fe); 206 207 /** This is for simple PLLs - set all parameters in one go. */ 208 int (*set_params)(struct dvb_frontend *fe); 209 int (*set_analog_params)(struct dvb_frontend *fe, struct analog_parameters *p); 210 211 /** This is support for demods like the mt352 - fills out the supplied buffer with what to write. */ 212 int (*calc_regs)(struct dvb_frontend *fe, u8 *buf, int buf_len); 213 214 /** This is to allow setting tuner-specific configs */ 215 int (*set_config)(struct dvb_frontend *fe, void *priv_cfg); 216 217 int (*get_frequency)(struct dvb_frontend *fe, u32 *frequency); 218 int (*get_bandwidth)(struct dvb_frontend *fe, u32 *bandwidth); 219 int (*get_if_frequency)(struct dvb_frontend *fe, u32 *frequency); 220 221 #define TUNER_STATUS_LOCKED 1 222 #define TUNER_STATUS_STEREO 2 223 int (*get_status)(struct dvb_frontend *fe, u32 *status); 224 int (*get_rf_strength)(struct dvb_frontend *fe, u16 *strength); 225 int (*get_afc)(struct dvb_frontend *fe, s32 *afc); 226 227 /** These are provided separately from set_params in order to facilitate silicon 228 * tuners which require sophisticated tuning loops, controlling each parameter separately. */ 229 int (*set_frequency)(struct dvb_frontend *fe, u32 frequency); 230 int (*set_bandwidth)(struct dvb_frontend *fe, u32 bandwidth); 231 232 /* 233 * These are provided separately from set_params in order to facilitate silicon 234 * tuners which require sophisticated tuning loops, controlling each parameter separately. 235 */ 236 int (*set_state)(struct dvb_frontend *fe, enum tuner_param param, struct tuner_state *state); 237 int (*get_state)(struct dvb_frontend *fe, enum tuner_param param, struct tuner_state *state); 238 }; 239 240 struct analog_demod_info { 241 char *name; 242 }; 243 244 struct analog_demod_ops { 245 246 struct analog_demod_info info; 247 248 void (*set_params)(struct dvb_frontend *fe, 249 struct analog_parameters *params); 250 int (*has_signal)(struct dvb_frontend *fe, u16 *signal); 251 int (*get_afc)(struct dvb_frontend *fe, s32 *afc); 252 void (*tuner_status)(struct dvb_frontend *fe); 253 void (*standby)(struct dvb_frontend *fe); 254 void (*release)(struct dvb_frontend *fe); 255 int (*i2c_gate_ctrl)(struct dvb_frontend *fe, int enable); 256 257 /** This is to allow setting tuner-specific configuration */ 258 int (*set_config)(struct dvb_frontend *fe, void *priv_cfg); 259 }; 260 261 struct dtv_frontend_properties; 262 263 struct dvb_frontend_ops { 264 265 struct dvb_frontend_info info; 266 267 u8 delsys[MAX_DELSYS]; 268 269 void (*release)(struct dvb_frontend* fe); 270 void (*release_sec)(struct dvb_frontend* fe); 271 272 int (*init)(struct dvb_frontend* fe); 273 int (*sleep)(struct dvb_frontend* fe); 274 275 int (*write)(struct dvb_frontend* fe, const u8 buf[], int len); 276 277 /* if this is set, it overrides the default swzigzag */ 278 int (*tune)(struct dvb_frontend* fe, 279 bool re_tune, 280 unsigned int mode_flags, 281 unsigned int *delay, 282 fe_status_t *status); 283 /* get frontend tuning algorithm from the module */ 284 enum dvbfe_algo (*get_frontend_algo)(struct dvb_frontend *fe); 285 286 /* these two are only used for the swzigzag code */ 287 int (*set_frontend)(struct dvb_frontend *fe); 288 int (*get_tune_settings)(struct dvb_frontend* fe, struct dvb_frontend_tune_settings* settings); 289 290 int (*get_frontend)(struct dvb_frontend *fe); 291 292 int (*read_status)(struct dvb_frontend* fe, fe_status_t* status); 293 int (*read_ber)(struct dvb_frontend* fe, u32* ber); 294 int (*read_signal_strength)(struct dvb_frontend* fe, u16* strength); 295 int (*read_snr)(struct dvb_frontend* fe, u16* snr); 296 int (*read_ucblocks)(struct dvb_frontend* fe, u32* ucblocks); 297 298 int (*diseqc_reset_overload)(struct dvb_frontend* fe); 299 int (*diseqc_send_master_cmd)(struct dvb_frontend* fe, struct dvb_diseqc_master_cmd* cmd); 300 int (*diseqc_recv_slave_reply)(struct dvb_frontend* fe, struct dvb_diseqc_slave_reply* reply); 301 int (*diseqc_send_burst)(struct dvb_frontend* fe, fe_sec_mini_cmd_t minicmd); 302 int (*set_tone)(struct dvb_frontend* fe, fe_sec_tone_mode_t tone); 303 int (*set_voltage)(struct dvb_frontend* fe, fe_sec_voltage_t voltage); 304 int (*enable_high_lnb_voltage)(struct dvb_frontend* fe, long arg); 305 int (*dishnetwork_send_legacy_command)(struct dvb_frontend* fe, unsigned long cmd); 306 int (*i2c_gate_ctrl)(struct dvb_frontend* fe, int enable); 307 int (*ts_bus_ctrl)(struct dvb_frontend* fe, int acquire); 308 int (*set_lna)(struct dvb_frontend *); 309 310 /* These callbacks are for devices that implement their own 311 * tuning algorithms, rather than a simple swzigzag 312 */ 313 enum dvbfe_search (*search)(struct dvb_frontend *fe); 314 315 struct dvb_tuner_ops tuner_ops; 316 struct analog_demod_ops analog_ops; 317 318 int (*set_property)(struct dvb_frontend* fe, struct dtv_property* tvp); 319 int (*get_property)(struct dvb_frontend* fe, struct dtv_property* tvp); 320 }; 321 322 #ifdef __DVB_CORE__ 323 #define MAX_EVENT 8 324 325 struct dvb_fe_events { 326 struct dvb_frontend_event events[MAX_EVENT]; 327 int eventw; 328 int eventr; 329 int overflow; 330 wait_queue_head_t wait_queue; 331 struct mutex mtx; 332 }; 333 #endif 334 335 struct dtv_frontend_properties { 336 337 /* Cache State */ 338 u32 state; 339 340 u32 frequency; 341 fe_modulation_t modulation; 342 343 fe_sec_voltage_t voltage; 344 fe_sec_tone_mode_t sectone; 345 fe_spectral_inversion_t inversion; 346 fe_code_rate_t fec_inner; 347 fe_transmit_mode_t transmission_mode; 348 u32 bandwidth_hz; /* 0 = AUTO */ 349 fe_guard_interval_t guard_interval; 350 fe_hierarchy_t hierarchy; 351 u32 symbol_rate; 352 fe_code_rate_t code_rate_HP; 353 fe_code_rate_t code_rate_LP; 354 355 fe_pilot_t pilot; 356 fe_rolloff_t rolloff; 357 358 fe_delivery_system_t delivery_system; 359 360 enum fe_interleaving interleaving; 361 362 /* ISDB-T specifics */ 363 u8 isdbt_partial_reception; 364 u8 isdbt_sb_mode; 365 u8 isdbt_sb_subchannel; 366 u32 isdbt_sb_segment_idx; 367 u32 isdbt_sb_segment_count; 368 u8 isdbt_layer_enabled; 369 struct { 370 u8 segment_count; 371 fe_code_rate_t fec; 372 fe_modulation_t modulation; 373 u8 interleaving; 374 } layer[3]; 375 376 /* Multistream specifics */ 377 u32 stream_id; 378 379 /* ATSC-MH specifics */ 380 u8 atscmh_fic_ver; 381 u8 atscmh_parade_id; 382 u8 atscmh_nog; 383 u8 atscmh_tnog; 384 u8 atscmh_sgn; 385 u8 atscmh_prc; 386 387 u8 atscmh_rs_frame_mode; 388 u8 atscmh_rs_frame_ensemble; 389 u8 atscmh_rs_code_mode_pri; 390 u8 atscmh_rs_code_mode_sec; 391 u8 atscmh_sccc_block_mode; 392 u8 atscmh_sccc_code_mode_a; 393 u8 atscmh_sccc_code_mode_b; 394 u8 atscmh_sccc_code_mode_c; 395 u8 atscmh_sccc_code_mode_d; 396 397 u32 lna; 398 399 /* statistics data */ 400 struct dtv_fe_stats strength; 401 struct dtv_fe_stats cnr; 402 struct dtv_fe_stats pre_bit_error; 403 struct dtv_fe_stats pre_bit_count; 404 struct dtv_fe_stats post_bit_error; 405 struct dtv_fe_stats post_bit_count; 406 struct dtv_fe_stats block_error; 407 struct dtv_fe_stats block_count; 408 }; 409 410 #define DVB_FE_NO_EXIT 0 411 #define DVB_FE_NORMAL_EXIT 1 412 #define DVB_FE_DEVICE_REMOVED 2 413 #define DVB_FE_DEVICE_RESUME 3 414 415 struct dvb_frontend { 416 struct dvb_frontend_ops ops; 417 struct dvb_adapter *dvb; 418 void *demodulator_priv; 419 void *tuner_priv; 420 void *frontend_priv; 421 void *sec_priv; 422 void *analog_demod_priv; 423 struct dtv_frontend_properties dtv_property_cache; 424 #define DVB_FRONTEND_COMPONENT_TUNER 0 425 #define DVB_FRONTEND_COMPONENT_DEMOD 1 426 int (*callback)(void *adapter_priv, int component, int cmd, int arg); 427 int id; 428 unsigned int exit; 429 }; 430 431 extern int dvb_register_frontend(struct dvb_adapter *dvb, 432 struct dvb_frontend *fe); 433 434 extern int dvb_unregister_frontend(struct dvb_frontend *fe); 435 436 extern void dvb_frontend_detach(struct dvb_frontend *fe); 437 438 extern void dvb_frontend_reinitialise(struct dvb_frontend *fe); 439 extern int dvb_frontend_suspend(struct dvb_frontend *fe); 440 extern int dvb_frontend_resume(struct dvb_frontend *fe); 441 442 extern void dvb_frontend_sleep_until(struct timeval *waketime, u32 add_usec); 443 extern s32 timeval_usec_diff(struct timeval lasttime, struct timeval curtime); 444 445 #endif 446