174ba9207SThomas Gleixner /* SPDX-License-Identifier: GPL-2.0-or-later */
29a0bf528SMauro Carvalho Chehab /*
39a0bf528SMauro Carvalho Chehab Driver for Philips tda1004xh OFDM Frontend
49a0bf528SMauro Carvalho Chehab
59a0bf528SMauro Carvalho Chehab (c) 2004 Andrew de Quincey
69a0bf528SMauro Carvalho Chehab
79a0bf528SMauro Carvalho Chehab
89a0bf528SMauro Carvalho Chehab */
99a0bf528SMauro Carvalho Chehab
109a0bf528SMauro Carvalho Chehab #ifndef TDA1004X_H
119a0bf528SMauro Carvalho Chehab #define TDA1004X_H
129a0bf528SMauro Carvalho Chehab
139a0bf528SMauro Carvalho Chehab #include <linux/dvb/frontend.h>
149a0bf528SMauro Carvalho Chehab #include <linux/firmware.h>
159a0bf528SMauro Carvalho Chehab
169a0bf528SMauro Carvalho Chehab enum tda10046_xtal {
179a0bf528SMauro Carvalho Chehab TDA10046_XTAL_4M,
189a0bf528SMauro Carvalho Chehab TDA10046_XTAL_16M,
199a0bf528SMauro Carvalho Chehab };
209a0bf528SMauro Carvalho Chehab
219a0bf528SMauro Carvalho Chehab enum tda10046_agc {
229a0bf528SMauro Carvalho Chehab TDA10046_AGC_DEFAULT, /* original configuration */
23868c9a17SMauro Carvalho Chehab TDA10046_AGC_IFO_AUTO_NEG, /* IF AGC only, automatic, negative */
249a0bf528SMauro Carvalho Chehab TDA10046_AGC_IFO_AUTO_POS, /* IF AGC only, automatic, positive */
259a0bf528SMauro Carvalho Chehab TDA10046_AGC_TDA827X, /* IF AGC only, special setup for tda827x */
269a0bf528SMauro Carvalho Chehab };
279a0bf528SMauro Carvalho Chehab
289a0bf528SMauro Carvalho Chehab /* Many (hybrid) boards use GPIO 1 and 3
299a0bf528SMauro Carvalho Chehab GPIO1 analog - dvb switch
309a0bf528SMauro Carvalho Chehab GPIO3 firmware eeprom address switch
319a0bf528SMauro Carvalho Chehab */
329a0bf528SMauro Carvalho Chehab enum tda10046_gpio {
339a0bf528SMauro Carvalho Chehab TDA10046_GPTRI = 0x00, /* All GPIOs tristate */
349a0bf528SMauro Carvalho Chehab TDA10046_GP00 = 0x40, /* GPIO3=0, GPIO1=0 */
359a0bf528SMauro Carvalho Chehab TDA10046_GP01 = 0x42, /* GPIO3=0, GPIO1=1 */
369a0bf528SMauro Carvalho Chehab TDA10046_GP10 = 0x48, /* GPIO3=1, GPIO1=0 */
379a0bf528SMauro Carvalho Chehab TDA10046_GP11 = 0x4a, /* GPIO3=1, GPIO1=1 */
389a0bf528SMauro Carvalho Chehab TDA10046_GP00_I = 0x80, /* GPIO3=0, GPIO1=0, invert in sleep mode*/
399a0bf528SMauro Carvalho Chehab TDA10046_GP01_I = 0x82, /* GPIO3=0, GPIO1=1, invert in sleep mode */
409a0bf528SMauro Carvalho Chehab TDA10046_GP10_I = 0x88, /* GPIO3=1, GPIO1=0, invert in sleep mode */
419a0bf528SMauro Carvalho Chehab TDA10046_GP11_I = 0x8a, /* GPIO3=1, GPIO1=1, invert in sleep mode */
429a0bf528SMauro Carvalho Chehab };
439a0bf528SMauro Carvalho Chehab
449a0bf528SMauro Carvalho Chehab enum tda10046_if {
459a0bf528SMauro Carvalho Chehab TDA10046_FREQ_3617, /* original config, 36,166 MHZ */
469a0bf528SMauro Carvalho Chehab TDA10046_FREQ_3613, /* 36,13 MHZ */
479a0bf528SMauro Carvalho Chehab TDA10046_FREQ_045, /* low IF, 4.0, 4.5, or 5.0 MHZ */
489a0bf528SMauro Carvalho Chehab TDA10046_FREQ_052, /* low IF, 5.1667 MHZ for tda9889 */
499a0bf528SMauro Carvalho Chehab };
509a0bf528SMauro Carvalho Chehab
519a0bf528SMauro Carvalho Chehab enum tda10046_tsout {
529a0bf528SMauro Carvalho Chehab TDA10046_TS_PARALLEL = 0x00, /* parallel transport stream, default */
539a0bf528SMauro Carvalho Chehab TDA10046_TS_SERIAL = 0x01, /* serial transport stream */
549a0bf528SMauro Carvalho Chehab };
559a0bf528SMauro Carvalho Chehab
569a0bf528SMauro Carvalho Chehab struct tda1004x_config
579a0bf528SMauro Carvalho Chehab {
589a0bf528SMauro Carvalho Chehab /* the demodulator's i2c address */
599a0bf528SMauro Carvalho Chehab u8 demod_address;
609a0bf528SMauro Carvalho Chehab
619a0bf528SMauro Carvalho Chehab /* does the "inversion" need inverted? */
629a0bf528SMauro Carvalho Chehab u8 invert;
639a0bf528SMauro Carvalho Chehab
649a0bf528SMauro Carvalho Chehab /* Does the OCLK signal need inverted? */
659a0bf528SMauro Carvalho Chehab u8 invert_oclk;
669a0bf528SMauro Carvalho Chehab
679a0bf528SMauro Carvalho Chehab /* parallel or serial transport stream */
689a0bf528SMauro Carvalho Chehab enum tda10046_tsout ts_mode;
699a0bf528SMauro Carvalho Chehab
709a0bf528SMauro Carvalho Chehab /* Xtal frequency, 4 or 16MHz*/
719a0bf528SMauro Carvalho Chehab enum tda10046_xtal xtal_freq;
729a0bf528SMauro Carvalho Chehab
739a0bf528SMauro Carvalho Chehab /* IF frequency */
749a0bf528SMauro Carvalho Chehab enum tda10046_if if_freq;
759a0bf528SMauro Carvalho Chehab
769a0bf528SMauro Carvalho Chehab /* AGC configuration */
779a0bf528SMauro Carvalho Chehab enum tda10046_agc agc_config;
789a0bf528SMauro Carvalho Chehab
799a0bf528SMauro Carvalho Chehab /* setting of GPIO1 and 3 */
809a0bf528SMauro Carvalho Chehab enum tda10046_gpio gpio_config;
819a0bf528SMauro Carvalho Chehab
829a0bf528SMauro Carvalho Chehab /* slave address and configuration of the tuner */
839a0bf528SMauro Carvalho Chehab u8 tuner_address;
849a0bf528SMauro Carvalho Chehab u8 antenna_switch;
859a0bf528SMauro Carvalho Chehab
869a0bf528SMauro Carvalho Chehab /* if the board uses another I2c Bridge (tda8290), its address */
879a0bf528SMauro Carvalho Chehab u8 i2c_gate;
889a0bf528SMauro Carvalho Chehab
899a0bf528SMauro Carvalho Chehab /* request firmware for device */
909a0bf528SMauro Carvalho Chehab int (*request_firmware)(struct dvb_frontend* fe, const struct firmware **fw, char* name);
919a0bf528SMauro Carvalho Chehab };
929a0bf528SMauro Carvalho Chehab
939a0bf528SMauro Carvalho Chehab enum tda1004x_demod {
949a0bf528SMauro Carvalho Chehab TDA1004X_DEMOD_TDA10045,
959a0bf528SMauro Carvalho Chehab TDA1004X_DEMOD_TDA10046,
969a0bf528SMauro Carvalho Chehab };
979a0bf528SMauro Carvalho Chehab
989a0bf528SMauro Carvalho Chehab struct tda1004x_state {
999a0bf528SMauro Carvalho Chehab struct i2c_adapter* i2c;
1009a0bf528SMauro Carvalho Chehab const struct tda1004x_config* config;
1019a0bf528SMauro Carvalho Chehab struct dvb_frontend frontend;
1029a0bf528SMauro Carvalho Chehab
1039a0bf528SMauro Carvalho Chehab /* private demod data */
1049a0bf528SMauro Carvalho Chehab enum tda1004x_demod demod_type;
1059a0bf528SMauro Carvalho Chehab };
1069a0bf528SMauro Carvalho Chehab
1079b174527SArnd Bergmann #if IS_REACHABLE(CONFIG_DVB_TDA1004X)
1089a0bf528SMauro Carvalho Chehab extern struct dvb_frontend* tda10045_attach(const struct tda1004x_config* config,
1099a0bf528SMauro Carvalho Chehab struct i2c_adapter* i2c);
1109a0bf528SMauro Carvalho Chehab
1119a0bf528SMauro Carvalho Chehab extern struct dvb_frontend* tda10046_attach(const struct tda1004x_config* config,
1129a0bf528SMauro Carvalho Chehab struct i2c_adapter* i2c);
1139a0bf528SMauro Carvalho Chehab #else
tda10045_attach(const struct tda1004x_config * config,struct i2c_adapter * i2c)1149a0bf528SMauro Carvalho Chehab static inline struct dvb_frontend* tda10045_attach(const struct tda1004x_config* config,
1159a0bf528SMauro Carvalho Chehab struct i2c_adapter* i2c)
1169a0bf528SMauro Carvalho Chehab {
1179a0bf528SMauro Carvalho Chehab printk(KERN_WARNING "%s: driver disabled by Kconfig\n", __func__);
1189a0bf528SMauro Carvalho Chehab return NULL;
1199a0bf528SMauro Carvalho Chehab }
tda10046_attach(const struct tda1004x_config * config,struct i2c_adapter * i2c)1209a0bf528SMauro Carvalho Chehab static inline struct dvb_frontend* tda10046_attach(const struct tda1004x_config* config,
1219a0bf528SMauro Carvalho Chehab struct i2c_adapter* i2c)
1229a0bf528SMauro Carvalho Chehab {
1239a0bf528SMauro Carvalho Chehab printk(KERN_WARNING "%s: driver disabled by Kconfig\n", __func__);
1249a0bf528SMauro Carvalho Chehab return NULL;
1259a0bf528SMauro Carvalho Chehab }
1269a0bf528SMauro Carvalho Chehab #endif // CONFIG_DVB_TDA1004X
1279a0bf528SMauro Carvalho Chehab
tda1004x_writereg(struct dvb_frontend * fe,u8 reg,u8 val)1289a0bf528SMauro Carvalho Chehab static inline int tda1004x_writereg(struct dvb_frontend *fe, u8 reg, u8 val) {
1299a0bf528SMauro Carvalho Chehab int r = 0;
1309a0bf528SMauro Carvalho Chehab u8 buf[] = {reg, val};
1319a0bf528SMauro Carvalho Chehab if (fe->ops.write)
1329a0bf528SMauro Carvalho Chehab r = fe->ops.write(fe, buf, 2);
1339a0bf528SMauro Carvalho Chehab return r;
1349a0bf528SMauro Carvalho Chehab }
1359a0bf528SMauro Carvalho Chehab
1369a0bf528SMauro Carvalho Chehab #endif // TDA1004X_H
137