Name Date Size

..25-Oct-20244 KiB

dev_video.cH A D25-Oct-20242.2 KiB

dev_video.hH A D25-Oct-2024246

doc/H25-Oct-20244 KiB

MakefileH A D25-Oct-20242.7 KiB

READMEH A D25-Oct-20245.5 KiB

test_invalid_ioctl.cH A D25-Oct-20241.2 KiB

test_invalid_ioctl.hH A D25-Oct-2024310

test_VIDIOC_AUDIO.cH A D25-Oct-202414.3 KiB

test_VIDIOC_AUDIO.hH A D25-Oct-2024553

test_VIDIOC_AUDOUT.cH A D25-Oct-202413.9 KiB

test_VIDIOC_AUDOUT.hH A D25-Oct-2024562

test_VIDIOC_CROP.cH A D25-Oct-202426.4 KiB

test_VIDIOC_CROP.hH A D25-Oct-2024501

test_VIDIOC_CROPCAP.cH A D25-Oct-20248.9 KiB

test_VIDIOC_CROPCAP.hH A D25-Oct-2024289

test_VIDIOC_CTRL.cH A D25-Oct-202425.8 KiB

test_VIDIOC_CTRL.hH A D25-Oct-2024529

test_VIDIOC_ENUM_FMT.cH A D25-Oct-202415.1 KiB

test_VIDIOC_ENUM_FMT.hH A D25-Oct-2024591

test_VIDIOC_ENUM_FRAMESIZES.cH A D25-Oct-202419.2 KiB

test_VIDIOC_ENUM_FRAMESIZES.hH A D25-Oct-2024377

test_VIDIOC_ENUMAUDIO.cH A D25-Oct-20245.1 KiB

test_VIDIOC_ENUMAUDIO.hH A D25-Oct-2024499

test_VIDIOC_ENUMAUDOUT.cH A D25-Oct-20245.6 KiB

test_VIDIOC_ENUMAUDOUT.hH A D25-Oct-2024383

test_VIDIOC_ENUMINPUT.cH A D25-Oct-20245.6 KiB

test_VIDIOC_ENUMINPUT.hH A D25-Oct-2024526

test_VIDIOC_ENUMOUTPUT.cH A D25-Oct-20245.3 KiB

test_VIDIOC_ENUMOUTPUT.hH A D25-Oct-2024383

test_VIDIOC_ENUMSTD.cH A D25-Oct-20245.6 KiB

test_VIDIOC_ENUMSTD.hH A D25-Oct-2024514

test_VIDIOC_EXT_CTRLS.cH A D25-Oct-202418.5 KiB

test_VIDIOC_EXT_CTRLS.hH A D25-Oct-2024636

test_VIDIOC_FMT.cH A D25-Oct-202451.1 KiB

test_VIDIOC_FMT.hH A D25-Oct-2024412

test_VIDIOC_FREQUENCY.cH A D25-Oct-202421 KiB

test_VIDIOC_FREQUENCY.hH A D25-Oct-2024695

test_VIDIOC_G_SLICED_VBI_CAP.cH A D25-Oct-20244.1 KiB

test_VIDIOC_G_SLICED_VBI_CAP.hH A D25-Oct-2024313

test_VIDIOC_INPUT.cH A D25-Oct-20247 KiB

test_VIDIOC_INPUT.hH A D25-Oct-2024373

test_VIDIOC_JPEGCOMP.cH A D25-Oct-20242.8 KiB

test_VIDIOC_JPEGCOMP.hH A D25-Oct-2024252

test_VIDIOC_LOG_STATUS.cH A D25-Oct-20241.1 KiB

test_VIDIOC_LOG_STATUS.hH A D25-Oct-2024212

test_VIDIOC_MODULATOR.cH A D25-Oct-20246.6 KiB

test_VIDIOC_MODULATOR.hH A D25-Oct-2024388

test_VIDIOC_OUTPUT.cH A D25-Oct-20246.8 KiB

test_VIDIOC_OUTPUT.hH A D25-Oct-2024436

test_VIDIOC_PARM.cH A D25-Oct-20249.1 KiB

test_VIDIOC_PARM.hH A D25-Oct-2024283

