bcm3510_priv.h

Go to the documentation of this file.

/*
 * Support for the Broadcom BCM3510 ATSC demodulator (1st generation Air2PC)
 *
 *  Copyright (C) 2001-5, B2C2 inc.
 *
 *  GPL/Linux driver written by Patrick Boettcher <[email protected]>
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */
#ifndef __BCM3510_PRIV_H__
#define __BCM3510_PRIV_H__

#define PACKED __attribute__((packed))

#undef err
#define err(format, arg...)  printk(KERN_ERR     "bcm3510: " format "\n" , ## arg)
#undef info
#define info(format, arg...) printk(KERN_INFO    "bcm3510: " format "\n" , ## arg)
#undef warn
#define warn(format, arg...) printk(KERN_WARNING "bcm3510: " format "\n" , ## arg)


#define PANASONIC_FIRST_IF_BASE_IN_KHz  1407500
#define BCM3510_SYMBOL_RATE             5381000

typedef union {
    u8 raw;

    struct {
        u8 CTL   :8;
    } TSTCTL_2e;

    u8 LDCERC_4e;
    u8 LDUERC_4f;
    u8 LD_BER0_65;
    u8 LD_BER1_66;
    u8 LD_BER2_67;
    u8 LD_BER3_68;

    struct {
        u8 RESET :1;
        u8 IDLE  :1;
        u8 STOP  :1;
        u8 HIRQ0 :1;
        u8 HIRQ1 :1;
        u8 na0   :1;
        u8 HABAV :1;
        u8 na1   :1;
    } HCTL1_a0;

    struct {
        u8 na0    :1;
        u8 IDLMSK :1;
        u8 STMSK  :1;
        u8 I0MSK  :1;
        u8 I1MSK  :1;
        u8 na1    :1;
        u8 HABMSK :1;
        u8 na2    :1;
    } HCTLMSK_a1;

    struct {
        u8 RESET  :1;
        u8 IDLE   :1;
        u8 STOP   :1;
        u8 RUN    :1;
        u8 HABAV  :1;
        u8 MEMAV  :1;
        u8 ALDONE :1;
        u8 REIRQ  :1;
    } APSTAT1_a2;

    struct {
        u8 RSTMSK :1;
        u8 IMSK   :1;
        u8 SMSK   :1;
        u8 RMSK   :1;
        u8 HABMSK :1;
        u8 MAVMSK :1;
        u8 ALDMSK :1;
        u8 REMSK  :1;
    } APMSK1_a3;

    u8 APSTAT2_a4;
    u8 APMSK2_a5;

    struct {
        u8 HABADR :7;
        u8 na     :1;
    } HABADR_a6;

    u8 HABDATA_a7;

    struct {
        u8 HABR   :1;
        u8 LDHABR :1;
        u8 APMSK  :1;
        u8 HMSK   :1;
        u8 LDMSK  :1;
        u8 na     :3;
    } HABSTAT_a8;

    u8 MADRH_a9;
    u8 MADRL_aa;
    u8 MDATA_ab;

    struct {
#define JDEC_WAIT_AT_RAM      0x7
#define JDEC_EEPROM_LOAD_WAIT 0x4
        u8 JDEC   :3;
        u8 na     :5;
    } JDEC_ca;

    struct {
        u8 REV   :4;
        u8 LAYER :4;
    } REVID_e0;

    struct {
        u8 unk0   :1;
        u8 CNTCTL :1;
        u8 BITCNT :1;
        u8 unk1   :1;
        u8 RESYNC :1;
        u8 unk2   :3;
    } BERCTL_fa;

    struct {
        u8 CSEL0  :1;
        u8 CLKED0 :1;
        u8 CSEL1  :1;
        u8 CLKED1 :1;
        u8 CLKLEV :1;
        u8 SPIVAR :1;
        u8 na     :2;
    } TUNSET_fc;

    struct {
        u8 CLK    :1;
        u8 DATA   :1;
        u8 CS0    :1;
        u8 CS1    :1;
        u8 AGCSEL :1;
        u8 na0    :1;
        u8 TUNSEL :1;
        u8 na1    :1;
    } TUNCTL_fd;

    u8 TUNSEL0_fe;
    u8 TUNSEL1_ff;

} bcm3510_register_value;

/* HAB commands */

/* version */
#define CMD_GET_VERSION_INFO   0x3D
#define MSGID_GET_VERSION_INFO 0x15
struct bcm3510_hab_cmd_get_version_info {
    u8 microcode_version;
    u8 script_version;
    u8 config_version;
    u8 demod_version;
} PACKED;

#define BCM3510_DEF_MICROCODE_VERSION 0x0E
#define BCM3510_DEF_SCRIPT_VERSION    0x06
#define BCM3510_DEF_CONFIG_VERSION    0x01
#define BCM3510_DEF_DEMOD_VERSION     0xB1

/* acquire */
#define CMD_ACQUIRE            0x38

