get-summary-info 接口
获取设备状态信息,包括设备基本信息、以太网状态、USB Net状态。
请求方式
POST http://ip/mwapi/get-summary-info
返回数据
JSON 结构如下:
{
"status": 0,
"device": {...},
"wifi": {...},
"ethernet": {...},
"rndis": {...},
"out": {...}
}
1. 返回状态
"status": 0
属性 |
说明 |
status |
返回状态。0:请求成功,返回其它值请参考 API 状态码。 |
2. 设备基本信息 (device {...})
"device": {
"name": "USB Presenter",
"model": "HDMI 2K Plus",
"serial-no": "B401180706020",
"hw-revision": "B",
"fw-version": "1.1.72",
"up-to-date": true,
"input-hdmi-1-state": "1920x1080p60",
"input-hdmi-2-state": "no-signal",
"input-web-camera-state": "1280x720p30",
"hdmi-output-mode": 0,
"hdmi-output-state": "unconnected",
"cpu-usage": 5.00,
"memory-usage": 58.33,
"core-temp": 46.76,
"up-time": 8006,
"storage-size": 0,
"fan-rpm": 0
}
属性 |
说明 |
name |
产品族名称。 |
model |
产品型号,如 HDMI 2K Plus... |
serial-no |
设备序列号。 |
hw-version |
硬件版本号,有效值:A ~ Z。 |
fw-version |
当前设备固件版本号。 |
up-to-date |
当前设备固件版本是否最新。是则显示 true,否则显示 false。 |
input-hdmi-1-state |
HDMI 1 接口输入信号状态,有效值:no-signal、locking、unsupported 或实际值,如:1920x1080p60。 |
input-hdmi-2-state |
HDMI 2 接口输入信号状态,有效值:no-signal、locking、unsupported 或实际值,如:1920x1080p60。 |
input-web-camera-state |
WEB CAMERA 接口输入信号状态,有效值:no-signal、unsupported 或实际值,如:1920x1080p60。 |
hdmi-out-mode |
输出信号模式,有效值:0、1、2, 分别代表 loopthru HDMI 1, loopthru HDMI 2, pgm。 |
hdmi-out-state |
输出信号状态,有效值:unconnected、unsupported、active。 |
cpu-usage |
CPU 使用率。 |
memory-usage |
内存使用率。 |
core-temp |
当前设备芯片的温度 (℃)。 |
up-time |
距离设备上次启动的时长 (s)。 |
storage-size |
存储容量 (MB)。 |
fan-rpm |
当前每分钟风扇转速。 |
3. 无线网络状态信息 (wifi {...})
"wifi": {
"state": "magewell-001",
"mac-addr": "70:B3:D5:75:D2:41",
"ip-addr": "0.0.0.0",
"ip-mask": "0.0.0.0",
"gw-addr": "0.0.0.0",
"dns-addr": "0.0.0.0",
"tx-speed-kbps": 0,
"rx-speed-kbps": 0
}
属性 |
说明 |
state |
WiFi连接状态,有效值:down、disconnected。 |
mac-addr |
MAC 地址。 |
ip-addr |
Wifi IP 地址。 |
ip-mask |
子网掩码地址。 |
gw-addr |
网关地址。 |
dns-addr |
DNS 服务器地址。 |
tx-speed-kbps |
Wifi发送速度 (Kbps)。 |
rx-speed-kbps |
Wifi接收速度 (Kbps)。 |
4. 以太网状态信息 (ethernet {...})
"ethernet": {
"state": "disconnected",
"mac-addr": "70:B3:D5:75:D2:41",
"ip-addr": "0.0.0.0",
"ip-mask": "0.0.0.0",
"gw-addr": "0.0.0.0",
"dns-addr": "0.0.0.0",
"tx-speed-kbps": 0,
"rx-speed-kbps": 0
}
属性 |
说明 |
state |
以太网连接状态,有效值:down、disconnected、10m、100m、1000m、2500m、5000m、10000m。 |
mac-addr |
MAC 地址。 |
ip-addr |
以太网 IP 地址。 |
ip-mask |
子网掩码地址。 |
gw-addr |
网关地址。 |
dns-addr |
DNS 服务器地址。 |
tx-speed-kbps |
以太网发送速度 (Kbps)。 |
rx-speed-kbps |
以太网接收速度 (Kbps)。 |
5. USB RNDIS 状态信息 (rndis {...})
"rndis": {
"state": "high-speed",
"ip-addr": "192.168.66.1",
"tx-speed-kbps": 0,
"rx-speed-kbps": 0
}
属性 |
说明 |
state |
USB 连接状态,有效值:disconnected、full-speed、high-speed、super-speed-5g、super-speed-10g。 |
ip-addr |
USB RNDIS 地址。 |
tx-speed-kbps |
通过 USB RNDIS 发送数据速率 (Kbps)。 |
rx-speed-kbps |
通过 USB RNDIS 接收数据速度 (Kbps)。 |
6. USB OUT 状态信息 (out {...})
"out": {
"video-format": "NV12",
"connection": "USB 3.0",
"audio-drop-frames": 0,
"video-drop-frames": 0,
"video-width": 1920,
"video-height": 1080,
"video-scan": "progressive",
"video-field-rate": 0.00,
"audio-num-channels": 2,
"audio-sample-rate": 48000,
"audio-bit-count": 16
}
属性 |
说明 |
video-format |
UVC 视频输出格式, 可能为 NV12, YUYV, MJPEG 等。 |
connection |
usb连接状态, "USB 3.0", "USB 2.0", "disable"。 |
audio-drop-frames |
前一秒音频丢帧数。 |
audio-num-channels |
音频通道总数。 |
audio-sample-rate |
音频采样率,包括 32000、44100 等。 |
audio-bit-count |
音频比特率,包括 16、20、24 等。 |
video-drop-frames |
前一秒的视频丢帧数。 |
video-bit-rate |
前一秒的视频编码速率 (Kbps)。 |
video-width |
视频宽度,总像素数。 |
video-height |
视频高度,总像素数。 |
video-scan |
扫描方式:progressive、interlaced、psf。 |
video-field-rate |
帧率,包括 24、25、29.97、30、48、50、59.94、60。 |