test_VIDIOC_PRIORITY.cH A D25-Oct-20247.2 KiB

test_VIDIOC_PRIORITY.hH A D25-Oct-2024370

test_VIDIOC_QUERYBUF.cH A D25-Oct-202415.3 KiB

test_VIDIOC_QUERYBUF.hH A D25-Oct-2024678

test_VIDIOC_QUERYCAP.cH A D25-Oct-20243.8 KiB

test_VIDIOC_QUERYCAP.hH A D25-Oct-2024305

test_VIDIOC_QUERYCTRL.cH A D25-Oct-202419.9 KiB

test_VIDIOC_QUERYCTRL.hH A D25-Oct-2024564

test_VIDIOC_QUERYMENU.cH A D25-Oct-20249.6 KiB

test_VIDIOC_QUERYMENU.hH A D25-Oct-2024383

test_VIDIOC_QUERYSTD.cH A D25-Oct-20242.3 KiB

test_VIDIOC_QUERYSTD.hH A D25-Oct-2024248

test_VIDIOC_REQBUFS.cH A D25-Oct-202412.9 KiB

test_VIDIOC_REQBUFS.hH A D25-Oct-2024578

test_VIDIOC_STD.cH A D25-Oct-202414.5 KiB

test_VIDIOC_STD.hH A D25-Oct-2024451

test_VIDIOC_TUNER.cH A D25-Oct-202415.1 KiB

test_VIDIOC_TUNER.hH A D25-Oct-2024478

v4l2_foreach.cH A D25-Oct-20242.3 KiB

v4l2_foreach.hH A D25-Oct-2024356

v4l2_show.cH A D25-Oct-20243.7 KiB

v4l2_show.hH A D25-Oct-2024535

v4l2_test.cH A D25-Oct-202418.9 KiB

v4l2_test.hH A D25-Oct-2024460

v4l2_validator.cH A D25-Oct-20242 KiB

v4l2_validator.hH A D25-Oct-2024454

video_limits.hH A D25-Oct-2024631

README

