VWAS6.0 中控协议
Copyright © 2005-2016 Vtron Group Co.,Ltd.
中控设备通信协议
(配套 VWAS6.0 标准版)
威创集团股份有限公司
2016-04-12
1 / 47
VWAS6.0 中控协议
Copyright © 2005-2016 Vtron Group Co.,Ltd.
版本修订批准记录
【历次版本修订记录,版本修订描述重要说明】
版本修订描述
6.0 中控协议初稿,同 VWAS5.5 中控协议
整理中控协议,生成 WORD 版,增加窗口的显示,隐藏协议,
修改开窗协议,开窗时可以支持显示或者隐藏属性
针对 VWAS6.0,增加可视信号源预览协议
修改获取信号源清单协议,增加HDMI,YPBPR,
DP,DUALLINK,SDI,APP六种信号源类型
增加设置整墙光学模式,获取整墙光学模式,获取支持光学
模式,获取光机状态命令
修改中控服务启动整墙回显回码协议
增加按照窗口位置(象素式)和信号源名称替换信号源命令
(命令码:0x42)
根据VWAS5.5中控协议文档,修改VWAS6.0中控协议,使所有
命令码和回码都相同
根据北京高法非标需求,增加执行模式不返回窗口信息协议
(命令码:0x3e)
根据测试核对的5.5同6.0协议差异,对差异部分添加说明
增加两条协议:1)多墙批量开关窗协议(命令码:0x43)2)
查询中控服务支持的命令码协议(命令码:0x44)
提交日期
2013-6-27
版本号
V1.0
2013-8-8
2013-8-12
V1.1
V1.2
2014-02-18
V1.4
2014-06-27
2014-09-22
V1.5
V1.6
2014-10-11
V1.7
2014-10-30
V1.8
2014-11-25
2015-02-09
V1.9
V2.0
2016-04-12
V2.1
增加获取多功能设备在线状态协议(命令码:0x45)
2 / 47
VWAS6.0 中控协议
Copyright © 2005-2016 Vtron Group Co.,Ltd.
目录
功能 ............................................................................................................................................... - 6 -
选择想要控制的显示墙 .................................................................................................................. - 6 -
打开显示墙机芯 .............................................................................................................................. - 6 -
关闭显示墙机芯 .............................................................................................................................. - 6 -
获取模式列表 .................................................................................................................................. - 6 -
预览模式 .......................................................................................................................................... - 6 -
调用模式 .......................................................................................................................................... - 7 -
给模式内窗口换信号 ...................................................................................................................... - 7 -
更换模式 .......................................................................................................................................... - 7 -
获取信号源清单 .............................................................................................................................. - 7 -
给设备切换信号(不指定通道) .................................................................................................. - 7 -
打开设备 .......................................................................................................................................... - 8 -
关闭设备 .......................................................................................................................................... - 8 -
枚举指定显示墙窗口(返回单元编号) ........................................................................................... - 8 -
获取多功能设备列表 ...................................................................................................................... - 8 -
关闭模式 .......................................................................................................................................... - 8 -
打开窗口(根据屏号) .................................................................................................................. - 8 -
关闭窗口(根据屏号) .................................................................................................................. - 9 -
关闭所有窗口 .................................................................................................................................. - 9 -
枚举显示墙名称 .............................................................................................................................. - 9 -
获取显示墙行列数和单屏分辨率 .................................................................................................. - 9 -
打开窗口(通过像素坐标) ............................................................................................................... - 9 -
关闭窗口(通过句柄) ....................................................................................................................... - 9 -
预览模式(返回坐标) ..................................................................................................................... - 10 -
调用模式(返回坐标) ..................................................................................................................... - 10 -
枚举指定显示墙窗口(返回坐标) ................................................................................................. - 10 -
枚举多功能设备列表(包含信道信息) ......................................................................................... - 10 -
给设备切换信号(切换到指定通道) .............................................................................................. - 10 -
移动窗口与缩放窗口(通过像素坐标) .................................................................................... - 10 -
批量开窗 ........................................................................................................................................ - 11 -
根据窗口位置和信号源名称更换信号源 (单元式) ............................................................... - 11 -
批量关窗 ........................................................................................................................................ - 11 -
设置窗口风格(显示,隐藏)(仅适用 VWAS6.0) .................................................................. - 11 -
设置(当前墙)光学模式 ............................................................................................................ - 11 -
获取(当前墙)光学模式 ............................................................................................................ - 11 -
获取支持的光学模式 .................................................................................................................... - 11 -
获取被操作光机的状态信息 ........................................................................................................ - 12 -
调用模式(不返回窗口信息) ......................................................................................................... - 12 -
根据窗口位置和信号源名称更换信号源 (象素式) ............................................................... - 12 -
多墙批量开关窗操作(象素坐标) ............................................................................................ - 12 -
查询中控服务支持的命令码 ........................................................................................................ - 12 -
3 / 47
VWAS6.0 中控协议
Copyright © 2005-2016 Vtron Group Co.,Ltd.
获取多功能设备在线状态 ............................................................................................................ - 12 -
协议 ............................................................................................................................................. - 13 -
选择想要控制的显示墙 ................................................................................................................ - 13 -
打开显示墙机芯 ............................................................................................................................ - 14 -
关闭显示墙机芯 ............................................................................................................................ - 14 -
获取模式列表 ................................................................................................................................ - 15 -
模式预览(返回单元) ................................................................................................................ - 15 -
调用模式 ........................................................................................................................................ - 16 -
给模式内窗口换信号 .................................................................................................................... - 17 -
更改模式 ........................................................................................................................................ - 17 -
获取信号源清单 ............................................................................................................................ - 18 -
给设备切换信号(不指定通道) ................................................................................................ - 19 -
打开设备 ........................................................................................................................................ - 19 -
关闭设备 ........................................................................................................................................ - 20 -
枚举指定显示墙窗口(返回单元编号) ......................................................................................... - 20 -
枚举多功能设备列表 .................................................................................................................... - 22 -
关闭模式 ........................................................................................................................................ - 22 -
打开窗口(根据屏号) ..................................................................................................................... - 23 -
关闭窗口(根据屏号) ..................................................................................................................... - 23 -
关闭所有窗口 ................................................................................................................................ - 24 -
枚举显示墙名称 ............................................................................................................................ - 24 -
获取显示墙行列数及单屏分辨率 ................................................................................................ - 25 -
打开窗口(通过像素坐标) ............................................................................................................. - 26 -
关闭窗口(通过句柄) ..................................................................................................................... - 26 -
模式预览(返回坐标) ..................................................................................................................... - 27 -
调用模式(返回坐标) ..................................................................................................................... - 28 -
枚举指定显示墙窗口(返回坐标) ................................................................................................. - 28 -
枚举多功能设备(包含信道列表) ................................................................................................. - 30 -
给设备切换信号(切换到指定通道) ............................................................................................. - 32 -
移动窗口与缩放窗口(通过像素坐标) .................................................................................... - 32 -
批量开窗 ........................................................................................................................................ - 33 -
根据窗口位置和信号源名称更换信号源(单元式) ................................................................ - 33 -
设置窗口风格(显示,隐藏) .................................................................................................... - 34 -
批量关窗 ........................................................................................................................................ - 34 -
设置(当前墙)光学模式 ............................................................................................................ - 35 -
获取(当前墙)光学模式 ............................................................................................................ - 35 -
获取支持的光学模式 .................................................................................................................... - 36 -
获取光机的状态 ............................................................................................................................ - 36 -
调用模式(不返回窗口信息) ......................................................................................................... - 38 -
根据窗口位置和信号源名称更换信号源(象素式) ................................................................ - 39 -
多墙批量开关窗操作(象素坐标) ............................................................................................ - 39 -
查询中控服务支持的命令码 ........................................................................................................ - 41 -
获取多功能设备在线状态 ............................................................................................................ - 41 -
4 / 47
VWAS6.0 中控协议
Copyright © 2005-2016 Vtron Group Co.,Ltd.
示例 ............................................................................................................................................. - 42 -
打开指定显示墙上的机芯 02(第 0 行,第 2 列) .................................................................. - 42 -
打开所有机芯 ................................................................................................................................ - 43 -
关闭所有机芯 ................................................................................................................................ - 44 -
调用模式 ........................................................................................................................................ - 45 -
附录 ............................................................................................................................................. - 47 -
错误码详细(VWAS6.0 新增) .................................................................................................... - 47 -
5 / 47
VWAS6.0 中控协议
Copyright © 2005-2016 Vtron Group Co.,Ltd.
功能
VWAS 需提供串口和网络 TCP 两种方式与中控设备通信,每种方式仅满足一个客户使用,多
个中控设备通过一个中控设备主机与 VWAS 通信,采用典型的 C/S 架构。
选择想要控制的显示墙
为了支持多个墙,在中控设备进行下面的各种操作之前需要调用此命令通知VWAS当前控制
的是哪一个墙,如果不发送此命令,则VWAS默认为第一个墙。下面所有的操作都是针对此
此命令所选择的墙,如果没有选择就是针对第一个墙(如果有多个墙的话)。
参数:想要控制的显示墙名称
返回:成功或失败
打开显示墙机芯
参数:显示单元的行和列数值,也可以打开所有机芯
返回:成功或失败。
关闭显示墙机芯
参数:显示单元的行和列数值,也可以关闭所有机芯
返回:成功或失败。
获取模式列表
参数:无
返回:所有模式名称的列表,目前中控设备只支持英文字符,即在有中控设备的情况下,
VWAS中的模式名称推荐只使用英文。
预览模式
参数:给定的模式名称
6 / 47
VWAS6.0 中控协议
Copyright © 2005-2016 Vtron Group Co.,Ltd.
返回:模式中包含的所有窗口位置(左上角显示单元行列值序号,窗口所占屏数)、窗
口信号源名称。
调用模式
参数:给定的模式名称
返回:模式结果,包括模式内窗口的句柄(一个unsigned long数字表示),窗口位置(左
上角显示单元行列值序号,窗口所占屏数)、窗口信号源名称。
给模式内窗口换信号
参数:给定的窗口句柄和信号源名称。
返回:新的窗口句柄
更换模式
参数:给定的模式名称
返回:模式中包含的所有窗口位置(左上角显示单元和右下角显示单元表示)、窗口信
号源名称。
获取信号源清单
参数:类型(计算机信号、视频信号或音频信号)
返回:指定类型的信号源名称列表,,目前中控设备只支持英文字符,即在有中控设备
的情况下,VWAS中的信号源名称只能使用英文。
给设备切换信号(不指定通道)
包括计算机信号、视频信号和音频信号,VWAS为其切换矩阵和切换设备通道。 由于中控
设备需要预先定义设备的布局,所以设备名称应由中控设备预先设置,而VWAS需要保持设
备资源名称与中控设备完全相同。
参数:设备名称,信号源名称
返回:成功、失败。
7 / 47
VWAS6.0 中控协议
Copyright © 2005-2016 Vtron Group Co.,Ltd.
打开设备
参数:设备名称
返回:成功、失败。
关闭设备
参数:设备名称
返回:成功、失败。
枚举指定显示墙窗口(返回单元编号)
参数:显示墙名称
返回:成功、失败。以及当前墙内所有窗口的行列值序号,所占屏数,信号源名称
获取多功能设备列表
参数:无
返回:所有多功能设备名称的列表。
关闭模式
参数:给定的模式名称
返回:成功、失败。
打开窗口(根据屏号)
参数:给定的显示墙名称、信号源名称、窗口类型、窗口所占的左上角点屏编号和右下
角点屏编号、窗口显示,隐藏
返回:成功、失败。若成功返回窗口句柄
8 / 47