get-signal-info

Use the interface to get the status information of the HDMI Source input signal.

Request Mode

POST http://ip/mwapi/get-signal-info/
Parameter Description
source-id The input source ID
0: HDMI 1
1: HDMI 2

Response Body

JSON structure is as follows:

{
  "status": 0,
  "signal-info-types": ["video-info", "audio-info", "hdmi-info", "info-frames"], 
  "video-info": {...},
  "audio-info": {...},
  "hdmi-info": {...},
  "info-frames": {...}
}
Response 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",    
  "audio-info",
  "hdmi-info",
  "info-frames"     
]
Video Signal Status (video-info:{...})
"video-info": {
  "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
width The total number of pixels, horizontally
height The total number of pixels, vertically.
scan The scan mode, including progressive, interlaced and psf
field-rate The frame rate, including 24, 25, 29.97, 30, 48, 50, 59.94 and 60
color-depth The color depth, including 8, 10 and 12
color-format The color space, including rgb, bt.601, bt.709 and bt.2020
aspect-ratio The aspect ratio, including 16:9, 4:3, etc.
sampling The sampling mode, including 4:2:0, 4:2:2, 4:4:4 and 4:4:4:4
quant-range The quantization range, including limited and full
sat-range The saturation range, including limited, extended and full
frame-struct The frame structure, including 2d, 3d-left-right, 3d-top-bottom, 3d-left-right-half and 3d-top-bottom-half
Audio Signal Status (audio-info:{...})
"audio-info": {
  "codec": "lpcm",
  "num-channels": 2,
  "sample-rate": 48000,
  "bit-count": 16
}
Name Description
codec The encoding type, including lpcm, ac3, aac, etc.
num-channels The number of channels, including 1, 2, .. 16
sample-rate The sampling rate, including 32000, 44100, etc.
bit-count The bit rate, including 16, 20, 24, etc.
HDMI Signal Status (hdmi-info:{...})
"hdmi-info": {
  "mode": "hdmi",
  "hdcp": "none",
  "vic": 0,
  "it-content": false,
  "pixel-rate": "148MHz",
  "timing-htotal": 2200,
  "timing-hactive": 1920,
  "timing-h-front-porch": 88,
  "timing-h-synct-width": 44,
  "timing-h-back-porch": 148,
  "timing-vtotal": 1125,
  "timing-vactive": 1080,
  "timing-v-front-porch": 4,
  "timing-v-synct-width": 5,
  "timing-v-back-porch": 36
}
Name Description
mode The signal mode, including HDMI and DVI
vic The video identification code
scramble Whether to scramble to prevent signal parsing problems. If yes, it shows true; otherwise, it is false.
clock-ratio The CPU clock ratio multiplication, including 1 and 4
hdcp The HDCP encryption mode, including none, hdcp-1.x and hdcp-2.2
repeat-count The repeat count, including 0, 1, 2, 4, etc.
it-content The IT content identifier
If yes, it shows true; otherwise, it is false.
timing-mode-line The modeline
Format: pclk hdisp hsyncstart hsyncend htotal vdisp vsyncstart vsyncend vtotal [flags]
flags: +hsync, -hsync, +vsync, -vsync, interlace, double-scan, sog, +csync, -csync
Example: 23.86 640 656 720 800 480 481 484 497 -hsync +vsync
The unit of pclk is MHz, and that of other parameters is in pixels.
Information Frame (info-frames:{...})
"info-frames": [
  {
    "id": "AVI"、     
    "type": 130,
    "version": 2,
    "length": 13,
    "checksum": 96,
    "data": "ACgAIgAAADkEAACBBw=="
  },
  {
    "id": "SPD",
    "type": 132,
    "version": 1,
    "length": 25,    //bytes
    "checksum": 112,
    "data": "AQAAAAAAAAAAAA=="
  }
]
Name Description
id The information frame name, including AVI, SPD, etc.
type The packet type
version The packet version
length The packet length
checksum The packet checksum
data The data is encoded in Base64 and displayed in hex.

results matching ""

    No results matching ""

    results matching ""

      No results matching ""