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