在线手册

FLEX-16pro-cn

3.3.4 中控协议

本系统支持HTTP和串口两种中控方式。

HTTP中控方式

HTTP端口:80。

不支持keep-alive模式。

若非特殊说明,下面接口中POST或者GET的URL均为: http://主机ip地址/index2.html

登录

Request typePOST
ContentJson: { "Command" : "Login", "UserName" : "用户名", "Password" : "密码的MD5字符串" }
ResponseJson: { "Status" : "Ok"/"Error", "SessionId" : 本次登录的会话id, -- 在status为ok的时候有效 "ScreenGroup" : [屏幕分组权限,1表示可以操作,0表示不可以操作], "Message" : "错误信息" }
🚨  注意:会话id必须保存下来供后面使用

获取主机场景列表

该命令获取由ScreenGroup指定的屏幕分组相对应的场景列表

Request typeGET
Header包含session_id=会话id
ContentCommand=GetAllModal&ScreenGroup=屏幕分组序号(1~4)
ResponseJson: { "Status":"Ok"/"Error", "ModalList":["场景名", "场景名", …] }

获取主机场景缩略图

Request typeGET
URLhttp://xxx.xxx.xxx.xxxx/场景名.jpg
Header包含session_id=会话id
Response图片数据

切换场景

Request typePOST
Header包含session_id=会话id
ContentJson: { "Command" : " LoadModal", "ScreenGroup" : 屏幕分组序号(1~4), "ModalName" : "场景名称" }
ResponseJson: { "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码。

串口命令

获取主机场景列表

中控命令:

Op1
Scr一个字节,取值1到4,指定屏幕分组的序号
DATA无
应用示例:获取屏幕分组一的场景:$11^ 获取屏幕分组二的场景:$12^ 获取屏幕分组三的场景:$13^ 获取屏幕分组四的场景:$14^

设备响应:

Op1
DATA以空格隔开的多个场景名称(UTF8格式)。例如: 场景一 场景二

获取当前窗口列表

中控命令:

Op2
Scr一个字节,取值1到4,指定屏幕分组的序号。
DATA无
应用示例:获取屏幕分组一的窗口列表:$21^ 获取屏幕分组二的窗口列表:$22^ 获取屏幕分组三的窗口列表:$23^ 获取屏幕分组四的窗口列表:$24^

设备响应:

Op2
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]

切换场景

中控命令:

Op3
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

设备响应:

Op3
DATAOk或者Error

窗口信号源开窗

中控命令:

Op4
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

设备响应:

Op4
DATAOk或者Error

切换窗口信号源

中控命令:

Op5
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

设备响应:

Op5
DATAOk或者Error

获取处理器IP

中控命令:

Op6
Scr无
DATA无
应用示例:$6^

设备响应:

Op6
DATA处理器IP。例如: IP:[192.168.1.250]

设置处理器IP地址

中控命令:

Op7
Scr无
DATAIP地址
应用示例:设置处理器IP地址为192.168.1.200:$7192.168.1.200^

设备响应:

Op7
DATAOk或者Error

复位处理器

中控命令:

Op8
Scr无
DATA无
应用示例:$8^

设备响应:

Op8
DATAOk或者Error,复位成功后重启处理器生效

切换音频通道

中控命令:

Op9
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

设备响应:

Op9
DATAOk或者Error

关闭窗口

中控命令:

Op0
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

设备响应:

Op0
DATAOk或者Error

移动窗口

中控命令:

Opa
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

设备响应:

Opa
DATAOk或者Error