get-signal-info
Use the interface to retrieve 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 |
Shows the video codecs, including uncompressed, dsc, mpeg2, ... |
width |
Shows the total number of pixels, horizontally. |
height |
Shows the total number of pixels, vertically. |
scan |
Shows the scanning mode, including progressive, interlaced, psf |
field-rate |
Shows the field rate, including 24, 25, 29.97, 30, 48, 50, 59.94, 60. |
color-depth |
Shows the color depth, including 8, 10, 12. |
color-format |
Shows the color space, including rgb, bt.601, bt.709, bt.2020. |
aspect-ratio |
Shows the aspect ratio, including 16:9, 4:3, ... |
sampling |
Shows the sampling rate, including 4:2:0, 4:2:2, 4:4:4, 4:4:4:4. |
quant-range |
Shows the quantization range, including limited, full. |
sat-range |
Shows the saturation range, including limited, extended, full. |
frame-struct |
Shows 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 |
Shows the encoding type, including lpcm, ac3, aac, ... |
num-channels |
Shows the number of channels, including 1, 2, .. 16 |
sample-rate |
Shows the sampling rate, including 32000, 44100, ... |
bit-count |
Shows 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 |
Shows the signal type, including hdmi, dvi. |
vic |
Shows the Video Identification Code, which is defined for CEA formats. |
scramble |
True indicates to scramble to prevent signal parsing problems, otherwise it is false. |
clock-ratio |
Shows the clock ratio, including 1, 4. |
hdcp |
Shows HDCP encrypted type, including none, hdcp-1.x, hdcp-2.2. |
repeat-count |
Shows the signal repeat times, 0, 1, 2, 4, ... |
it-content |
True indicates that the transmission package is content, otherwise it is false. |
timing-mode-line |
Shows 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 |
Shows link type of input SDI signal, including unknown, single-link, dual-link, quad-link. |
link-speed |
Shows the current data speed, including unknown, sd, hd, 3g, 6g, 12g. |
stream-type |
Shows the number of streams that is contained in the data source, including single-stream, dual-stream, 3d. |
level-b |
True indicates that the input signal is level B format, otherwise it is false. |
interlaced |
True indicates that the input signal is interlaced, otherwise it is false. |
assignment |
Shows the link number, especially when be fed into a source of multi-link interfaces. |
st352-payload-id |
Shows the SMPTE ST 352 video payload identification code for SDI. which is an unsigned 32-bit integer and be displayed in HEX. |
h-total |
Shows the total number of pixels, horizontally. |
v-total |
Shows the total number of pixels, vertically. |
h-active |
Shows the number of active pixels, horizontally. |
v-active |
Shows 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 |
Shows the infoFrame type, including AVI, Audio, ... |
type |
Shows the packet type. |
version |
Shows the packet version. |
checksum |
Shows the packet checksum. |
data |
Shows the InfoFrame payload, which is encoded in base64 and displayed in hex. |