1/*
2 *  Driver for the Conexant CX23885 PCIe bridge
3 *
4 *  Copyright (c) 2007 Steven Toth <stoth@linuxtv.org>
5 *
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.
10 *
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
14 *
15 *  GNU General Public License for more details.
16 */
17
18#include <linux/kernel.h>
19#include <linux/module.h>
20#include <linux/moduleparam.h>
21#include <linux/init.h>
22
23#include "cx23885.h"
24
25static unsigned int vbibufs = 4;
26module_param(vbibufs, int, 0644);
27MODULE_PARM_DESC(vbibufs, "number of vbi buffers, range 2-32");
28
29static unsigned int vbi_debug;
30module_param(vbi_debug, int, 0644);
31MODULE_PARM_DESC(vbi_debug, "enable debug messages [vbi]");
32
33#define dprintk(level, fmt, arg...)\
34	do { if (vbi_debug >= level)\
35		printk(KERN_DEBUG "%s/0: " fmt, dev->name, ## arg);\
36	} while (0)
37
38/* ------------------------------------------------------------------ */
39
40#define VBI_LINE_LENGTH 1440
41#define VBI_NTSC_LINE_COUNT 12
42#define VBI_PAL_LINE_COUNT 18
43
44
45int cx23885_vbi_fmt(struct file *file, void *priv,
46	struct v4l2_format *f)
47{
48	struct cx23885_dev *dev = video_drvdata(file);
49
50	f->fmt.vbi.sampling_rate = 27000000;
51	f->fmt.vbi.samples_per_line = VBI_LINE_LENGTH;
52	f->fmt.vbi.sample_format = V4L2_PIX_FMT_GREY;
53	f->fmt.vbi.offset = 0;
54	f->fmt.vbi.flags = 0;
55	if (dev->tvnorm & V4L2_STD_525_60) {
56		/* ntsc */
57		f->fmt.vbi.start[0] = V4L2_VBI_ITU_525_F1_START + 9;
58		f->fmt.vbi.start[1] = V4L2_VBI_ITU_525_F2_START + 9;
59		f->fmt.vbi.count[0] = VBI_NTSC_LINE_COUNT;
60		f->fmt.vbi.count[1] = VBI_NTSC_LINE_COUNT;
61	} else if (dev->tvnorm & V4L2_STD_625_50) {
62		/* pal */
63		f->fmt.vbi.start[0] = V4L2_VBI_ITU_625_F1_START + 5;
64		f->fmt.vbi.start[1] = V4L2_VBI_ITU_625_F2_START + 5;
65		f->fmt.vbi.count[0] = VBI_PAL_LINE_COUNT;
66		f->fmt.vbi.count[1] = VBI_PAL_LINE_COUNT;
67	}
68
69	return 0;
70}
71
72/* We're given the Video Interrupt status register.
73 * The cx23885_video_irq() func has already validated
74 * the potential error bits, we just need to
75 * deal with vbi payload and return indication if
76 * we actually processed any payload.
77 */
78int cx23885_vbi_irq(struct cx23885_dev *dev, u32 status)
79{
80	u32 count;
81	int handled = 0;
82
83	if (status & VID_BC_MSK_VBI_RISCI1) {
84		dprintk(1, "%s() VID_BC_MSK_VBI_RISCI1\n", __func__);
85		spin_lock(&dev->slock);
86		count = cx_read(VID_A_GPCNT);
87		cx23885_video_wakeup(dev, &dev->vbiq, count);
88		spin_unlock(&dev->slock);
89		handled++;
90	}
91
92	return handled;
93}
94
95static int cx23885_start_vbi_dma(struct cx23885_dev    *dev,
96			 struct cx23885_dmaqueue *q,
97			 struct cx23885_buffer   *buf)
98{
99	dprintk(1, "%s()\n", __func__);
100
101	/* setup fifo + format */
102	cx23885_sram_channel_setup(dev, &dev->sram_channels[SRAM_CH02],
103				VBI_LINE_LENGTH, buf->risc.dma);
104
105	/* reset counter */
106	cx_write(VID_A_GPCNT_CTL, 3);
107	cx_write(VID_A_VBI_CTRL, 3);
108	cx_write(VBI_A_GPCNT_CTL, 3);
109	q->count = 0;
110
111	/* enable irq */
112	cx23885_irq_add_enable(dev, 0x01);
113	cx_set(VID_A_INT_MSK, 0x000022);
114
115	/* start dma */
116	cx_set(DEV_CNTRL2, (1<<5));
117	cx_set(VID_A_DMA_CTL, 0x22); /* FIFO and RISC enable */
118
119	return 0;
120}
121
122/* ------------------------------------------------------------------ */
123
124static int queue_setup(struct vb2_queue *q, const struct v4l2_format *fmt,
125			   unsigned int *num_buffers, unsigned int *num_planes,
126			   unsigned int sizes[], void *alloc_ctxs[])
127{
128	struct cx23885_dev *dev = q->drv_priv;
129	unsigned lines = VBI_PAL_LINE_COUNT;
130
131	if (dev->tvnorm & V4L2_STD_525_60)
132		lines = VBI_NTSC_LINE_COUNT;
133	*num_planes = 1;
134	sizes[0] = lines * VBI_LINE_LENGTH * 2;
135	alloc_ctxs[0] = dev->alloc_ctx;
136	return 0;
137}
138
139static int buffer_prepare(struct vb2_buffer *vb)
140{
141	struct cx23885_dev *dev = vb->vb2_queue->drv_priv;
142	struct cx23885_buffer *buf = container_of(vb,
143		struct cx23885_buffer, vb);
144	struct sg_table *sgt = vb2_dma_sg_plane_desc(vb, 0);
145	unsigned lines = VBI_PAL_LINE_COUNT;
146
147	if (dev->tvnorm & V4L2_STD_525_60)
148		lines = VBI_NTSC_LINE_COUNT;
149
150	if (vb2_plane_size(vb, 0) < lines * VBI_LINE_LENGTH * 2)
151		return -EINVAL;
152	vb2_set_plane_payload(vb, 0, lines * VBI_LINE_LENGTH * 2);
153
154	cx23885_risc_vbibuffer(dev->pci, &buf->risc,
155			 sgt->sgl,
156			 0, VBI_LINE_LENGTH * lines,
157			 VBI_LINE_LENGTH, 0,
158			 lines);
159	return 0;
160}
161
162static void buffer_finish(struct vb2_buffer *vb)
163{
164	struct cx23885_buffer *buf = container_of(vb,
165		struct cx23885_buffer, vb);
166
167	cx23885_free_buffer(vb->vb2_queue->drv_priv, buf);
168}
169
170/*
171 * The risc program for each buffer works as follows: it starts with a simple
172 * 'JUMP to addr + 12', which is effectively a NOP. Then the code to DMA the
173 * buffer follows and at the end we have a JUMP back to the start + 12 (skipping
174 * the initial JUMP).
175 *
176 * This is the risc program of the first buffer to be queued if the active list
177 * is empty and it just keeps DMAing this buffer without generating any
178 * interrupts.
179 *
180 * If a new buffer is added then the initial JUMP in the code for that buffer
181 * will generate an interrupt which signals that the previous buffer has been
182 * DMAed successfully and that it can be returned to userspace.
183 *
184 * It also sets the final jump of the previous buffer to the start of the new
185 * buffer, thus chaining the new buffer into the DMA chain. This is a single
186 * atomic u32 write, so there is no race condition.
187 *
188 * The end-result of all this that you only get an interrupt when a buffer
189 * is ready, so the control flow is very easy.
190 */
191static void buffer_queue(struct vb2_buffer *vb)
192{
193	struct cx23885_dev *dev = vb->vb2_queue->drv_priv;
194	struct cx23885_buffer *buf = container_of(vb, struct cx23885_buffer, vb);
195	struct cx23885_buffer *prev;
196	struct cx23885_dmaqueue *q = &dev->vbiq;
197	unsigned long flags;
198
199	buf->risc.cpu[1] = cpu_to_le32(buf->risc.dma + 12);
200	buf->risc.jmp[0] = cpu_to_le32(RISC_JUMP | RISC_CNT_INC);
201	buf->risc.jmp[1] = cpu_to_le32(buf->risc.dma + 12);
202	buf->risc.jmp[2] = cpu_to_le32(0); /* bits 63-32 */
203
204	if (list_empty(&q->active)) {
205		spin_lock_irqsave(&dev->slock, flags);
206		list_add_tail(&buf->queue, &q->active);
207		spin_unlock_irqrestore(&dev->slock, flags);
208		dprintk(2, "[%p/%d] vbi_queue - first active\n",
209			buf, buf->vb.v4l2_buf.index);
210
211	} else {
212		buf->risc.cpu[0] |= cpu_to_le32(RISC_IRQ1);
213		prev = list_entry(q->active.prev, struct cx23885_buffer,
214			queue);
215		spin_lock_irqsave(&dev->slock, flags);
216		list_add_tail(&buf->queue, &q->active);
217		spin_unlock_irqrestore(&dev->slock, flags);
218		prev->risc.jmp[1] = cpu_to_le32(buf->risc.dma);
219		dprintk(2, "[%p/%d] buffer_queue - append to active\n",
220			buf, buf->vb.v4l2_buf.index);
221	}
222}
223
224static int cx23885_start_streaming(struct vb2_queue *q, unsigned int count)
225{
226	struct cx23885_dev *dev = q->drv_priv;
227	struct cx23885_dmaqueue *dmaq = &dev->vbiq;
228	struct cx23885_buffer *buf = list_entry(dmaq->active.next,
229			struct cx23885_buffer, queue);
230
231	cx23885_start_vbi_dma(dev, dmaq, buf);
232	return 0;
233}
234
235static void cx23885_stop_streaming(struct vb2_queue *q)
236{
237	struct cx23885_dev *dev = q->drv_priv;
238	struct cx23885_dmaqueue *dmaq = &dev->vbiq;
239	unsigned long flags;
240
241	cx_clear(VID_A_DMA_CTL, 0x22); /* FIFO and RISC enable */
242	spin_lock_irqsave(&dev->slock, flags);
243	while (!list_empty(&dmaq->active)) {
244		struct cx23885_buffer *buf = list_entry(dmaq->active.next,
245			struct cx23885_buffer, queue);
246
247		list_del(&buf->queue);
248		vb2_buffer_done(&buf->vb, VB2_BUF_STATE_ERROR);
249	}
250	spin_unlock_irqrestore(&dev->slock, flags);
251}
252
253
254struct vb2_ops cx23885_vbi_qops = {
255	.queue_setup    = queue_setup,
256	.buf_prepare  = buffer_prepare,
257	.buf_finish = buffer_finish,
258	.buf_queue    = buffer_queue,
259	.wait_prepare = vb2_ops_wait_prepare,
260	.wait_finish = vb2_ops_wait_finish,
261	.start_streaming = cx23885_start_streaming,
262	.stop_streaming = cx23885_stop_streaming,
263};
264