一、中控概况
1.1 中控概念
中控即为中央控制系统。
中控系统是指对声、光、电等各种设备进行集中控制的设备。用户可通过计算机和中央控制系统软件控制投影机、展示台、视频会议终端、卡座、功放、话筒、计算机、笔记本、电动屏幕、电动窗帘、灯光等设备。
亿联视频会议提供API接口,中控系统可以调用API接口来控制视频会议的拨号、会议控制、摄像头调整、音量大小等通过功能,实现遥控器上大部分功能。
二代和三代终端中控API文档参考:《Yealink中控控制API指令说明文档V1.09》
MeetingEye500和IWB中控API文档参考:《中控API说明文档V1.0》
1.2 中控介绍
中控特点:可灵活编程,反馈处理:比如收到A接口命令,向B接口发送对应控制命令
----如:iPad app通过网络,点击打开灯光按钮,中控通过IO控制会议室灯光打开
----如:iPad app通过网络,点击关闭系统,中控通过串口控制 时序电源 分别关闭 功放,调音台
二、终端对接中控
2.1 终端后台设置
1.删除安全控制密码 (如果中控需要校验则设置安全控制密码,如果不需要删除安全控制密码即可,且需保证安全控制为启用状态)
2.安全控制TCP端口为6024(网络连接端口)
3.配置与中控相同的参数(波特率、数据位、奇偶校验位、结束位)
2.2 码流——标准协议
亿联硬件终端VCS2.0及以上版本支持三种协议 pelcoD、pelcoP、visca,三种协议均可直接控制终端。此三种方式均使用十六进制(Hex)发送,无需换行。
会议主机也是通过标准协议来进行预置位的调用,保证会议主机发出的编码符合这三类协议,且其中不能掺杂其他字符串。若对接会议主机失败,可以参考故障排查内容。
2.3 码流——API指令
2.3.1 普通终端API
亿联硬件终端VCS2.0及以上版本支持使用API指令进行控制。API指令使用时,若使用ASCII发送,则需要添加回车换行(Enter 或 \r\n) 。
指令基本格式:
1> Command (无参数类型)
2> Command+空格+param1 (带一个参数类型)
3> Command + 空格 + param1 + 空格 + param2 + 空格 + … +空格 + pa
按键1:button 1
调用预设位1: preset near go 1
摄像机左转: camera near move left
对接中控优先建议使用ASCII发送API命令形式对接
2.3.2 多模终端API
共9个语法,29条指令,主要内容是camera语法和audio语法
Camera:控制摄像头移动,控制焦距,获取/设置摄像头位置,获取摄像头列表和详细信息,设置AI模式,设置/应用预设位
Audio:设置音频输入输出,获取/设置静音状态,获取/设置音量
2.4 TCP/IP控制
串口调试助手:见底部附件serial_port_utility_latest.exe
Yealink VCS2.0 设备支持网络模式对主机设备进行控制,采用TCP协议建立连接,客户端需要知道主机的ip地址和端口号才能连接主机端。 以下是网络模式需要配置的参数:
1> 中控的网络模式的控制端口配置为:6024
2> IP地址可以根据实际情况查看即可。
使用串口调试工具,确认填写正确后点击连接即可收到响应信息
若使用十六进制(Hex),则需要先将ASCII转换为Hex后,再加上0D 0A(数字零),代表回车换行,无需再额外换行。基本所有中控都支持采用十六进制对接
有些中控支持ASCII,但却无法直接回车。所以也可以采用两者混合的形式来进行编写,回车换行用0D0A代替。
例如:button1\x0D\x0A
2.5 RS232串口控制
2.5.1 线材介绍
2.5.2 线材连接
优先建议终端使用USB-RS232直接连接到中控,减少转接
2.5.3 串口工具模拟
首先确保电脑可以识别串口,若无法识别则需先安装PL2303驱动,可以从 我的电脑-右键-管理-设备管理-端口查看,如果驱动正常,就能看到有个端口一行,显示COMX
三、故障排查
若连接设置完毕后,依旧无法成功控制终端,可进行交叉测试:
①检测中控是否输出控制指令到终端:
将连接在终端USB的线直接接至电脑USB口。
右键此电脑,点击管理-设备管理器-串口,检查是否出现一条以COMX结尾的串口信息。
打开串口调试工具连接该串口,端口为设备管理器查看到的端口,波特率为115200(可变),数据位8,奇偶校验none,停止位1,流控制可保持默认也可不勾选。
正常结果:电脑串口工具可通过RS232接收到来自中控发送的指令。
连接方式:中控主机-RS232-USB-(原终端)电脑
②检测终端是否可以正常接收指令:
将连接在会议主机的RS232断开,通过RS232转USB,连接到电脑,重复上面操作至电脑可以正常通过RS232连接到终端。
电脑发送相应的控制指令到终端,观察终端是否可以正常完成操作指令。
正常结果:电脑串口工具可通过RS232控制终端。
连接方式:电脑(原中控)-USB-RS232-USB-终端
其他原因:
1.线材连接问题(交叉直通错误、线材连接错误等)
2.中控的数据与终端不匹配(波特率等)
3.发送数据异常(缺少回车换行、命令错误等)
4.USB口故障,可尝试更换终端其他USB口
四、UVC对接中控
中控对接UVC摄像头,实质是通过YRC软件进行控制,类似于VCS主机的TCP/IP控制,中控端需要知道主机(即PC)的IP地址和端口号才能连接到主机端。对于网络模式,需要配置以下参数:
1.中心控制的网络模式的控制端口配置为:6024
2.根据实际情况查看PC的IP地址。
语法以及格式都与终端的API指令相同,不再赘述
YRC及UVC版本要求、详细API指令可以参考Camera Control API
YRC中需要在设备设置里关闭智能取景功能,否则设备不可控
API指令设置预设位成功之后在YRC里查看不到,YRC中依旧显示预设位是空的,这是两套独立的逻辑。
YRC设置预设位的数量为9,可以查看指令参数
附录
Pelco-D 协议
Pelco-D 协议
具体指令
指令含义
ff01000800ff08
上移指令
ff01001000ff10
下移指令
ff010004ff0004
左移指令
ff010002ff0002
右移指令
ff010080000081
聚焦近指令
ff010100000002
聚焦远指令
ff010007000008
转至预置点0
ff010007000109
转至预置点1
ff01000700020a
转至预置点2
ff01000700030b
转至预置点3
ff01000700040c
转至预置点4
ff01000700050d
转至预置点5
ff010003000004
设置预置点0
ff010003000105
设置预置点1
ff010003000206
设置预置点2
ff010003000307
设置预置点3
ff010003000408
设置预置点4
ff010003000509
设置预置点5
ff010005000006
删除预置点0
ff010005000107
删除预置点1
ff010005000208
删除预置点2
ff010005000309
删除预置点3
ff01000500040a
删除预置点4
ff01000500050b
删除预置点5
ff010000000001
停止指令
Pelco-P协议
Pelco-P 协议
具体指令
指令含义
a00100080030af39
上移指令
a00100100030af21
下移指令
a00100041000af15
左移指令
a00100021000af13
右移指令
a00100800000af81
聚焦近
a00101000000af00
聚焦远
a00100070001af07
转至预置点001
a00100030001af03
设置预置点001
a00100050001af05
删除预置点001
a00100000000af01
停止指令
VISCA 协议
VISCA 协议
具体指令
指令含义
8101060100000301FF
上移指令
8101060100000302FF
下移指令
8101060100000103FF
左移指令
8101060100000203FF
右移指令
8101060100000303FF
停止指令
8001043F0001FF
删除预置位1指令
8001043F0101FF
添加预设位1指令
8001043F0201FF
转到预设位1指令
8001040702FF
变焦近指令
8001040703FF
变焦远指令
8101040700FF
停止变焦指令
serial_port_utility_latest.exe