4 * Driver for ST STV0900 satellite demodulator IC.
6 * Copyright (C) ST Microelectronics.
7 * Copyright (C) 2009 NetUP Inc.
8 * Copyright (C) 2009 Igor M. Liplianin <liplianin@netup.ru>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
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
19 * GNU General Public License for more details.
22 #ifndef STV0900_PRIV_H
23 #define STV0900_PRIV_H
25 #include <linux/i2c.h>
27 #define INRANGE(X, Y, Z) ((((X) <= (Y)) && ((Y) <= (Z))) \
28 || (((Z) <= (Y)) && ((Y) <= (X))) ? 1 : 0)
31 #define MAKEWORD(X, Y) (((X) << 8) + (Y))
34 #define LSB(X) (((X) & 0xFF))
35 #define MSB(Y) (((Y) >> 8) & 0xFF)
44 #define dprintk(args...) \
47 printk(KERN_DEBUG args); \
50 #define STV0900_MAXLOOKUPSIZE 500
51 #define STV0900_BLIND_SEARCH_AGC2_TH 700
52 #define STV0900_BLIND_SEARCH_AGC2_TH_CUT30 1400
53 #define IQPOWER_THRESHOLD 30
55 /* One point of the lookup table */
56 struct stv000_lookpoint {
57 s32 realval;/* real value */
58 s32 regval;/* binary value */
61 /* Lookup table definition */
63 s32 size;/* Size of the lookup table */
64 struct stv000_lookpoint table[STV0900_MAXLOOKUPSIZE];/* Lookup table */
67 enum fe_stv0900_error {
69 STV0900_INVALID_HANDLE,
70 STV0900_BAD_PARAMETER,
72 STV0900_SEARCH_FAILED,
75 enum fe_stv0900_clock_type {
76 STV0900_USE_REGISTERS_DEFAULT,
77 STV0900_SERIAL_PUNCT_CLOCK,/*Serial punctured clock */
78 STV0900_SERIAL_CONT_CLOCK,/*Serial continues clock */
79 STV0900_PARALLEL_PUNCT_CLOCK,/*Parallel punctured clock */
80 STV0900_DVBCI_CLOCK/*Parallel continues clock : DVBCI */
83 enum fe_stv0900_search_state {
91 enum fe_stv0900_ldpc_state {
92 STV0900_PATH1_OFF_PATH2_OFF = 0,
93 STV0900_PATH1_ON_PATH2_OFF = 1,
94 STV0900_PATH1_OFF_PATH2_ON = 2,
95 STV0900_PATH1_ON_PATH2_ON = 3
98 enum fe_stv0900_signal_type {
102 STV0900_ANALOGCARRIER,
114 enum fe_stv0900_demod_num {
119 enum fe_stv0900_tracking_standard {
120 STV0900_DVBS1_STANDARD,/* Found Standard*/
121 STV0900_DVBS2_STANDARD,
122 STV0900_DSS_STANDARD,
123 STV0900_TURBOCODE_STANDARD,
124 STV0900_UNKNOWN_STANDARD
127 enum fe_stv0900_search_standard {
129 STV0900_SEARCH_DVBS1,/* Search Standard*/
130 STV0900_SEARCH_DVBS2,
132 STV0900_SEARCH_TURBOCODE
135 enum fe_stv0900_search_algo {
136 STV0900_BLIND_SEARCH,/* offset freq and SR are Unknown */
137 STV0900_COLD_START,/* only the SR is known */
138 STV0900_WARM_START/* offset freq and SR are known */
141 enum fe_stv0900_modulation {
149 enum fe_stv0900_modcode {
179 STV0900_MODCODE_UNKNOWN
182 enum fe_stv0900_fec {/*DVBS1, DSS and turbo code puncture rate*/
186 STV0900_FEC_4_5,/*for turbo code only*/
188 STV0900_FEC_6_7,/*for DSS only */
190 STV0900_FEC_8_9,/*for turbo code only*/
194 enum fe_stv0900_frame_length {
199 enum fe_stv0900_pilot {
204 enum fe_stv0900_rolloff {
210 enum fe_stv0900_search_iq {
212 STV0900_IQ_AUTO_NORMAL_FIRST,
213 STV0900_IQ_FORCE_NORMAL,
214 STV0900_IQ_FORCE_SWAPPED
217 enum stv0900_iq_inversion {
222 enum fe_stv0900_diseqc_mode {
223 STV0900_22KHZ_Continues = 0,
224 STV0900_DISEQC_2_3_PWM = 2,
225 STV0900_DISEQC_3_3_PWM = 3,
226 STV0900_DISEQC_2_3_ENVELOP = 4,
227 STV0900_DISEQC_3_3_ENVELOP = 5
230 enum fe_stv0900_demod_mode {
235 struct stv0900_init_params{
236 u32 dmd_ref_clk;/* Reference,Input clock for the demod in Hz */
238 /* Demodulator Type (single demod or dual demod) */
239 enum fe_stv0900_demod_mode demod_mode;
240 enum fe_stv0900_rolloff rolloff;
241 enum fe_stv0900_clock_type path1_ts_clock;
247 /* IQ from the tuner1 to the demod */
248 enum stv0900_iq_inversion tun1_iq_inv;
249 enum fe_stv0900_clock_type path2_ts_clock;
255 /* IQ from the tuner2 to the demod */
256 enum stv0900_iq_inversion tun2_iq_inv;
257 struct stv0900_reg *ts_config;
260 struct stv0900_search_params {
261 enum fe_stv0900_demod_num path;/* Path Used demod1 or 2 */
263 u32 frequency;/* Transponder frequency (in KHz) */
264 u32 symbol_rate;/* Transponder symbol rate (in bds)*/
265 u32 search_range;/* Range of the search (in Hz) */
267 enum fe_stv0900_search_standard standard;
268 enum fe_stv0900_modulation modulation;
269 enum fe_stv0900_fec fec;
270 enum fe_stv0900_modcode modcode;
271 enum fe_stv0900_search_iq iq_inversion;
272 enum fe_stv0900_search_algo search_algo;
276 struct stv0900_signal_info {
277 int locked;/* Transponder locked */
278 u32 frequency;/* Transponder frequency (in KHz) */
279 u32 symbol_rate;/* Transponder symbol rate (in Mbds) */
281 enum fe_stv0900_tracking_standard standard;
282 enum fe_stv0900_fec fec;
283 enum fe_stv0900_modcode modcode;
284 enum fe_stv0900_modulation modulation;
285 enum fe_stv0900_pilot pilot;
286 enum fe_stv0900_frame_length frame_len;
287 enum stv0900_iq_inversion spectrum;
288 enum fe_stv0900_rolloff rolloff;
290 s32 Power;/* Power of the RF signal (dBm) */
291 s32 C_N;/* Carrier to noise ratio (dB x10)*/
292 u32 BER;/* Bit error rate (x10^7) */
296 struct stv0900_internal{
299 /* manual RollOff for DVBS1/DSS only */
300 enum fe_stv0900_rolloff rolloff;
301 /* Demodulator use for single demod or for dual demod) */
302 enum fe_stv0900_demod_mode demod_mode;
309 /* for software/auto tuner */
312 /* algorithm for search Blind, Cold or Warm*/
313 enum fe_stv0900_search_algo srch_algo[2];
314 /* search standard: Auto, DVBS1/DSS only or DVBS2 only*/
315 enum fe_stv0900_search_standard srch_standard[2];
316 /* inversion search : auto, auto norma first, normal or inverted */
317 enum fe_stv0900_search_iq srch_iq_inv[2];
318 enum fe_stv0900_modcode modcode[2];
319 enum fe_stv0900_modulation modulation[2];
320 enum fe_stv0900_fec fec[2];
322 struct stv0900_signal_info result[2];
323 enum fe_stv0900_error err[2];
326 struct i2c_adapter *i2c_adap;
328 u8 clkmode;/* 0 for CLKI, 2 for XTALI */
330 struct stv0900_reg *ts_config;
331 enum fe_stv0900_error errs;
335 /* state for each demod */
336 struct stv0900_state {
337 /* pointer for internal params, one for each pair of demods */
338 struct stv0900_internal *internal;
339 struct i2c_adapter *i2c_adap;
340 const struct stv0900_config *config;
341 struct dvb_frontend frontend;
347 extern s32 ge2comp(s32 a, s32 width);
349 extern void stv0900_write_reg(struct stv0900_internal *i_params,
350 u16 reg_addr, u8 reg_data);
352 extern u8 stv0900_read_reg(struct stv0900_internal *i_params,
355 extern void stv0900_write_bits(struct stv0900_internal *i_params,
358 extern u8 stv0900_get_bits(struct stv0900_internal *i_params,
361 extern int stv0900_get_demod_lock(struct stv0900_internal *i_params,
362 enum fe_stv0900_demod_num demod, s32 time_out);
363 extern int stv0900_check_signal_presence(struct stv0900_internal *i_params,
364 enum fe_stv0900_demod_num demod);
366 extern enum fe_stv0900_signal_type stv0900_algo(struct dvb_frontend *fe);
368 extern void stv0900_set_tuner(struct dvb_frontend *fe, u32 frequency,
370 extern void stv0900_set_bandwidth(struct dvb_frontend *fe, u32 bandwidth);
372 extern void stv0900_start_search(struct stv0900_internal *i_params,
373 enum fe_stv0900_demod_num demod);
375 extern u8 stv0900_get_optim_carr_loop(s32 srate,
376 enum fe_stv0900_modcode modcode,
377 s32 pilot, u8 chip_id);
379 extern u8 stv0900_get_optim_short_carr_loop(s32 srate,
380 enum fe_stv0900_modulation modulation,
383 extern void stv0900_stop_all_s2_modcod(struct stv0900_internal *i_params,
384 enum fe_stv0900_demod_num demod);
386 extern void stv0900_activate_s2_modcod(struct stv0900_internal *i_params,
387 enum fe_stv0900_demod_num demod);
389 extern void stv0900_activate_s2_modcod_single(struct stv0900_internal *i_params,
390 enum fe_stv0900_demod_num demod);
393 fe_stv0900_tracking_standard stv0900_get_standard(struct dvb_frontend *fe,
394 enum fe_stv0900_demod_num demod);
397 stv0900_get_freq_auto(struct stv0900_internal *intp, int demod);
400 stv0900_set_tuner_auto(struct stv0900_internal *intp, u32 Frequency,
401 u32 Bandwidth, int demod);