2 * Fujifilm Finepix subdriver
4 * Copyright (C) 2008 Frank Zago
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 MODULE_NAME "finepix"
25 MODULE_AUTHOR("Frank Zago <frank@zago.net>");
26 MODULE_DESCRIPTION("Fujifilm FinePix USB V4L2 driver");
27 MODULE_LICENSE("GPL");
29 /* Default timeout, in ms */
30 #define FPIX_TIMEOUT 250
32 /* Maximum transfer size to use. The windows driver reads by chunks of
33 * 0x2000 bytes, so do the same. Note: reading more seems to work
35 #define FPIX_MAX_TRANSFER 0x2000
37 /* Structure to hold all of our device specific stuff */
39 struct gspca_dev gspca_dev; /* !! must be the first item */
41 struct work_struct work_struct;
42 struct workqueue_struct *work_thread;
45 /* Delay after which claim the next frame. If the delay is too small,
46 * the camera will return old frames. On the 4800Z, 20ms is bad, 25ms
47 * will fail every 4 or 5 frames, but 30ms is perfect. On the A210,
48 * 30ms is bad while 35ms is perfect. */
49 #define NEXT_FRAME_DELAY 35
51 /* These cameras only support 320x200. */
52 static const struct v4l2_pix_format fpix_mode[1] = {
53 { 320, 240, V4L2_PIX_FMT_JPEG, V4L2_FIELD_NONE,
55 .sizeimage = 320 * 240 * 3 / 8 + 590,
56 .colorspace = V4L2_COLORSPACE_SRGB,
60 /* send a command to the webcam */
61 static int command(struct gspca_dev *gspca_dev,
62 int order) /* 0: reset, 1: frame request */
64 static u8 order_values[2][12] = {
65 {0xc6, 0, 0, 0, 0, 0, 0, 0, 0x20, 0, 0, 0}, /* reset */
66 {0xd3, 0, 0, 0, 0, 0, 0, 0x01, 0, 0, 0, 0}, /* fr req */
69 memcpy(gspca_dev->usb_buf, order_values[order], 12);
70 return usb_control_msg(gspca_dev->dev,
71 usb_sndctrlpipe(gspca_dev->dev, 0),
73 USB_DIR_OUT | USB_TYPE_CLASS |
74 USB_RECIP_INTERFACE, 0, 0, gspca_dev->usb_buf,
79 static void dostream(struct work_struct *work)
81 struct usb_fpix *dev = container_of(work, struct usb_fpix, work_struct);
82 struct gspca_dev *gspca_dev = &dev->gspca_dev;
83 struct urb *urb = gspca_dev->urb[0];
84 u8 *data = urb->transfer_buffer;
85 struct gspca_frame *frame;
89 /* synchronize with the main driver */
90 mutex_lock(&gspca_dev->usb_lock);
91 mutex_unlock(&gspca_dev->usb_lock);
92 PDEBUG(D_STREAM, "dostream started");
94 /* loop reading a frame */
96 while (gspca_dev->present && gspca_dev->streaming) {
99 mutex_lock(&gspca_dev->usb_lock);
100 ret = command(gspca_dev, 1);
101 mutex_unlock(&gspca_dev->usb_lock);
104 if (!gspca_dev->present || !gspca_dev->streaming)
107 /* the frame comes in parts */
109 ret = usb_bulk_msg(gspca_dev->dev,
115 /* Most of the time we get a timeout
116 * error. Just restart. */
119 if (!gspca_dev->present || !gspca_dev->streaming)
121 frame = gspca_get_i_frame(&dev->gspca_dev);
123 gspca_dev->last_packet_type = DISCARD_PACKET;
125 if (len < FPIX_MAX_TRANSFER ||
126 (data[len - 2] == 0xff &&
127 data[len - 1] == 0xd9)) {
129 /* If the result is less than what was asked
130 * for, then it's the end of the
131 * frame. Sometimes the jpeg is not complete,
132 * but there's nothing we can do. We also end
133 * here if the the jpeg ends right at the end
136 frame = gspca_frame_add(gspca_dev,
143 /* got a partial image */
145 gspca_frame_add(gspca_dev,
146 gspca_dev->last_packet_type
148 ? FIRST_PACKET : INTER_PACKET,
152 /* We must wait before trying reading the next
153 * frame. If we don't, or if the delay is too short,
154 * the camera will disconnect. */
155 msleep(NEXT_FRAME_DELAY);
159 PDEBUG(D_STREAM, "dostream stopped");
162 /* this function is called at probe time */
163 static int sd_config(struct gspca_dev *gspca_dev,
164 const struct usb_device_id *id)
166 struct usb_fpix *dev = (struct usb_fpix *) gspca_dev;
167 struct cam *cam = &gspca_dev->cam;
169 cam->cam_mode = fpix_mode;
172 cam->bulk_size = FPIX_MAX_TRANSFER;
174 INIT_WORK(&dev->work_struct, dostream);
179 /* this function is called at probe and resume time */
180 static int sd_init(struct gspca_dev *gspca_dev)
185 /* start the camera */
186 static int sd_start(struct gspca_dev *gspca_dev)
188 struct usb_fpix *dev = (struct usb_fpix *) gspca_dev;
191 /* Init the device */
192 ret = command(gspca_dev, 0);
194 PDEBUG(D_STREAM, "init failed %d", ret);
198 /* Read the result of the command. Ignore the result, for it
199 * varies with the device. */
200 ret = usb_bulk_msg(gspca_dev->dev,
201 gspca_dev->urb[0]->pipe,
202 gspca_dev->urb[0]->transfer_buffer,
203 FPIX_MAX_TRANSFER, &len,
206 PDEBUG(D_STREAM, "usb_bulk_msg failed %d", ret);
210 /* Request a frame, but don't read it */
211 ret = command(gspca_dev, 1);
213 PDEBUG(D_STREAM, "frame request failed %d", ret);
217 /* Again, reset bulk in endpoint */
218 usb_clear_halt(gspca_dev->dev, gspca_dev->urb[0]->pipe);
220 /* Start the workqueue function to do the streaming */
221 dev->work_thread = create_singlethread_workqueue(MODULE_NAME);
222 queue_work(dev->work_thread, &dev->work_struct);
227 /* called on streamoff with alt==0 and on disconnect */
228 /* the usb_lock is held at entry - restore on exit */
229 static void sd_stop0(struct gspca_dev *gspca_dev)
231 struct usb_fpix *dev = (struct usb_fpix *) gspca_dev;
233 /* wait for the work queue to terminate */
234 mutex_unlock(&gspca_dev->usb_lock);
235 destroy_workqueue(dev->work_thread);
236 mutex_lock(&gspca_dev->usb_lock);
237 dev->work_thread = NULL;
240 /* Table of supported USB devices */
241 static const __devinitdata struct usb_device_id device_table[] = {
242 {USB_DEVICE(0x04cb, 0x0104)},
243 {USB_DEVICE(0x04cb, 0x0109)},
244 {USB_DEVICE(0x04cb, 0x010b)},
245 {USB_DEVICE(0x04cb, 0x010f)},
246 {USB_DEVICE(0x04cb, 0x0111)},
247 {USB_DEVICE(0x04cb, 0x0113)},
248 {USB_DEVICE(0x04cb, 0x0115)},
249 {USB_DEVICE(0x04cb, 0x0117)},
250 {USB_DEVICE(0x04cb, 0x0119)},
251 {USB_DEVICE(0x04cb, 0x011b)},
252 {USB_DEVICE(0x04cb, 0x011d)},
253 {USB_DEVICE(0x04cb, 0x0121)},
254 {USB_DEVICE(0x04cb, 0x0123)},
255 {USB_DEVICE(0x04cb, 0x0125)},
256 {USB_DEVICE(0x04cb, 0x0127)},
257 {USB_DEVICE(0x04cb, 0x0129)},
258 {USB_DEVICE(0x04cb, 0x012b)},
259 {USB_DEVICE(0x04cb, 0x012d)},
260 {USB_DEVICE(0x04cb, 0x012f)},
261 {USB_DEVICE(0x04cb, 0x0131)},
262 {USB_DEVICE(0x04cb, 0x013b)},
263 {USB_DEVICE(0x04cb, 0x013d)},
264 {USB_DEVICE(0x04cb, 0x013f)},
268 MODULE_DEVICE_TABLE(usb, device_table);
270 /* sub-driver description */
271 static const struct sd_desc sd_desc = {
279 /* -- device connect -- */
280 static int sd_probe(struct usb_interface *intf,
281 const struct usb_device_id *id)
283 return gspca_dev_probe(intf, id,
285 sizeof(struct usb_fpix),
289 static struct usb_driver sd_driver = {
291 .id_table = device_table,
293 .disconnect = gspca_disconnect,
295 .suspend = gspca_suspend,
296 .resume = gspca_resume,
300 /* -- module insert / remove -- */
301 static int __init sd_mod_init(void)
305 ret = usb_register(&sd_driver);
308 PDEBUG(D_PROBE, "registered");
312 static void __exit sd_mod_exit(void)
314 usb_deregister(&sd_driver);
315 PDEBUG(D_PROBE, "deregistered");
318 module_init(sd_mod_init);
319 module_exit(sd_mod_exit);