1
2           v4l-test: Test environment for Video For Linux Two API
3
4Release History
5---------------
623 Jul 2009  0.17 Test cases added for VIDIOC_ENUM_FRAMESIZES and
7                  VIDIOC_G_JPEGCOMP. New V4L2_PIX_FMT_* formats also
8                  used in test cases.
9 6 Jul 2009  0.16 Iterate through all available inputs in VIDIOC_G_STD and
10                  VIDIOC_S_STD test cases
1125 May 2009  0.15 Test cases added for VIDIOC_G_EXT_CTRLS, VIDIOC_S_EXT_CTRLS
12                  and VIDIOC_TRY_EXT_CTRLS
13 7 May 2009  0.14 Test cases added for VIDIOC_QUERYBUF;
14                  Debug functions separated
1529 Apr 2009  0.13 Added string content validation;
16                  Test cases added for VIDIOC_REQBUFS
1719 Apr 2009  0.12 Test cases added for VIDIOC_S_FMT;
18                  NULL parameter test suite split to read only, write only
19                  and write/read ioctl suite;
20                  More verbose debug output in VIDIOC_S_FREQUENCY and in some
21                  other test cases;
22                  More strict check added for strings in different test cases
23 9 Apr 2009  0.11 Test cases added for VIDIOC_G_OUTPUT, VIDIOC_S_OUTPUT,
24                  VIDIOC_G_FMT, VIDIOC_G_SLICED_VBI_CAP, VIDIOC_QUERYMENU;
25                  Cleaned up ret and errno variable names;
26                  Separated the NULL parameter test cases to a spearated testsuite
27                  and reworked most of the NULL parameter test cases;
28                  Added camera enabling through /sys/devices/platform/eeepc/camera;
29                  Added results page to documentation;
30                  Follow kernel API changes in video_dummy.ko
3118 Mar 2009  0.10 Test cases added for VIDIOC_G_PARM;
32                  Duplicated test for V4L2_BUF_TYPE_VIDEO_CAPTURE removed in
33                  VIDIOC_ENUM_FMT test
3414 Mar 2009  0.9  Test cases added for VIDIOC_S_CROP;
35                  Test steps added for VIDIOC_S_CTRL
3622 Feb 2009  0.8  Test cases added for VIDIOC_G_CROP, VIDIOC_G_CTRL and VIDIOC_S_CTRL
37 9 Feb 2009  0.7  Test cases added for VIDIOC_G_AUDIO, VIDIOC_G_AUDOUT,
38                  VIDIOC_S_AUDIO and VIDIOC_G_CROP;
39                  Added video_dummy kernel driver to verify the test
40                  environment;
41                  Some cleanup
42 4 Feb 2009  0.6  Test cases added for VIDIOC_G_AUDIO, VIDIOC_G_AUDOUT,
43                  VIDIOC_G_MODULATOR, VIDIOC_G_PRIORITY, VIDIOC_S_PRIORITY
44                  and VIDIOC_S_FREQUENCY
4531 Jan 2009  0.5  Test cases added for VIDIOC_QUERYSTD, VIDIOC_G_FREQUENCY
46                  and VIDIOC_G_TUNER
4724 Jan 2009  0.4  Test cases for MAX_EM28XX_INPUT, MAX_EM28XX_TVNORMS removed;
48                  some typos fixed
49 4 Jan 2008  0.3  Test cases for VIDIOC_ENUMOUTPUT, VIDIOC_ENUMAUDOUT,
50                  VIDIOC_QUERYCTRL added;
51                  New test cases for VIDIOC_ENUMAUDIO, VIDIOC_ENUM_FMT,
52                  VIDIOC_ENUM_STD
5322 Dec 2008  0.2  Test cases with NULL parameter added;
54                  Test cases for VIDIOC_CROPCAP added
5518 Dec 2008  0.1  First release
56
57Written by M�rton N�meth <nm127@freemail.hu>
58Released under GPL
59
60What is this?
61-------------
62v4l-test is a test environment for V4L2 drivers. The V4L2 drivers
63are running under Linux in kernel space. This test environment is running
64in userspace and tries what normal video application would do. It also
65tries some things which are supposed to test the error handling mechanisms
66of a V4L2 driver. These are the "invalid test cases".
67
68The V4L2 API only covers webcams and analog tuner cards, the digital broadcast
69is out of the scope of V4L2 API so it is also out of the scope of this test
70environment. See Linux DVB API at http://linuxtv.org/docs/dvbapi/dvbapi.html
71for digital broadcast and Chapter 6.3 "Relation of V4L2 to other Linux multimedia APIs"
72in V4L2 specification.
73
74How to build?
75-------------
76To build the test environment you will need a C compiler, "make" and the
77CUnit development files installed. Just type "make" and the test environment
78is ready.
79
80How to run?
81-----------
82You need to have a video device (i.e. webcam, tuner card, etc.) connected
83to your system and available under /dev/video0. If you don't have any
84hardware device available, you can still test the "Virtual Video Driver".
85To compile this you need to compile your kernel with CONFIG_VIDEO_VIVI=m
86under:
87
88  -> Device Drivers
89    -> Multimedia devices
90      -> Video For Linux
91        -> Video capture adapters
92         -> Virtual Video Driver
93
94At this point you can execute v4l-test.
95
96Video for Linux Two Specification
97---------------------------------
98The V4L2 API specification can be found at http://v4l2spec.bytesex.org/spec/ .
99Revision 0.42 of V4L2 is the base for this test environment.
100
101Code Coverage
102-------------
103The code coverage shows which lines of the code were executed and how many
104times. The measurement results gives you a feedback about the quality of
105the test cases.
106You can measure the code coverage of a kernel module with the gocv and lcov
107softwares. See http://ltp.sourceforge.net/coverage/gcov.php and
108http://ltp.sourceforge.net/coverage/lcov.php for details.
109
110Current status
111--------------
112Currently all test are running and evaluated automatically. This might
113change in future if we want to test for example plugging and unplugging
114a USB video device or ask the user if a received picture make sense or not.
115
116See doc/index.html about how much of the specification is covered by the
117different test cases.
118
119See also
120--------
121See also doc/index.html for further references and recommended readings.
122
123Feedbacks
124---------
125Any feedbacks, comments, ideas, etc. are welcome at the author's
126email address: M�rton N�meth <nm127@freemail.hu>.
127