dec

The dec command is used to manage A/V decoder settings. The dec start and dec stop commands can be used to start and stop decoding video. ID can be all or id1,id2,id3,id4 with values from 0 to 3. You can specify a comma-separated list of IDs for the operation, as shown in the examples that follow.

Synopsis

dec ID start
dec ID stop
dec ID set parameter=value [parameter=value]
dec ID get [config/stats/all] [video/buffer/metadata/audio/clockrecovery/all]
dec ID capture [filename=value] [resolution=WxH]
dec ID clear

Actions

Action	Description
start	Starts decoding the video input.
stop	Stops decoding the video input.
set	Configures A/V decoder settings. A series of one or more `parameter=value` pairs can be specified at once. See Parameters below.
get	Displays information on the decoder. You can choose to display the configuration (`config`), `stats`, or `all` [`config/stats/all`], and optionally specify a section of interest [`video/buffer/metadata/audio/clockrecovery/all`] Tip To display a summary of all the decoders in a table format, you can use `dec all get table:` # dec all get table ID STREAM ALT-STREAM STATE FORMAT BUFFERING OUTPUTS ---------------------------------------------------------------------------------------- 0 1 (None) ACTIVE NATIVE AUTOMATIC SDI-1 1 (None) (None) STOPPED NATIVE AUTOMATIC SDI-2 2 (None) (None) STOPPED NATIVE AUTOMATIC SDI-3 3 (None) (None) STOPPED NATIVE AUTOMATIC SDI-4
clear	Clears the decoder’s statistics.
help	Displays usage information for the `dec` command.

Parameters

Parameter	Default	Description/Values
streamId	n/a	Positive stream index. See Configuring Decoder Outputs.
stillImage	freeze	The type of static image to display when the decoder is not receiving a video stream. `freeze`: continues to display the last decoded video frame. `black`: displays a black screen. `blue`: displays a blue screen. `bars`: displays a series of vertical color bars across the width of the display. `mute`: disables the video output. `custom:` displays the custom still image specified for `stillFile`. Note When the still image is substituted on the display outputs, the video frame rate and resolution will be maintained. When the video decoder receives a new video stream, it waits until it receives a new IDR frame and re-starts the display with that IDR frame.
stillFile	n/a	Filename of the custom still image. Default images are provided, and your system administrator may have imported additional Still Images for your decoder. See /wiki/spaces/MX4D/pages/11502615.
stillDelay	3	The delay in seconds before the still image is displayed: 1...1000
format	auto	The output display format: `Auto:` The decoder will select an output resolution that attempts to closely match the coded picture resolution, taking into account the capabilities of any displays connected to the HDMI interface. `Native:` The output resolution will be exactly the same as the coded picture resolution. If the coded picture resolution is not compatible with the output interfaces, nothing will be displayed. See "Output Resolution" in /wiki/spaces/MX4D/pages/11501759. Video scaling is not supported.
frameRate	auto	The output frame rate for the displays. `Auto, 23, 24, 25, 29, 30, 50, 59` or `60` If `Auto` is selected, the actual frame rate generated will be the next highest valid frame rate supported by the SDI interface, plus the one that gives the best decimation factor. For example, 30Hz could be chosen instead of 29.970 Hz. Values set which are impossible to implement will be treated as `Auto`. Reasons for not supporting the selection can range from “Display does not support the frame rate” or “Frame rate is undefined for the detected input resolution”.
buffering	automatic	The type of buffering to use. A jitter buffer temporarily stores arriving packets in order to remove the effects of jitter from the decoded stream. `automatic` - Set buffering automatically for good quality and proper sync `fixed` - Set buffering for fixed delay (use delay=X parameter) `multisync` - Set buffering for fixed delay from the encode time (use multiSyncDelay=X parameter, requires SYSTEM TC and NTP)
delay	n/a	The delay in ms when using `stc syncmode` with fixed buffering. Range: `0...3000`
multiSyncDelay	n/a	The delay in ms from encoder TC when using multisync buffering. Range: `0...10000`
hardwareDelayAdd	n/a	The number of ms to add to the delay for processing the output in the hardware. Range: `-60...200`
dropCorruptedFrames	no	Configures the decoder to drop corrupted frames before they reach the decoder. Options: `no, yes`
dynamicrange	automatic	Configures the decoder to detect the inbound High Dynamic Range (HDR) transfer function signaling and forward that information within the decoded stream. automatic: the decoder detects HDR transfer function from the source off (SDR/BT.709) HLG: HDR content is based on the Hybrid Log Gamma (HLG, BT.2100) transfer function PQ: HDR content is based on the Perceptual Quantizer (PQ, SMPTE ST 2084/BT.2100) transfer function Note HLG and PQ override the settings in the stream.
outputs	n/a	A list of physical SDI outputs the decoder core will feed: 1..4 none, all, default, quad2SI, or id1[,id2,id3,id4]