#define MSGID_EXT_TUNER_ACQUIRE 0x0A
struct bcm3510_hab_cmd_ext_acquire {
    struct {
        u8 MODE      :4;
        u8 BW        :1;
        u8 FA        :1;
        u8 NTSCSWEEP :1;
        u8 OFFSET    :1;
    } PACKED ACQUIRE0; /* control_byte */

    struct {
        u8 IF_FREQ  :3;
        u8 zero0    :1;
        u8 SYM_RATE :3;
        u8 zero1    :1;
    } PACKED ACQUIRE1; /* sym_if */

    u8 IF_OFFSET0;   /* IF_Offset_10hz */
    u8 IF_OFFSET1;
    u8 SYM_OFFSET0;  /* SymbolRateOffset */
    u8 SYM_OFFSET1;
    u8 NTSC_OFFSET0; /* NTSC_Offset_10hz */
    u8 NTSC_OFFSET1;
} PACKED;

#define MSGID_INT_TUNER_ACQUIRE 0x0B
struct bcm3510_hab_cmd_int_acquire {
    struct {
        u8 MODE      :4;
        u8 BW        :1;
        u8 FA        :1;
        u8 NTSCSWEEP :1;
        u8 OFFSET    :1;
    } PACKED ACQUIRE0; /* control_byte */

    struct {
        u8 IF_FREQ  :3;
        u8 zero0    :1;
        u8 SYM_RATE :3;
        u8 zero1    :1;
    } PACKED ACQUIRE1; /* sym_if */

    u8 TUNER_FREQ0;
    u8 TUNER_FREQ1;
    u8 TUNER_FREQ2;
    u8 TUNER_FREQ3;
    u8 IF_OFFSET0;   /* IF_Offset_10hz */
    u8 IF_OFFSET1;
    u8 SYM_OFFSET0;  /* SymbolRateOffset */
    u8 SYM_OFFSET1;
    u8 NTSC_OFFSET0; /* NTSC_Offset_10hz */
    u8 NTSC_OFFSET1;
} PACKED;

/* modes */
#define BCM3510_QAM16           =   0x01
#define BCM3510_QAM32           =   0x02
#define BCM3510_QAM64           =   0x03
#define BCM3510_QAM128          =   0x04
#define BCM3510_QAM256          =   0x05
#define BCM3510_8VSB            =   0x0B
#define BCM3510_16VSB           =   0x0D

/* IF_FREQS */
#define BCM3510_IF_TERRESTRIAL 0x0
#define BCM3510_IF_CABLE       0x1
#define BCM3510_IF_USE_CMD     0x7

/* SYM_RATE */
#define BCM3510_SR_8VSB        0x0 /* 5381119 s/sec */
#define BCM3510_SR_256QAM      0x1 /* 5360537 s/sec */
#define BCM3510_SR_16QAM       0x2 /* 5056971 s/sec */
#define BCM3510_SR_MISC        0x3 /* 5000000 s/sec */
#define BCM3510_SR_USE_CMD     0x7

/* special symbol rate */
#define CMD_SET_VALUE_NOT_LISTED  0x2d
#define MSGID_SET_SYMBOL_RATE_NOT_LISTED 0x0c
struct bcm3510_hab_cmd_set_sr_not_listed {
    u8 HOST_SYM_RATE0;
    u8 HOST_SYM_RATE1;
    u8 HOST_SYM_RATE2;
    u8 HOST_SYM_RATE3;
} PACKED;

/* special IF */
#define MSGID_SET_IF_FREQ_NOT_LISTED 0x0d
struct bcm3510_hab_cmd_set_if_freq_not_listed {
    u8 HOST_IF_FREQ0;
    u8 HOST_IF_FREQ1;
    u8 HOST_IF_FREQ2;
    u8 HOST_IF_FREQ3;
} PACKED;

/* auto reacquire */
#define CMD_AUTO_PARAM       0x2a
#define MSGID_AUTO_REACQUIRE 0x0e
struct bcm3510_hab_cmd_auto_reacquire {
    u8 ACQ    :1; /* on/off*/
    u8 unused :7;
} PACKED;

#define MSGID_SET_RF_AGC_SEL 0x12
struct bcm3510_hab_cmd_set_agc {
    u8 LVL    :1;
    u8 unused :6;
    u8 SEL    :1;
} PACKED;

#define MSGID_SET_AUTO_INVERSION 0x14
struct bcm3510_hab_cmd_auto_inversion {
    u8 AI     :1;
    u8 unused :7;
} PACKED;


/* bert control */
#define CMD_STATE_CONTROL  0x12
#define MSGID_BERT_CONTROL 0x0e
#define MSGID_BERT_SET     0xfa
struct bcm3510_hab_cmd_bert_control {
    u8 BE     :1;
    u8 unused :7;
} PACKED;

