[net-next-2.6.git] / include / media / saa7146_vv.h

#ifndef __SAA7146_VV__
#define __SAA7146_VV__

#include <media/v4l2-common.h>
#include <media/v4l2-ioctl.h>
#include <media/saa7146.h>
#include <media/videobuf-dma-sg.h>

#define MAX_SAA7146_CAPTURE_BUFFERS	32	/* arbitrary */
#define BUFFER_TIMEOUT     (HZ/2)  /* 0.5 seconds */

#define WRITE_RPS0(x) do { \
	dev->d_rps0.cpu_addr[ count++ ] = cpu_to_le32(x); \
	} while (0);

#define WRITE_RPS1(x) do { \
	dev->d_rps1.cpu_addr[ count++ ] = cpu_to_le32(x); \
	} while (0);

struct	saa7146_video_dma {
	u32 base_odd;
	u32 base_even;
	u32 prot_addr;
	u32 pitch;
	u32 base_page;
	u32 num_line_byte;
};

#define FORMAT_BYTE_SWAP	0x1
#define FORMAT_IS_PLANAR	0x2

struct saa7146_format {
	char	*name;
	u32	pixelformat;
	u32	trans;
	u8	depth;
	u8	flags;
	u8	swap;
};

struct saa7146_standard
{
	char          *name;
	v4l2_std_id   id;

	int v_offset;	/* number of lines of vertical offset before processing */
	int v_field;	/* number of lines in a field for HPS to process */

	int h_offset;	/* horizontal offset of processing window */
	int h_pixels;	/* number of horizontal pixels to process */

	int v_max_out;
	int h_max_out;
};

/* buffer for one video/vbi frame */
struct saa7146_buf {
	/* common v4l buffer stuff -- must be first */
	struct videobuf_buffer vb;

	/* saa7146 specific */
	struct v4l2_pix_format  *fmt;
	int (*activate)(struct saa7146_dev *dev,
			struct saa7146_buf *buf,
			struct saa7146_buf *next);

	/* page tables */
	struct saa7146_pgtable  pt[3];
};

struct saa7146_dmaqueue {
	struct saa7146_dev	*dev;
	struct saa7146_buf	*curr;
	struct list_head	queue;
	struct timer_list	timeout;
};

struct saa7146_overlay {
	struct saa7146_fh	*fh;
	struct v4l2_window	win;
	struct v4l2_clip	clips[16];
	int			nclips;
};

/* per open data */
struct saa7146_fh {
	struct saa7146_dev	*dev;
	/* if this is a vbi or capture open */
	enum v4l2_buf_type	type;

	/* video overlay */
	struct saa7146_overlay	ov;

	/* video capture */
	struct videobuf_queue	video_q;
	struct v4l2_pix_format	video_fmt;

	/* vbi capture */
	struct videobuf_queue	vbi_q;
	struct v4l2_vbi_format	vbi_fmt;
	struct timer_list	vbi_read_timeout;

	unsigned int resources;	/* resource management for device open */
};

#define STATUS_OVERLAY	0x01
#define STATUS_CAPTURE	0x02

struct saa7146_vv
{
	/* vbi capture */
	struct saa7146_dmaqueue		vbi_q;
	/* vbi workaround interrupt queue */
	wait_queue_head_t		vbi_wq;
	int				vbi_fieldcount;
	struct saa7146_fh		*vbi_streaming;

	int				video_status;
	struct saa7146_fh		*video_fh;

	/* video overlay */
	struct v4l2_framebuffer		ov_fb;
	struct saa7146_format		*ov_fmt;
	struct saa7146_overlay		*ov_data;
	struct saa7146_fh		*ov_suspend;

	/* video capture */
	struct saa7146_dmaqueue		video_q;
	enum v4l2_field			last_field;

	/* common: fixme? shouldn't this be in saa7146_fh?
	   (this leads to a more complicated question: shall the driver
	   store the different settings (for example S_INPUT) for every open
	   and restore it appropriately, or should all settings be common for
	   all opens? currently, we do the latter, like all other
	   drivers do... */
	struct saa7146_standard	*standard;

	int	vflip;
	int	hflip;
	int	current_hps_source;
	int	current_hps_sync;

	struct saa7146_dma	d_clipping;	/* pointer to clipping memory */

	unsigned int resources;	/* resource management for device */
};

/* flags */
#define SAA7146_USE_PORT_B_FOR_VBI	0x2     /* use input port b for vbi hardware bug workaround */

struct saa7146_ext_vv
{
	/* informations about the video capabilities of the device */
	int	inputs;
	int	audios;
	u32	capabilities;
	int	flags;

	/* additionally supported transmission standards */
	struct saa7146_standard *stds;
	int num_stds;
	int (*std_callback)(struct saa7146_dev*, struct saa7146_standard *);

	/* the extension can override this */
	struct v4l2_ioctl_ops ops;
	/* pointer to the saa7146 core ops */
	const struct v4l2_ioctl_ops *core_ops;