Examples

# dec 3,2,0 start

Starts decoders 3, 2 and 0 (in the order specified)

# dec 1 get stats

Returns (all) decoder statistics for decoder 1:

Decoder ID : 1
Decoder Name : "Decoder 1"
Statistics
State : ACTIVE
Up Time : 3h59m53s
Usage
Start : 1 (Last One: 3h59m52s ago)
Stop : 0
Get Stats : 3,237 (Last One: 0s ago)
Get Info : 2,301 (Last One: 0s ago)
Configure : 1 (Last One: 3h59m52s ago)
Capture : 0
Clear : 1 (Last One: 3h48m32s ago)
Load Config : 1 (Last One: 3h59m52s ago)
Save Config : 0
Buffering
Buffering Mode : AUTOMATIC
Buffering State : ACTIVE
Video Latency : 144ms
Initial Converge Time : 33s
Adjustment Profile : VBR (Last Changed: Never, Count=0)
Decoder Set Delay : 141ms (min=143ms)
STC to PCR Lead Time : 102ms (STC is ahead of PCR by 102ms)
Max Input Jitter : 30ms (absolute max=30ms, occurred 3h57m1s ago)
Non-Video Late : 26ms (max=24ms occurred 3h59m42s ago)
Audio Late Correction : 0ms (last changed Never)
VCU Requested Delay : 0ms (last changed Never)
Video Decoder Latency : 12ms (max=22ms occurred 3h59m40s ago)
Video Decoder Jitter : 29ms (max=33ms occurred 3h59m20s ago)
B-frame Delay : 0ms (max=0ms occurred Never)
Hardware Delay : 40ms
Buffering Delays : 54ms (Before VCU), 87ms (After Buffering)
Video Output Jitter : 0ms
Video STC Lead Time : 62ms (Min=46ms, Max=63ms, Range=17ms)
Minimum Display Delay : 59ms
Last Video Skip/Replay : 3h59m19s ago
Audio STC Lead Time : 112ms (Min=94ms, Max=121ms, Range=27ms)
Last Audio Skip : Never
Video
Preprocessor State : ACTIVE
Stream Properties
Compression : H.265
Color : 4:2:0 8-bit
Profile : Main
Level : 4.0
Format : 1280x720p60
Bitrate : 15.02 Mbps
Framing : IP
GOP Interval : 120
Slices per Frame : 1
Dynamic Range : SDR Stream, SDR Output
Metadata Present : None
Input Frame Rate Measrd : 59.78 [99.6%] (max=60 occurred 3h48m29s ago, min=59 occurred 3h48m19s ago)
Still Image : FREEZE (INACTIVE) [On Count=0, Max On=0s, Last On=Ne ver, Last Off=3h59m52s ago]
Video Decoder State : ACTIVE
Display Format : 1280x720p60
Video Decoder Load : 11%
Decoder Counters
VCU Frm not Release : 1 (Last One: 4m28s ago)
HW Counters
Displayed Output Frms : 822,772 [100.0000%] (Last One: 0s ago)
Skipped Output Frames : 0 [0.0000%] (Last One: Never)
Replayed Output Frames : 0 [0.0000%] (Last One: Never)
Skip/Replay Rate : 0.00%
Audio
Audio Decoder State : ACTIVE
Number of Pairs : 2
Downmix to Stereo : NO
Played Output Frames : 1,285,604 [100.0000%] (Last One: 0s ago)
TS Discontinuities : 10,636 (Last One: 0s ago)
AUDIO STREAM #1
Audio Decoder State : ACTIVE
Compression : AAC-ADTS
Implementation : Decode (FFMPEG)
Bitrate : 128.49 kbps
Language : None
Input Layout : 2.0
Output Layout : 2.0
Sample Rate In : 48 kHz
Sample Rate Out : 48 kHz
Audio Pair 1 : FrontL FrontR on Output Pair 1
Left Level : -15.1dB (max=-9.1dB occurred 50m40s ago)
Right Level : -15.1dB (max=-9.1dB occurred 2h57m8s ago)
A/V Sync : -7 ms (VidStc Delta 293 (3 ms), AudStc Delta -374 (- 4 ms))
Decoded Frames : 642,800 (Last One: 0s ago)
Played Output Frms : 642,799 (Last One: 0s ago)
TS Discontinuities : 10,636 (Last One: 0s ago)
AUDIO STREAM #2
Audio Decoder State : ACTIVE
Compression : AAC-ADTS
Implementation : Decode (FFMPEG)
Bitrate : 128.5 kbps
Language : bbb
Input Layout : 2.0
Output Layout : 2.0
Sample Rate In : 48 kHz
Sample Rate Out : 48 kHz
Audio Pair 1 : FrontL FrontR on Output Pair 2
Left Level : -9.9dB (max=-5.1dB occurred 16m4s ago)
Right Level : -9.3dB (max=-3.3dB occurred 1h32m17s ago)
A/V Sync : -7 ms (VidStc Delta 293 (3 ms), AudStc Delta -370 (- 4 ms))
Decoded Frames : 642,805 (Last One: 0s ago)
Played Output Frms : 642,805 (Last One: 0s ago)
Metadata
Metadata State : IDLE
Clock Recovery
Tracking Mode : ENABLE
Status : LOCKED (0.0PPM)
avSyncMasterMode : Audio (pair 0)
Req Audio Delay : 106 ms (Based on Video Delay 131 ms)
ReSync Count : 0
PCR Updates : 0
Current STC : 26,999,844Hz (5PPM from Nominal)
STC Avg (last 2 min) : 26,999,845Hz (Deviation 0.0PPM)

