drivers/media/dvb-frontends/bcm3510_priv.h

   1 /* SPDX-License-Identifier: GPL-2.0-or-later */
   2 /*
   3  * Support for the Broadcom BCM3510 ATSC demodulator (1st generation Air2PC)
   4  *
   5  *  Copyright (C) 2001-5, B2C2 inc.
   6  *
   7  *  GPL/Linux driver written by Patrick Boettcher <patrick.boettcher@posteo.de>
   8  */
   9 #ifndef __BCM3510_PRIV_H__
  10 #define __BCM3510_PRIV_H__
  11
  12 #define PACKED __attribute__((packed))
  13
  14 #undef err
  15 #define err(format, arg...)  printk(KERN_ERR     "bcm3510: " format "\n" , ## arg)
  16 #undef info
  17 #define info(format, arg...) printk(KERN_INFO    "bcm3510: " format "\n" , ## arg)
  18 #undef warn
  19 #define warn(format, arg...) printk(KERN_WARNING "bcm3510: " format "\n" , ## arg)
  20
  21
  22 #define PANASONIC_FIRST_IF_BASE_IN_KHz  1407500
  23 #define BCM3510_SYMBOL_RATE             5381000
  24
  25 typedef union {
  26         u8 raw;
  27
  28         struct {
  29                 u8 CTL   :8;
  30         } TSTCTL_2e;
  31
  32         u8 LDCERC_4e;
  33         u8 LDUERC_4f;
  34         u8 LD_BER0_65;
  35         u8 LD_BER1_66;
  36         u8 LD_BER2_67;
  37         u8 LD_BER3_68;
  38
  39         struct {
  40                 u8 RESET :1;
  41                 u8 IDLE  :1;
  42                 u8 STOP  :1;
  43                 u8 HIRQ0 :1;
  44                 u8 HIRQ1 :1;
  45                 u8 na0   :1;
  46                 u8 HABAV :1;
  47                 u8 na1   :1;
  48         } HCTL1_a0;
  49
  50         struct {
  51                 u8 na0    :1;
  52                 u8 IDLMSK :1;
  53                 u8 STMSK  :1;
  54                 u8 I0MSK  :1;
  55                 u8 I1MSK  :1;
  56                 u8 na1    :1;
  57                 u8 HABMSK :1;
  58                 u8 na2    :1;
  59         } HCTLMSK_a1;
  60
  61         struct {
  62                 u8 RESET  :1;
  63                 u8 IDLE   :1;
  64                 u8 STOP   :1;
  65                 u8 RUN    :1;
  66                 u8 HABAV  :1;
  67                 u8 MEMAV  :1;
  68                 u8 ALDONE :1;
  69                 u8 REIRQ  :1;
  70         } APSTAT1_a2;
  71
  72         struct {
  73                 u8 RSTMSK :1;
  74                 u8 IMSK   :1;
  75                 u8 SMSK   :1;
  76                 u8 RMSK   :1;
  77                 u8 HABMSK :1;
  78                 u8 MAVMSK :1;
  79                 u8 ALDMSK :1;
  80                 u8 REMSK  :1;
  81         } APMSK1_a3;
  82
  83         u8 APSTAT2_a4;
  84         u8 APMSK2_a5;
  85
  86         struct {
  87                 u8 HABADR :7;
  88                 u8 na     :1;
  89         } HABADR_a6;
  90
  91         u8 HABDATA_a7;
  92
  93         struct {
  94                 u8 HABR   :1;
  95                 u8 LDHABR :1;
  96                 u8 APMSK  :1;
  97                 u8 HMSK   :1;
  98                 u8 LDMSK  :1;
  99                 u8 na     :3;
 100         } HABSTAT_a8;
 101
 102         u8 MADRH_a9;
 103         u8 MADRL_aa;
 104         u8 MDATA_ab;
 105
 106         struct {
 107 #define JDEC_WAIT_AT_RAM      0x7
 108 #define JDEC_EEPROM_LOAD_WAIT 0x4
 109                 u8 JDEC   :3;
 110                 u8 na     :5;
 111         } JDEC_ca;
 112
 113         struct {
 114                 u8 REV   :4;
 115                 u8 LAYER :4;
 116         } REVID_e0;
 117
 118         struct {
 119                 u8 unk0   :1;
 120                 u8 CNTCTL :1;
 121                 u8 BITCNT :1;
 122                 u8 unk1   :1;
 123                 u8 RESYNC :1;
 124                 u8 unk2   :3;
 125         } BERCTL_fa;
 126
 127         struct {
 128                 u8 CSEL0  :1;
 129                 u8 CLKED0 :1;
 130                 u8 CSEL1  :1;
 131                 u8 CLKED1 :1;
 132                 u8 CLKLEV :1;
 133                 u8 SPIVAR :1;
 134                 u8 na     :2;
 135         } TUNSET_fc;
 136
 137         struct {
 138                 u8 CLK    :1;
 139                 u8 DATA   :1;
 140                 u8 CS0    :1;
 141                 u8 CS1    :1;
 142                 u8 AGCSEL :1;
 143                 u8 na0    :1;
 144                 u8 TUNSEL :1;
 145                 u8 na1    :1;
 146         } TUNCTL_fd;
 147
 148         u8 TUNSEL0_fe;
 149         u8 TUNSEL1_ff;
 150
 151 } bcm3510_register_value;
 152
 153 /* HAB commands */
 154
 155 /* version */
 156 #define CMD_GET_VERSION_INFO   0x3D
 157 #define MSGID_GET_VERSION_INFO 0x15
 158 struct bcm3510_hab_cmd_get_version_info {
 159         u8 microcode_version;
 160         u8 script_version;
 161         u8 config_version;
 162         u8 demod_version;
 163 } PACKED;
 164
 165 #define BCM3510_DEF_MICROCODE_VERSION 0x0E
 166 #define BCM3510_DEF_SCRIPT_VERSION    0x06
 167 #define BCM3510_DEF_CONFIG_VERSION    0x01
 168 #define BCM3510_DEF_DEMOD_VERSION     0xB1
 169
 170 /* acquire */
 171 #define CMD_ACQUIRE            0x38
 172
 173 #define MSGID_EXT_TUNER_ACQUIRE 0x0A
 174 struct bcm3510_hab_cmd_ext_acquire {
 175         struct {
 176                 u8 MODE      :4;
 177                 u8 BW        :1;
 178                 u8 FA        :1;
 179                 u8 NTSCSWEEP :1;
 180                 u8 OFFSET    :1;
 181         } PACKED ACQUIRE0; /* control_byte */
 182
 183         struct {
 184                 u8 IF_FREQ  :3;
 185                 u8 zero0    :1;
 186                 u8 SYM_RATE :3;
 187                 u8 zero1    :1;
 188         } PACKED ACQUIRE1; /* sym_if */
 189
 190         u8 IF_OFFSET0;   /* IF_Offset_10hz */
 191         u8 IF_OFFSET1;
 192         u8 SYM_OFFSET0;  /* SymbolRateOffset */
 193         u8 SYM_OFFSET1;
 194         u8 NTSC_OFFSET0; /* NTSC_Offset_10hz */
 195         u8 NTSC_OFFSET1;
 196 } PACKED;
 197
 198 #define MSGID_INT_TUNER_ACQUIRE 0x0B
 199 struct bcm3510_hab_cmd_int_acquire {
 200         struct {
 201                 u8 MODE      :4;
 202                 u8 BW        :1;
 203                 u8 FA        :1;
 204                 u8 NTSCSWEEP :1;
 205                 u8 OFFSET    :1;
 206         } PACKED ACQUIRE0; /* control_byte */
 207
 208         struct {
 209                 u8 IF_FREQ  :3;
 210                 u8 zero0    :1;
 211                 u8 SYM_RATE :3;
 212                 u8 zero1    :1;
 213         } PACKED ACQUIRE1; /* sym_if */
 214
 215         u8 TUNER_FREQ0;
 216         u8 TUNER_FREQ1;
 217         u8 TUNER_FREQ2;
 218         u8 TUNER_FREQ3;
 219         u8 IF_OFFSET0;   /* IF_Offset_10hz */
 220         u8 IF_OFFSET1;
 221         u8 SYM_OFFSET0;  /* SymbolRateOffset */
 222         u8 SYM_OFFSET1;
 223         u8 NTSC_OFFSET0; /* NTSC_Offset_10hz */
 224         u8 NTSC_OFFSET1;
 225 } PACKED;
 226
 227 /* modes */
 228 #define BCM3510_QAM16           =   0x01
 229 #define BCM3510_QAM32           =   0x02
 230 #define BCM3510_QAM64           =   0x03
 231 #define BCM3510_QAM128          =   0x04
 232 #define BCM3510_QAM256          =   0x05
 233 #define BCM3510_8VSB            =   0x0B
 234 #define BCM3510_16VSB           =   0x0D
 235
 236 /* IF_FREQS */
 237 #define BCM3510_IF_TERRESTRIAL 0x0
 238 #define BCM3510_IF_CABLE       0x1
 239 #define BCM3510_IF_USE_CMD     0x7
 240
 241 /* SYM_RATE */
 242 #define BCM3510_SR_8VSB        0x0 /* 5381119 s/sec */
 243 #define BCM3510_SR_256QAM      0x1 /* 5360537 s/sec */
 244 #define BCM3510_SR_16QAM       0x2 /* 5056971 s/sec */
 245 #define BCM3510_SR_MISC        0x3 /* 5000000 s/sec */
 246 #define BCM3510_SR_USE_CMD     0x7
 247
 248 /* special symbol rate */
 249 #define CMD_SET_VALUE_NOT_LISTED  0x2d
 250 #define MSGID_SET_SYMBOL_RATE_NOT_LISTED 0x0c
 251 struct bcm3510_hab_cmd_set_sr_not_listed {
 252         u8 HOST_SYM_RATE0;
 253         u8 HOST_SYM_RATE1;
 254         u8 HOST_SYM_RATE2;
 255         u8 HOST_SYM_RATE3;
 256 } PACKED;
 257
 258 /* special IF */
 259 #define MSGID_SET_IF_FREQ_NOT_LISTED 0x0d
 260 struct bcm3510_hab_cmd_set_if_freq_not_listed {
 261         u8 HOST_IF_FREQ0;
 262         u8 HOST_IF_FREQ1;
 263         u8 HOST_IF_FREQ2;
 264         u8 HOST_IF_FREQ3;
 265 } PACKED;
 266
 267 /* auto reacquire */
 268 #define CMD_AUTO_PARAM       0x2a
 269 #define MSGID_AUTO_REACQUIRE 0x0e
 270 struct bcm3510_hab_cmd_auto_reacquire {
 271         u8 ACQ    :1; /* on/off*/
 272         u8 unused :7;
 273 } PACKED;
 274
 275 #define MSGID_SET_RF_AGC_SEL 0x12
 276 struct bcm3510_hab_cmd_set_agc {
 277         u8 LVL    :1;
 278         u8 unused :6;
 279         u8 SEL    :1;
 280 } PACKED;
 281
 282 #define MSGID_SET_AUTO_INVERSION 0x14
 283 struct bcm3510_hab_cmd_auto_inversion {
 284         u8 AI     :1;
 285         u8 unused :7;
 286 } PACKED;
 287
 288
 289 /* bert control */
 290 #define CMD_STATE_CONTROL  0x12
 291 #define MSGID_BERT_CONTROL 0x0e
 292 #define MSGID_BERT_SET     0xfa
 293 struct bcm3510_hab_cmd_bert_control {
 294         u8 BE     :1;
 295         u8 unused :7;
 296 } PACKED;
 297
 298 #define MSGID_TRI_STATE 0x2e
 299 struct bcm3510_hab_cmd_tri_state {
 300         u8 RE :1; /* a/d ram port pins */
 301         u8 PE :1; /* baud clock pin */
 302         u8 AC :1; /* a/d clock pin */
 303         u8 BE :1; /* baud clock pin */
 304         u8 unused :4;
 305 } PACKED;
 306
 307
 308 /* tune */
 309 #define CMD_TUNE   0x38
 310 #define MSGID_TUNE 0x16
 311 struct bcm3510_hab_cmd_tune_ctrl_data_pair {
 312         struct {
 313 #define BITS_8 0x07
 314 #define BITS_7 0x06
 315 #define BITS_6 0x05
 316 #define BITS_5 0x04
 317 #define BITS_4 0x03
 318 #define BITS_3 0x02
 319 #define BITS_2 0x01
 320 #define BITS_1 0x00
 321                 u8 size    :3;
 322                 u8 unk     :2;
 323                 u8 clk_off :1;
 324                 u8 cs0     :1;
 325                 u8 cs1     :1;
 326
 327         } PACKED ctrl;
 328
 329         u8 data;
 330 } PACKED;
 331
 332 struct bcm3510_hab_cmd_tune {
 333         u8 length;
 334         u8 clock_width;
 335         u8 misc;
 336         u8 TUNCTL_state;
 337
 338         struct bcm3510_hab_cmd_tune_ctrl_data_pair ctl_dat[16];
 339 } PACKED;
 340
 341 #define CMD_STATUS    0x38
 342 #define MSGID_STATUS1 0x08
 343 struct bcm3510_hab_cmd_status1 {
 344         struct {
 345                 u8 EQ_MODE       :4;
 346                 u8 reserved      :2;
 347                 u8 QRE           :1; /* if QSE and the spectrum is inversed */
 348                 u8 QSE           :1; /* automatic spectral inversion */
 349         } PACKED STATUS0;
 350
 351         struct {
 352                 u8 RECEIVER_LOCK :1;
 353                 u8 FEC_LOCK      :1;
 354                 u8 OUT_PLL_LOCK  :1;
 355                 u8 reserved      :5;
 356         } PACKED STATUS1;
 357
 358         struct {
 359                 u8 reserved      :2;
 360                 u8 BW            :1;
 361                 u8 NTE           :1; /* NTSC filter sweep enabled */
 362                 u8 AQI           :1; /* currently acquiring */
 363                 u8 FA            :1; /* fast acquisition */
 364                 u8 ARI           :1; /* auto reacquire */
 365                 u8 TI            :1; /* programming the tuner */
 366         } PACKED STATUS2;
 367         u8 STATUS3;
 368         u8 SNR_EST0;
 369         u8 SNR_EST1;
 370         u8 TUNER_FREQ0;
 371         u8 TUNER_FREQ1;
 372         u8 TUNER_FREQ2;
 373         u8 TUNER_FREQ3;
 374         u8 SYM_RATE0;
 375         u8 SYM_RATE1;
 376         u8 SYM_RATE2;
 377         u8 SYM_RATE3;
 378         u8 SYM_OFFSET0;
 379         u8 SYM_OFFSET1;
 380         u8 SYM_ERROR0;
 381         u8 SYM_ERROR1;
 382         u8 IF_FREQ0;
 383         u8 IF_FREQ1;
 384         u8 IF_FREQ2;
 385         u8 IF_FREQ3;
 386         u8 IF_OFFSET0;
 387         u8 IF_OFFSET1;
 388         u8 IF_ERROR0;
 389         u8 IF_ERROR1;
 390         u8 NTSC_FILTER0;
 391         u8 NTSC_FILTER1;
 392         u8 NTSC_FILTER2;
 393         u8 NTSC_FILTER3;
 394         u8 NTSC_OFFSET0;
 395         u8 NTSC_OFFSET1;
 396         u8 NTSC_ERROR0;
 397         u8 NTSC_ERROR1;
 398         u8 INT_AGC_LEVEL0;
 399         u8 INT_AGC_LEVEL1;
 400         u8 EXT_AGC_LEVEL0;
 401         u8 EXT_AGC_LEVEL1;
 402 } PACKED;
 403
 404 #define MSGID_STATUS2 0x14
 405 struct bcm3510_hab_cmd_status2 {
 406         struct {
 407                 u8 EQ_MODE  :4;
 408                 u8 reserved :2;
 409                 u8 QRE      :1;
 410                 u8 QSR      :1;
 411         } PACKED STATUS0;
 412         struct {
 413                 u8 RL       :1;
 414                 u8 FL       :1;
 415                 u8 OL       :1;
 416                 u8 reserved :5;
 417         } PACKED STATUS1;
 418         u8 SYMBOL_RATE0;
 419         u8 SYMBOL_RATE1;
 420         u8 SYMBOL_RATE2;
 421         u8 SYMBOL_RATE3;
 422         u8 LDCERC0;
 423         u8 LDCERC1;
 424         u8 LDCERC2;
 425         u8 LDCERC3;
 426         u8 LDUERC0;
 427         u8 LDUERC1;
 428         u8 LDUERC2;
 429         u8 LDUERC3;
 430         u8 LDBER0;
 431         u8 LDBER1;
 432         u8 LDBER2;
 433         u8 LDBER3;
 434         struct {
 435                 u8 MODE_TYPE :4; /* acquire mode 0 */
 436                 u8 reservd   :4;
 437         } MODE_TYPE;
 438         u8 SNR_EST0;
 439         u8 SNR_EST1;
 440         u8 SIGNAL;
 441 } PACKED;
 442
 443 #define CMD_SET_RF_BW_NOT_LISTED   0x3f
 444 #define MSGID_SET_RF_BW_NOT_LISTED 0x11
 445 /* TODO */
 446
 447 #endif