sh_eth: fix EESIPR values for SH77{34|63}
[linux/fpc-iii.git] / drivers / media / radio / si470x / radio-si470x-usb.c
blob1add136d37a32f327f32a3f04f786ea39863b8ad
1 /*
2 * drivers/media/radio/si470x/radio-si470x-usb.c
4 * USB driver for radios with Silicon Labs Si470x FM Radio Receivers
6 * Copyright (c) 2009 Tobias Lorenz <tobias.lorenz@gmx.net>
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, or
11 * (at your option) any later version.
13 * This program is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 * GNU General Public License for more details.
18 * You should have received a copy of the GNU General Public License
19 * along with this program; if not, write to the Free Software
20 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
25 * ToDo:
26 * - add firmware download/update support
30 /* driver definitions */
31 #define DRIVER_AUTHOR "Tobias Lorenz <tobias.lorenz@gmx.net>"
32 #define DRIVER_CARD "Silicon Labs Si470x FM Radio Receiver"
33 #define DRIVER_DESC "USB radio driver for Si470x FM Radio Receivers"
34 #define DRIVER_VERSION "1.0.10"
36 /* kernel includes */
37 #include <linux/usb.h>
38 #include <linux/hid.h>
39 #include <linux/slab.h>
41 #include "radio-si470x.h"
44 /* USB Device ID List */
45 static struct usb_device_id si470x_usb_driver_id_table[] = {
46 /* Silicon Labs USB FM Radio Reference Design */
47 { USB_DEVICE_AND_INTERFACE_INFO(0x10c4, 0x818a, USB_CLASS_HID, 0, 0) },
48 /* ADS/Tech FM Radio Receiver (formerly Instant FM Music) */
49 { USB_DEVICE_AND_INTERFACE_INFO(0x06e1, 0xa155, USB_CLASS_HID, 0, 0) },
50 /* KWorld USB FM Radio SnapMusic Mobile 700 (FM700) */
51 { USB_DEVICE_AND_INTERFACE_INFO(0x1b80, 0xd700, USB_CLASS_HID, 0, 0) },
52 /* Sanei Electric, Inc. FM USB Radio (sold as DealExtreme.com PCear) */
53 { USB_DEVICE_AND_INTERFACE_INFO(0x10c5, 0x819a, USB_CLASS_HID, 0, 0) },
54 /* Axentia ALERT FM USB Receiver */
55 { USB_DEVICE_AND_INTERFACE_INFO(0x12cf, 0x7111, USB_CLASS_HID, 0, 0) },
56 /* Terminating entry */
57 { }
59 MODULE_DEVICE_TABLE(usb, si470x_usb_driver_id_table);
63 /**************************************************************************
64 * Module Parameters
65 **************************************************************************/
67 /* Radio Nr */
68 static int radio_nr = -1;
69 module_param(radio_nr, int, 0444);
70 MODULE_PARM_DESC(radio_nr, "Radio Nr");
72 /* USB timeout */
73 static unsigned int usb_timeout = 500;
74 module_param(usb_timeout, uint, 0644);
75 MODULE_PARM_DESC(usb_timeout, "USB timeout (ms): *500*");
77 /* RDS buffer blocks */
78 static unsigned int rds_buf = 100;
79 module_param(rds_buf, uint, 0444);
80 MODULE_PARM_DESC(rds_buf, "RDS buffer entries: *100*");
82 /* RDS maximum block errors */
83 static unsigned short max_rds_errors = 1;
84 /* 0 means 0 errors requiring correction */
85 /* 1 means 1-2 errors requiring correction (used by original USBRadio.exe) */
86 /* 2 means 3-5 errors requiring correction */
87 /* 3 means 6+ errors or errors in checkword, correction not possible */
88 module_param(max_rds_errors, ushort, 0644);
89 MODULE_PARM_DESC(max_rds_errors, "RDS maximum block errors: *1*");
93 /**************************************************************************
94 * USB HID Reports
95 **************************************************************************/
97 /* Reports 1-16 give direct read/write access to the 16 Si470x registers */
98 /* with the (REPORT_ID - 1) corresponding to the register address across USB */
99 /* endpoint 0 using GET_REPORT and SET_REPORT */
100 #define REGISTER_REPORT_SIZE (RADIO_REGISTER_SIZE + 1)
101 #define REGISTER_REPORT(reg) ((reg) + 1)
103 /* Report 17 gives direct read/write access to the entire Si470x register */
104 /* map across endpoint 0 using GET_REPORT and SET_REPORT */
105 #define ENTIRE_REPORT_SIZE (RADIO_REGISTER_NUM * RADIO_REGISTER_SIZE + 1)
106 #define ENTIRE_REPORT 17
108 /* Report 18 is used to send the lowest 6 Si470x registers up the HID */
109 /* interrupt endpoint 1 to Windows every 20 milliseconds for status */
110 #define RDS_REPORT_SIZE (RDS_REGISTER_NUM * RADIO_REGISTER_SIZE + 1)
111 #define RDS_REPORT 18
113 /* Report 19: LED state */
114 #define LED_REPORT_SIZE 3
115 #define LED_REPORT 19
117 /* Report 19: stream */
118 #define STREAM_REPORT_SIZE 3
119 #define STREAM_REPORT 19
121 /* Report 20: scratch */
122 #define SCRATCH_PAGE_SIZE 63
123 #define SCRATCH_REPORT_SIZE (SCRATCH_PAGE_SIZE + 1)
124 #define SCRATCH_REPORT 20
126 /* Reports 19-22: flash upgrade of the C8051F321 */
127 #define WRITE_REPORT_SIZE 4
128 #define WRITE_REPORT 19
129 #define FLASH_REPORT_SIZE 64
130 #define FLASH_REPORT 20
131 #define CRC_REPORT_SIZE 3
132 #define CRC_REPORT 21
133 #define RESPONSE_REPORT_SIZE 2
134 #define RESPONSE_REPORT 22
136 /* Report 23: currently unused, but can accept 60 byte reports on the HID */
137 /* interrupt out endpoint 2 every 1 millisecond */
138 #define UNUSED_REPORT 23
140 #define MAX_REPORT_SIZE 64
144 /**************************************************************************
145 * Software/Hardware Versions from Scratch Page
146 **************************************************************************/
147 #define RADIO_HW_VERSION 1
151 /**************************************************************************
152 * LED State Definitions
153 **************************************************************************/
154 #define LED_COMMAND 0x35
156 #define NO_CHANGE_LED 0x00
157 #define ALL_COLOR_LED 0x01 /* streaming state */
158 #define BLINK_GREEN_LED 0x02 /* connect state */
159 #define BLINK_RED_LED 0x04
160 #define BLINK_ORANGE_LED 0x10 /* disconnect state */
161 #define SOLID_GREEN_LED 0x20 /* tuning/seeking state */
162 #define SOLID_RED_LED 0x40 /* bootload state */
163 #define SOLID_ORANGE_LED 0x80
167 /**************************************************************************
168 * Stream State Definitions
169 **************************************************************************/
170 #define STREAM_COMMAND 0x36
171 #define STREAM_VIDPID 0x00
172 #define STREAM_AUDIO 0xff
176 /**************************************************************************
177 * Bootloader / Flash Commands
178 **************************************************************************/
180 /* unique id sent to bootloader and required to put into a bootload state */
181 #define UNIQUE_BL_ID 0x34
183 /* mask for the flash data */
184 #define FLASH_DATA_MASK 0x55
186 /* bootloader commands */
187 #define GET_SW_VERSION_COMMAND 0x00
188 #define SET_PAGE_COMMAND 0x01
189 #define ERASE_PAGE_COMMAND 0x02
190 #define WRITE_PAGE_COMMAND 0x03
191 #define CRC_ON_PAGE_COMMAND 0x04
192 #define READ_FLASH_BYTE_COMMAND 0x05
193 #define RESET_DEVICE_COMMAND 0x06
194 #define GET_HW_VERSION_COMMAND 0x07
195 #define BLANK 0xff
197 /* bootloader command responses */
198 #define COMMAND_OK 0x01
199 #define COMMAND_FAILED 0x02
200 #define COMMAND_PENDING 0x03
204 /**************************************************************************
205 * General Driver Functions - REGISTER_REPORTs
206 **************************************************************************/
209 * si470x_get_report - receive a HID report
211 static int si470x_get_report(struct si470x_device *radio, void *buf, int size)
213 unsigned char *report = buf;
214 int retval;
216 retval = usb_control_msg(radio->usbdev,
217 usb_rcvctrlpipe(radio->usbdev, 0),
218 HID_REQ_GET_REPORT,
219 USB_TYPE_CLASS | USB_RECIP_INTERFACE | USB_DIR_IN,
220 report[0], 2,
221 buf, size, usb_timeout);
223 if (retval < 0)
224 dev_warn(&radio->intf->dev,
225 "si470x_get_report: usb_control_msg returned %d\n",
226 retval);
227 return retval;
232 * si470x_set_report - send a HID report
234 static int si470x_set_report(struct si470x_device *radio, void *buf, int size)
236 unsigned char *report = buf;
237 int retval;
239 retval = usb_control_msg(radio->usbdev,
240 usb_sndctrlpipe(radio->usbdev, 0),
241 HID_REQ_SET_REPORT,
242 USB_TYPE_CLASS | USB_RECIP_INTERFACE | USB_DIR_OUT,
243 report[0], 2,
244 buf, size, usb_timeout);
246 if (retval < 0)
247 dev_warn(&radio->intf->dev,
248 "si470x_set_report: usb_control_msg returned %d\n",
249 retval);
250 return retval;
255 * si470x_get_register - read register
257 int si470x_get_register(struct si470x_device *radio, int regnr)
259 int retval;
261 radio->usb_buf[0] = REGISTER_REPORT(regnr);
263 retval = si470x_get_report(radio, radio->usb_buf, REGISTER_REPORT_SIZE);
265 if (retval >= 0)
266 radio->registers[regnr] = get_unaligned_be16(&radio->usb_buf[1]);
268 return (retval < 0) ? -EINVAL : 0;
273 * si470x_set_register - write register
275 int si470x_set_register(struct si470x_device *radio, int regnr)
277 int retval;
279 radio->usb_buf[0] = REGISTER_REPORT(regnr);
280 put_unaligned_be16(radio->registers[regnr], &radio->usb_buf[1]);
282 retval = si470x_set_report(radio, radio->usb_buf, REGISTER_REPORT_SIZE);
284 return (retval < 0) ? -EINVAL : 0;
289 /**************************************************************************
290 * General Driver Functions - ENTIRE_REPORT
291 **************************************************************************/
294 * si470x_get_all_registers - read entire registers
296 static int si470x_get_all_registers(struct si470x_device *radio)
298 int retval;
299 unsigned char regnr;
301 radio->usb_buf[0] = ENTIRE_REPORT;
303 retval = si470x_get_report(radio, radio->usb_buf, ENTIRE_REPORT_SIZE);
305 if (retval >= 0)
306 for (regnr = 0; regnr < RADIO_REGISTER_NUM; regnr++)
307 radio->registers[regnr] = get_unaligned_be16(
308 &radio->usb_buf[regnr * RADIO_REGISTER_SIZE + 1]);
310 return (retval < 0) ? -EINVAL : 0;
315 /**************************************************************************
316 * General Driver Functions - LED_REPORT
317 **************************************************************************/
320 * si470x_set_led_state - sets the led state
322 static int si470x_set_led_state(struct si470x_device *radio,
323 unsigned char led_state)
325 int retval;
327 radio->usb_buf[0] = LED_REPORT;
328 radio->usb_buf[1] = LED_COMMAND;
329 radio->usb_buf[2] = led_state;
331 retval = si470x_set_report(radio, radio->usb_buf, LED_REPORT_SIZE);
333 return (retval < 0) ? -EINVAL : 0;
338 /**************************************************************************
339 * General Driver Functions - SCRATCH_REPORT
340 **************************************************************************/
343 * si470x_get_scratch_versions - gets the scratch page and version infos
345 static int si470x_get_scratch_page_versions(struct si470x_device *radio)
347 int retval;
349 radio->usb_buf[0] = SCRATCH_REPORT;
351 retval = si470x_get_report(radio, radio->usb_buf, SCRATCH_REPORT_SIZE);
353 if (retval < 0)
354 dev_warn(&radio->intf->dev, "si470x_get_scratch: si470x_get_report returned %d\n",
355 retval);
356 else {
357 radio->software_version = radio->usb_buf[1];
358 radio->hardware_version = radio->usb_buf[2];
361 return (retval < 0) ? -EINVAL : 0;
366 /**************************************************************************
367 * RDS Driver Functions
368 **************************************************************************/
371 * si470x_int_in_callback - rds callback and processing function
373 * TODO: do we need to use mutex locks in some sections?
375 static void si470x_int_in_callback(struct urb *urb)
377 struct si470x_device *radio = urb->context;
378 int retval;
379 unsigned char regnr;
380 unsigned char blocknum;
381 unsigned short bler; /* rds block errors */
382 unsigned short rds;
383 unsigned char tmpbuf[3];
385 if (urb->status) {
386 if (urb->status == -ENOENT ||
387 urb->status == -ECONNRESET ||
388 urb->status == -ESHUTDOWN) {
389 return;
390 } else {
391 dev_warn(&radio->intf->dev,
392 "non-zero urb status (%d)\n", urb->status);
393 goto resubmit; /* Maybe we can recover. */
397 /* Sometimes the device returns len 0 packets */
398 if (urb->actual_length != RDS_REPORT_SIZE)
399 goto resubmit;
401 radio->registers[STATUSRSSI] =
402 get_unaligned_be16(&radio->int_in_buffer[1]);
404 if (radio->registers[STATUSRSSI] & STATUSRSSI_STC)
405 complete(&radio->completion);
407 if ((radio->registers[SYSCONFIG1] & SYSCONFIG1_RDS)) {
408 /* Update RDS registers with URB data */
409 for (regnr = 1; regnr < RDS_REGISTER_NUM; regnr++)
410 radio->registers[STATUSRSSI + regnr] =
411 get_unaligned_be16(&radio->int_in_buffer[
412 regnr * RADIO_REGISTER_SIZE + 1]);
413 /* get rds blocks */
414 if ((radio->registers[STATUSRSSI] & STATUSRSSI_RDSR) == 0) {
415 /* No RDS group ready, better luck next time */
416 goto resubmit;
418 if ((radio->registers[STATUSRSSI] & STATUSRSSI_RDSS) == 0) {
419 /* RDS decoder not synchronized */
420 goto resubmit;
422 for (blocknum = 0; blocknum < 4; blocknum++) {
423 switch (blocknum) {
424 default:
425 bler = (radio->registers[STATUSRSSI] &
426 STATUSRSSI_BLERA) >> 9;
427 rds = radio->registers[RDSA];
428 break;
429 case 1:
430 bler = (radio->registers[READCHAN] &
431 READCHAN_BLERB) >> 14;
432 rds = radio->registers[RDSB];
433 break;
434 case 2:
435 bler = (radio->registers[READCHAN] &
436 READCHAN_BLERC) >> 12;
437 rds = radio->registers[RDSC];
438 break;
439 case 3:
440 bler = (radio->registers[READCHAN] &
441 READCHAN_BLERD) >> 10;
442 rds = radio->registers[RDSD];
443 break;
446 /* Fill the V4L2 RDS buffer */
447 put_unaligned_le16(rds, &tmpbuf);
448 tmpbuf[2] = blocknum; /* offset name */
449 tmpbuf[2] |= blocknum << 3; /* received offset */
450 if (bler > max_rds_errors)
451 tmpbuf[2] |= 0x80; /* uncorrectable errors */
452 else if (bler > 0)
453 tmpbuf[2] |= 0x40; /* corrected error(s) */
455 /* copy RDS block to internal buffer */
456 memcpy(&radio->buffer[radio->wr_index], &tmpbuf, 3);
457 radio->wr_index += 3;
459 /* wrap write pointer */
460 if (radio->wr_index >= radio->buf_size)
461 radio->wr_index = 0;
463 /* check for overflow */
464 if (radio->wr_index == radio->rd_index) {
465 /* increment and wrap read pointer */
466 radio->rd_index += 3;
467 if (radio->rd_index >= radio->buf_size)
468 radio->rd_index = 0;
471 if (radio->wr_index != radio->rd_index)
472 wake_up_interruptible(&radio->read_queue);
475 resubmit:
476 /* Resubmit if we're still running. */
477 if (radio->int_in_running && radio->usbdev) {
478 retval = usb_submit_urb(radio->int_in_urb, GFP_ATOMIC);
479 if (retval) {
480 dev_warn(&radio->intf->dev,
481 "resubmitting urb failed (%d)", retval);
482 radio->int_in_running = 0;
485 radio->status_rssi_auto_update = radio->int_in_running;
489 int si470x_fops_open(struct file *file)
491 return v4l2_fh_open(file);
494 int si470x_fops_release(struct file *file)
496 return v4l2_fh_release(file);
499 static void si470x_usb_release(struct v4l2_device *v4l2_dev)
501 struct si470x_device *radio =
502 container_of(v4l2_dev, struct si470x_device, v4l2_dev);
504 usb_free_urb(radio->int_in_urb);
505 v4l2_ctrl_handler_free(&radio->hdl);
506 v4l2_device_unregister(&radio->v4l2_dev);
507 kfree(radio->int_in_buffer);
508 kfree(radio->buffer);
509 kfree(radio->usb_buf);
510 kfree(radio);
514 /**************************************************************************
515 * Video4Linux Interface
516 **************************************************************************/
519 * si470x_vidioc_querycap - query device capabilities
521 int si470x_vidioc_querycap(struct file *file, void *priv,
522 struct v4l2_capability *capability)
524 struct si470x_device *radio = video_drvdata(file);
526 strlcpy(capability->driver, DRIVER_NAME, sizeof(capability->driver));
527 strlcpy(capability->card, DRIVER_CARD, sizeof(capability->card));
528 usb_make_path(radio->usbdev, capability->bus_info,
529 sizeof(capability->bus_info));
530 capability->device_caps = V4L2_CAP_HW_FREQ_SEEK | V4L2_CAP_READWRITE |
531 V4L2_CAP_TUNER | V4L2_CAP_RADIO | V4L2_CAP_RDS_CAPTURE;
532 capability->capabilities = capability->device_caps | V4L2_CAP_DEVICE_CAPS;
533 return 0;
537 static int si470x_start_usb(struct si470x_device *radio)
539 int retval;
541 /* initialize interrupt urb */
542 usb_fill_int_urb(radio->int_in_urb, radio->usbdev,
543 usb_rcvintpipe(radio->usbdev,
544 radio->int_in_endpoint->bEndpointAddress),
545 radio->int_in_buffer,
546 le16_to_cpu(radio->int_in_endpoint->wMaxPacketSize),
547 si470x_int_in_callback,
548 radio,
549 radio->int_in_endpoint->bInterval);
551 radio->int_in_running = 1;
552 mb();
554 retval = usb_submit_urb(radio->int_in_urb, GFP_KERNEL);
555 if (retval) {
556 dev_info(&radio->intf->dev,
557 "submitting int urb failed (%d)\n", retval);
558 radio->int_in_running = 0;
560 radio->status_rssi_auto_update = radio->int_in_running;
562 /* start radio */
563 retval = si470x_start(radio);
564 if (retval < 0)
565 return retval;
567 v4l2_ctrl_handler_setup(&radio->hdl);
569 return retval;
572 /**************************************************************************
573 * USB Interface
574 **************************************************************************/
577 * si470x_usb_driver_probe - probe for the device
579 static int si470x_usb_driver_probe(struct usb_interface *intf,
580 const struct usb_device_id *id)
582 struct si470x_device *radio;
583 struct usb_host_interface *iface_desc;
584 struct usb_endpoint_descriptor *endpoint;
585 int i, int_end_size, retval = 0;
586 unsigned char version_warning = 0;
588 /* private data allocation and initialization */
589 radio = kzalloc(sizeof(struct si470x_device), GFP_KERNEL);
590 if (!radio) {
591 retval = -ENOMEM;
592 goto err_initial;
594 radio->usb_buf = kmalloc(MAX_REPORT_SIZE, GFP_KERNEL);
595 if (radio->usb_buf == NULL) {
596 retval = -ENOMEM;
597 goto err_radio;
599 radio->usbdev = interface_to_usbdev(intf);
600 radio->intf = intf;
601 radio->band = 1; /* Default to 76 - 108 MHz */
602 mutex_init(&radio->lock);
603 init_completion(&radio->completion);
605 iface_desc = intf->cur_altsetting;
607 /* Set up interrupt endpoint information. */
608 for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i) {
609 endpoint = &iface_desc->endpoint[i].desc;
610 if (usb_endpoint_is_int_in(endpoint))
611 radio->int_in_endpoint = endpoint;
613 if (!radio->int_in_endpoint) {
614 dev_info(&intf->dev, "could not find interrupt in endpoint\n");
615 retval = -EIO;
616 goto err_usbbuf;
619 int_end_size = le16_to_cpu(radio->int_in_endpoint->wMaxPacketSize);
621 radio->int_in_buffer = kmalloc(int_end_size, GFP_KERNEL);
622 if (!radio->int_in_buffer) {
623 dev_info(&intf->dev, "could not allocate int_in_buffer");
624 retval = -ENOMEM;
625 goto err_usbbuf;
628 radio->int_in_urb = usb_alloc_urb(0, GFP_KERNEL);
629 if (!radio->int_in_urb) {
630 retval = -ENOMEM;
631 goto err_intbuffer;
634 radio->v4l2_dev.release = si470x_usb_release;
637 * The si470x SiLabs reference design uses the same USB IDs as
638 * 'Thanko's Raremono' si4734 based receiver. So check here which we
639 * have: attempt to read the device ID from the si470x: the lower 12
640 * bits should be 0x0242 for the si470x.
642 * We use this check to determine which device we are dealing with.
644 if (id->idVendor == 0x10c4 && id->idProduct == 0x818a) {
645 retval = usb_control_msg(radio->usbdev,
646 usb_rcvctrlpipe(radio->usbdev, 0),
647 HID_REQ_GET_REPORT,
648 USB_TYPE_CLASS | USB_RECIP_INTERFACE | USB_DIR_IN,
649 1, 2,
650 radio->usb_buf, 3, 500);
651 if (retval != 3 ||
652 (get_unaligned_be16(&radio->usb_buf[1]) & 0xfff) != 0x0242) {
653 dev_info(&intf->dev, "this is not a si470x device.\n");
654 retval = -ENODEV;
655 goto err_urb;
659 retval = v4l2_device_register(&intf->dev, &radio->v4l2_dev);
660 if (retval < 0) {
661 dev_err(&intf->dev, "couldn't register v4l2_device\n");
662 goto err_urb;
665 v4l2_ctrl_handler_init(&radio->hdl, 2);
666 v4l2_ctrl_new_std(&radio->hdl, &si470x_ctrl_ops,
667 V4L2_CID_AUDIO_MUTE, 0, 1, 1, 1);
668 v4l2_ctrl_new_std(&radio->hdl, &si470x_ctrl_ops,
669 V4L2_CID_AUDIO_VOLUME, 0, 15, 1, 15);
670 if (radio->hdl.error) {
671 retval = radio->hdl.error;
672 dev_err(&intf->dev, "couldn't register control\n");
673 goto err_dev;
675 radio->videodev = si470x_viddev_template;
676 radio->videodev.ctrl_handler = &radio->hdl;
677 radio->videodev.lock = &radio->lock;
678 radio->videodev.v4l2_dev = &radio->v4l2_dev;
679 radio->videodev.release = video_device_release_empty;
680 video_set_drvdata(&radio->videodev, radio);
682 /* get device and chip versions */
683 if (si470x_get_all_registers(radio) < 0) {
684 retval = -EIO;
685 goto err_ctrl;
687 dev_info(&intf->dev, "DeviceID=0x%4.4hx ChipID=0x%4.4hx\n",
688 radio->registers[DEVICEID], radio->registers[SI_CHIPID]);
689 if ((radio->registers[SI_CHIPID] & SI_CHIPID_FIRMWARE) < RADIO_FW_VERSION) {
690 dev_warn(&intf->dev,
691 "This driver is known to work with firmware version %hu,\n",
692 RADIO_FW_VERSION);
693 dev_warn(&intf->dev,
694 "but the device has firmware version %hu.\n",
695 radio->registers[SI_CHIPID] & SI_CHIPID_FIRMWARE);
696 version_warning = 1;
699 /* get software and hardware versions */
700 if (si470x_get_scratch_page_versions(radio) < 0) {
701 retval = -EIO;
702 goto err_ctrl;
704 dev_info(&intf->dev, "software version %d, hardware version %d\n",
705 radio->software_version, radio->hardware_version);
706 if (radio->hardware_version < RADIO_HW_VERSION) {
707 dev_warn(&intf->dev,
708 "This driver is known to work with hardware version %hu,\n",
709 RADIO_HW_VERSION);
710 dev_warn(&intf->dev,
711 "but the device has hardware version %hu.\n",
712 radio->hardware_version);
713 version_warning = 1;
716 /* give out version warning */
717 if (version_warning == 1) {
718 dev_warn(&intf->dev,
719 "If you have some trouble using this driver,\n");
720 dev_warn(&intf->dev,
721 "please report to V4L ML at linux-media@vger.kernel.org\n");
724 /* set led to connect state */
725 si470x_set_led_state(radio, BLINK_GREEN_LED);
727 /* rds buffer allocation */
728 radio->buf_size = rds_buf * 3;
729 radio->buffer = kmalloc(radio->buf_size, GFP_KERNEL);
730 if (!radio->buffer) {
731 retval = -EIO;
732 goto err_ctrl;
735 /* rds buffer configuration */
736 radio->wr_index = 0;
737 radio->rd_index = 0;
738 init_waitqueue_head(&radio->read_queue);
739 usb_set_intfdata(intf, radio);
741 /* start radio */
742 retval = si470x_start_usb(radio);
743 if (retval < 0)
744 goto err_all;
746 /* set initial frequency */
747 si470x_set_freq(radio, 87.5 * FREQ_MUL); /* available in all regions */
749 /* register video device */
750 retval = video_register_device(&radio->videodev, VFL_TYPE_RADIO,
751 radio_nr);
752 if (retval) {
753 dev_err(&intf->dev, "Could not register video device\n");
754 goto err_all;
757 return 0;
758 err_all:
759 kfree(radio->buffer);
760 err_ctrl:
761 v4l2_ctrl_handler_free(&radio->hdl);
762 err_dev:
763 v4l2_device_unregister(&radio->v4l2_dev);
764 err_urb:
765 usb_free_urb(radio->int_in_urb);
766 err_intbuffer:
767 kfree(radio->int_in_buffer);
768 err_usbbuf:
769 kfree(radio->usb_buf);
770 err_radio:
771 kfree(radio);
772 err_initial:
773 return retval;
778 * si470x_usb_driver_suspend - suspend the device
780 static int si470x_usb_driver_suspend(struct usb_interface *intf,
781 pm_message_t message)
783 struct si470x_device *radio = usb_get_intfdata(intf);
785 dev_info(&intf->dev, "suspending now...\n");
787 /* shutdown interrupt handler */
788 if (radio->int_in_running) {
789 radio->int_in_running = 0;
790 if (radio->int_in_urb)
791 usb_kill_urb(radio->int_in_urb);
794 /* cancel read processes */
795 wake_up_interruptible(&radio->read_queue);
797 /* stop radio */
798 si470x_stop(radio);
799 return 0;
804 * si470x_usb_driver_resume - resume the device
806 static int si470x_usb_driver_resume(struct usb_interface *intf)
808 struct si470x_device *radio = usb_get_intfdata(intf);
809 int ret;
811 dev_info(&intf->dev, "resuming now...\n");
813 /* start radio */
814 ret = si470x_start_usb(radio);
815 if (ret == 0)
816 v4l2_ctrl_handler_setup(&radio->hdl);
818 return ret;
823 * si470x_usb_driver_disconnect - disconnect the device
825 static void si470x_usb_driver_disconnect(struct usb_interface *intf)
827 struct si470x_device *radio = usb_get_intfdata(intf);
829 mutex_lock(&radio->lock);
830 v4l2_device_disconnect(&radio->v4l2_dev);
831 video_unregister_device(&radio->videodev);
832 usb_set_intfdata(intf, NULL);
833 mutex_unlock(&radio->lock);
834 v4l2_device_put(&radio->v4l2_dev);
839 * si470x_usb_driver - usb driver interface
841 * A note on suspend/resume: this driver had only empty suspend/resume
842 * functions, and when I tried to test suspend/resume it always disconnected
843 * instead of resuming (using my ADS InstantFM stick). So I've decided to
844 * remove these callbacks until someone else with better hardware can
845 * implement and test this.
847 static struct usb_driver si470x_usb_driver = {
848 .name = DRIVER_NAME,
849 .probe = si470x_usb_driver_probe,
850 .disconnect = si470x_usb_driver_disconnect,
851 .suspend = si470x_usb_driver_suspend,
852 .resume = si470x_usb_driver_resume,
853 .reset_resume = si470x_usb_driver_resume,
854 .id_table = si470x_usb_driver_id_table,
857 module_usb_driver(si470x_usb_driver);
859 MODULE_LICENSE("GPL");
860 MODULE_AUTHOR(DRIVER_AUTHOR);
861 MODULE_DESCRIPTION(DRIVER_DESC);
862 MODULE_VERSION(DRIVER_VERSION);