#define MSGID_TRI_STATE 0x2e
struct bcm3510_hab_cmd_tri_state {
    u8 RE :1; /* a/d ram port pins */
    u8 PE :1; /* baud clock pin */
    u8 AC :1; /* a/d clock pin */
    u8 BE :1; /* baud clock pin */
    u8 unused :4;
} PACKED;


/* tune */
#define CMD_TUNE   0x38
#define MSGID_TUNE 0x16
struct bcm3510_hab_cmd_tune_ctrl_data_pair {
    struct {
#define BITS_8 0x07
#define BITS_7 0x06
#define BITS_6 0x05
#define BITS_5 0x04
#define BITS_4 0x03
#define BITS_3 0x02
#define BITS_2 0x01
#define BITS_1 0x00
        u8 size    :3;
        u8 unk     :2;
        u8 clk_off :1;
        u8 cs0     :1;
        u8 cs1     :1;

    } PACKED ctrl;

    u8 data;
} PACKED;

struct bcm3510_hab_cmd_tune {
    u8 length;
    u8 clock_width;
    u8 misc;
    u8 TUNCTL_state;

    struct bcm3510_hab_cmd_tune_ctrl_data_pair ctl_dat[16];
} PACKED;

#define CMD_STATUS    0x38
#define MSGID_STATUS1 0x08
struct bcm3510_hab_cmd_status1 {
    struct {
        u8 EQ_MODE       :4;
        u8 reserved      :2;
        u8 QRE           :1; /* if QSE and the spectrum is inversed */
        u8 QSE           :1; /* automatic spectral inversion */
    } PACKED STATUS0;

    struct {
        u8 RECEIVER_LOCK :1;
        u8 FEC_LOCK      :1;
        u8 OUT_PLL_LOCK  :1;
        u8 reserved      :5;
    } PACKED STATUS1;

    struct {
        u8 reserved      :2;
        u8 BW            :1;
        u8 NTE           :1; /* NTSC filter sweep enabled */
        u8 AQI           :1; /* currently acquiring */
        u8 FA            :1; /* fast acquisition */
        u8 ARI           :1; /* auto reacquire */
        u8 TI            :1; /* programming the tuner */
    } PACKED STATUS2;
    u8 STATUS3;
    u8 SNR_EST0;
    u8 SNR_EST1;
    u8 TUNER_FREQ0;
    u8 TUNER_FREQ1;
    u8 TUNER_FREQ2;
    u8 TUNER_FREQ3;
    u8 SYM_RATE0;
    u8 SYM_RATE1;
    u8 SYM_RATE2;
    u8 SYM_RATE3;
    u8 SYM_OFFSET0;
    u8 SYM_OFFSET1;
    u8 SYM_ERROR0;
    u8 SYM_ERROR1;
    u8 IF_FREQ0;
    u8 IF_FREQ1;
    u8 IF_FREQ2;
    u8 IF_FREQ3;
    u8 IF_OFFSET0;
    u8 IF_OFFSET1;
    u8 IF_ERROR0;
    u8 IF_ERROR1;
    u8 NTSC_FILTER0;
    u8 NTSC_FILTER1;
    u8 NTSC_FILTER2;
    u8 NTSC_FILTER3;
    u8 NTSC_OFFSET0;
    u8 NTSC_OFFSET1;
    u8 NTSC_ERROR0;
    u8 NTSC_ERROR1;
    u8 INT_AGC_LEVEL0;
    u8 INT_AGC_LEVEL1;
    u8 EXT_AGC_LEVEL0;
    u8 EXT_AGC_LEVEL1;
} PACKED;

#define MSGID_STATUS2 0x14
struct bcm3510_hab_cmd_status2 {
    struct {
        u8 EQ_MODE  :4;
        u8 reserved :2;
        u8 QRE      :1;
        u8 QSR      :1;
    } PACKED STATUS0;
    struct {
        u8 RL       :1;
        u8 FL       :1;
        u8 OL       :1;
        u8 reserved :5;
    } PACKED STATUS1;
    u8 SYMBOL_RATE0;
    u8 SYMBOL_RATE1;
    u8 SYMBOL_RATE2;
    u8 SYMBOL_RATE3;
    u8 LDCERC0;
    u8 LDCERC1;
    u8 LDCERC2;
    u8 LDCERC3;
    u8 LDUERC0;
    u8 LDUERC1;
    u8 LDUERC2;
    u8 LDUERC3;
    u8 LDBER0;
    u8 LDBER1;
    u8 LDBER2;
    u8 LDBER3;
    struct {
        u8 MODE_TYPE :4; /* acquire mode 0 */
        u8 reservd   :4;
    } MODE_TYPE;
    u8 SNR_EST0;
    u8 SNR_EST1;
    u8 SIGNAL;
} PACKED;

#define CMD_SET_RF_BW_NOT_LISTED   0x3f
#define MSGID_SET_RF_BW_NOT_LISTED 0x11
/* TODO */

#endif