5 * Copyright (C) 2005 Mike Isely <isely@pobox.com>
6 * Copyright (C) 2004 Aurelien Alleaume <slts@free.fr>
8 * This program is free software; you can redistribute it and/or modify
9 * it under the terms of the GNU General Public License as published by
10 * the Free Software Foundation; either version 2 of the License
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
23 #include <linux/device.h> // for linux/firmware.h
24 #include <linux/firmware.h>
25 #include "pvrusb2-util.h"
26 #include "pvrusb2-encoder.h"
27 #include "pvrusb2-hdw-internal.h"
28 #include "pvrusb2-debug.h"
29 #include "pvrusb2-fx2-cmd.h"
33 /* Firmware mailbox flags - definitions found from ivtv */
34 #define IVTV_MBOX_FIRMWARE_DONE 0x00000004
35 #define IVTV_MBOX_DRIVER_DONE 0x00000002
36 #define IVTV_MBOX_DRIVER_BUSY 0x00000001
38 #define MBOX_BASE 0x44
41 static int pvr2_encoder_write_words(struct pvr2_hdw *hdw,
43 const u32 *data, unsigned int dlen)
45 unsigned int idx,addr;
48 unsigned int chunkCnt;
52 Format: First byte must be 0x01. Remaining 32 bit words are
53 spread out into chunks of 7 bytes each, with the first 4 bytes
54 being the data word (little endian), and the next 3 bytes
55 being the address where that data word is to be written (big
56 endian). Repeat request for additional words, with offset
62 if (chunkCnt > dlen) chunkCnt = dlen;
63 memset(hdw->cmd_buffer,0,sizeof(hdw->cmd_buffer));
65 hdw->cmd_buffer[bAddr++] = FX2CMD_MEM_WRITE_DWORD;
66 for (idx = 0; idx < chunkCnt; idx++) {
68 hdw->cmd_buffer[bAddr+6] = (addr & 0xffu);
69 hdw->cmd_buffer[bAddr+5] = ((addr>>8) & 0xffu);
70 hdw->cmd_buffer[bAddr+4] = ((addr>>16) & 0xffu);
71 PVR2_DECOMPOSE_LE(hdw->cmd_buffer, bAddr,data[idx]);
74 ret = pvr2_send_request(hdw,
75 hdw->cmd_buffer,1+(chunkCnt*7),
87 static int pvr2_encoder_read_words(struct pvr2_hdw *hdw,
89 u32 *data, unsigned int dlen)
93 unsigned int chunkCnt;
97 Format: First byte must be 0x02 (status check) or 0x28 (read
98 back block of 32 bit words). Next 6 bytes must be zero,
99 followed by a single byte of MBOX_BASE+offset for portion to
100 be read. Returned data is packed set of 32 bits words that
107 if (chunkCnt > dlen) chunkCnt = dlen;
108 if (chunkCnt < 16) chunkCnt = 1;
111 FX2CMD_MEM_READ_DWORD : FX2CMD_MEM_READ_64BYTES);
112 hdw->cmd_buffer[1] = 0;
113 hdw->cmd_buffer[2] = 0;
114 hdw->cmd_buffer[3] = 0;
115 hdw->cmd_buffer[4] = 0;
116 hdw->cmd_buffer[5] = ((offs>>16) & 0xffu);
117 hdw->cmd_buffer[6] = ((offs>>8) & 0xffu);
118 hdw->cmd_buffer[7] = (offs & 0xffu);
119 ret = pvr2_send_request(hdw,
122 (chunkCnt == 1 ? 4 : 16 * 4));
125 for (idx = 0; idx < chunkCnt; idx++) {
126 data[idx] = PVR2_COMPOSE_LE(hdw->cmd_buffer,idx*4);
137 /* This prototype is set up to be compatible with the
138 cx2341x_mbox_func prototype in cx2341x.h, which should be in
139 kernels 2.6.18 or later. We do this so that we can enable
140 cx2341x.ko to write to our encoder (by handing it a pointer to this
141 function). For earlier kernels this doesn't really matter. */
142 static int pvr2_encoder_cmd(void *ctxt,
148 unsigned int poll_count;
149 unsigned int try_count = 0;
153 /* These sizes look to be limited by the FX2 firmware implementation */
156 struct pvr2_hdw *hdw = (struct pvr2_hdw *)ctxt;
161 The encoder seems to speak entirely using blocks 32 bit words.
162 In ivtv driver terms, this is a mailbox at MBOX_BASE which we
163 populate with data and watch what the hardware does with it.
164 The first word is a set of flags used to control the
165 transaction, the second word is the command to execute, the
166 third byte is zero (ivtv driver suggests that this is some
167 kind of return value), and the fourth byte is a specified
168 timeout (windows driver always uses 0x00060000 except for one
169 case when it is zero). All successive words are the argument
170 words for the command.
172 First, write out the entire set of words, with the first word
175 Next, write out just the first word again, but set it to
176 IVTV_MBOX_DRIVER_DONE | IVTV_DRIVER_BUSY this time (which
177 probably means "go").
179 Next, read back the return count words. Check the first word,
180 which should have IVTV_MBOX_FIRMWARE_DONE set. If however
181 that bit is not set, then the command isn't done so repeat the
182 read until it is set.
184 Finally, write out just the first word again, but set it to
185 0x0 this time (which probably means "idle").
189 if (arg_cnt_send > (ARRAY_SIZE(wrData) - 4)) {
191 PVR2_TRACE_ERROR_LEGS,
192 "Failed to write cx23416 command"
193 " - too many input arguments"
194 " (was given %u limit %lu)",
195 arg_cnt_send, (long unsigned) ARRAY_SIZE(wrData) - 4);
199 if (arg_cnt_recv > (ARRAY_SIZE(rdData) - 4)) {
201 PVR2_TRACE_ERROR_LEGS,
202 "Failed to write cx23416 command"
203 " - too many return arguments"
204 " (was given %u limit %lu)",
205 arg_cnt_recv, (long unsigned) ARRAY_SIZE(rdData) - 4);
210 LOCK_TAKE(hdw->ctl_lock); do {
212 if (!hdw->flag_encoder_ok) {
223 wrData[3] = 0x00060000;
224 for (idx = 0; idx < arg_cnt_send; idx++) {
225 wrData[idx+4] = argp[idx];
227 for (; idx < ARRAY_SIZE(wrData) - 4; idx++) {
231 ret = pvr2_encoder_write_words(hdw,MBOX_BASE,wrData,idx);
233 wrData[0] = IVTV_MBOX_DRIVER_DONE|IVTV_MBOX_DRIVER_BUSY;
234 ret = pvr2_encoder_write_words(hdw,MBOX_BASE,wrData,1);
239 ret = pvr2_encoder_read_words(hdw,MBOX_BASE,rdData,
244 if (rdData[0] & IVTV_MBOX_FIRMWARE_DONE) {
247 if (rdData[0] && (poll_count < 1000)) continue;
251 PVR2_TRACE_ERROR_LEGS,
252 "Encoder timed out waiting for us"
253 "; arranging to retry");
256 PVR2_TRACE_ERROR_LEGS,
257 "***WARNING*** device's encoder"
258 " appears to be stuck"
259 " (status=0x%08x)",rdData[0]);
262 PVR2_TRACE_ERROR_LEGS,
263 "Encoder command: 0x%02x",cmd);
264 for (idx = 4; idx < arg_cnt_send; idx++) {
266 PVR2_TRACE_ERROR_LEGS,
267 "Encoder arg%d: 0x%08x",
274 if (try_count < 20) continue;
276 PVR2_TRACE_ERROR_LEGS,
277 "Too many retries...");
281 hdw->flag_encoder_ok = 0;
283 PVR2_TRACE_ERROR_LEGS,
284 "Giving up on command."
286 " this is a bad idea...");
290 for (idx = 0; idx < arg_cnt_recv; idx++) {
291 argp[idx] = rdData[idx+4];
295 ret = pvr2_encoder_write_words(hdw,MBOX_BASE,wrData,1);
298 } while(0); LOCK_GIVE(hdw->ctl_lock);
304 static int pvr2_encoder_vcmd(struct pvr2_hdw *hdw, int cmd,
311 if (args > ARRAY_SIZE(data)) {
313 PVR2_TRACE_ERROR_LEGS,
314 "Failed to write cx23416 command"
315 " - too many arguments"
316 " (was given %u limit %lu)",
317 args, (long unsigned) ARRAY_SIZE(data));
322 for (idx = 0; idx < args; idx++) {
323 data[idx] = va_arg(vl, u32);
327 return pvr2_encoder_cmd(hdw,cmd,args,0,data);
331 /* This implements some extra setup for the encoder that seems to be
332 specific to the PVR USB2 hardware. */
333 static int pvr2_encoder_prep_config(struct pvr2_hdw *hdw)
339 /* This inexplicable bit happens in the Hauppage windows
340 driver (for both 24xxx and 29xxx devices). However I
341 currently see no difference in behavior with or without
342 this stuff. Leave this here as a note of its existence,
344 LOCK_TAKE(hdw->ctl_lock); do {
347 pvr2_encoder_write_words(hdw,0x01fe,dat,1);
348 pvr2_encoder_write_words(hdw,0x023e,dat,1);
349 } while(0); LOCK_GIVE(hdw->ctl_lock);
352 /* Mike Isely <isely@pobox.com> 26-Jan-2006 The windows driver
353 sends the following list of ENC_MISC commands (for both
354 24xxx and 29xxx devices). Meanings are not entirely clear,
355 however without the ENC_MISC(3,1) command then we risk
356 random perpetual video corruption whenever the video input
357 breaks up for a moment (like when switching channels). */
361 /* This ENC_MISC(5,0) command seems to hurt 29xxx sync
362 performance on channel changes, but is not a problem on
364 ret |= pvr2_encoder_vcmd(hdw, CX2341X_ENC_MISC,4, 5,0,0,0);
367 /* This ENC_MISC(3,encMisc3Arg) command is critical - without
368 it there will eventually be video corruption. Also, the
369 29xxx case is strange - the Windows driver is passing 1
370 regardless of device type but if we have 1 for 29xxx device
371 the video turns sluggish. */
372 switch (hdw->hdw_type) {
373 case PVR2_HDW_TYPE_24XXX: encMisc3Arg = 1; break;
374 case PVR2_HDW_TYPE_29XXX: encMisc3Arg = 0; break;
377 ret |= pvr2_encoder_vcmd(hdw, CX2341X_ENC_MISC,4, 3,
380 ret |= pvr2_encoder_vcmd(hdw, CX2341X_ENC_MISC,4, 8,0,0,0);
383 /* This ENC_MISC(4,1) command is poisonous, so it is commented
384 out. But I'm leaving it here anyway to document its
385 existence in the Windows driver. The effect of this
386 command is that apps displaying the stream become sluggish
387 with stuttering video. */
388 ret |= pvr2_encoder_vcmd(hdw, CX2341X_ENC_MISC,4, 4,1,0,0);
391 ret |= pvr2_encoder_vcmd(hdw, CX2341X_ENC_MISC,4, 0,3,0,0);
392 ret |= pvr2_encoder_vcmd(hdw, CX2341X_ENC_MISC,4,15,0,0,0);
397 int pvr2_encoder_configure(struct pvr2_hdw *hdw)
401 pvr2_trace(PVR2_TRACE_ENCODER,"pvr2_encoder_configure"
402 " (cx2341x module)");
403 hdw->enc_ctl_state.port = CX2341X_PORT_STREAMING;
404 hdw->enc_ctl_state.width = hdw->res_hor_val;
405 hdw->enc_ctl_state.height = hdw->res_ver_val;
406 hdw->enc_ctl_state.is_50hz = ((hdw->std_mask_cur & V4L2_STD_525_60) ?
411 ret |= pvr2_encoder_prep_config(hdw);
415 if (hdw->hdw_type == PVR2_HDW_TYPE_24XXX) {
416 /* ivtv cx25840: 0x140 */
420 if (!ret) ret = pvr2_encoder_vcmd(
421 hdw,CX2341X_ENC_SET_NUM_VSYNC_LINES, 2,
424 /* setup firmware to notify us about some events (don't know why...) */
425 if (!ret) ret = pvr2_encoder_vcmd(
426 hdw,CX2341X_ENC_SET_EVENT_NOTIFICATION, 4,
427 0, 0, 0x10000000, 0xffffffff);
429 if (!ret) ret = pvr2_encoder_vcmd(
430 hdw,CX2341X_ENC_SET_VBI_LINE, 5,
434 pvr2_trace(PVR2_TRACE_ERROR_LEGS,
435 "Failed to configure cx23416");
439 ret = cx2341x_update(hdw,pvr2_encoder_cmd,
440 (hdw->enc_cur_valid ? &hdw->enc_cur_state : NULL),
441 &hdw->enc_ctl_state);
443 pvr2_trace(PVR2_TRACE_ERROR_LEGS,
444 "Error from cx2341x module code=%d",ret);
450 if (!ret) ret = pvr2_encoder_vcmd(
451 hdw, CX2341X_ENC_INITIALIZE_INPUT, 0);
454 pvr2_trace(PVR2_TRACE_ERROR_LEGS,
455 "Failed to initialize cx23416 video input");
459 hdw->subsys_enabled_mask |= (1<<PVR2_SUBSYS_B_ENC_CFG);
460 memcpy(&hdw->enc_cur_state,&hdw->enc_ctl_state,
461 sizeof(struct cx2341x_mpeg_params));
462 hdw->enc_cur_valid = !0;
467 int pvr2_encoder_start(struct pvr2_hdw *hdw)
471 /* unmask some interrupts */
472 pvr2_write_register(hdw, 0x0048, 0xbfffffff);
474 /* change some GPIO data */
475 pvr2_hdw_gpio_chg_dir(hdw,0xffffffff,0x00000481);
476 pvr2_hdw_gpio_chg_out(hdw,0xffffffff,0x00000000);
478 pvr2_encoder_vcmd(hdw,CX2341X_ENC_MUTE_VIDEO,1,
479 hdw->input_val == PVR2_CVAL_INPUT_RADIO ? 1 : 0);
481 switch (hdw->config) {
482 case pvr2_config_vbi:
483 status = pvr2_encoder_vcmd(hdw,CX2341X_ENC_START_CAPTURE,2,
486 case pvr2_config_mpeg:
487 status = pvr2_encoder_vcmd(hdw,CX2341X_ENC_START_CAPTURE,2,
490 default: /* Unhandled cases for now */
491 status = pvr2_encoder_vcmd(hdw,CX2341X_ENC_START_CAPTURE,2,
496 hdw->subsys_enabled_mask |= (1<<PVR2_SUBSYS_B_ENC_RUN);
501 int pvr2_encoder_stop(struct pvr2_hdw *hdw)
505 /* mask all interrupts */
506 pvr2_write_register(hdw, 0x0048, 0xffffffff);
508 switch (hdw->config) {
509 case pvr2_config_vbi:
510 status = pvr2_encoder_vcmd(hdw,CX2341X_ENC_STOP_CAPTURE,3,
513 case pvr2_config_mpeg:
514 status = pvr2_encoder_vcmd(hdw,CX2341X_ENC_STOP_CAPTURE,3,
517 default: /* Unhandled cases for now */
518 status = pvr2_encoder_vcmd(hdw,CX2341X_ENC_STOP_CAPTURE,3,
523 /* change some GPIO data */
524 /* Note: Bit d7 of dir appears to control the LED. So we shut it
526 pvr2_hdw_gpio_chg_dir(hdw,0xffffffff,0x00000401);
527 pvr2_hdw_gpio_chg_out(hdw,0xffffffff,0x00000000);
530 hdw->subsys_enabled_mask &= ~(1<<PVR2_SUBSYS_B_ENC_RUN);
537 Stuff for Emacs to see, in order to encourage consistent editing style:
538 *** Local Variables: ***
540 *** fill-column: 70 ***
542 *** c-basic-offset: 8 ***