2 * Driver for the NXP SAA7164 PCIe bridge
4 * Copyright (c) 2009 Steven Toth <stoth@kernellabs.com>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
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
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
26 saa7164_core.c/buffer.c/cards.c/i2c.c/dvb.c
27 | : Standard Linux driver framework for creating
28 | : exposing and managing interfaces to the rest
29 | : of the kernel or userland. Also uses _fw.c to load
30 | : firmware direct into the PCIe bus, bypassing layers.
32 saa7164_api..() : Translate kernel specific functions/features
33 | : into command buffers.
35 saa7164_cmd..() : Manages the flow of command packets on/off,
36 | : the bus. Deal with bus errors, timeouts etc.
38 saa7164_bus..() : Manage a read/write memory ring buffer in the
39 | : PCIe Address space.
41 | saa7164_fw...() : Load any frimware
42 | | : direct into the device
44 <- ----------------- PCIe address space -------------------- ->
47 #include <linux/pci.h>
48 #include <linux/i2c.h>
49 #include <linux/i2c-algo-bit.h>
50 #include <linux/kdev_t.h>
52 #include <media/tuner.h>
53 #include <media/tveeprom.h>
54 #include <media/videobuf-dma-sg.h>
55 #include <media/videobuf-dvb.h>
57 #include "saa7164-reg.h"
58 #include "saa7164-types.h"
60 #include <linux/version.h>
61 #include <linux/mutex.h>
63 #define SAA7164_MAXBOARDS 8
66 #define SAA7164_BOARD_NOAUTO UNSET
67 #define SAA7164_BOARD_UNKNOWN 0
68 #define SAA7164_BOARD_UNKNOWN_REV2 1
69 #define SAA7164_BOARD_UNKNOWN_REV3 2
70 #define SAA7164_BOARD_HAUPPAUGE_HVR2250 3
71 #define SAA7164_BOARD_HAUPPAUGE_HVR2200 4
72 #define SAA7164_BOARD_HAUPPAUGE_HVR2200_2 5
73 #define SAA7164_BOARD_HAUPPAUGE_HVR2200_3 6
74 #define SAA7164_BOARD_HAUPPAUGE_HVR2250_2 7
76 #define SAA7164_MAX_UNITS 8
77 #define SAA7164_TS_NUMBER_OF_LINES 312
78 #define SAA7164_PT_ENTRIES 16 /* (312 * 188) / 4096 */
85 #define DBGLVL_BUS 128
86 #define DBGLVL_IRQ 256
87 #define DBGLVL_BUF 512
90 SAA7164_MPEG_UNDEFINED = 0,
94 enum saa7164_i2c_bus_nr {
95 SAA7164_I2C_BUS_0 = 0,
100 enum saa7164_buffer_flags {
101 SAA7164_BUFFER_UNDEFINED = 0,
107 enum saa7164_unit_type {
108 SAA7164_UNIT_UNDEFINED = 0,
109 SAA7164_UNIT_DIGITAL_DEMODULATOR,
110 SAA7164_UNIT_ANALOG_DEMODULATOR,
113 SAA7164_UNIT_ZILOG_IRBLASTER,
114 SAA7164_UNIT_ENCODER,
117 /* The PCIe bridge doesn't grant direct access to i2c.
118 * Instead, you address i2c devices using a uniqely
119 * allocated 'unitid' value via a messaging API. This
120 * is a problem. The kernel and existing demod/tuner
121 * drivers expect to talk 'i2c', so we have to maintain
122 * a translation layer, and a series of functions to
123 * convert i2c bus + device address into a unit id.
125 struct saa7164_unit {
126 enum saa7164_unit_type type;
129 enum saa7164_i2c_bus_nr i2c_bus_nr;
134 struct saa7164_board {
136 enum port_t porta, portb;
138 SAA7164_CHIP_UNDEFINED = 0,
142 struct saa7164_unit unit[SAA7164_MAX_UNITS];
145 struct saa7164_subid {
151 struct saa7164_fw_status {
153 /* RISC Core details */
161 /* Firmware version */
171 struct dvb_adapter adapter;
172 struct dvb_frontend *frontend;
173 struct dvb_demux demux;
174 struct dmxdev dmxdev;
175 struct dmx_frontend fe_hw;
176 struct dmx_frontend fe_mem;
182 struct saa7164_dev *dev;
184 enum saa7164_i2c_bus_nr nr;
187 struct i2c_adapter i2c_adap;
188 struct i2c_algo_bit_data i2c_algo;
189 struct i2c_client i2c_client;
193 struct saa7164_tsport;
195 struct saa7164_buffer {
196 struct list_head list;
200 struct saa7164_tsport *port;
202 /* Hardware Specific */
203 /* PCI Memory allocations */
204 enum saa7164_buffer_flags flags; /* Free, Busy, Full */
206 /* A block of page align PCI memory */
207 u32 pci_size; /* PCI allocation size in bytes */
208 u64 *cpu; /* Virtual address */
209 dma_addr_t dma; /* Physical address */
211 /* A page table that splits the block into a number of entries */
212 u32 pt_size; /* PCI allocation size in bytes */
213 u64 *pt_cpu; /* Virtual address */
214 dma_addr_t pt_dma; /* Physical address */
217 struct saa7164_tsport {
219 struct saa7164_dev *dev;
223 struct saa7164_dvb dvb;
225 /* HW related stream parameters */
226 tmHWStreamParameters_t hw_streamingparams;
228 /* DMA configuration values, is seeded during initialization */
229 tmComResDMATermDescrHeader_t hwcfg;
231 /* hardware specific registers */
240 u32 numpte; /* Number of entries in array, only valid in head */
241 struct mutex dmaqueue_lock;
242 struct mutex dummy_dmaqueue_lock;
243 struct saa7164_buffer dmaqueue;
244 struct saa7164_buffer dummy_dmaqueue;
249 struct list_head devlist;
254 unsigned char pci_rev, pci_lat;
255 int pci_bus, pci_slot;
268 /* firmware status */
269 struct saa7164_fw_status fw_status;
271 tmComResHWDescr_t hwdesc;
272 tmComResInterfaceDescr_t intfdesc;
273 tmComResBusDescr_t busdesc;
275 tmComResBusInfo_t bus;
277 /* TODO: Urgh, remove volatiles */
278 volatile u32 *InterruptStatus;
279 volatile u32 *InterruptAck;
281 struct cmd cmds[SAA_CMD_MAX_MSG_UNITS];
285 struct saa7164_i2c i2c_bus[3];
287 /* Transport related */
288 struct saa7164_tsport ts1, ts2;
290 /* Deferred command/api interrupts handling */
291 struct work_struct workcmd;
295 extern struct list_head saa7164_devlist;
297 /* ----------------------------------------------------------- */
299 void saa7164_dumpregs(struct saa7164_dev *dev, u32 addr);
300 void saa7164_dumphex16(struct saa7164_dev *dev, u8 *buf, int len);
301 void saa7164_getfirmwarestatus(struct saa7164_dev *dev);
302 u32 saa7164_getcurrentfirmwareversion(struct saa7164_dev *dev);
304 /* ----------------------------------------------------------- */
306 int saa7164_downloadfirmware(struct saa7164_dev *dev);
308 /* ----------------------------------------------------------- */
310 extern int saa7164_i2c_register(struct saa7164_i2c *bus);
311 extern int saa7164_i2c_unregister(struct saa7164_i2c *bus);
312 extern void saa7164_call_i2c_clients(struct saa7164_i2c *bus,
313 unsigned int cmd, void *arg);
315 /* ----------------------------------------------------------- */
317 int saa7164_bus_setup(struct saa7164_dev *dev);
318 void saa7164_bus_dump(struct saa7164_dev *dev);
319 int saa7164_bus_set(struct saa7164_dev *dev, tmComResInfo_t* msg, void *buf);
320 int saa7164_bus_get(struct saa7164_dev *dev, tmComResInfo_t* msg,
321 void *buf, int peekonly);
323 /* ----------------------------------------------------------- */
325 int saa7164_cmd_send(struct saa7164_dev *dev,
326 u8 id, tmComResCmd_t command, u16 controlselector,
327 u16 size, void *buf);
328 void saa7164_cmd_signal(struct saa7164_dev *dev, u8 seqno);
330 /* ----------------------------------------------------------- */
332 int saa7164_api_test(struct saa7164_dev *dev);
333 int saa7164_api_get_fw_version(struct saa7164_dev *dev, u32 *version);
334 int saa7164_api_enum_subdevs(struct saa7164_dev *dev);
335 int saa7164_api_i2c_read(struct saa7164_i2c *bus, u8 addr, u32 reglen, u8 *reg,
336 u32 datalen, u8 *data);
337 int saa7164_api_i2c_write(struct saa7164_i2c *bus, u8 addr,
338 u32 datalen, u8 *data);
339 int saa7164_api_dif_write(struct saa7164_i2c *bus, u8 addr,
340 u32 datalen, u8 *data);
341 int saa7164_api_read_eeprom(struct saa7164_dev *dev, u8 *buf, int buflen);
342 int saa7164_api_set_gpiobit(struct saa7164_dev *dev, u8 unitid, u8 pin);
343 int saa7164_api_clear_gpiobit(struct saa7164_dev *dev, u8 unitid, u8 pin);
344 int saa7164_api_transition_port(struct saa7164_tsport *port, u8 mode);
346 /* ----------------------------------------------------------- */
347 /* saa7164-cards.c */
348 extern struct saa7164_board saa7164_boards[];
349 extern const unsigned int saa7164_bcount;
351 extern struct saa7164_subid saa7164_subids[];
352 extern const unsigned int saa7164_idcount;
354 extern void saa7164_card_list(struct saa7164_dev *dev);
355 extern void saa7164_gpio_setup(struct saa7164_dev *dev);
356 extern void saa7164_card_setup(struct saa7164_dev *dev);
358 extern int saa7164_i2caddr_to_reglen(struct saa7164_i2c *bus, int addr);
359 extern int saa7164_i2caddr_to_unitid(struct saa7164_i2c *bus, int addr);
360 extern char *saa7164_unitid_name(struct saa7164_dev *dev, u8 unitid);
362 /* ----------------------------------------------------------- */
364 extern int saa7164_dvb_register(struct saa7164_tsport *port);
365 extern int saa7164_dvb_unregister(struct saa7164_tsport *port);
367 /* ----------------------------------------------------------- */
368 /* saa7164-buffer.c */
369 extern struct saa7164_buffer *saa7164_buffer_alloc(struct saa7164_tsport *port,
371 extern int saa7164_buffer_dealloc(struct saa7164_tsport *port,
372 struct saa7164_buffer *buf);
374 /* ----------------------------------------------------------- */
376 extern unsigned int debug;
377 #define dprintk(level, fmt, arg...)\
378 do { if (debug & level)\
379 printk(KERN_DEBUG "%s: " fmt, dev->name, ## arg);\
382 #define log_warn(fmt, arg...)\
384 printk(KERN_WARNING "%s: " fmt, dev->name, ## arg);\
387 #define log_err(fmt, arg...)\
389 printk(KERN_ERROR "%s: " fmt, dev->name, ## arg);\
392 #define saa7164_readl(reg) readl(dev->lmmio + ((reg) >> 2))
393 #define saa7164_writel(reg, value) \
395 printk(KERN_ERR "writel(%x, %llx)\n", value, (u64)(dev->lmmio + ((reg) >> 2))); \
396 writel((value), dev->lmmio + ((reg) >> 2)); \
399 #define saa7164_readb(reg) readl(dev->bmmio + (reg))
400 #define saa7164_writeb(reg, value) writel((value), dev->bmmio + (reg))