1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25#ifndef PWC_H
26#define PWC_H
27
28#include <linux/module.h>
29#include <linux/usb.h>
30#include <linux/spinlock.h>
31#include <linux/wait.h>
32#include <linux/mutex.h>
33#include <linux/mm.h>
34#include <linux/slab.h>
35#include <asm/errno.h>
36#include <linux/videodev2.h>
37#include <media/v4l2-common.h>
38#include <media/v4l2-device.h>
39#include <media/v4l2-ioctl.h>
40#include <media/v4l2-ctrls.h>
41#include <media/v4l2-fh.h>
42#include <media/v4l2-event.h>
43#include <media/videobuf2-v4l2.h>
44#include <media/videobuf2-vmalloc.h>
45#ifdef CONFIG_USB_PWC_INPUT_EVDEV
46#include <linux/input.h>
47#endif
48#include "pwc-dec1.h"
49#include "pwc-dec23.h"
50
51
52#define PWC_VERSION "10.0.15"
53#define PWC_NAME "pwc"
54#define PFX PWC_NAME ": "
55
56
57
58#define PWC_DEBUG_LEVEL_MODULE (1<<0)
59#define PWC_DEBUG_LEVEL_PROBE (1<<1)
60#define PWC_DEBUG_LEVEL_OPEN (1<<2)
61#define PWC_DEBUG_LEVEL_READ (1<<3)
62#define PWC_DEBUG_LEVEL_MEMORY (1<<4)
63#define PWC_DEBUG_LEVEL_FLOW (1<<5)
64#define PWC_DEBUG_LEVEL_SIZE (1<<6)
65#define PWC_DEBUG_LEVEL_IOCTL (1<<7)
66#define PWC_DEBUG_LEVEL_TRACE (1<<8)
67
68#define PWC_DEBUG_MODULE(fmt, args...) PWC_DEBUG(MODULE, fmt, ##args)
69#define PWC_DEBUG_PROBE(fmt, args...) PWC_DEBUG(PROBE, fmt, ##args)
70#define PWC_DEBUG_OPEN(fmt, args...) PWC_DEBUG(OPEN, fmt, ##args)
71#define PWC_DEBUG_READ(fmt, args...) PWC_DEBUG(READ, fmt, ##args)
72#define PWC_DEBUG_MEMORY(fmt, args...) PWC_DEBUG(MEMORY, fmt, ##args)
73#define PWC_DEBUG_FLOW(fmt, args...) PWC_DEBUG(FLOW, fmt, ##args)
74#define PWC_DEBUG_SIZE(fmt, args...) PWC_DEBUG(SIZE, fmt, ##args)
75#define PWC_DEBUG_IOCTL(fmt, args...) PWC_DEBUG(IOCTL, fmt, ##args)
76#define PWC_DEBUG_TRACE(fmt, args...) PWC_DEBUG(TRACE, fmt, ##args)
77
78
79#ifdef CONFIG_USB_PWC_DEBUG
80
81#define PWC_DEBUG_LEVEL (PWC_DEBUG_LEVEL_MODULE)
82
83#define PWC_DEBUG(level, fmt, args...) do {\
84 if ((PWC_DEBUG_LEVEL_ ##level) & pwc_trace) \
85 printk(KERN_DEBUG PFX fmt, ##args); \
86 } while (0)
87
88#define PWC_ERROR(fmt, args...) printk(KERN_ERR PFX fmt, ##args)
89#define PWC_WARNING(fmt, args...) printk(KERN_WARNING PFX fmt, ##args)
90#define PWC_INFO(fmt, args...) printk(KERN_INFO PFX fmt, ##args)
91#define PWC_TRACE(fmt, args...) PWC_DEBUG(TRACE, fmt, ##args)
92
93#else
94
95#define PWC_ERROR(fmt, args...) printk(KERN_ERR PFX fmt, ##args)
96#define PWC_WARNING(fmt, args...) printk(KERN_WARNING PFX fmt, ##args)
97#define PWC_INFO(fmt, args...) printk(KERN_INFO PFX fmt, ##args)
98#define PWC_TRACE(fmt, args...) do { } while(0)
99#define PWC_DEBUG(level, fmt, args...) do { } while(0)
100
101#define pwc_trace 0
102
103#endif
104
105
106#define TOUCAM_HEADER_SIZE 8
107#define TOUCAM_TRAILER_SIZE 4
108
109#define FEATURE_MOTOR_PANTILT 0x0001
110#define FEATURE_CODEC1 0x0002
111#define FEATURE_CODEC2 0x0004
112
113#define MAX_WIDTH 640
114#define MAX_HEIGHT 480
115
116
117#define FRAME_LOWMARK 5
118
119
120#define MAX_ISO_BUFS 3
121#define ISO_FRAMES_PER_DESC 10
122#define ISO_MAX_FRAME_SIZE 960
123#define ISO_BUFFER_SIZE (ISO_FRAMES_PER_DESC * ISO_MAX_FRAME_SIZE)
124
125
126#define PWC_FRAME_SIZE (460800 + TOUCAM_HEADER_SIZE + TOUCAM_TRAILER_SIZE)
127
128
129#define MIN_FRAMES 2
130#define MAX_FRAMES 16
131
132
133#define DEVICE_USE_CODEC1(x) ((x)<675)
134#define DEVICE_USE_CODEC2(x) ((x)>=675 && (x)<700)
135#define DEVICE_USE_CODEC3(x) ((x)>=700)
136#define DEVICE_USE_CODEC23(x) ((x)>=675)
137
138
139#define SET_LUM_CTL 0x01
140#define GET_LUM_CTL 0x02
141#define SET_CHROM_CTL 0x03
142#define GET_CHROM_CTL 0x04
143#define SET_STATUS_CTL 0x05
144#define GET_STATUS_CTL 0x06
145#define SET_EP_STREAM_CTL 0x07
146#define GET_EP_STREAM_CTL 0x08
147#define GET_XX_CTL 0x09
148#define SET_XX_CTL 0x0A
149#define GET_XY_CTL 0x0B
150#define SET_XY_CTL 0x0C
151#define SET_MPT_CTL 0x0D
152#define GET_MPT_CTL 0x0E
153
154
155#define AGC_MODE_FORMATTER 0x2000
156#define PRESET_AGC_FORMATTER 0x2100
157#define SHUTTER_MODE_FORMATTER 0x2200
158#define PRESET_SHUTTER_FORMATTER 0x2300
159#define PRESET_CONTOUR_FORMATTER 0x2400
160#define AUTO_CONTOUR_FORMATTER 0x2500
161#define BACK_LIGHT_COMPENSATION_FORMATTER 0x2600
162#define CONTRAST_FORMATTER 0x2700
163#define DYNAMIC_NOISE_CONTROL_FORMATTER 0x2800
164#define FLICKERLESS_MODE_FORMATTER 0x2900
165#define AE_CONTROL_SPEED 0x2A00
166#define BRIGHTNESS_FORMATTER 0x2B00
167#define GAMMA_FORMATTER 0x2C00
168
169
170#define WB_MODE_FORMATTER 0x1000
171#define AWB_CONTROL_SPEED_FORMATTER 0x1100
172#define AWB_CONTROL_DELAY_FORMATTER 0x1200
173#define PRESET_MANUAL_RED_GAIN_FORMATTER 0x1300
174#define PRESET_MANUAL_BLUE_GAIN_FORMATTER 0x1400
175#define COLOUR_MODE_FORMATTER 0x1500
176#define SATURATION_MODE_FORMATTER1 0x1600
177#define SATURATION_MODE_FORMATTER2 0x1700
178
179
180#define SAVE_USER_DEFAULTS_FORMATTER 0x0200
181#define RESTORE_USER_DEFAULTS_FORMATTER 0x0300
182#define RESTORE_FACTORY_DEFAULTS_FORMATTER 0x0400
183#define READ_AGC_FORMATTER 0x0500
184#define READ_SHUTTER_FORMATTER 0x0600
185#define READ_RED_GAIN_FORMATTER 0x0700
186#define READ_BLUE_GAIN_FORMATTER 0x0800
187
188
189#define PT_RELATIVE_CONTROL_FORMATTER 0x01
190#define PT_RESET_CONTROL_FORMATTER 0x02
191#define PT_STATUS_FORMATTER 0x03
192
193
194#define PSZ_SQCIF 0x00
195#define PSZ_QSIF 0x01
196#define PSZ_QCIF 0x02
197#define PSZ_SIF 0x03
198#define PSZ_CIF 0x04
199#define PSZ_VGA 0x05
200#define PSZ_MAX 6
201
202struct pwc_raw_frame {
203 __le16 type;
204 __le16 vbandlength;
205
206 __u8 cmd[4];
207
208 __u8 rawframe[0];
209} __packed;
210
211
212struct pwc_frame_buf
213{
214
215 struct vb2_v4l2_buffer vb;
216 struct list_head list;
217 void *data;
218 int filled;
219};
220
221struct pwc_device
222{
223 struct video_device vdev;
224 struct v4l2_device v4l2_dev;
225
226
227 struct vb2_queue vb_queue;
228 struct list_head queued_bufs;
229 spinlock_t queued_bufs_lock;
230
231
232 struct mutex v4l2_lock;
233 struct mutex vb_queue_lock;
234
235
236 struct usb_device *udev;
237
238
239 int type;
240 int release;
241 int features;
242
243
244 int vendpoint;
245 int vcinterface;
246 int valternate;
247 int vframes;
248 int pixfmt;
249 int vframe_count;
250 int vmax_packet_size;
251 int vlast_packet_size;
252 int visoc_errors;
253 int vbandlength;
254 char vsync;
255 char vmirror;
256 char power_save;
257
258 unsigned char cmd_buf[13];
259 unsigned char *ctrl_buf;
260
261 struct urb *urbs[MAX_ISO_BUFS];
262
263
264
265
266
267
268
269 struct pwc_frame_buf *fill_buf;
270
271 int frame_header_size, frame_trailer_size;
272 int frame_size;
273 int frame_total_size;
274 int drop_frames;
275
276 union {
277 struct pwc_dec1_private dec1;
278 struct pwc_dec23_private dec23;
279 };
280
281
282
283
284
285
286
287 int image_mask;
288 int width, height;
289
290#ifdef CONFIG_USB_PWC_INPUT_EVDEV
291 struct input_dev *button_dev;
292 char button_phys[64];
293#endif
294
295
296 struct v4l2_ctrl_handler ctrl_handler;
297 u16 saturation_fmt;
298 struct v4l2_ctrl *brightness;
299 struct v4l2_ctrl *contrast;
300 struct v4l2_ctrl *saturation;
301 struct v4l2_ctrl *gamma;
302 struct {
303
304 struct v4l2_ctrl *auto_white_balance;
305 struct v4l2_ctrl *red_balance;
306 struct v4l2_ctrl *blue_balance;
307
308 int color_bal_valid;
309 unsigned long last_color_bal_update;
310 s32 last_red_balance;
311 s32 last_blue_balance;
312 };
313 struct {
314
315 struct v4l2_ctrl *autogain;
316 struct v4l2_ctrl *gain;
317 int gain_valid;
318 unsigned long last_gain_update;
319 s32 last_gain;
320 };
321 struct {
322
323 struct v4l2_ctrl *exposure_auto;
324 struct v4l2_ctrl *exposure;
325 int exposure_valid;
326 unsigned long last_exposure_update;
327 s32 last_exposure;
328 };
329 struct v4l2_ctrl *colorfx;
330 struct {
331
332 struct v4l2_ctrl *autocontour;
333 struct v4l2_ctrl *contour;
334 };
335 struct v4l2_ctrl *backlight;
336 struct v4l2_ctrl *flicker;
337 struct v4l2_ctrl *noise_reduction;
338 struct v4l2_ctrl *save_user;
339 struct v4l2_ctrl *restore_user;
340 struct v4l2_ctrl *restore_factory;
341 struct v4l2_ctrl *awb_speed;
342 struct v4l2_ctrl *awb_delay;
343 struct {
344
345 struct v4l2_ctrl *motor_pan;
346 struct v4l2_ctrl *motor_tilt;
347 struct v4l2_ctrl *motor_pan_reset;
348 struct v4l2_ctrl *motor_tilt_reset;
349 };
350
351 struct v4l2_ctrl *autogain_expo_cluster[3];
352};
353
354
355#ifdef CONFIG_USB_PWC_DEBUG
356extern int pwc_trace;
357#endif
358
359
360
361extern const int pwc_image_sizes[PSZ_MAX][2];
362
363int pwc_get_size(struct pwc_device *pdev, int width, int height);
364void pwc_construct(struct pwc_device *pdev);
365
366
367
368extern int pwc_set_video_mode(struct pwc_device *pdev, int width, int height,
369 int pixfmt, int frames, int *compression, int send_to_cam);
370extern unsigned int pwc_get_fps(struct pwc_device *pdev, unsigned int index, unsigned int size);
371extern int pwc_set_leds(struct pwc_device *pdev, int on_value, int off_value);
372extern int pwc_get_cmos_sensor(struct pwc_device *pdev, int *sensor);
373extern int send_control_msg(struct pwc_device *pdev,
374 u8 request, u16 value, void *buf, int buflen);
375
376
377int pwc_get_u8_ctrl(struct pwc_device *pdev, u8 request, u16 value, int *data);
378int pwc_set_u8_ctrl(struct pwc_device *pdev, u8 request, u16 value, u8 data);
379int pwc_get_s8_ctrl(struct pwc_device *pdev, u8 request, u16 value, int *data);
380#define pwc_set_s8_ctrl pwc_set_u8_ctrl
381int pwc_get_u16_ctrl(struct pwc_device *pdev, u8 request, u16 value, int *dat);
382int pwc_set_u16_ctrl(struct pwc_device *pdev, u8 request, u16 value, u16 data);
383int pwc_button_ctrl(struct pwc_device *pdev, u16 value);
384int pwc_init_controls(struct pwc_device *pdev);
385
386
387extern void pwc_camera_power(struct pwc_device *pdev, int power);
388
389extern const struct v4l2_ioctl_ops pwc_ioctl_ops;
390
391
392
393int pwc_decompress(struct pwc_device *pdev, struct pwc_frame_buf *fbuf);
394
395#endif
396