1 /*
2  *  tw68 functions to handle video data
3  *
4  *  Much of this code is derived from the cx88 and sa7134 drivers, which
5  *  were in turn derived from the bt87x driver.  The original work was by
6  *  Gerd Knorr; more recently the code was enhanced by Mauro Carvalho Chehab,
7  *  Hans Verkuil, Andy Walls and many others.  Their work is gratefully
8  *  acknowledged.  Full credit goes to them - any problems within this code
9  *  are mine.
10  *
11  *  Copyright (C) 2009  William M. Brack
12  *
13  *  Refactored and updated to the latest v4l core frameworks:
14  *
15  *  Copyright (C) 2014 Hans Verkuil <hverkuil@xs4all.nl>
16  *
17  *  This program is free software; you can redistribute it and/or modify
18  *  it under the terms of the GNU General Public License as published by
19  *  the Free Software Foundation; either version 2 of the License, or
20  *  (at your option) any later version.
21  *
22  *  This program is distributed in the hope that it will be useful,
23  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
24  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
25  *  GNU General Public License for more details.
26  */
27 
28 #include <linux/module.h>
29 #include <media/v4l2-common.h>
30 #include <media/v4l2-event.h>
31 #include <media/videobuf2-dma-sg.h>
32 
33 #include "tw68.h"
34 #include "tw68-reg.h"
35 
36 /* ------------------------------------------------------------------ */
37 /* data structs for video                                             */
38 /*
39  * FIXME -
40  * Note that the saa7134 has formats, e.g. YUV420, which are classified
41  * as "planar".  These affect overlay mode, and are flagged with a field
42  * ".planar" in the format.  Do we need to implement this in this driver?
43  */
44 static const struct tw68_format formats[] = {
45 	{
46 		.name		= "15 bpp RGB, le",
47 		.fourcc		= V4L2_PIX_FMT_RGB555,
48 		.depth		= 16,
49 		.twformat	= ColorFormatRGB15,
50 	}, {
51 		.name		= "15 bpp RGB, be",
52 		.fourcc		= V4L2_PIX_FMT_RGB555X,
53 		.depth		= 16,
54 		.twformat	= ColorFormatRGB15 | ColorFormatBSWAP,
55 	}, {
56 		.name		= "16 bpp RGB, le",
57 		.fourcc		= V4L2_PIX_FMT_RGB565,
58 		.depth		= 16,
59 		.twformat	= ColorFormatRGB16,
60 	}, {
61 		.name		= "16 bpp RGB, be",
62 		.fourcc		= V4L2_PIX_FMT_RGB565X,
63 		.depth		= 16,
64 		.twformat	= ColorFormatRGB16 | ColorFormatBSWAP,
65 	}, {
66 		.name		= "24 bpp RGB, le",
67 		.fourcc		= V4L2_PIX_FMT_BGR24,
68 		.depth		= 24,
69 		.twformat	= ColorFormatRGB24,
70 	}, {
71 		.name		= "24 bpp RGB, be",
72 		.fourcc		= V4L2_PIX_FMT_RGB24,
73 		.depth		= 24,
74 		.twformat	= ColorFormatRGB24 | ColorFormatBSWAP,
75 	}, {
76 		.name		= "32 bpp RGB, le",
77 		.fourcc		= V4L2_PIX_FMT_BGR32,
78 		.depth		= 32,
79 		.twformat	= ColorFormatRGB32,
80 	}, {
81 		.name		= "32 bpp RGB, be",
82 		.fourcc		= V4L2_PIX_FMT_RGB32,
83 		.depth		= 32,
84 		.twformat	= ColorFormatRGB32 | ColorFormatBSWAP |
85 				  ColorFormatWSWAP,
86 	}, {
87 		.name		= "4:2:2 packed, YUYV",
88 		.fourcc		= V4L2_PIX_FMT_YUYV,
89 		.depth		= 16,
90 		.twformat	= ColorFormatYUY2,
91 	}, {
92 		.name		= "4:2:2 packed, UYVY",
93 		.fourcc		= V4L2_PIX_FMT_UYVY,
94 		.depth		= 16,
95 		.twformat	= ColorFormatYUY2 | ColorFormatBSWAP,
96 	}
97 };
98 #define FORMATS ARRAY_SIZE(formats)
99 
100 #define NORM_625_50			\
101 		.h_delay	= 3,	\
102 		.h_delay0	= 133,	\
103 		.h_start	= 0,	\
104 		.h_stop		= 719,	\
105 		.v_delay	= 24,	\
106 		.vbi_v_start_0	= 7,	\
107 		.vbi_v_stop_0	= 22,	\
108 		.video_v_start	= 24,	\
109 		.video_v_stop	= 311,	\
110 		.vbi_v_start_1	= 319
111 
112 #define NORM_525_60			\
113 		.h_delay	= 8,	\
114 		.h_delay0	= 138,	\
115 		.h_start	= 0,	\
116 		.h_stop		= 719,	\
117 		.v_delay	= 22,	\
118 		.vbi_v_start_0	= 10,	\
119 		.vbi_v_stop_0	= 21,	\
120 		.video_v_start	= 22,	\
121 		.video_v_stop	= 262,	\
122 		.vbi_v_start_1	= 273
123 
124 /*
125  * The following table is searched by tw68_s_std, first for a specific
126  * match, then for an entry which contains the desired id.  The table
127  * entries should therefore be ordered in ascending order of specificity.
128  */
129 static const struct tw68_tvnorm tvnorms[] = {
130 	{
131 		.name		= "PAL", /* autodetect */
132 		.id		= V4L2_STD_PAL,
133 		NORM_625_50,
134 
135 		.sync_control	= 0x18,
136 		.luma_control	= 0x40,
137 		.chroma_ctrl1	= 0x81,
138 		.chroma_gain	= 0x2a,
139 		.chroma_ctrl2	= 0x06,
140 		.vgate_misc	= 0x1c,
141 		.format		= VideoFormatPALBDGHI,
142 	}, {
143 		.name		= "NTSC",
144 		.id		= V4L2_STD_NTSC,
145 		NORM_525_60,
146 
147 		.sync_control	= 0x59,
148 		.luma_control	= 0x40,
149 		.chroma_ctrl1	= 0x89,
150 		.chroma_gain	= 0x2a,
151 		.chroma_ctrl2	= 0x0e,
152 		.vgate_misc	= 0x18,
153 		.format		= VideoFormatNTSC,
154 	}, {
155 		.name		= "SECAM",
156 		.id		= V4L2_STD_SECAM,
157 		NORM_625_50,
158 
159 		.sync_control	= 0x18,
160 		.luma_control	= 0x1b,
161 		.chroma_ctrl1	= 0xd1,
162 		.chroma_gain	= 0x80,
163 		.chroma_ctrl2	= 0x00,
164 		.vgate_misc	= 0x1c,
165 		.format		= VideoFormatSECAM,
166 	}, {
167 		.name		= "PAL-M",
168 		.id		= V4L2_STD_PAL_M,
169 		NORM_525_60,
170 
171 		.sync_control	= 0x59,
172 		.luma_control	= 0x40,
173 		.chroma_ctrl1	= 0xb9,
174 		.chroma_gain	= 0x2a,
175 		.chroma_ctrl2	= 0x0e,
176 		.vgate_misc	= 0x18,
177 		.format		= VideoFormatPALM,
178 	}, {
179 		.name		= "PAL-Nc",
180 		.id		= V4L2_STD_PAL_Nc,
181 		NORM_625_50,
182 
183 		.sync_control	= 0x18,
184 		.luma_control	= 0x40,
185 		.chroma_ctrl1	= 0xa1,
186 		.chroma_gain	= 0x2a,
187 		.chroma_ctrl2	= 0x06,
188 		.vgate_misc	= 0x1c,
189 		.format		= VideoFormatPALNC,
190 	}, {
191 		.name		= "PAL-60",
192 		.id		= V4L2_STD_PAL_60,
193 		.h_delay	= 186,
194 		.h_start	= 0,
195 		.h_stop		= 719,
196 		.v_delay	= 26,
197 		.video_v_start	= 23,
198 		.video_v_stop	= 262,
199 		.vbi_v_start_0	= 10,
200 		.vbi_v_stop_0	= 21,
201 		.vbi_v_start_1	= 273,
202 
203 		.sync_control	= 0x18,
204 		.luma_control	= 0x40,
205 		.chroma_ctrl1	= 0x81,
206 		.chroma_gain	= 0x2a,
207 		.chroma_ctrl2	= 0x06,
208 		.vgate_misc	= 0x1c,
209 		.format		= VideoFormatPAL60,
210 	}
211 };
212 #define TVNORMS ARRAY_SIZE(tvnorms)
213 
214 static const struct tw68_format *format_by_fourcc(unsigned int fourcc)
215 {
216 	unsigned int i;
217 
218 	for (i = 0; i < FORMATS; i++)
219 		if (formats[i].fourcc == fourcc)
220 			return formats+i;
221 	return NULL;
222 }
223 
224 
225 /* ------------------------------------------------------------------ */
226 /*
227  * Note that the cropping rectangles are described in terms of a single
228  * frame, i.e. line positions are only 1/2 the interlaced equivalent
229  */
230 static void set_tvnorm(struct tw68_dev *dev, const struct tw68_tvnorm *norm)
231 {
232 	if (norm != dev->tvnorm) {
233 		dev->width = 720;
234 		dev->height = (norm->id & V4L2_STD_525_60) ? 480 : 576;
235 		dev->tvnorm = norm;
236 		tw68_set_tvnorm_hw(dev);
237 	}
238 }
239 
240 /*
241  * tw68_set_scale
242  *
243  * Scaling and Cropping for video decoding
244  *
245  * We are working with 3 values for horizontal and vertical - scale,
246  * delay and active.
247  *
248  * HACTIVE represent the actual number of pixels in the "usable" image,
249  * before scaling.  HDELAY represents the number of pixels skipped
250  * between the start of the horizontal sync and the start of the image.
251  * HSCALE is calculated using the formula
252  *	HSCALE = (HACTIVE / (#pixels desired)) * 256
253  *
254  * The vertical registers are similar, except based upon the total number
255  * of lines in the image, and the first line of the image (i.e. ignoring
256  * vertical sync and VBI).
257  *
258  * Note that the number of bytes reaching the FIFO (and hence needing
259  * to be processed by the DMAP program) is completely dependent upon
260  * these values, especially HSCALE.
261  *
262  * Parameters:
263  *	@dev		pointer to the device structure, needed for
264  *			getting current norm (as well as debug print)
265  *	@width		actual image width (from user buffer)
266  *	@height		actual image height
267  *	@field		indicates Top, Bottom or Interlaced
268  */
269 static int tw68_set_scale(struct tw68_dev *dev, unsigned int width,
270 			  unsigned int height, enum v4l2_field field)
271 {
272 	const struct tw68_tvnorm *norm = dev->tvnorm;
273 	/* set individually for debugging clarity */
274 	int hactive, hdelay, hscale;
275 	int vactive, vdelay, vscale;
276 	int comb;
277 
278 	if (V4L2_FIELD_HAS_BOTH(field))	/* if field is interlaced */
279 		height /= 2;		/* we must set for 1-frame */
280 
281 	pr_debug("%s: width=%d, height=%d, both=%d\n"
282 		 "  tvnorm h_delay=%d, h_start=%d, h_stop=%d, "
283 		 "v_delay=%d, v_start=%d, v_stop=%d\n" , __func__,
284 		width, height, V4L2_FIELD_HAS_BOTH(field),
285 		norm->h_delay, norm->h_start, norm->h_stop,
286 		norm->v_delay, norm->video_v_start,
287 		norm->video_v_stop);
288 
289 	switch (dev->vdecoder) {
290 	case TW6800:
291 		hdelay = norm->h_delay0;
292 		break;
293 	default:
294 		hdelay = norm->h_delay;
295 		break;
296 	}
297 
298 	hdelay += norm->h_start;
299 	hactive = norm->h_stop - norm->h_start + 1;
300 
301 	hscale = (hactive * 256) / (width);
302 
303 	vdelay = norm->v_delay;
304 	vactive = ((norm->id & V4L2_STD_525_60) ? 524 : 624) / 2 - norm->video_v_start;
305 	vscale = (vactive * 256) / height;
306 
307 	pr_debug("%s: %dx%d [%s%s,%s]\n", __func__,
308 		width, height,
309 		V4L2_FIELD_HAS_TOP(field)    ? "T" : "",
310 		V4L2_FIELD_HAS_BOTTOM(field) ? "B" : "",
311 		v4l2_norm_to_name(dev->tvnorm->id));
312 	pr_debug("%s: hactive=%d, hdelay=%d, hscale=%d; "
313 		"vactive=%d, vdelay=%d, vscale=%d\n", __func__,
314 		hactive, hdelay, hscale, vactive, vdelay, vscale);
315 
316 	comb =	((vdelay & 0x300)  >> 2) |
317 		((vactive & 0x300) >> 4) |
318 		((hdelay & 0x300)  >> 6) |
319 		((hactive & 0x300) >> 8);
320 	pr_debug("%s: setting CROP_HI=%02x, VDELAY_LO=%02x, "
321 		"VACTIVE_LO=%02x, HDELAY_LO=%02x, HACTIVE_LO=%02x\n",
322 		__func__, comb, vdelay, vactive, hdelay, hactive);
323 	tw_writeb(TW68_CROP_HI, comb);
324 	tw_writeb(TW68_VDELAY_LO, vdelay & 0xff);
325 	tw_writeb(TW68_VACTIVE_LO, vactive & 0xff);
326 	tw_writeb(TW68_HDELAY_LO, hdelay & 0xff);
327 	tw_writeb(TW68_HACTIVE_LO, hactive & 0xff);
328 
329 	comb = ((vscale & 0xf00) >> 4) | ((hscale & 0xf00) >> 8);
330 	pr_debug("%s: setting SCALE_HI=%02x, VSCALE_LO=%02x, "
331 		"HSCALE_LO=%02x\n", __func__, comb, vscale, hscale);
332 	tw_writeb(TW68_SCALE_HI, comb);
333 	tw_writeb(TW68_VSCALE_LO, vscale);
334 	tw_writeb(TW68_HSCALE_LO, hscale);
335 
336 	return 0;
337 }
338 
339 /* ------------------------------------------------------------------ */
340 
341 int tw68_video_start_dma(struct tw68_dev *dev, struct tw68_buf *buf)
342 {
343 	/* Set cropping and scaling */
344 	tw68_set_scale(dev, dev->width, dev->height, dev->field);
345 	/*
346 	 *  Set start address for RISC program.  Note that if the DMAP
347 	 *  processor is currently running, it must be stopped before
348 	 *  a new address can be set.
349 	 */
350 	tw_clearl(TW68_DMAC, TW68_DMAP_EN);
351 	tw_writel(TW68_DMAP_SA, buf->dma);
352 	/* Clear any pending interrupts */
353 	tw_writel(TW68_INTSTAT, dev->board_virqmask);
354 	/* Enable the risc engine and the fifo */
355 	tw_andorl(TW68_DMAC, 0xff, dev->fmt->twformat |
356 		ColorFormatGamma | TW68_DMAP_EN | TW68_FIFO_EN);
357 	dev->pci_irqmask |= dev->board_virqmask;
358 	tw_setl(TW68_INTMASK, dev->pci_irqmask);
359 	return 0;
360 }
361 
362 /* ------------------------------------------------------------------ */
363 
364 /* calc max # of buffers from size (must not exceed the 4MB virtual
365  * address space per DMA channel) */
366 static int tw68_buffer_count(unsigned int size, unsigned int count)
367 {
368 	unsigned int maxcount;
369 
370 	maxcount = (4 * 1024 * 1024) / roundup(size, PAGE_SIZE);
371 	if (count > maxcount)
372 		count = maxcount;
373 	return count;
374 }
375 
376 /* ------------------------------------------------------------- */
377 /* vb2 queue operations                                          */
378 
379 static int tw68_queue_setup(struct vb2_queue *q, const struct v4l2_format *fmt,
380 			   unsigned int *num_buffers, unsigned int *num_planes,
381 			   unsigned int sizes[], void *alloc_ctxs[])
382 {
383 	struct tw68_dev *dev = vb2_get_drv_priv(q);
384 	unsigned tot_bufs = q->num_buffers + *num_buffers;
385 
386 	sizes[0] = (dev->fmt->depth * dev->width * dev->height) >> 3;
387 	alloc_ctxs[0] = dev->alloc_ctx;
388 	/*
389 	 * We allow create_bufs, but only if the sizeimage is the same as the
390 	 * current sizeimage. The tw68_buffer_count calculation becomes quite
391 	 * difficult otherwise.
392 	 */
393 	if (fmt && fmt->fmt.pix.sizeimage < sizes[0])
394 		return -EINVAL;
395 	*num_planes = 1;
396 	if (tot_bufs < 2)
397 		tot_bufs = 2;
398 	tot_bufs = tw68_buffer_count(sizes[0], tot_bufs);
399 	*num_buffers = tot_bufs - q->num_buffers;
400 
401 	return 0;
402 }
403 
404 /*
405  * The risc program for each buffers works as follows: it starts with a simple
406  * 'JUMP to addr + 8', which is effectively a NOP. Then the program to DMA the
407  * buffer follows and at the end we have a JUMP back to the start + 8 (skipping
408  * the initial JUMP).
409  *
410  * This is the program of the first buffer to be queued if the active list is
411  * empty and it just keeps DMAing this buffer without generating any interrupts.
412  *
413  * If a new buffer is added then the initial JUMP in the program generates an
414  * interrupt as well which signals that the previous buffer has been DMAed
415  * successfully and that it can be returned to userspace.
416  *
417  * It also sets the final jump of the previous buffer to the start of the new
418  * buffer, thus chaining the new buffer into the DMA chain. This is a single
419  * atomic u32 write, so there is no race condition.
420  *
421  * The end-result of all this that you only get an interrupt when a buffer
422  * is ready, so the control flow is very easy.
423  */
424 static void tw68_buf_queue(struct vb2_buffer *vb)
425 {
426 	struct vb2_queue *vq = vb->vb2_queue;
427 	struct tw68_dev *dev = vb2_get_drv_priv(vq);
428 	struct tw68_buf *buf = container_of(vb, struct tw68_buf, vb);
429 	struct tw68_buf *prev;
430 	unsigned long flags;
431 
432 	spin_lock_irqsave(&dev->slock, flags);
433 
434 	/* append a 'JUMP to start of buffer' to the buffer risc program */
435 	buf->jmp[0] = cpu_to_le32(RISC_JUMP);
436 	buf->jmp[1] = cpu_to_le32(buf->dma + 8);
437 
438 	if (!list_empty(&dev->active)) {
439 		prev = list_entry(dev->active.prev, struct tw68_buf, list);
440 		buf->cpu[0] |= cpu_to_le32(RISC_INT_BIT);
441 		prev->jmp[1] = cpu_to_le32(buf->dma);
442 	}
443 	list_add_tail(&buf->list, &dev->active);
444 	spin_unlock_irqrestore(&dev->slock, flags);
445 }
446 
447 /*
448  * buffer_prepare
449  *
450  * Set the ancilliary information into the buffer structure.  This
451  * includes generating the necessary risc program if it hasn't already
452  * been done for the current buffer format.
453  * The structure fh contains the details of the format requested by the
454  * user - type, width, height and #fields.  This is compared with the
455  * last format set for the current buffer.  If they differ, the risc
456  * code (which controls the filling of the buffer) is (re-)generated.
457  */
458 static int tw68_buf_prepare(struct vb2_buffer *vb)
459 {
460 	struct vb2_queue *vq = vb->vb2_queue;
461 	struct tw68_dev *dev = vb2_get_drv_priv(vq);
462 	struct tw68_buf *buf = container_of(vb, struct tw68_buf, vb);
463 	struct sg_table *dma = vb2_dma_sg_plane_desc(vb, 0);
464 	unsigned size, bpl;
465 
466 	size = (dev->width * dev->height * dev->fmt->depth) >> 3;
467 	if (vb2_plane_size(vb, 0) < size)
468 		return -EINVAL;
469 	vb2_set_plane_payload(vb, 0, size);
470 
471 	bpl = (dev->width * dev->fmt->depth) >> 3;
472 	switch (dev->field) {
473 	case V4L2_FIELD_TOP:
474 		tw68_risc_buffer(dev->pci, buf, dma->sgl,
475 				 0, UNSET, bpl, 0, dev->height);
476 		break;
477 	case V4L2_FIELD_BOTTOM:
478 		tw68_risc_buffer(dev->pci, buf, dma->sgl,
479 				 UNSET, 0, bpl, 0, dev->height);
480 		break;
481 	case V4L2_FIELD_SEQ_TB:
482 		tw68_risc_buffer(dev->pci, buf, dma->sgl,
483 				 0, bpl * (dev->height >> 1),
484 				 bpl, 0, dev->height >> 1);
485 		break;
486 	case V4L2_FIELD_SEQ_BT:
487 		tw68_risc_buffer(dev->pci, buf, dma->sgl,
488 				 bpl * (dev->height >> 1), 0,
489 				 bpl, 0, dev->height >> 1);
490 		break;
491 	case V4L2_FIELD_INTERLACED:
492 	default:
493 		tw68_risc_buffer(dev->pci, buf, dma->sgl,
494 				 0, bpl, bpl, bpl, dev->height >> 1);
495 		break;
496 	}
497 	return 0;
498 }
499 
500 static void tw68_buf_finish(struct vb2_buffer *vb)
501 {
502 	struct vb2_queue *vq = vb->vb2_queue;
503 	struct tw68_dev *dev = vb2_get_drv_priv(vq);
504 	struct tw68_buf *buf = container_of(vb, struct tw68_buf, vb);
505 
506 	pci_free_consistent(dev->pci, buf->size, buf->cpu, buf->dma);
507 }
508 
509 static int tw68_start_streaming(struct vb2_queue *q, unsigned int count)
510 {
511 	struct tw68_dev *dev = vb2_get_drv_priv(q);
512 	struct tw68_buf *buf =
513 		container_of(dev->active.next, struct tw68_buf, list);
514 
515 	dev->seqnr = 0;
516 	tw68_video_start_dma(dev, buf);
517 	return 0;
518 }
519 
520 static void tw68_stop_streaming(struct vb2_queue *q)
521 {
522 	struct tw68_dev *dev = vb2_get_drv_priv(q);
523 
524 	/* Stop risc & fifo */
525 	tw_clearl(TW68_DMAC, TW68_DMAP_EN | TW68_FIFO_EN);
526 	while (!list_empty(&dev->active)) {
527 		struct tw68_buf *buf =
528 			container_of(dev->active.next, struct tw68_buf, list);
529 
530 		list_del(&buf->list);
531 		vb2_buffer_done(&buf->vb, VB2_BUF_STATE_ERROR);
532 	}
533 }
534 
535 static struct vb2_ops tw68_video_qops = {
536 	.queue_setup	= tw68_queue_setup,
537 	.buf_queue	= tw68_buf_queue,
538 	.buf_prepare	= tw68_buf_prepare,
539 	.buf_finish	= tw68_buf_finish,
540 	.start_streaming = tw68_start_streaming,
541 	.stop_streaming = tw68_stop_streaming,
542 	.wait_prepare	= vb2_ops_wait_prepare,
543 	.wait_finish	= vb2_ops_wait_finish,
544 };
545 
546 /* ------------------------------------------------------------------ */
547 
548 static int tw68_s_ctrl(struct v4l2_ctrl *ctrl)
549 {
550 	struct tw68_dev *dev =
551 		container_of(ctrl->handler, struct tw68_dev, hdl);
552 
553 	switch (ctrl->id) {
554 	case V4L2_CID_BRIGHTNESS:
555 		tw_writeb(TW68_BRIGHT, ctrl->val);
556 		break;
557 	case V4L2_CID_HUE:
558 		tw_writeb(TW68_HUE, ctrl->val);
559 		break;
560 	case V4L2_CID_CONTRAST:
561 		tw_writeb(TW68_CONTRAST, ctrl->val);
562 		break;
563 	case V4L2_CID_SATURATION:
564 		tw_writeb(TW68_SAT_U, ctrl->val);
565 		tw_writeb(TW68_SAT_V, ctrl->val);
566 		break;
567 	case V4L2_CID_COLOR_KILLER:
568 		if (ctrl->val)
569 			tw_andorb(TW68_MISC2, 0xe0, 0xe0);
570 		else
571 			tw_andorb(TW68_MISC2, 0xe0, 0x00);
572 		break;
573 	case V4L2_CID_CHROMA_AGC:
574 		if (ctrl->val)
575 			tw_andorb(TW68_LOOP, 0x30, 0x20);
576 		else
577 			tw_andorb(TW68_LOOP, 0x30, 0x00);
578 		break;
579 	}
580 	return 0;
581 }
582 
583 /* ------------------------------------------------------------------ */
584 
585 /*
586  * Note that this routine returns what is stored in the fh structure, and
587  * does not interrogate any of the device registers.
588  */
589 static int tw68_g_fmt_vid_cap(struct file *file, void *priv,
590 				struct v4l2_format *f)
591 {
592 	struct tw68_dev *dev = video_drvdata(file);
593 
594 	f->fmt.pix.width        = dev->width;
595 	f->fmt.pix.height       = dev->height;
596 	f->fmt.pix.field        = dev->field;
597 	f->fmt.pix.pixelformat  = dev->fmt->fourcc;
598 	f->fmt.pix.bytesperline =
599 		(f->fmt.pix.width * (dev->fmt->depth)) >> 3;
600 	f->fmt.pix.sizeimage =
601 		f->fmt.pix.height * f->fmt.pix.bytesperline;
602 	f->fmt.pix.colorspace	= V4L2_COLORSPACE_SMPTE170M;
603 	f->fmt.pix.priv = 0;
604 	return 0;
605 }
606 
607 static int tw68_try_fmt_vid_cap(struct file *file, void *priv,
608 						struct v4l2_format *f)
609 {
610 	struct tw68_dev *dev = video_drvdata(file);
611 	const struct tw68_format *fmt;
612 	enum v4l2_field field;
613 	unsigned int maxh;
614 
615 	fmt = format_by_fourcc(f->fmt.pix.pixelformat);
616 	if (NULL == fmt)
617 		return -EINVAL;
618 
619 	field = f->fmt.pix.field;
620 	maxh  = (dev->tvnorm->id & V4L2_STD_525_60) ? 480 : 576;
621 
622 	switch (field) {
623 	case V4L2_FIELD_TOP:
624 	case V4L2_FIELD_BOTTOM:
625 		break;
626 	case V4L2_FIELD_INTERLACED:
627 	case V4L2_FIELD_SEQ_BT:
628 	case V4L2_FIELD_SEQ_TB:
629 		maxh = maxh * 2;
630 		break;
631 	default:
632 		field = (f->fmt.pix.height > maxh / 2)
633 			? V4L2_FIELD_INTERLACED
634 			: V4L2_FIELD_BOTTOM;
635 		break;
636 	}
637 
638 	f->fmt.pix.field = field;
639 	if (f->fmt.pix.width  < 48)
640 		f->fmt.pix.width  = 48;
641 	if (f->fmt.pix.height < 32)
642 		f->fmt.pix.height = 32;
643 	if (f->fmt.pix.width > 720)
644 		f->fmt.pix.width = 720;
645 	if (f->fmt.pix.height > maxh)
646 		f->fmt.pix.height = maxh;
647 	f->fmt.pix.width &= ~0x03;
648 	f->fmt.pix.bytesperline =
649 		(f->fmt.pix.width * (fmt->depth)) >> 3;
650 	f->fmt.pix.sizeimage =
651 		f->fmt.pix.height * f->fmt.pix.bytesperline;
652 	f->fmt.pix.colorspace = V4L2_COLORSPACE_SMPTE170M;
653 	return 0;
654 }
655 
656 /*
657  * Note that tw68_s_fmt_vid_cap sets the information into the fh structure,
658  * and it will be used for all future new buffers.  However, there could be
659  * some number of buffers on the "active" chain which will be filled before
660  * the change takes place.
661  */
662 static int tw68_s_fmt_vid_cap(struct file *file, void *priv,
663 					struct v4l2_format *f)
664 {
665 	struct tw68_dev *dev = video_drvdata(file);
666 	int err;
667 
668 	err = tw68_try_fmt_vid_cap(file, priv, f);
669 	if (0 != err)
670 		return err;
671 
672 	dev->fmt = format_by_fourcc(f->fmt.pix.pixelformat);
673 	dev->width = f->fmt.pix.width;
674 	dev->height = f->fmt.pix.height;
675 	dev->field = f->fmt.pix.field;
676 	return 0;
677 }
678 
679 static int tw68_enum_input(struct file *file, void *priv,
680 					struct v4l2_input *i)
681 {
682 	struct tw68_dev *dev = video_drvdata(file);
683 	unsigned int n;
684 
685 	n = i->index;
686 	if (n >= TW68_INPUT_MAX)
687 		return -EINVAL;
688 	i->index = n;
689 	i->type = V4L2_INPUT_TYPE_CAMERA;
690 	snprintf(i->name, sizeof(i->name), "Composite %d", n);
691 
692 	/* If the query is for the current input, get live data */
693 	if (n == dev->input) {
694 		int v1 = tw_readb(TW68_STATUS1);
695 		int v2 = tw_readb(TW68_MVSN);
696 
697 		if (0 != (v1 & (1 << 7)))
698 			i->status |= V4L2_IN_ST_NO_SYNC;
699 		if (0 != (v1 & (1 << 6)))
700 			i->status |= V4L2_IN_ST_NO_H_LOCK;
701 		if (0 != (v1 & (1 << 2)))
702 			i->status |= V4L2_IN_ST_NO_SIGNAL;
703 		if (0 != (v1 & 1 << 1))
704 			i->status |= V4L2_IN_ST_NO_COLOR;
705 		if (0 != (v2 & (1 << 2)))
706 			i->status |= V4L2_IN_ST_MACROVISION;
707 	}
708 	i->std = video_devdata(file)->tvnorms;
709 	return 0;
710 }
711 
712 static int tw68_g_input(struct file *file, void *priv, unsigned int *i)
713 {
714 	struct tw68_dev *dev = video_drvdata(file);
715 
716 	*i = dev->input;
717 	return 0;
718 }
719 
720 static int tw68_s_input(struct file *file, void *priv, unsigned int i)
721 {
722 	struct tw68_dev *dev = video_drvdata(file);
723 
724 	if (i >= TW68_INPUT_MAX)
725 		return -EINVAL;
726 	dev->input = i;
727 	tw_andorb(TW68_INFORM, 0x03 << 2, dev->input << 2);
728 	return 0;
729 }
730 
731 static int tw68_querycap(struct file *file, void  *priv,
732 					struct v4l2_capability *cap)
733 {
734 	struct tw68_dev *dev = video_drvdata(file);
735 
736 	strcpy(cap->driver, "tw68");
737 	strlcpy(cap->card, "Techwell Capture Card",
738 		sizeof(cap->card));
739 	sprintf(cap->bus_info, "PCI:%s", pci_name(dev->pci));
740 	cap->device_caps =
741 		V4L2_CAP_VIDEO_CAPTURE |
742 		V4L2_CAP_READWRITE |
743 		V4L2_CAP_STREAMING;
744 
745 	cap->capabilities = cap->device_caps | V4L2_CAP_DEVICE_CAPS;
746 	return 0;
747 }
748 
749 static int tw68_s_std(struct file *file, void *priv, v4l2_std_id id)
750 {
751 	struct tw68_dev *dev = video_drvdata(file);
752 	unsigned int i;
753 
754 	if (vb2_is_busy(&dev->vidq))
755 		return -EBUSY;
756 
757 	/* Look for match on complete norm id (may have mult bits) */
758 	for (i = 0; i < TVNORMS; i++) {
759 		if (id == tvnorms[i].id)
760 			break;
761 	}
762 
763 	/* If no exact match, look for norm which contains this one */
764 	if (i == TVNORMS) {
765 		for (i = 0; i < TVNORMS; i++)
766 			if (id & tvnorms[i].id)
767 				break;
768 	}
769 	/* If still not matched, give up */
770 	if (i == TVNORMS)
771 		return -EINVAL;
772 
773 	set_tvnorm(dev, &tvnorms[i]);	/* do the actual setting */
774 	return 0;
775 }
776 
777 static int tw68_g_std(struct file *file, void *priv, v4l2_std_id *id)
778 {
779 	struct tw68_dev *dev = video_drvdata(file);
780 
781 	*id = dev->tvnorm->id;
782 	return 0;
783 }
784 
785 static int tw68_enum_fmt_vid_cap(struct file *file, void  *priv,
786 					struct v4l2_fmtdesc *f)
787 {
788 	if (f->index >= FORMATS)
789 		return -EINVAL;
790 
791 	strlcpy(f->description, formats[f->index].name,
792 		sizeof(f->description));
793 
794 	f->pixelformat = formats[f->index].fourcc;
795 
796 	return 0;
797 }
798 
799 /*
800  * Used strictly for internal development and debugging, this routine
801  * prints out the current register contents for the tw68xx device.
802  */
803 static void tw68_dump_regs(struct tw68_dev *dev)
804 {
805 	unsigned char line[80];
806 	int i, j, k;
807 	unsigned char *cptr;
808 
809 	pr_info("Full dump of TW68 registers:\n");
810 	/* First we do the PCI regs, 8 4-byte regs per line */
811 	for (i = 0; i < 0x100; i += 32) {
812 		cptr = line;
813 		cptr += sprintf(cptr, "%03x  ", i);
814 		/* j steps through the next 4 words */
815 		for (j = i; j < i + 16; j += 4)
816 			cptr += sprintf(cptr, "%08x ", tw_readl(j));
817 		*cptr++ = ' ';
818 		for (; j < i + 32; j += 4)
819 			cptr += sprintf(cptr, "%08x ", tw_readl(j));
820 		*cptr++ = '\n';
821 		*cptr = 0;
822 		pr_info("%s", line);
823 	}
824 	/* Next the control regs, which are single-byte, address mod 4 */
825 	while (i < 0x400) {
826 		cptr = line;
827 		cptr += sprintf(cptr, "%03x ", i);
828 		/* Print out 4 groups of 4 bytes */
829 		for (j = 0; j < 4; j++) {
830 			for (k = 0; k < 4; k++) {
831 				cptr += sprintf(cptr, "%02x ",
832 					tw_readb(i));
833 				i += 4;
834 			}
835 			*cptr++ = ' ';
836 		}
837 		*cptr++ = '\n';
838 		*cptr = 0;
839 		pr_info("%s", line);
840 	}
841 }
842 
843 static int vidioc_log_status(struct file *file, void *priv)
844 {
845 	struct tw68_dev *dev = video_drvdata(file);
846 
847 	tw68_dump_regs(dev);
848 	return v4l2_ctrl_log_status(file, priv);
849 }
850 
851 #ifdef CONFIG_VIDEO_ADV_DEBUG
852 static int vidioc_g_register(struct file *file, void *priv,
853 			      struct v4l2_dbg_register *reg)
854 {
855 	struct tw68_dev *dev = video_drvdata(file);
856 
857 	if (reg->size == 1)
858 		reg->val = tw_readb(reg->reg);
859 	else
860 		reg->val = tw_readl(reg->reg);
861 	return 0;
862 }
863 
864 static int vidioc_s_register(struct file *file, void *priv,
865 				const struct v4l2_dbg_register *reg)
866 {
867 	struct tw68_dev *dev = video_drvdata(file);
868 
869 	if (reg->size == 1)
870 		tw_writeb(reg->reg, reg->val);
871 	else
872 		tw_writel(reg->reg & 0xffff, reg->val);
873 	return 0;
874 }
875 #endif
876 
877 static const struct v4l2_ctrl_ops tw68_ctrl_ops = {
878 	.s_ctrl = tw68_s_ctrl,
879 };
880 
881 static const struct v4l2_file_operations video_fops = {
882 	.owner			= THIS_MODULE,
883 	.open			= v4l2_fh_open,
884 	.release		= vb2_fop_release,
885 	.read			= vb2_fop_read,
886 	.poll			= vb2_fop_poll,
887 	.mmap			= vb2_fop_mmap,
888 	.unlocked_ioctl		= video_ioctl2,
889 };
890 
891 static const struct v4l2_ioctl_ops video_ioctl_ops = {
892 	.vidioc_querycap		= tw68_querycap,
893 	.vidioc_enum_fmt_vid_cap	= tw68_enum_fmt_vid_cap,
894 	.vidioc_reqbufs			= vb2_ioctl_reqbufs,
895 	.vidioc_create_bufs		= vb2_ioctl_create_bufs,
896 	.vidioc_querybuf		= vb2_ioctl_querybuf,
897 	.vidioc_qbuf			= vb2_ioctl_qbuf,
898 	.vidioc_dqbuf			= vb2_ioctl_dqbuf,
899 	.vidioc_s_std			= tw68_s_std,
900 	.vidioc_g_std			= tw68_g_std,
901 	.vidioc_enum_input		= tw68_enum_input,
902 	.vidioc_g_input			= tw68_g_input,
903 	.vidioc_s_input			= tw68_s_input,
904 	.vidioc_streamon		= vb2_ioctl_streamon,
905 	.vidioc_streamoff		= vb2_ioctl_streamoff,
906 	.vidioc_g_fmt_vid_cap		= tw68_g_fmt_vid_cap,
907 	.vidioc_try_fmt_vid_cap		= tw68_try_fmt_vid_cap,
908 	.vidioc_s_fmt_vid_cap		= tw68_s_fmt_vid_cap,
909 	.vidioc_log_status		= vidioc_log_status,
910 	.vidioc_subscribe_event		= v4l2_ctrl_subscribe_event,
911 	.vidioc_unsubscribe_event	= v4l2_event_unsubscribe,
912 #ifdef CONFIG_VIDEO_ADV_DEBUG
913 	.vidioc_g_register              = vidioc_g_register,
914 	.vidioc_s_register              = vidioc_s_register,
915 #endif
916 };
917 
918 static struct video_device tw68_video_template = {
919 	.name			= "tw68_video",
920 	.fops			= &video_fops,
921 	.ioctl_ops		= &video_ioctl_ops,
922 	.release		= video_device_release_empty,
923 	.tvnorms		= TW68_NORMS,
924 };
925 
926 /* ------------------------------------------------------------------ */
927 /* exported stuff                                                     */
928 void tw68_set_tvnorm_hw(struct tw68_dev *dev)
929 {
930 	tw_andorb(TW68_SDT, 0x07, dev->tvnorm->format);
931 }
932 
933 int tw68_video_init1(struct tw68_dev *dev)
934 {
935 	struct v4l2_ctrl_handler *hdl = &dev->hdl;
936 
937 	v4l2_ctrl_handler_init(hdl, 6);
938 	v4l2_ctrl_new_std(hdl, &tw68_ctrl_ops,
939 			V4L2_CID_BRIGHTNESS, -128, 127, 1, 20);
940 	v4l2_ctrl_new_std(hdl, &tw68_ctrl_ops,
941 			V4L2_CID_CONTRAST, 0, 255, 1, 100);
942 	v4l2_ctrl_new_std(hdl, &tw68_ctrl_ops,
943 			V4L2_CID_SATURATION, 0, 255, 1, 128);
944 	/* NTSC only */
945 	v4l2_ctrl_new_std(hdl, &tw68_ctrl_ops,
946 			V4L2_CID_HUE, -128, 127, 1, 0);
947 	v4l2_ctrl_new_std(hdl, &tw68_ctrl_ops,
948 			V4L2_CID_COLOR_KILLER, 0, 1, 1, 0);
949 	v4l2_ctrl_new_std(hdl, &tw68_ctrl_ops,
950 			V4L2_CID_CHROMA_AGC, 0, 1, 1, 1);
951 	if (hdl->error) {
952 		v4l2_ctrl_handler_free(hdl);
953 		return hdl->error;
954 	}
955 	dev->v4l2_dev.ctrl_handler = hdl;
956 	v4l2_ctrl_handler_setup(hdl);
957 	return 0;
958 }
959 
960 int tw68_video_init2(struct tw68_dev *dev, int video_nr)
961 {
962 	int ret;
963 
964 	set_tvnorm(dev, &tvnorms[0]);
965 
966 	dev->fmt      = format_by_fourcc(V4L2_PIX_FMT_BGR24);
967 	dev->width    = 720;
968 	dev->height   = 576;
969 	dev->field    = V4L2_FIELD_INTERLACED;
970 
971 	INIT_LIST_HEAD(&dev->active);
972 	dev->vidq.type = V4L2_BUF_TYPE_VIDEO_CAPTURE;
973 	dev->vidq.timestamp_flags = V4L2_BUF_FLAG_TIMESTAMP_MONOTONIC;
974 	dev->vidq.io_modes = VB2_MMAP | VB2_USERPTR | VB2_READ | VB2_DMABUF;
975 	dev->vidq.ops = &tw68_video_qops;
976 	dev->vidq.mem_ops = &vb2_dma_sg_memops;
977 	dev->vidq.drv_priv = dev;
978 	dev->vidq.gfp_flags = __GFP_DMA32;
979 	dev->vidq.buf_struct_size = sizeof(struct tw68_buf);
980 	dev->vidq.lock = &dev->lock;
981 	dev->vidq.min_buffers_needed = 2;
982 	ret = vb2_queue_init(&dev->vidq);
983 	if (ret)
984 		return ret;
985 	dev->vdev = tw68_video_template;
986 	dev->vdev.v4l2_dev = &dev->v4l2_dev;
987 	dev->vdev.lock = &dev->lock;
988 	dev->vdev.queue = &dev->vidq;
989 	video_set_drvdata(&dev->vdev, dev);
990 	return video_register_device(&dev->vdev, VFL_TYPE_GRABBER, video_nr);
991 }
992 
993 /*
994  * tw68_irq_video_done
995  */
996 void tw68_irq_video_done(struct tw68_dev *dev, unsigned long status)
997 {
998 	__u32 reg;
999 
1000 	/* reset interrupts handled by this routine */
1001 	tw_writel(TW68_INTSTAT, status);
1002 	/*
1003 	 * Check most likely first
1004 	 *
1005 	 * DMAPI shows we have reached the end of the risc code
1006 	 * for the current buffer.
1007 	 */
1008 	if (status & TW68_DMAPI) {
1009 		struct tw68_buf *buf;
1010 
1011 		spin_lock(&dev->slock);
1012 		buf = list_entry(dev->active.next, struct tw68_buf, list);
1013 		list_del(&buf->list);
1014 		spin_unlock(&dev->slock);
1015 		v4l2_get_timestamp(&buf->vb.v4l2_buf.timestamp);
1016 		buf->vb.v4l2_buf.field = dev->field;
1017 		buf->vb.v4l2_buf.sequence = dev->seqnr++;
1018 		vb2_buffer_done(&buf->vb, VB2_BUF_STATE_DONE);
1019 		status &= ~(TW68_DMAPI);
1020 		if (0 == status)
1021 			return;
1022 	}
1023 	if (status & (TW68_VLOCK | TW68_HLOCK))
1024 		dev_dbg(&dev->pci->dev, "Lost sync\n");
1025 	if (status & TW68_PABORT)
1026 		dev_err(&dev->pci->dev, "PABORT interrupt\n");
1027 	if (status & TW68_DMAPERR)
1028 		dev_err(&dev->pci->dev, "DMAPERR interrupt\n");
1029 	/*
1030 	 * On TW6800, FDMIS is apparently generated if video input is switched
1031 	 * during operation.  Therefore, it is not enabled for that chip.
1032 	 */
1033 	if (status & TW68_FDMIS)
1034 		dev_dbg(&dev->pci->dev, "FDMIS interrupt\n");
1035 	if (status & TW68_FFOF) {
1036 		/* probably a logic error */
1037 		reg = tw_readl(TW68_DMAC) & TW68_FIFO_EN;
1038 		tw_clearl(TW68_DMAC, TW68_FIFO_EN);
1039 		dev_dbg(&dev->pci->dev, "FFOF interrupt\n");
1040 		tw_setl(TW68_DMAC, reg);
1041 	}
1042 	if (status & TW68_FFERR)
1043 		dev_dbg(&dev->pci->dev, "FFERR interrupt\n");
1044 }
1045