xref: /openbmc/linux/drivers/media/pci/tw686x/tw686x.h (revision 1804569d)
1 /*
2  * Copyright (C) 2015 VanguardiaSur - www.vanguardiasur.com.ar
3  *
4  * Copyright (C) 2015 Industrial Research Institute for Automation
5  * and Measurements PIAP
6  * Written by Krzysztof Ha?asa
7  *
8  * This program is free software; you can redistribute it and/or modify it
9  * under the terms of version 2 of the GNU General Public License
10  * as published by the Free Software Foundation.
11  */
12 
13 #include <linux/mutex.h>
14 #include <linux/pci.h>
15 #include <linux/timer.h>
16 #include <linux/videodev2.h>
17 #include <media/v4l2-common.h>
18 #include <media/v4l2-ctrls.h>
19 #include <media/v4l2-device.h>
20 #include <media/v4l2-ioctl.h>
21 #include <media/videobuf2-v4l2.h>
22 #include <sound/pcm.h>
23 
24 #include "tw686x-regs.h"
25 
26 #define TYPE_MAX_CHANNELS	0x0f
27 #define TYPE_SECOND_GEN		0x10
28 #define TW686X_DEF_PHASE_REF	0x1518
29 
30 #define TW686X_AUDIO_PAGE_MAX		16
31 #define TW686X_AUDIO_PERIODS_MIN	2
32 #define TW686X_AUDIO_PERIODS_MAX	TW686X_AUDIO_PAGE_MAX
33 
34 #define TW686X_DMA_MODE_MEMCPY		0
35 #define TW686X_DMA_MODE_CONTIG		1
36 #define TW686X_DMA_MODE_SG		2
37 
38 struct tw686x_format {
39 	char *name;
40 	unsigned int fourcc;
41 	unsigned int depth;
42 	unsigned int mode;
43 };
44 
45 struct tw686x_dma_desc {
46 	dma_addr_t phys;
47 	void *virt;
48 	unsigned int size;
49 };
50 
51 struct tw686x_sg_desc {
52 	/* 3 MSBits for flags, 13 LSBits for length */
53 	__le32 flags_length;
54 	__le32 phys;
55 };
56 
57 struct tw686x_audio_buf {
58 	dma_addr_t dma;
59 	void *virt;
60 	struct list_head list;
61 };
62 
63 struct tw686x_v4l2_buf {
64 	struct vb2_v4l2_buffer vb;
65 	struct list_head list;
66 };
67 
68 struct tw686x_audio_channel {
69 	struct tw686x_dev *dev;
70 	struct snd_pcm_substream *ss;
71 	unsigned int ch;
72 	struct tw686x_audio_buf *curr_bufs[2];
73 	struct tw686x_dma_desc dma_descs[2];
74 	dma_addr_t ptr;
75 
76 	struct tw686x_audio_buf buf[TW686X_AUDIO_PAGE_MAX];
77 	struct list_head buf_list;
78 	spinlock_t lock;
79 };
80 
81 struct tw686x_video_channel {
82 	struct tw686x_dev *dev;
83 
84 	struct vb2_queue vidq;
85 	struct list_head vidq_queued;
86 	struct video_device *device;
87 	struct tw686x_v4l2_buf *curr_bufs[2];
88 	struct tw686x_dma_desc dma_descs[2];
89 	struct tw686x_sg_desc *sg_descs[2];
90 
91 	struct v4l2_ctrl_handler ctrl_handler;
92 	const struct tw686x_format *format;
93 	struct mutex vb_mutex;
94 	spinlock_t qlock;
95 	v4l2_std_id video_standard;
96 	unsigned int width, height;
97 	unsigned int h_halve, v_halve;
98 	unsigned int ch;
99 	unsigned int num;
100 	unsigned int fps;
101 	unsigned int input;
102 	unsigned int sequence;
103 	unsigned int pb;
104 	bool no_signal;
105 };
106 
107 struct tw686x_dma_ops {
108 	int (*setup)(struct tw686x_dev *dev);
109 	int (*alloc)(struct tw686x_video_channel *vc, unsigned int pb);
110 	void (*free)(struct tw686x_video_channel *vc, unsigned int pb);
111 	void (*buf_refill)(struct tw686x_video_channel *vc, unsigned int pb);
112 	const struct vb2_mem_ops *mem_ops;
113 	enum v4l2_field field;
114 	u32 hw_dma_mode;
115 };
116 
117 /**
118  * struct tw686x_dev - global device status
119  * @lock: spinlock controlling access to the
120  *        shared device registers (DMA enable/disable).
121  */
122 struct tw686x_dev {
123 	spinlock_t lock;
124 
125 	struct v4l2_device v4l2_dev;
126 	struct snd_card *snd_card;
127 
128 	char name[32];
129 	unsigned int type;
130 	unsigned int dma_mode;
131 	struct pci_dev *pci_dev;
132 	__u32 __iomem *mmio;
133 
134 	const struct tw686x_dma_ops *dma_ops;
135 	struct tw686x_video_channel *video_channels;
136 	struct tw686x_audio_channel *audio_channels;
137 
138 	/* Per-device audio parameters */
139 	int audio_rate;
140 	int period_size;
141 	int audio_enabled;
142 
143 	struct timer_list dma_delay_timer;
144 	u32 pending_dma_en; /* must be protected by lock */
145 	u32 pending_dma_cmd; /* must be protected by lock */
146 };
147 
148 static inline uint32_t reg_read(struct tw686x_dev *dev, unsigned int reg)
149 {
150 	return readl(dev->mmio + reg);
151 }
152 
153 static inline void reg_write(struct tw686x_dev *dev, unsigned int reg,
154 			     uint32_t value)
155 {
156 	writel(value, dev->mmio + reg);
157 }
158 
159 static inline unsigned int max_channels(struct tw686x_dev *dev)
160 {
161 	return dev->type & TYPE_MAX_CHANNELS; /* 4 or 8 channels */
162 }
163 
164 static inline unsigned is_second_gen(struct tw686x_dev *dev)
165 {
166 	/* each channel has its own DMA SG table */
167 	return dev->type & TYPE_SECOND_GEN;
168 }
169 
170 void tw686x_enable_channel(struct tw686x_dev *dev, unsigned int channel);
171 void tw686x_disable_channel(struct tw686x_dev *dev, unsigned int channel);
172 
173 int tw686x_video_init(struct tw686x_dev *dev);
174 void tw686x_video_free(struct tw686x_dev *dev);
175 void tw686x_video_irq(struct tw686x_dev *dev, unsigned long requests,
176 		      unsigned int pb_status, unsigned int fifo_status,
177 		      unsigned int *reset_ch);
178 
179 int tw686x_audio_init(struct tw686x_dev *dev);
180 void tw686x_audio_free(struct tw686x_dev *dev);
181 void tw686x_audio_irq(struct tw686x_dev *dev, unsigned long requests,
182 		      unsigned int pb_status);
183