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 int dvb_usb_dib0700_ir_proto = 1;
17 module_param(dvb_usb_dib0700_ir_proto, int, 0644);
18 MODULE_PARM_DESC(dvb_usb_dib0700_ir_proto, "set ir protocol (0=NEC, 1=RC5 (default), 2=RC6).");
20 static int nb_packet_buffer_size = 21;
21 module_param(nb_packet_buffer_size, int, 0644);
22 MODULE_PARM_DESC(nb_packet_buffer_size,
23 "Set the dib0700 driver data buffer size. This parameter "
24 "corresponds to the number of TS packets. The actual size of "
25 "the data buffer corresponds to this parameter "
26 "multiplied by 188 (default: 21)");
28 DVB_DEFINE_MOD_OPT_ADAPTER_NR(adapter_nr);
31 int dib0700_get_version(struct dvb_usb_device *d, u32 *hwversion,
32 u32 *romversion, u32 *ramversion, u32 *fwtype)
35 int ret = usb_control_msg(d->udev, usb_rcvctrlpipe(d->udev, 0),
37 USB_TYPE_VENDOR | USB_DIR_IN, 0, 0,
38 b, sizeof(b), USB_CTRL_GET_TIMEOUT);
39 if (hwversion != NULL)
40 *hwversion = (b[0] << 24) | (b[1] << 16) | (b[2] << 8) | b[3];
41 if (romversion != NULL)
42 *romversion = (b[4] << 24) | (b[5] << 16) | (b[6] << 8) | b[7];
43 if (ramversion != NULL)
44 *ramversion = (b[8] << 24) | (b[9] << 16) | (b[10] << 8) | b[11];
46 *fwtype = (b[12] << 24) | (b[13] << 16) | (b[14] << 8) | b[15];
50 /* expecting rx buffer: request data[0] data[1] ... data[2] */
51 static int dib0700_ctrl_wr(struct dvb_usb_device *d, u8 *tx, u8 txlen)
56 debug_dump(tx,txlen,deb_data);
58 status = usb_control_msg(d->udev, usb_sndctrlpipe(d->udev,0),
59 tx[0], USB_TYPE_VENDOR | USB_DIR_OUT, 0, 0, tx, txlen,
60 USB_CTRL_GET_TIMEOUT);
63 deb_data("ep 0 write error (status = %d, len: %d)\n",status,txlen);
65 return status < 0 ? status : 0;
68 /* expecting tx buffer: request data[0] ... data[n] (n <= 4) */
69 int dib0700_ctrl_rd(struct dvb_usb_device *d, u8 *tx, u8 txlen, u8 *rx, u8 rxlen)
75 err("tx buffer length is smaller than 2. Makes no sense.");
79 err("tx buffer length is larger than 4. Not supported.");
84 debug_dump(tx,txlen,deb_data);
86 value = ((txlen - 2) << 8) | tx[1];
89 index |= (tx[2] << 8);
93 status = usb_control_msg(d->udev, usb_rcvctrlpipe(d->udev,0), tx[0],
94 USB_TYPE_VENDOR | USB_DIR_IN, value, index, rx, rxlen,
95 USB_CTRL_GET_TIMEOUT);
98 deb_info("ep 0 read error (status = %d)\n",status);
101 debug_dump(rx,rxlen,deb_data);
103 return status; /* length in case of success */
106 int dib0700_set_gpio(struct dvb_usb_device *d, enum dib07x0_gpios gpio, u8 gpio_dir, u8 gpio_val)
108 u8 buf[3] = { REQUEST_SET_GPIO, gpio, ((gpio_dir & 0x01) << 7) | ((gpio_val & 0x01) << 6) };
109 return dib0700_ctrl_wr(d,buf,3);
112 static int dib0700_set_usb_xfer_len(struct dvb_usb_device *d, u16 nb_ts_packets)
114 struct dib0700_state *st = d->priv;
118 if (st->fw_version >= 0x10201) {
119 b[0] = REQUEST_SET_USB_XFER_LEN;
120 b[1] = (nb_ts_packets >> 8)&0xff;
121 b[2] = nb_ts_packets & 0xff;
123 deb_info("set the USB xfer len to %i Ts packet\n", nb_ts_packets);
125 ret = dib0700_ctrl_wr(d, b, 3);
127 deb_info("this firmware does not allow to change the USB xfer len\n");
134 * I2C master xfer function (supported in 1.20 firmware)
136 static int dib0700_i2c_xfer_new(struct i2c_adapter *adap, struct i2c_msg *msg,
139 /* The new i2c firmware messages are more reliable and in particular
140 properly support i2c read calls not preceded by a write */
142 struct dvb_usb_device *d = i2c_get_adapdata(adap);
143 uint8_t bus_mode = 1; /* 0=eeprom bus, 1=frontend bus */
144 uint8_t gen_mode = 0; /* 0=master i2c, 1=gpio i2c */
145 uint8_t en_start = 0;
147 uint8_t buf[255]; /* TBV: malloc ? */
150 /* Ensure nobody else hits the i2c bus while we're sending our
151 sequence of messages, (such as the remote control thread) */
152 if (mutex_lock_interruptible(&d->i2c_mutex) < 0)
155 for (i = 0; i < num; i++) {
157 /* First message in the transaction */
159 } else if (!(msg[i].flags & I2C_M_NOSTART)) {
160 /* Device supports repeated-start */
163 /* Not the first packet and device doesn't support
167 if (i == (num - 1)) {
168 /* Last message in the transaction */
172 if (msg[i].flags & I2C_M_RD) {
177 i2c_dest = (msg[i].addr << 1);
178 value = ((en_start << 7) | (en_stop << 6) |
179 (msg[i].len & 0x3F)) << 8 | i2c_dest;
180 /* I2C ctrl + FE bus; */
181 index = ((gen_mode<<6)&0xC0) | ((bus_mode<<4)&0x30);
183 result = usb_control_msg(d->udev,
184 usb_rcvctrlpipe(d->udev, 0),
185 REQUEST_NEW_I2C_READ,
186 USB_TYPE_VENDOR | USB_DIR_IN,
187 value, index, msg[i].buf,
189 USB_CTRL_GET_TIMEOUT);
191 err("i2c read error (status = %d)\n", result);
196 debug_dump(msg[i].buf, msg[i].len, deb_data);
200 buf[0] = REQUEST_NEW_I2C_WRITE;
201 buf[1] = (msg[i].addr << 1);
202 buf[2] = (en_start << 7) | (en_stop << 6) |
204 /* I2C ctrl + FE bus; */
205 buf[3] = ((gen_mode<<6)&0xC0) | ((bus_mode<<4)&0x30);
206 /* The Actual i2c payload */
207 memcpy(&buf[4], msg[i].buf, msg[i].len);
210 debug_dump(buf, msg[i].len + 4, deb_data);
212 result = usb_control_msg(d->udev,
213 usb_sndctrlpipe(d->udev, 0),
214 REQUEST_NEW_I2C_WRITE,
215 USB_TYPE_VENDOR | USB_DIR_OUT,
216 0, 0, buf, msg[i].len + 4,
217 USB_CTRL_GET_TIMEOUT);
219 err("i2c write error (status = %d)\n", result);
224 mutex_unlock(&d->i2c_mutex);
229 * I2C master xfer function (pre-1.20 firmware)
231 static int dib0700_i2c_xfer_legacy(struct i2c_adapter *adap,
232 struct i2c_msg *msg, int num)
234 struct dvb_usb_device *d = i2c_get_adapdata(adap);
238 if (mutex_lock_interruptible(&d->i2c_mutex) < 0)
241 for (i = 0; i < num; i++) {
242 /* fill in the address */
243 buf[1] = (msg[i].addr << 1);
244 /* fill the buffer */
245 memcpy(&buf[2], msg[i].buf, msg[i].len);
247 /* write/read request */
248 if (i+1 < num && (msg[i+1].flags & I2C_M_RD)) {
249 buf[0] = REQUEST_I2C_READ;
252 /* special thing in the current firmware: when length is zero the read-failed */
253 if ((len = dib0700_ctrl_rd(d, buf, msg[i].len + 2, msg[i+1].buf, msg[i+1].len)) <= 0) {
254 deb_info("I2C read failed on address 0x%02x\n",
263 buf[0] = REQUEST_I2C_WRITE;
264 if (dib0700_ctrl_wr(d, buf, msg[i].len + 2) < 0)
269 mutex_unlock(&d->i2c_mutex);
273 static int dib0700_i2c_xfer(struct i2c_adapter *adap, struct i2c_msg *msg,
276 struct dvb_usb_device *d = i2c_get_adapdata(adap);
277 struct dib0700_state *st = d->priv;
279 if (st->fw_use_new_i2c_api == 1) {
280 /* User running at least fw 1.20 */
281 return dib0700_i2c_xfer_new(adap, msg, num);
283 /* Use legacy calls */
284 return dib0700_i2c_xfer_legacy(adap, msg, num);
288 static u32 dib0700_i2c_func(struct i2c_adapter *adapter)
293 struct i2c_algorithm dib0700_i2c_algo = {
294 .master_xfer = dib0700_i2c_xfer,
295 .functionality = dib0700_i2c_func,
298 int dib0700_identify_state(struct usb_device *udev, struct dvb_usb_device_properties *props,
299 struct dvb_usb_device_description **desc, int *cold)
302 s16 ret = usb_control_msg(udev, usb_rcvctrlpipe(udev,0),
303 REQUEST_GET_VERSION, USB_TYPE_VENDOR | USB_DIR_IN, 0, 0, b, 16, USB_CTRL_GET_TIMEOUT);
305 deb_info("FW GET_VERSION length: %d\n",ret);
309 deb_info("cold: %d\n", *cold);
313 static int dib0700_set_clock(struct dvb_usb_device *d, u8 en_pll,
314 u8 pll_src, u8 pll_range, u8 clock_gpio3, u16 pll_prediv,
315 u16 pll_loopdiv, u16 free_div, u16 dsuScaler)
318 b[0] = REQUEST_SET_CLOCK;
319 b[1] = (en_pll << 7) | (pll_src << 6) | (pll_range << 5) | (clock_gpio3 << 4);
320 b[2] = (pll_prediv >> 8) & 0xff; // MSB
321 b[3] = pll_prediv & 0xff; // LSB
322 b[4] = (pll_loopdiv >> 8) & 0xff; // MSB
323 b[5] = pll_loopdiv & 0xff; // LSB
324 b[6] = (free_div >> 8) & 0xff; // MSB
325 b[7] = free_div & 0xff; // LSB
326 b[8] = (dsuScaler >> 8) & 0xff; // MSB
327 b[9] = dsuScaler & 0xff; // LSB
329 return dib0700_ctrl_wr(d, b, 10);
332 int dib0700_ctrl_clock(struct dvb_usb_device *d, u32 clk_MHz, u8 clock_out_gp3)
335 case 72: dib0700_set_clock(d, 1, 0, 1, clock_out_gp3, 2, 24, 0, 0x4c); break;
336 default: return -EINVAL;
341 static int dib0700_jumpram(struct usb_device *udev, u32 address)
344 u8 buf[8] = { REQUEST_JUMPRAM, 0, 0, 0,
345 (address >> 24) & 0xff,
346 (address >> 16) & 0xff,
347 (address >> 8) & 0xff,
350 if ((ret = usb_bulk_msg(udev, usb_sndbulkpipe(udev, 0x01),buf,8,&actlen,1000)) < 0) {
351 deb_fw("jumpram to 0x%x failed\n",address);
355 deb_fw("jumpram to 0x%x failed\n",address);
361 int dib0700_download_firmware(struct usb_device *udev, const struct firmware *fw)
364 int pos = 0, ret, act_len, i, adap_num;
370 while ((ret = dvb_usb_get_hexline(fw, &hx, &pos)) > 0) {
371 deb_fwdata("writing to address 0x%08x (buffer: 0x%02x %02x)\n",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_rc_setup(struct dvb_usb_device *d)
476 u8 rc_setup[3] = {REQUEST_SET_RC, dvb_usb_dib0700_ir_proto, 0};
477 int i = dib0700_ctrl_wr(d, rc_setup, 3);
479 err("ir protocol setup failed");
485 static int dib0700_probe(struct usb_interface *intf,
486 const struct usb_device_id *id)
489 struct dvb_usb_device *dev;
491 for (i = 0; i < dib0700_device_count; i++)
492 if (dvb_usb_device_init(intf, &dib0700_devices[i], THIS_MODULE,
493 &dev, adapter_nr) == 0) {
494 struct dib0700_state *st = dev->priv;
495 u32 hwversion, romversion, fw_version, fwtype;
497 dib0700_get_version(dev, &hwversion, &romversion,
498 &fw_version, &fwtype);
500 deb_info("Firmware version: %x, %d, 0x%x, %d\n",
501 hwversion, romversion, fw_version, fwtype);
503 st->fw_version = fw_version;
504 st->nb_packet_buffer_size = (u32)nb_packet_buffer_size;
506 dib0700_rc_setup(dev);
514 static struct usb_driver dib0700_driver = {
515 .name = "dvb_usb_dib0700",
516 .probe = dib0700_probe,
517 .disconnect = dvb_usb_device_exit,
518 .id_table = dib0700_usb_id_table,
522 static int __init dib0700_module_init(void)
525 info("loaded with support for %d different device-types", dib0700_device_count);
526 if ((result = usb_register(&dib0700_driver))) {
527 err("usb_register failed. Error number %d",result);
534 static void __exit dib0700_module_exit(void)
536 /* deregister this driver from the USB subsystem */
537 usb_deregister(&dib0700_driver);
540 module_init (dib0700_module_init);
541 module_exit (dib0700_module_exit);
543 MODULE_AUTHOR("Patrick Boettcher <pboettcher@dibcom.fr>");
544 MODULE_DESCRIPTION("Driver for devices based on DiBcom DiB0700 - USB bridge");
545 MODULE_VERSION("1.0");
546 MODULE_LICENSE("GPL");