LXR linux/drivers/media/dvb-frontends/stv0299.h

   1/* SPDX-License-Identifier: GPL-2.0-or-later */
   2/*
   3    Driver for ST STV0299 demodulator
   4
   5    Copyright (C) 2001-2002 Convergence Integrated Media GmbH
   6        <ralph@convergence.de>,
   7        <holger@convergence.de>,
   8        <js@convergence.de>
   9
  10
  11    Philips SU1278/SH
  12
  13    Copyright (C) 2002 by Peter Schildmann <peter.schildmann@web.de>
  14
  15
  16    LG TDQF-S001F
  17
  18    Copyright (C) 2002 Felix Domke <tmbinc@elitedvb.net>
  19                     & Andreas Oberritter <obi@linuxtv.org>
  20
  21
  22    Support for Samsung TBMU24112IMB used on Technisat SkyStar2 rev. 2.6B
  23
  24    Copyright (C) 2003 Vadim Catana <skystar@moldova.cc>:
  25
  26    Support for Philips SU1278 on Technotrend hardware
  27
  28    Copyright (C) 2004 Andrew de Quincey <adq_dvb@lidskialf.net>
  29
  30
  31*/
  32
  33#ifndef STV0299_H
  34#define STV0299_H
  35
  36#include <linux/dvb/frontend.h>
  37#include <media/dvb_frontend.h>
  38
  39#define STV0299_LOCKOUTPUT_0  0
  40#define STV0299_LOCKOUTPUT_1  1
  41#define STV0299_LOCKOUTPUT_CF 2
  42#define STV0299_LOCKOUTPUT_LK 3
  43
  44#define STV0299_VOLT13_OP0 0
  45#define STV0299_VOLT13_OP1 1
  46
  47struct stv0299_config
  48{
  49        /* the demodulator's i2c address */
  50        u8 demod_address;
  51
  52        /* inittab - array of pairs of values.
  53         * First of each pair is the register, second is the value.
  54         * List should be terminated with an 0xff, 0xff pair.
  55         */
  56        const u8* inittab;
  57
  58        /* master clock to use */
  59        u32 mclk;
  60
  61        /* does the inversion require inversion? */
  62        u8 invert:1;
  63
  64        /* Skip reinitialisation? */
  65        u8 skip_reinit:1;
  66
  67        /* LOCK OUTPUT setting */
  68        u8 lock_output:2;
  69
  70        /* Is 13v controlled by OP0 or OP1? */
  71        u8 volt13_op0_op1:1;
  72
  73        /* Turn-off OP0? */
  74        u8 op0_off:1;
  75
  76        /* minimum delay before retuning */
  77        int min_delay_ms;
  78
  79        /* Set the symbol rate */
  80        int (*set_symbol_rate)(struct dvb_frontend *fe, u32 srate, u32 ratio);
  81
  82        /* Set device param to start dma */
  83        int (*set_ts_params)(struct dvb_frontend *fe, int is_punctured);
  84};
  85
  86#if IS_REACHABLE(CONFIG_DVB_STV0299)
  87extern struct dvb_frontend *stv0299_attach(const struct stv0299_config *config,
  88                                           struct i2c_adapter *i2c);
  89#else
  90static inline struct dvb_frontend *stv0299_attach(const struct stv0299_config *config,
  91                                           struct i2c_adapter *i2c)
  92{
  93        printk(KERN_WARNING "%s: driver disabled by Kconfig\n", __func__);
  94        return NULL;
  95}
  96#endif // CONFIG_DVB_STV0299
  97
  98static inline int stv0299_writereg(struct dvb_frontend *fe, u8 reg, u8 val) {
  99        int r = 0;
 100        u8 buf[] = {reg, val};
 101        if (fe->ops.write)
 102                r = fe->ops.write(fe, buf, 2);
 103        return r;
 104}
 105
 106#endif // STV0299_H
 107