Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 1 | /* |
| 2 | * STK1160 driver |
| 3 | * |
| 4 | * Copyright (C) 2012 Ezequiel Garcia |
| 5 | * <elezegarcia--a.t--gmail.com> |
| 6 | * |
| 7 | * Based on Easycap driver by R.M. Thomas |
| 8 | * Copyright (C) 2010 R.M. Thomas |
| 9 | * <rmthomas--a.t--sciolus.org> |
| 10 | * |
| 11 | * This program is free software; you can redistribute it and/or modify |
| 12 | * it under the terms of the GNU General Public License as published by |
| 13 | * the Free Software Foundation; either version 2 of the License, or |
| 14 | * (at your option) any later version. |
| 15 | * |
| 16 | * This program is distributed in the hope that it will be useful, |
| 17 | * but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 18 | * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 19 | * GNU General Public License for more details. |
| 20 | * |
| 21 | * TODO: |
| 22 | * |
| 23 | * 1. (Try to) detect if we must register ac97 mixer |
| 24 | * 2. Support stream at lower speed: lower frame rate or lower frame size. |
| 25 | * |
| 26 | */ |
| 27 | |
| 28 | #include <linux/module.h> |
| 29 | #include <linux/init.h> |
| 30 | #include <linux/kernel.h> |
| 31 | #include <linux/errno.h> |
| 32 | #include <linux/slab.h> |
| 33 | |
| 34 | #include <linux/usb.h> |
| 35 | #include <linux/mm.h> |
| 36 | #include <linux/vmalloc.h> |
| 37 | #include <media/saa7115.h> |
| 38 | |
| 39 | #include "stk1160.h" |
| 40 | #include "stk1160-reg.h" |
| 41 | |
| 42 | static unsigned int input; |
| 43 | module_param(input, int, 0644); |
| 44 | MODULE_PARM_DESC(input, "Set default input"); |
| 45 | |
| 46 | MODULE_LICENSE("GPL"); |
| 47 | MODULE_AUTHOR("Ezequiel Garcia"); |
| 48 | MODULE_DESCRIPTION("STK1160 driver"); |
| 49 | |
| 50 | /* Devices supported by this driver */ |
| 51 | static struct usb_device_id stk1160_id_table[] = { |
| 52 | { USB_DEVICE(0x05e1, 0x0408) }, |
| 53 | { } |
| 54 | }; |
| 55 | MODULE_DEVICE_TABLE(usb, stk1160_id_table); |
| 56 | |
| 57 | /* saa7113 I2C address */ |
| 58 | static unsigned short saa7113_addrs[] = { |
| 59 | 0x4a >> 1, |
| 60 | I2C_CLIENT_END |
| 61 | }; |
| 62 | |
| 63 | /* |
| 64 | * Read/Write stk registers |
| 65 | */ |
| 66 | int stk1160_read_reg(struct stk1160 *dev, u16 reg, u8 *value) |
| 67 | { |
| 68 | int ret; |
| 69 | int pipe = usb_rcvctrlpipe(dev->udev, 0); |
Ezequiel Garcia | 85ac1a1 | 2014-04-17 09:28:20 -0300 | [diff] [blame] | 70 | u8 *buf; |
Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 71 | |
| 72 | *value = 0; |
Ezequiel Garcia | 85ac1a1 | 2014-04-17 09:28:20 -0300 | [diff] [blame] | 73 | |
| 74 | buf = kmalloc(sizeof(u8), GFP_KERNEL); |
| 75 | if (!buf) |
| 76 | return -ENOMEM; |
Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 77 | ret = usb_control_msg(dev->udev, pipe, 0x00, |
| 78 | USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE, |
Ezequiel Garcia | 85ac1a1 | 2014-04-17 09:28:20 -0300 | [diff] [blame] | 79 | 0x00, reg, buf, sizeof(u8), HZ); |
Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 80 | if (ret < 0) { |
| 81 | stk1160_err("read failed on reg 0x%x (%d)\n", |
| 82 | reg, ret); |
Ezequiel Garcia | 85ac1a1 | 2014-04-17 09:28:20 -0300 | [diff] [blame] | 83 | kfree(buf); |
Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 84 | return ret; |
| 85 | } |
| 86 | |
Ezequiel Garcia | 85ac1a1 | 2014-04-17 09:28:20 -0300 | [diff] [blame] | 87 | *value = *buf; |
| 88 | kfree(buf); |
Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 89 | return 0; |
| 90 | } |
| 91 | |
| 92 | int stk1160_write_reg(struct stk1160 *dev, u16 reg, u16 value) |
| 93 | { |
| 94 | int ret; |
| 95 | int pipe = usb_sndctrlpipe(dev->udev, 0); |
| 96 | |
| 97 | ret = usb_control_msg(dev->udev, pipe, 0x01, |
| 98 | USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE, |
| 99 | value, reg, NULL, 0, HZ); |
| 100 | if (ret < 0) { |
| 101 | stk1160_err("write failed on reg 0x%x (%d)\n", |
| 102 | reg, ret); |
| 103 | return ret; |
| 104 | } |
| 105 | |
| 106 | return 0; |
| 107 | } |
| 108 | |
| 109 | void stk1160_select_input(struct stk1160 *dev) |
| 110 | { |
Ezequiel Garcia | 56a960b | 2012-10-09 18:01:03 -0300 | [diff] [blame] | 111 | int route; |
Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 112 | static const u8 gctrl[] = { |
Ezequiel Garcia | 56a960b | 2012-10-09 18:01:03 -0300 | [diff] [blame] | 113 | 0x98, 0x90, 0x88, 0x80, 0x98 |
Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 114 | }; |
| 115 | |
Ezequiel Garcia | 56a960b | 2012-10-09 18:01:03 -0300 | [diff] [blame] | 116 | if (dev->ctl_input == STK1160_SVIDEO_INPUT) |
| 117 | route = SAA7115_SVIDEO3; |
| 118 | else |
| 119 | route = SAA7115_COMPOSITE0; |
| 120 | |
| 121 | if (dev->ctl_input < ARRAY_SIZE(gctrl)) { |
| 122 | v4l2_device_call_all(&dev->v4l2_dev, 0, video, s_routing, |
| 123 | route, 0, 0); |
Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 124 | stk1160_write_reg(dev, STK1160_GCTRL, gctrl[dev->ctl_input]); |
Ezequiel Garcia | 56a960b | 2012-10-09 18:01:03 -0300 | [diff] [blame] | 125 | } |
Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 126 | } |
| 127 | |
| 128 | /* TODO: We should break this into pieces */ |
| 129 | static void stk1160_reg_reset(struct stk1160 *dev) |
| 130 | { |
| 131 | int i; |
| 132 | |
| 133 | static const struct regval ctl[] = { |
| 134 | {STK1160_GCTRL+2, 0x0078}, |
| 135 | |
| 136 | {STK1160_RMCTL+1, 0x0000}, |
| 137 | {STK1160_RMCTL+3, 0x0002}, |
| 138 | |
| 139 | {STK1160_PLLSO, 0x0010}, |
| 140 | {STK1160_PLLSO+1, 0x0000}, |
| 141 | {STK1160_PLLSO+2, 0x0014}, |
| 142 | {STK1160_PLLSO+3, 0x000E}, |
| 143 | |
| 144 | {STK1160_PLLFD, 0x0046}, |
| 145 | |
| 146 | /* Timing generator setup */ |
| 147 | {STK1160_TIGEN, 0x0012}, |
| 148 | {STK1160_TICTL, 0x002D}, |
| 149 | {STK1160_TICTL+1, 0x0001}, |
| 150 | {STK1160_TICTL+2, 0x0000}, |
| 151 | {STK1160_TICTL+3, 0x0000}, |
| 152 | {STK1160_TIGEN, 0x0080}, |
| 153 | |
| 154 | {0xffff, 0xffff} |
| 155 | }; |
| 156 | |
| 157 | for (i = 0; ctl[i].reg != 0xffff; i++) |
| 158 | stk1160_write_reg(dev, ctl[i].reg, ctl[i].val); |
| 159 | } |
| 160 | |
| 161 | static void stk1160_release(struct v4l2_device *v4l2_dev) |
| 162 | { |
| 163 | struct stk1160 *dev = container_of(v4l2_dev, struct stk1160, v4l2_dev); |
| 164 | |
| 165 | stk1160_info("releasing all resources\n"); |
| 166 | |
| 167 | stk1160_i2c_unregister(dev); |
| 168 | |
| 169 | v4l2_ctrl_handler_free(&dev->ctrl_handler); |
| 170 | v4l2_device_unregister(&dev->v4l2_dev); |
| 171 | kfree(dev->alt_max_pkt_size); |
| 172 | kfree(dev); |
| 173 | } |
| 174 | |
| 175 | /* high bandwidth multiplier, as encoded in highspeed endpoint descriptors */ |
| 176 | #define hb_mult(wMaxPacketSize) (1 + (((wMaxPacketSize) >> 11) & 0x03)) |
| 177 | |
| 178 | /* |
| 179 | * Scan usb interface and populate max_pkt_size array |
| 180 | * with information on each alternate setting. |
| 181 | * The array should be allocated by the caller. |
| 182 | */ |
| 183 | static int stk1160_scan_usb(struct usb_interface *intf, struct usb_device *udev, |
| 184 | unsigned int *max_pkt_size) |
| 185 | { |
| 186 | int i, e, sizedescr, size, ifnum; |
| 187 | const struct usb_endpoint_descriptor *desc; |
| 188 | |
| 189 | bool has_video = false, has_audio = false; |
| 190 | const char *speed; |
| 191 | |
| 192 | ifnum = intf->altsetting[0].desc.bInterfaceNumber; |
| 193 | |
| 194 | /* Get endpoints */ |
| 195 | for (i = 0; i < intf->num_altsetting; i++) { |
| 196 | |
| 197 | for (e = 0; e < intf->altsetting[i].desc.bNumEndpoints; e++) { |
| 198 | |
| 199 | /* This isn't clear enough, at least to me */ |
| 200 | desc = &intf->altsetting[i].endpoint[e].desc; |
| 201 | sizedescr = le16_to_cpu(desc->wMaxPacketSize); |
| 202 | size = sizedescr & 0x7ff; |
| 203 | |
| 204 | if (udev->speed == USB_SPEED_HIGH) |
| 205 | size = size * hb_mult(sizedescr); |
| 206 | |
| 207 | if (usb_endpoint_xfer_isoc(desc) && |
| 208 | usb_endpoint_dir_in(desc)) { |
| 209 | switch (desc->bEndpointAddress) { |
| 210 | case STK1160_EP_AUDIO: |
| 211 | has_audio = true; |
| 212 | break; |
| 213 | case STK1160_EP_VIDEO: |
| 214 | has_video = true; |
| 215 | max_pkt_size[i] = size; |
| 216 | break; |
| 217 | } |
| 218 | } |
| 219 | } |
| 220 | } |
| 221 | |
| 222 | /* Is this even possible? */ |
| 223 | if (!(has_audio || has_video)) { |
| 224 | dev_err(&udev->dev, "no audio or video endpoints found\n"); |
| 225 | return -ENODEV; |
| 226 | } |
| 227 | |
| 228 | switch (udev->speed) { |
| 229 | case USB_SPEED_LOW: |
| 230 | speed = "1.5"; |
| 231 | break; |
| 232 | case USB_SPEED_FULL: |
| 233 | speed = "12"; |
| 234 | break; |
| 235 | case USB_SPEED_HIGH: |
| 236 | speed = "480"; |
| 237 | break; |
| 238 | default: |
| 239 | speed = "unknown"; |
| 240 | } |
| 241 | |
| 242 | dev_info(&udev->dev, "New device %s %s @ %s Mbps (%04x:%04x, interface %d, class %d)\n", |
| 243 | udev->manufacturer ? udev->manufacturer : "", |
| 244 | udev->product ? udev->product : "", |
| 245 | speed, |
| 246 | le16_to_cpu(udev->descriptor.idVendor), |
| 247 | le16_to_cpu(udev->descriptor.idProduct), |
| 248 | ifnum, |
| 249 | intf->altsetting->desc.bInterfaceNumber); |
| 250 | |
| 251 | /* This should never happen, since we rejected audio interfaces */ |
| 252 | if (has_audio) |
| 253 | dev_warn(&udev->dev, "audio interface %d found.\n\ |
| 254 | This is not implemented by this driver,\ |
| 255 | you should use snd-usb-audio instead\n", ifnum); |
| 256 | |
| 257 | if (has_video) |
| 258 | dev_info(&udev->dev, "video interface %d found\n", |
| 259 | ifnum); |
| 260 | |
| 261 | /* |
| 262 | * Make sure we have 480 Mbps of bandwidth, otherwise things like |
| 263 | * video stream wouldn't likely work, since 12 Mbps is generally |
| 264 | * not enough even for most streams. |
| 265 | */ |
| 266 | if (udev->speed != USB_SPEED_HIGH) |
| 267 | dev_warn(&udev->dev, "must be connected to a high-speed USB 2.0 port\n\ |
| 268 | You may not be able to stream video smoothly\n"); |
| 269 | |
| 270 | return 0; |
| 271 | } |
| 272 | |
| 273 | static int stk1160_probe(struct usb_interface *interface, |
| 274 | const struct usb_device_id *id) |
| 275 | { |
Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 276 | int rc = 0; |
| 277 | |
| 278 | unsigned int *alt_max_pkt_size; /* array of wMaxPacketSize */ |
| 279 | struct usb_device *udev; |
| 280 | struct stk1160 *dev; |
| 281 | |
Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 282 | udev = interface_to_usbdev(interface); |
| 283 | |
| 284 | /* |
| 285 | * Since usb audio class is supported by snd-usb-audio, |
| 286 | * we reject audio interface. |
| 287 | */ |
| 288 | if (interface->altsetting[0].desc.bInterfaceClass == USB_CLASS_AUDIO) |
| 289 | return -ENODEV; |
| 290 | |
| 291 | /* Alloc an array for all possible max_pkt_size */ |
| 292 | alt_max_pkt_size = kmalloc(sizeof(alt_max_pkt_size[0]) * |
| 293 | interface->num_altsetting, GFP_KERNEL); |
| 294 | if (alt_max_pkt_size == NULL) |
| 295 | return -ENOMEM; |
| 296 | |
| 297 | /* |
| 298 | * Scan usb posibilities and populate alt_max_pkt_size array. |
| 299 | * Also, check if device speed is fast enough. |
| 300 | */ |
| 301 | rc = stk1160_scan_usb(interface, udev, alt_max_pkt_size); |
| 302 | if (rc < 0) { |
| 303 | kfree(alt_max_pkt_size); |
| 304 | return rc; |
| 305 | } |
| 306 | |
| 307 | dev = kzalloc(sizeof(struct stk1160), GFP_KERNEL); |
| 308 | if (dev == NULL) { |
| 309 | kfree(alt_max_pkt_size); |
| 310 | return -ENOMEM; |
| 311 | } |
| 312 | |
| 313 | dev->alt_max_pkt_size = alt_max_pkt_size; |
| 314 | dev->udev = udev; |
| 315 | dev->num_alt = interface->num_altsetting; |
| 316 | dev->ctl_input = input; |
| 317 | |
| 318 | /* We save struct device for debug purposes only */ |
| 319 | dev->dev = &interface->dev; |
| 320 | |
| 321 | usb_set_intfdata(interface, dev); |
| 322 | |
| 323 | /* initialize videobuf2 stuff */ |
| 324 | rc = stk1160_vb2_setup(dev); |
| 325 | if (rc < 0) |
| 326 | goto free_err; |
| 327 | |
| 328 | /* |
| 329 | * There is no need to take any locks here in probe |
| 330 | * because we register the device node as the *last* thing. |
| 331 | */ |
| 332 | spin_lock_init(&dev->buf_lock); |
| 333 | mutex_init(&dev->v4l_lock); |
| 334 | mutex_init(&dev->vb_queue_lock); |
| 335 | |
| 336 | rc = v4l2_ctrl_handler_init(&dev->ctrl_handler, 0); |
| 337 | if (rc) { |
| 338 | stk1160_err("v4l2_ctrl_handler_init failed (%d)\n", rc); |
| 339 | goto free_err; |
| 340 | } |
| 341 | |
| 342 | /* |
| 343 | * We obtain a v4l2_dev but defer |
| 344 | * registration of video device node as the last thing. |
| 345 | * There is no need to set the name if we give a device struct |
| 346 | */ |
| 347 | dev->v4l2_dev.release = stk1160_release; |
| 348 | dev->v4l2_dev.ctrl_handler = &dev->ctrl_handler; |
| 349 | rc = v4l2_device_register(dev->dev, &dev->v4l2_dev); |
| 350 | if (rc) { |
| 351 | stk1160_err("v4l2_device_register failed (%d)\n", rc); |
| 352 | goto free_ctrl; |
| 353 | } |
| 354 | |
| 355 | rc = stk1160_i2c_register(dev); |
| 356 | if (rc < 0) |
| 357 | goto unreg_v4l2; |
| 358 | |
| 359 | /* |
| 360 | * To the best of my knowledge stk1160 boards only have |
| 361 | * saa7113, but it doesn't hurt to support them all. |
| 362 | */ |
| 363 | dev->sd_saa7115 = v4l2_i2c_new_subdev(&dev->v4l2_dev, &dev->i2c_adap, |
| 364 | "saa7115_auto", 0, saa7113_addrs); |
| 365 | |
| 366 | stk1160_info("driver ver %s successfully loaded\n", |
| 367 | STK1160_VERSION); |
| 368 | |
| 369 | /* i2c reset saa711x */ |
| 370 | v4l2_device_call_all(&dev->v4l2_dev, 0, core, reset, 0); |
Ezequiel García | 9cb2173 | 2012-08-11 14:32:57 -0300 | [diff] [blame] | 371 | v4l2_device_call_all(&dev->v4l2_dev, 0, video, s_stream, 0); |
| 372 | |
| 373 | /* reset stk1160 to default values */ |
| 374 | stk1160_reg_reset(dev); |
| 375 | |
| 376 | /* select default input */ |
| 377 | stk1160_select_input(dev); |
| 378 | |
| 379 | stk1160_ac97_register(dev); |
| 380 | |
| 381 | rc = stk1160_video_register(dev); |
| 382 | if (rc < 0) |
| 383 | goto unreg_i2c; |
| 384 | |
| 385 | return 0; |
| 386 | |
| 387 | unreg_i2c: |
| 388 | stk1160_i2c_unregister(dev); |
| 389 | unreg_v4l2: |
| 390 | v4l2_device_unregister(&dev->v4l2_dev); |
| 391 | free_ctrl: |
| 392 | v4l2_ctrl_handler_free(&dev->ctrl_handler); |
| 393 | free_err: |
| 394 | kfree(alt_max_pkt_size); |
| 395 | kfree(dev); |
| 396 | |
| 397 | return rc; |
| 398 | } |
| 399 | |
| 400 | static void stk1160_disconnect(struct usb_interface *interface) |
| 401 | { |
| 402 | struct stk1160 *dev; |
| 403 | |
| 404 | dev = usb_get_intfdata(interface); |
| 405 | usb_set_intfdata(interface, NULL); |
| 406 | |
| 407 | /* |
| 408 | * Wait until all current v4l2 operation are finished |
| 409 | * then deallocate resources |
| 410 | */ |
| 411 | mutex_lock(&dev->vb_queue_lock); |
| 412 | mutex_lock(&dev->v4l_lock); |
| 413 | |
| 414 | /* Here is the only place where isoc get released */ |
| 415 | stk1160_uninit_isoc(dev); |
| 416 | |
| 417 | /* ac97 unregister needs to be done before usb_device is cleared */ |
| 418 | stk1160_ac97_unregister(dev); |
| 419 | |
| 420 | stk1160_clear_queue(dev); |
| 421 | |
| 422 | video_unregister_device(&dev->vdev); |
| 423 | v4l2_device_disconnect(&dev->v4l2_dev); |
| 424 | |
| 425 | /* This way current users can detect device is gone */ |
| 426 | dev->udev = NULL; |
| 427 | |
| 428 | mutex_unlock(&dev->v4l_lock); |
| 429 | mutex_unlock(&dev->vb_queue_lock); |
| 430 | |
| 431 | /* |
| 432 | * This calls stk1160_release if it's the last reference. |
| 433 | * therwise, release is posponed until there are no users left. |
| 434 | */ |
| 435 | v4l2_device_put(&dev->v4l2_dev); |
| 436 | } |
| 437 | |
| 438 | static struct usb_driver stk1160_usb_driver = { |
| 439 | .name = "stk1160", |
| 440 | .id_table = stk1160_id_table, |
| 441 | .probe = stk1160_probe, |
| 442 | .disconnect = stk1160_disconnect, |
| 443 | }; |
| 444 | |
| 445 | module_usb_driver(stk1160_usb_driver); |