linux/drivers/media/tuners/tda18271-priv.h
<<
>>
Prefs
   1/* SPDX-License-Identifier: GPL-2.0-or-later */
   2/*
   3    tda18271-priv.h - private header for the NXP TDA18271 silicon tuner
   4
   5    Copyright (C) 2007, 2008 Michael Krufky <mkrufky@linuxtv.org>
   6
   7*/
   8
   9#ifndef __TDA18271_PRIV_H__
  10#define __TDA18271_PRIV_H__
  11
  12#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
  13
  14#include <linux/kernel.h>
  15#include <linux/types.h>
  16#include <linux/mutex.h>
  17#include "tuner-i2c.h"
  18#include "tda18271.h"
  19
  20#define R_ID     0x00   /* ID byte                */
  21#define R_TM     0x01   /* Thermo byte            */
  22#define R_PL     0x02   /* Power level byte       */
  23#define R_EP1    0x03   /* Easy Prog byte 1       */
  24#define R_EP2    0x04   /* Easy Prog byte 2       */
  25#define R_EP3    0x05   /* Easy Prog byte 3       */
  26#define R_EP4    0x06   /* Easy Prog byte 4       */
  27#define R_EP5    0x07   /* Easy Prog byte 5       */
  28#define R_CPD    0x08   /* Cal Post-Divider byte  */
  29#define R_CD1    0x09   /* Cal Divider byte 1     */
  30#define R_CD2    0x0a   /* Cal Divider byte 2     */
  31#define R_CD3    0x0b   /* Cal Divider byte 3     */
  32#define R_MPD    0x0c   /* Main Post-Divider byte */
  33#define R_MD1    0x0d   /* Main Divider byte 1    */
  34#define R_MD2    0x0e   /* Main Divider byte 2    */
  35#define R_MD3    0x0f   /* Main Divider byte 3    */
  36#define R_EB1    0x10   /* Extended byte 1        */
  37#define R_EB2    0x11   /* Extended byte 2        */
  38#define R_EB3    0x12   /* Extended byte 3        */
  39#define R_EB4    0x13   /* Extended byte 4        */
  40#define R_EB5    0x14   /* Extended byte 5        */
  41#define R_EB6    0x15   /* Extended byte 6        */
  42#define R_EB7    0x16   /* Extended byte 7        */
  43#define R_EB8    0x17   /* Extended byte 8        */
  44#define R_EB9    0x18   /* Extended byte 9        */
  45#define R_EB10   0x19   /* Extended byte 10       */
  46#define R_EB11   0x1a   /* Extended byte 11       */
  47#define R_EB12   0x1b   /* Extended byte 12       */
  48#define R_EB13   0x1c   /* Extended byte 13       */
  49#define R_EB14   0x1d   /* Extended byte 14       */
  50#define R_EB15   0x1e   /* Extended byte 15       */
  51#define R_EB16   0x1f   /* Extended byte 16       */
  52#define R_EB17   0x20   /* Extended byte 17       */
  53#define R_EB18   0x21   /* Extended byte 18       */
  54#define R_EB19   0x22   /* Extended byte 19       */
  55#define R_EB20   0x23   /* Extended byte 20       */
  56#define R_EB21   0x24   /* Extended byte 21       */
  57#define R_EB22   0x25   /* Extended byte 22       */
  58#define R_EB23   0x26   /* Extended byte 23       */
  59
  60#define TDA18271_NUM_REGS 39
  61
  62/*---------------------------------------------------------------------*/
  63
  64struct tda18271_rf_tracking_filter_cal {
  65        u32 rfmax;
  66        u8  rfband;
  67        u32 rf1_def;
  68        u32 rf2_def;
  69        u32 rf3_def;
  70        u32 rf1;
  71        u32 rf2;
  72        u32 rf3;
  73        s32 rf_a1;
  74        s32 rf_b1;
  75        s32 rf_a2;
  76        s32 rf_b2;
  77};
  78
  79enum tda18271_pll {
  80        TDA18271_MAIN_PLL,
  81        TDA18271_CAL_PLL,
  82};
  83
  84struct tda18271_map_layout;
  85
  86enum tda18271_ver {
  87        TDA18271HDC1,
  88        TDA18271HDC2,
  89};
  90
  91struct tda18271_priv {
  92        unsigned char tda18271_regs[TDA18271_NUM_REGS];
  93
  94        struct list_head        hybrid_tuner_instance_list;
  95        struct tuner_i2c_props  i2c_props;
  96
  97        enum tda18271_mode mode;
  98        enum tda18271_role role;
  99        enum tda18271_i2c_gate gate;
 100        enum tda18271_ver id;
 101        enum tda18271_output_options output_opt;
 102        enum tda18271_small_i2c small_i2c;
 103
 104        unsigned int config; /* interface to saa713x / tda829x */
 105        unsigned int cal_initialized:1;
 106
 107        u8 tm_rfcal;
 108
 109        struct tda18271_map_layout *maps;
 110        struct tda18271_std_map std;
 111        struct tda18271_rf_tracking_filter_cal rf_cal_state[8];
 112
 113        struct mutex lock;
 114
 115        u16 if_freq;
 116
 117        u32 frequency;
 118        u32 bandwidth;
 119};
 120
 121/*---------------------------------------------------------------------*/
 122
 123extern int tda18271_debug;
 124
 125#define DBG_INFO 1
 126#define DBG_MAP  2
 127#define DBG_REG  4
 128#define DBG_ADV  8
 129#define DBG_CAL  16
 130
 131__attribute__((format(printf, 4, 5)))
 132void _tda_printk(struct tda18271_priv *state, const char *level,
 133                 const char *func, const char *fmt, ...);
 134
 135#define tda_printk(st, lvl, fmt, arg...)                        \
 136        _tda_printk(st, lvl, __func__, fmt, ##arg)
 137
 138#define tda_dprintk(st, lvl, fmt, arg...)                       \
 139do {                                                            \
 140        if (tda18271_debug & lvl)                               \
 141                tda_printk(st, KERN_DEBUG, fmt, ##arg);         \
 142} while (0)
 143
 144#define tda_info(fmt, arg...)   pr_info(fmt, ##arg)
 145#define tda_warn(fmt, arg...)   tda_printk(priv, KERN_WARNING, fmt, ##arg)
 146#define tda_err(fmt, arg...)    tda_printk(priv, KERN_ERR,     fmt, ##arg)
 147#define tda_dbg(fmt, arg...)    tda_dprintk(priv, DBG_INFO,    fmt, ##arg)
 148#define tda_map(fmt, arg...)    tda_dprintk(priv, DBG_MAP,     fmt, ##arg)
 149#define tda_reg(fmt, arg...)    tda_dprintk(priv, DBG_REG,     fmt, ##arg)
 150#define tda_cal(fmt, arg...)    tda_dprintk(priv, DBG_CAL,     fmt, ##arg)
 151
 152#define tda_fail(ret)                                                        \
 153({                                                                           \
 154        int __ret;                                                           \
 155        __ret = (ret < 0);                                                   \
 156        if (__ret)                                                           \
 157                tda_printk(priv, KERN_ERR,                                   \
 158                           "error %d on line %d\n", ret, __LINE__);          \
 159        __ret;                                                               \
 160})
 161
 162/*---------------------------------------------------------------------*/
 163
 164enum tda18271_map_type {
 165        /* tda18271_pll_map */
 166        MAIN_PLL,
 167        CAL_PLL,
 168        /* tda18271_map */
 169        RF_CAL,
 170        RF_CAL_KMCO,
 171        RF_CAL_DC_OVER_DT,
 172        BP_FILTER,
 173        RF_BAND,
 174        GAIN_TAPER,
 175        IR_MEASURE,
 176};
 177
 178extern int tda18271_lookup_pll_map(struct dvb_frontend *fe,
 179                                   enum tda18271_map_type map_type,
 180                                   u32 *freq, u8 *post_div, u8 *div);
 181extern int tda18271_lookup_map(struct dvb_frontend *fe,
 182                               enum tda18271_map_type map_type,
 183                               u32 *freq, u8 *val);
 184
 185extern int tda18271_lookup_thermometer(struct dvb_frontend *fe);
 186
 187extern int tda18271_lookup_rf_band(struct dvb_frontend *fe,
 188                                   u32 *freq, u8 *rf_band);
 189
 190extern int tda18271_lookup_cid_target(struct dvb_frontend *fe,
 191                                      u32 *freq, u8 *cid_target,
 192                                      u16 *count_limit);
 193
 194extern int tda18271_assign_map_layout(struct dvb_frontend *fe);
 195
 196/*---------------------------------------------------------------------*/
 197
 198extern int tda18271_read_regs(struct dvb_frontend *fe);
 199extern int tda18271_read_extended(struct dvb_frontend *fe);
 200extern int tda18271_write_regs(struct dvb_frontend *fe, int idx, int len);
 201extern int tda18271_init_regs(struct dvb_frontend *fe);
 202
 203extern int tda18271_charge_pump_source(struct dvb_frontend *fe,
 204                                       enum tda18271_pll pll, int force);
 205extern int tda18271_set_standby_mode(struct dvb_frontend *fe,
 206                                     int sm, int sm_lt, int sm_xt);
 207
 208extern int tda18271_calc_main_pll(struct dvb_frontend *fe, u32 freq);
 209extern int tda18271_calc_cal_pll(struct dvb_frontend *fe, u32 freq);
 210
 211extern int tda18271_calc_bp_filter(struct dvb_frontend *fe, u32 *freq);
 212extern int tda18271_calc_km(struct dvb_frontend *fe, u32 *freq);
 213extern int tda18271_calc_rf_band(struct dvb_frontend *fe, u32 *freq);
 214extern int tda18271_calc_gain_taper(struct dvb_frontend *fe, u32 *freq);
 215extern int tda18271_calc_ir_measure(struct dvb_frontend *fe, u32 *freq);
 216extern int tda18271_calc_rf_cal(struct dvb_frontend *fe, u32 *freq);
 217
 218#endif /* __TDA18271_PRIV_H__ */
 219