saa7146_vv.h

  1/* SPDX-License-Identifier: GPL-2.0 */
  2#ifndef __SAA7146_VV__
  3#define __SAA7146_VV__
  4
  5#include <media/v4l2-common.h>
  6#include <media/v4l2-ioctl.h>
  7#include <media/v4l2-fh.h>
  8#include <media/drv-intf/saa7146.h>
  9#include <media/videobuf2-dma-sg.h>
 10
 11#define MAX_SAA7146_CAPTURE_BUFFERS	32	/* arbitrary */
 12#define BUFFER_TIMEOUT     (HZ/2)  /* 0.5 seconds */
 13
 14#define WRITE_RPS0(x) do { \
 15	dev->d_rps0.cpu_addr[ count++ ] = cpu_to_le32(x); \
 16	} while (0);
 17
 18#define WRITE_RPS1(x) do { \
 19	dev->d_rps1.cpu_addr[ count++ ] = cpu_to_le32(x); \
 20	} while (0);
 21
 22struct	saa7146_video_dma {
 23	u32 base_odd;
 24	u32 base_even;
 25	u32 prot_addr;
 26	u32 pitch;
 27	u32 base_page;
 28	u32 num_line_byte;
 29};
 30
 31#define FORMAT_BYTE_SWAP	0x1
 32#define FORMAT_IS_PLANAR	0x2
 33
 34struct saa7146_format {
 35	u32	pixelformat;
 36	u32	trans;
 37	u8	depth;
 38	u8	flags;
 39	u8	swap;
 40};
 41
 42struct saa7146_standard
 43{
 44	char          *name;
 45	v4l2_std_id   id;
 46
 47	int v_offset;	/* number of lines of vertical offset before processing */
 48	int v_field;	/* number of lines in a field for HPS to process */
 49
 50	int h_offset;	/* horizontal offset of processing window */
 51	int h_pixels;	/* number of horizontal pixels to process */
 52
 53	int v_max_out;
 54	int h_max_out;
 55};
 56
 57/* buffer for one video/vbi frame */
 58struct saa7146_buf {
 59	/* common v4l buffer stuff -- must be first */
 60	struct vb2_v4l2_buffer vb;
 61	struct list_head list;
 62
 63	/* saa7146 specific */
 64	int (*activate)(struct saa7146_dev *dev,
 65			struct saa7146_buf *buf,
 66			struct saa7146_buf *next);
 67
 68	/* page tables */
 69	struct saa7146_pgtable  pt[3];
 70};
 71
 72struct saa7146_dmaqueue {
 73	struct saa7146_dev	*dev;
 74	struct saa7146_buf	*curr;
 75	struct list_head	queue;
 76	struct timer_list	timeout;
 77	struct vb2_queue	q;
 78};
 79
 80struct saa7146_vv
 81{
 82	/* vbi capture */
 83	struct saa7146_dmaqueue		vbi_dmaq;
 84	struct v4l2_vbi_format		vbi_fmt;
 85	struct timer_list		vbi_read_timeout;
 86	/* vbi workaround interrupt queue */
 87	wait_queue_head_t		vbi_wq;
 88
 89	/* video capture */
 90	struct saa7146_dmaqueue		video_dmaq;
 91	struct v4l2_pix_format		video_fmt;
 92	enum v4l2_field			last_field;
 93	u32				seqnr;
 94
 95	/* common: fixme? shouldn't this be in saa7146_fh?
 96	   (this leads to a more complicated question: shall the driver
 97	   store the different settings (for example S_INPUT) for every open
 98	   and restore it appropriately, or should all settings be common for
 99	   all opens? currently, we do the latter, like all other
100	   drivers do... */
101	struct saa7146_standard	*standard;
102
103	int	vflip;
104	int	hflip;
105	int	current_hps_source;
106	int	current_hps_sync;
107
108	unsigned int resources; /* resource management for device */
109};
110
111/* flags */
112#define SAA7146_USE_PORT_B_FOR_VBI	0x2     /* use input port b for vbi hardware bug workaround */
113
114struct saa7146_ext_vv
115{
116	/* information about the video capabilities of the device */
117	int	inputs;
118	int	audios;
119	u32	capabilities;
120	int	flags;
121
122	/* additionally supported transmission standards */
123	struct saa7146_standard *stds;
124	int num_stds;
125	int (*std_callback)(struct saa7146_dev*, struct saa7146_standard *);
126
127	/* the extension can override this */
128	struct v4l2_ioctl_ops vid_ops;
129	struct v4l2_ioctl_ops vbi_ops;
130	/* pointer to the saa7146 core ops */
131	const struct v4l2_ioctl_ops *core_ops;
132
133	ssize_t (*vbi_write)(struct file *file, const char __user *data,
134			     size_t count, loff_t *ppos);
135};
136
137struct saa7146_use_ops  {
138	void (*init)(struct saa7146_dev *, struct saa7146_vv *);
139	void (*irq_done)(struct saa7146_dev *, unsigned long status);
140};
141
142/* from saa7146_fops.c */
143int saa7146_register_device(struct video_device *vid, struct saa7146_dev *dev, char *name, int type);
144int saa7146_unregister_device(struct video_device *vid, struct saa7146_dev *dev);
145void saa7146_buffer_finish(struct saa7146_dev *dev, struct saa7146_dmaqueue *q, int state);
146void saa7146_buffer_next(struct saa7146_dev *dev, struct saa7146_dmaqueue *q,int vbi);
147int saa7146_buffer_queue(struct saa7146_dev *dev, struct saa7146_dmaqueue *q, struct saa7146_buf *buf);
148void saa7146_buffer_timeout(struct timer_list *t);
149
150int saa7146_vv_init(struct saa7146_dev* dev, struct saa7146_ext_vv *ext_vv);
151int saa7146_vv_release(struct saa7146_dev* dev);
152
153/* from saa7146_hlp.c */
154void saa7146_set_capture(struct saa7146_dev *dev, struct saa7146_buf *buf, struct saa7146_buf *next);
155void saa7146_write_out_dma(struct saa7146_dev* dev, int which, struct saa7146_video_dma* vdma) ;
156void saa7146_set_hps_source_and_sync(struct saa7146_dev *saa, int source, int sync);
157void saa7146_set_gpio(struct saa7146_dev *saa, u8 pin, u8 data);
158
159/* from saa7146_video.c */
160extern const struct v4l2_ioctl_ops saa7146_video_ioctl_ops;
161extern const struct v4l2_ioctl_ops saa7146_vbi_ioctl_ops;
162extern const struct saa7146_use_ops saa7146_video_uops;
163extern const struct vb2_ops video_qops;
164long saa7146_video_do_ioctl(struct file *file, unsigned int cmd, void *arg);
165int saa7146_s_ctrl(struct v4l2_ctrl *ctrl);
166
167/* from saa7146_vbi.c */
168extern const struct saa7146_use_ops saa7146_vbi_uops;
169extern const struct vb2_ops vbi_qops;
170
171/* resource management functions */
172int saa7146_res_get(struct saa7146_dev *dev, unsigned int bit);
173void saa7146_res_free(struct saa7146_dev *dev, unsigned int bits);
174
175#define RESOURCE_DMA1_HPS	0x1
176#define RESOURCE_DMA2_CLP	0x2
177#define RESOURCE_DMA3_BRS	0x4
178
179/* saa7146 source inputs */
180#define SAA7146_HPS_SOURCE_PORT_A	0x00
181#define SAA7146_HPS_SOURCE_PORT_B	0x01
182#define SAA7146_HPS_SOURCE_YPB_CPA	0x02
183#define SAA7146_HPS_SOURCE_YPA_CPB	0x03
184
185/* sync inputs */
186#define SAA7146_HPS_SYNC_PORT_A		0x00
187#define SAA7146_HPS_SYNC_PORT_B		0x01
188
189/* some memory sizes */
190/* max. 16 clipping rectangles */
191#define SAA7146_CLIPPING_MEM	(16 * 4 * sizeof(u32))
192
193/* some defines for the various clipping-modes */
194#define SAA7146_CLIPPING_RECT		0x4
195#define SAA7146_CLIPPING_RECT_INVERTED	0x5
196#define SAA7146_CLIPPING_MASK		0x6
197#define SAA7146_CLIPPING_MASK_INVERTED	0x7
198
199/* output formats: each entry holds four information */
200#define RGB08_COMPOSED	0x0217 /* composed is used in the sense of "not-planar" */
201/* this means: planar?=0, yuv2rgb-conversation-mode=2, dither=yes(=1), format-mode = 7 */
202#define RGB15_COMPOSED	0x0213
203#define RGB16_COMPOSED	0x0210
204#define RGB24_COMPOSED	0x0201
205#define RGB32_COMPOSED	0x0202
206
207#define Y8			0x0006
208#define YUV411_COMPOSED		0x0003
209#define YUV422_COMPOSED		0x0000
210/* this means: planar?=1, yuv2rgb-conversion-mode=0, dither=no(=0), format-mode = b */
211#define YUV411_DECOMPOSED	0x100b
212#define YUV422_DECOMPOSED	0x1009
213#define YUV420_DECOMPOSED	0x100a
214
215#define IS_PLANAR(x) (x & 0xf000)
216
217/* misc defines */
218#define SAA7146_NO_SWAP		(0x0)
219#define SAA7146_TWO_BYTE_SWAP	(0x1)
220#define SAA7146_FOUR_BYTE_SWAP	(0x2)
221
222#endif