xref: /linux/drivers/media/usb/au0828/au0828-core.c (revision b85d45947951d23cb22d90caecf4c1eb81342c96)
1 /*
2  *  Driver for the Auvitek USB bridge
3  *
4  *  Copyright (c) 2008 Steven Toth <stoth@linuxtv.org>
5  *
6  *  This program is free software; you can redistribute it and/or modify
7  *  it under the terms of the GNU General Public License as published by
8  *  the Free Software Foundation; either version 2 of the License, or
9  *  (at your option) any later version.
10  *
11  *  This program is distributed in the hope that it will be useful,
12  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
13  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  *
15  *  GNU General Public License for more details.
16  *
17  *  You should have received a copy of the GNU General Public License
18  *  along with this program; if not, write to the Free Software
19  *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20  */
21 
22 #include "au0828.h"
23 
24 #include <linux/module.h>
25 #include <linux/slab.h>
26 #include <linux/videodev2.h>
27 #include <media/v4l2-common.h>
28 #include <linux/mutex.h>
29 
30 /*
31  * 1 = General debug messages
32  * 2 = USB handling
33  * 4 = I2C related
34  * 8 = Bridge related
35  * 16 = IR related
36  */
37 int au0828_debug;
38 module_param_named(debug, au0828_debug, int, 0644);
39 MODULE_PARM_DESC(debug,
40 		 "set debug bitmask: 1=general, 2=USB, 4=I2C, 8=bridge, 16=IR");
41 
42 static unsigned int disable_usb_speed_check;
43 module_param(disable_usb_speed_check, int, 0444);
44 MODULE_PARM_DESC(disable_usb_speed_check,
45 		 "override min bandwidth requirement of 480M bps");
46 
47 #define _AU0828_BULKPIPE 0x03
48 #define _BULKPIPESIZE 0xffff
49 
50 static int send_control_msg(struct au0828_dev *dev, u16 request, u32 value,
51 			    u16 index);
52 static int recv_control_msg(struct au0828_dev *dev, u16 request, u32 value,
53 	u16 index, unsigned char *cp, u16 size);
54 
55 /* USB Direction */
56 #define CMD_REQUEST_IN		0x00
57 #define CMD_REQUEST_OUT		0x01
58 
59 u32 au0828_readreg(struct au0828_dev *dev, u16 reg)
60 {
61 	u8 result = 0;
62 
63 	recv_control_msg(dev, CMD_REQUEST_IN, 0, reg, &result, 1);
64 	dprintk(8, "%s(0x%04x) = 0x%02x\n", __func__, reg, result);
65 
66 	return result;
67 }
68 
69 u32 au0828_writereg(struct au0828_dev *dev, u16 reg, u32 val)
70 {
71 	dprintk(8, "%s(0x%04x, 0x%02x)\n", __func__, reg, val);
72 	return send_control_msg(dev, CMD_REQUEST_OUT, val, reg);
73 }
74 
75 static int send_control_msg(struct au0828_dev *dev, u16 request, u32 value,
76 	u16 index)
77 {
78 	int status = -ENODEV;
79 
80 	if (dev->usbdev) {
81 
82 		/* cp must be memory that has been allocated by kmalloc */
83 		status = usb_control_msg(dev->usbdev,
84 				usb_sndctrlpipe(dev->usbdev, 0),
85 				request,
86 				USB_DIR_OUT | USB_TYPE_VENDOR |
87 					USB_RECIP_DEVICE,
88 				value, index, NULL, 0, 1000);
89 
90 		status = min(status, 0);
91 
92 		if (status < 0) {
93 			pr_err("%s() Failed sending control message, error %d.\n",
94 				__func__, status);
95 		}
96 
97 	}
98 
99 	return status;
100 }
101 
102 static int recv_control_msg(struct au0828_dev *dev, u16 request, u32 value,
103 	u16 index, unsigned char *cp, u16 size)
104 {
105 	int status = -ENODEV;
106 	mutex_lock(&dev->mutex);
107 	if (dev->usbdev) {
108 		status = usb_control_msg(dev->usbdev,
109 				usb_rcvctrlpipe(dev->usbdev, 0),
110 				request,
111 				USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
112 				value, index,
113 				dev->ctrlmsg, size, 1000);
114 
115 		status = min(status, 0);
116 
117 		if (status < 0) {
118 			pr_err("%s() Failed receiving control message, error %d.\n",
119 				__func__, status);
120 		}
121 
122 		/* the host controller requires heap allocated memory, which
123 		   is why we didn't just pass "cp" into usb_control_msg */
124 		memcpy(cp, dev->ctrlmsg, size);
125 	}
126 	mutex_unlock(&dev->mutex);
127 	return status;
128 }
129 
130 static void au0828_usb_release(struct au0828_dev *dev)
131 {
132 	/* I2C */
133 	au0828_i2c_unregister(dev);
134 
135 	kfree(dev);
136 }
137 
138 #ifdef CONFIG_VIDEO_AU0828_V4L2
139 static void au0828_usb_v4l2_release(struct v4l2_device *v4l2_dev)
140 {
141 	struct au0828_dev *dev =
142 		container_of(v4l2_dev, struct au0828_dev, v4l2_dev);
143 
144 	v4l2_ctrl_handler_free(&dev->v4l2_ctrl_hdl);
145 	v4l2_device_unregister(&dev->v4l2_dev);
146 	au0828_usb_release(dev);
147 }
148 #endif
149 
150 static void au0828_usb_disconnect(struct usb_interface *interface)
151 {
152 	struct au0828_dev *dev = usb_get_intfdata(interface);
153 
154 	dprintk(1, "%s()\n", __func__);
155 
156 	/* there is a small window after disconnect, before
157 	   dev->usbdev is NULL, for poll (e.g: IR) try to access
158 	   the device and fill the dmesg with error messages.
159 	   Set the status so poll routines can check and avoid
160 	   access after disconnect.
161 	*/
162 	dev->dev_state = DEV_DISCONNECTED;
163 
164 	au0828_rc_unregister(dev);
165 	/* Digital TV */
166 	au0828_dvb_unregister(dev);
167 
168 	usb_set_intfdata(interface, NULL);
169 	mutex_lock(&dev->mutex);
170 	dev->usbdev = NULL;
171 	mutex_unlock(&dev->mutex);
172 #ifdef CONFIG_VIDEO_AU0828_V4L2
173 	if (AUVI_INPUT(0).type != AU0828_VMUX_UNDEFINED) {
174 		au0828_analog_unregister(dev);
175 		v4l2_device_disconnect(&dev->v4l2_dev);
176 		v4l2_device_put(&dev->v4l2_dev);
177 		return;
178 	}
179 #endif
180 	au0828_usb_release(dev);
181 }
182 
183 static int au0828_usb_probe(struct usb_interface *interface,
184 	const struct usb_device_id *id)
185 {
186 	int ifnum;
187 	int retval = 0;
188 
189 	struct au0828_dev *dev;
190 	struct usb_device *usbdev = interface_to_usbdev(interface);
191 
192 	ifnum = interface->altsetting->desc.bInterfaceNumber;
193 
194 	if (ifnum != 0)
195 		return -ENODEV;
196 
197 	dprintk(1, "%s() vendor id 0x%x device id 0x%x ifnum:%d\n", __func__,
198 		le16_to_cpu(usbdev->descriptor.idVendor),
199 		le16_to_cpu(usbdev->descriptor.idProduct),
200 		ifnum);
201 
202 	/*
203 	 * Make sure we have 480 Mbps of bandwidth, otherwise things like
204 	 * video stream wouldn't likely work, since 12 Mbps is generally
205 	 * not enough even for most Digital TV streams.
206 	 */
207 	if (usbdev->speed != USB_SPEED_HIGH && disable_usb_speed_check == 0) {
208 		pr_err("au0828: Device initialization failed.\n");
209 		pr_err("au0828: Device must be connected to a high-speed USB 2.0 port.\n");
210 		return -ENODEV;
211 	}
212 
213 	dev = kzalloc(sizeof(*dev), GFP_KERNEL);
214 	if (dev == NULL) {
215 		pr_err("%s() Unable to allocate memory\n", __func__);
216 		return -ENOMEM;
217 	}
218 
219 	mutex_init(&dev->lock);
220 	mutex_lock(&dev->lock);
221 	mutex_init(&dev->mutex);
222 	mutex_init(&dev->dvb.lock);
223 	dev->usbdev = usbdev;
224 	dev->boardnr = id->driver_info;
225 	dev->board = au0828_boards[dev->boardnr];
226 
227 
228 #ifdef CONFIG_VIDEO_AU0828_V4L2
229 	dev->v4l2_dev.release = au0828_usb_v4l2_release;
230 
231 	/* Create the v4l2_device */
232 	retval = v4l2_device_register(&interface->dev, &dev->v4l2_dev);
233 	if (retval) {
234 		pr_err("%s() v4l2_device_register failed\n",
235 		       __func__);
236 		mutex_unlock(&dev->lock);
237 		kfree(dev);
238 		return retval;
239 	}
240 	/* This control handler will inherit the controls from au8522 */
241 	retval = v4l2_ctrl_handler_init(&dev->v4l2_ctrl_hdl, 4);
242 	if (retval) {
243 		pr_err("%s() v4l2_ctrl_handler_init failed\n",
244 		       __func__);
245 		mutex_unlock(&dev->lock);
246 		kfree(dev);
247 		return retval;
248 	}
249 	dev->v4l2_dev.ctrl_handler = &dev->v4l2_ctrl_hdl;
250 #endif
251 
252 	/* Power Up the bridge */
253 	au0828_write(dev, REG_600, 1 << 4);
254 
255 	/* Bring up the GPIO's and supporting devices */
256 	au0828_gpio_setup(dev);
257 
258 	/* I2C */
259 	au0828_i2c_register(dev);
260 
261 	/* Setup */
262 	au0828_card_setup(dev);
263 
264 #ifdef CONFIG_VIDEO_AU0828_V4L2
265 	/* Analog TV */
266 	if (AUVI_INPUT(0).type != AU0828_VMUX_UNDEFINED)
267 		au0828_analog_register(dev, interface);
268 #endif
269 
270 	/* Digital TV */
271 	retval = au0828_dvb_register(dev);
272 	if (retval)
273 		pr_err("%s() au0282_dev_register failed\n",
274 		       __func__);
275 
276 	/* Remote controller */
277 	au0828_rc_register(dev);
278 
279 	/*
280 	 * Store the pointer to the au0828_dev so it can be accessed in
281 	 * au0828_usb_disconnect
282 	 */
283 	usb_set_intfdata(interface, dev);
284 
285 	pr_info("Registered device AU0828 [%s]\n",
286 		dev->board.name == NULL ? "Unset" : dev->board.name);
287 
288 	mutex_unlock(&dev->lock);
289 
290 	return retval;
291 }
292 
293 static int au0828_suspend(struct usb_interface *interface,
294 				pm_message_t message)
295 {
296 	struct au0828_dev *dev = usb_get_intfdata(interface);
297 
298 	if (!dev)
299 		return 0;
300 
301 	pr_info("Suspend\n");
302 
303 	au0828_rc_suspend(dev);
304 	au0828_v4l2_suspend(dev);
305 	au0828_dvb_suspend(dev);
306 
307 	/* FIXME: should suspend also ATV/DTV */
308 
309 	return 0;
310 }
311 
312 static int au0828_resume(struct usb_interface *interface)
313 {
314 	struct au0828_dev *dev = usb_get_intfdata(interface);
315 	if (!dev)
316 		return 0;
317 
318 	pr_info("Resume\n");
319 
320 	/* Power Up the bridge */
321 	au0828_write(dev, REG_600, 1 << 4);
322 
323 	/* Bring up the GPIO's and supporting devices */
324 	au0828_gpio_setup(dev);
325 
326 	au0828_rc_resume(dev);
327 	au0828_v4l2_resume(dev);
328 	au0828_dvb_resume(dev);
329 
330 	/* FIXME: should resume also ATV/DTV */
331 
332 	return 0;
333 }
334 
335 static struct usb_driver au0828_usb_driver = {
336 	.name		= KBUILD_MODNAME,
337 	.probe		= au0828_usb_probe,
338 	.disconnect	= au0828_usb_disconnect,
339 	.id_table	= au0828_usb_id_table,
340 	.suspend	= au0828_suspend,
341 	.resume		= au0828_resume,
342 	.reset_resume	= au0828_resume,
343 };
344 
345 static int __init au0828_init(void)
346 {
347 	int ret;
348 
349 	if (au0828_debug & 1)
350 		pr_info("%s() Debugging is enabled\n", __func__);
351 
352 	if (au0828_debug & 2)
353 		pr_info("%s() USB Debugging is enabled\n", __func__);
354 
355 	if (au0828_debug & 4)
356 		pr_info("%s() I2C Debugging is enabled\n", __func__);
357 
358 	if (au0828_debug & 8)
359 		pr_info("%s() Bridge Debugging is enabled\n",
360 		       __func__);
361 
362 	if (au0828_debug & 16)
363 		pr_info("%s() IR Debugging is enabled\n",
364 		       __func__);
365 
366 	pr_info("au0828 driver loaded\n");
367 
368 	ret = usb_register(&au0828_usb_driver);
369 	if (ret)
370 		pr_err("usb_register failed, error = %d\n", ret);
371 
372 	return ret;
373 }
374 
375 static void __exit au0828_exit(void)
376 {
377 	usb_deregister(&au0828_usb_driver);
378 }
379 
380 module_init(au0828_init);
381 module_exit(au0828_exit);
382 
383 MODULE_DESCRIPTION("Driver for Auvitek AU0828 based products");
384 MODULE_AUTHOR("Steven Toth <stoth@linuxtv.org>");
385 MODULE_LICENSE("GPL");
386 MODULE_VERSION("0.0.3");
387