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
26
27#ifndef __LINUX_USBVISION_H
28#define __LINUX_USBVISION_H
29
30#include <linux/list.h>
31#include <linux/usb.h>
32#include <linux/i2c.h>
33#include <linux/mutex.h>
34#include <media/v4l2-device.h>
35#include <media/v4l2-ctrls.h>
36#include <media/tuner.h>
37#include <linux/videodev2.h>
38
39#define USBVISION_DEBUG
40
41#define USBVISION_PWR_REG 0x00
42 #define USBVISION_SSPND_EN (1 << 1)
43 #define USBVISION_RES2 (1 << 2)
44 #define USBVISION_PWR_VID (1 << 5)
45 #define USBVISION_E2_EN (1 << 7)
46#define USBVISION_CONFIG_REG 0x01
47#define USBVISION_ADRS_REG 0x02
48#define USBVISION_ALTER_REG 0x03
49#define USBVISION_FORCE_ALTER_REG 0x04
50#define USBVISION_STATUS_REG 0x05
51#define USBVISION_IOPIN_REG 0x06
52 #define USBVISION_IO_1 (1 << 0)
53 #define USBVISION_IO_2 (1 << 1)
54 #define USBVISION_AUDIO_IN 0
55 #define USBVISION_AUDIO_TV 1
56 #define USBVISION_AUDIO_RADIO 2
57 #define USBVISION_AUDIO_MUTE 3
58#define USBVISION_SER_MODE 0x07
59 #define USBVISION_CLK_OUT (1 << 0)
60 #define USBVISION_DAT_IO (1 << 1)
61 #define USBVISION_SENS_OUT (1 << 2)
62 #define USBVISION_SER_MODE_SOFT (0 << 4)
63 #define USBVISION_SER_MODE_SIO (1 << 4)
64#define USBVISION_SER_ADRS 0x08
65#define USBVISION_SER_CONT 0x09
66#define USBVISION_SER_DAT1 0x0A
67#define USBVISION_SER_DAT2 0x0B
68#define USBVISION_SER_DAT3 0x0C
69#define USBVISION_SER_DAT4 0x0D
70#define USBVISION_EE_DATA 0x0E
71#define USBVISION_EE_LSBAD 0x0F
72#define USBVISION_EE_CONT 0x10
73#define USBVISION_DRM_CONT 0x12
74 #define USBVISION_REF (1 << 0)
75 #define USBVISION_RES_UR (1 << 2)
76 #define USBVISION_RES_FDL (1 << 3)
77 #define USBVISION_RES_VDW (1 << 4)
78#define USBVISION_DRM_PRM1 0x13
79#define USBVISION_DRM_PRM2 0x14
80#define USBVISION_DRM_PRM3 0x15
81#define USBVISION_DRM_PRM4 0x16
82#define USBVISION_DRM_PRM5 0x17
83#define USBVISION_DRM_PRM6 0x18
84#define USBVISION_DRM_PRM7 0x19
85#define USBVISION_DRM_PRM8 0x1A
86#define USBVISION_VIN_REG1 0x1B
87 #define USBVISION_8_422_SYNC 0x01
88 #define USBVISION_16_422_SYNC 0x02
89 #define USBVISION_VSNC_POL (1 << 3)
90 #define USBVISION_HSNC_POL (1 << 4)
91 #define USBVISION_FID_POL (1 << 5)
92 #define USBVISION_HVALID_PO (1 << 6)
93 #define USBVISION_VCLK_POL (1 << 7)
94#define USBVISION_VIN_REG2 0x1C
95 #define USBVISION_AUTO_FID (1 << 0)
96 #define USBVISION_NONE_INTER (1 << 1)
97 #define USBVISION_NOHVALID (1 << 2)
98 #define USBVISION_UV_ID (1 << 3)
99 #define USBVISION_FIX_2C (1 << 4)
100 #define USBVISION_SEND_FID (1 << 5)
101 #define USBVISION_KEEP_BLANK (1 << 7)
102#define USBVISION_LXSIZE_I 0x1D
103#define USBVISION_MXSIZE_I 0x1E
104#define USBVISION_LYSIZE_I 0x1F
105#define USBVISION_MYSIZE_I 0x20
106#define USBVISION_LX_OFFST 0x21
107#define USBVISION_MX_OFFST 0x22
108#define USBVISION_LY_OFFST 0x23
109#define USBVISION_MY_OFFST 0x24
110#define USBVISION_FRM_RATE 0x25
111#define USBVISION_LXSIZE_O 0x26
112#define USBVISION_MXSIZE_O 0x27
113#define USBVISION_LYSIZE_O 0x28
114#define USBVISION_MYSIZE_O 0x29
115#define USBVISION_FILT_CONT 0x2A
116#define USBVISION_VO_MODE 0x2B
117#define USBVISION_INTRA_CYC 0x2C
118#define USBVISION_STRIP_SZ 0x2D
119#define USBVISION_FORCE_INTRA 0x2E
120#define USBVISION_FORCE_UP 0x2F
121#define USBVISION_BUF_THR 0x30
122#define USBVISION_DVI_YUV 0x31
123#define USBVISION_AUDIO_CONT 0x32
124#define USBVISION_AUD_PK_LEN 0x33
125#define USBVISION_BLK_PK_LEN 0x34
126#define USBVISION_PCM_THR1 0x38
127#define USBVISION_PCM_THR2 0x39
128#define USBVISION_DIST_THR_L 0x3A
129#define USBVISION_DIST_THR_H 0x3B
130#define USBVISION_MAX_DIST_L 0x3C
131#define USBVISION_MAX_DIST_H 0x3D
132#define USBVISION_OP_CODE 0x33
133
134#define MAX_BYTES_PER_PIXEL 4
135
136#define MIN_FRAME_WIDTH 64
137#define MAX_USB_WIDTH 320
138#define MAX_FRAME_WIDTH 320
139
140#define MIN_FRAME_HEIGHT 48
141#define MAX_USB_HEIGHT 240
142#define MAX_FRAME_HEIGHT 240
143
144#define MAX_FRAME_SIZE (MAX_FRAME_WIDTH * MAX_FRAME_HEIGHT * MAX_BYTES_PER_PIXEL)
145#define USBVISION_CLIPMASK_SIZE (MAX_FRAME_WIDTH * MAX_FRAME_HEIGHT / 8)
146
147#define USBVISION_URB_FRAMES 32
148
149#define USBVISION_NUM_HEADERMARKER 20
150#define USBVISION_NUMFRAMES 3
151#define USBVISION_NUMSBUF 2
152
153#define USBVISION_POWEROFF_TIME (3 * HZ)
154
155
156#define FRAMERATE_MIN 0
157#define FRAMERATE_MAX 31
158
159enum {
160 ISOC_MODE_YUV422 = 0x03,
161 ISOC_MODE_YUV420 = 0x14,
162 ISOC_MODE_COMPRESS = 0x60,
163};
164
165
166#define RESTRICT_TO_RANGE(v, mi, ma) \
167 { if (((int)v) < (mi)) (v) = (mi); else if ((v) > (ma)) (v) = (ma); }
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188#define LIMIT_RGB(x) (((x) < 0) ? 0 : (((x) > 255) ? 255 : (x)))
189#define YUV_TO_RGB_BY_THE_BOOK(my, mu, mv, mr, mg, mb) { \
190 int mm_y, mm_yc, mm_u, mm_v, mm_r, mm_g, mm_b; \
191 mm_y = (my) - 16; \
192 mm_u = (mu) - 128; \
193 mm_v = (mv) - 128; \
194 mm_yc = mm_y * 76284; \
195 mm_b = (mm_yc + 132252 * mm_v) >> 16; \
196 mm_g = (mm_yc - 53281 * mm_u - 25625 * mm_v) >> 16; \
197 mm_r = (mm_yc + 104595 * mm_u) >> 16; \
198 mb = LIMIT_RGB(mm_b); \
199 mg = LIMIT_RGB(mm_g); \
200 mr = LIMIT_RGB(mm_r); \
201}
202
203
204
205
206
207
208#define USBVISION_IS_OPERATIONAL(udevice) (\
209 (udevice != NULL) && \
210 ((udevice)->dev != NULL) && \
211 ((udevice)->last_error == 0) && \
212 (!(udevice)->remove_pending))
213
214#define I2C_USB_ADAP_MAX 16
215
216#define USBVISION_NORMS (V4L2_STD_PAL | V4L2_STD_NTSC | V4L2_STD_SECAM | V4L2_STD_PAL_M)
217
218
219
220
221enum scan_state {
222 scan_state_scanning,
223 scan_state_lines
224};
225
226
227enum parse_state {
228 parse_state_continue,
229 parse_state_next_frame,
230 parse_state_out,
231 parse_state_end_parse
232};
233
234enum frame_state {
235 frame_state_unused,
236 frame_state_ready,
237 frame_state_grabbing,
238 frame_state_done,
239 frame_state_done_hold,
240 frame_state_error,
241};
242
243
244enum stream_state {
245 stream_off,
246 stream_idle,
247 stream_interrupt,
248 stream_on,
249};
250
251enum isoc_state {
252 isoc_state_in_frame,
253 isoc_state_no_frame,
254};
255
256struct usb_device;
257
258struct usbvision_sbuf {
259 char *data;
260 struct urb *urb;
261};
262
263#define USBVISION_MAGIC_1 0x55
264#define USBVISION_MAGIC_2 0xAA
265#define USBVISION_HEADER_LENGTH 0x0c
266#define USBVISION_SAA7111_ADDR 0x48
267#define USBVISION_SAA7113_ADDR 0x4a
268#define USBVISION_IIC_LRACK 0x20
269#define USBVISION_IIC_LRNACK 0x30
270#define USBVISION_FRAME_FORMAT_PARAM_INTRA (1<<7)
271
272struct usbvision_v4l2_format_st {
273 int supported;
274 int bytes_per_pixel;
275 int depth;
276 int format;
277 char *desc;
278};
279#define USBVISION_SUPPORTED_PALETTES ARRAY_SIZE(usbvision_v4l2_format)
280
281struct usbvision_frame_header {
282 unsigned char magic_1;
283 unsigned char magic_2;
284 unsigned char header_length;
285 unsigned char frame_num;
286 unsigned char frame_phase;
287 unsigned char frame_latency;
288 unsigned char data_format;
289 unsigned char format_param;
290 unsigned char frame_width_lo;
291 unsigned char frame_width_hi;
292 unsigned char frame_height_lo;
293 unsigned char frame_height_hi;
294 __u16 frame_width;
295 __u16 frame_height;
296};
297
298struct usbvision_frame {
299 char *data;
300 struct usbvision_frame_header isoc_header;
301
302 int width;
303 int height;
304 int index;
305 int frmwidth;
306 int frmheight;
307
308 volatile int grabstate;
309 int scanstate;
310
311 struct list_head frame;
312
313 int curline;
314
315 long scanlength;
316 long bytes_read;
317 struct usbvision_v4l2_format_st v4l2_format;
318 int v4l2_linesize;
319 struct timeval timestamp;
320 int sequence;
321};
322
323#define CODEC_SAA7113 7113
324#define CODEC_SAA7111 7111
325#define CODEC_WEBCAM 3000
326#define BRIDGE_NT1003 1003
327#define BRIDGE_NT1004 1004
328#define BRIDGE_NT1005 1005
329
330struct usbvision_device_data_st {
331 __u64 video_norm;
332 const char *model_string;
333 int interface;
334 __u16 codec;
335 unsigned video_channels:3;
336 unsigned audio_channels:2;
337 unsigned radio:1;
338 unsigned vbi:1;
339 unsigned tuner:1;
340 unsigned vin_reg1_override:1;
341 unsigned vin_reg2_override:1;
342 unsigned dvi_yuv_override:1;
343 __u8 vin_reg1;
344 __u8 vin_reg2;
345 __u8 dvi_yuv;
346 __u8 tuner_type;
347 __s16 x_offset;
348 __s16 y_offset;
349};
350
351
352extern struct usbvision_device_data_st usbvision_device_data[];
353extern struct usb_device_id usbvision_table[];
354
355struct usb_usbvision {
356 struct v4l2_device v4l2_dev;
357 struct v4l2_ctrl_handler hdl;
358 struct video_device vdev;
359 struct video_device rdev;
360
361
362 struct i2c_adapter i2c_adap;
363 int registered_i2c;
364
365 struct urb *ctrl_urb;
366 unsigned char ctrl_urb_buffer[8];
367 int ctrl_urb_busy;
368 struct usb_ctrlrequest ctrl_urb_setup;
369
370
371 int have_tuner;
372 int tuner_type;
373 int bridge_type;
374 int radio;
375 int video_inputs;
376 unsigned long radio_freq;
377 unsigned long tv_freq;
378 int audio_mute;
379 int audio_channel;
380 int isoc_mode;
381 unsigned int nr;
382
383
384 struct usb_device *dev;
385
386 int num_alt;
387 unsigned int *alt_max_pkt_size;
388 unsigned char iface;
389 unsigned char iface_alt;
390 unsigned char vin_reg2_preset;
391 struct mutex v4l2_lock;
392 int power;
393 int user;
394 int initialized;
395 int dev_model;
396 enum stream_state streaming;
397 int last_error;
398 int curwidth;
399 int curheight;
400 int stretch_width;
401 int stretch_height;
402 char *fbuf;
403 int max_frame_size;
404 int fbuf_size;
405 spinlock_t queue_lock;
406 struct list_head inqueue, outqueue;
407 wait_queue_head_t wait_frame;
408 wait_queue_head_t wait_stream;
409 struct usbvision_frame *cur_frame;
410 struct usbvision_frame frame[USBVISION_NUMFRAMES];
411 int num_frames;
412 struct usbvision_sbuf sbuf[USBVISION_NUMSBUF];
413 volatile int remove_pending;
414
415
416 unsigned char *scratch;
417 int scratch_read_ptr;
418 int scratch_write_ptr;
419 int scratch_headermarker[USBVISION_NUM_HEADERMARKER];
420 int scratch_headermarker_read_ptr;
421 int scratch_headermarker_write_ptr;
422 enum isoc_state isocstate;
423 struct usbvision_v4l2_format_st palette;
424
425 struct v4l2_capability vcap;
426 unsigned int ctl_input;
427 v4l2_std_id tvnorm_id;
428 unsigned char video_endp;
429
430
431 unsigned char *intra_frame_buffer;
432 int block_pos;
433 int request_intra;
434 int last_isoc_frame_num;
435 int isoc_packet_size;
436 int used_bandwidth;
437 int compr_level;
438 int last_compr_level;
439 int usb_bandwidth;
440
441
442 unsigned long isoc_urb_count;
443 unsigned long urb_length;
444 unsigned long isoc_data_count;
445 unsigned long header_count;
446 unsigned long scratch_ovf_count;
447 unsigned long isoc_skip_count;
448 unsigned long isoc_err_count;
449 unsigned long isoc_packet_count;
450 unsigned long time_in_irq;
451 int isoc_measure_bandwidth_count;
452 int frame_num;
453 int max_strip_len;
454 int comprblock_pos;
455 int strip_len_errors;
456 int strip_magic_errors;
457 int strip_line_number_errors;
458 int compr_block_types[4];
459};
460
461static inline struct usb_usbvision *to_usbvision(struct v4l2_device *v4l2_dev)
462{
463 return container_of(v4l2_dev, struct usb_usbvision, v4l2_dev);
464}
465
466#define call_all(usbvision, o, f, args...) \
467 v4l2_device_call_all(&usbvision->v4l2_dev, 0, o, f, ##args)
468
469
470
471
472
473
474
475
476
477int usbvision_i2c_register(struct usb_usbvision *usbvision);
478int usbvision_i2c_unregister(struct usb_usbvision *usbvision);
479
480
481int usbvision_read_reg(struct usb_usbvision *usbvision, unsigned char reg);
482int usbvision_write_reg(struct usb_usbvision *usbvision, unsigned char reg,
483 unsigned char value);
484
485int usbvision_frames_alloc(struct usb_usbvision *usbvision, int number_of_frames);
486void usbvision_frames_free(struct usb_usbvision *usbvision);
487int usbvision_scratch_alloc(struct usb_usbvision *usbvision);
488void usbvision_scratch_free(struct usb_usbvision *usbvision);
489int usbvision_decompress_alloc(struct usb_usbvision *usbvision);
490void usbvision_decompress_free(struct usb_usbvision *usbvision);
491
492int usbvision_setup(struct usb_usbvision *usbvision, int format);
493int usbvision_init_isoc(struct usb_usbvision *usbvision);
494int usbvision_restart_isoc(struct usb_usbvision *usbvision);
495void usbvision_stop_isoc(struct usb_usbvision *usbvision);
496int usbvision_set_alternate(struct usb_usbvision *dev);
497
498int usbvision_set_audio(struct usb_usbvision *usbvision, int audio_channel);
499int usbvision_audio_off(struct usb_usbvision *usbvision);
500
501int usbvision_begin_streaming(struct usb_usbvision *usbvision);
502void usbvision_empty_framequeues(struct usb_usbvision *dev);
503int usbvision_stream_interrupt(struct usb_usbvision *dev);
504
505int usbvision_muxsel(struct usb_usbvision *usbvision, int channel);
506int usbvision_set_input(struct usb_usbvision *usbvision);
507int usbvision_set_output(struct usb_usbvision *usbvision, int width, int height);
508
509int usbvision_power_off(struct usb_usbvision *usbvision);
510int usbvision_power_on(struct usb_usbvision *usbvision);
511
512#endif
513