4 #include <linux/module.h>
5 #include <linux/kernel.h>
7 #include <linux/videodev2.h>
8 #include <media/v4l2-common.h>
9 #include <linux/mutex.h>
11 /* compilation option */
15 /* GSPCA our debug messages */
16 extern int gspca_debug;
17 #define PDEBUG(level, fmt, args...) \
19 if (gspca_debug & (level)) \
20 printk(KERN_INFO MODULE_NAME ": " fmt "\n", ## args); \
32 #define PDEBUG(level, fmt, args...)
35 #define err(fmt, args...) \
37 printk(KERN_ERR MODULE_NAME ": " fmt "\n", ## args); \
40 #define info(fmt, args...) \
42 printk(KERN_INFO MODULE_NAME ": " fmt "\n", ## args); \
45 #define warn(fmt, args...) \
47 printk(KERN_WARNING MODULE_NAME ": " fmt "\n", ## args); \
50 #define GSPCA_MAX_FRAMES 16 /* maximum number of video frame buffers */
52 #define MAX_NURBS 4 /* max number of URBs */
53 #define ISO_MAX_PKT 32 /* max number of packets in an ISOC transfer */
54 #define ISO_MAX_SIZE 0x8000 /* max size of one URB buffer (32 Kb) */
56 /* device information - set at probe time */
58 int bulk_size; /* buffer size when image transfer by bulk */
59 struct v4l2_pix_format *cam_mode; /* size nmodes */
61 __u8 bulk_nurbs; /* number of URBs in bulk mode
62 * - cannot be > MAX_NURBS
63 * - when 0 and bulk_size != 0 means
64 * 1 URB and submit done by subdriver */
71 /* subdriver operations */
72 typedef int (*cam_op) (struct gspca_dev *);
73 typedef void (*cam_v_op) (struct gspca_dev *);
74 typedef int (*cam_cf_op) (struct gspca_dev *, const struct usb_device_id *);
75 typedef int (*cam_jpg_op) (struct gspca_dev *,
76 struct v4l2_jpegcompression *);
77 typedef int (*cam_qmnu_op) (struct gspca_dev *,
78 struct v4l2_querymenu *);
79 typedef void (*cam_pkt_op) (struct gspca_dev *gspca_dev,
80 struct gspca_frame *frame,
85 struct v4l2_queryctrl qctrl;
86 int (*set)(struct gspca_dev *, __s32);
87 int (*get)(struct gspca_dev *, __s32 *);
90 /* subdriver description */
93 const char *name; /* sub-driver name */
95 const struct ctrl *ctrls;
97 /* mandatory operations */
98 cam_cf_op config; /* called on probe */
99 cam_op init; /* called on probe and resume */
100 cam_op start; /* called on stream on */
102 /* optional operations */
103 cam_v_op stopN; /* called on stream off - main alt */
104 cam_v_op stop0; /* called on stream off & disconnect - alt 0 */
105 cam_v_op dq_callback; /* called when a frame has been dequeued */
106 cam_jpg_op get_jcomp;
107 cam_jpg_op set_jcomp;
108 cam_qmnu_op querymenu;
111 /* packet types when moving from iso buf to frame buf */
112 enum gspca_packet_type {
120 __u8 *data; /* frame buffer */
121 __u8 *data_end; /* end of frame while filling */
123 struct v4l2_buffer v4l2_buf;
127 struct video_device vdev; /* !! must be the first item */
128 struct module *module; /* subdriver handling the device */
129 struct usb_device *dev;
130 struct file *capt_file; /* file doing video capture */
132 struct cam cam; /* device information */
133 const struct sd_desc *sd_desc; /* subdriver description */
134 unsigned ctrl_dis; /* disabled controls (bit map) */
136 #define USB_BUF_SZ 64
137 __u8 *usb_buf; /* buffer for USB exchanges */
138 struct urb *urb[MAX_NURBS];
140 __u8 *frbuf; /* buffer for nframes */
141 struct gspca_frame frame[GSPCA_MAX_FRAMES];
142 __u32 frsz; /* frame size */
143 char nframes; /* number of frames */
144 char fr_i; /* frame being filled */
145 char fr_q; /* next frame to queue */
146 char fr_o; /* next frame to dequeue */
147 signed char fr_queue[GSPCA_MAX_FRAMES]; /* frame queue */
148 __u8 last_packet_type;
149 __s8 empty_packet; /* if (-1) don't check empty packets */
152 __u8 curr_mode; /* current camera mode */
153 __u32 pixfmt; /* current mode parameters */
156 __u32 sequence; /* frame sequence number */
158 wait_queue_head_t wq; /* wait queue */
159 struct mutex usb_lock; /* usb exchange protection */
160 struct mutex read_lock; /* read protection */
161 struct mutex queue_lock; /* ISOC queue protection */
163 char frozen; /* suspend - resume */
165 char users; /* number of opens */
166 char present; /* device connected */
167 char nbufread; /* number of buffers for read() */
168 char nurbs; /* number of allocated URBs */
169 char memory; /* memory type (V4L2_MEMORY_xxx) */
170 __u8 iface; /* USB interface number */
171 __u8 alt; /* USB alternate setting */
172 __u8 nbalt; /* number of USB alternate settings */
175 int gspca_dev_probe(struct usb_interface *intf,
176 const struct usb_device_id *id,
177 const struct sd_desc *sd_desc,
179 struct module *module);
180 void gspca_disconnect(struct usb_interface *intf);
181 struct gspca_frame *gspca_frame_add(struct gspca_dev *gspca_dev,
182 enum gspca_packet_type packet_type,
183 struct gspca_frame *frame,
186 struct gspca_frame *gspca_get_i_frame(struct gspca_dev *gspca_dev);
188 int gspca_suspend(struct usb_interface *intf, pm_message_t message);
189 int gspca_resume(struct usb_interface *intf);
191 int gspca_auto_gain_n_exposure(struct gspca_dev *gspca_dev, int avg_lum,
192 int desired_avg_lum, int deadzone, int gain_knee, int exposure_knee);
193 #endif /* GSPCAV2_H */