Ivtvctl old

From IVTV

(Redirected from Ivtvctl)
Jump to: navigation, search

In the newer releases of ivtv (>=ivtv-0.8) most these options have been moved to v4l2-ctl. The syntax should be almost the same


ivtvctl is a utility that can control many card settings, like changing the inputs from tuner to svideo or composite, setting video resolution or changing video mode (PAL, SECAM, NTSC).

It is included in the ivtv source under the utils directory, and is installed with make install. Most non-ivtv specific options (such as selecting inputs, etc) have been moved into 'v4l2-ctl' utility, and ivtvctl now only has settings specific to ivtv.

Usage:

	-A	--list-audio-inputs	display audio inputs [VIDIOC_ENUMAUDIO]
	-a	--all	display all information available
	-B	--get-vbi	query the current VBI mode [IVTV_G_VBI_MODE]
	-b	--set-vbi=<mode>	set the current VBI mode [IVTV_S_VBI_MODE]
    
    	raw	raw VBI mode
    	teletext	sliced teletext
    	cc	sliced closed caption
    	wss	sliced widescreen signal
    	vps	sliced vps
    
	-C	--list-codec-params	display the current codec parameters [IVTV_IOC_G_CODEC]
	-c	--set-codec-params=[param],[param],...	set the current codec parameters [IVTV_IOC_S_CODEC]
    
    	aspect	aspect ratio
        
        	1	1:1
        	2	4:3 (normal TV)
        	3	16:9 (Widescreen)
        	4	2.21:1
    	audio	audio bitmask, binary OR of the following values
        
        Samplerate
        	0x0000	44,100Hz (CD)
        	0x0001	48,000Hz (AC97)
        	0x0002	32,000Hz
        Layer
        	0x0004	Layer 1
        	0x0008	Layer 2
        Bitrate
        	0x0000	Free Format
        	0x0010	32kbps
        	0x0020	L1: 64kbps, L2: 48kbps
        	0x0030	L1: 96kbps, L2: 56kbps
        	0x0040	L1: 128kbps, L2: 64kbps
        	0x0050	L1: 160kbps, L2: 80kbps
        	0x0060	L1: 192kbps, L2: 96kbps
        	0x0070	L1: 224kbps, L2: 112kbps
        	0x0080	L1: 256kbps, L2: 128kbps
        	0x0090	L1: 288kbps, L2: 160kbps
        	0x00A0	L1: 320kbps, L2: 192kbps
        	0x00B0	L1: 352kbps, L2: 224kbps
        	0x00C0	L1: 384kbps, L2: 256kbps
        	0x00D0	L1: 416kbps, L2: 320kbps
        	0x00E0	L1: 448kbps, L2: 384kbps
        Mode
        	0x0000	Stereo
        	0x0100	Joint Stereo
        	0x0200	Dual
        	0x0300	Mono
        Mode Extension (for Joint Stereo)
        	0x0000	subbands 4-31 in intensity_stereo, bound==4
        	0x0400	subbands 8-31 in intensity_stereo, bound==8
        	0x0800	subbands 12-31 in intensity_stereo, bound==12
        	0x0C00	subbands 16-31 in intensity_stereo, bound==16
        Emphasis
        	0x0000	None
        	0x1000	50/15uS
        	0x3000	CCITT J.17
        CRC (Cyclic Redundancy Check)
        	0x0000	Off
        	0x4000	On
        Copyright
        	0x0000	Off
        	0x8000	On
        Generation
        	0x0000	Copy
        	0x10000	Original
        
    	bframes	number of B (bidirectional) frames PLUS 1<br/>default setting of 3 generates 2 b-frames between P and I frames
    	bitrate	bitrate (DVD max = 9.6Mbps)
    	bitrate_mode	
        
        	0	variable
        	1	constant
        
    	bitrate_peak	peak bitrate (must be greater than bitrate)
    	dnr_mode	Dynamic Noise Reduction filter mode
        
        	0	both manual
        	1	spatial: automatic, temporal: manual
        	2	spatial: manual, temporal: automatic
        	3	both automatic
    	dnr_spatial	amount of spatial (horizontal) smoothing (0..15)
    	dnr_temporal	amount of temporal (motion) smoothing (0..31)
    	dnr_type	Median Filter
        
        	0	Disabled
        	1	Horizontal
        	2	Vertical
        	3	Horizontal/Vertical
        	4	Diagonal
        
    	framerate	
        
        	0	30 (NTSC)
        	1	25 (PAL)
        
    	framespergop	number of frames in a Group Of Pictures
    	gop_closure	open/closed gop
    	pulldown	inverse telecine on (1) / off (0)
    	stream_type	
        
        	0	Program Stream (PS)
        	1	Transport Stream (TS) Note: This does not work with newer firmware (from at least November 2005, maybe earlier)
        	2	MPEG1
        	3	PES A/V
        	4	?
        	5	PES Video
        	6	?
        	7	PES Audio
        	8	?
        	9	?
        	10	DVD
        	11	VCD
        	12	SVCD
        	13	DVD_S1
        	14	DVD_S2
        
    
	-d	--device=<dev>	use device <dev> instead of /dev/video0
	-F	--get-format	query the current data format [VIDIOC_G_FMT]
	-f	--set-format=width=<x>,height=<y>	set the current data format [VIDIOC_S_FMT]
	-h	--help	display this help message
	-K	--passthrough=<mode>	set passthrough mode: 1 = on, 0 = off [IVTV_IOC_PASSTHROUGH]
	-L	--get-output	query the current video output [VIDIOC_G_OUTPUT]
	-l	--set-output=<num>	set the current video output to <num> [VIDIOC_S_OUTPUT]
	-m	--list-capability	query device capabilities [VIDIOC_QUERYCAP]
	-N	--list-outputs	display video outputs [VIDIOC_ENUMOUTPUT]
	-n	--list-inputs	display video inputs [VIDIOC_ENUMINPUT]
	-P	--get-input	query the current video input [VIDIOC_G_INPUT]
	-p	--set-input=<num>	set the current video input to <num> [VIDIOC_S_INPUT]
	-Q	--get-audio-input	query the current audio input [VIDIOC_G_AUDIO]
	-q	--set-audio-input=<num>	set the current audio input to <num> [VIDIOC_S_AUDIO]
	-R	--get-freq	query the current frequency [VIDIOC_G_FREQUENCY]
	-r	--set-freq=<freq>	set the current frequency to <freq> [VIDIOC_S_FREQUENCY]
	-s	--list-standards	display supported video standards [VIDIOC_ENUMSTD]
	-U	--get-standard	query the current video standard [VIDIOC_G_STD]
	-u	--set-standard=<num>	set the current video standard to <num> [VIDIOC_S_STD]
        
        	0x003000	NTSC
        	0x0000ff	PAL
        	0x7f0000	SECAM
        
	-W	--get-vbi-passthrough	query the current VBI passthrough mode [IVTV_IOC_G_VBI_PASSTHROUGH]
	-w	--set-vbi-passthrough=<mode>	set the current VBI passthrough mode to <mode> [IVTV_IOC_S_VBI_PASSTHROUGH]
        
        	none	no passthrough
        	cc	closed caption
        	wss	widescreen signal
        	vps	VPS
        
	-X	--get-vbi-embed	query whether VBI data is embedded in the MPEG stream [IVTV_IOC_G_VBI_EMBED]
	-x	--set-vbi-embed=<mode>	set whether VBI data is embedded in the MPEG stream [IVTV_IOC_S_VBI_EMBED]
                     If 1, embed VBI data in the MPEG stream, if 0, don't.
	-Y	--list-ctrls	display all controls and their values [VIDIOC_QUERYCTRL]
	-y	--set-ctrl=[ctrl]=<val>	set the control to the value specified [VIDIOC_S_CTRL]
        
        	brightness	Picture brightness, or more precisely, the black level. [0 - 255]
        	hue	Hue or color balance. [-128 - 127]
        	saturation	Picture color saturation or chroma gain. [0 - 127]
        	contrast	Picture contrast or luma gain. [0 - 127]
        	volume	Overall audio volume. [0 - 65535]
        	mute	Mute audio, i.e. set the volume to zero [boolean]
        
	-Z	--get-sapmode	query the current Secondary Audio Program [VIDIOC_G_TUNER]
	-z	--set-sapmode=<mode>	set the current Secondary Audio Program to <mode> [VIDIOC_S_TUNER]
        
        	0	Mono
        	1	Stereo
        	2	Channel 2
        	3	Channel 1
        
		--get-yuv-mode	display the current yuv mode
		--set-yuv-mode=[param],[param]	set the current yuv mode
        
        	mode	yuv mode
            
            	0	interlaced
            	1	progressive
            	2	auto
            
        	threshold	if src_hight <= threshold treat as progressive
        
		--reset-ir	reset the infrared receiver [IVTV_IOC_RESET_IR]
		--version	shows the version number of this utility. It should match the driver version.
