xref: /linux/drivers/media/pci/pt3/pt3.h (revision a13d7201d7deedcbb6ac6efa94a1a7d34d3d79ec)
1 /*
2  * Earthsoft PT3 driver
3  *
4  * Copyright (C) 2014 Akihiro Tsukada <tskd08@gmail.com>
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License as
8  * published by the Free Software Foundation version 2.
9  *
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  */
16 
17 #ifndef PT3_H
18 #define PT3_H
19 
20 #include <linux/atomic.h>
21 #include <linux/types.h>
22 
23 #include "dvb_demux.h"
24 #include "dvb_frontend.h"
25 #include "dmxdev.h"
26 
27 #include "tc90522.h"
28 #include "mxl301rf.h"
29 #include "qm1d1c0042.h"
30 
31 #define DRV_NAME KBUILD_MODNAME
32 
33 #define PT3_NUM_FE 4
34 
35 /*
36  * register index of the FPGA chip
37  */
38 #define REG_VERSION	0x00
39 #define REG_BUS		0x04
40 #define REG_SYSTEM_W	0x08
41 #define REG_SYSTEM_R	0x0c
42 #define REG_I2C_W	0x10
43 #define REG_I2C_R	0x14
44 #define REG_RAM_W	0x18
45 #define REG_RAM_R	0x1c
46 #define REG_DMA_BASE	0x40	/* regs for FE[i] = REG_DMA_BASE + 0x18 * i */
47 #define OFST_DMA_DESC_L	0x00
48 #define OFST_DMA_DESC_H	0x04
49 #define OFST_DMA_CTL	0x08
50 #define OFST_TS_CTL	0x0c
51 #define OFST_STATUS	0x10
52 #define OFST_TS_ERR	0x14
53 
54 /*
55  * internal buffer for I2C
56  */
57 #define PT3_I2C_MAX 4091
58 struct pt3_i2cbuf {
59 	u8  data[PT3_I2C_MAX];
60 	u8  tmp;
61 	u32 num_cmds;
62 };
63 
64 /*
65  * DMA things
66  */
67 #define TS_PACKET_SZ  188
68 /* DMA transfers must not cross 4GiB, so use one page / transfer */
69 #define DATA_XFER_SZ   4096
70 #define DATA_BUF_XFERS 47
71 /* (num_bufs * DATA_BUF_SZ) % TS_PACKET_SZ must be 0 */
72 #define DATA_BUF_SZ    (DATA_BUF_XFERS * DATA_XFER_SZ)
73 #define MAX_DATA_BUFS  16
74 #define MIN_DATA_BUFS   2
75 
76 #define DESCS_IN_PAGE (PAGE_SIZE / sizeof(struct xfer_desc))
77 #define MAX_NUM_XFERS (MAX_DATA_BUFS * DATA_BUF_XFERS)
78 #define MAX_DESC_BUFS DIV_ROUND_UP(MAX_NUM_XFERS, DESCS_IN_PAGE)
79 
80 /* DMA transfer description.
81  * device is passed a pointer to this struct, dma-reads it,
82  * and gets the DMA buffer ring for storing TS data.
83  */
84 struct xfer_desc {
85 	u32 addr_l; /* bus address of target data buffer */
86 	u32 addr_h;
87 	u32 size;
88 	u32 next_l; /* bus adddress of the next xfer_desc */
89 	u32 next_h;
90 };
91 
92 /* A DMA mapping of a page containing xfer_desc's */
93 struct xfer_desc_buffer {
94 	dma_addr_t b_addr;
95 	struct xfer_desc *descs; /* PAGE_SIZE (xfer_desc[DESCS_IN_PAGE]) */
96 };
97 
98 /* A DMA mapping of a data buffer */
99 struct dma_data_buffer {
100 	dma_addr_t b_addr;
101 	u8 *data; /* size: u8[PAGE_SIZE] */
102 };
103 
104 /*
105  * device things
106  */
107 struct pt3_adap_config {
108 	struct i2c_board_info demod_info;
109 	struct tc90522_config demod_cfg;
110 
111 	struct i2c_board_info tuner_info;
112 	union tuner_config {
113 		struct qm1d1c0042_config qm1d1c0042;
114 		struct mxl301rf_config   mxl301rf;
115 	} tuner_cfg;
116 	u32 init_freq;
117 };
118 
119 struct pt3_adapter {
120 	struct dvb_adapter  dvb_adap;  /* dvb_adap.priv => struct pt3_board */
121 	int adap_idx;
122 
123 	struct dvb_demux    demux;
124 	struct dmxdev       dmxdev;
125 	struct dvb_frontend *fe;
126 	struct i2c_client   *i2c_demod;
127 	struct i2c_client   *i2c_tuner;
128 
129 	/* data fetch thread */
130 	struct task_struct *thread;
131 	int num_feeds;
132 
133 	bool cur_lna;
134 	bool cur_lnb; /* current LNB power status (on/off) */
135 
136 	/* items below are for DMA */
137 	struct dma_data_buffer buffer[MAX_DATA_BUFS];
138 	int buf_idx;
139 	int buf_ofs;
140 	int num_bufs;  /* == pt3_board->num_bufs */
141 	int num_discard; /* how many access units to discard initially */
142 
143 	struct xfer_desc_buffer desc_buf[MAX_DESC_BUFS];
144 	int num_desc_bufs;  /* == num_bufs * DATA_BUF_XFERS / DESCS_IN_PAGE */
145 };
146 
147 
148 struct pt3_board {
149 	struct pci_dev *pdev;
150 	void __iomem *regs[2];
151 	/* regs[0]: registers, regs[1]: internal memory, used for I2C */
152 
153 	struct mutex lock;
154 
155 	/* LNB power shared among sat-FEs */
156 	int lnb_on_cnt; /* LNB power on count */
157 
158 	/* LNA shared among terr-FEs */
159 	int lna_on_cnt; /* booster enabled count */
160 
161 	int num_bufs;  /* number of DMA buffers allocated/mapped per FE */
162 
163 	struct i2c_adapter i2c_adap;
164 	struct pt3_i2cbuf *i2c_buf;
165 
166 	struct pt3_adapter *adaps[PT3_NUM_FE];
167 };
168 
169 
170 /*
171  * prototypes
172  */
173 extern int  pt3_alloc_dmabuf(struct pt3_adapter *adap);
174 extern void pt3_init_dmabuf(struct pt3_adapter *adap);
175 extern void pt3_free_dmabuf(struct pt3_adapter *adap);
176 extern int  pt3_start_dma(struct pt3_adapter *adap);
177 extern int  pt3_stop_dma(struct pt3_adapter *adap);
178 extern int  pt3_proc_dma(struct pt3_adapter *adap);
179 
180 extern int  pt3_i2c_master_xfer(struct i2c_adapter *adap,
181 				struct i2c_msg *msgs, int num);
182 extern u32  pt3_i2c_functionality(struct i2c_adapter *adap);
183 extern void pt3_i2c_reset(struct pt3_board *pt3);
184 extern int  pt3_init_all_demods(struct pt3_board *pt3);
185 extern int  pt3_init_all_mxl301rf(struct pt3_board *pt3);
186 #endif /* PT3_H */
187