# dec 0 get stats video

Returns (video) decoder statistics for decoder 0:

Decoder ID              : 0
Statistics
  State                 : ACTIVE
  Up Time               : 4m15s
Video
  Preprocessor State    : ACTIVE
  Stream Properties
    Compression         : H.265
    Color               : 4:2:0 8-bit
    Profile             : Main
    Level               : 5.1
    Format              : 1920x1080p29.97
    Bitrate            : 10.03 Mbps
    Framing             : IP
    GOP Interval        : 60
    Slices per Frame    : 1
    Dynamic Range Stream: SDR
    Dynamic Range Output: HLG
    Metadata Present    : None
  Stream ID Changes     : 1 (Last One: 4m14s ago)
  Format Changes        : 1 (Last One: 4m14s ago)
  Input Frame Rate      : 29.96 [100.0%] (measured)
  Still Image           : FREEZE (INACTIVE) [Count=0, Max=18857d13h38m27s, Last On=Never, Last Off=4m10s ago]
  Video Decoder State   : ACTIVE
  Display Format        : 1920x1080p29.97
  Video Decoder Load    : 12%
  Decoder Counters
    VCU Frm not Release : 2 (Last One: 8s ago)
    VCU IN Discontinuity: 0
  HW Counters
    Displayed Output Frms: 7,473 [92.9131%] (Last One: 0s ago)
    Skipped Output Frames: 178 [2.2131%] (Last One: 3m50s ago)
    Replayed Output Frames: 392 [4.8738%] (Last One: 4m ago)

# dec 1 set stillimage=blue

Sets the static image to blue. You will receive the following confirmation:

Decoder configured successfully.

Related Topics