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...) \
36 printk(KERN_ERR MODULE_NAME ": " fmt "\n", ## args)
38 #define info(fmt, args...) \
39 printk(KERN_INFO MODULE_NAME ": " fmt "\n", ## args)
41 #define warn(fmt, args...) \
42 printk(KERN_WARNING MODULE_NAME ": " fmt "\n", ## args)
44 #define GSPCA_MAX_FRAMES 16 /* maximum number of video frame buffers */
46 #define MAX_NURBS 4 /* max number of URBs */
49 /* used to list framerates supported by a camera mode (resolution) */
55 /* device information - set at probe time */
57 int bulk_size; /* buffer size when image transfer by bulk */
58 const struct v4l2_pix_format *cam_mode; /* size nmodes */
60 const struct framerates *mode_framerates; /* must have size nmode,
61 * just like cam_mode */
62 __u8 bulk_nurbs; /* number of URBs in bulk mode
63 * - cannot be > MAX_NURBS
64 * - when 0 and bulk_size != 0 means
65 * 1 URB and submit done by subdriver */
66 u8 bulk; /* image transfer by 0:isoc / 1:bulk */
67 u8 npkt; /* number of packets in an ISOC message
68 * 0 is the default value: 32 packets */
69 u32 input_flags; /* value for ENUM_INPUT status flags */
70 char reverse_alts; /* Alt settings are in high to low order */
76 /* subdriver operations */
77 typedef int (*cam_op) (struct gspca_dev *);
78 typedef void (*cam_v_op) (struct gspca_dev *);
79 typedef int (*cam_cf_op) (struct gspca_dev *, const struct usb_device_id *);
80 typedef int (*cam_jpg_op) (struct gspca_dev *,
81 struct v4l2_jpegcompression *);
82 typedef int (*cam_reg_op) (struct gspca_dev *,
83 struct v4l2_dbg_register *);
84 typedef int (*cam_ident_op) (struct gspca_dev *,
85 struct v4l2_dbg_chip_ident *);
86 typedef int (*cam_streamparm_op) (struct gspca_dev *,
87 struct v4l2_streamparm *);
88 typedef int (*cam_qmnu_op) (struct gspca_dev *,
89 struct v4l2_querymenu *);
90 typedef void (*cam_pkt_op) (struct gspca_dev *gspca_dev,
95 struct v4l2_queryctrl qctrl;
96 int (*set)(struct gspca_dev *, __s32);
97 int (*get)(struct gspca_dev *, __s32 *);
100 /* subdriver description */
103 const char *name; /* sub-driver name */
105 const struct ctrl *ctrls;
107 /* mandatory operations */
108 cam_cf_op config; /* called on probe */
109 cam_op init; /* called on probe and resume */
110 cam_op start; /* called on stream on after URBs creation */
112 /* optional operations */
113 cam_op isoc_init; /* called on stream on before getting the EP */
114 cam_op isoc_nego; /* called when URB submit failed with NOSPC */
115 cam_v_op stopN; /* called on stream off - main alt */
116 cam_v_op stop0; /* called on stream off & disconnect - alt 0 */
117 cam_v_op dq_callback; /* called when a frame has been dequeued */
118 cam_jpg_op get_jcomp;
119 cam_jpg_op set_jcomp;
120 cam_qmnu_op querymenu;
121 cam_streamparm_op get_streamparm;
122 cam_streamparm_op set_streamparm;
123 #ifdef CONFIG_VIDEO_ADV_DEBUG
124 cam_reg_op set_register;
125 cam_reg_op get_register;
127 cam_ident_op get_chip_ident;
130 /* packet types when moving from iso buf to frame buf */
131 enum gspca_packet_type {
139 __u8 *data; /* frame buffer */
140 __u8 *data_end; /* end of frame while filling */
142 struct v4l2_buffer v4l2_buf;
146 struct video_device vdev; /* !! must be the first item */
147 struct module *module; /* subdriver handling the device */
148 struct usb_device *dev;
149 struct file *capt_file; /* file doing video capture */
151 struct cam cam; /* device information */
152 const struct sd_desc *sd_desc; /* subdriver description */
153 unsigned ctrl_dis; /* disabled controls (bit map) */
154 unsigned ctrl_inac; /* inactive controls (bit map) */
156 #define USB_BUF_SZ 64
157 __u8 *usb_buf; /* buffer for USB exchanges */
158 struct urb *urb[MAX_NURBS];
160 __u8 *frbuf; /* buffer for nframes */
161 struct gspca_frame frame[GSPCA_MAX_FRAMES];
162 struct gspca_frame *cur_frame; /* frame beeing filled */
163 __u32 frsz; /* frame size */
164 char nframes; /* number of frames */
165 char fr_i; /* frame being filled */
166 char fr_q; /* next frame to queue */
167 char fr_o; /* next frame to dequeue */
168 signed char fr_queue[GSPCA_MAX_FRAMES]; /* frame queue */
169 __u8 last_packet_type;
170 __s8 empty_packet; /* if (-1) don't check empty packets */
173 __u8 curr_mode; /* current camera mode */
174 __u32 pixfmt; /* current mode parameters */
177 __u32 sequence; /* frame sequence number */
179 wait_queue_head_t wq; /* wait queue */
180 struct mutex usb_lock; /* usb exchange protection */
181 struct mutex read_lock; /* read protection */
182 struct mutex queue_lock; /* ISOC queue protection */
184 char frozen; /* suspend - resume */
186 char users; /* number of opens */
187 char present; /* device connected */
188 char nbufread; /* number of buffers for read() */
189 char nurbs; /* number of allocated URBs */
190 char memory; /* memory type (V4L2_MEMORY_xxx) */
191 __u8 iface; /* USB interface number */
192 __u8 alt; /* USB alternate setting */
193 __u8 nbalt; /* number of USB alternate settings */
194 u16 pkt_size; /* ISOC packet size */
197 int gspca_dev_probe(struct usb_interface *intf,
198 const struct usb_device_id *id,
199 const struct sd_desc *sd_desc,
201 struct module *module);
202 void gspca_disconnect(struct usb_interface *intf);
203 void gspca_frame_add(struct gspca_dev *gspca_dev,
204 enum gspca_packet_type packet_type,
207 struct gspca_frame *gspca_get_i_frame(struct gspca_dev *gspca_dev);
209 int gspca_suspend(struct usb_interface *intf, pm_message_t message);
210 int gspca_resume(struct usb_interface *intf);
212 int gspca_auto_gain_n_exposure(struct gspca_dev *gspca_dev, int avg_lum,
213 int desired_avg_lum, int deadzone, int gain_knee, int exposure_knee);
214 #endif /* GSPCAV2_H */