linux/drivers/media/pci/pt3/pt3.h
Akihiro Tsukada f5a98f37a5 [media] pt3: add support for Earthsoft PT3 ISDB-S/T receiver card
This patch adds support for PT3 PCIe cards.
PT3 has an FPGA PCIe bridge chip, a TC90522 demod chip and
a VA4M6JC2103 tuner module which contains two QM1D1C0042 chips for ISDB-S
and two MxL301RF's for ISDB-T.
It can receive and deliver 4 (2x ISDB-S, 2x ISDB-T) streams simultaneously,
and a kthread is used per stream to poll incoming data,
because PT3 does not have interrupts.

As an antenna input for each delivery system is split in the tuner module
and shared between the corresponding two tuner chips,
LNB/LNA controls that the FPGA chip provides are (naturally) shared as well.
The tuner chips also share the power line in the tuner module,
which is controlled on/off by a GPIO pin of the demod chip.

As with the demod chip and the ISDB-T tuner chip,
the init sequences/register settings for those chips are not disclosed
and stored in a private memory of the FPGA,
PT3 driver executes the init of those chips on behalf of their drivers.

Signed-off-by: Akihiro Tsukada <tskd08@gmail.com>
Signed-off-by: Mauro Carvalho Chehab <mchehab@osg.samsung.com>
2014-09-23 17:04:01 -03:00

187 lines
4.6 KiB
C

/*
* Earthsoft PT3 driver
*
* Copyright (C) 2014 Akihiro Tsukada <tskd08@gmail.com>
*
* 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 version 2.
*
*
* 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.
*/
#ifndef PT3_H
#define PT3_H
#include <linux/atomic.h>
#include <linux/types.h>
#include "dvb_demux.h"
#include "dvb_frontend.h"
#include "dmxdev.h"
#include "tc90522.h"
#include "mxl301rf.h"
#include "qm1d1c0042.h"
#define DRV_NAME KBUILD_MODNAME
#define PT3_NUM_FE 4
/*
* register index of the FPGA chip
*/
#define REG_VERSION 0x00
#define REG_BUS 0x04
#define REG_SYSTEM_W 0x08
#define REG_SYSTEM_R 0x0c
#define REG_I2C_W 0x10
#define REG_I2C_R 0x14
#define REG_RAM_W 0x18
#define REG_RAM_R 0x1c
#define REG_DMA_BASE 0x40 /* regs for FE[i] = REG_DMA_BASE + 0x18 * i */
#define OFST_DMA_DESC_L 0x00
#define OFST_DMA_DESC_H 0x04
#define OFST_DMA_CTL 0x08
#define OFST_TS_CTL 0x0c
#define OFST_STATUS 0x10
#define OFST_TS_ERR 0x14
/*
* internal buffer for I2C
*/
#define PT3_I2C_MAX 4091
struct pt3_i2cbuf {
u8 data[PT3_I2C_MAX];
u8 tmp;
u32 num_cmds;
};
/*
* DMA things
*/
#define TS_PACKET_SZ 188
/* DMA transfers must not cross 4GiB, so use one page / transfer */
#define DATA_XFER_SZ 4096
#define DATA_BUF_XFERS 47
/* (num_bufs * DATA_BUF_SZ) % TS_PACKET_SZ must be 0 */
#define DATA_BUF_SZ (DATA_BUF_XFERS * DATA_XFER_SZ)
#define MAX_DATA_BUFS 16
#define MIN_DATA_BUFS 2
#define DESCS_IN_PAGE (PAGE_SIZE / sizeof(struct xfer_desc))
#define MAX_NUM_XFERS (MAX_DATA_BUFS * DATA_BUF_XFERS)
#define MAX_DESC_BUFS DIV_ROUND_UP(MAX_NUM_XFERS, DESCS_IN_PAGE)
/* DMA transfer description.
* device is passed a pointer to this struct, dma-reads it,
* and gets the DMA buffer ring for storing TS data.
*/
struct xfer_desc {
u32 addr_l; /* bus address of target data buffer */
u32 addr_h;
u32 size;
u32 next_l; /* bus adddress of the next xfer_desc */
u32 next_h;
};
/* A DMA mapping of a page containing xfer_desc's */
struct xfer_desc_buffer {
dma_addr_t b_addr;
struct xfer_desc *descs; /* PAGE_SIZE (xfer_desc[DESCS_IN_PAGE]) */
};
/* A DMA mapping of a data buffer */
struct dma_data_buffer {
dma_addr_t b_addr;
u8 *data; /* size: u8[PAGE_SIZE] */
};
/*
* device things
*/
struct pt3_adap_config {
struct i2c_board_info demod_info;
struct tc90522_config demod_cfg;
struct i2c_board_info tuner_info;
union tuner_config {
struct qm1d1c0042_config qm1d1c0042;
struct mxl301rf_config mxl301rf;
} tuner_cfg;
u32 init_freq;
};
struct pt3_adapter {
struct dvb_adapter dvb_adap; /* dvb_adap.priv => struct pt3_board */
int adap_idx;
struct dvb_demux demux;
struct dmxdev dmxdev;
struct dvb_frontend *fe;
struct i2c_client *i2c_demod;
struct i2c_client *i2c_tuner;
/* data fetch thread */
struct task_struct *thread;
int num_feeds;
bool cur_lna;
bool cur_lnb; /* current LNB power status (on/off) */
/* items below are for DMA */
struct dma_data_buffer buffer[MAX_DATA_BUFS];
int buf_idx;
int buf_ofs;
int num_bufs; /* == pt3_board->num_bufs */
int num_discard; /* how many access units to discard initially */
struct xfer_desc_buffer desc_buf[MAX_DESC_BUFS];
int num_desc_bufs; /* == num_bufs * DATA_BUF_XFERS / DESCS_IN_PAGE */
};
struct pt3_board {
struct pci_dev *pdev;
void __iomem *regs[2];
/* regs[0]: registers, regs[1]: internal memory, used for I2C */
struct mutex lock;
/* LNB power shared among sat-FEs */
int lnb_on_cnt; /* LNB power on count */
/* LNA shared among terr-FEs */
int lna_on_cnt; /* booster enabled count */
int num_bufs; /* number of DMA buffers allocated/mapped per FE */
struct i2c_adapter i2c_adap;
struct pt3_i2cbuf *i2c_buf;
struct pt3_adapter *adaps[PT3_NUM_FE];
};
/*
* prototypes
*/
extern int pt3_alloc_dmabuf(struct pt3_adapter *adap);
extern void pt3_init_dmabuf(struct pt3_adapter *adap);
extern void pt3_free_dmabuf(struct pt3_adapter *adap);
extern int pt3_start_dma(struct pt3_adapter *adap);
extern int pt3_stop_dma(struct pt3_adapter *adap);
extern int pt3_proc_dma(struct pt3_adapter *adap);
extern int pt3_i2c_master_xfer(struct i2c_adapter *adap,
struct i2c_msg *msgs, int num);
extern u32 pt3_i2c_functionality(struct i2c_adapter *adap);
extern void pt3_i2c_reset(struct pt3_board *pt3);
extern int pt3_init_all_demods(struct pt3_board *pt3);
extern int pt3_init_all_mxl301rf(struct pt3_board *pt3);
#endif /* PT3_H */