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 */
48 /* device information - set at probe time */
50 int bulk_size; /* buffer size when image transfer by bulk */
51 const struct v4l2_pix_format *cam_mode; /* size nmodes */
53 __u8 bulk_nurbs; /* number of URBs in bulk mode
54 * - cannot be > MAX_NURBS
55 * - when 0 and bulk_size != 0 means
56 * 1 URB and submit done by subdriver */
57 u8 bulk; /* image transfer by 0:isoc / 1:bulk */
58 u8 npkt; /* number of packets in an ISOC message
59 * 0 is the default value: 32 packets */
60 u32 input_flags; /* value for ENUM_INPUT status flags */
61 char reverse_alts; /* Alt settings are in high to low order */
67 /* subdriver operations */
68 typedef int (*cam_op) (struct gspca_dev *);
69 typedef void (*cam_v_op) (struct gspca_dev *);
70 typedef int (*cam_cf_op) (struct gspca_dev *, const struct usb_device_id *);
71 typedef int (*cam_jpg_op) (struct gspca_dev *,
72 struct v4l2_jpegcompression *);
73 typedef int (*cam_reg_op) (struct gspca_dev *,
74 struct v4l2_dbg_register *);
75 typedef int (*cam_ident_op) (struct gspca_dev *,
76 struct v4l2_dbg_chip_ident *);
77 typedef int (*cam_streamparm_op) (struct gspca_dev *,
78 struct v4l2_streamparm *);
79 typedef int (*cam_qmnu_op) (struct gspca_dev *,
80 struct v4l2_querymenu *);
81 typedef void (*cam_pkt_op) (struct gspca_dev *gspca_dev,
82 struct gspca_frame *frame,
87 struct v4l2_queryctrl qctrl;
88 int (*set)(struct gspca_dev *, __s32);
89 int (*get)(struct gspca_dev *, __s32 *);
92 /* subdriver description */
95 const char *name; /* sub-driver name */
97 const struct ctrl *ctrls;
99 /* mandatory operations */
100 cam_cf_op config; /* called on probe */
101 cam_op init; /* called on probe and resume */
102 cam_op start; /* called on stream on after URBs creation */
104 /* optional operations */
105 cam_op isoc_init; /* called on stream on before getting the EP */
106 cam_op isoc_nego; /* called when URB submit failed with NOSPC */
107 cam_v_op stopN; /* called on stream off - main alt */
108 cam_v_op stop0; /* called on stream off & disconnect - alt 0 */
109 cam_v_op dq_callback; /* called when a frame has been dequeued */
110 cam_jpg_op get_jcomp;
111 cam_jpg_op set_jcomp;
112 cam_qmnu_op querymenu;
113 cam_streamparm_op get_streamparm;
114 cam_streamparm_op set_streamparm;
115 #ifdef CONFIG_VIDEO_ADV_DEBUG
116 cam_reg_op set_register;
117 cam_reg_op get_register;
119 cam_ident_op get_chip_ident;
122 /* packet types when moving from iso buf to frame buf */
123 enum gspca_packet_type {
131 __u8 *data; /* frame buffer */
132 __u8 *data_end; /* end of frame while filling */
134 struct v4l2_buffer v4l2_buf;
138 struct video_device vdev; /* !! must be the first item */
139 struct module *module; /* subdriver handling the device */
140 struct usb_device *dev;
141 struct file *capt_file; /* file doing video capture */
143 struct cam cam; /* device information */
144 const struct sd_desc *sd_desc; /* subdriver description */
145 unsigned ctrl_dis; /* disabled controls (bit map) */
146 unsigned ctrl_inac; /* inactive controls (bit map) */
148 #define USB_BUF_SZ 64
149 __u8 *usb_buf; /* buffer for USB exchanges */
150 struct urb *urb[MAX_NURBS];
152 __u8 *frbuf; /* buffer for nframes */
153 struct gspca_frame frame[GSPCA_MAX_FRAMES];
154 struct gspca_frame *cur_frame; /* frame beeing filled */
155 __u32 frsz; /* frame size */
156 char nframes; /* number of frames */
157 char fr_i; /* frame being filled */
158 char fr_q; /* next frame to queue */
159 char fr_o; /* next frame to dequeue */
160 signed char fr_queue[GSPCA_MAX_FRAMES]; /* frame queue */
161 __u8 last_packet_type;
162 __s8 empty_packet; /* if (-1) don't check empty packets */
165 __u8 curr_mode; /* current camera mode */
166 __u32 pixfmt; /* current mode parameters */
169 __u32 sequence; /* frame sequence number */
171 wait_queue_head_t wq; /* wait queue */
172 struct mutex usb_lock; /* usb exchange protection */
173 struct mutex read_lock; /* read protection */
174 struct mutex queue_lock; /* ISOC queue protection */
176 char frozen; /* suspend - resume */
178 char users; /* number of opens */
179 char present; /* device connected */
180 char nbufread; /* number of buffers for read() */
181 char nurbs; /* number of allocated URBs */
182 char memory; /* memory type (V4L2_MEMORY_xxx) */
183 __u8 iface; /* USB interface number */
184 __u8 alt; /* USB alternate setting */
185 __u8 nbalt; /* number of USB alternate settings */
186 u16 pkt_size; /* ISOC packet size */
189 int gspca_dev_probe(struct usb_interface *intf,
190 const struct usb_device_id *id,
191 const struct sd_desc *sd_desc,
193 struct module *module);
194 void gspca_disconnect(struct usb_interface *intf);
195 struct gspca_frame *gspca_frame_add(struct gspca_dev *gspca_dev,
196 enum gspca_packet_type packet_type,
197 struct gspca_frame *frame,
200 struct gspca_frame *gspca_get_i_frame(struct gspca_dev *gspca_dev);
202 int gspca_suspend(struct usb_interface *intf, pm_message_t message);
203 int gspca_resume(struct usb_interface *intf);
205 int gspca_auto_gain_n_exposure(struct gspca_dev *gspca_dev, int avg_lum,
206 int desired_avg_lum, int deadzone, int gain_knee, int exposure_knee);
207 #endif /* GSPCAV2_H */