get-signal-info

Use the interface to obtain the input signal information.

HTTP Request

GET http://ip/mwapi?method=get-signal-info
Parameter Description
method get-signal-info

Response Body

JSON structure is as follows:

{
 "status": 0,
 "signal-info-types": ["video-info", "audio-info", "hdmi-info", "sdi-info", "info-frames"], // The items in the array correspond to the following property one by one
 "video-info": {...},
 "audio-info": {...},
 "hdmi-info": {...},
 "sdi-info": {...},
 "info-frames": {...}
}
Status
"status": 0
Name Description
status 0 indicates that the request was accepted successfully. Refer to API Status Codes to find specific description for other values.
Signal type
"signal-info-types": [
 "video-info",   // video status
 "audio-info",   // audio status
 "hdmi-info",   // HDMI status
 "sdi-info",    // SDI status
 "info-frames"   // InfoFrame
]
VIDEO STATUS (video-info:{...})
"video-info": {
 "codec": "uncompressed",
 "width": 1920,
 "height": 1080,
 "scan": "progressive",
 "field-rate": 60.00,
 "color-depth": 8,
 "color-format": "rgb",
 "aspect-ratio": "16:9",
 "sampling": "4:4:4",
 "quant-range": "full",
 "sat-range": "full",
 "frame-struct": "2d"
}
Name Description
codec Indicates the video compression methods, including uncompressed, dsc, mpeg2, ...
width Indicates the total number of pixels, horizontally.
height Indicates the total number of pixels, vertically.
scan Indicates the refresh rate, , including progressive, interlaced, psf
field-rate Indicates the frame rate, including 24, 25, 29.97, 30, 48, 50, 59.94, 60.
color-depth Indicates the color depth, including 8, 10, 12.
color-format Indicates the color space, including rgb, bt.601, bt.709, bt.2020.
aspect-ratio Indicates the aspect ratio, including 16:9, 4:3, ...
sampling Indicates the sampling rate, including 4:2:0, 4:2:2, 4:4:4, 4:4:4:4.
quant-range Indicates the quantization range, including limited, full.
sat-range Indicates the saturation range, including limited, extended, full.
frame-struct Indicates the input video frame type, 2d, 3d-left-right, 3d-top-bottom, 3d-left-right-half, 3d-top-bottom-half.
AUDIO STATUS (audio-info:{...})
"audio-info": {
 "codec": "lpcm",
 "num-channels": 2,
 "sample-rate": 48000,
 "bit-count": 16
}
Name Description
codec Indicates the encoding type, including lpcm, ac3, aac, ...
num-channels Indicates the number of channels, including 1, 2, .. 16
sample-rate Indicates the sampling rate, including 32000, 44100, ...
bit-count Indicates the bit rate, including 16, 20, 24, ...
HDMI STATUS (hdmi-info:{...})
"hdmi-info": {
 "mode": "dvi",
 "vic": 0,
 "scramble": false,
 "clock-ratio": 1,
 "hdcp": "none",
 "repeat-count": 0,
 "it-content": false,
 "timing-mode-line": "148.50 1920 2008 2052 2200 1080 1084 1089 1125 +hsync +vsync"
}
Name Description
mode Indicates the signal type, including hdmi, dvi.
vic Indicates the Video Identification Code, which is defined for CEA formats.
scramble Indicates whether to scramble to prevent signal parsing problems. If yes, it shows true; otherwise, it is false.
clock-ratio Indicates the clock ratio, including 1, 4.
hdcp Indicates HDCP encrypted type, including none, hdcp-1.x, hdcp-2.2.
repeat-count Indicates the signal repeat times, 0, 1, 2, 4, ...
it-content Indicates whether the transmission package is content. If yes, it shows true; otherwise, it is false.
timing-mode-line Indicates the modeline.
Syntax: pclk hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal [flags]
flags: +hsync, -hsync, +vsync, -vsync, interlace, double-scan, sog, +csync, -csync
For example: 23.86 640 656 720 800 480 481 484 497 -hsync +vsync
The unit of pclk is MHz, and that of the other parameters are in pixels.
SDI STATUS (sdi-info:{...})
"sdi-info": {
 "link-type": "",
 "link-speed": "",
 "stream-type": "",
 "level-b": true,
 "interlaced": true,
 "assignment": 0,
 "st352-payload-id": 3423424,
 "h-total": 2250,
 "v-total": 1125,
 "h-active": 1920,
 "v-active": 1080
}
Name Description
link-type Indicates link type of input SDI signal, including unknown, single-link, dual-link, quad-link.
link-speed Indicates the current data speed, including unknown, sd, hd, 3g, 6g, 12g.
stream-type Indicates the number of streams that is contained in the data source, including single-stream, dual-stream, 3d.
level-b Indicates whether the input signal is level B format. If yes, it shows true; otherwise, it is false.
interlaced Indicates whether the input signal is interlaced. If yes, it shows true; otherwise, it is false.
assignment Indicates the link number, especially when be fed into a source of multi-link interfaces.
st352-payload-id Indicates the SMPTE ST 352 video payload identification code for SDI. which is an unsigned 32-bit integer and be displayed in HEX.
h-total Indicates the total number of pixels, horizontally
v-total Indicates the total number of pixels, vertically.
h-active Indicates the number of active pixels, horizontally.
v-active Indicates the number of active pixels, vertically.
InfoFrame (info-frames:{...})
"info-frames": [
 {
  "id": "AVI",   
  "type": 130,
  "version": 2,
  "checksum": 96,
  "data": "ACgAIgAAADkEAACBBw=="
 },
 {
  "id": "Audio",
  "type": 132,
  "version": 1,
  "checksum": 112,
  "data": "AQAAAAAAAAAAAA=="
 }
]
Name Description
id Indicates the infoFrame type, including AVI, Audio, ...
type Indicates the packet type.
version Indicates the packet version.
checksum Indicates the packet checksum.
data Indicates the InfoFrame payload, which is encoded in base64 and displayed in hex.

results matching ""

    No results matching ""

    results matching ""

      No results matching ""