[尽责]VTRON拼接器协议

justsosonihao 发表于 2006-9-11 17:55

VWAS 串口控制协议 
一、概述 
为了实现AMX 等串口设备对显示墙管理系统（VWAS）的操作功能，VWAS 需要提供串口 
控制的接口。本文描述该接口的控制协议。 
VWAS 串口控制协议中包含了一系列的指令。每条指令及其参数无歧义的描述了可以通 
过VWAS 实现的对显示墙系统的某项操作。这些操作包括：机芯开关、执行模式、关闭所有 
机芯直通窗口、关闭所有处理器窗口、关闭所有处理器应用和信号源选择。 
该协议可根据以后的功能需求进行扩展。 
二、指令的命名和格式 
指令的命名采用如下规则：第一个字母小写，表示操作类型。e 表示机芯操作，p 表示 
处理器操作，m 表示模式操作，s 表示信号源操作，d 表示多功能设备操作，c 表示串口操作； 
其余字母是其功能的英文描述的简写。 
指令及其参数、指令的执行结果均用字符串表示。 
每条指令的最后一个字符必须为结束符，指令及其参数之间用分隔符分开。本协议采用 
的结束符为回车符（0x0D，以下用↵表示），分隔符为0x0B（以下用_表示）。 
指令的参数按类型可分为整型值和字符串。整型参数直接用其十进制值的字符串表示。 
指令的参数按照性质可分为必要参数和可选参数。可选参数用[]表示。 
指令的执行结果的格式与此类似，由指令的名称和返回的执行结果代码（整型值）组成。 
执行结果代码为0 表示成功，其他值的含义与指令相关。 
三、指令描述 
1、 ePowerOn 
功能：机芯开机 
格式：ePowerOn↵ 
参数： 
WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙，此时ProjNo 
也必须省略。 
ProjNo：要进行该操作的机芯编号。如果省略或为0，表示指定拼墙的所有机 
芯。 
执行结果：ePowerOn_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的拼墙名称； 
4：非法的机芯编号； 
5：操作失败。 
2、 ePowerOff 
功能：机芯关机 
格式：ePowerOff↵ 
参数： 
WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙，此时ProjNo 
也必须省略。 
ProjNo：要进行该操作的机芯编号。如果省略或为0，表示指定拼墙的所有机 
芯。 
执行结果：ePowerOff_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的拼墙名称； 
4：非法的机芯编号； 
5：操作失败。 
3、 dPowerOn 
功能：多功能显示设备开机 
格式：dPowerOn_DevName↵ 
参数： 
DevName：要进行该操作的多功能显示设备的名称。 
执行结果：dPowerOn_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的多功能显示设备名称； 
4：操作失败。 
4、 dPowerOff 
功能：多功能显示设备关机 
格式：dPowerOff_DevName↵ 
参数： 
DevName：要进行该操作的多功能显示设备的名称芯。 
执行结果：dPowerOff_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的多功能显示设备名称； 
4：操作失败。 
5、 eCloseWin 
功能：关闭所有机芯直通窗口 
格式：eCloseWin↵ 
参数： 
WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙。 
执行结果：eCloseWin_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的拼墙名称； 
4：操作失败。 
6、 pCloseApp 
功能：关闭所有处理器应用实例 
格式：pCloseApp↵ 
参数： 
WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙。 
执行结果：pCloseApp_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的拼墙名称； 
4：操作失败。 
7、 pCloseWin 
功能：关闭所有处理器窗口 
格式：pCloseWin↵ 
参数： 
WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙。 
执行结果：pCloseWin_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的拼墙名称； 
4：操作失败。 
8、 mApply 
功能：执行已经定义的模式 
格式：mApply_ModeName↵ 
参数： 
ModeName：要执行的模式的名称。 
执行结果：mApply_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的模式名称； 
4：操作失败。 
9、 sSelVideo 
功能：将一个VIDEO 信号源选择切换到一个监视器 
格式：sSelVideo_SouName_DevName↵ 
参数： 
SouName：要切换的VIDEO 信号源的名称。 
DevName：要显示该信号源的监视器的名称。 
执行结果：sSelVideo_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的信号源名称； 
4：非法的监视器名称； 
5：操作失败。 
10、 sSelCamera 
功能：将一个摄像头信号源选择切换到一个监视器 
格式：sSelCamera_SouName_DevName↵ 
参数： 
SouName：要切换的摄像头信号源的名称。 
DevName：要显示该信号源的监视器的名称。 
执行结果：sSelCamera_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的信号源名称； 
4：非法的监视器名称； 
5：操作失败。 
11、 sSelRGB 
功能：将一个RGB 信号源选择切换到一个显示器 
格式：sSelRGB_SouName_DevName↵ 
参数： 
SouName：要切换的RGB 信号源的名称。 
DevName：要显示该信号源的显示器的名称。 
执行结果：sSelRGB_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的信号源名称； 
4：非法的显示器名称； 
5：操作失败。 
12、 sSelAudio 
功能：将一个AUDIO 信号源选择切换到一个播放器 
格式：sSelAudio_SouName_DevName↵ 
参数： 
SouName：要切换的AUDIO 信号源的名称。 
DevName：要显示该信号源的监视器的名称。 
执行结果：sSelAudio_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的信号源名称； 
4：非法的播放器名称； 
5：操作失败。 
13、 sSelVideo2MFD 
功能：将一个VIDEO 信号源选择切换到一个多功能显示设备 
格式：sSelVideo2MFD_SouName_DevName↵ 
参数： 
SouName：要切换的VIDEO 信号源的名称。 
DevName：要显示该信号源的多功能显示设备的名称。 
执行结果：sSelVideo2MFD_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的信号源名称； 
4：非法的多功能显示设备名称； 
5：操作失败。 
14、 sSelCamera2MFD 
功能：将一个摄像头信号源选择切换到一个多功能显示设备 
格式：sSelCamera2MFD_SouName_DevName↵ 
参数： 
SouName：要切换的摄像头信号源的名称。 
DevName：要显示该信号源的多功能显示设备的名称。 
执行结果：sSelCamera2MFD_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的信号源名称； 
4：非法的多功能显示设备名称； 
5：操作失败。 
15、 sSelRGB2MFD 
功能：将一个RGB 信号源选择切换到一个多功能显示设备 
格式：sSelRGB2MFD_SouName_DevName↵ 
参数： 
SouName：要切换的RGB 信号源的名称。 
DevName：要显示该信号源的多功能显示设备的名称。 
执行结果：sSelRGB2MFD_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的信号源名称； 
4：非法的多功能显示设备名称； 
5：操作失败。 
16、 sSelAudio2MFD 
功能：将一个AUDIO 信号源选择切换到一个多功能显示设备 
格式：sSelAudio2MFD_SouName_DevName↵ 
参数： 
SouName：要切换的AUDIO 信号源的名称。 
DevName：要显示该信号源的多功能显示设备的名称。 
执行结果：sSelAudio2MFD_nResult↵ 
nResult 可能取值： 
0：成功； 
1：串口控制功能被禁止； 
2：非法的指令名称； 
3：非法的信号源名称； 
4：非法的多功能显示设备名称； 
5：操作失败。 
17、 cSendData 
功能：发送数据到指定串口 
格式：cSendData_PortNo_PortSettings_Length↵Data 
参数： 
PortNo：串口名称，譬如COM1 
PortSettings：串口设置，譬如9600,n,8,1 
Length：发送的数据长度 
Data：发送的数据。 
执行结果：cSendData_nResult↵ 
nResult 可能取值： 
0：成功 
1：串口控制功能被禁止 
2：非法的指令名称 
3：非法的端口名称 
4：非法的串口设置 
5：操作失败。

lovemusic 发表于 2008-11-20 14:18

我顶了谢谢你的分享为了得到更多的积分与你们分享

hainavip 发表于 2009-2-16 22:57

多谢楼主分享学习!!!!!!!!!!

yusuf 发表于 2009-9-30 20:31

多谢分享，是个好东西。

页: [1]

XYCAD中国音响设计网's Archiver

[尽责]VTRON拼接器协议