1 /*****************************************************************************
5 *****************************************************************************/
8 * Copyright (C) 2010 R.M. Thomas <rmthomas@sciolus.org>
11 * This is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License as published by
13 * the Free Software Foundation; either version 2 of the License, or
14 * (at your option) any later version.
16 * The software is distributed in the hope that it will be useful,
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 * GNU General Public License for more details.
21 * You should have received a copy of the GNU General Public License
22 * along with this software; if not, write to the Free Software
23 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
26 /*****************************************************************************/
27 /*---------------------------------------------------------------------------*/
29 * THE FOLLOWING PARAMETERS ARE UNDEFINED:
33 * IF REQUIRED THEY MUST BE EXTERNALLY DEFINED, FOR EXAMPLE AS COMPILER
36 /*---------------------------------------------------------------------------*/
41 /*---------------------------------------------------------------------------*/
43 * THESE ARE NORMALLY DEFINED
45 /*---------------------------------------------------------------------------*/
48 /*---------------------------------------------------------------------------*/
50 * THESE ARE FOR MAINTENANCE ONLY - NORMALLY UNDEFINED:
52 /*---------------------------------------------------------------------------*/
53 #undef EASYCAP_TESTCARD
54 /*---------------------------------------------------------------------------*/
55 #include <linux/kernel.h>
56 #include <linux/errno.h>
57 #include <linux/init.h>
58 #include <linux/slab.h>
59 #include <linux/module.h>
60 #include <linux/kref.h>
61 #include <linux/usb.h>
62 #include <linux/uaccess.h>
64 #include <linux/i2c.h>
65 #include <linux/workqueue.h>
66 #include <linux/poll.h>
69 #include <linux/delay.h>
70 #include <linux/types.h>
72 #include <linux/vmalloc.h>
73 #include <linux/sound.h>
74 #include <sound/core.h>
75 #include <sound/pcm.h>
76 #include <sound/pcm_params.h>
77 #include <sound/info.h>
78 #include <sound/initval.h>
79 #include <sound/control.h>
80 #include <media/v4l2-dev.h>
81 #include <media/v4l2-device.h>
82 #include <linux/videodev2.h>
83 #include <linux/soundcard.h>
85 /*---------------------------------------------------------------------------*/
86 /* VENDOR, PRODUCT: Syntek Semiconductor Co., Ltd
88 * EITHER EasyCAP USB 2.0 Video Adapter with Audio, Model No. DC60
89 * with input cabling: AUDIO(L), AUDIO(R), CVBS, S-VIDEO.
91 * OR EasyCAP 4CHANNEL USB 2.0 DVR, Model No. EasyCAP002
92 * with input cabling: MICROPHONE, CVBS1, CVBS2, CVBS3, CVBS4.
94 /*---------------------------------------------------------------------------*/
95 #define USB_EASYCAP_VENDOR_ID 0x05e1
96 #define USB_EASYCAP_PRODUCT_ID 0x0408
98 #define EASYCAP_DRIVER_VERSION "0.9.01"
99 #define EASYCAP_DRIVER_DESCRIPTION "easycapdc60"
101 #define USB_SKEL_MINOR_BASE 192
102 #define DONGLE_MANY 8
104 /*---------------------------------------------------------------------------*/
106 * DEFAULT LUMINANCE, CONTRAST, SATURATION AND HUE
108 /*---------------------------------------------------------------------------*/
109 #define SAA_0A_DEFAULT 0x7F
110 #define SAA_0B_DEFAULT 0x3F
111 #define SAA_0C_DEFAULT 0x2F
112 #define SAA_0D_DEFAULT 0x00
113 /*---------------------------------------------------------------------------*/
115 * VIDEO STREAMING PARAMETERS:
116 * USB 2.0 PROVIDES FOR HIGH-BANDWIDTH ENDPOINTS WITH AN UPPER LIMIT
117 * OF 3072 BYTES PER MICROFRAME for wMaxPacketSize.
119 /*---------------------------------------------------------------------------*/
120 #define VIDEO_ISOC_BUFFER_MANY 16
121 #define VIDEO_ISOC_ORDER 3
122 #define VIDEO_ISOC_FRAMESPERDESC ((unsigned int) 1 << VIDEO_ISOC_ORDER)
123 #define USB_2_0_MAXPACKETSIZE 3072
124 #if (USB_2_0_MAXPACKETSIZE > PAGE_SIZE)
125 #error video_isoc_buffer[.] will not be big enough
127 #define VIDEO_JUNK_TOLERATE VIDEO_ISOC_BUFFER_MANY
128 #define VIDEO_LOST_TOLERATE 50
129 /*---------------------------------------------------------------------------*/
133 /*---------------------------------------------------------------------------*/
134 #define FIELD_BUFFER_SIZE (203 * PAGE_SIZE)
135 #define FRAME_BUFFER_SIZE (405 * PAGE_SIZE)
136 #define FIELD_BUFFER_MANY 4
137 #define FRAME_BUFFER_MANY 6
138 /*---------------------------------------------------------------------------*/
140 * AUDIO STREAMING PARAMETERS
142 /*---------------------------------------------------------------------------*/
143 #define AUDIO_ISOC_BUFFER_MANY 16
144 #define AUDIO_ISOC_ORDER 1
145 #define AUDIO_ISOC_FRAMESPERDESC 32
146 #define AUDIO_ISOC_BUFFER_SIZE (PAGE_SIZE << AUDIO_ISOC_ORDER)
147 /*---------------------------------------------------------------------------*/
151 /*---------------------------------------------------------------------------*/
152 #define AUDIO_FRAGMENT_MANY 32
153 #define PAGES_PER_AUDIO_FRAGMENT 4
154 /*---------------------------------------------------------------------------*/
156 * IT IS ESSENTIAL THAT EVEN-NUMBERED STANDARDS ARE 25 FRAMES PER SECOND,
157 * ODD-NUMBERED STANDARDS ARE 30 FRAMES PER SECOND.
158 * THE NUMBERING OF STANDARDS MUST NOT BE CHANGED WITHOUT DUE CARE. NOT
159 * ONLY MUST THE PARAMETER
161 * BE CHANGED TO CORRESPOND TO THE NEW NUMBER OF STANDARDS, BUT ALSO THE
162 * NUMBERING MUST REMAIN AN UNBROKEN ASCENDING SEQUENCE: DUMMY STANDARDS
163 * MAY NEED TO BE ADDED. APPROPRIATE CHANGES WILL ALWAYS BE REQUIRED IN
164 * ROUTINE fillin_formats() AND POSSIBLY ELSEWHERE. BEWARE.
166 /*---------------------------------------------------------------------------*/
177 #define PAL_BGHIN_SLOW 10
178 #define PAL_Nc_SLOW 12
179 #define SECAM_SLOW 14
180 #define NTSC_N_SLOW 16
181 #define NTSC_N_443_SLOW 18
182 #define NTSC_M_SLOW 11
183 #define NTSC_443_SLOW 13
184 #define NTSC_M_JP_SLOW 15
185 #define PAL_60_SLOW 17
186 #define PAL_M_SLOW 19
187 #define STANDARD_MANY 20
188 /*---------------------------------------------------------------------------*/
192 /*---------------------------------------------------------------------------*/
217 #define SETTINGS_MANY (STANDARD_MANY * \
222 /*---------------------------------------------------------------------------*/
224 * STRUCTURE DEFINITIONS
226 /*---------------------------------------------------------------------------*/
227 struct easycap_dongle
{
228 struct easycap
*peasycap
;
229 struct mutex mutex_video
;
230 struct mutex mutex_audio
;
232 /*---------------------------------------------------------------------------*/
234 struct list_head list_head
;
240 /*---------------------------------------------------------------------------*/
242 struct list_head list_head
;
247 /*---------------------------------------------------------------------------*/
248 struct easycap_standard
{
250 struct v4l2_standard v4l2_standard
;
252 struct easycap_format
{
255 struct v4l2_format v4l2_format
;
261 int standard_offset_ok
;
263 int format_offset_ok
;
273 /*---------------------------------------------------------------------------*/
275 * easycap.ilk == 0 => CVBS+S-VIDEO HARDWARE, AUDIO wMaxPacketSize=256
276 * easycap.ilk == 2 => CVBS+S-VIDEO HARDWARE, AUDIO wMaxPacketSize=9
277 * easycap.ilk == 3 => FOUR-CVBS HARDWARE, AUDIO wMaxPacketSize=9
279 /*---------------------------------------------------------------------------*/
284 struct video_device video_device
;
285 struct v4l2_device v4l2_device
;
288 unsigned int audio_pages_per_fragment
;
289 unsigned int audio_bytes_per_fragment
;
290 unsigned int audio_buffer_page_many
;
300 struct usb_device
*pusb_device
;
301 struct usb_interface
*pusb_interface
;
305 int queued
[FRAME_BUFFER_MANY
];
306 int done
[FRAME_BUFFER_MANY
];
308 wait_queue_head_t wq_video
;
309 wait_queue_head_t wq_audio
;
310 wait_queue_head_t wq_trigger
;
316 struct inputset inputset
[INPUT_MANY
];
324 int lost
[INPUT_MANY
];
327 struct timeval timeval0
;
328 struct timeval timeval1
;
329 struct timeval timeval2
;
330 struct timeval timeval3
;
331 struct timeval timeval6
;
332 struct timeval timeval7
;
333 struct timeval timeval8
;
334 long long int dnbydt
;
337 int video_altsetting_on
;
338 int video_altsetting_off
;
339 int video_endpointnumber
;
340 int video_isoc_maxframesize
;
341 int video_isoc_buffer_size
;
342 int video_isoc_framesperdesc
;
344 int video_isoc_streaming
;
345 int video_isoc_sequence
;
350 struct data_buffer video_isoc_buffer
[VIDEO_ISOC_BUFFER_MANY
];
351 struct data_buffer field_buffer
[FIELD_BUFFER_MANY
]
352 [(FIELD_BUFFER_SIZE
/PAGE_SIZE
)];
353 struct data_buffer frame_buffer
[FRAME_BUFFER_MANY
]
354 [(FRAME_BUFFER_SIZE
/PAGE_SIZE
)];
356 struct list_head urb_video_head
;
357 struct list_head
*purb_video_head
;
363 long long audio_bytes
;
367 /*---------------------------------------------------------------------------*/
371 /*---------------------------------------------------------------------------*/
372 int field_fill
; /* Field buffer being filled by easycap_complete(). */
373 /* Bumped only by easycap_complete(). */
374 int field_page
; /* Page of field buffer page being filled by */
375 /* easycap_complete(). */
376 int field_read
; /* Field buffer to be read by field2frame(). */
377 /* Bumped only by easycap_complete(). */
378 int frame_fill
; /* Frame buffer being filled by field2frame(). */
379 /* Bumped only by easycap_dqbuf() when */
380 /* field2frame() has created a complete frame. */
381 int frame_read
; /* Frame buffer offered to user by DQBUF. */
382 /* Set only by easycap_dqbuf() to trail frame_fill.*/
383 int frame_lock
; /* Flag set to 1 by DQBUF and cleared by QBUF */
384 /*---------------------------------------------------------------------------*/
388 /*---------------------------------------------------------------------------*/
396 int frame_buffer_used
;
397 int frame_buffer_many
;
398 int videofieldamount
;
405 int allocation_video_urb
;
406 int allocation_video_page
;
407 int allocation_video_struct
;
408 int registered_video
;
409 /*---------------------------------------------------------------------------*/
413 /*---------------------------------------------------------------------------*/
414 struct snd_pcm_hardware alsa_hardware
;
415 struct snd_card
*psnd_card
;
416 struct snd_pcm
*psnd_pcm
;
417 struct snd_pcm_substream
*psubstream
;
421 /*---------------------------------------------------------------------------*/
425 /*---------------------------------------------------------------------------*/
427 int audio_altsetting_on
;
428 int audio_altsetting_off
;
429 int audio_endpointnumber
;
430 int audio_isoc_maxframesize
;
431 int audio_isoc_buffer_size
;
432 int audio_isoc_framesperdesc
;
434 int audio_isoc_streaming
;
441 struct data_buffer audio_isoc_buffer
[AUDIO_ISOC_BUFFER_MANY
];
443 struct list_head urb_audio_head
;
444 struct list_head
*purb_audio_head
;
445 /*---------------------------------------------------------------------------*/
449 /*---------------------------------------------------------------------------*/
450 int audio_fill
; /* Audio buffer being filled by easycap_complete(). */
451 /* Bumped only by easycap_complete(). */
452 int audio_read
; /* Audio buffer page being read by easycap_read(). */
453 /* Set by easycap_read() to trail audio_fill by */
455 /*---------------------------------------------------------------------------*/
459 /*---------------------------------------------------------------------------*/
461 int audio_buffer_many
;
463 int allocation_audio_urb
;
464 int allocation_audio_page
;
465 int allocation_audio_struct
;
466 int registered_audio
;
468 long long int audio_sample
;
469 long long int audio_niveau
;
470 long long int audio_square
;
472 struct data_buffer audio_buffer
[];
474 /*---------------------------------------------------------------------------*/
476 * VIDEO FUNCTION PROTOTYPES
478 /*^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^*/
479 long easycap_unlocked_ioctl(struct file
*, unsigned int, unsigned long);
480 int easycap_dqbuf(struct easycap
*, int);
481 int submit_video_urbs(struct easycap
*);
482 int kill_video_urbs(struct easycap
*);
483 int field2frame(struct easycap
*);
484 int redaub(struct easycap
*, void *, void *,
485 int, int, u8
, u8
, bool);
486 void easycap_testcard(struct easycap
*, int);
487 int fillin_formats(void);
488 int newinput(struct easycap
*, int);
489 int adjust_standard(struct easycap
*, v4l2_std_id
);
490 int adjust_format(struct easycap
*, u32
, u32
, u32
,
492 int adjust_brightness(struct easycap
*, int);
493 int adjust_contrast(struct easycap
*, int);
494 int adjust_saturation(struct easycap
*, int);
495 int adjust_hue(struct easycap
*, int);
496 int adjust_volume(struct easycap
*, int);
497 /*---------------------------------------------------------------------------*/
499 * AUDIO FUNCTION PROTOTYPES
501 /*---------------------------------------------------------------------------*/
502 int easycap_alsa_probe(struct easycap
*);
503 void easycap_alsa_complete(struct urb
*);
505 int easycap_sound_setup(struct easycap
*);
506 int submit_audio_urbs(struct easycap
*);
507 int kill_audio_urbs(struct easycap
*);
508 void easyoss_testtone(struct easycap
*, int);
509 int audio_setup(struct easycap
*);
510 /*---------------------------------------------------------------------------*/
512 * LOW-LEVEL FUNCTION PROTOTYPES
514 /*---------------------------------------------------------------------------*/
515 int audio_gainget(struct usb_device
*);
516 int audio_gainset(struct usb_device
*, s8
);
518 int set_interface(struct usb_device
*, u16
);
519 int wakeup_device(struct usb_device
*);
520 int confirm_resolution(struct usb_device
*);
521 int confirm_stream(struct usb_device
*);
523 int setup_stk(struct usb_device
*, bool);
524 int setup_saa(struct usb_device
*, bool);
525 int setup_vt(struct usb_device
*);
526 int check_stk(struct usb_device
*, bool);
527 int check_saa(struct usb_device
*, bool);
528 int ready_saa(struct usb_device
*);
529 int merit_saa(struct usb_device
*);
530 int check_vt(struct usb_device
*);
531 int select_input(struct usb_device
*, int, int);
532 int set_resolution(struct usb_device
*,
535 int read_saa(struct usb_device
*, u16
);
536 int read_stk(struct usb_device
*, u32
);
537 int write_saa(struct usb_device
*, u16
, u16
);
538 int write_000(struct usb_device
*, u16
, u16
);
539 int start_100(struct usb_device
*);
540 int stop_100(struct usb_device
*);
541 int write_300(struct usb_device
*);
542 int read_vt(struct usb_device
*, u16
);
543 int write_vt(struct usb_device
*, u16
, u16
);
544 int isdongle(struct easycap
*);
545 /*---------------------------------------------------------------------------*/
546 struct signed_div_result
{
547 long long int quotient
;
548 unsigned long long int remainder
;
549 } signed_div(long long int, long long int);
552 /*---------------------------------------------------------------------------*/
554 * MACROS SAM(...) AND JOM(...) ALLOW DIAGNOSTIC OUTPUT TO BE TAGGED WITH
555 * THE IDENTITY OF THE DONGLE TO WHICH IT APPLIES, BUT IF INVOKED WHEN THE
556 * POINTER peasycap IS INVALID AN Oops IS LIKELY, AND ITS CAUSE MAY NOT BE
557 * IMMEDIATELY OBVIOUS FROM A CASUAL READING OF THE SOURCE CODE. BEWARE.
559 /*---------------------------------------------------------------------------*/
560 const char *strerror(int err
);
562 #define SAY(format, args...) do { \
563 printk(KERN_DEBUG "easycap:: %s: " \
564 format, __func__, ##args); \
566 #define SAM(format, args...) do { \
567 printk(KERN_DEBUG "easycap::%i%s: " \
568 format, peasycap->isdongle, __func__, ##args);\
571 #ifdef CONFIG_EASYCAP_DEBUG
572 extern int easycap_debug
;
573 #define JOT(n, format, args...) do { \
574 if (n <= easycap_debug) { \
575 printk(KERN_DEBUG "easycap:: %s: " \
576 format, __func__, ##args);\
579 #define JOM(n, format, args...) do { \
580 if (n <= easycap_debug) { \
581 printk(KERN_DEBUG "easycap::%i%s: " \
582 format, peasycap->isdongle, __func__, ##args);\
587 #define JOT(n, format, args...) do {} while (0)
588 #define JOM(n, format, args...) do {} while (0)
589 #endif /* CONFIG_EASYCAP_DEBUG */
591 /*---------------------------------------------------------------------------*/
593 /*---------------------------------------------------------------------------*/
596 /*---------------------------------------------------------------------------*/
598 extern bool easycap_readback
;
599 extern const struct easycap_standard easycap_standard
[];
600 extern struct easycap_format easycap_format
[];
601 extern struct v4l2_queryctrl easycap_control
[];
602 extern struct usb_driver easycap_usb_driver
;
603 extern struct easycap_dongle easycapdc60_dongle
[];
605 #endif /* !__EASYCAP_H__ */