2 * Benq DC E300 subdriver
4 * Copyright (C) 2009 Jean-Francois Moine (http://moinejf.free.fr)
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
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 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
21 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
23 #define MODULE_NAME "benq"
27 MODULE_AUTHOR("Jean-Francois Moine <http://moinejf.free.fr>");
28 MODULE_DESCRIPTION("Benq DC E300 USB Camera Driver");
29 MODULE_LICENSE("GPL");
31 /* specific webcam descriptor */
33 struct gspca_dev gspca_dev; /* !! must be the first item */
36 /* V4L2 controls supported by the driver */
37 static const struct ctrl sd_ctrls[] = {
40 static const struct v4l2_pix_format vga_mode[] = {
41 {320, 240, V4L2_PIX_FMT_JPEG, V4L2_FIELD_NONE,
43 .sizeimage = 320 * 240 * 3 / 8 + 590,
44 .colorspace = V4L2_COLORSPACE_JPEG},
47 static void sd_isoc_irq(struct urb *urb);
49 /* -- write a register -- */
50 static void reg_w(struct gspca_dev *gspca_dev,
53 struct usb_device *dev = gspca_dev->dev;
56 if (gspca_dev->usb_err < 0)
58 ret = usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
60 USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
67 pr_err("reg_w err %d\n", ret);
68 gspca_dev->usb_err = ret;
72 /* this function is called at probe time */
73 static int sd_config(struct gspca_dev *gspca_dev,
74 const struct usb_device_id *id)
76 gspca_dev->cam.cam_mode = vga_mode;
77 gspca_dev->cam.nmodes = ARRAY_SIZE(vga_mode);
78 gspca_dev->cam.no_urb_create = 1;
79 gspca_dev->cam.reverse_alts = 1;
83 /* this function is called at probe and resume time */
84 static int sd_init(struct gspca_dev *gspca_dev)
89 /* -- start the camera -- */
90 static int sd_start(struct gspca_dev *gspca_dev)
95 /* create 4 URBs - 2 on endpoint 0x83 and 2 on 0x082 */
97 #error "Not enough URBs in the gspca table"
101 for (n = 0; n < 4; n++) {
102 urb = usb_alloc_urb(SD_NPKT, GFP_KERNEL);
104 pr_err("usb_alloc_urb failed\n");
107 gspca_dev->urb[n] = urb;
108 urb->transfer_buffer = usb_alloc_coherent(gspca_dev->dev,
113 if (urb->transfer_buffer == NULL) {
114 pr_err("usb_alloc_coherent failed\n");
117 urb->dev = gspca_dev->dev;
118 urb->context = gspca_dev;
119 urb->transfer_buffer_length = SD_PKT_SZ * SD_NPKT;
120 urb->pipe = usb_rcvisocpipe(gspca_dev->dev,
121 n & 1 ? 0x82 : 0x83);
122 urb->transfer_flags = URB_ISO_ASAP
123 | URB_NO_TRANSFER_DMA_MAP;
125 urb->complete = sd_isoc_irq;
126 urb->number_of_packets = SD_NPKT;
127 for (i = 0; i < SD_NPKT; i++) {
128 urb->iso_frame_desc[i].length = SD_PKT_SZ;
129 urb->iso_frame_desc[i].offset = SD_PKT_SZ * i;
133 return gspca_dev->usb_err;
136 static void sd_stopN(struct gspca_dev *gspca_dev)
138 reg_w(gspca_dev, 0x003c, 0x0003);
139 reg_w(gspca_dev, 0x003c, 0x0004);
140 reg_w(gspca_dev, 0x003c, 0x0005);
141 reg_w(gspca_dev, 0x003c, 0x0006);
142 reg_w(gspca_dev, 0x003c, 0x0007);
143 usb_set_interface(gspca_dev->dev, gspca_dev->iface,
144 gspca_dev->nbalt - 1);
147 static void sd_pkt_scan(struct gspca_dev *gspca_dev,
148 u8 *data, /* isoc packet */
149 int len) /* iso packet length */
154 /* reception of an URB */
155 static void sd_isoc_irq(struct urb *urb)
157 struct gspca_dev *gspca_dev = (struct gspca_dev *) urb->context;
162 PDEBUG(D_PACK, "sd isoc irq");
163 if (!gspca_dev->streaming)
165 if (urb->status != 0) {
166 if (urb->status == -ESHUTDOWN)
167 return; /* disconnection */
169 if (gspca_dev->frozen)
172 pr_err("urb status: %d\n", urb->status);
176 /* if this is a control URN (ep 0x83), wait */
177 if (urb == gspca_dev->urb[0] || urb == gspca_dev->urb[2])
180 /* scan both received URBs */
181 if (urb == gspca_dev->urb[1])
182 urb0 = gspca_dev->urb[0];
184 urb0 = gspca_dev->urb[2];
185 for (i = 0; i < urb->number_of_packets; i++) {
187 /* check the packet status and length */
188 if (urb0->iso_frame_desc[i].actual_length != SD_PKT_SZ
189 || urb->iso_frame_desc[i].actual_length != SD_PKT_SZ) {
190 PDEBUG(D_ERR, "ISOC bad lengths %d / %d",
191 urb0->iso_frame_desc[i].actual_length,
192 urb->iso_frame_desc[i].actual_length);
193 gspca_dev->last_packet_type = DISCARD_PACKET;
196 st = urb0->iso_frame_desc[i].status;
198 st = urb->iso_frame_desc[i].status;
200 pr_err("ISOC data error: [%d] status=%d\n",
202 gspca_dev->last_packet_type = DISCARD_PACKET;
207 * The images are received in URBs of different endpoints
209 * Image pieces in URBs of ep 0x83 are continuated in URBs of
210 * ep 0x82 of the same index.
211 * The packets in the URBs of endpoint 0x83 start with:
212 * - 80 ba/bb 00 00 = start of image followed by 'ff d8'
213 * - 04 ba/bb oo oo = image piece
214 * where 'oo oo' is the image offset
216 * - (other -> bad frame)
217 * The images are JPEG encoded with full header and
219 * The end of image ('ff d9') may occur in any URB.
222 data = (u8 *) urb0->transfer_buffer
223 + urb0->iso_frame_desc[i].offset;
224 if (data[0] == 0x80 && (data[1] & 0xfe) == 0xba) {
227 gspca_frame_add(gspca_dev, LAST_PACKET,
229 gspca_frame_add(gspca_dev, FIRST_PACKET,
230 data + 4, SD_PKT_SZ - 4);
231 } else if (data[0] == 0x04 && (data[1] & 0xfe) == 0xba) {
232 gspca_frame_add(gspca_dev, INTER_PACKET,
233 data + 4, SD_PKT_SZ - 4);
235 gspca_dev->last_packet_type = DISCARD_PACKET;
238 data = (u8 *) urb->transfer_buffer
239 + urb->iso_frame_desc[i].offset;
240 gspca_frame_add(gspca_dev, INTER_PACKET,
244 /* resubmit the URBs */
245 st = usb_submit_urb(urb0, GFP_ATOMIC);
247 pr_err("usb_submit_urb(0) ret %d\n", st);
248 st = usb_submit_urb(urb, GFP_ATOMIC);
250 pr_err("usb_submit_urb() ret %d\n", st);
253 /* sub-driver description */
254 static const struct sd_desc sd_desc = {
257 .nctrls = ARRAY_SIZE(sd_ctrls),
262 .pkt_scan = sd_pkt_scan,
265 /* -- module initialisation -- */
266 static const struct usb_device_id device_table[] = {
267 {USB_DEVICE(0x04a5, 0x3035)},
270 MODULE_DEVICE_TABLE(usb, device_table);
272 /* -- device connect -- */
273 static int sd_probe(struct usb_interface *intf,
274 const struct usb_device_id *id)
276 return gspca_dev_probe(intf, id, &sd_desc, sizeof(struct sd),
280 static struct usb_driver sd_driver = {
282 .id_table = device_table,
284 .disconnect = gspca_disconnect,
286 .suspend = gspca_suspend,
287 .resume = gspca_resume,
291 /* -- module insert / remove -- */
292 static int __init sd_mod_init(void)
294 return usb_register(&sd_driver);
296 static void __exit sd_mod_exit(void)
298 usb_deregister(&sd_driver);
301 module_init(sd_mod_init);
302 module_exit(sd_mod_exit);