1 /* A driver for the D-Link DSB-R100 USB radio. The R100 plugs 2 into both the USB and an analog audio input, so this thing 3 only deals with initialisation and frequency setting, the 4 audio data has to be handled by a sound driver. 5 6 Major issue: I can't find out where the device reports the signal 7 strength, and indeed the windows software appearantly just looks 8 at the stereo indicator as well. So, scanning will only find 9 stereo stations. Sad, but I can't help it. 10 11 Also, the windows program sends oodles of messages over to the 12 device, and I couldn't figure out their meaning. My suspicion 13 is that they don't have any:-) 14 15 You might find some interesting stuff about this module at 16 http://unimut.fsk.uni-heidelberg.de/unimut/demi/dsbr 17 18 Copyright (c) 2000 Markus Demleitner <msdemlei@cl.uni-heidelberg.de> 19 20 This program is free software; you can redistribute it and/or modify 21 it under the terms of the GNU General Public License as published by 22 the Free Software Foundation; either version 2 of the License, or 23 (at your option) any later version. 24 25 This program is distributed in the hope that it will be useful, 26 but WITHOUT ANY WARRANTY; without even the implied warranty of 27 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 28 GNU General Public License for more details. 29 30 You should have received a copy of the GNU General Public License 31 along with this program; if not, write to the Free Software 32 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA 33 34 History: 35 36 Version 0.43: 37 Oliver Neukum: avoided DMA coherency issue 38 39 Version 0.42: 40 Converted dsbr100 to use video_ioctl2 41 by Douglas Landgraf <dougsland@gmail.com> 42 43 Version 0.41-ac1: 44 Alan Cox: Some cleanups and fixes 45 46 Version 0.41: 47 Converted to V4L2 API by Mauro Carvalho Chehab <mchehab@infradead.org> 48 49 Version 0.40: 50 Markus: Updates for 2.6.x kernels, code layout changes, name sanitizing 51 52 Version 0.30: 53 Markus: Updates for 2.5.x kernel and more ISO compliant source 54 55 Version 0.25: 56 PSL and Markus: Cleanup, radio now doesn't stop on device close 57 58 Version 0.24: 59 Markus: Hope I got these silly VIDEO_TUNER_LOW issues finally 60 right. Some minor cleanup, improved standalone compilation 61 62 Version 0.23: 63 Markus: Sign extension bug fixed by declaring transfer_buffer unsigned 64 65 Version 0.22: 66 Markus: Some (brown bag) cleanup in what VIDIOCSTUNER returns, 67 thanks to Mike Cox for pointing the problem out. 68 69 Version 0.21: 70 Markus: Minor cleanup, warnings if something goes wrong, lame attempt 71 to adhere to Documentation/CodingStyle 72 73 Version 0.2: 74 Brad Hards <bradh@dynamite.com.au>: Fixes to make it work as non-module 75 Markus: Copyright clarification 76 77 Version 0.01: Markus: initial release 78 79 */ 80 81 #include <linux/kernel.h> 82 #include <linux/module.h> 83 #include <linux/init.h> 84 #include <linux/slab.h> 85 #include <linux/input.h> 86 #include <linux/videodev2.h> 87 #include <media/v4l2-common.h> 88 #include <media/v4l2-ioctl.h> 89 #include <linux/usb.h> 90 91 /* 92 * Version Information 93 */ 94 #include <linux/version.h> /* for KERNEL_VERSION MACRO */ 95 96 #define DRIVER_VERSION "v0.41" 97 #define RADIO_VERSION KERNEL_VERSION(0,4,1) 98 99 static struct v4l2_queryctrl radio_qctrl[] = { 100 { 101 .id = V4L2_CID_AUDIO_MUTE, 102 .name = "Mute", 103 .minimum = 0, 104 .maximum = 1, 105 .default_value = 1, 106 .type = V4L2_CTRL_TYPE_BOOLEAN, 107 } 108 }; 109 110 #define DRIVER_AUTHOR "Markus Demleitner <msdemlei@tucana.harvard.edu>" 111 #define DRIVER_DESC "D-Link DSB-R100 USB FM radio driver" 112 113 #define DSB100_VENDOR 0x04b4 114 #define DSB100_PRODUCT 0x1002 115 116 /* Commands the device appears to understand */ 117 #define DSB100_TUNE 1 118 #define DSB100_ONOFF 2 119 120 #define TB_LEN 16 121 122 /* Frequency limits in MHz -- these are European values. For Japanese 123 devices, that would be 76 and 91. */ 124 #define FREQ_MIN 87.5 125 #define FREQ_MAX 108.0 126 #define FREQ_MUL 16000 127 128 129 static int usb_dsbr100_probe(struct usb_interface *intf, 130 const struct usb_device_id *id); 131 static void usb_dsbr100_disconnect(struct usb_interface *intf); 132 static int usb_dsbr100_open(struct inode *inode, struct file *file); 133 static int usb_dsbr100_close(struct inode *inode, struct file *file); 134 135 static int radio_nr = -1; 136 module_param(radio_nr, int, 0); 137 138 /* Data for one (physical) device */ 139 struct dsbr100_device { 140 struct usb_device *usbdev; 141 struct video_device *videodev; 142 u8 *transfer_buffer; 143 int curfreq; 144 int stereo; 145 int users; 146 int removed; 147 int muted; 148 }; 149 150 151 static struct usb_device_id usb_dsbr100_device_table [] = { 152 { USB_DEVICE(DSB100_VENDOR, DSB100_PRODUCT) }, 153 { } /* Terminating entry */ 154 }; 155 156 MODULE_DEVICE_TABLE (usb, usb_dsbr100_device_table); 157 158 /* USB subsystem interface */ 159 static struct usb_driver usb_dsbr100_driver = { 160 .name = "dsbr100", 161 .probe = usb_dsbr100_probe, 162 .disconnect = usb_dsbr100_disconnect, 163 .id_table = usb_dsbr100_device_table, 164 }; 165 166 /* Low-level device interface begins here */ 167 168 /* switch on radio */ 169 static int dsbr100_start(struct dsbr100_device *radio) 170 { 171 if (usb_control_msg(radio->usbdev, usb_rcvctrlpipe(radio->usbdev, 0), 172 USB_REQ_GET_STATUS, 173 USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, 174 0x00, 0xC7, radio->transfer_buffer, 8, 300) < 0 || 175 usb_control_msg(radio->usbdev, usb_rcvctrlpipe(radio->usbdev, 0), 176 DSB100_ONOFF, 177 USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, 178 0x01, 0x00, radio->transfer_buffer, 8, 300) < 0) 179 return -1; 180 radio->muted=0; 181 return (radio->transfer_buffer)[0]; 182 } 183 184 185 /* switch off radio */ 186 static int dsbr100_stop(struct dsbr100_device *radio) 187 { 188 if (usb_control_msg(radio->usbdev, usb_rcvctrlpipe(radio->usbdev, 0), 189 USB_REQ_GET_STATUS, 190 USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, 191 0x16, 0x1C, radio->transfer_buffer, 8, 300) < 0 || 192 usb_control_msg(radio->usbdev, usb_rcvctrlpipe(radio->usbdev, 0), 193 DSB100_ONOFF, 194 USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, 195 0x00, 0x00, radio->transfer_buffer, 8, 300) < 0) 196 return -1; 197 radio->muted=1; 198 return (radio->transfer_buffer)[0]; 199 } 200 201 /* set a frequency, freq is defined by v4l's TUNER_LOW, i.e. 1/16th kHz */ 202 static int dsbr100_setfreq(struct dsbr100_device *radio, int freq) 203 { 204 freq = (freq / 16 * 80) / 1000 + 856; 205 if (usb_control_msg(radio->usbdev, usb_rcvctrlpipe(radio->usbdev, 0), 206 DSB100_TUNE, 207 USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, 208 (freq >> 8) & 0x00ff, freq & 0xff, 209 radio->transfer_buffer, 8, 300) < 0 || 210 usb_control_msg(radio->usbdev, usb_rcvctrlpipe(radio->usbdev, 0), 211 USB_REQ_GET_STATUS, 212 USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, 213 0x96, 0xB7, radio->transfer_buffer, 8, 300) < 0 || 214 usb_control_msg(radio->usbdev, usb_rcvctrlpipe(radio->usbdev, 0), 215 USB_REQ_GET_STATUS, 216 USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, 217 0x00, 0x24, radio->transfer_buffer, 8, 300) < 0) { 218 radio->stereo = -1; 219 return -1; 220 } 221 radio->stereo = !((radio->transfer_buffer)[0] & 0x01); 222 return (radio->transfer_buffer)[0]; 223 } 224 225 /* return the device status. This is, in effect, just whether it 226 sees a stereo signal or not. Pity. */ 227 static void dsbr100_getstat(struct dsbr100_device *radio) 228 { 229 if (usb_control_msg(radio->usbdev, usb_rcvctrlpipe(radio->usbdev, 0), 230 USB_REQ_GET_STATUS, 231 USB_TYPE_VENDOR | USB_RECIP_DEVICE | USB_DIR_IN, 232 0x00 , 0x24, radio->transfer_buffer, 8, 300) < 0) 233 radio->stereo = -1; 234 else 235 radio->stereo = !(radio->transfer_buffer[0] & 0x01); 236 } 237 238 239 /* USB subsystem interface begins here */ 240 241 /* handle unplugging of the device, release data structures 242 if nothing keeps us from doing it. If something is still 243 keeping us busy, the release callback of v4l will take care 244 of releasing it. */ 245 static void usb_dsbr100_disconnect(struct usb_interface *intf) 246 { 247 struct dsbr100_device *radio = usb_get_intfdata(intf); 248 249 usb_set_intfdata (intf, NULL); 250 if (radio) { 251 video_unregister_device(radio->videodev); 252 radio->videodev = NULL; 253 if (radio->users) { 254 kfree(radio->transfer_buffer); 255 kfree(radio); 256 } else { 257 radio->removed = 1; 258 } 259 } 260 } 261 262 263 static int vidioc_querycap(struct file *file, void *priv, 264 struct v4l2_capability *v) 265 { 266 strlcpy(v->driver, "dsbr100", sizeof(v->driver)); 267 strlcpy(v->card, "D-Link R-100 USB FM Radio", sizeof(v->card)); 268 sprintf(v->bus_info, "USB"); 269 v->version = RADIO_VERSION; 270 v->capabilities = V4L2_CAP_TUNER; 271 return 0; 272 } 273 274 static int vidioc_g_tuner(struct file *file, void *priv, 275 struct v4l2_tuner *v) 276 { 277 struct dsbr100_device *radio = video_drvdata(file); 278 279 if (v->index > 0) 280 return -EINVAL; 281 282 dsbr100_getstat(radio); 283 strcpy(v->name, "FM"); 284 v->type = V4L2_TUNER_RADIO; 285 v->rangelow = FREQ_MIN * FREQ_MUL; 286 v->rangehigh = FREQ_MAX * FREQ_MUL; 287 v->rxsubchans = V4L2_TUNER_SUB_MONO | V4L2_TUNER_SUB_STEREO; 288 v->capability = V4L2_TUNER_CAP_LOW; 289 if(radio->stereo) 290 v->audmode = V4L2_TUNER_MODE_STEREO; 291 else 292 v->audmode = V4L2_TUNER_MODE_MONO; 293 v->signal = 0xffff; /* We can't get the signal strength */ 294 return 0; 295 } 296 297 static int vidioc_s_tuner(struct file *file, void *priv, 298 struct v4l2_tuner *v) 299 { 300 if (v->index > 0) 301 return -EINVAL; 302 303 return 0; 304 } 305 306 static int vidioc_s_frequency(struct file *file, void *priv, 307 struct v4l2_frequency *f) 308 { 309 struct dsbr100_device *radio = video_drvdata(file); 310 311 radio->curfreq = f->frequency; 312 if (dsbr100_setfreq(radio, radio->curfreq) == -1) 313 dev_warn(&radio->usbdev->dev, "Set frequency failed\n"); 314 return 0; 315 } 316 317 static int vidioc_g_frequency(struct file *file, void *priv, 318 struct v4l2_frequency *f) 319 { 320 struct dsbr100_device *radio = video_drvdata(file); 321 322 f->type = V4L2_TUNER_RADIO; 323 f->frequency = radio->curfreq; 324 return 0; 325 } 326 327 static int vidioc_queryctrl(struct file *file, void *priv, 328 struct v4l2_queryctrl *qc) 329 { 330 int i; 331 332 for (i = 0; i < ARRAY_SIZE(radio_qctrl); i++) { 333 if (qc->id && qc->id == radio_qctrl[i].id) { 334 memcpy(qc, &(radio_qctrl[i]), sizeof(*qc)); 335 return 0; 336 } 337 } 338 return -EINVAL; 339 } 340 341 static int vidioc_g_ctrl(struct file *file, void *priv, 342 struct v4l2_control *ctrl) 343 { 344 struct dsbr100_device *radio = video_drvdata(file); 345 346 switch (ctrl->id) { 347 case V4L2_CID_AUDIO_MUTE: 348 ctrl->value = radio->muted; 349 return 0; 350 } 351 return -EINVAL; 352 } 353 354 static int vidioc_s_ctrl(struct file *file, void *priv, 355 struct v4l2_control *ctrl) 356 { 357 struct dsbr100_device *radio = video_drvdata(file); 358 359 switch (ctrl->id) { 360 case V4L2_CID_AUDIO_MUTE: 361 if (ctrl->value) { 362 if (dsbr100_stop(radio) == -1) { 363 dev_warn(&radio->usbdev->dev, 364 "Radio did not respond properly\n"); 365 return -EBUSY; 366 } 367 } else { 368 if (dsbr100_start(radio) == -1) { 369 dev_warn(&radio->usbdev->dev, 370 "Radio did not respond properly\n"); 371 return -EBUSY; 372 } 373 } 374 return 0; 375 } 376 return -EINVAL; 377 } 378 379 static int vidioc_g_audio(struct file *file, void *priv, 380 struct v4l2_audio *a) 381 { 382 if (a->index > 1) 383 return -EINVAL; 384 385 strcpy(a->name, "Radio"); 386 a->capability = V4L2_AUDCAP_STEREO; 387 return 0; 388 } 389 390 static int vidioc_g_input(struct file *filp, void *priv, unsigned int *i) 391 { 392 *i = 0; 393 return 0; 394 } 395 396 static int vidioc_s_input(struct file *filp, void *priv, unsigned int i) 397 { 398 if (i != 0) 399 return -EINVAL; 400 return 0; 401 } 402 403 static int vidioc_s_audio(struct file *file, void *priv, 404 struct v4l2_audio *a) 405 { 406 if (a->index != 0) 407 return -EINVAL; 408 return 0; 409 } 410 411 static int usb_dsbr100_open(struct inode *inode, struct file *file) 412 { 413 struct dsbr100_device *radio = video_drvdata(file); 414 int retval; 415 416 lock_kernel(); 417 radio->users = 1; 418 radio->muted = 1; 419 420 if (dsbr100_start(radio) < 0) { 421 dev_warn(&radio->usbdev->dev, 422 "Radio did not start up properly\n"); 423 radio->users = 0; 424 unlock_kernel(); 425 return -EIO; 426 } 427 428 retval = dsbr100_setfreq(radio, radio->curfreq); 429 430 if (retval == -1) 431 printk(KERN_WARNING KBUILD_MODNAME ": Set frequency failed\n"); 432 433 unlock_kernel(); 434 return 0; 435 } 436 437 static int usb_dsbr100_close(struct inode *inode, struct file *file) 438 { 439 struct dsbr100_device *radio = video_drvdata(file); 440 441 if (!radio) 442 return -ENODEV; 443 radio->users = 0; 444 if (radio->removed) { 445 kfree(radio->transfer_buffer); 446 kfree(radio); 447 } 448 return 0; 449 } 450 451 /* File system interface */ 452 static const struct file_operations usb_dsbr100_fops = { 453 .owner = THIS_MODULE, 454 .open = usb_dsbr100_open, 455 .release = usb_dsbr100_close, 456 .ioctl = video_ioctl2, 457 #ifdef CONFIG_COMPAT 458 .compat_ioctl = v4l_compat_ioctl32, 459 #endif 460 .llseek = no_llseek, 461 }; 462 463 static const struct v4l2_ioctl_ops usb_dsbr100_ioctl_ops = { 464 .vidioc_querycap = vidioc_querycap, 465 .vidioc_g_tuner = vidioc_g_tuner, 466 .vidioc_s_tuner = vidioc_s_tuner, 467 .vidioc_g_frequency = vidioc_g_frequency, 468 .vidioc_s_frequency = vidioc_s_frequency, 469 .vidioc_queryctrl = vidioc_queryctrl, 470 .vidioc_g_ctrl = vidioc_g_ctrl, 471 .vidioc_s_ctrl = vidioc_s_ctrl, 472 .vidioc_g_audio = vidioc_g_audio, 473 .vidioc_s_audio = vidioc_s_audio, 474 .vidioc_g_input = vidioc_g_input, 475 .vidioc_s_input = vidioc_s_input, 476 }; 477 478 /* V4L2 interface */ 479 static struct video_device dsbr100_videodev_template = { 480 .name = "D-Link DSB-R 100", 481 .fops = &usb_dsbr100_fops, 482 .ioctl_ops = &usb_dsbr100_ioctl_ops, 483 .release = video_device_release, 484 }; 485 486 /* check if the device is present and register with v4l and 487 usb if it is */ 488 static int usb_dsbr100_probe(struct usb_interface *intf, 489 const struct usb_device_id *id) 490 { 491 struct dsbr100_device *radio; 492 493 radio = kmalloc(sizeof(struct dsbr100_device), GFP_KERNEL); 494 495 if (!radio) 496 return -ENOMEM; 497 498 radio->transfer_buffer = kmalloc(TB_LEN, GFP_KERNEL); 499 500 if (!(radio->transfer_buffer)) { 501 kfree(radio); 502 return -ENOMEM; 503 } 504 radio->videodev = video_device_alloc(); 505 506 if (!(radio->videodev)) { 507 kfree(radio->transfer_buffer); 508 kfree(radio); 509 return -ENOMEM; 510 } 511 memcpy(radio->videodev, &dsbr100_videodev_template, 512 sizeof(dsbr100_videodev_template)); 513 radio->removed = 0; 514 radio->users = 0; 515 radio->usbdev = interface_to_usbdev(intf); 516 radio->curfreq = FREQ_MIN * FREQ_MUL; 517 video_set_drvdata(radio->videodev, radio); 518 if (video_register_device(radio->videodev, VFL_TYPE_RADIO, radio_nr) < 0) { 519 dev_warn(&intf->dev, "Could not register video device\n"); 520 video_device_release(radio->videodev); 521 kfree(radio->transfer_buffer); 522 kfree(radio); 523 return -EIO; 524 } 525 usb_set_intfdata(intf, radio); 526 return 0; 527 } 528 529 static int __init dsbr100_init(void) 530 { 531 int retval = usb_register(&usb_dsbr100_driver); 532 printk(KERN_INFO KBUILD_MODNAME ": " DRIVER_VERSION ":" 533 DRIVER_DESC "\n"); 534 return retval; 535 } 536 537 static void __exit dsbr100_exit(void) 538 { 539 usb_deregister(&usb_dsbr100_driver); 540 } 541 542 module_init (dsbr100_init); 543 module_exit (dsbr100_exit); 544 545 MODULE_AUTHOR( DRIVER_AUTHOR ); 546 MODULE_DESCRIPTION( DRIVER_DESC ); 547 MODULE_LICENSE("GPL"); 548