	struct v4l2_file_operations vbi_fops;
};

struct saa7146_use_ops  {
	void (*init)(struct saa7146_dev *, struct saa7146_vv *);
	int(*open)(struct saa7146_dev *, struct file *);
	void (*release)(struct saa7146_dev *, struct file *);
	void (*irq_done)(struct saa7146_dev *, unsigned long status);
	ssize_t (*read)(struct file *, char __user *, size_t, loff_t *);
};

/* from saa7146_fops.c */
int saa7146_register_device(struct video_device **vid, struct saa7146_dev* dev, char *name, int type);
int saa7146_unregister_device(struct video_device **vid, struct saa7146_dev* dev);
void saa7146_buffer_finish(struct saa7146_dev *dev, struct saa7146_dmaqueue *q, int state);
void saa7146_buffer_next(struct saa7146_dev *dev, struct saa7146_dmaqueue *q,int vbi);
int saa7146_buffer_queue(struct saa7146_dev *dev, struct saa7146_dmaqueue *q, struct saa7146_buf *buf);
void saa7146_buffer_timeout(unsigned long data);
void saa7146_dma_free(struct saa7146_dev* dev,struct videobuf_queue *q,
						struct saa7146_buf *buf);

int saa7146_vv_init(struct saa7146_dev* dev, struct saa7146_ext_vv *ext_vv);
int saa7146_vv_release(struct saa7146_dev* dev);

/* from saa7146_hlp.c */
int saa7146_enable_overlay(struct saa7146_fh *fh);
void saa7146_disable_overlay(struct saa7146_fh *fh);

void saa7146_set_capture(struct saa7146_dev *dev, struct saa7146_buf *buf, struct saa7146_buf *next);
void saa7146_write_out_dma(struct saa7146_dev* dev, int which, struct saa7146_video_dma* vdma) ;
void saa7146_set_hps_source_and_sync(struct saa7146_dev *saa, int source, int sync);
void saa7146_set_gpio(struct saa7146_dev *saa, u8 pin, u8 data);

/* from saa7146_video.c */
extern const struct v4l2_ioctl_ops saa7146_video_ioctl_ops;
extern struct saa7146_use_ops saa7146_video_uops;
int saa7146_start_preview(struct saa7146_fh *fh);
int saa7146_stop_preview(struct saa7146_fh *fh);
long saa7146_video_do_ioctl(struct file *file, unsigned int cmd, void *arg);

/* from saa7146_vbi.c */
extern struct saa7146_use_ops saa7146_vbi_uops;

/* resource management functions */
int saa7146_res_get(struct saa7146_fh *fh, unsigned int bit);
void saa7146_res_free(struct saa7146_fh *fh, unsigned int bits);

#define RESOURCE_DMA1_HPS	0x1
#define RESOURCE_DMA2_CLP	0x2
#define RESOURCE_DMA3_BRS	0x4

/* saa7146 source inputs */
#define SAA7146_HPS_SOURCE_PORT_A	0x00
#define SAA7146_HPS_SOURCE_PORT_B	0x01
#define SAA7146_HPS_SOURCE_YPB_CPA	0x02
#define SAA7146_HPS_SOURCE_YPA_CPB	0x03

/* sync inputs */
#define SAA7146_HPS_SYNC_PORT_A		0x00
#define SAA7146_HPS_SYNC_PORT_B		0x01

/* some memory sizes */
/* max. 16 clipping rectangles */
#define SAA7146_CLIPPING_MEM	(16 * 4 * sizeof(u32))

/* some defines for the various clipping-modes */
#define SAA7146_CLIPPING_RECT		0x4
#define SAA7146_CLIPPING_RECT_INVERTED	0x5
#define SAA7146_CLIPPING_MASK		0x6
#define SAA7146_CLIPPING_MASK_INVERTED	0x7

/* output formats: each entry holds four informations */
#define RGB08_COMPOSED	0x0217 /* composed is used in the sense of "not-planar" */
/* this means: planar?=0, yuv2rgb-conversation-mode=2, dither=yes(=1), format-mode = 7 */
#define RGB15_COMPOSED	0x0213
#define RGB16_COMPOSED	0x0210
#define RGB24_COMPOSED	0x0201
#define RGB32_COMPOSED	0x0202

#define Y8			0x0006
#define YUV411_COMPOSED		0x0003
#define YUV422_COMPOSED		0x0000
/* this means: planar?=1, yuv2rgb-conversion-mode=0, dither=no(=0), format-mode = b */
#define YUV411_DECOMPOSED	0x100b
#define YUV422_DECOMPOSED	0x1009
#define YUV420_DECOMPOSED	0x100a

#define IS_PLANAR(x) (x & 0xf000)

/* misc defines */
#define SAA7146_NO_SWAP		(0x0)
#define SAA7146_TWO_BYTE_SWAP	(0x1)
#define SAA7146_FOUR_BYTE_SWAP	(0x2)

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