在线手册
FLEX-16pro-cn
2.2.2 中控协议
本系统支持HTTP和串口两种中控方式。
HTTP中控方式
HTTP端口:80。
不支持keep-alive模式。
若非特殊说明,下面接口中POST或者GET的URL均为: http://主机ip地址/index2.html
登录
| Request type | POST |
|---|---|
| Content | Json: { "Command" : "Login", "UserName" : "用户名", "Password" : "密码的MD5字符串" } |
| Response | Json: { "Status" : "Ok"/"Error", "SessionId" : 本次登录的会话id, -- 在status为ok的时候有效 "ScreenGroup" : [屏幕分组权限,1表示可以操作,0表示不可以操作], "Message" : "错误信息" } |
🚨 注意:会话id必须保存下来供后面使用
获取主机场景列表
该命令获取由ScreenGroup指定的屏幕分组相对应的场景列表
| Request type | GET |
|---|---|
| Header包含 | session_id=会话id |
| Content | Command=GetAllModal&ScreenGroup=屏幕分组序号(1~4) |
| Response | Json: { "Status":"Ok"/"Error", "ModalList":["场景名", "场景名", …] } |
获取主机场景缩略图
| Request type | GET |
|---|---|
| URL | http://xxx.xxx.xxx.xxxx/场景名.jpg |
| Header包含 | session_id=会话id |
| Response | 图片数据 |
切换场景
| Request type | POST |
|---|---|
| Header包含 | session_id=会话id |
| Content | Json: { "Command" : " LoadModal", "ScreenGroup" : 屏幕分组序号(1~4), "ModalName" : "场景名称" } |
| Response | Json: { "Status" : "Ok"/"Error", "Message" : "错误信息" } |
串口中控方式
串口配置
波特率:9600
奇偶校验:无
流量控制:无
数据位:8
停止位:1
如使用RJ45网线连接处理器串口,则网线1号是我们的TX,2号是我们的RX,6号是我们的GND,其他线断开。RJ45对应线序图如下:

如使用DB9串口线连接处理器串口,则3号脚是我们的TX,2号脚是我们的RX,5号脚是我们的GND。DB9引脚定义如下:

