拼接控制器通讯协议 v234(1)

拼接控制器通讯协议

一、通讯方式

PC与拼接控制器可以使用两种方式通讯：

1、串口方式：PC与控制器使用直联RS232串口线连接，PC的串口应设置为9600波特率、

1停止位、无校验。

2、UDP网络方式：PC与控制器使用以太网连接，PC向控制器的5000端口发送UDP报文，

每条命令使用一个UDP包发送。

控制方式为命令应答式，两种通讯方式可同时工作，但同一时间控制器只能执行一条命令，在执行命令期间PC发送给控制器的命令将被忽略。

控制器提供一个485或232级联端口，可用于向下级设备转发命令，实现对下级设备的控制。当使用UDP连接时，PC向控制器5001端口发送的报文会自动转给环出串口。

二、命令格式

PC与控制器的通讯为双向协议，所有的命令都使用以下格式：

<命令,参数1,参数2,…参数N>

本指令集使用ASCII码字符集，指令字符不区分大小写，所有命令均已“<”开始，以“>”结束，各参数之间用“，”隔开。命令中不得出现空格字符。

所有命令都由PC主动向控制器发送，控制器对命令的反应有四种情况：

1、命令正确执行，如果该命令是单向执行的命令，则控制器返回以下报文：

<命令,OK>

2、命令正确执行，如果该命令是从控制器读取信息的命令，则控制器返回以下报文：

<命令,参数1,参数2,…参数N>

…

<命令,OK>

根据命令的不同，控制器可能会返回一条或多条带参数的报文，最后以OK结束。

3、如果命令格式错误，或因为版本兼容等原因而不被支持，返回以下报文：

4、命令超时

当控制器正在执行命令时，再次接收到命令，此时后面的命令可能被忽略导致PC接收不到回复。通常PC端在发送完一条命令后，可以设置1秒的超时检查时间。

三、参数约定

在通讯协议中，有以下几个重要的参数需要注意：

1、Channel，信号源主通道号，用来标识一个主信号源，从1开始。

主通道号是与控制器机箱的物理插槽位置相关的。在控制器机箱上，有多个输入卡插槽，每个插槽上可以根据需要插入任意类型的信号源（如DVI、VGA、8路视频等）输入卡。

在系统中，每个输入卡插槽分配2个主通道号，即便这个插槽是空着的，主通道号也预

留出来。

如果机箱的输入卡是垂直插入的，则从左向右排列。如果机箱的输入卡是水平插入的，则从上向下排列。

对VGA、DVI等一卡两路信号源的输入卡，Input A和Input B分别对应该输入卡的1、2通道。对SDI、底图卡等一卡一路信号源的输入卡，则该信号源只对应该卡的1通道，2通道不使用。

2、SubChannel，信号源子通道号。

对4路视频和8路视频输入卡来说，由于一块输入卡只能对应2个主通道，要标识所有的信号源，就需要使用子通道号。4路视频输入卡，使用1个主通道号和0-3的子通道号来标识。8路视频输入卡，使用主通道号1和子通道0-3，以及主通道号2和子通道0-3来标识8路输入。

对其它输入卡而言，只使用主通道号即可标识，子通道号应设置为0。

例如，有一个带6个输入槽位的机箱：

输入卡Input A Input B

DVI：Input1+Input2主通道1，子通道0主通道2，子通道0

VGA：Input1+Input2主通道3，子通道0主通道4，子通道0

未插卡预留预留

SDI：Input1主通道7，子通道0预留

Video4：V1V2V3V4主通道9，子通道V1=0，

V2=1，V3=2，V4=3

预留

Video5：V1V2V3V4V5V6 V7V8主通道11，子通道V1=0，

V2=1，V3=2，V4=3

主通道12，子通道V5=0，

V6=1，V7=2，V8=3

3、W_ID，窗口的序列号，用以区分不同的窗口。不同窗口的序列号绝对不可以一样。

其范围：1≤W_ID≤65535。

对窗口进行操作时，需要提供W_ID。W_ID需要做回收的，如果使用某个ID的窗口关闭了，则以后新窗口可以使用这个ID。

4、坐标，指由多块屏幕拼接成的虚拟逻辑大屏幕上的坐标，左上角为（0，0）。

大屏上的窗口坐标为左上角为闭区间坐标，右下角为开区间坐标。

比如：在1024x768输出的大屏中，充满左上角物理屏的窗口坐标为：(0,0)-(1024,768)

四、命令协议

1、新开窗口

此命令用来创建一个新窗口。

参数功能说明

W_ID窗口ID用来区分不同的窗口，如果使用已经开过窗口的

W_ID来open，则会自动将原来的窗口删除再重新

开窗。见“参数约定”中的说明

Channel信号源主通道见“参数约定”中的说明

SubChannel信号源子通道见“参数约定”中的说明

x0,y0窗口左上角坐标见“参数约定”中的说明

x1,y1窗口右下角坐标见“参数约定”中的说明

控制器正确执行后返回：

2、关闭窗口

此命令用来关闭序列号为W_ID的窗口。

控制器正确执行后返回：

3、移动窗口命令

此命令用来改变序列号为W_ID的窗口的位置和大小，参数功能与新开窗口命令相同。

控制器正确执行后返回：

4、改变窗口大小命令

此命令用来改变序列号为W_ID的窗口的位置和大小，参数功能与新开窗口命令相同。这条命令的功能和move是一样的，可以相互替换。

控制器正确执行后返回：

5、层次关系命令

此命令用来改变窗口之间的层次关系。

参数功能说明

W_ID窗口ID见“参数约定”中的说明

ZOrder窗口的层次序号1≤ZOrder≤n，1为最底层，n为最上层。（n为所

开的窗口数）。

控制器正确执行后返回：

6、关闭全部窗口

此命令用来关闭所有窗口。

控制器正确执行后返回：

7、保存场景

此命令用来将当前的开窗信息保存到控制器的场景中。