1 /* Linux driver for devices based on the DiBcom DiB0700 USB bridge
3 * This program is free software; you can redistribute it and/or modify it
4 * under the terms of the GNU General Public License as published by the Free
5 * Software Foundation, version 2.
7 * Copyright (C) 2005-6 DiBcom, SA
12 int dvb_usb_dib0700_debug;
13 module_param_named(debug,dvb_usb_dib0700_debug, int, 0644);
14 MODULE_PARM_DESC(debug, "set debugging level (1=info,2=fw,4=fwdata,8=data (or-able))." DVB_USB_DEBUG_STATUS);
16 static int nb_packet_buffer_size = 21;
17 module_param(nb_packet_buffer_size, int, 0644);
18 MODULE_PARM_DESC(nb_packet_buffer_size,
19 "Set the dib0700 driver data buffer size. This parameter "
20 "corresponds to the number of TS packets. The actual size of "
21 "the data buffer corresponds to this parameter "
22 "multiplied by 188 (default: 21)");
24 DVB_DEFINE_MOD_OPT_ADAPTER_NR(adapter_nr);
27 int dib0700_get_version(struct dvb_usb_device *d, u32 *hwversion,
28 u32 *romversion, u32 *ramversion, u32 *fwtype)
31 int ret = usb_control_msg(d->udev, usb_rcvctrlpipe(d->udev, 0),
33 USB_TYPE_VENDOR | USB_DIR_IN, 0, 0,
34 b, sizeof(b), USB_CTRL_GET_TIMEOUT);
35 if (hwversion != NULL)
36 *hwversion = (b[0] << 24) | (b[1] << 16) | (b[2] << 8) | b[3];
37 if (romversion != NULL)
38 *romversion = (b[4] << 24) | (b[5] << 16) | (b[6] << 8) | b[7];
39 if (ramversion != NULL)
40 *ramversion = (b[8] << 24) | (b[9] << 16) | (b[10] << 8) | b[11];
42 *fwtype = (b[12] << 24) | (b[13] << 16) | (b[14] << 8) | b[15];
46 /* expecting rx buffer: request data[0] data[1] ... data[2] */
47 static int dib0700_ctrl_wr(struct dvb_usb_device *d, u8 *tx, u8 txlen)
52 debug_dump(tx, txlen, deb_data);
54 status = usb_control_msg(d->udev, usb_sndctrlpipe(d->udev,0),
55 tx[0], USB_TYPE_VENDOR | USB_DIR_OUT, 0, 0, tx, txlen,
56 USB_CTRL_GET_TIMEOUT);
59 deb_data("ep 0 write error (status = %d, len: %d)\n",status,txlen);
61 return status < 0 ? status : 0;
64 /* expecting tx buffer: request data[0] ... data[n] (n <= 4) */
65 int dib0700_ctrl_rd(struct dvb_usb_device *d, u8 *tx, u8 txlen, u8 *rx, u8 rxlen)
71 err("tx buffer length is smaller than 2. Makes no sense.");
75 err("tx buffer length is larger than 4. Not supported.");
80 debug_dump(tx,txlen,deb_data);
82 value = ((txlen - 2) << 8) | tx[1];
85 index |= (tx[2] << 8);
89 status = usb_control_msg(d->udev, usb_rcvctrlpipe(d->udev,0), tx[0],
90 USB_TYPE_VENDOR | USB_DIR_IN, value, index, rx, rxlen,
91 USB_CTRL_GET_TIMEOUT);
94 deb_info("ep 0 read error (status = %d)\n",status);
97 debug_dump(rx, rxlen, deb_data);
99 return status; /* length in case of success */
102 int dib0700_set_gpio(struct dvb_usb_device *d, enum dib07x0_gpios gpio, u8 gpio_dir, u8 gpio_val)
104 u8 buf[3] = { REQUEST_SET_GPIO, gpio, ((gpio_dir & 0x01) << 7) | ((gpio_val & 0x01) << 6) };
105 return dib0700_ctrl_wr(d, buf, sizeof(buf));
108 static int dib0700_set_usb_xfer_len(struct dvb_usb_device *d, u16 nb_ts_packets)
110 struct dib0700_state *st = d->priv;
114 if (st->fw_version >= 0x10201) {
115 b[0] = REQUEST_SET_USB_XFER_LEN;
116 b[1] = (nb_ts_packets >> 8) & 0xff;
117 b[2] = nb_ts_packets & 0xff;
119 deb_info("set the USB xfer len to %i Ts packet\n", nb_ts_packets);
121 ret = dib0700_ctrl_wr(d, b, sizeof(b));
123 deb_info("this firmware does not allow to change the USB xfer len\n");
131 * I2C master xfer function (supported in 1.20 firmware)
133 static int dib0700_i2c_xfer_new(struct i2c_adapter *adap, struct i2c_msg *msg,
136 /* The new i2c firmware messages are more reliable and in particular
137 properly support i2c read calls not preceded by a write */
139 struct dvb_usb_device *d = i2c_get_adapdata(adap);
140 uint8_t bus_mode = 1; /* 0=eeprom bus, 1=frontend bus */
141 uint8_t gen_mode = 0; /* 0=master i2c, 1=gpio i2c */
142 uint8_t en_start = 0;
144 uint8_t buf[255]; /* TBV: malloc ? */
147 /* Ensure nobody else hits the i2c bus while we're sending our
148 sequence of messages, (such as the remote control thread) */
149 if (mutex_lock_interruptible(&d->i2c_mutex) < 0)
152 for (i = 0; i < num; i++) {
154 /* First message in the transaction */
156 } else if (!(msg[i].flags & I2C_M_NOSTART)) {
157 /* Device supports repeated-start */
160 /* Not the first packet and device doesn't support
164 if (i == (num - 1)) {
165 /* Last message in the transaction */
169 if (msg[i].flags & I2C_M_RD) {
174 i2c_dest = (msg[i].addr << 1);
175 value = ((en_start << 7) | (en_stop << 6) |
176 (msg[i].len & 0x3F)) << 8 | i2c_dest;
177 /* I2C ctrl + FE bus; */
178 index = ((gen_mode << 6) & 0xC0) |
179 ((bus_mode << 4) & 0x30);
181 result = usb_control_msg(d->udev,
182 usb_rcvctrlpipe(d->udev, 0),
183 REQUEST_NEW_I2C_READ,
184 USB_TYPE_VENDOR | USB_DIR_IN,
185 value, index, msg[i].buf,
187 USB_CTRL_GET_TIMEOUT);
189 err("i2c read error (status = %d)\n", result);
194 debug_dump(msg[i].buf, msg[i].len, deb_data);
198 buf[0] = REQUEST_NEW_I2C_WRITE;
199 buf[1] = msg[i].addr << 1;
200 buf[2] = (en_start << 7) | (en_stop << 6) |
202 /* I2C ctrl + FE bus; */
203 buf[3] = ((gen_mode << 6) & 0xC0) |
204 ((bus_mode << 4) & 0x30);
205 /* The Actual i2c payload */
206 memcpy(&buf[4], msg[i].buf, msg[i].len);
209 debug_dump(buf, msg[i].len + 4, deb_data);
211 result = usb_control_msg(d->udev,
212 usb_sndctrlpipe(d->udev, 0),
213 REQUEST_NEW_I2C_WRITE,
214 USB_TYPE_VENDOR | USB_DIR_OUT,
215 0, 0, buf, msg[i].len + 4,
216 USB_CTRL_GET_TIMEOUT);
218 err("i2c write error (status = %d)\n", result);
223 mutex_unlock(&d->i2c_mutex);
228 * I2C master xfer function (pre-1.20 firmware)
230 static int dib0700_i2c_xfer_legacy(struct i2c_adapter *adap,
231 struct i2c_msg *msg, int num)
233 struct dvb_usb_device *d = i2c_get_adapdata(adap);
237 if (mutex_lock_interruptible(&d->i2c_mutex) < 0)
240 for (i = 0; i < num; i++) {
241 /* fill in the address */
242 buf[1] = msg[i].addr << 1;
243 /* fill the buffer */
244 memcpy(&buf[2], msg[i].buf, msg[i].len);
246 /* write/read request */
247 if (i+1 < num && (msg[i+1].flags & I2C_M_RD)) {
248 buf[0] = REQUEST_I2C_READ;
251 /* special thing in the current firmware: when length is zero the read-failed */
252 if ((len = dib0700_ctrl_rd(d, buf, msg[i].len + 2, msg[i+1].buf, msg[i+1].len)) <= 0) {
253 deb_info("I2C read failed on address 0x%02x\n",
262 buf[0] = REQUEST_I2C_WRITE;
263 if (dib0700_ctrl_wr(d, buf, msg[i].len + 2) < 0)
268 mutex_unlock(&d->i2c_mutex);
272 static int dib0700_i2c_xfer(struct i2c_adapter *adap, struct i2c_msg *msg,
275 struct dvb_usb_device *d = i2c_get_adapdata(adap);
276 struct dib0700_state *st = d->priv;
278 if (st->fw_use_new_i2c_api == 1) {
279 /* User running at least fw 1.20 */
280 return dib0700_i2c_xfer_new(adap, msg, num);
282 /* Use legacy calls */
283 return dib0700_i2c_xfer_legacy(adap, msg, num);
287 static u32 dib0700_i2c_func(struct i2c_adapter *adapter)
292 struct i2c_algorithm dib0700_i2c_algo = {
293 .master_xfer = dib0700_i2c_xfer,
294 .functionality = dib0700_i2c_func,
297 int dib0700_identify_state(struct usb_device *udev, struct dvb_usb_device_properties *props,
298 struct dvb_usb_device_description **desc, int *cold)
301 s16 ret = usb_control_msg(udev, usb_rcvctrlpipe(udev,0),
302 REQUEST_GET_VERSION, USB_TYPE_VENDOR | USB_DIR_IN, 0, 0, b, 16, USB_CTRL_GET_TIMEOUT);
304 deb_info("FW GET_VERSION length: %d\n",ret);
308 deb_info("cold: %d\n", *cold);
312 static int dib0700_set_clock(struct dvb_usb_device *d, u8 en_pll,
313 u8 pll_src, u8 pll_range, u8 clock_gpio3, u16 pll_prediv,
314 u16 pll_loopdiv, u16 free_div, u16 dsuScaler)
317 b[0] = REQUEST_SET_CLOCK;
318 b[1] = (en_pll << 7) | (pll_src << 6) | (pll_range << 5) | (clock_gpio3 << 4);
319 b[2] = (pll_prediv >> 8) & 0xff; // MSB
320 b[3] = pll_prediv & 0xff; // LSB
321 b[4] = (pll_loopdiv >> 8) & 0xff; // MSB
322 b[5] = pll_loopdiv & 0xff; // LSB
323 b[6] = (free_div >> 8) & 0xff; // MSB
324 b[7] = free_div & 0xff; // LSB
325 b[8] = (dsuScaler >> 8) & 0xff; // MSB
326 b[9] = dsuScaler & 0xff; // LSB
328 return dib0700_ctrl_wr(d, b, 10);
331 int dib0700_ctrl_clock(struct dvb_usb_device *d, u32 clk_MHz, u8 clock_out_gp3)
334 case 72: dib0700_set_clock(d, 1, 0, 1, clock_out_gp3, 2, 24, 0, 0x4c); break;
335 default: return -EINVAL;
340 static int dib0700_jumpram(struct usb_device *udev, u32 address)
343 u8 buf[8] = { REQUEST_JUMPRAM, 0, 0, 0,
344 (address >> 24) & 0xff,
345 (address >> 16) & 0xff,
346 (address >> 8) & 0xff,
349 if ((ret = usb_bulk_msg(udev, usb_sndbulkpipe(udev, 0x01),buf,8,&actlen,1000)) < 0) {
350 deb_fw("jumpram to 0x%x failed\n",address);
354 deb_fw("jumpram to 0x%x failed\n",address);
360 int dib0700_download_firmware(struct usb_device *udev, const struct firmware *fw)
363 int pos = 0, ret, act_len, i, adap_num;
369 while ((ret = dvb_usb_get_hexline(fw, &hx, &pos)) > 0) {
370 deb_fwdata("writing to address 0x%08x (buffer: 0x%02x %02x)\n",
371 hx.addr, hx.len, hx.chk);
374 buf[1] = (hx.addr >> 8) & 0xff;
375 buf[2] = hx.addr & 0xff;
377 memcpy(&buf[4],hx.data,hx.len);
378 buf[4+hx.len] = hx.chk;
380 ret = usb_bulk_msg(udev,
381 usb_sndbulkpipe(udev, 0x01),
388 err("firmware download failed at %d with %d",pos,ret);
394 /* start the firmware */
395 if ((ret = dib0700_jumpram(udev, 0x70000000)) == 0) {
396 info("firmware started successfully.");
402 /* the number of ts packet has to be at least 1 */
403 if (nb_packet_buffer_size < 1)
404 nb_packet_buffer_size = 1;
406 /* get the fimware version */
407 usb_control_msg(udev, usb_rcvctrlpipe(udev, 0),
409 USB_TYPE_VENDOR | USB_DIR_IN, 0, 0,
410 b, sizeof(b), USB_CTRL_GET_TIMEOUT);
411 fw_version = (b[8] << 24) | (b[9] << 16) | (b[10] << 8) | b[11];
413 /* set the buffer size - DVB-USB is allocating URB buffers
414 * only after the firwmare download was successful */
415 for (i = 0; i < dib0700_device_count; i++) {
416 for (adap_num = 0; adap_num < dib0700_devices[i].num_adapters;
418 if (fw_version >= 0x10201) {
419 dib0700_devices[i].adapter[adap_num].stream.u.bulk.buffersize = 188*nb_packet_buffer_size;
421 /* for fw version older than 1.20.1,
422 * the buffersize has to be n times 512 */
423 dib0700_devices[i].adapter[adap_num].stream.u.bulk.buffersize = ((188*nb_packet_buffer_size+188/2)/512)*512;
424 if (dib0700_devices[i].adapter[adap_num].stream.u.bulk.buffersize < 512)
425 dib0700_devices[i].adapter[adap_num].stream.u.bulk.buffersize = 512;
433 int dib0700_streaming_ctrl(struct dvb_usb_adapter *adap, int onoff)
435 struct dib0700_state *st = adap->dev->priv;
439 if ((onoff != 0) && (st->fw_version >= 0x10201)) {
440 /* for firmware later than 1.20.1,
441 * the USB xfer length can be set */
442 ret = dib0700_set_usb_xfer_len(adap->dev,
443 st->nb_packet_buffer_size);
445 deb_info("can not set the USB xfer len\n");
450 b[0] = REQUEST_ENABLE_VIDEO;
451 b[1] = (onoff << 4) | 0x00; /* this bit gives a kind of command, rather than enabling something or not */
453 if (st->disable_streaming_master_mode == 1)
456 b[2] = 0x01 << 4; /* Master mode */
460 deb_info("modifying (%d) streaming state for %d\n", onoff, adap->id);
463 st->channel_state |= 1 << adap->id;
465 st->channel_state &= ~(1 << adap->id);
467 b[2] |= st->channel_state;
469 deb_info("data for streaming: %x %x\n", b[1], b[2]);
471 return dib0700_ctrl_wr(adap->dev, b, 4);
474 int dib0700_change_protocol(void *priv, u64 ir_type)
476 struct dvb_usb_device *d = priv;
477 struct dib0700_state *st = d->priv;
478 u8 rc_setup[3] = { REQUEST_SET_RC, 0, 0 };
481 /* Set the IR mode */
482 if (ir_type == IR_TYPE_RC5)
484 else if (ir_type == IR_TYPE_NEC)
486 else if (ir_type == IR_TYPE_RC6) {
487 if (st->fw_version < 0x10200)
494 rc_setup[1] = new_proto;
496 ret = dib0700_ctrl_wr(d, rc_setup, sizeof(rc_setup));
498 err("ir protocol setup failed");
502 d->props.rc.core.protocol = new_proto;
507 /* Number of keypresses to ignore before start repeating */
508 #define RC_REPEAT_DELAY_V1_20 10
510 /* This is the structure of the RC response packet starting in firmware 1.20 */
511 struct dib0700_rc_response {
518 #define RC_MSG_SIZE_V1_20 6
520 static void dib0700_rc_urb_completion(struct urb *purb)
522 struct dvb_usb_device *d = purb->context;
523 struct dib0700_state *st;
524 struct dib0700_rc_response poll_reply;
529 deb_info("%s()\n", __func__);
533 if (d->rc_input_dev == NULL) {
534 /* This will occur if disable_rc_polling=1 */
540 buf = (u8 *)purb->transfer_buffer;
542 if (purb->status < 0) {
543 deb_info("discontinuing polling\n");
548 if (purb->actual_length != RC_MSG_SIZE_V1_20) {
549 deb_info("malformed rc msg size=%d\n", purb->actual_length);
553 deb_data("IR raw %02X %02X %02X %02X %02X %02X (len %d)\n", buf[0],
554 buf[1], buf[2], buf[3], buf[4], buf[5], purb->actual_length);
556 switch (d->props.rc.core.protocol) {
558 poll_reply.data_state = 0;
559 poll_reply.system = buf[2];
560 poll_reply.data = buf[4];
561 poll_reply.not_data = buf[5];
564 /* NEC protocol sends repeat code as 0 0 0 FF */
565 if ((poll_reply.system == 0x00) && (poll_reply.data == 0x00)
566 && (poll_reply.not_data == 0xff)) {
567 poll_reply.data_state = 2;
574 /* TODO: need to check the mapping for RC6 */
575 poll_reply.report_id = buf[0];
576 poll_reply.data_state = buf[1];
577 poll_reply.system = (buf[2] << 8) | buf[3];
578 poll_reply.data = buf[4];
579 poll_reply.not_data = buf[5];
581 toggle = poll_reply.report_id;
586 if ((poll_reply.data + poll_reply.not_data) != 0xff) {
587 /* Key failed integrity check */
588 err("key failed integrity check: %04x %02x %02x",
590 poll_reply.data, poll_reply.not_data);
594 deb_data("rid=%02x ds=%02x sm=%04x d=%02x nd=%02x\n",
595 poll_reply.report_id, poll_reply.data_state,
596 poll_reply.system, poll_reply.data, poll_reply.not_data);
598 keycode = poll_reply.system << 8 | poll_reply.data;
599 ir_keydown(d->rc_input_dev, keycode, toggle);
602 /* Clean the buffer before we requeue */
603 memset(purb->transfer_buffer, 0, RC_MSG_SIZE_V1_20);
606 usb_submit_urb(purb, GFP_ATOMIC);
609 int dib0700_rc_setup(struct dvb_usb_device *d)
611 struct dib0700_state *st = d->priv;
615 /* Poll-based. Don't initialize bulk mode */
616 if (st->fw_version < 0x10200)
619 /* Starting in firmware 1.20, the RC info is provided on a bulk pipe */
620 purb = usb_alloc_urb(0, GFP_KERNEL);
622 err("rc usb alloc urb failed\n");
626 purb->transfer_buffer = kzalloc(RC_MSG_SIZE_V1_20, GFP_KERNEL);
627 if (purb->transfer_buffer == NULL) {
628 err("rc kzalloc failed\n");
633 purb->status = -EINPROGRESS;
634 usb_fill_bulk_urb(purb, d->udev, usb_rcvbulkpipe(d->udev, 1),
635 purb->transfer_buffer, RC_MSG_SIZE_V1_20,
636 dib0700_rc_urb_completion, d);
638 ret = usb_submit_urb(purb, GFP_ATOMIC);
640 err("rc submit urb failed\n");
645 static int dib0700_probe(struct usb_interface *intf,
646 const struct usb_device_id *id)
649 struct dvb_usb_device *dev;
651 for (i = 0; i < dib0700_device_count; i++)
652 if (dvb_usb_device_init(intf, &dib0700_devices[i], THIS_MODULE,
653 &dev, adapter_nr) == 0) {
654 struct dib0700_state *st = dev->priv;
655 u32 hwversion, romversion, fw_version, fwtype;
657 dib0700_get_version(dev, &hwversion, &romversion,
658 &fw_version, &fwtype);
660 deb_info("Firmware version: %x, %d, 0x%x, %d\n",
661 hwversion, romversion, fw_version, fwtype);
663 st->fw_version = fw_version;
664 st->nb_packet_buffer_size = (u32)nb_packet_buffer_size;
666 /* Disable polling mode on newer firmwares */
667 if (st->fw_version >= 0x10200)
668 dev->props.rc.core.bulk_mode = true;
670 dev->props.rc.core.bulk_mode = false;
672 /* Need a higher delay, to avoid wrong repeat */
673 dev->rc_input_dev->rep[REP_DELAY] = 500;
675 dib0700_rc_setup(dev);
683 static struct usb_driver dib0700_driver = {
684 .name = "dvb_usb_dib0700",
685 .probe = dib0700_probe,
686 .disconnect = dvb_usb_device_exit,
687 .id_table = dib0700_usb_id_table,
691 static int __init dib0700_module_init(void)
694 info("loaded with support for %d different device-types", dib0700_device_count);
695 if ((result = usb_register(&dib0700_driver))) {
696 err("usb_register failed. Error number %d",result);
703 static void __exit dib0700_module_exit(void)
705 /* deregister this driver from the USB subsystem */
706 usb_deregister(&dib0700_driver);
709 module_init (dib0700_module_init);
710 module_exit (dib0700_module_exit);
712 MODULE_AUTHOR("Patrick Boettcher <pboettcher@dibcom.fr>");
713 MODULE_DESCRIPTION("Driver for devices based on DiBcom DiB0700 - USB bridge");
714 MODULE_VERSION("1.0");
715 MODULE_LICENSE("GPL");