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.

results matching ""

    No results matching ""