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