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->state_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 del_timer_sync(&hdw->encoder_run_timer);
282 hdw->state_encoder_ok = 0;
283 pvr2_trace(PVR2_TRACE_STBITS,
284 "State bit %s <-- %s",
286 (hdw->state_encoder_ok ? "true" : "false"));
287 if (hdw->state_encoder_runok) {
288 hdw->state_encoder_runok = 0;
289 pvr2_trace(PVR2_TRACE_STBITS,
290 "State bit %s <-- %s",
291 "state_encoder_runok",
292 (hdw->state_encoder_runok ?
296 PVR2_TRACE_ERROR_LEGS,
297 "Giving up on command."
298 " This is normally recovered by the driver.");
302 for (idx = 0; idx < arg_cnt_recv; idx++) {
303 argp[idx] = rdData[idx+4];
307 ret = pvr2_encoder_write_words(hdw,MBOX_BASE,wrData,1);
310 } while(0); LOCK_GIVE(hdw->ctl_lock);
316 static int pvr2_encoder_vcmd(struct pvr2_hdw *hdw, int cmd,
323 if (args > ARRAY_SIZE(data)) {
325 PVR2_TRACE_ERROR_LEGS,
326 "Failed to write cx23416 command"
327 " - too many arguments"
328 " (was given %u limit %lu)",
329 args, (long unsigned) ARRAY_SIZE(data));
334 for (idx = 0; idx < args; idx++) {
335 data[idx] = va_arg(vl, u32);
339 return pvr2_encoder_cmd(hdw,cmd,args,0,data);
343 /* This implements some extra setup for the encoder that seems to be
344 specific to the PVR USB2 hardware. */
345 static int pvr2_encoder_prep_config(struct pvr2_hdw *hdw)
351 /* This inexplicable bit happens in the Hauppage windows
352 driver (for both 24xxx and 29xxx devices). However I
353 currently see no difference in behavior with or without
354 this stuff. Leave this here as a note of its existence,
356 LOCK_TAKE(hdw->ctl_lock); do {
359 pvr2_encoder_write_words(hdw,0x01fe,dat,1);
360 pvr2_encoder_write_words(hdw,0x023e,dat,1);
361 } while(0); LOCK_GIVE(hdw->ctl_lock);
364 /* Mike Isely <isely@pobox.com> 26-Jan-2006 The windows driver
365 sends the following list of ENC_MISC commands (for both
366 24xxx and 29xxx devices). Meanings are not entirely clear,
367 however without the ENC_MISC(3,1) command then we risk
368 random perpetual video corruption whenever the video input
369 breaks up for a moment (like when switching channels). */
373 /* This ENC_MISC(5,0) command seems to hurt 29xxx sync
374 performance on channel changes, but is not a problem on
376 ret |= pvr2_encoder_vcmd(hdw, CX2341X_ENC_MISC,4, 5,0,0,0);
379 /* This ENC_MISC(3,encMisc3Arg) command is critical - without
380 it there will eventually be video corruption. Also, the
381 saa7115 case is strange - the Windows driver is passing 1
382 regardless of device type but if we have 1 for saa7115
383 devices the video turns sluggish. */
384 if (hdw->hdw_desc->flag_has_cx25840) {
389 ret |= pvr2_encoder_vcmd(hdw, CX2341X_ENC_MISC,4, 3,
392 ret |= pvr2_encoder_vcmd(hdw, CX2341X_ENC_MISC,4, 8,0,0,0);
395 /* This ENC_MISC(4,1) command is poisonous, so it is commented
396 out. But I'm leaving it here anyway to document its
397 existence in the Windows driver. The effect of this
398 command is that apps displaying the stream become sluggish
399 with stuttering video. */
400 ret |= pvr2_encoder_vcmd(hdw, CX2341X_ENC_MISC,4, 4,1,0,0);
403 ret |= pvr2_encoder_vcmd(hdw, CX2341X_ENC_MISC,4, 0,3,0,0);
404 ret |= pvr2_encoder_vcmd(hdw, CX2341X_ENC_MISC,4,15,0,0,0);
409 int pvr2_encoder_adjust(struct pvr2_hdw *hdw)
412 ret = cx2341x_update(hdw,pvr2_encoder_cmd,
413 (hdw->enc_cur_valid ? &hdw->enc_cur_state : NULL),
414 &hdw->enc_ctl_state);
416 pvr2_trace(PVR2_TRACE_ERROR_LEGS,
417 "Error from cx2341x module code=%d",ret);
419 memcpy(&hdw->enc_cur_state,&hdw->enc_ctl_state,
420 sizeof(struct cx2341x_mpeg_params));
421 hdw->enc_cur_valid = !0;
427 int pvr2_encoder_configure(struct pvr2_hdw *hdw)
431 pvr2_trace(PVR2_TRACE_ENCODER,"pvr2_encoder_configure"
432 " (cx2341x module)");
433 hdw->enc_ctl_state.port = CX2341X_PORT_STREAMING;
434 hdw->enc_ctl_state.width = hdw->res_hor_val;
435 hdw->enc_ctl_state.height = hdw->res_ver_val;
436 hdw->enc_ctl_state.is_50hz = ((hdw->std_mask_cur & V4L2_STD_525_60) ?
441 ret |= pvr2_encoder_prep_config(hdw);
445 if (hdw->hdw_desc->flag_has_cx25840) {
446 /* ivtv cx25840: 0x140 */
450 if (!ret) ret = pvr2_encoder_vcmd(
451 hdw,CX2341X_ENC_SET_NUM_VSYNC_LINES, 2,
454 /* setup firmware to notify us about some events (don't know why...) */
455 if (!ret) ret = pvr2_encoder_vcmd(
456 hdw,CX2341X_ENC_SET_EVENT_NOTIFICATION, 4,
457 0, 0, 0x10000000, 0xffffffff);
459 if (!ret) ret = pvr2_encoder_vcmd(
460 hdw,CX2341X_ENC_SET_VBI_LINE, 5,
464 pvr2_trace(PVR2_TRACE_ERROR_LEGS,
465 "Failed to configure cx23416");
469 ret = pvr2_encoder_adjust(hdw);
472 ret = pvr2_encoder_vcmd(
473 hdw, CX2341X_ENC_INITIALIZE_INPUT, 0);
476 pvr2_trace(PVR2_TRACE_ERROR_LEGS,
477 "Failed to initialize cx23416 video input");
485 int pvr2_encoder_start(struct pvr2_hdw *hdw)
489 /* unmask some interrupts */
490 pvr2_write_register(hdw, 0x0048, 0xbfffffff);
492 pvr2_encoder_vcmd(hdw,CX2341X_ENC_MUTE_VIDEO,1,
493 hdw->input_val == PVR2_CVAL_INPUT_RADIO ? 1 : 0);
495 switch (hdw->active_stream_type) {
496 case pvr2_config_vbi:
497 status = pvr2_encoder_vcmd(hdw,CX2341X_ENC_START_CAPTURE,2,
500 case pvr2_config_mpeg:
501 status = pvr2_encoder_vcmd(hdw,CX2341X_ENC_START_CAPTURE,2,
504 default: /* Unhandled cases for now */
505 status = pvr2_encoder_vcmd(hdw,CX2341X_ENC_START_CAPTURE,2,
512 int pvr2_encoder_stop(struct pvr2_hdw *hdw)
516 /* mask all interrupts */
517 pvr2_write_register(hdw, 0x0048, 0xffffffff);
519 switch (hdw->active_stream_type) {
520 case pvr2_config_vbi:
521 status = pvr2_encoder_vcmd(hdw,CX2341X_ENC_STOP_CAPTURE,3,
524 case pvr2_config_mpeg:
525 status = pvr2_encoder_vcmd(hdw,CX2341X_ENC_STOP_CAPTURE,3,
528 default: /* Unhandled cases for now */
529 status = pvr2_encoder_vcmd(hdw,CX2341X_ENC_STOP_CAPTURE,3,
539 Stuff for Emacs to see, in order to encourage consistent editing style:
540 *** Local Variables: ***
542 *** fill-column: 70 ***
544 *** c-basic-offset: 8 ***