4 #include <linux/module.h>
5 #include <linux/version.h>
6 #include <linux/kernel.h>
8 #include <linux/videodev2.h>
9 #include <media/v4l2-common.h>
10 #include <linux/mutex.h>
12 /* compilation option */
16 /* GSPCA our debug messages */
17 extern int gspca_debug;
18 #define PDEBUG(level, fmt, args...) \
20 if (gspca_debug & (level)) \
21 printk(KERN_INFO MODULE_NAME ": " fmt "\n", ## args); \
33 #define PDEBUG(level, fmt, args...)
36 #define err(fmt, args...) \
38 printk(KERN_ERR MODULE_NAME ": " fmt "\n", ## args); \
41 #define info(fmt, args...) \
43 printk(KERN_INFO MODULE_NAME ": " fmt "\n", ## args); \
46 #define warn(fmt, args...) \
48 printk(KERN_WARNING MODULE_NAME ": " fmt "\n", ## args); \
51 #define GSPCA_MAX_FRAMES 16 /* maximum number of video frame buffers */
53 #define MAX_NURBS 4 /* max number of URBs */
54 #define ISO_MAX_PKT 32 /* max number of packets in an ISOC transfer */
55 #define ISO_MAX_SIZE 0x8000 /* max size of one URB buffer (32 Kb) */
57 /* device information - set at probe time */
59 struct v4l2_pix_format *cam_mode; /* size nmodes */
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_qmnu_op) (struct gspca_dev *,
74 struct v4l2_querymenu *);
75 typedef void (*cam_pkt_op) (struct gspca_dev *gspca_dev,
76 struct gspca_frame *frame,
81 struct v4l2_queryctrl qctrl;
82 int (*set)(struct gspca_dev *, __s32);
83 int (*get)(struct gspca_dev *, __s32 *);
86 /* subdriver description */
89 const char *name; /* sub-driver name */
91 const struct ctrl *ctrls;
93 /* mandatory operations */
94 cam_cf_op config; /* called on probe */
95 cam_op init; /* called on probe and resume */
96 cam_op start; /* called on stream on */
98 /* optional operations */
99 cam_v_op stopN; /* called on stream off - main alt */
100 cam_v_op stop0; /* called on stream off - alt 0 */
101 cam_v_op dq_callback; /* called when a frame has been dequeued */
102 cam_jpg_op get_jcomp;
103 cam_jpg_op set_jcomp;
104 cam_qmnu_op querymenu;
107 /* packet types when moving from iso buf to frame buf */
108 #define DISCARD_PACKET 0
109 #define FIRST_PACKET 1
110 #define INTER_PACKET 2
111 #define LAST_PACKET 3
114 __u8 *data; /* frame buffer */
115 __u8 *data_end; /* end of frame while filling */
117 struct v4l2_buffer v4l2_buf;
121 struct video_device vdev; /* !! must be the first item */
122 struct file_operations fops;
123 struct usb_device *dev;
125 struct file *capt_file; /* file doing video capture */
127 struct cam cam; /* device information */
128 const struct sd_desc *sd_desc; /* subdriver description */
129 unsigned ctrl_dis; /* disabled controls (bit map) */
131 #define USB_BUF_SZ 64
132 __u8 *usb_buf; /* buffer for USB exchanges */
133 struct urb *urb[MAX_NURBS];
135 __u8 *frbuf; /* buffer for nframes */
136 struct gspca_frame frame[GSPCA_MAX_FRAMES];
137 __u32 frsz; /* frame size */
138 char nframes; /* number of frames */
139 char fr_i; /* frame being filled */
140 char fr_q; /* next frame to queue */
141 char fr_o; /* next frame to dequeue */
142 signed char fr_queue[GSPCA_MAX_FRAMES]; /* frame queue */
143 char last_packet_type;
145 __u8 iface; /* USB interface number */
146 __u8 alt; /* USB alternate setting */
147 __u8 bulk; /* image transfer by isoc (0) or bulk (1) */
148 __u8 curr_mode; /* current camera mode */
149 __u32 pixfmt; /* current mode parameters */
153 atomic_t nevent; /* number of frames done */
154 wait_queue_head_t wq; /* wait queue */
155 struct mutex usb_lock; /* usb exchange protection */
156 struct mutex read_lock; /* read protection */
157 struct mutex queue_lock; /* ISOC queue protection */
158 __u32 sequence; /* frame sequence number */
161 char frozen; /* suspend - resume */
163 char users; /* number of opens */
164 char present; /* device connected */
165 char nbufread; /* number of buffers for read() */
166 char nurbs; /* number of allocated URBs */
167 char memory; /* memory type (V4L2_MEMORY_xxx) */
168 __u8 nbalt; /* number of USB alternate settings */
171 int gspca_dev_probe(struct usb_interface *intf,
172 const struct usb_device_id *id,
173 const struct sd_desc *sd_desc,
175 struct module *module);
176 void gspca_disconnect(struct usb_interface *intf);
177 struct gspca_frame *gspca_frame_add(struct gspca_dev *gspca_dev,
179 struct gspca_frame *frame,
182 struct gspca_frame *gspca_get_i_frame(struct gspca_dev *gspca_dev);
184 int gspca_suspend(struct usb_interface *intf, pm_message_t message);
185 int gspca_resume(struct usb_interface *intf);
187 int gspca_auto_gain_n_exposure(struct gspca_dev *gspca_dev, int avg_lum,
188 int desired_avg_lum, int deadzone, int gain_knee, int exposure_knee);
189 #endif /* GSPCAV2_H */