This message will disappear after all relevant tasks have been resolved.
Semantic MediaWiki
There are 1 incomplete or pending task to finish installation of Semantic MediaWiki. An administrator or user with sufficient rights can complete it. This should be done before adding new data to avoid inconsistencies.The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
1 Overview[edit source]
v4l2-ctl is a V4L2 utility allowing to control the camera subsystem [1]. It is based on V4L2 Linux kernel interface[2].
2 Usage[edit source]
v4l2-ctl --help
General/Common options:
--all display all information available
-C, --get-ctrl=<ctrl>[,<ctrl>...]
get the value of the controls [VIDIOC_G_EXT_CTRLS]
-c, --set-ctrl=<ctrl>=<val>[,<ctrl>=<val>...]
set the value of the controls [VIDIOC_S_EXT_CTRLS]
-D, --info show driver info [VIDIOC_QUERYCAP]
-d, --device=<dev> use device <dev> instead of /dev/video0
if <dev> starts with a digit, then /dev/video<dev> is used
-e, --out-device=<dev> use device <dev> for output streams instead of the
default device as set with --device
if <dev> starts with a digit, then /dev/video<dev> is used
-h, --help display this help message
--help-all all options
--help-io input/output options
--help-misc miscellaneous options
--help-overlay overlay format options
--help-sdr SDR format options
--help-selection crop/selection options
--help-stds standards and other video timings options
--help-streaming streaming options
--help-tuner tuner/modulator options
--help-vbi VBI format options
--help-vidcap video capture format options
--help-vidout vidout output format options
--help-edid edid handling options
-k, --concise be more concise if possible.
-l, --list-ctrls display all controls and their values [VIDIOC_QUERYCTRL]
-L, --list-ctrls-menus
display all controls and their menus [VIDIOC_QUERYMENU]
-r, --subset=<ctrl>[,<offset>,<size>]+
the subset of the N-dimensional array to get/set for control <ctrl>,
for every dimension an (<offset>, <size>) tuple is given.
-w, --wrapper use the libv4l2 wrapper library.
--list-devices list all v4l devices
--log-status log the board status in the kernel log [VIDIOC_LOG_STATUS]
--get-priority query the current access priority [VIDIOC_G_PRIORITY]
--set-priority=<prio>
set the new access priority [VIDIOC_S_PRIORITY]
<prio> is 1 (background), 2 (interactive) or 3 (record)
--silent only set the result code, do not print any messages
--sleep=<secs> sleep <secs>, call QUERYCAP and close the file handle
--verbose turn on verbose ioctl status reporting
A longer help is also available:
v4l2-ctl --help-all
General/Common options:
--all display all information available
-C, --get-ctrl=<ctrl>[,<ctrl>...]
get the value of the controls [VIDIOC_G_EXT_CTRLS]
-c, --set-ctrl=<ctrl>=<val>[,<ctrl>=<val>...]
set the value of the controls [VIDIOC_S_EXT_CTRLS]
-D, --info show driver info [VIDIOC_QUERYCAP]
-d, --device=<dev> use device <dev> instead of /dev/video0
if <dev> starts with a digit, then /dev/video<dev> is used
-e, --out-device=<dev> use device <dev> for output streams instead of the
default device as set with --device
if <dev> starts with a digit, then /dev/video<dev> is used
-h, --help display this help message
--help-all all options
--help-io input/output options
--help-misc miscellaneous options
--help-overlay overlay format options
--help-sdr SDR format options
--help-selection crop/selection options
--help-stds standards and other video timings options
--help-streaming streaming options
--help-tuner tuner/modulator options
--help-vbi VBI format options
--help-vidcap video capture format options
--help-vidout vidout output format options
--help-edid edid handling options
-k, --concise be more concise if possible.
-l, --list-ctrls display all controls and their values [VIDIOC_QUERYCTRL]
-L, --list-ctrls-menus
display all controls and their menus [VIDIOC_QUERYMENU]
-r, --subset=<ctrl>[,<offset>,<size>]+
the subset of the N-dimensional array to get/set for control <ctrl>,
for every dimension an (<offset>, <size>) tuple is given.
-w, --wrapper use the libv4l2 wrapper library.
--list-devices list all v4l devices
--log-status log the board status in the kernel log [VIDIOC_LOG_STATUS]
--get-priority query the current access priority [VIDIOC_G_PRIORITY]
--set-priority=<prio>
set the new access priority [VIDIOC_S_PRIORITY]
<prio> is 1 (background), 2 (interactive) or 3 (record)
--silent only set the result code, do not print any messages
--sleep=<secs> sleep <secs>, call QUERYCAP and close the file handle
--verbose turn on verbose ioctl status reporting
Tuner/Modulator options:
-F, --get-freq query the frequency [VIDIOC_G_FREQUENCY]
-f, --set-freq=<freq>
set the frequency to <freq> MHz [VIDIOC_S_FREQUENCY]
-T, --get-tuner query the tuner settings [VIDIOC_G_TUNER]
-t, --set-tuner=<mode>
set the audio mode of the tuner [VIDIOC_S_TUNER]
Possible values: mono, stereo, lang2, lang1, bilingual
--tuner-index=<idx> Use idx as tuner idx for tuner/modulator commands
--list-freq-bands display all frequency bands for the tuner/modulator
[VIDIOC_ENUM_FREQ_BANDS]
--get-modulator query the modulator settings [VIDIOC_G_MODULATOR]
--set-modulator=<txsubchans>
set the sub-carrier modulation [VIDIOC_S_MODULATOR]
<txsubchans> is one of:
mono: Modulate as mono
mono-rds: Modulate as mono with RDS (radio only)
stereo: Modulate as stereo
stereo-rds: Modulate as stereo with RDS (radio only)
bilingual: Modulate as bilingual
mono-sap: Modulate as mono with Second Audio Program
stereo-sap: Modulate as stereo with Second Audio Program
--freq-seek=dir=<0/1>,wrap=<0/1>,spacing=<hz>,low=<freq>,high=<freq>
perform a hardware frequency seek [VIDIOC_S_HW_FREQ_SEEK]
dir is 0 (seek downward) or 1 (seek upward)
wrap is 0 (do not wrap around) or 1 (wrap around)
spacing sets the seek resolution (use 0 for default)
low and high set the low and high seek frequency range in MHz
Input/Output options:
-I, --get-input query the video input [VIDIOC_G_INPUT]
-i, --set-input=<num>
set the video input to <num> [VIDIOC_S_INPUT]
-N, --list-outputs display video outputs [VIDIOC_ENUMOUTPUT]
-n, --list-inputs display video inputs [VIDIOC_ENUMINPUT]
-O, --get-output query the video output [VIDIOC_G_OUTPUT]
-o, --set-output=<num>
set the video output to <num> [VIDIOC_S_OUTPUT]
--set-audio-output=<num>
set the audio output to <num> [VIDIOC_S_AUDOUT]
--get-audio-input query the audio input [VIDIOC_G_AUDIO]
--set-audio-input=<num>
set the audio input to <num> [VIDIOC_S_AUDIO]
--get-audio-output query the audio output [VIDIOC_G_AUDOUT]
--set-audio-output=<num>
set the audio output to <num> [VIDIOC_S_AUDOUT]
--list-audio-outputs
display audio outputs [VIDIOC_ENUMAUDOUT]
--list-audio-inputs
display audio inputs [VIDIOC_ENUMAUDIO]
Standards/Timings options:
--list-standards display supported video standards [VIDIOC_ENUMSTD]
-S, --get-standard
query the video standard [VIDIOC_G_STD]
-s, --set-standard=<num>
set the video standard to <num> [VIDIOC_S_STD]
<num> a numerical v4l2_std value, or one of:
pal or pal-X (X = B/G/H/N/Nc/I/D/K/M/60) (V4L2_STD_PAL)
ntsc or ntsc-X (X = M/J/K) (V4L2_STD_NTSC)
secam or secam-X (X = B/G/H/D/K/L/Lc) (V4L2_STD_SECAM)
--get-detected-standard
display detected input video standard [VIDIOC_QUERYSTD]
--list-dv-timings list supp. standard dv timings [VIDIOC_ENUM_DV_TIMINGS]
--set-dv-bt-timings
query: use the output of VIDIOC_QUERY_DV_TIMINGS
index=<index>: use the index as provided by --list-dv-timings
or specify timings using cvt/gtf options as follows:
cvt/gtf,width=<width>,height=<height>,fps=<frames per sec>
interlaced=<0/1>,reduced-blanking=<0/1/2>,reduced-fps=<0/1>
The value of reduced-blanking, if greater than 0, indicates
that reduced blanking is to be used and the value indicate the
version. For gtf, there is no version 2 for reduced blanking, and
the value 1 or 2 will give same results.
reduced-fps = 1, slows down pixel clock by factor of 1000 / 1001, allowing
to support NTSC frame rates like 29.97 or 59.94.
Reduced fps flag takes effect only with reduced blanking version 2 and,
when refresh rate is an integer multiple of 6, say, fps = 24,30,60 etc.
or update all or part of the current timings fields:
width=<width>,height=<height>,interlaced=<0/1>,
polarities=<polarities mask>,pixelclock=<pixelclock Hz>,
hfp=<horizontal front porch>,hs=<horizontal sync>,
hbp=<horizontal back porch>,vfp=<vertical front porch>,
vs=<vertical sync>,vbp=<vertical back porch>,
il_vfp=<vertical front porch for bottom field>,
il_vs=<vertical sync for bottom field>,
il_vbp=<vertical back porch for bottom field>.
clear: start with zeroed timings instead of the current timings.
set the digital video timings according to the BT 656/1120
standard [VIDIOC_S_DV_TIMINGS]
--get-dv-timings get the digital video timings in use [VIDIOC_G_DV_TIMINGS]
--query-dv-timings query the detected dv timings [VIDIOC_QUERY_DV_TIMINGS]
--get-dv-timings-cap
get the dv timings capabilities [VIDIOC_DV_TIMINGS_CAP]
Video Capture Formats options:
--list-formats display supported video formats [VIDIOC_ENUM_FMT]
--list-formats-ext display supported video formats including frame sizes
and intervals
--list-framesizes=<f>
list supported framesizes for pixelformat <f>
[VIDIOC_ENUM_FRAMESIZES]
pixelformat is the fourcc value as a string
--list-frameintervals=width=<w>,height=<h>,pixelformat=<f>
list supported frame intervals for pixelformat <f> and
the given width and height [VIDIOC_ENUM_FRAMEINTERVALS]
pixelformat is the fourcc value as a string
--list-fields list supported fields for the current format
-V, --get-fmt-video
query the video capture format [VIDIOC_G_FMT]
-v, --set-fmt-video
--try-fmt-video=width=<w>,height=<h>,pixelformat=<pf>,field=<f>,colorspace=<c>,
xfer=<xf>,ycbcr=<y>,quantization=<q>,premul-alpha,bytesperline=<bpl>
set/try the video capture format [VIDIOC_S/TRY_FMT]
pixelformat is either the format index as reported by
--list-formats, or the fourcc value as a string.
The bytesperline option can be used multiple times, once for each plane.
premul-alpha sets V4L2_PIX_FMT_FLAG_PREMUL_ALPHA.
<f> can be one of the following field layouts:
any, none, top, bottom, interlaced, seq_tb, seq_bt,
alternate, interlaced_tb, interlaced_bt
<c> can be one of the following colorspaces:
smpte170m, smpte240m, rec709, 470m, 470bg, jpeg, srgb,
adobergb, bt2020, dcip3
<xf> can be one of the following transfer functions:
default, 709, srgb, adobergb, smpte240m, smpte2084, dcip3, none
<y> can be one of the following Y'CbCr encodings:
default, 601, 709, xv601, xv709, bt2020, bt2020c, smpte240m
<q> can be one of the following quantization methods:
default, full-range, lim-range
Video Output Formats options:
--list-formats-out display supported video output formats [VIDIOC_ENUM_FMT]
--list-fields-out list supported fields for the current output format
--get-fmt-video-out
query the video output format [VIDIOC_G_FMT]
--set-fmt-video-out
--try-fmt-video-out=width=<w>,height=<h>,pixelformat=<pf>,field=<f>,colorspace=<c>,
xfer=<xf>,ycbcr=<y>,quantization=<q>,premul-alpha,bytesperline=<bpl>
set/try the video output format [VIDIOC_S/TRY_FMT]
pixelformat is either the format index as reported by
--list-formats-out, or the fourcc value as a string.
premul-alpha sets V4L2_PIX_FMT_FLAG_PREMUL_ALPHA.
The bytesperline option can be used multiple times, once for each plane.
<f> can be one of the following field layouts:
any, none, top, bottom, interlaced, seq_tb, seq_bt,
alternate, interlaced_tb, interlaced_bt
<c> can be one of the following colorspaces:
smpte170m, smpte240m, rec709, 470m, 470bg, jpeg, srgb,
adobergb, bt2020, dcip3
<xf> can be one of the following transfer functions:
default, 709, srgb, adobergb, smpte240m, smpte2084, dcip3, none
<y> can be one of the following Y'CbCr encodings:
default, 601, 709, xv601, xv709, bt2020, bt2020c, smpte240m
<q> can be one of the following quantization methods:
default, full-range, lim-range
Video Overlay options:
--list-formats-overlay
display supported overlay formats [VIDIOC_ENUM_FMT]
--find-fb find the fb device corresponding with the overlay
--overlay=<on> turn overlay on (1) or off (0) (VIDIOC_OVERLAY)
--get-fmt-overlay query the video or video output overlay format [VIDIOC_G_FMT]
--set-fmt-overlay
--try-fmt-overlay=chromakey=<key>,global_alpha=<alpha>,
top=<t>,left=<l>,width=<w>,height=<h>,field=<f>
set/try the video or video output overlay format [VIDIOC_TRY/S_FMT]
<f> can be one of:
any, none, top, bottom, interlaced, seq_tb, seq_bt,
alternate, interlaced_tb, interlaced_bt
If the width or height changed then the old clip list and bitmap will
be invalidated.
--clear-clips clear any old clips, to be used in combination with --try/set-fmt-overlay
--clear-bitmap clear any old bitmap, to be used in combination with --try/set-fmt-overlay
--add-clip=top=<t>,left=<l>,width=<w>,height=<h>
Add an entry to the clip list. May be used multiple times.
This clip list will be passed to --try/set-fmt-overlay
--add-bitmap=top=<t>,left=<l>,width=<w>,height=<h>
Set the bits in the given rectangle in the bitmap to 1. May be
used multiple times.
The bitmap will be passed to --try/set-fmt-overlay
--get-fbuf query the overlay framebuffer data [VIDIOC_G_FBUF]
--set-fbuf=chromakey=<b>,src_chromakey=<b>,global_alpha=<b>,local_alpha=<b>,local_inv_alpha=<b>,fb=<fb>
set the overlay framebuffer [VIDIOC_S_FBUF]
<b> is 0 or 1
<fb> is the framebuffer device (/dev/fbX)
if <fb> starts with a digit, then /dev/fb<fb> is used
VBI Formats options:
--get-sliced-vbi-cap
query the sliced VBI capture capabilities
[VIDIOC_G_SLICED_VBI_CAP]
--get-sliced-vbi-out-cap
query the sliced VBI output capabilities
[VIDIOC_G_SLICED_VBI_CAP]
-B, --get-fmt-sliced-vbi
query the sliced VBI capture format [VIDIOC_G_FMT]
--get-fmt-sliced-vbi-out
query the sliced VBI output format [VIDIOC_G_FMT]
-b, --set-fmt-sliced-vbi
--try-fmt-sliced-vbi
--set-fmt-sliced-vbi-out
--try-fmt-sliced-vbi-out=<mode>
set/try the sliced VBI capture/output format to <mode>
[VIDIOC_S/TRY_FMT], <mode> is a comma separated list of:
off: turn off sliced VBI (cannot be combined with
other modes)
teletext: teletext (PAL/SECAM)
cc: closed caption (NTSC)
wss: widescreen signal (PAL/SECAM)
vps: VPS (PAL/SECAM)
--get-fmt-vbi query the VBI capture format [VIDIOC_G_FMT]
--get-fmt-vbi-out query the VBI output format [VIDIOC_G_FMT]
--set-fmt-vbi
--try-fmt-vbi
--set-fmt-vbi-out
--try-fmt-vbi-out=samplingrate=<r>,offset=<o>,samplesperline=<spl>,
start0=<s0>,count0=<c0>,start1=<s1>,count1=<c1>
set/try the raw VBI capture/output format [VIDIOC_S/TRY_FMT]
samplingrate: samples per second
offset: horizontal offset in samples
samplesperline: samples per line
start0: start line number of the first field
count0: number of lines in the first field
start1: start line number of the second field
count1: number of lines in the second field
SDR Formats options:
--list-formats-sdr display supported SDR capture formats [VIDIOC_ENUM_FMT]
--get-fmt-sdr query the SDR capture format [VIDIOC_G_FMT]
--set-fmt-sdr=<f> set the SDR capture format [VIDIOC_S_FMT]
parameter is either the format index as reported by
--list-formats-sdr-cap, or the fourcc value as a string
--try-fmt-sdr=<f> try the SDR capture format [VIDIOC_TRY_FMT]
parameter is either the format index as reported by
--list-formats-sdr-cap, or the fourcc value as a string
--list-formats-sdr-out
display supported SDR output formats [VIDIOC_ENUM_FMT]
--get-fmt-sdr-out query the SDR output format [VIDIOC_G_FMT]
--set-fmt-sdr-out=<f>
set the SDR output format [VIDIOC_S_FMT]
parameter is either the format index as reported by
--list-formats-sdr-out, or the fourcc value as a string
--try-fmt-sdr-out=<f>
try the SDR output format [VIDIOC_TRY_FMT]
parameter is either the format index as reported by
--list-formats-sdr-out, or the fourcc value as a string
Selection/Cropping options:
--get-cropcap query the crop capabilities [VIDIOC_CROPCAP]
--get-crop query the video capture crop window [VIDIOC_G_CROP]
--set-crop=top=<x>,left=<y>,width=<w>,height=<h>
set the video capture crop window [VIDIOC_S_CROP]
--get-cropcap-output
query crop capabilities for video output [VIDIOC_CROPCAP]
--get-crop-output query the video output crop window [VIDIOC_G_CROP]
--set-crop-output=top=<x>,left=<y>,width=<w>,height=<h>
set the video output crop window [VIDIOC_S_CROP]
--get-cropcap-overlay
query crop capabilities for video overlay [VIDIOC_CROPCAP]
--get-crop-overlay query the video overlay crop window [VIDIOC_G_CROP]
--set-crop-overlay=top=<x>,left=<y>,width=<w>,height=<h>
set the video overlay crop window [VIDIOC_S_CROP]
--get-cropcap-output-overlay
query the crop capabilities for video output overlays
[VIDIOC_CROPCAP]
--get-crop-output-overlay
query the video output overlay crop window [VIDIOC_G_CROP]
--set-crop-output-overlay=top=<x>,left=<y>,width=<w>,height=<h>
set the video output overlay crop window [VIDIOC_S_CROP]
--get-selection=target=<target>
query the video capture selection rectangle [VIDIOC_G_SELECTION]
See --set-selection command for the valid <target> values.
--set-selection=target=<target>,flags=<flags>,top=<x>,left=<y>,width=<w>,height=<h>
set the video capture selection rectangle [VIDIOC_S_SELECTION]
target=crop|crop_bounds|crop_default|compose|compose_bounds|
compose_default|compose_padded|native_size
flags=le|ge
--get-selection-output=target=<target>
query the video output selection rectangle [VIDIOC_G_SELECTION]
See --set-selection command for the valid <target> values.
--set-selection-output=target=<target>,flags=<flags>,top=<x>,left=<y>,width=<w>,height=<h>
set the video output selection rectangle [VIDIOC_S_SELECTION]
See --set-selection command for the arguments.
Miscellaneous options:
--wait-for-event=<event>
wait for an event [VIDIOC_DQEVENT]
<event> is the event number or one of:
eos, vsync, ctrl=<id>, frame_sync, source_change=<pad>,
motion_det
where <id> is the name of the control
and where <pad> is the index of the pad or input
--poll-for-event=<event>
poll for an event [VIDIOC_DQEVENT]
see --wait-for-event for possible events
-P, --get-parm display video parameters [VIDIOC_G_PARM]
-p, --set-parm=<fps>
set video framerate in <fps> [VIDIOC_S_PARM]
--get-output-parm display output video parameters [VIDIOC_G_PARM]
--set-output-parm=<fps>
set output video framerate in <fps> [VIDIOC_S_PARM]
--get-jpeg-comp query the JPEG compression [VIDIOC_G_JPEGCOMP]
--set-jpeg-comp=quality=<q>,markers=<markers>,comment=<c>,app<n>=<a>
set the JPEG compression [VIDIOC_S_JPEGCOMP]
<n> is the app segment: 0-9/a-f, <a> is the actual string.
<markers> is a colon separated list of:
dht: Define Huffman Tables
dqt: Define Quantization Tables
dri: Define Restart Interval
--encoder-cmd=cmd=<cmd>,flags=<flags>
Send a command to the encoder [VIDIOC_ENCODER_CMD]
cmd=start|stop|pause|resume
flags=stop_at_gop_end
--try-encoder-cmd=cmd=<cmd>,flags=<flags>
Try an encoder command [VIDIOC_TRY_ENCODER_CMD]
See --encoder-cmd for the arguments.
--decoder-cmd=cmd=<cmd>,flags=<flags>,stop_pts=<pts>,start_speed=<speed>,
start_format=<none|gop>
Send a command to the decoder [VIDIOC_DECODER_CMD]
cmd=start|stop|pause|resume
flags=start_mute_audio|pause_to_black|stop_to_black|
stop_immediately
--try-decoder-cmd=cmd=<cmd>,flags=<flags>
Try a decoder command [VIDIOC_TRY_DECODER_CMD]
See --decoder-cmd for the arguments.
Video Streaming options:
--stream-count=<count>
stream <count> buffers. The default is to keep streaming
forever. This count does not include the number of initial
skipped buffers as is passed by --stream-skip.
--stream-skip=<count>
skip the first <count> buffers. The default is 0.
--stream-sleep=<count>
sleep for 1 second every <count> buffers. If <count> is 0,
then sleep forever right after streaming starts. The default
is -1 (never sleep).
--stream-to=<file> stream to this file. The default is to discard the
data. If <file> is '-', then the data is written to stdout
and the --silent option is turned on automatically.
--stream-to-host=<hostname[:port]> stream to this host. The default port is 8362.
--stream-poll use non-blocking mode and select() to stream.
--stream-mmap=<count>
capture video using mmap() [VIDIOC_(D)QBUF]
count: the number of buffers to allocate. The default is 3.
--stream-user=<count>
capture video using user pointers [VIDIOC_(D)QBUF]
count: the number of buffers to allocate. The default is 3.
--stream-dmabuf capture video using dmabuf [VIDIOC_(D)QBUF]
Requires a corresponding --stream-out-mmap option.
--stream-from=<file> stream from this file. The default is to generate a pattern.
If <file> is '-', then the data is read from stdin.
--stream-from-host=<hostname[:port]> stream from this host. The default port is 8362.
--stream-loop loop when the end of the file we are streaming from is reached.
The default is to stop.
--stream-out-pattern=<count>
choose output test pattern. The default is 0.
--stream-out-square
show a square in the middle of the output test pattern.
--stream-out-border
show a border around the pillar/letterboxed video.
--stream-out-sav insert an SAV code in every line.
--stream-out-eav insert an EAV code in every line.
--stream-out-pixel-aspect=<aspect
select a pixel aspect ratio. The default is to autodetect.
<aspect> can be one of: square, ntsc, pal
--stream-out-video-aspect=<aspect
select a video aspect ratio. The default is to use the frame ratio.
<aspect> can be one of: 4x3, 14x9, 16x9, anamorphic
--stream-out-alpha=<alpha-value>
value to use for the alpha component, range 0-255. The default is 0.
--stream-out-alpha-red-only
only use the --stream-out-alpha value for the red colors,
for all others use 0.
--stream-out-rgb-lim-range
Encode RGB values as limited [16-235] instead of full range.
--stream-out-hor-speed=<speed>
choose speed for horizontal movement. The default is 0,
and the range is [-3...3].
--stream-out-vert-speed=<speed>
choose speed for vertical movement. The default is 0,
and the range is [-3...3].
--stream-out-perc-fill=<percentage>
percentage of the frame to actually fill. The default is 100%.
--stream-out-mmap=<count>
output video using mmap() [VIDIOC_(D)QBUF]
count: the number of buffers to allocate. The default is 4.
--stream-out-user=<count>
output video using user pointers [VIDIOC_(D)QBUF]
count: the number of buffers to allocate. The default is 4.
--stream-out-dmabuf
output video using dmabuf [VIDIOC_(D)QBUF]
Requires a corresponding --stream-mmap option.
--list-patterns list available patterns for use with --stream-pattern.
--list-buffers list all video buffers [VIDIOC_QUERYBUF]
--list-buffers-out list all video output buffers [VIDIOC_QUERYBUF]
--list-buffers-vbi list all VBI buffers [VIDIOC_QUERYBUF]
--list-buffers-vbi-out
list all VBI output buffers [VIDIOC_QUERYBUF]
--list-buffers-sliced-vbi
list all sliced VBI buffers [VIDIOC_QUERYBUF]
--list-buffers-sliced-vbi-out
list all sliced VBI output buffers [VIDIOC_QUERYBUF]
--list-buffers-sdr
list all SDR RX buffers [VIDIOC_QUERYBUF]
--list-buffers-sdr-out
list all SDR TX buffers [VIDIOC_QUERYBUF]
EDID options:
--set-edid=pad=<pad>[,type=<type>|file=<file>][,format=<fmt>][modifiers]
<pad> is the input or output index for which to set the EDID.
<type> can be 'hdmi', 'hdmi-4k-170mhz', 'hdmi-4k-300mhz', 'hdmi-4k-600mhz',
'dvid' or 'vga'. A predefined EDID suitable for that connector type will be
set. It has a 1920x1080p60 native resolution for the non-4k variants and a
3840x2160 resolution for the 4k variants (4kp30 YCbCr 4:2:0 for 170mhz, 4kp30
for 300 mhz and 4kp60 for 600 mhz).
If <file> is '-', then the data is read from stdin, otherwise it is
read from the given file. The file format must be in hex as in get-edid.
The 'type' or 'file' arguments are mutually exclusive. One of the two
must be specified.
<fmt> is one of:
hex: hex numbers in ascii text (default)
raw: raw binary EDID content
[modifiers] is a comma-separate list of EDID modifiers:
CEA-861 Header modifiers:
underscan: toggle the underscan bit.
audio: toggle the audio bit.
ycbcr444: toggle the YCbCr 4:4:4 bit.
ycbcr422: toggle the YCbCr 4:2:2 bit.
Speaker Allocation Data Block modifiers:
fl-fr: Front Left and Front Right.
lfe: Low Frequence Effects.
fc: Front Center.
rl-rr: Rear Left and Rear Right.
rc: Rear Center.
flc-frc: Front Left Center and Front Right Center.
rlc-rrc: Rear Left Center and Rear Right Center.
flw-frw: Front Left Wide and Front Right Wide.
flh-frh: Front Left High and Front Right High.
tc: Top Center.
fch: Front Center High.
HDMI Vendor-Specific Data Block modifiers:
pa=<pa>: change the physical address.
y444: toggle the YCbCr 4:4:4 Deep Color bit.
30-bit: toggle the 30 bits/pixel bit.
36-bit: toggle the 36 bits/pixel bit.
48-bit: toggle the 48 bits/pixel bit.
graphics: toggle the Graphics Content Type bit.
photo: toggle the Photo Content Type bit.
cinema: toggle the Cinema Content Type bit.
game: toggle the Game Content Type bit.
HDMI Forum Vendor-Specific Data Block modifiers:
scdc: toggle the SCDC Present bit.
CEA-861 Video Capability Descriptor modifiers:
qy: toggle the QY YCC Quantization Range bit.
qs: toggle the QS RGB Quantization Range bit.
s-pt=<0-3>: set the PT Preferred Format Over/underscan bits.
s-it=<0-3>: set the IT Over/underscan bits.
s-ce=<0-3>: set the CE Over/underscan bits.
CEA-861 Colorimetry Data Block modifiers:
xvycc-601: toggle the xvYCC 601 bit.
xvycc-709: toggle the xvYCC 709 bit.
sycc: toggle the sYCC 601 bit.
adobe-ycc: toggle the Adobe YCC 601 bit.
adobe-rgb: toggle the Adobe RGB bit.
bt2020-rgb: toggle the BT2020 RGB bit.
bt2020-ycc: toggle the BT2020 YCC bit.
bt2020-cycc: toggle the BT2020 cYCC bit.
CEA-861 HDR Static Metadata Data Block modifiers:
sdr: toggle the Traditional gamma SDR bit.
hdr: toggle the Traditional gamma HDR bit.
smpte2084: toggle the SMPTE ST 2084 bit.
--clear-edid=<pad>
<pad> is the input or output index for which to clear the EDID.
--info-edid=<pad> print the current EDID's modifiers
<pad> is the input or output index for which to get the EDID.
--get-edid=pad=<pad>,startblock=<startblock>,blocks=<blocks>,format=<fmt>,file=<file>
<pad> is the input or output index for which to get the EDID.
<startblock> is the first block number you want to read. Default 0.
<blocks> is the number of blocks you want to read. Default is
all blocks.
<fmt> is one of:
hex: hex numbers in ascii text (default)
raw: can be piped directly into the edid-decode tool
carray: c-program struct
If <file> is '-' or not the 'file' argument is not supplied, then the data
is written to stdout.
--fix-edid-checksums
If specified then any checksum errors will be fixed silently.
3 Examples[edit source]
Refer to V4L2 camera overview ("how to use the framework" chapter) for examples of usage.
4 References[edit source]