Expert options:
	-D	--set-debug=level	set the module ivtv_debug variable [IVTV_IOC_S_DEBUG_LEVEL]
	-E	--end-gop	capture last GOP [IVTV_IOC_S_GOP_END]
	-e	--get-debug	query the module ivtv_debug variable [IVTV_IOC_G_DEBUG_LEVEL]
	-G	--list-dec-registers	dump decoder registers [DECODER_GET_REG]
	-g	--set-dec-register=reg=<reg>,val=<val>	set decoder registers [DECODER_SET_REG]
	-H	--reload	forces reload on cards firmware [IVTV_IOC_RELOAD_FW]
	-I	--input-detect	detect input video signal
	-i	--set-gpio=<mode>	set GPIO output to <mode> for debugging [0x0000-0xffff]
	-J	--list-enc-registers	dump encoder registers [ENCODER_GET_REG]
	-j	--set-enc-register=reg=<reg>,val=<val>	set encoder registers [ENCODER_SET_REG]
	-k	--sync	test vsync's capabilities [IVTV_IOC_FRAMESYNC]
	-O	--list-itvc-registers=min=<val>,max=<val>	dump ITVC registers [ITVC_GET_REG]
	-o	--set-itvc-register=reg=<reg>,val=<val>	set ITVC registers [ITVC_SET_REG]
	-S	--streamoff	send StreamOff API [VIDIOC_STREAMOFF]
	-V	--info	gets driver information (version) [IVTV_IOC_G_DRIVER_INFO]
	-v	--set-io=input=<in>,output=<out>	set the MSP34xx input/output mapping [MSP_SET_MATRIX]
		--log-status	log the board status in the kernel log
development