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 <linux/module.h>
23 #include <linux/slab.h>
24 #include <linux/videodev2.h>
25 #include <media/v4l2-common.h>
26 #include <linux/mutex.h>
27 
28 #include "au0828.h"
29 
30 /*
31  * 1 = General debug messages
32  * 2 = USB handling
33  * 4 = I2C related
34  * 8 = Bridge related
35  */
36 int au0828_debug;
37 module_param_named(debug, au0828_debug, int, 0644);
38 MODULE_PARM_DESC(debug, "enable debug messages");
39 
40 static unsigned int disable_usb_speed_check;
41 module_param(disable_usb_speed_check, int, 0444);
42 MODULE_PARM_DESC(disable_usb_speed_check,
43 		 "override min bandwidth requirement of 480M bps");
44 
45 #define _AU0828_BULKPIPE 0x03
46 #define _BULKPIPESIZE 0xffff
47 
48 static int send_control_msg(struct au0828_dev *dev, u16 request, u32 value,
49 			    u16 index);
50 static int recv_control_msg(struct au0828_dev *dev, u16 request, u32 value,
51 	u16 index, unsigned char *cp, u16 size);
52 
53 /* USB Direction */
54 #define CMD_REQUEST_IN		0x00
55 #define CMD_REQUEST_OUT		0x01
56 
57 u32 au0828_readreg(struct au0828_dev *dev, u16 reg)
58 {
59 	u8 result = 0;
60 
61 	recv_control_msg(dev, CMD_REQUEST_IN, 0, reg, &result, 1);
62 	dprintk(8, "%s(0x%04x) = 0x%02x\n", __func__, reg, result);
63 
64 	return result;
65 }
66 
67 u32 au0828_writereg(struct au0828_dev *dev, u16 reg, u32 val)
68 {
69 	dprintk(8, "%s(0x%04x, 0x%02x)\n", __func__, reg, val);
70 	return send_control_msg(dev, CMD_REQUEST_OUT, val, reg);
71 }
72 
73 static int send_control_msg(struct au0828_dev *dev, u16 request, u32 value,
74 	u16 index)
75 {
76 	int status = -ENODEV;
77 
78 	if (dev->usbdev) {
79 
80 		/* cp must be memory that has been allocated by kmalloc */
81 		status = usb_control_msg(dev->usbdev,
82 				usb_sndctrlpipe(dev->usbdev, 0),
83 				request,
84 				USB_DIR_OUT | USB_TYPE_VENDOR |
85 					USB_RECIP_DEVICE,
86 				value, index, NULL, 0, 1000);
87 
88 		status = min(status, 0);
89 
90 		if (status < 0) {
91 			printk(KERN_ERR "%s() Failed sending control message, error %d.\n",
92 				__func__, status);
93 		}
94 
95 	}
96 
97 	return status;
98 }
99 
100 static int recv_control_msg(struct au0828_dev *dev, u16 request, u32 value,
101 	u16 index, unsigned char *cp, u16 size)
102 {
103 	int status = -ENODEV;
104 	mutex_lock(&dev->mutex);
105 	if (dev->usbdev) {
106 		status = usb_control_msg(dev->usbdev,
107 				usb_rcvctrlpipe(dev->usbdev, 0),
108 				request,
109 				USB_DIR_IN | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
110 				value, index,
111 				dev->ctrlmsg, size, 1000);
112 
113 		status = min(status, 0);
114 
115 		if (status < 0) {
116 			printk(KERN_ERR "%s() Failed receiving control message, error %d.\n",
117 				__func__, status);
118 		}
119 
120 		/* the host controller requires heap allocated memory, which
121 		   is why we didn't just pass "cp" into usb_control_msg */
122 		memcpy(cp, dev->ctrlmsg, size);
123 	}
124 	mutex_unlock(&dev->mutex);
125 	return status;
126 }
127 
128 static void au0828_usb_release(struct au0828_dev *dev)
129 {
130 	/* I2C */
131 	au0828_i2c_unregister(dev);
132 
133 	kfree(dev);
134 }
135 
136 #ifdef CONFIG_VIDEO_AU0828_V4L2
137 static void au0828_usb_v4l2_release(struct v4l2_device *v4l2_dev)
138 {
139 	struct au0828_dev *dev =
140 		container_of(v4l2_dev, struct au0828_dev, v4l2_dev);
141 
142 	v4l2_ctrl_handler_free(&dev->v4l2_ctrl_hdl);
143 	v4l2_device_unregister(&dev->v4l2_dev);
144 	au0828_usb_release(dev);
145 }
146 #endif
147 
148 static void au0828_usb_disconnect(struct usb_interface *interface)
149 {
150 	struct au0828_dev *dev = usb_get_intfdata(interface);
151 
152 	dprintk(1, "%s()\n", __func__);
153 
154 	/* Digital TV */
155 	au0828_dvb_unregister(dev);
156 
157 	usb_set_intfdata(interface, NULL);
158 	mutex_lock(&dev->mutex);
159 	dev->usbdev = NULL;
160 	mutex_unlock(&dev->mutex);
161 #ifdef CONFIG_VIDEO_AU0828_V4L2
162 	if (AUVI_INPUT(0).type != AU0828_VMUX_UNDEFINED) {
163 		au0828_analog_unregister(dev);
164 		v4l2_device_disconnect(&dev->v4l2_dev);
165 		v4l2_device_put(&dev->v4l2_dev);
166 		return;
167 	}
168 #endif
169 	au0828_usb_release(dev);
170 }
171 
172 static int au0828_usb_probe(struct usb_interface *interface,
173 	const struct usb_device_id *id)
174 {
175 	int ifnum;
176 #ifdef CONFIG_VIDEO_AU0828_V4L2
177 	int retval;
178 #endif
179 	struct au0828_dev *dev;
180 	struct usb_device *usbdev = interface_to_usbdev(interface);
181 
182 	ifnum = interface->altsetting->desc.bInterfaceNumber;
183 
184 	if (ifnum != 0)
185 		return -ENODEV;
186 
187 	dprintk(1, "%s() vendor id 0x%x device id 0x%x ifnum:%d\n", __func__,
188 		le16_to_cpu(usbdev->descriptor.idVendor),
189 		le16_to_cpu(usbdev->descriptor.idProduct),
190 		ifnum);
191 
192 	/*
193 	 * Make sure we have 480 Mbps of bandwidth, otherwise things like
194 	 * video stream wouldn't likely work, since 12 Mbps is generally
195 	 * not enough even for most Digital TV streams.
196 	 */
197 	if (usbdev->speed != USB_SPEED_HIGH && disable_usb_speed_check == 0) {
198 		printk(KERN_ERR "au0828: Device initialization failed.\n");
199 		printk(KERN_ERR "au0828: Device must be connected to a "
200 		       "high-speed USB 2.0 port.\n");
201 		return -ENODEV;
202 	}
203 
204 	dev = kzalloc(sizeof(*dev), GFP_KERNEL);
205 	if (dev == NULL) {
206 		printk(KERN_ERR "%s() Unable to allocate memory\n", __func__);
207 		return -ENOMEM;
208 	}
209 
210 	mutex_init(&dev->lock);
211 	mutex_lock(&dev->lock);
212 	mutex_init(&dev->mutex);
213 	mutex_init(&dev->dvb.lock);
214 	dev->usbdev = usbdev;
215 	dev->boardnr = id->driver_info;
216 
217 #ifdef CONFIG_VIDEO_AU0828_V4L2
218 	dev->v4l2_dev.release = au0828_usb_v4l2_release;
219 
220 	/* Create the v4l2_device */
221 	retval = v4l2_device_register(&interface->dev, &dev->v4l2_dev);
222 	if (retval) {
223 		pr_err("%s() v4l2_device_register failed\n",
224 		       __func__);
225 		mutex_unlock(&dev->lock);
226 		kfree(dev);
227 		return retval;
228 	}
229 	/* This control handler will inherit the controls from au8522 */
230 	retval = v4l2_ctrl_handler_init(&dev->v4l2_ctrl_hdl, 4);
231 	if (retval) {
232 		pr_err("%s() v4l2_ctrl_handler_init failed\n",
233 		       __func__);
234 		mutex_unlock(&dev->lock);
235 		kfree(dev);
236 		return retval;
237 	}
238 	dev->v4l2_dev.ctrl_handler = &dev->v4l2_ctrl_hdl;
239 #endif
240 
241 	/* Power Up the bridge */
242 	au0828_write(dev, REG_600, 1 << 4);
243 
244 	/* Bring up the GPIO's and supporting devices */
245 	au0828_gpio_setup(dev);
246 
247 	/* I2C */
248 	au0828_i2c_register(dev);
249 
250 	/* Setup */
251 	au0828_card_setup(dev);
252 
253 #ifdef CONFIG_VIDEO_AU0828_V4L2
254 	/* Analog TV */
255 	if (AUVI_INPUT(0).type != AU0828_VMUX_UNDEFINED)
256 		au0828_analog_register(dev, interface);
257 #endif
258 
259 	/* Digital TV */
260 	au0828_dvb_register(dev);
261 
262 	/* Store the pointer to the au0828_dev so it can be accessed in
263 	   au0828_usb_disconnect */
264 	usb_set_intfdata(interface, dev);
265 
266 	printk(KERN_INFO "Registered device AU0828 [%s]\n",
267 		dev->board.name == NULL ? "Unset" : dev->board.name);
268 
269 	mutex_unlock(&dev->lock);
270 
271 	return 0;
272 }
273 
274 static struct usb_driver au0828_usb_driver = {
275 	.name		= DRIVER_NAME,
276 	.probe		= au0828_usb_probe,
277 	.disconnect	= au0828_usb_disconnect,
278 	.id_table	= au0828_usb_id_table,
279 };
280 
281 static int __init au0828_init(void)
282 {
283 	int ret;
284 
285 	if (au0828_debug & 1)
286 		printk(KERN_INFO "%s() Debugging is enabled\n", __func__);
287 
288 	if (au0828_debug & 2)
289 		printk(KERN_INFO "%s() USB Debugging is enabled\n", __func__);
290 
291 	if (au0828_debug & 4)
292 		printk(KERN_INFO "%s() I2C Debugging is enabled\n", __func__);
293 
294 	if (au0828_debug & 8)
295 		printk(KERN_INFO "%s() Bridge Debugging is enabled\n",
296 		       __func__);
297 
298 	printk(KERN_INFO "au0828 driver loaded\n");
299 
300 	ret = usb_register(&au0828_usb_driver);
301 	if (ret)
302 		printk(KERN_ERR "usb_register failed, error = %d\n", ret);
303 
304 	return ret;
305 }
306 
307 static void __exit au0828_exit(void)
308 {
309 	usb_deregister(&au0828_usb_driver);
310 }
311 
312 module_init(au0828_init);
313 module_exit(au0828_exit);
314 
315 MODULE_DESCRIPTION("Driver for Auvitek AU0828 based products");
316 MODULE_AUTHOR("Steven Toth <stoth@linuxtv.org>");
317 MODULE_LICENSE("GPL");
318 MODULE_VERSION("0.0.2");
319