!"#
$"%
&'()$*+,-$(''&)$.
*+$$*&+
*&'()$*&+ /
0&0 1/
$"%23 4
!'3!
+%2'.!
,* !'3! 5
'63)7%#
%3006"8
%32&0 1
%30"8&0 1
%32&16
,'*& 1
96'1
:!% .
:)(7()(+(
,+%
1*)
* *&;,;7$<* *&;;7$<* *&;$)-;7$/
* *&;,;='(,&'<* *&;;='(,&'4
* *&;(+;*+'$<* *&;,;*+'$<* *&;;*+'$4
* *&;(+;&$'$<* *&;,;&$'$<* *&;;&$'$4
* *&;>()-$)<* *&;,;$)<* *&;;$)<* *&;$)-;(?$;$)<
* *&;,;(?$;$)<* *&;;(?$;$)4
* *&;(+ *&<* *&;,; *&<* *&;; *&#
* *&;(+ &$<* *&;,; &$<* *&;; &$
* *&;(+& ();
* *&; (& ();
;* *&;&
;* *&;&:
;* *&;&()-
;* *&;($;(); $.
';* *&;;(+& ();)(($
';* *&;;(+& ();)(
';* *&;,;(+& ();)(
';* *&;;,'; $/
';* *&;,;,'; $/
';* *&;;,';)( $$/
';* *&;,;,';)( $$/
';* *&;;,'*&;&+7*,4
';* *&;;,'*&;@)*$(4
';* *&;;,'*&;)( 4
';* *&;,;,'*&;)(
';* *&;;(A&
';* *&;;,';(+(5
';* *&;,;,';(+(5
';* *&;;()*&+;)( 5
';* *&;,;()*&+;)( 5
';* *&;;&$$;)( #
';* *&;,;&$$;)( #
';* *&;;?*&;(+(#
';* *&;;?*&;)(
';* *&;,;?*&;)(
';* *&;;?*&;'(
';* *&;,;,';$*$ (
';* *&;,;,';&+,*$ (
';* *&;,;,';'((
';* *&;,;,';&)(
';* *&;,;,';$;$*(
';* *&;,;,';$; $(
';* *&;,;,';$(*$(
';* *&;,;,';&:
';* *&;,;,';,,.
';* *&;,;,';,.
';* *&;,;,';,.
';* *&;,;,';).
';* *&;;(+;-+(+.
';* *&;;(+& ();&
';* *&;,;&+*+(
';* *&;;'(+
)(**&+A*$&)-/
&036%!00
$2 :2%"10"$%00%01
2%%"$2 :!682%"%<"
2%%3$2%B81%%/
C2%"!%001%/<232%!%
!6"!
.
*%
$2%!6"%" !%6D%"
%*2E%<"F002
103220
0%0!%%
G 0823FEH
tar xjf sdk_2253_X.Y.Z_linux.tar.bz2,
2?-I%21%2 :
G 232622208 :%H
cd sdk_2253_X.Y.Z_linux
G 21!00H
make all
.G *%2!%E!H
sudo make install
G '321"0$2!"
!621%2"6%
/G &0H*2%01%6033<03
%0<2!!62H
modprobe s2253
+H$2%%0%6"0!"<2!
%26%"!622%0%*28
1%6%6%!23%<%0%.!6"0!
3%2!%
%&0
@221%<2211%,'*&
21216$21%!
J1?K2?0%2!"11%0%2
%6%!$2E%11%1001
2211%10
Video Capture and Output Driver
$21%00%.L.G%$2.'*%
!2$"%
L20H13%1.91"90%G.0%
%008%"/$21.91"233%B
L!!G%2%1
$2211%"%200%2%00.'*
"0%3!0%%-.L08----G
-.#'L+%!90<-01"0G
!0%%!%='(,<'(,.'A/.!6
%!%$2'(,.A/.%!%%"!2
L2%6G'.'(,%0%!20
1%1!%3%<201"
%<%00<E306!10%
"E306<%2%0<"32%%<2<%<
%
&!00%03!0%%1%31
2%!%60132!0%%12%06
2!0%032329"2!0%%1%3
12%!%6%!39"2!0%%11
8
$210106!0%%%!%3'(,.
A/.!6%!%'.!3!%!%'(,
%0%!%%%002%6='(,3%
%002%!
$2!%212!601%"20
%!%20%!%!%6*%!!!
%"20%!%%!%6<%30%!%3
0%!%!%6$2!!600%%31
306"8
/
Troubleshooting
*21%<321<21
1%<2%!68!0"60"!2
1'%%20!Juname -rKJdmesgK22!
1%!"2%"[email protected]*
621%!"8<0%%0128E3
E
$21E%8!2%%
/lib/modules/`uname -r`/extra/s2253.ko.
*2%E%!%%3<2220068%0<0%
%21<%30.2%0%%*6212
JlsusbK03!%<6%21E!%
@2%033<62%215.H
2( L G2$"%$21%2
E!E2!/lib/firmware/s2253.fw*2%E%
!%%3<0%%21<0.2%0%%@22
E!%<21%2235.H
2( $"%2"
*2( %322%%"15.H%2
E!2%M<23216J1K
J%!8KJ%!8K$2%212
%!"3!%%3%"<J!%3K%201%!
"20"!
$2( 2$"%2%%2
!0%10%3$2( "822%3%"%
%M!22B%1%0!$2( "83
""6%31.L%'*G
4
Demo Program
8%1%%
8!2!!Jmake demoK
J./captureK%2!00
$60J/capture -hK20!
. 7!0<60J./capture -4 -b 2000000 -o output.m4vK
%1'(,.1"0%2Eoutput.m4v
06"%%06110"62
%!!006!!%%061%!%H
mplayer tv:// -tv outfmt=yuy2:width=320:height=240:norm=NTSC:device=/dev/video1
mplayer tv:// -tv outfmt=uyvy:width=320:height=240:norm=NTSC:device=/dev/video1
mplayer tv:// -tv outfmt=mjpg:width=320:height=240:norm=NTSC:device=/dev/video1
MPEG4: mplayer tv:// -tv outfmt=0x5634504d:width=640:height=480:norm=NTSC
H264: mplayer tv:// -tv outfmt=0x34363248:width=640:height=480:norm=NTSC
$20%2332!%2outfmt%3$22
232%3%2!3%F$2!%38+$
'$21%3%220106!<3
6%!06!!%%06"2%!%%!%6
Notes on the MP4 format
$2'.!0"62%1
%6!%3%!$21%%J3!K'.
%!<22!8%0%%"%!!61
83!E%6%1<%0%%
0623!!2%!00
%00!66062>8!<'677!03$%
2'.E%06"!%06%<20!
%06%%23!%!!!6!'.
E
$0!'.!<%29!029.90
220!$20!%"E
$03!'.!<%29F029.9
0+22%E!606%!06%
$06'.E22101<!%"23!
!7!0<J0!0.N11K062E2
1
$06'.E2%93!<%206"8!03!<
2212E929O623!!06
21
GUI Demo Program
8%1%%(200
J!06K216$2008%!
23!3H
%2 1+!%2%!2210$2
"%2"%8%3='(,%0%22
6<201%32!0600L
%<G0%!E<8%!1 '$2
%%%62%32%!<232%
""%"P%2%!3$2!0601E
022 1+!%%<3
!0%!%"001%!%6
5
Playing Recorded Files
(!0%2+'6LG'6(77!03
"%H20H131
'6"%H20H!062B2
77!03"%H20HC!033
@20%%B<%5540%+$<0%'%<
%"%2!3%F%0<%/.#.#
!0%H
MJPEG: vlc output.mjpg --mjpeg-fps 29.97
MPEG4: vlc output.m4v
h264: vlc output.h264
MP4: vlc output.mp4
'6!0%H
MJPEG: mplayer output.mjpg -fps 29.97
UYVY: mplayer -rawvideo format=uyvy:w=640:h=480 -demuxer rawvideo output.uyvy
-fps 29.97
YUYV: mplayer -rawvideo format=yuy2:w=640:h=480 -demuxer rawvideo output.yuy2
-fps 29.97
NV12: mplayer -rawvideo format=nv12:w=640:h=480 -demuxer rawvideo output.nv12
-fps 29.97
grey: mplayer -rawvideo format=y800:w=640:h=480 -demuxer rawvideo output.grey
-fps 29.97
MPEG4: mplayer output.m4v
h264: mplayer output.h264 -fps 29.97
MP4: mplayer output.mp4
77!031%*!H
MJPEG: ffmpeg -f mjpeg -r 29.97 -i output.mjpg -vcodec copy output_mjpg.avi
UYVY: ffmpeg -f rawvideo -pix_fmt uyvy422 -s 640x480 -r 29.97 -i output.uyvy
-vcodec copy output_uyvy.avi
YUYV: ffmpeg -f rawvideo -pix_fmt yuyv422 -s 640x480 -r 29.97 -i output.yuyv
-vcodec copy output_yuyv.avi
NV12: ffmpeg -f rawvideo -pix_fmt nv12 -s 640x480 -r 29.97 -i output.nv12
-vcodec copy output_nv12.avi
grey: ffmpeg -f rawvideo -pix_fmt gray -s 640x480 -r 29.97 -i output.grey
-vcodec copy output_grey.avi
MPEG4: ffmpeg -f m4v -r 29.97 -i output.m4v -vcodec copy output_mpeg4.avi
h264: ffmpeg -f h264 -r 29.97 -i output.h264 -vcodec copy output_h264.avi
$2E%%"1*!%3!
MJPEG: mencoder output.mjpg -fps 29.97 -ovc copy -o output_mjpg.avi
UYVY: mencoder -rawvideo format=uyvy:w=640:h=480 -demuxer rawvideo output.uyvy
-fps 29.97 -ovc copy -o output_uyvy.avi
YUYV: mencoder -rawvideo format=yuy2:w=640:h=480 -demuxer rawvideo output.yuyv
-fps 29.97 -ovc copy -o output_yuyv.avi
NV12: mencoder -rawvideo format=nv12:w=640:h=480 -demuxer rawvideo output.nv12
-fps 29.97 -ovc copy -o output_nv12.avi
grey: mencoder -rawvideo format=y800:w=640:h=480 -demuxer rawvideo output.grey
-fps 29.97 -ovc copy -o output_grey.avi
MPEG4: mencoder output.m4v -ovc copy -o output_mpeg4.avi
h264: mencoder output.h264 -fps 29.97 -ovc copy -o output_h264.avi
#
Using ALSA for audio capture and playback
$2101%'<349
90$210%0621
01
$E2!2"<%203!J9KH
**** List of CAPTURE Hardware Devices ****
card 1: s2253 [Sensoray 2253], device 0: s2253 [Sensoray 2253]
Subdevices: 1/1
Subdevice #0: subdevice #0
A%1#%2<%"%J2H<#K
$<%203!%0621<!<
%!0<!"2%7!0H
PCM 16-bit stereo: arecord -D hw:1,0 -f S16_LE -r 48000 -c 2 output.pcm
g.711 A-law mono: arecord -D hw:1,0 -f A_LAW -r 8000 -c 1 output.g711
g.711 mu-law mono: arecord -D hw:1,0 -f MU_LAW -r 8000 -c 1 output.g711
%QN3<290!2
7!0%<%2!03HJ!K
$06"822%<%20603!%06
2%!%3%%7!0H
PCM 16-bit stereo: aplay -f S16_LE -r 48000 -c 2 output.pcm
g.711 A-law mono: aplay -f A_LAW -r 8000 -c 1 output.g711
g.711 mu-law mono: aplay -f MU_LAW -r 8000 -c 1 output.g711
$P%21!0<%2%!!!7
!0<2!"%<%290J%!9
K%2"86%RS<86%%2
%323$21!%<'6"80
$2*0,%3%!,322%T
%!0221!%21C2,%
"$2*0%3%6%22
*0%'%%(%!
*2!!9%<69!000
%2""232%3%21
$21!0%%3%09"%3%%
C26'.'(,9$%!%"30
Using the Video Output Device
$2%%606E2101%00
E%32JK!2H
cat output.m4v > /dev/video2
$21!02E!%2!
!6$2101606"8'(,9.A/.
!6%!%<'.3!%!%<'(,9$
$2J06"8K!03!%!021
93!'.%!3!%!06"21
$21!2!%%2!0%%%!<
2%0122320!%
$2J06"8K!!6%"%06!0%%%!%<"
B2!!%%"01%0!%
$21%!%"%!606"87%!6
%%!3!*2%!!%%
%!22%06%FL4#.#+$4#4/'G2!3
"2%062"8"
$06"820<21"832%%6%
2"C12%"$%006"8!!6
%"C1<%2* *&;$)(&77
* *&; (& (); .; (; ;$&'
Using Loopback on Video Output Device
%2%!!%0"8!0.3!%!1
0H
09F9%4#..#939#9906"89
$20!O%2%20E%02!2
06"8!%%9"C806!!!2
0632%!122%$2%%%22!008
!%660<%2"%
%%0%%"!!%%%2"8"6%!3
0010
%3L!0H11#N11G0!2
1%%6.8"C32%!$2%"C3
%0!%<%322!0
!1%<%326
$206"8!%%96!2063!
9E%<321!6622
1!%22%32!%!260
1!%%2;* ;&@;$(+-2'*
Using the Video Overlay
$21302!3%1210%06$2
216%/9"%090!9"%
090%06!$21%00%16!3%
2'+,!.9"'!$21!0
%%%00%93%
$21!2!302!3%121
001%!%03023%!6"%2%!
!33%%2"1<%%3E0%%3!6%
1!%"00$2302%0062!
22!3<2!2!6216302
'+,'!3%"1!2!
$2 :overlay6%overlay03!16
!3%%2%0overlay-demo.sh2%!0!3%
01$2%2%0overlay-lines.sh%2%06
$2%2%0overlay-text.sh2%06$2%2
%0overlay-font.sh%2%6%!%
2%2%2"83$2%!0overlay.c
%2%2!23!!%21
%S2253_VIDIOC_OVERLAY"%"3!%
3
GPIO Device
$2,'*&1%0%%%6%%,'*&%%$2%
321%6%%%30(2"00%%
3020+++%"6<3"E%"32"
%HJ+./K<2"%30E%%"32
,'*&3%"62"$2"%%"%2E%30+++
%"6230%2"$230+++%"6%
EL3JKJKG21EJK,'*&
"!"6321E<JK,'*&"!E"6
3JKJ#K21E
%!0!2%%01%1.2,'*2
,'&2'*S2253_CID_GPIS2253_CID_GPO
Low-Latency Preview
$1%9601<2%!!!%"--<2
4#.<232.#+$4/'<0!%"<!3
O0%"<!%"%$296!%
%!622%!U2%%3%22
%%96!$2%!"60%%%2%F%%
11%%%"!%1"!210
9601!"%%!%62
L2%3'.'(,9$!<!0G$2
9601"%2!6!9601
2%%<1"82%%00*96
01%B%!<%
V4L2_MPEG_AUDIO_ENCODING_NONE022
V4L2_CID_MPEG_AUDIO_ENCODING
Known Limitations
1%%<6%!%%2"%!H
0<00$2%"%%1!"
0%H
Capture 1 Capture 2 Output
&8 &8
&8 &8
&8 &8
'(,9.00"%%!%62A/.0
$2%"%%1!"0%H
Capture H.264 Capture MPEG-4 Output H.264 Output MPEG-4
&8 &8
&8 &8
&8 &8
)01!%!3!"2*
!01%2%!2"<013
2!6%C%LP86%310
0G
$2%C%H
• !121C2"
• 222322011
• 2!
2%!"2!%< --01 --
0"0!%!%6!
.
• :)
General Notes
1%%%1/dev/videoX2?%2!"
%%3212%033$2/dev/videoX%
"21$2E%11%
1022%10@2212
%"!"6%32* *&;>()-'
!2E2%$21%%00!00<
3%!0!%"23929O62203!%
%%321
Driver Ioctl Reference
$2%%01%129%0E
0"%<2B32%B621%32.'*
321%7!0.'*<
0%%2$3"%
L20H13%1.91"90%G
%ioctl2%!3002
$2E%0!LfdG%E%0"6open()<22
%0E%2%%1
$2%0!LrequestG%2B%<22%0E%2
60B%
$220!%09%0E
%#%%%%<311%
$2ioctls"%"62B%0!
19%0E%%B%%E
1%2
VIDIOC_G_FMT, VIDIOC_S_FMT, VIDIOC_TRY_FMT
int ioctl(int fd, int request, struct v4l2_format *fmt);
fmt->pix.width
*33"4#%0%/
fmt->pix.height
*335/.#L+$G4/L'G%0%/
+H0<22323!0%%!%
L='(,''.A/.'.G%!%%2
%!
fmt->pix.pixelformat
007&)%H
V4L2_PIX_FMT_MJPEG –!0%%!='(,
V4L2_PIX_FMT_JPEG –%!%V4L2_PIX_FMT_MJPEG
V4L2_PIX_FMT_MP4V –'(,9.1!6%!
V4L2_PIX_FMT_H264 –A/.1!6%!
V4L2_PIX_FMT_MP42 –'.3!%!
V4L2_PIX_FMT_MPEG –'(,%0%!
V4L2_PIX_FMT_UYVY –-.12!E%
V4L2_PIX_FMT_YUYV T-.1!E%
V4L2_PIX_FMT_NV12 –-.#%!90!
V4L2_PIX_FMT_GREY –-9"%!0%6
+H%E112%2
fmt->pix.field
00!%H
$2V4L2_FIELD_NONE0%%%%3E
0%02!%%3%$2%!2!1%2
P333%%"6!"E%<03%!2
03%%1!$2%%%20C3"210
%!%2
$2V4L2_FIELD_INTERLACE001%"2E%2
0!%%!"3%!60022
0232%!22123221%
$2%%%20C3"210%!%2
$2V4L2_FIELD_ANY0%232!<13
2321
$2E!%""62;* ;*+$()'&$(
<%"
/
VIDIOC_G_JPEGCOMP, VIDIOC_S_JPEGCOMP
int ioctl(int fd, int request, v4l2_jpegcompression *jc);
jc->quality
*33#5#$2%4
.;'*?;7$;='(,!%"%
VIDIOC_ENUM_INPUT, VIDIOC_G_INPUT, VIDIOC_S_INPUT
int ioctl(int fd, int request, struct v4l2_input *inp);
$2%60#<!J!0%K
$2inp->statusE!6212"V4L2_IN_ST_NO_H_LOCK%2
1%"8201%3
VIDIOC_ENUM_OUTPUT, VIDIOC_G_OUTPUT, VIDIOC_S_OUTPUT
int ioctl(int fd, int request, struct v4l2_output *inp);
$2%60#<!J!0%K
VIDIOC_QUERYCTRL, VIDIOC_G_CTRL, VIDIOC_S_CTRL,
VIDIOC_TRY_EXT_CTRLS, VIDIOC_G_EXT_CTRLS,
VIDIOC_S_EXT_CTRLS
int ioctl(int fd, int request, struct v4l2_ext_controls *ctrls);
@2%3* *&;,;$)* *&;;$)<
%9N;%%VVV4L2_CTRL_CLASS_USER,
the s00ctrls->controlsE%1%H
V4L2_CID_BRIGHTNESSH#<06
V4L2_CID_CONTRASTH#<06
V4L2_CID_SATURATIONH#<06
V4L2_CID_HUE:9<#06
V4L2_CID_AUDIO_VOLUME:#50<#40
V4L2_CID_AUDIO_BALANCE:9####<#
V4L2_CID_HFLIPH"2FO0<#06
4
V4L2_CID_VFLIPH"1O0<#06
S2253_CID_DFLIP:
3O0<#06+1"--<
--='(,!%
$21!3<%23O0!"%H
5#3%HA7*'V7*'V# 7*'V
#3%HA7*'V7*'V 7*'V#
4#3%HA7*'V#7*'V 7*'V
S2253_CID_INTERPOLATE:
<0%2620E02
!%<01%12,*!06
S2253_CID_OUTPUT_MODE:
*33#<223!3%H
#H*T%06"8%0
H0T%062010
H%T%06%"%
H7%2T%06%32!06%"0%
!%391%6
&016
S2253_CID_LOW_LATENCY:
<!%229606"8!%C
#H&CT%2063!E%!
H&T%20631%!$206"81
!001!%06"86
"%2!%!1"7!%00
361"32%21T21
!68%%%%%0%%"6
&016
S2253_CID_GPI:
<962%1%2%2
3900%0
S2253_CID_GPO:
<!%%23900%0
S2253_CID_XLED_MODE:
*33#<223!3%H
#HA88T?( "8218%"%
HA8T?( C218%"%
H&T?( %6%L0G
H&CT?( %6%C
S2253_CID_OSD_ENABLE:
*3<!%2229%9%06%1%"<
22%%
#H%"LG
H"<2.
H"<2//
S2253_CID_OSD_TRANSPARENT:
*3<!%2%029%9%06
"83%
#H#WL"8"83G
H##WL"83GLG
H#W
HW
S2253_CID_OSD_POSITION:
!H#<$0H<
S2253_CID_OSD_DATEFORMAT:
#H9 9----LG
H 99----
H9 9--
H 99--
.H9 9----
H 99----
/H9 9--
4H 99--
H <----
5H ----
#H <--
H --
S2253_CID_OSD_TIMEFORMAT:
AAHHH#<AAHH#H<AAHH##H< #
S2253_CID_OSD_TIMEZONE:
32C%%!$ $X#
+H2%%6%%2!2112$
!%22%8
S2253_CID_OSD_MESSAGE:
36JYKJYK%!<%016
S2253_CID_OSD_XOFF:
*33#!3!2<#
S2253_CID_OSD_YOFF:
*33#!3!232<#
@2%9N;%%VVV4L2_CTRL_CLASS_MPEG,
%00ctrls->controlsE%1%H
V4L2_CID_MPEG_STREAM_VBI_FMT:
%!V4L2_MPEG_STREAM_VBI_FMT_NONE
V4L2_MPEG_STREAM_VBI_FMT_IVTV%%%0%!
5
*2/.%!<!6'(,9$06
@2"<%%"1
V4L2_CID_MPEG_AUDIO_ENCODING:
%!V4L2_MPEG_AUDIO_ENCODING_AAC
V4L2_MPEG_AUDIO_ENCODING_NONE&62'.'(,9$0
6
V4L2_CID_MPEG_AUDIO_MODE:
%!V4L2_MPEG_AUDIO_MODE_STEREO
V4L2_MPEG_AUDIO_MODE_MONO&62'.'(,9$06
V4L2_CID_MPEG_AUDIO_AAC_BITRATE:
<###<###"0%%0%/<###"0%<5<###"0%
&62'.'(,9$06
V4L2_CID_MPEG_VIDEO_ENCODING:
%!V4L2_MPEG_VIDEO_ENCODING_MPEG_4_AVCL2/.G
V4L2_MPEG_VIDEO_ENCODING_MPEG_4L'(,9.G
&62'.'(,9$06
V4L2_CID_MPEG_VIDEO_ASPECT:
*33#%%010%30
6
#H
H.
H/5
H
+H0#%'%0)<2% %06%0)
V4L2_CID_MPEG_VIDEO_GOP_SIZE:
*33##$2%3#!%%2
9,&'%F06
V4L2_CID_MPEG_VIDEO_BITRATE:
##<####<###<###"0%%0%##<###"0%<<###<###
"0%06
V4L2_CID_MPEG_VIDEO_H264_I_PERIOD:
*33###&6A/.3 %3#
E%!%* )6<2%* )E%!
16+2,&'
VIDIOC_ENUMAUDIO, VIDIOC_G_AUDIO, VIDIOC_S_AUDIO
int ioctl(int fd, int request, struct v4l2_audio *audio);
$20%H
*#HJKL!G
*HJ*KL%G
20%%009N!.; & (;L!1!
1<%8%,<!3G$20%
,%09"H"2%!%!2%!03%%
#
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
Page is loading ...
/
