2 * cx18 mailbox functions
4 * Copyright (C) 2007 Hans Verkuil <hverkuil@xs4all.nl>
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.
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 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
24 #include "cx18-driver.h"
28 #include "cx18-mailbox.h"
30 #define API_FAST (1 << 2) /* Short timeout */
31 #define API_SLOW (1 << 3) /* Additional 300ms timeout */
33 struct cx18_api_info {
35 u8 flags; /* Flags, see above */
36 u8 rpu; /* Processing unit */
37 const char *name; /* The name of the command */
40 #define API_ENTRY(rpu, x, f) { (x), (f), (rpu), #x }
42 static const struct cx18_api_info api_info[] = {
43 /* MPEG encoder API */
44 API_ENTRY(CPU, CX18_CPU_SET_CHANNEL_TYPE, 0),
45 API_ENTRY(CPU, CX18_EPU_DEBUG, 0),
46 API_ENTRY(CPU, CX18_CREATE_TASK, 0),
47 API_ENTRY(CPU, CX18_DESTROY_TASK, 0),
48 API_ENTRY(CPU, CX18_CPU_CAPTURE_START, API_SLOW),
49 API_ENTRY(CPU, CX18_CPU_CAPTURE_STOP, API_SLOW),
50 API_ENTRY(CPU, CX18_CPU_CAPTURE_PAUSE, 0),
51 API_ENTRY(CPU, CX18_CPU_CAPTURE_RESUME, 0),
52 API_ENTRY(CPU, CX18_CPU_SET_CHANNEL_TYPE, 0),
53 API_ENTRY(CPU, CX18_CPU_SET_STREAM_OUTPUT_TYPE, 0),
54 API_ENTRY(CPU, CX18_CPU_SET_VIDEO_IN, 0),
55 API_ENTRY(CPU, CX18_CPU_SET_VIDEO_RATE, 0),
56 API_ENTRY(CPU, CX18_CPU_SET_VIDEO_RESOLUTION, 0),
57 API_ENTRY(CPU, CX18_CPU_SET_FILTER_PARAM, 0),
58 API_ENTRY(CPU, CX18_CPU_SET_SPATIAL_FILTER_TYPE, 0),
59 API_ENTRY(CPU, CX18_CPU_SET_MEDIAN_CORING, 0),
60 API_ENTRY(CPU, CX18_CPU_SET_INDEXTABLE, 0),
61 API_ENTRY(CPU, CX18_CPU_SET_AUDIO_PARAMETERS, 0),
62 API_ENTRY(CPU, CX18_CPU_SET_VIDEO_MUTE, 0),
63 API_ENTRY(CPU, CX18_CPU_SET_AUDIO_MUTE, 0),
64 API_ENTRY(CPU, CX18_CPU_SET_MISC_PARAMETERS, 0),
65 API_ENTRY(CPU, CX18_CPU_SET_RAW_VBI_PARAM, API_SLOW),
66 API_ENTRY(CPU, CX18_CPU_SET_CAPTURE_LINE_NO, 0),
67 API_ENTRY(CPU, CX18_CPU_SET_COPYRIGHT, 0),
68 API_ENTRY(CPU, CX18_CPU_SET_AUDIO_PID, 0),
69 API_ENTRY(CPU, CX18_CPU_SET_VIDEO_PID, 0),
70 API_ENTRY(CPU, CX18_CPU_SET_VER_CROP_LINE, 0),
71 API_ENTRY(CPU, CX18_CPU_SET_GOP_STRUCTURE, 0),
72 API_ENTRY(CPU, CX18_CPU_SET_SCENE_CHANGE_DETECTION, 0),
73 API_ENTRY(CPU, CX18_CPU_SET_ASPECT_RATIO, 0),
74 API_ENTRY(CPU, CX18_CPU_SET_SKIP_INPUT_FRAME, 0),
75 API_ENTRY(CPU, CX18_CPU_SET_SLICED_VBI_PARAM, 0),
76 API_ENTRY(CPU, CX18_CPU_SET_USERDATA_PLACE_HOLDER, 0),
77 API_ENTRY(CPU, CX18_CPU_GET_ENC_PTS, 0),
78 API_ENTRY(CPU, CX18_CPU_DE_SET_MDL_ACK, 0),
79 API_ENTRY(CPU, CX18_CPU_DE_SET_MDL, API_FAST),
80 API_ENTRY(CPU, CX18_APU_RESETAI, API_FAST),
81 API_ENTRY(CPU, CX18_CPU_DE_RELEASE_MDL, API_SLOW),
85 static const struct cx18_api_info *find_api_info(u32 cmd)
89 for (i = 0; api_info[i].cmd; i++)
90 if (api_info[i].cmd == cmd)
95 long cx18_mb_ack(struct cx18 *cx, const struct cx18_mailbox *mb, int rpu)
97 struct cx18_mailbox __iomem *ack_mb;
102 ack_irq = IRQ_EPU_TO_APU_ACK;
103 ack_mb = &cx->scb->apu2epu_mb;
106 ack_irq = IRQ_EPU_TO_CPU_ACK;
107 ack_mb = &cx->scb->cpu2epu_mb;
110 CX18_WARN("Unhandled RPU (%d) for command %x ack\n",
115 cx18_setup_page(cx, SCB_OFFSET);
116 cx18_write_sync(cx, mb->request, &ack_mb->ack);
117 cx18_write_reg_expect(cx, ack_irq, SW2_INT_SET, ack_irq, ack_irq);
121 static void cx18_api_log_ack_delay(struct cx18 *cx, int msecs)
123 if (msecs > CX18_MAX_MB_ACK_DELAY)
124 msecs = CX18_MAX_MB_ACK_DELAY;
125 atomic_inc(&cx->mbox_stats.mb_ack_delay[msecs]);
128 static int cx18_api_call(struct cx18 *cx, u32 cmd, int args, u32 data[])
130 const struct cx18_api_info *info = find_api_info(cmd);
131 u32 state, irq, req, ack, err;
132 struct cx18_mailbox __iomem *mb;
133 u32 __iomem *xpu_state;
134 wait_queue_head_t *waitq;
135 struct mutex *mb_lock;
136 long int timeout, ret;
140 CX18_WARN("unknown cmd %x\n", cmd);
144 if (cmd == CX18_CPU_DE_SET_MDL)
145 CX18_DEBUG_HI_API("%s\n", info->name);
147 CX18_DEBUG_API("%s\n", info->name);
151 waitq = &cx->mb_apu_waitq;
152 mb_lock = &cx->epu2apu_mb_lock;
153 irq = IRQ_EPU_TO_APU;
154 mb = &cx->scb->epu2apu_mb;
155 xpu_state = &cx->scb->apu_state;
158 waitq = &cx->mb_cpu_waitq;
159 mb_lock = &cx->epu2cpu_mb_lock;
160 irq = IRQ_EPU_TO_CPU;
161 mb = &cx->scb->epu2cpu_mb;
162 xpu_state = &cx->scb->cpu_state;
165 CX18_WARN("Unknown RPU (%d) for API call\n", info->rpu);
170 cx18_setup_page(cx, SCB_OFFSET);
173 * Wait for an in-use mailbox to complete
175 * If the XPU is responding with Ack's, the mailbox shouldn't be in
176 * a busy state, since we serialize access to it on our end.
178 * If the wait for ack after sending a previous command was interrupted
179 * by a signal, we may get here and find a busy mailbox. After waiting,
180 * mark it "not busy" from our end, if the XPU hasn't ack'ed it still.
182 state = cx18_readl(cx, xpu_state);
183 req = cx18_readl(cx, &mb->request);
184 timeout = msecs_to_jiffies(20); /* 1 field at 50 Hz vertical refresh */
185 ret = wait_event_timeout(*waitq,
186 (ack = cx18_readl(cx, &mb->ack)) == req,
189 /* waited long enough, make the mbox "not busy" from our end */
190 cx18_writel(cx, req, &mb->ack);
191 CX18_ERR("mbox was found stuck busy when setting up for %s; "
192 "clearing busy and trying to proceed\n", info->name);
193 } else if (ret != timeout)
194 CX18_DEBUG_API("waited %u usecs for busy mbox to be acked\n",
195 jiffies_to_usecs(timeout-ret));
197 /* Build the outgoing mailbox */
198 req = ((req & 0xfffffffe) == 0xfffffffe) ? 1 : req + 1;
200 cx18_writel(cx, cmd, &mb->cmd);
201 for (i = 0; i < args; i++)
202 cx18_writel(cx, data[i], &mb->args[i]);
203 cx18_writel(cx, 0, &mb->error);
204 cx18_writel(cx, req, &mb->request);
205 cx18_writel(cx, req - 1, &mb->ack); /* ensure ack & req are distinct */
208 * Notify the XPU and wait for it to send an Ack back
209 * 21 ms = ~ 0.5 frames at a frame rate of 24 fps
210 * 42 ms = ~ 1 frame at a frame rate of 24 fps
212 timeout = msecs_to_jiffies((info->flags & API_FAST) ? 21 : 42);
214 CX18_DEBUG_HI_IRQ("sending interrupt SW1: %x to send %s\n",
216 cx18_write_reg_expect(cx, irq, SW1_INT_SET, irq, irq);
218 ret = wait_event_timeout(
220 cx18_readl(cx, &mb->ack) == cx18_readl(cx, &mb->request),
224 mutex_unlock(mb_lock);
225 i = jiffies_to_msecs(timeout);
226 cx18_api_log_ack_delay(cx, i);
227 CX18_WARN("sending %s timed out waiting %d msecs for RPU "
228 "acknowledgement\n", info->name, i);
230 } else if (ret < 0) {
232 mutex_unlock(mb_lock);
233 CX18_WARN("sending %s was interrupted waiting for RPU"
234 "acknowledgement\n", info->name);
238 i = jiffies_to_msecs(timeout-ret);
239 cx18_api_log_ack_delay(cx, i);
241 CX18_DEBUG_HI_API("waited %u msecs for %s to be acked\n",
244 /* Collect data returned by the XPU */
245 for (i = 0; i < MAX_MB_ARGUMENTS; i++)
246 data[i] = cx18_readl(cx, &mb->args[i]);
247 err = cx18_readl(cx, &mb->error);
248 mutex_unlock(mb_lock);
251 * Wait for XPU to perform extra actions for the caller in some cases.
252 * e.g. CX18_CPU_DE_RELEASE_MDL will cause the CPU to send all buffers
253 * back in a burst shortly thereafter
255 if (info->flags & API_SLOW)
256 cx18_msleep_timeout(300, 0);
259 CX18_DEBUG_API("mailbox error %08x for command %s\n", err,
261 return err ? -EIO : 0;
264 int cx18_api(struct cx18 *cx, u32 cmd, int args, u32 data[])
266 return cx18_api_call(cx, cmd, args, data);
269 static int cx18_set_filter_param(struct cx18_stream *s)
271 struct cx18 *cx = s->cx;
275 mode = (cx->filter_mode & 1) ? 2 : (cx->spatial_strength ? 1 : 0);
276 ret = cx18_vapi(cx, CX18_CPU_SET_FILTER_PARAM, 4,
277 s->handle, 1, mode, cx->spatial_strength);
278 mode = (cx->filter_mode & 2) ? 2 : (cx->temporal_strength ? 1 : 0);
279 ret = ret ? ret : cx18_vapi(cx, CX18_CPU_SET_FILTER_PARAM, 4,
280 s->handle, 0, mode, cx->temporal_strength);
281 ret = ret ? ret : cx18_vapi(cx, CX18_CPU_SET_FILTER_PARAM, 4,
282 s->handle, 2, cx->filter_mode >> 2, 0);
286 int cx18_api_func(void *priv, u32 cmd, int in, int out,
287 u32 data[CX2341X_MBOX_MAX_DATA])
289 struct cx18 *cx = priv;
290 struct cx18_stream *s = &cx->streams[CX18_ENC_STREAM_TYPE_MPG];
293 case CX2341X_ENC_SET_OUTPUT_PORT:
295 case CX2341X_ENC_SET_FRAME_RATE:
296 return cx18_vapi(cx, CX18_CPU_SET_VIDEO_IN, 6,
297 s->handle, 0, 0, 0, 0, data[0]);
298 case CX2341X_ENC_SET_FRAME_SIZE:
299 return cx18_vapi(cx, CX18_CPU_SET_VIDEO_RESOLUTION, 3,
300 s->handle, data[1], data[0]);
301 case CX2341X_ENC_SET_STREAM_TYPE:
302 return cx18_vapi(cx, CX18_CPU_SET_STREAM_OUTPUT_TYPE, 2,
304 case CX2341X_ENC_SET_ASPECT_RATIO:
305 return cx18_vapi(cx, CX18_CPU_SET_ASPECT_RATIO, 2,
308 case CX2341X_ENC_SET_GOP_PROPERTIES:
309 return cx18_vapi(cx, CX18_CPU_SET_GOP_STRUCTURE, 3,
310 s->handle, data[0], data[1]);
311 case CX2341X_ENC_SET_GOP_CLOSURE:
313 case CX2341X_ENC_SET_AUDIO_PROPERTIES:
314 return cx18_vapi(cx, CX18_CPU_SET_AUDIO_PARAMETERS, 2,
316 case CX2341X_ENC_MUTE_AUDIO:
317 return cx18_vapi(cx, CX18_CPU_SET_AUDIO_MUTE, 2,
319 case CX2341X_ENC_SET_BIT_RATE:
320 return cx18_vapi(cx, CX18_CPU_SET_VIDEO_RATE, 5,
321 s->handle, data[0], data[1], data[2], data[3]);
322 case CX2341X_ENC_MUTE_VIDEO:
323 return cx18_vapi(cx, CX18_CPU_SET_VIDEO_MUTE, 2,
325 case CX2341X_ENC_SET_FRAME_DROP_RATE:
326 return cx18_vapi(cx, CX18_CPU_SET_SKIP_INPUT_FRAME, 2,
328 case CX2341X_ENC_MISC:
329 return cx18_vapi(cx, CX18_CPU_SET_MISC_PARAMETERS, 4,
330 s->handle, data[0], data[1], data[2]);
331 case CX2341X_ENC_SET_DNR_FILTER_MODE:
332 cx->filter_mode = (data[0] & 3) | (data[1] << 2);
333 return cx18_set_filter_param(s);
334 case CX2341X_ENC_SET_DNR_FILTER_PROPS:
335 cx->spatial_strength = data[0];
336 cx->temporal_strength = data[1];
337 return cx18_set_filter_param(s);
338 case CX2341X_ENC_SET_SPATIAL_FILTER_TYPE:
339 return cx18_vapi(cx, CX18_CPU_SET_SPATIAL_FILTER_TYPE, 3,
340 s->handle, data[0], data[1]);
341 case CX2341X_ENC_SET_CORING_LEVELS:
342 return cx18_vapi(cx, CX18_CPU_SET_MEDIAN_CORING, 5,
343 s->handle, data[0], data[1], data[2], data[3]);
345 CX18_WARN("Unknown cmd %x\n", cmd);
349 int cx18_vapi_result(struct cx18 *cx, u32 data[MAX_MB_ARGUMENTS],
350 u32 cmd, int args, ...)
356 for (i = 0; i < args; i++)
357 data[i] = va_arg(ap, u32);
359 return cx18_api(cx, cmd, args, data);
362 int cx18_vapi(struct cx18 *cx, u32 cmd, int args, ...)
364 u32 data[MAX_MB_ARGUMENTS];
369 CX18_ERR("cx == NULL (cmd=%x)\n", cmd);
372 if (args > MAX_MB_ARGUMENTS) {
373 CX18_ERR("args too big (cmd=%x)\n", cmd);
374 args = MAX_MB_ARGUMENTS;
377 for (i = 0; i < args; i++)
378 data[i] = va_arg(ap, u32);
380 return cx18_api(cx, cmd, args, data);