包格式
中控发给设备的命令,以及设备发给中控的响应,都被封装成数据包,每个数据包以$字符开始,^字符结束,如下图所示:
Op表示操作命令,一个字符。
Scr表示要操作的屏幕分组序号,一个字符。
处理器中控支持字符串指令和16进制指令,中控设备发送字符串指令或16进制指令至处理器均可处理,16进制指令即为字符串的ASCII码。
串口命令
获取主机场景列表
中控命令:
| Op | 1 |
|---|---|
| Scr | 一个字节,取值1到4,指定屏幕分组的序号 |
| DATA | 无 |
| 应用示例: | 获取屏幕分组一的场景:$11^ 获取屏幕分组二的场景:$12^ 获取屏幕分组三的场景:$13^ 获取屏幕分组四的场景:$14^ |
设备响应:
| Op | 1 |
|---|---|
| DATA | 以空格隔开的多个场景名称(UTF8格式)。例如: 场景一 场景二 |
获取当前窗口列表
中控命令:
| Op | 2 |
|---|---|
| Scr | 一个字节,取值1到4,指定屏幕分组的序号。 |
| DATA | 无 |
| 应用示例: | 获取屏幕分组一的窗口列表:$21^ 获取屏幕分组二的窗口列表:$22^ 获取屏幕分组三的窗口列表:$23^ 获取屏幕分组四的窗口列表:$24^ |
设备响应:
| Op | 2 |
|---|---|
| DATA | 以中括号间隔的多个窗口信息,窗口信息内容格式为[窗口ID,窗口左上角X起始坐标,窗口左上角Y起始坐标,窗口右下角X截止坐标,窗口右下角Y截止坐标]。例如: 2[21326,0,0,960,540][25588,960,0,1920,540][21456,1920,0,2880,540][8192,2880,0,3840,540]...[26424,4800,8100,5760,8640][13336,5760,8100,6720,8640][9651,6720,8100,7680,8640] |
切换场景
中控命令:
| Op | 3 |
|---|---|
| Scr | 一个字节,取值1到4,指定屏幕分组的序号 |
| DATA | 场景名称(UTF8格式) |
| 应用示例: | 切换屏幕分组一的"场景五":$31场景五^ 切换屏幕分组二的"ab":$32ab^ 切换屏幕分组三的"123ab":$33123ab ^ 切换屏幕分组四的"场景6a":$34场景6a ^ 场景名称"1"代码:24 33 31 31 5E 场景名称"2"代码:24 33 31 32 5E 场景名称"3"代码:24 33 31 33 5E |
设备响应:
| Op | 3 |
|---|---|
| DATA | Ok或者Error |
窗口信号源开窗
中控命令:
| Op | 4 |
|---|---|
| Scr | 一个字节,取值1到4,指定屏幕分组的序号 |
| DATA | [窗口ID][输入槽位号1-16][输入端口号1-8][窗口左上角X起始坐标,窗口左上角Y起始坐标,窗口右下角X截止坐标,窗口右下角Y截止坐标] 窗口ID需为大于等于1的整数,ID具体唯一性,多个窗口的ID不能重复 |
| 应用示例: | 信号源开窗指令示例如下: 将第2个输入槽位的第3路输入开在分组1上,窗口ID为2,坐标为1920,1080,3840,2160:$41[2][2][3][1920,1080,3840,2160]^ 将第2个输入槽位的第3路输入开在分组1上,窗口ID为2,坐标为1920,1080,3840,2160的16进制代码:24 34 31 5B 32 5D 5B 32 5D 5B 33 5D 5B 31 39 32 30 2C 31 30 38 30 2C 33 38 34 30 2C 32 31 36 30 5D 5E |
设备响应:
| Op | 4 |
|---|---|
| DATA | Ok或者Error |
切换窗口信号源
中控命令:
| Op | 5 |
|---|---|
| Scr | 一个字节,取值1到4,指定屏幕分组的序号 |
| DATA | [窗口ID][输入槽位号1-16][输入端口号1-8] 窗口ID可以通过获取当前窗口列表接口读取 |
| 应用示例: | 切换窗口信号源指令示例如下: 将第2个输入槽位的第3路输入切换到屏幕分组1上ID为21326的窗口:$51[21326][2][3]^ 将第2个输入槽位的第3路输入切换到屏幕分组1上ID为21326的窗口的16进制代码: 24 35 31 5B 32 31 33 32 36 5D 5B 32 5D 5B 33 5D 5E |
设备响应:
| Op | 5 |
|---|---|
| DATA | Ok或者Error |
获取处理器IP
中控命令:
| Op | 6 |
|---|---|
| Scr | 无 |
| DATA | 无 |
| 应用示例: | $6^ |
设备响应:
| Op | 6 |
|---|---|
| DATA | 处理器IP。例如: IP:[192.168.1.250] |
设置处理器IP地址
中控命令:
| Op | 7 |
|---|---|
| Scr | 无 |
| DATA | IP地址 |
| 应用示例: | 设置处理器IP地址为192.168.1.200:$7192.168.1.200^ |
设备响应:
| Op | 7 |
|---|---|
| DATA | Ok或者Error |
复位处理器
中控命令:
| Op | 8 |
|---|---|
| Scr | 无 |
| DATA | 无 |
| 应用示例: | $8^ |
设备响应:
| Op | 8 |
|---|---|
| DATA | Ok或者Error,复位成功后重启处理器生效 |
切换音频通道
中控命令:
| Op | 9 |
|---|---|
| Scr | 无 |
| DATA | [输入槽位号1-16][输入端口号1-8] |
| 应用示例: | 关闭音频输入,需要将输入槽位号和输入端口号都设为0。 切换音频通道指令示例如下: 切换为第2个输入槽位的第3路输入的音频通道:$9[2][3]^ 关闭音频输入:$9[0][0]^ 切换为第2个输入槽位的第3路输入的音频通道的16进制代码: 24 39 5B 32 5D 5B 33 5D 5E 关闭音频输入的16进制代码为:24 39 5B 30 5D 5B 30 5D 5E |
设备响应:
| Op | 9 |
|---|---|
| DATA | Ok或者Error |
关闭窗口
中控命令:
| Op | 0 |
|---|---|
| Scr | 一个字节,取值1到4,指定屏幕分组的序号 |
| DATA | [窗口ID] 窗口ID可以通过获取当前窗口列表接口读取 |
| 应用示例: | 关闭当前分组所有的窗口,需要将窗口ID设为0。 关闭窗口指令示例如下: 关闭分组2窗口ID为1的窗口:$02[1]^ 关闭分组1所有窗口:$01[0]^ 关闭分组2窗口ID为1的窗口的16进制代码: 24 30 32 5B 31 5D 5E 关闭分组1所有窗口的16进制代码为:24 30 31 5B 30 5D 5E |
设备响应:
| Op | 0 |
|---|---|
| DATA | Ok或者Error |
移动窗口
中控命令:
| Op | a |
|---|---|
| Scr | 一个字节,取值1到4,指定屏幕分组的序号 |
| DATA | [窗口ID] [窗口左上角X起始坐标,窗口左上角Y起始坐标,窗口右下角X截止坐标,窗口右下角Y截止坐标] 窗口ID可以通过获取当前窗口列表接口读取 0509点对点模式不支持窗口操作 |
| 应用示例: | 移动窗口指令示例如下: 移动分组1窗口ID为1的窗口至起始坐标为1920、1080,截止坐标为3840、2160:$a1[1][1920,1080,3840,2160]^ 移动分组1窗口ID为1的窗口至起始坐标为1920、1080,截止坐标为3840、2160的16进制代码: 24 61 31 5B 31 5D 5B 31 39 32 30 2C 31 30 38 30 2C 33 38 34 30 2C 32 31 36 30 5D 5E |
设备响应:
| Op | a |
|---|---|
| DATA | Ok或者Error |