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. |