V4L/DVB (4042): Documentation: whitespace cleanup
Signed-off-by: Michael Krufky <mkrufky@linuxtv.org> Signed-off-by: Mauro Carvalho Chehab <mchehab@infradead.org>
This commit is contained in:
Родитель
680543c5d2
Коммит
6e20409004
|
@ -18,7 +18,7 @@ Ragnar Hojland Espinosa <ragnar@macula.net>
|
||||||
|
|
||||||
|
|
||||||
+ many more (please mail me if you are missing in this list and would
|
+ many more (please mail me if you are missing in this list and would
|
||||||
like to be mentioned)
|
like to be mentioned)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -1,9 +1,9 @@
|
||||||
|
|
||||||
ET61X[12]51 PC Camera Controllers
|
ET61X[12]51 PC Camera Controllers
|
||||||
Driver for Linux
|
Driver for Linux
|
||||||
=================================
|
=================================
|
||||||
|
|
||||||
- Documentation -
|
- Documentation -
|
||||||
|
|
||||||
|
|
||||||
Index
|
Index
|
||||||
|
@ -156,46 +156,46 @@ Name: video_nr
|
||||||
Type: short array (min = 0, max = 64)
|
Type: short array (min = 0, max = 64)
|
||||||
Syntax: <-1|n[,...]>
|
Syntax: <-1|n[,...]>
|
||||||
Description: Specify V4L2 minor mode number:
|
Description: Specify V4L2 minor mode number:
|
||||||
-1 = use next available
|
-1 = use next available
|
||||||
n = use minor number n
|
n = use minor number n
|
||||||
You can specify up to 64 cameras this way.
|
You can specify up to 64 cameras this way.
|
||||||
For example:
|
For example:
|
||||||
video_nr=-1,2,-1 would assign minor number 2 to the second
|
video_nr=-1,2,-1 would assign minor number 2 to the second
|
||||||
registered camera and use auto for the first one and for every
|
registered camera and use auto for the first one and for every
|
||||||
other camera.
|
other camera.
|
||||||
Default: -1
|
Default: -1
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: force_munmap
|
Name: force_munmap
|
||||||
Type: bool array (min = 0, max = 64)
|
Type: bool array (min = 0, max = 64)
|
||||||
Syntax: <0|1[,...]>
|
Syntax: <0|1[,...]>
|
||||||
Description: Force the application to unmap previously mapped buffer memory
|
Description: Force the application to unmap previously mapped buffer memory
|
||||||
before calling any VIDIOC_S_CROP or VIDIOC_S_FMT ioctl's. Not
|
before calling any VIDIOC_S_CROP or VIDIOC_S_FMT ioctl's. Not
|
||||||
all the applications support this feature. This parameter is
|
all the applications support this feature. This parameter is
|
||||||
specific for each detected camera.
|
specific for each detected camera.
|
||||||
0 = do not force memory unmapping
|
0 = do not force memory unmapping
|
||||||
1 = force memory unmapping (save memory)
|
1 = force memory unmapping (save memory)
|
||||||
Default: 0
|
Default: 0
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: frame_timeout
|
Name: frame_timeout
|
||||||
Type: uint array (min = 0, max = 64)
|
Type: uint array (min = 0, max = 64)
|
||||||
Syntax: <n[,...]>
|
Syntax: <n[,...]>
|
||||||
Description: Timeout for a video frame in seconds. This parameter is
|
Description: Timeout for a video frame in seconds. This parameter is
|
||||||
specific for each detected camera. This parameter can be
|
specific for each detected camera. This parameter can be
|
||||||
changed at runtime thanks to the /sys filesystem interface.
|
changed at runtime thanks to the /sys filesystem interface.
|
||||||
Default: 2
|
Default: 2
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: debug
|
Name: debug
|
||||||
Type: ushort
|
Type: ushort
|
||||||
Syntax: <n>
|
Syntax: <n>
|
||||||
Description: Debugging information level, from 0 to 3:
|
Description: Debugging information level, from 0 to 3:
|
||||||
0 = none (use carefully)
|
0 = none (use carefully)
|
||||||
1 = critical errors
|
1 = critical errors
|
||||||
2 = significant informations
|
2 = significant informations
|
||||||
3 = more verbose messages
|
3 = more verbose messages
|
||||||
Level 3 is useful for testing only, when only one device
|
Level 3 is useful for testing only, when only one device
|
||||||
is used at the same time. It also shows some more informations
|
is used at the same time. It also shows some more informations
|
||||||
about the hardware being detected. This module parameter can be
|
about the hardware being detected. This module parameter can be
|
||||||
changed at runtime thanks to the /sys filesystem interface.
|
changed at runtime thanks to the /sys filesystem interface.
|
||||||
Default: 2
|
Default: 2
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
|
|
@ -21,7 +21,7 @@ Internal interface: Video For Linux (V4L)
|
||||||
Supported controls:
|
Supported controls:
|
||||||
- by V4L: Contrast, Brightness, Color, Hue
|
- by V4L: Contrast, Brightness, Color, Hue
|
||||||
- by driver options: frame rate, lighting conditions, video format,
|
- by driver options: frame rate, lighting conditions, video format,
|
||||||
default picture settings, sharpness.
|
default picture settings, sharpness.
|
||||||
|
|
||||||
SUPPORTED CAMERAS:
|
SUPPORTED CAMERAS:
|
||||||
|
|
||||||
|
@ -191,66 +191,66 @@ init_model2_sat Integer 0..255 [0x34] init_model2_sat=65
|
||||||
init_model2_yb Integer 0..255 [0xa0] init_model2_yb=200
|
init_model2_yb Integer 0..255 [0xa0] init_model2_yb=200
|
||||||
|
|
||||||
debug You don't need this option unless you are a developer.
|
debug You don't need this option unless you are a developer.
|
||||||
If you are a developer then you will see in the code
|
If you are a developer then you will see in the code
|
||||||
what values do what. 0=off.
|
what values do what. 0=off.
|
||||||
|
|
||||||
flags This is a bit mask, and you can combine any number of
|
flags This is a bit mask, and you can combine any number of
|
||||||
bits to produce what you want. Usually you don't want
|
bits to produce what you want. Usually you don't want
|
||||||
any of extra features this option provides:
|
any of extra features this option provides:
|
||||||
|
|
||||||
FLAGS_RETRY_VIDIOCSYNC 1 This bit allows to retry failed
|
FLAGS_RETRY_VIDIOCSYNC 1 This bit allows to retry failed
|
||||||
VIDIOCSYNC ioctls without failing.
|
VIDIOCSYNC ioctls without failing.
|
||||||
Will work with xawtv, will not
|
Will work with xawtv, will not
|
||||||
with xrealproducer. Default is
|
with xrealproducer. Default is
|
||||||
not set.
|
not set.
|
||||||
FLAGS_MONOCHROME 2 Activates monochrome (b/w) mode.
|
FLAGS_MONOCHROME 2 Activates monochrome (b/w) mode.
|
||||||
FLAGS_DISPLAY_HINTS 4 Shows colored pixels which have
|
FLAGS_DISPLAY_HINTS 4 Shows colored pixels which have
|
||||||
magic meaning to developers.
|
magic meaning to developers.
|
||||||
FLAGS_OVERLAY_STATS 8 Shows tiny numbers on screen,
|
FLAGS_OVERLAY_STATS 8 Shows tiny numbers on screen,
|
||||||
useful only for debugging.
|
useful only for debugging.
|
||||||
FLAGS_FORCE_TESTPATTERN 16 Shows blue screen with numbers.
|
FLAGS_FORCE_TESTPATTERN 16 Shows blue screen with numbers.
|
||||||
FLAGS_SEPARATE_FRAMES 32 Shows each frame separately, as
|
FLAGS_SEPARATE_FRAMES 32 Shows each frame separately, as
|
||||||
it was received from the camera.
|
it was received from the camera.
|
||||||
Default (not set) is to mix the
|
Default (not set) is to mix the
|
||||||
preceding frame in to compensate
|
preceding frame in to compensate
|
||||||
for occasional loss of Isoc data
|
for occasional loss of Isoc data
|
||||||
on high frame rates.
|
on high frame rates.
|
||||||
FLAGS_CLEAN_FRAMES 64 Forces "cleanup" of each frame
|
FLAGS_CLEAN_FRAMES 64 Forces "cleanup" of each frame
|
||||||
prior to use; relevant only if
|
prior to use; relevant only if
|
||||||
FLAGS_SEPARATE_FRAMES is set.
|
FLAGS_SEPARATE_FRAMES is set.
|
||||||
Default is not to clean frames,
|
Default is not to clean frames,
|
||||||
this is a little faster but may
|
this is a little faster but may
|
||||||
produce flicker if frame rate is
|
produce flicker if frame rate is
|
||||||
too high and Isoc data gets lost.
|
too high and Isoc data gets lost.
|
||||||
FLAGS_NO_DECODING 128 This flag turns the video stream
|
FLAGS_NO_DECODING 128 This flag turns the video stream
|
||||||
decoder off, and dumps the raw
|
decoder off, and dumps the raw
|
||||||
Isoc data from the camera into
|
Isoc data from the camera into
|
||||||
the reading process. Useful to
|
the reading process. Useful to
|
||||||
developers, but not to users.
|
developers, but not to users.
|
||||||
|
|
||||||
framerate This setting controls frame rate of the camera. This is
|
framerate This setting controls frame rate of the camera. This is
|
||||||
an approximate setting (in terms of "worst" ... "best")
|
an approximate setting (in terms of "worst" ... "best")
|
||||||
because camera changes frame rate depending on amount
|
because camera changes frame rate depending on amount
|
||||||
of light available. Setting 0 is slowest, 6 is fastest.
|
of light available. Setting 0 is slowest, 6 is fastest.
|
||||||
Beware - fast settings are very demanding and may not
|
Beware - fast settings are very demanding and may not
|
||||||
work well with all video sizes. Be conservative.
|
work well with all video sizes. Be conservative.
|
||||||
|
|
||||||
hue_correction This highly optional setting allows to adjust the
|
hue_correction This highly optional setting allows to adjust the
|
||||||
hue of the image in a way slightly different from
|
hue of the image in a way slightly different from
|
||||||
what usual "hue" control does. Both controls affect
|
what usual "hue" control does. Both controls affect
|
||||||
YUV colorspace: regular "hue" control adjusts only
|
YUV colorspace: regular "hue" control adjusts only
|
||||||
U component, and this "hue_correction" option similarly
|
U component, and this "hue_correction" option similarly
|
||||||
adjusts only V component. However usually it is enough
|
adjusts only V component. However usually it is enough
|
||||||
to tweak only U or V to compensate for colored light or
|
to tweak only U or V to compensate for colored light or
|
||||||
color temperature; this option simply allows more
|
color temperature; this option simply allows more
|
||||||
complicated correction when and if it is necessary.
|
complicated correction when and if it is necessary.
|
||||||
|
|
||||||
init_brightness These settings specify _initial_ values which will be
|
init_brightness These settings specify _initial_ values which will be
|
||||||
init_contrast used to set up the camera. If your V4L application has
|
init_contrast used to set up the camera. If your V4L application has
|
||||||
init_color its own controls to adjust the picture then these
|
init_color its own controls to adjust the picture then these
|
||||||
init_hue controls will be used too. These options allow you to
|
init_hue controls will be used too. These options allow you to
|
||||||
preconfigure the camera when it gets connected, before
|
preconfigure the camera when it gets connected, before
|
||||||
any V4L application connects to it. Good for webcams.
|
any V4L application connects to it. Good for webcams.
|
||||||
|
|
||||||
init_model2_rg These initial settings alter color balance of the
|
init_model2_rg These initial settings alter color balance of the
|
||||||
init_model2_rg2 camera on hardware level. All four settings may be used
|
init_model2_rg2 camera on hardware level. All four settings may be used
|
||||||
|
@ -258,47 +258,47 @@ init_model2_sat to tune the camera to specific lighting conditions. These
|
||||||
init_model2_yb settings only apply to Model 2 cameras.
|
init_model2_yb settings only apply to Model 2 cameras.
|
||||||
|
|
||||||
lighting This option selects one of three hardware-defined
|
lighting This option selects one of three hardware-defined
|
||||||
photosensitivity settings of the camera. 0=bright light,
|
photosensitivity settings of the camera. 0=bright light,
|
||||||
1=Medium (default), 2=Low light. This setting affects
|
1=Medium (default), 2=Low light. This setting affects
|
||||||
frame rate: the dimmer the lighting the lower the frame
|
frame rate: the dimmer the lighting the lower the frame
|
||||||
rate (because longer exposition time is needed). The
|
rate (because longer exposition time is needed). The
|
||||||
Model 2 cameras allow values more than 2 for this option,
|
Model 2 cameras allow values more than 2 for this option,
|
||||||
thus enabling extremely high sensitivity at cost of frame
|
thus enabling extremely high sensitivity at cost of frame
|
||||||
rate, color saturation and imaging sensor noise.
|
rate, color saturation and imaging sensor noise.
|
||||||
|
|
||||||
sharpness This option controls smoothing (noise reduction)
|
sharpness This option controls smoothing (noise reduction)
|
||||||
made by camera. Setting 0 is most smooth, setting 6
|
made by camera. Setting 0 is most smooth, setting 6
|
||||||
is most sharp. Be aware that CMOS sensor used in the
|
is most sharp. Be aware that CMOS sensor used in the
|
||||||
camera is pretty noisy, so if you choose 6 you will
|
camera is pretty noisy, so if you choose 6 you will
|
||||||
be greeted with "snowy" image. Default is 4. Model 2
|
be greeted with "snowy" image. Default is 4. Model 2
|
||||||
cameras do not support this feature.
|
cameras do not support this feature.
|
||||||
|
|
||||||
size This setting chooses one of several image sizes that are
|
size This setting chooses one of several image sizes that are
|
||||||
supported by this driver. Cameras may support more, but
|
supported by this driver. Cameras may support more, but
|
||||||
it's difficult to reverse-engineer all formats.
|
it's difficult to reverse-engineer all formats.
|
||||||
Following video sizes are supported:
|
Following video sizes are supported:
|
||||||
|
|
||||||
size=0 128x96 (Model 1 only)
|
size=0 128x96 (Model 1 only)
|
||||||
size=1 160x120
|
size=1 160x120
|
||||||
size=2 176x144
|
size=2 176x144
|
||||||
size=3 320x240 (Model 2 only)
|
size=3 320x240 (Model 2 only)
|
||||||
size=4 352x240 (Model 2 only)
|
size=4 352x240 (Model 2 only)
|
||||||
size=5 352x288
|
size=5 352x288
|
||||||
size=6 640x480 (Model 3 only)
|
size=6 640x480 (Model 3 only)
|
||||||
|
|
||||||
The 352x288 is the native size of the Model 1 sensor
|
The 352x288 is the native size of the Model 1 sensor
|
||||||
array, so it's the best resolution the camera can
|
array, so it's the best resolution the camera can
|
||||||
yield. The best resolution of Model 2 is 176x144, and
|
yield. The best resolution of Model 2 is 176x144, and
|
||||||
larger images are produced by stretching the bitmap.
|
larger images are produced by stretching the bitmap.
|
||||||
Model 3 has sensor with 640x480 grid, and it works too,
|
Model 3 has sensor with 640x480 grid, and it works too,
|
||||||
but the frame rate will be exceptionally low (1-2 FPS);
|
but the frame rate will be exceptionally low (1-2 FPS);
|
||||||
it may be still OK for some applications, like security.
|
it may be still OK for some applications, like security.
|
||||||
Choose the image size you need. The smaller image can
|
Choose the image size you need. The smaller image can
|
||||||
support faster frame rate. Default is 352x288.
|
support faster frame rate. Default is 352x288.
|
||||||
|
|
||||||
For more information and the Troubleshooting FAQ visit this URL:
|
For more information and the Troubleshooting FAQ visit this URL:
|
||||||
|
|
||||||
http://www.linux-usb.org/ibmcam/
|
http://www.linux-usb.org/ibmcam/
|
||||||
|
|
||||||
WHAT NEEDS TO BE DONE:
|
WHAT NEEDS TO BE DONE:
|
||||||
|
|
||||||
|
|
|
@ -81,7 +81,7 @@ MODULE PARAMETERS:
|
||||||
TYPE: integer (Boolean)
|
TYPE: integer (Boolean)
|
||||||
DEFAULT: 1
|
DEFAULT: 1
|
||||||
DESC: Brightness is normally under automatic control and can't be set
|
DESC: Brightness is normally under automatic control and can't be set
|
||||||
manually by the video app. Set to 0 for manual control.
|
manually by the video app. Set to 0 for manual control.
|
||||||
|
|
||||||
NAME: autogain
|
NAME: autogain
|
||||||
TYPE: integer (Boolean)
|
TYPE: integer (Boolean)
|
||||||
|
@ -97,13 +97,13 @@ MODULE PARAMETERS:
|
||||||
TYPE: integer (0-6)
|
TYPE: integer (0-6)
|
||||||
DEFAULT: 3
|
DEFAULT: 3
|
||||||
DESC: Sets the threshold for printing debug messages. The higher the value,
|
DESC: Sets the threshold for printing debug messages. The higher the value,
|
||||||
the more is printed. The levels are cumulative, and are as follows:
|
the more is printed. The levels are cumulative, and are as follows:
|
||||||
0=no debug messages
|
0=no debug messages
|
||||||
1=init/detection/unload and other significant messages
|
1=init/detection/unload and other significant messages
|
||||||
2=some warning messages
|
2=some warning messages
|
||||||
3=config/control function calls
|
3=config/control function calls
|
||||||
4=most function calls and data parsing messages
|
4=most function calls and data parsing messages
|
||||||
5=highly repetitive mesgs
|
5=highly repetitive mesgs
|
||||||
|
|
||||||
NAME: snapshot
|
NAME: snapshot
|
||||||
TYPE: integer (Boolean)
|
TYPE: integer (Boolean)
|
||||||
|
@ -116,24 +116,24 @@ MODULE PARAMETERS:
|
||||||
TYPE: integer (1-4 for OV511, 1-31 for OV511+)
|
TYPE: integer (1-4 for OV511, 1-31 for OV511+)
|
||||||
DEFAULT: 1
|
DEFAULT: 1
|
||||||
DESC: Number of cameras allowed to stream simultaneously on a single bus.
|
DESC: Number of cameras allowed to stream simultaneously on a single bus.
|
||||||
Values higher than 1 reduce the data rate of each camera, allowing two
|
Values higher than 1 reduce the data rate of each camera, allowing two
|
||||||
or more to be used at once. If you have a complicated setup involving
|
or more to be used at once. If you have a complicated setup involving
|
||||||
both OV511 and OV511+ cameras, trial-and-error may be necessary for
|
both OV511 and OV511+ cameras, trial-and-error may be necessary for
|
||||||
finding the optimum setting.
|
finding the optimum setting.
|
||||||
|
|
||||||
NAME: compress
|
NAME: compress
|
||||||
TYPE: integer (Boolean)
|
TYPE: integer (Boolean)
|
||||||
DEFAULT: 0
|
DEFAULT: 0
|
||||||
DESC: Set this to 1 to turn on the camera's compression engine. This can
|
DESC: Set this to 1 to turn on the camera's compression engine. This can
|
||||||
potentially increase the frame rate at the expense of quality, if you
|
potentially increase the frame rate at the expense of quality, if you
|
||||||
have a fast CPU. You must load the proper compression module for your
|
have a fast CPU. You must load the proper compression module for your
|
||||||
camera before starting your application (ov511_decomp or ov518_decomp).
|
camera before starting your application (ov511_decomp or ov518_decomp).
|
||||||
|
|
||||||
NAME: testpat
|
NAME: testpat
|
||||||
TYPE: integer (Boolean)
|
TYPE: integer (Boolean)
|
||||||
DEFAULT: 0
|
DEFAULT: 0
|
||||||
DESC: This configures the camera's sensor to transmit a colored test-pattern
|
DESC: This configures the camera's sensor to transmit a colored test-pattern
|
||||||
instead of an image. This does not work correctly yet.
|
instead of an image. This does not work correctly yet.
|
||||||
|
|
||||||
NAME: dumppix
|
NAME: dumppix
|
||||||
TYPE: integer (0-2)
|
TYPE: integer (0-2)
|
||||||
|
|
|
@ -1,9 +1,9 @@
|
||||||
|
|
||||||
SN9C10x PC Camera Controllers
|
SN9C10x PC Camera Controllers
|
||||||
Driver for Linux
|
Driver for Linux
|
||||||
=============================
|
=============================
|
||||||
|
|
||||||
- Documentation -
|
- Documentation -
|
||||||
|
|
||||||
|
|
||||||
Index
|
Index
|
||||||
|
@ -176,46 +176,46 @@ Name: video_nr
|
||||||
Type: short array (min = 0, max = 64)
|
Type: short array (min = 0, max = 64)
|
||||||
Syntax: <-1|n[,...]>
|
Syntax: <-1|n[,...]>
|
||||||
Description: Specify V4L2 minor mode number:
|
Description: Specify V4L2 minor mode number:
|
||||||
-1 = use next available
|
-1 = use next available
|
||||||
n = use minor number n
|
n = use minor number n
|
||||||
You can specify up to 64 cameras this way.
|
You can specify up to 64 cameras this way.
|
||||||
For example:
|
For example:
|
||||||
video_nr=-1,2,-1 would assign minor number 2 to the second
|
video_nr=-1,2,-1 would assign minor number 2 to the second
|
||||||
recognized camera and use auto for the first one and for every
|
recognized camera and use auto for the first one and for every
|
||||||
other camera.
|
other camera.
|
||||||
Default: -1
|
Default: -1
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: force_munmap
|
Name: force_munmap
|
||||||
Type: bool array (min = 0, max = 64)
|
Type: bool array (min = 0, max = 64)
|
||||||
Syntax: <0|1[,...]>
|
Syntax: <0|1[,...]>
|
||||||
Description: Force the application to unmap previously mapped buffer memory
|
Description: Force the application to unmap previously mapped buffer memory
|
||||||
before calling any VIDIOC_S_CROP or VIDIOC_S_FMT ioctl's. Not
|
before calling any VIDIOC_S_CROP or VIDIOC_S_FMT ioctl's. Not
|
||||||
all the applications support this feature. This parameter is
|
all the applications support this feature. This parameter is
|
||||||
specific for each detected camera.
|
specific for each detected camera.
|
||||||
0 = do not force memory unmapping
|
0 = do not force memory unmapping
|
||||||
1 = force memory unmapping (save memory)
|
1 = force memory unmapping (save memory)
|
||||||
Default: 0
|
Default: 0
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: frame_timeout
|
Name: frame_timeout
|
||||||
Type: uint array (min = 0, max = 64)
|
Type: uint array (min = 0, max = 64)
|
||||||
Syntax: <n[,...]>
|
Syntax: <n[,...]>
|
||||||
Description: Timeout for a video frame in seconds. This parameter is
|
Description: Timeout for a video frame in seconds. This parameter is
|
||||||
specific for each detected camera. This parameter can be
|
specific for each detected camera. This parameter can be
|
||||||
changed at runtime thanks to the /sys filesystem interface.
|
changed at runtime thanks to the /sys filesystem interface.
|
||||||
Default: 2
|
Default: 2
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: debug
|
Name: debug
|
||||||
Type: ushort
|
Type: ushort
|
||||||
Syntax: <n>
|
Syntax: <n>
|
||||||
Description: Debugging information level, from 0 to 3:
|
Description: Debugging information level, from 0 to 3:
|
||||||
0 = none (use carefully)
|
0 = none (use carefully)
|
||||||
1 = critical errors
|
1 = critical errors
|
||||||
2 = significant informations
|
2 = significant informations
|
||||||
3 = more verbose messages
|
3 = more verbose messages
|
||||||
Level 3 is useful for testing only, when only one device
|
Level 3 is useful for testing only, when only one device
|
||||||
is used. It also shows some more informations about the
|
is used. It also shows some more informations about the
|
||||||
hardware being detected. This parameter can be changed at
|
hardware being detected. This parameter can be changed at
|
||||||
runtime thanks to the /sys filesystem interface.
|
runtime thanks to the /sys filesystem interface.
|
||||||
Default: 2
|
Default: 2
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
@ -280,24 +280,24 @@ Byte # Value Description
|
||||||
0x04 0xC4 Frame synchronisation pattern.
|
0x04 0xC4 Frame synchronisation pattern.
|
||||||
0x05 0x96 Frame synchronisation pattern.
|
0x05 0x96 Frame synchronisation pattern.
|
||||||
0x06 0xXX Unknown meaning. The exact value depends on the chip;
|
0x06 0xXX Unknown meaning. The exact value depends on the chip;
|
||||||
possible values are 0x00, 0x01 and 0x20.
|
possible values are 0x00, 0x01 and 0x20.
|
||||||
0x07 0xXX Variable value, whose bits are ff00uzzc, where ff is a
|
0x07 0xXX Variable value, whose bits are ff00uzzc, where ff is a
|
||||||
frame counter, u is unknown, zz is a size indicator
|
frame counter, u is unknown, zz is a size indicator
|
||||||
(00 = VGA, 01 = SIF, 10 = QSIF) and c stands for
|
(00 = VGA, 01 = SIF, 10 = QSIF) and c stands for
|
||||||
"compression enabled" (1 = yes, 0 = no).
|
"compression enabled" (1 = yes, 0 = no).
|
||||||
0x08 0xXX Brightness sum inside Auto-Exposure area (low-byte).
|
0x08 0xXX Brightness sum inside Auto-Exposure area (low-byte).
|
||||||
0x09 0xXX Brightness sum inside Auto-Exposure area (high-byte).
|
0x09 0xXX Brightness sum inside Auto-Exposure area (high-byte).
|
||||||
For a pure white image, this number will be equal to 500
|
For a pure white image, this number will be equal to 500
|
||||||
times the area of the specified AE area. For images
|
times the area of the specified AE area. For images
|
||||||
that are not pure white, the value scales down according
|
that are not pure white, the value scales down according
|
||||||
to relative whiteness.
|
to relative whiteness.
|
||||||
0x0A 0xXX Brightness sum outside Auto-Exposure area (low-byte).
|
0x0A 0xXX Brightness sum outside Auto-Exposure area (low-byte).
|
||||||
0x0B 0xXX Brightness sum outside Auto-Exposure area (high-byte).
|
0x0B 0xXX Brightness sum outside Auto-Exposure area (high-byte).
|
||||||
For a pure white image, this number will be equal to 125
|
For a pure white image, this number will be equal to 125
|
||||||
times the area outside of the specified AE area. For
|
times the area outside of the specified AE area. For
|
||||||
images that are not pure white, the value scales down
|
images that are not pure white, the value scales down
|
||||||
according to relative whiteness.
|
according to relative whiteness.
|
||||||
according to relative whiteness.
|
according to relative whiteness.
|
||||||
|
|
||||||
The following bytes are used by the SN9C103 bridge only:
|
The following bytes are used by the SN9C103 bridge only:
|
||||||
|
|
||||||
|
|
|
@ -1,9 +1,9 @@
|
||||||
|
|
||||||
W996[87]CF JPEG USB Dual Mode Camera Chip
|
W996[87]CF JPEG USB Dual Mode Camera Chip
|
||||||
Driver for Linux 2.6 (basic version)
|
Driver for Linux 2.6 (basic version)
|
||||||
=========================================
|
=========================================
|
||||||
|
|
||||||
- Documentation -
|
- Documentation -
|
||||||
|
|
||||||
|
|
||||||
Index
|
Index
|
||||||
|
@ -188,57 +188,57 @@ Name: ovmod_load
|
||||||
Type: bool
|
Type: bool
|
||||||
Syntax: <0|1>
|
Syntax: <0|1>
|
||||||
Description: Automatic 'ovcamchip' module loading: 0 disabled, 1 enabled.
|
Description: Automatic 'ovcamchip' module loading: 0 disabled, 1 enabled.
|
||||||
If enabled, 'insmod' searches for the required 'ovcamchip'
|
If enabled, 'insmod' searches for the required 'ovcamchip'
|
||||||
module in the system, according to its configuration, and
|
module in the system, according to its configuration, and
|
||||||
loads that module automatically. This action is performed as
|
loads that module automatically. This action is performed as
|
||||||
once soon as the 'w9968cf' module is loaded into memory.
|
once soon as the 'w9968cf' module is loaded into memory.
|
||||||
Default: 1
|
Default: 1
|
||||||
Note: The kernel must be compiled with the CONFIG_KMOD option
|
Note: The kernel must be compiled with the CONFIG_KMOD option
|
||||||
enabled for the 'ovcamchip' module to be loaded and for
|
enabled for the 'ovcamchip' module to be loaded and for
|
||||||
this parameter to be present.
|
this parameter to be present.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: simcams
|
Name: simcams
|
||||||
Type: int
|
Type: int
|
||||||
Syntax: <n>
|
Syntax: <n>
|
||||||
Description: Number of cameras allowed to stream simultaneously.
|
Description: Number of cameras allowed to stream simultaneously.
|
||||||
n may vary from 0 to 32.
|
n may vary from 0 to 32.
|
||||||
Default: 32
|
Default: 32
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: video_nr
|
Name: video_nr
|
||||||
Type: int array (min = 0, max = 32)
|
Type: int array (min = 0, max = 32)
|
||||||
Syntax: <-1|n[,...]>
|
Syntax: <-1|n[,...]>
|
||||||
Description: Specify V4L minor mode number.
|
Description: Specify V4L minor mode number.
|
||||||
-1 = use next available
|
-1 = use next available
|
||||||
n = use minor number n
|
n = use minor number n
|
||||||
You can specify up to 32 cameras this way.
|
You can specify up to 32 cameras this way.
|
||||||
For example:
|
For example:
|
||||||
video_nr=-1,2,-1 would assign minor number 2 to the second
|
video_nr=-1,2,-1 would assign minor number 2 to the second
|
||||||
recognized camera and use auto for the first one and for every
|
recognized camera and use auto for the first one and for every
|
||||||
other camera.
|
other camera.
|
||||||
Default: -1
|
Default: -1
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: packet_size
|
Name: packet_size
|
||||||
Type: int array (min = 0, max = 32)
|
Type: int array (min = 0, max = 32)
|
||||||
Syntax: <n[,...]>
|
Syntax: <n[,...]>
|
||||||
Description: Specify the maximum data payload size in bytes for alternate
|
Description: Specify the maximum data payload size in bytes for alternate
|
||||||
settings, for each device. n is scaled between 63 and 1023.
|
settings, for each device. n is scaled between 63 and 1023.
|
||||||
Default: 1023
|
Default: 1023
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: max_buffers
|
Name: max_buffers
|
||||||
Type: int array (min = 0, max = 32)
|
Type: int array (min = 0, max = 32)
|
||||||
Syntax: <n[,...]>
|
Syntax: <n[,...]>
|
||||||
Description: For advanced users.
|
Description: For advanced users.
|
||||||
Specify the maximum number of video frame buffers to allocate
|
Specify the maximum number of video frame buffers to allocate
|
||||||
for each device, from 2 to 32.
|
for each device, from 2 to 32.
|
||||||
Default: 2
|
Default: 2
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: double_buffer
|
Name: double_buffer
|
||||||
Type: bool array (min = 0, max = 32)
|
Type: bool array (min = 0, max = 32)
|
||||||
Syntax: <0|1[,...]>
|
Syntax: <0|1[,...]>
|
||||||
Description: Hardware double buffering: 0 disabled, 1 enabled.
|
Description: Hardware double buffering: 0 disabled, 1 enabled.
|
||||||
It should be enabled if you want smooth video output: if you
|
It should be enabled if you want smooth video output: if you
|
||||||
obtain out of sync. video, disable it, or try to
|
obtain out of sync. video, disable it, or try to
|
||||||
decrease the 'clockdiv' module parameter value.
|
decrease the 'clockdiv' module parameter value.
|
||||||
Default: 1 for every device.
|
Default: 1 for every device.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: clamping
|
Name: clamping
|
||||||
|
@ -251,9 +251,9 @@ Name: filter_type
|
||||||
Type: int array (min = 0, max = 32)
|
Type: int array (min = 0, max = 32)
|
||||||
Syntax: <0|1|2[,...]>
|
Syntax: <0|1|2[,...]>
|
||||||
Description: Video filter type.
|
Description: Video filter type.
|
||||||
0 none, 1 (1-2-1) 3-tap filter, 2 (2-3-6-3-2) 5-tap filter.
|
0 none, 1 (1-2-1) 3-tap filter, 2 (2-3-6-3-2) 5-tap filter.
|
||||||
The filter is used to reduce noise and aliasing artifacts
|
The filter is used to reduce noise and aliasing artifacts
|
||||||
produced by the CCD or CMOS image sensor.
|
produced by the CCD or CMOS image sensor.
|
||||||
Default: 0 for every device.
|
Default: 0 for every device.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: largeview
|
Name: largeview
|
||||||
|
@ -266,9 +266,9 @@ Name: upscaling
|
||||||
Type: bool array (min = 0, max = 32)
|
Type: bool array (min = 0, max = 32)
|
||||||
Syntax: <0|1[,...]>
|
Syntax: <0|1[,...]>
|
||||||
Description: Software scaling (for non-compressed video only):
|
Description: Software scaling (for non-compressed video only):
|
||||||
0 disabled, 1 enabled.
|
0 disabled, 1 enabled.
|
||||||
Disable it if you have a slow CPU or you don't have enough
|
Disable it if you have a slow CPU or you don't have enough
|
||||||
memory.
|
memory.
|
||||||
Default: 0 for every device.
|
Default: 0 for every device.
|
||||||
Note: If 'w9968cf-vpp' is not present, this parameter is set to 0.
|
Note: If 'w9968cf-vpp' is not present, this parameter is set to 0.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
|
@ -276,36 +276,36 @@ Name: decompression
|
||||||
Type: int array (min = 0, max = 32)
|
Type: int array (min = 0, max = 32)
|
||||||
Syntax: <0|1|2[,...]>
|
Syntax: <0|1|2[,...]>
|
||||||
Description: Software video decompression:
|
Description: Software video decompression:
|
||||||
0 = disables decompression
|
0 = disables decompression
|
||||||
(doesn't allow formats needing decompression).
|
(doesn't allow formats needing decompression).
|
||||||
1 = forces decompression
|
1 = forces decompression
|
||||||
(allows formats needing decompression only).
|
(allows formats needing decompression only).
|
||||||
2 = allows any permitted formats.
|
2 = allows any permitted formats.
|
||||||
Formats supporting (de)compressed video are YUV422P and
|
Formats supporting (de)compressed video are YUV422P and
|
||||||
YUV420P/YUV420 in any resolutions where width and height are
|
YUV420P/YUV420 in any resolutions where width and height are
|
||||||
multiples of 16.
|
multiples of 16.
|
||||||
Default: 2 for every device.
|
Default: 2 for every device.
|
||||||
Note: If 'w9968cf-vpp' is not present, forcing decompression is not
|
Note: If 'w9968cf-vpp' is not present, forcing decompression is not
|
||||||
allowed; in this case this parameter is set to 2.
|
allowed; in this case this parameter is set to 2.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: force_palette
|
Name: force_palette
|
||||||
Type: int array (min = 0, max = 32)
|
Type: int array (min = 0, max = 32)
|
||||||
Syntax: <0|9|10|13|15|8|7|1|6|3|4|5[,...]>
|
Syntax: <0|9|10|13|15|8|7|1|6|3|4|5[,...]>
|
||||||
Description: Force picture palette.
|
Description: Force picture palette.
|
||||||
In order:
|
In order:
|
||||||
0 = Off - allows any of the following formats:
|
0 = Off - allows any of the following formats:
|
||||||
9 = UYVY 16 bpp - Original video, compression disabled
|
9 = UYVY 16 bpp - Original video, compression disabled
|
||||||
10 = YUV420 12 bpp - Original video, compression enabled
|
10 = YUV420 12 bpp - Original video, compression enabled
|
||||||
13 = YUV422P 16 bpp - Original video, compression enabled
|
13 = YUV422P 16 bpp - Original video, compression enabled
|
||||||
15 = YUV420P 12 bpp - Original video, compression enabled
|
15 = YUV420P 12 bpp - Original video, compression enabled
|
||||||
8 = YUVY 16 bpp - Software conversion from UYVY
|
8 = YUVY 16 bpp - Software conversion from UYVY
|
||||||
7 = YUV422 16 bpp - Software conversion from UYVY
|
7 = YUV422 16 bpp - Software conversion from UYVY
|
||||||
1 = GREY 8 bpp - Software conversion from UYVY
|
1 = GREY 8 bpp - Software conversion from UYVY
|
||||||
6 = RGB555 16 bpp - Software conversion from UYVY
|
6 = RGB555 16 bpp - Software conversion from UYVY
|
||||||
3 = RGB565 16 bpp - Software conversion from UYVY
|
3 = RGB565 16 bpp - Software conversion from UYVY
|
||||||
4 = RGB24 24 bpp - Software conversion from UYVY
|
4 = RGB24 24 bpp - Software conversion from UYVY
|
||||||
5 = RGB32 32 bpp - Software conversion from UYVY
|
5 = RGB32 32 bpp - Software conversion from UYVY
|
||||||
When not 0, this parameter will override 'decompression'.
|
When not 0, this parameter will override 'decompression'.
|
||||||
Default: 0 for every device. Initial palette is 9 (UYVY).
|
Default: 0 for every device. Initial palette is 9 (UYVY).
|
||||||
Note: If 'w9968cf-vpp' is not present, this parameter is set to 9.
|
Note: If 'w9968cf-vpp' is not present, this parameter is set to 9.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
|
@ -313,77 +313,77 @@ Name: force_rgb
|
||||||
Type: bool array (min = 0, max = 32)
|
Type: bool array (min = 0, max = 32)
|
||||||
Syntax: <0|1[,...]>
|
Syntax: <0|1[,...]>
|
||||||
Description: Read RGB video data instead of BGR:
|
Description: Read RGB video data instead of BGR:
|
||||||
1 = use RGB component ordering.
|
1 = use RGB component ordering.
|
||||||
0 = use BGR component ordering.
|
0 = use BGR component ordering.
|
||||||
This parameter has effect when using RGBX palettes only.
|
This parameter has effect when using RGBX palettes only.
|
||||||
Default: 0 for every device.
|
Default: 0 for every device.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: autobright
|
Name: autobright
|
||||||
Type: bool array (min = 0, max = 32)
|
Type: bool array (min = 0, max = 32)
|
||||||
Syntax: <0|1[,...]>
|
Syntax: <0|1[,...]>
|
||||||
Description: Image sensor automatically changes brightness:
|
Description: Image sensor automatically changes brightness:
|
||||||
0 = no, 1 = yes
|
0 = no, 1 = yes
|
||||||
Default: 0 for every device.
|
Default: 0 for every device.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: autoexp
|
Name: autoexp
|
||||||
Type: bool array (min = 0, max = 32)
|
Type: bool array (min = 0, max = 32)
|
||||||
Syntax: <0|1[,...]>
|
Syntax: <0|1[,...]>
|
||||||
Description: Image sensor automatically changes exposure:
|
Description: Image sensor automatically changes exposure:
|
||||||
0 = no, 1 = yes
|
0 = no, 1 = yes
|
||||||
Default: 1 for every device.
|
Default: 1 for every device.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: lightfreq
|
Name: lightfreq
|
||||||
Type: int array (min = 0, max = 32)
|
Type: int array (min = 0, max = 32)
|
||||||
Syntax: <50|60[,...]>
|
Syntax: <50|60[,...]>
|
||||||
Description: Light frequency in Hz:
|
Description: Light frequency in Hz:
|
||||||
50 for European and Asian lighting, 60 for American lighting.
|
50 for European and Asian lighting, 60 for American lighting.
|
||||||
Default: 50 for every device.
|
Default: 50 for every device.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: bandingfilter
|
Name: bandingfilter
|
||||||
Type: bool array (min = 0, max = 32)
|
Type: bool array (min = 0, max = 32)
|
||||||
Syntax: <0|1[,...]>
|
Syntax: <0|1[,...]>
|
||||||
Description: Banding filter to reduce effects of fluorescent
|
Description: Banding filter to reduce effects of fluorescent
|
||||||
lighting:
|
lighting:
|
||||||
0 disabled, 1 enabled.
|
0 disabled, 1 enabled.
|
||||||
This filter tries to reduce the pattern of horizontal
|
This filter tries to reduce the pattern of horizontal
|
||||||
light/dark bands caused by some (usually fluorescent) lighting.
|
light/dark bands caused by some (usually fluorescent) lighting.
|
||||||
Default: 0 for every device.
|
Default: 0 for every device.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: clockdiv
|
Name: clockdiv
|
||||||
Type: int array (min = 0, max = 32)
|
Type: int array (min = 0, max = 32)
|
||||||
Syntax: <-1|n[,...]>
|
Syntax: <-1|n[,...]>
|
||||||
Description: Force pixel clock divisor to a specific value (for experts):
|
Description: Force pixel clock divisor to a specific value (for experts):
|
||||||
n may vary from 0 to 127.
|
n may vary from 0 to 127.
|
||||||
-1 for automatic value.
|
-1 for automatic value.
|
||||||
See also the 'double_buffer' module parameter.
|
See also the 'double_buffer' module parameter.
|
||||||
Default: -1 for every device.
|
Default: -1 for every device.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: backlight
|
Name: backlight
|
||||||
Type: bool array (min = 0, max = 32)
|
Type: bool array (min = 0, max = 32)
|
||||||
Syntax: <0|1[,...]>
|
Syntax: <0|1[,...]>
|
||||||
Description: Objects are lit from behind:
|
Description: Objects are lit from behind:
|
||||||
0 = no, 1 = yes
|
0 = no, 1 = yes
|
||||||
Default: 0 for every device.
|
Default: 0 for every device.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: mirror
|
Name: mirror
|
||||||
Type: bool array (min = 0, max = 32)
|
Type: bool array (min = 0, max = 32)
|
||||||
Syntax: <0|1[,...]>
|
Syntax: <0|1[,...]>
|
||||||
Description: Reverse image horizontally:
|
Description: Reverse image horizontally:
|
||||||
0 = no, 1 = yes
|
0 = no, 1 = yes
|
||||||
Default: 0 for every device.
|
Default: 0 for every device.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: monochrome
|
Name: monochrome
|
||||||
Type: bool array (min = 0, max = 32)
|
Type: bool array (min = 0, max = 32)
|
||||||
Syntax: <0|1[,...]>
|
Syntax: <0|1[,...]>
|
||||||
Description: The image sensor is monochrome:
|
Description: The image sensor is monochrome:
|
||||||
0 = no, 1 = yes
|
0 = no, 1 = yes
|
||||||
Default: 0 for every device.
|
Default: 0 for every device.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: brightness
|
Name: brightness
|
||||||
Type: long array (min = 0, max = 32)
|
Type: long array (min = 0, max = 32)
|
||||||
Syntax: <n[,...]>
|
Syntax: <n[,...]>
|
||||||
Description: Set picture brightness (0-65535).
|
Description: Set picture brightness (0-65535).
|
||||||
This parameter has no effect if 'autobright' is enabled.
|
This parameter has no effect if 'autobright' is enabled.
|
||||||
Default: 31000 for every device.
|
Default: 31000 for every device.
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: hue
|
Name: hue
|
||||||
|
@ -414,23 +414,23 @@ Name: debug
|
||||||
Type: int
|
Type: int
|
||||||
Syntax: <n>
|
Syntax: <n>
|
||||||
Description: Debugging information level, from 0 to 6:
|
Description: Debugging information level, from 0 to 6:
|
||||||
0 = none (use carefully)
|
0 = none (use carefully)
|
||||||
1 = critical errors
|
1 = critical errors
|
||||||
2 = significant informations
|
2 = significant informations
|
||||||
3 = configuration or general messages
|
3 = configuration or general messages
|
||||||
4 = warnings
|
4 = warnings
|
||||||
5 = called functions
|
5 = called functions
|
||||||
6 = function internals
|
6 = function internals
|
||||||
Level 5 and 6 are useful for testing only, when only one
|
Level 5 and 6 are useful for testing only, when only one
|
||||||
device is used.
|
device is used.
|
||||||
Default: 2
|
Default: 2
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
Name: specific_debug
|
Name: specific_debug
|
||||||
Type: bool
|
Type: bool
|
||||||
Syntax: <0|1>
|
Syntax: <0|1>
|
||||||
Description: Enable or disable specific debugging messages:
|
Description: Enable or disable specific debugging messages:
|
||||||
0 = print messages concerning every level <= 'debug' level.
|
0 = print messages concerning every level <= 'debug' level.
|
||||||
1 = print messages concerning the level indicated by 'debug'.
|
1 = print messages concerning the level indicated by 'debug'.
|
||||||
Default: 0
|
Default: 0
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
|
Загрузка…
Ссылка в новой задаче