1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3 * Benq DC E300 subdriver
4 *
5 * Copyright (C) 2009 Jean-Francois Moine (http://moinejf.free.fr)
6 */
7
8 #define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
9
10 #define MODULE_NAME "benq"
11
12 #include "gspca.h"
13
14 MODULE_AUTHOR("Jean-Francois Moine <http://moinejf.free.fr>");
15 MODULE_DESCRIPTION("Benq DC E300 USB Camera Driver");
16 MODULE_LICENSE("GPL");
17
18 /* specific webcam descriptor */
19 struct sd {
20 struct gspca_dev gspca_dev; /* !! must be the first item */
21 };
22
23 static const struct v4l2_pix_format vga_mode[] = {
24 {320, 240, V4L2_PIX_FMT_JPEG, V4L2_FIELD_NONE,
25 .bytesperline = 320,
26 .sizeimage = 320 * 240 * 3 / 8 + 590,
27 .colorspace = V4L2_COLORSPACE_JPEG},
28 };
29
30 static void sd_isoc_irq(struct urb *urb);
31
32 /* -- write a register -- */
reg_w(struct gspca_dev * gspca_dev,u16 value,u16 index)33 static void reg_w(struct gspca_dev *gspca_dev,
34 u16 value, u16 index)
35 {
36 struct usb_device *dev = gspca_dev->dev;
37 int ret;
38
39 if (gspca_dev->usb_err < 0)
40 return;
41 ret = usb_control_msg(dev, usb_sndctrlpipe(dev, 0),
42 0x02,
43 USB_DIR_OUT | USB_TYPE_VENDOR | USB_RECIP_DEVICE,
44 value,
45 index,
46 NULL,
47 0,
48 500);
49 if (ret < 0) {
50 pr_err("reg_w err %d\n", ret);
51 gspca_dev->usb_err = ret;
52 }
53 }
54
55 /* this function is called at probe time */
sd_config(struct gspca_dev * gspca_dev,const struct usb_device_id * id)56 static int sd_config(struct gspca_dev *gspca_dev,
57 const struct usb_device_id *id)
58 {
59 gspca_dev->cam.cam_mode = vga_mode;
60 gspca_dev->cam.nmodes = ARRAY_SIZE(vga_mode);
61 gspca_dev->cam.no_urb_create = 1;
62 return 0;
63 }
64
65 /* this function is called at probe and resume time */
sd_init(struct gspca_dev * gspca_dev)66 static int sd_init(struct gspca_dev *gspca_dev)
67 {
68 return 0;
69 }
70
71 /* -- start the camera -- */
sd_start(struct gspca_dev * gspca_dev)72 static int sd_start(struct gspca_dev *gspca_dev)
73 {
74 struct urb *urb;
75 int i, n;
76
77 /* create 4 URBs - 2 on endpoint 0x83 and 2 on 0x082 */
78 #if MAX_NURBS < 4
79 #error "Not enough URBs in the gspca table"
80 #endif
81 #define SD_PKT_SZ 64
82 #define SD_NPKT 32
83 for (n = 0; n < 4; n++) {
84 urb = usb_alloc_urb(SD_NPKT, GFP_KERNEL);
85 if (!urb)
86 return -ENOMEM;
87 gspca_dev->urb[n] = urb;
88 urb->transfer_buffer = usb_alloc_coherent(gspca_dev->dev,
89 SD_PKT_SZ * SD_NPKT,
90 GFP_KERNEL,
91 &urb->transfer_dma);
92
93 if (urb->transfer_buffer == NULL) {
94 pr_err("usb_alloc_coherent failed\n");
95 return -ENOMEM;
96 }
97 urb->dev = gspca_dev->dev;
98 urb->context = gspca_dev;
99 urb->transfer_buffer_length = SD_PKT_SZ * SD_NPKT;
100 urb->pipe = usb_rcvisocpipe(gspca_dev->dev,
101 n & 1 ? 0x82 : 0x83);
102 urb->transfer_flags = URB_ISO_ASAP
103 | URB_NO_TRANSFER_DMA_MAP;
104 urb->interval = 1;
105 urb->complete = sd_isoc_irq;
106 urb->number_of_packets = SD_NPKT;
107 for (i = 0; i < SD_NPKT; i++) {
108 urb->iso_frame_desc[i].length = SD_PKT_SZ;
109 urb->iso_frame_desc[i].offset = SD_PKT_SZ * i;
110 }
111 }
112
113 return gspca_dev->usb_err;
114 }
115
sd_stopN(struct gspca_dev * gspca_dev)116 static void sd_stopN(struct gspca_dev *gspca_dev)
117 {
118 struct usb_interface *intf;
119
120 reg_w(gspca_dev, 0x003c, 0x0003);
121 reg_w(gspca_dev, 0x003c, 0x0004);
122 reg_w(gspca_dev, 0x003c, 0x0005);
123 reg_w(gspca_dev, 0x003c, 0x0006);
124 reg_w(gspca_dev, 0x003c, 0x0007);
125
126 intf = usb_ifnum_to_if(gspca_dev->dev, gspca_dev->iface);
127 usb_set_interface(gspca_dev->dev, gspca_dev->iface,
128 intf->num_altsetting - 1);
129 }
130
sd_pkt_scan(struct gspca_dev * gspca_dev,u8 * data,int len)131 static void sd_pkt_scan(struct gspca_dev *gspca_dev,
132 u8 *data, /* isoc packet */
133 int len) /* iso packet length */
134 {
135 /* unused */
136 }
137
138 /* reception of an URB */
sd_isoc_irq(struct urb * urb)139 static void sd_isoc_irq(struct urb *urb)
140 {
141 struct gspca_dev *gspca_dev = (struct gspca_dev *) urb->context;
142 struct urb *urb0;
143 u8 *data;
144 int i, st;
145
146 gspca_dbg(gspca_dev, D_PACK, "sd isoc irq\n");
147 if (!gspca_dev->streaming)
148 return;
149 if (urb->status != 0) {
150 if (urb->status == -ESHUTDOWN)
151 return; /* disconnection */
152 #ifdef CONFIG_PM
153 if (gspca_dev->frozen)
154 return;
155 #endif
156 pr_err("urb status: %d\n", urb->status);
157 return;
158 }
159
160 /* if this is a control URN (ep 0x83), wait */
161 if (urb == gspca_dev->urb[0] || urb == gspca_dev->urb[2])
162 return;
163
164 /* scan both received URBs */
165 if (urb == gspca_dev->urb[1])
166 urb0 = gspca_dev->urb[0];
167 else
168 urb0 = gspca_dev->urb[2];
169 for (i = 0; i < urb->number_of_packets; i++) {
170
171 /* check the packet status and length */
172 if (urb0->iso_frame_desc[i].actual_length != SD_PKT_SZ
173 || urb->iso_frame_desc[i].actual_length != SD_PKT_SZ) {
174 gspca_err(gspca_dev, "ISOC bad lengths %d / %d\n",
175 urb0->iso_frame_desc[i].actual_length,
176 urb->iso_frame_desc[i].actual_length);
177 gspca_dev->last_packet_type = DISCARD_PACKET;
178 continue;
179 }
180 st = urb0->iso_frame_desc[i].status;
181 if (st == 0)
182 st = urb->iso_frame_desc[i].status;
183 if (st) {
184 pr_err("ISOC data error: [%d] status=%d\n",
185 i, st);
186 gspca_dev->last_packet_type = DISCARD_PACKET;
187 continue;
188 }
189
190 /*
191 * The images are received in URBs of different endpoints
192 * (0x83 and 0x82).
193 * Image pieces in URBs of ep 0x83 are continuated in URBs of
194 * ep 0x82 of the same index.
195 * The packets in the URBs of endpoint 0x83 start with:
196 * - 80 ba/bb 00 00 = start of image followed by 'ff d8'
197 * - 04 ba/bb oo oo = image piece
198 * where 'oo oo' is the image offset
199 (not checked)
200 * - (other -> bad frame)
201 * The images are JPEG encoded with full header and
202 * normal ff escape.
203 * The end of image ('ff d9') may occur in any URB.
204 * (not checked)
205 */
206 data = (u8 *) urb0->transfer_buffer
207 + urb0->iso_frame_desc[i].offset;
208 if (data[0] == 0x80 && (data[1] & 0xfe) == 0xba) {
209
210 /* new image */
211 gspca_frame_add(gspca_dev, LAST_PACKET,
212 NULL, 0);
213 gspca_frame_add(gspca_dev, FIRST_PACKET,
214 data + 4, SD_PKT_SZ - 4);
215 } else if (data[0] == 0x04 && (data[1] & 0xfe) == 0xba) {
216 gspca_frame_add(gspca_dev, INTER_PACKET,
217 data + 4, SD_PKT_SZ - 4);
218 } else {
219 gspca_dev->last_packet_type = DISCARD_PACKET;
220 continue;
221 }
222 data = (u8 *) urb->transfer_buffer
223 + urb->iso_frame_desc[i].offset;
224 gspca_frame_add(gspca_dev, INTER_PACKET,
225 data, SD_PKT_SZ);
226 }
227
228 /* resubmit the URBs */
229 st = usb_submit_urb(urb0, GFP_ATOMIC);
230 if (st < 0)
231 pr_err("usb_submit_urb(0) ret %d\n", st);
232 st = usb_submit_urb(urb, GFP_ATOMIC);
233 if (st < 0)
234 pr_err("usb_submit_urb() ret %d\n", st);
235 }
236
237 /* sub-driver description */
238 static const struct sd_desc sd_desc = {
239 .name = MODULE_NAME,
240 .config = sd_config,
241 .init = sd_init,
242 .start = sd_start,
243 .stopN = sd_stopN,
244 .pkt_scan = sd_pkt_scan,
245 };
246
247 /* -- module initialisation -- */
248 static const struct usb_device_id device_table[] = {
249 {USB_DEVICE(0x04a5, 0x3035)},
250 {}
251 };
252 MODULE_DEVICE_TABLE(usb, device_table);
253
254 /* -- device connect -- */
sd_probe(struct usb_interface * intf,const struct usb_device_id * id)255 static int sd_probe(struct usb_interface *intf,
256 const struct usb_device_id *id)
257 {
258 return gspca_dev_probe(intf, id, &sd_desc, sizeof(struct sd),
259 THIS_MODULE);
260 }
261
262 static struct usb_driver sd_driver = {
263 .name = MODULE_NAME,
264 .id_table = device_table,
265 .probe = sd_probe,
266 .disconnect = gspca_disconnect,
267 #ifdef CONFIG_PM
268 .suspend = gspca_suspend,
269 .resume = gspca_resume,
270 .reset_resume = gspca_resume,
271 #endif
272 };
273
274 module_usb_driver(sd_driver);
275