|
|
亲，只有注册或登录才能下载更有用的哦
您需要 登录 才可以下载或查看，没有账号？注册
×
VWAS 串口控制协议<br>
0 E! X w1 v* v一、概述<br>5 h$ i' z% I! M% v+ U( H
为了实现AMX 等串口设备对显示墙管理系统（VWAS）的操作功能，VWAS 需要提供串口<br>
9 f' B v1 q3 J0 I& N7 R: F控制的接口。本文描述该接口的控制协议。<br>
; p( P( L" Q. A/ E" C7 w [' pVWAS 串口控制协议中包含了一系列的指令。每条指令及其参数无歧义的描述了可以通<br>* g, ?6 }" W. n3 q
过VWAS 实现的对显示墙系统的某项操作。这些操作包括：机芯开关、执行模式、关闭所有<br>
% o/ h) D8 F9 y6 C% r# ~3 v+ w机芯直通窗口、关闭所有处理器窗口、关闭所有处理器应用和信号源选择。<br>/ v5 X8 X6 f: D2 \& U
该协议可根据以后的功能需求进行扩展。<br>3 y% C9 v$ r2 j- W7 n- q9 n
二、指令的命名和格式<br>
& C- G1 U2 p& |+ b1 a指令的命名采用如下规则：第一个字母小写，表示操作类型。e 表示机芯操作，p 表示<br>$ \5 g u, d) j, U# t
处理器操作，m 表示模式操作，s 表示信号源操作，d 表示多功能设备操作，c 表示串口操作；<br>' `! E$ ?7 Q7 g# l
其余字母是其功能的英文描述的简写。<br>: P9 O3 J- |1 ]" z
指令及其参数、指令的执行结果均用字符串表示。<br>
* D7 O8 T6 a* \( h) ?, y9 R每条指令的最后一个字符必须为结束符，指令及其参数之间用分隔符分开。本协议采用<br>
/ ~7 F! Y* T9 V7 j7 }! {的结束符为回车符（0x0D，以下用↵表示），分隔符为0x0B（以下用_表示）。<br>0 \$ C/ X& A) D' A. {5 x
指令的参数按类型可分为整型值和字符串。整型参数直接用其十进制值的字符串表示。<br>
9 w7 Q7 a4 N, n: `$ k4 H, z, m1 Q指令的参数按照性质可分为必要参数和可选参数。可选参数用[]表示。<br>: g3 S" @ x& e
指令的执行结果的格式与此类似，由指令的名称和返回的执行结果代码（整型值）组成。<br>
5 m% e) M4 P6 |9 `执行结果代码为0 表示成功，其他值的含义与指令相关。<br>
; Z" e* u: B5 G三、指令描述<br>% m W( }% f/ s8 A# v. `! N5 O! ] i
1、 ePowerOn<br>7 j* r1 `, y5 R5 k* t. g( [9 f# p7 \9 X
功能：机芯开机<br>3 J( e, `& g r& S& X
格式：ePowerOn[_WallName][_ProjNo]↵<br>
* `: U5 z9 \% V, D+ s7 u参数：<br>, i* V9 t2 C4 @, a1 T0 Z. t
WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙，此时ProjNo<br>0 Z& G# d2 b8 R; Q1 @3 X' P* k/ z8 w
也必须省略。<br>% T; D& [9 t3 k5 S+ ]
ProjNo：要进行该操作的机芯编号。如果省略或为0，表示指定拼墙的所有机<br>) _3 o6 H9 g+ l' s. u# Y# C- Z
芯。<br>7 y* I6 S6 M( ~. e* D) H
执行结果：ePowerOn_nResult↵<br>
& @' v$ h3 I) L ynResult 可能取值：<br>' r) ^1 |5 ?$ D2 B+ K |/ s
0：成功；<br>
: Q7 }% ?5 C4 O# o [/ ^6 f3 _1：串口控制功能被禁止；<br>( H& y5 ?. Q" n$ W7 m; W
2：非法的指令名称；<br>6 F' o M+ U6 K% P
3：非法的拼墙名称；<br>7 k9 A- E$ `2 t
4：非法的机芯编号；<br>, W$ O0 v. N; N# H" J3 P# x
5：操作失败。<br>3 B% C0 O3 W9 w; r
2、 ePowerOff<br># K" h% z2 t, }
功能：机芯关机<br>" P) A+ X' o# W H: \6 ]
格式：ePowerOff[_WallName][_ProjNo]↵<br>; X5 ?: f7 c0 E# v
参数：<br>
* ?% E5 K a- D8 O* U( K M5 g& \WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙，此时ProjNo<br>
. b2 p6 v7 l: i% w) m; P3 O也必须省略。<br>) d! z3 Z2 G* y/ s7 m5 Z6 Q& \
ProjNo：要进行该操作的机芯编号。如果省略或为0，表示指定拼墙的所有机<br>! ]6 Y4 {$ K: r+ d5 w
芯。<br>
/ K& L1 x) n6 I3 M- v& T, i2 F3 ^8 r( E执行结果：ePowerOff_nResult↵<br>" I& |+ f+ C; E P( W
nResult 可能取值：<br>/ ?) d$ T, ^2 h+ c5 U* K
0：成功；<br> O) }1 i* P1 x# O' N* u
1：串口控制功能被禁止；<br>
$ D) m- C5 O& e6 O: e- Q4 l# S2：非法的指令名称；<br>+ {% ^, C8 _- }. [* ~
3：非法的拼墙名称；<br>
- _; x( a+ f9 u* U% L4：非法的机芯编号；<br>3 V5 v4 u; ~. w, \1 ]7 b) d
5：操作失败。<br>
( e5 ]- [; D. _; [3、 dPowerOn<br>: v/ O+ H( \; F8 O
功能：多功能显示设备开机<br>/ g8 Q2 ^- f9 ]6 r: s0 Z
格式：dPowerOn_DevName↵<br>/ x& J2 X+ a; z6 |3 x
参数：<br>" p' H3 K' C' G7 V" b% c
DevName：要进行该操作的多功能显示设备的名称。<br>1 z+ _( K+ b ~; ~
执行结果：dPowerOn_nResult↵<br>+ x: M- k* `9 v+ h& O
nResult 可能取值：<br>& V, r+ p- W$ K& F
0：成功；<br>
4 l5 n. F, I1 N$ d6 @. B1：串口控制功能被禁止；<br>
. ^- f( P/ u, p, M- X- U7 |2：非法的指令名称；<br>
' Y! f% ^: U1 J+ H2 l' Y2 G- S7 y3：非法的多功能显示设备名称；<br> ~# j1 l6 U2 F2 Y2 r0 n
4：操作失败。<br>
( [: X. B" j' J f; |% E6 o6 Q2 m4、 dPowerOff<br>% `, ], R% D0 |+ [! _; y* }
功能：多功能显示设备关机<br>
2 @, @3 e& t6 H6 _0 n& G9 v格式：dPowerOff_DevName↵<br>( B9 A, [# I' P1 ^7 M5 @
参数：<br>
% C0 f d9 l; u: C. W3 DDevName：要进行该操作的多功能显示设备的名称芯。<br>
, P/ k4 e9 s3 t, ?2 A" u执行结果：dPowerOff_nResult↵<br>1 r3 d l. W w$ w4 P
nResult 可能取值：<br>! V) E$ E# ]9 x: X* ~ @: b8 P. n" k
0：成功；<br>! d" q, k+ Q; {3 ~% m: J
1：串口控制功能被禁止；<br>
; R8 Q2 J3 ?3 v! b$ h2：非法的指令名称；<br>) ?0 Y+ u e, N+ B$ H
3：非法的多功能显示设备名称；<br>, W- A$ G6 v0 j* r
4：操作失败。<br>
9 p7 f x2 x+ ^% B- m+ o5、 eCloseWin<br>
# H: H( E0 w' W- T4 Q功能：关闭所有机芯直通窗口<br># ?* `6 K8 G9 V! N, C' M
格式：eCloseWin[_WallName]↵<br>9 b: @3 a9 s2 q' ?4 R1 w1 ~
参数：<br>
8 x2 K0 {. W' I- }( AWallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙。<br> r4 L2 L% M* x/ |8 d9 z
执行结果：eCloseWin_nResult↵<br>" r# P' o! `: b/ ^4 \
nResult 可能取值：<br>
* ~4 x/ Q1 k" q4 D0：成功；<br>/ q8 A! i& d9 R' e# C4 F, D
1：串口控制功能被禁止；<br>4 p7 a- X( X- R( N; }
2：非法的指令名称；<br>
# S. G6 `6 k7 N! Z* L) A- B3：非法的拼墙名称；<br>3 p) H& b, Z! i$ E- H \
4：操作失败。<br>- K5 \# T$ a2 w! M- O5 j5 ]
6、 pCloseApp<br>( s8 m" a5 p8 U$ u
功能：关闭所有处理器应用实例<br>
* [) f y0 f1 u格式：pCloseApp[_WallName]↵<br>
8 Q9 k0 I' V& m参数：<br>
) F) L- [- G0 C4 D% \WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙。<br>
- v; c6 S/ n" h8 h" H执行结果：pCloseApp_nResult↵<br>
% h% X' ?, i( N7 R6 e- J5 N% x+ `$ \nResult 可能取值：<br>4 m3 `% U) k; @
0：成功；<br># A9 ]% Q/ ]2 D8 H1 v
1：串口控制功能被禁止；<br>* M) y2 X6 V2 u
2：非法的指令名称；<br>
- e/ V6 ~) ? V6 k3：非法的拼墙名称；<br>
" t0 x4 e Q, ?, P( \8 d4：操作失败。<br>$ y$ Q: j# o- `: N+ c
7、 pCloseWin<br>) V5 O& i, R& u+ N, w! L
功能：关闭所有处理器窗口<br>% M, Y2 k/ B: q
格式：pCloseWin[_WallName]↵<br>/ u7 E9 _3 f }% f/ G$ A0 [
参数：<br>% `9 O0 H: f& Z2 w
WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙。<br>
! P% ^, r' M# I# y执行结果：pCloseWin_nResult↵<br>3 ^' _+ K4 q/ K( m# x5 H
nResult 可能取值：<br>8 }5 G8 O0 X" e/ E' o3 K
0：成功；<br>
% V. t- p4 [2 \1：串口控制功能被禁止；<br>6 L2 P2 y5 J8 _& M5 l7 r! C
2：非法的指令名称；<br>
: a4 }$ r ^, T9 f2 x+ ?6 R) d: W3：非法的拼墙名称；<br> ^* w5 L% v8 t8 f1 Y& h. q& X
4：操作失败。<br>7 d/ E% V* l$ e$ ?$ S' m: N
8、 mApply<br>
* w; V1 N# A T- r0 S6 P功能：执行已经定义的模式<br>
4 ?! z6 q. \0 K. n格式：mApply_ModeName↵<br>7 O5 V" a* ]! d7 k5 u
参数：<br>8 X7 t9 }- q& T X8 \
ModeName：要执行的模式的名称。<br>
1 a. o! g& d( F; j( d# _执行结果：mApply_nResult↵<br>" z% O4 G% I. q6 Y* B+ C! H. k
nResult 可能取值：<br>
1 G9 A+ `6 U6 Y' }3 R0：成功；<br>3 d* ]' J0 j8 M, t
1：串口控制功能被禁止；<br>
5 \8 \$ e) a2 a/ A' J2：非法的指令名称；<br>
7 q0 e8 q6 n! R5 J+ D3 R3：非法的模式名称；<br> i2 ?7 Y' V3 [9 a4 [1 X$ _
4：操作失败。<br>1 W% h+ t) x! q. W$ w' G M
9、 sSelVideo<br>
7 F& S9 |/ t( z: ~' K3 u& S3 n1 K/ W功能：将一个VIDEO 信号源选择切换到一个监视器<br>7 }( ~. I5 w3 o( w$ W
格式：sSelVideo_SouName_DevName↵<br>
7 @- }0 e" @/ @6 G4 b/ N+ D参数：<br>6 t# ^- v R, \% I. ]
SouName：要切换的VIDEO 信号源的名称。<br>! \; c. S* ]) @2 D3 H# ^
DevName：要显示该信号源的监视器的名称。<br>
; h; |- r2 ^: N9 n, x执行结果：sSelVideo_nResult↵<br>
+ b( t5 W% ?% F8 G" r$ y$ E1 F XnResult 可能取值：<br>9 T, X6 s) V) o3 Q/ `. |* v
0：成功；<br># e3 P8 v. T i5 t. w# Q8 \5 R8 ^
1：串口控制功能被禁止；<br>6 o# B r4 z$ J5 T6 |4 j' z
2：非法的指令名称；<br>- ~$ u& b) i- ]' Z
3：非法的信号源名称；<br>
{/ o; W+ {, h1 _6 Z4：非法的监视器名称；<br>4 |% E- R2 {4 n# I0 l
5：操作失败。<br>
* G# @- l+ M2 {8 q7 ^8 N5 W/ }10、 sSelCamera<br>- H5 a& e; ^& H2 W) [7 F$ V
功能：将一个摄像头信号源选择切换到一个监视器<br>. E; B4 R* B" A: h! ^& R
格式：sSelCamera_SouName_DevName↵<br>
& l9 {4 i" f( }" Q2 a( D参数：<br>! }/ D4 E0 U K- e
SouName：要切换的摄像头信号源的名称。<br>
0 c1 N' A' | _7 s& }DevName：要显示该信号源的监视器的名称。<br> q7 a+ q |) m# u
执行结果：sSelCamera_nResult↵<br>- D# R) U) F9 q% }) a- p
nResult 可能取值：<br>
! l- v) V8 C% s& W& R0：成功；<br># ~$ e. k; J. e7 {
1：串口控制功能被禁止；<br>
1 E, f3 |6 P' F, `5 u- p1 `2：非法的指令名称；<br>2 _7 r. ^+ I6 `: e, s' r
3：非法的信号源名称；<br>4 Q$ {9 ^3 m! I, s
4：非法的监视器名称；<br>
9 L, b' b4 c! O, Z _4 X/ o5：操作失败。<br>
% z! n3 t1 }4 Z2 V; |! H' n11、 sSelRGB<br>
$ ^0 A, _9 D0 w功能：将一个RGB 信号源选择切换到一个显示器<br>" x+ j4 x5 z. t0 \
格式：sSelRGB_SouName_DevName↵<br>% |2 ?4 {+ Y8 o' I- B" b9 m
参数：<br>6 g5 m; L0 p5 P M4 X& N2 g
SouName：要切换的RGB 信号源的名称。<br>
a/ j2 a! i! _. b* QDevName：要显示该信号源的显示器的名称。<br>9 a# r% s# P5 `; P; [+ ?
执行结果：sSelRGB_nResult↵<br>
" Y2 X! T4 v1 a* o1 G+ d/ g4 N# tnResult 可能取值：<br># ^5 H% e1 p. T. X6 u
0：成功；<br>" E" E) N4 w8 v; ]9 B) G k
1：串口控制功能被禁止；<br>
8 c$ a& e) s# `2：非法的指令名称；<br>2 p; \: r2 A0 f; T0 J X, I
3：非法的信号源名称；<br>& [7 j+ k% ?, O
4：非法的显示器名称；<br>
' h% z2 D! S5 H2 G; ]5：操作失败。<br>
; A% K6 _/ h9 k12、 sSelAudio<br>
1 Y2 u1 v# |* |2 L- Z5 D& q2 q9 u功能：将一个AUDIO 信号源选择切换到一个播放器<br>4 R9 n% {0 F- ?
格式：sSelAudio_SouName_DevName↵<br>
# T5 @* u, N# X' i( l* `" p/ [9 ^$ ?参数：<br>
1 J) I6 z) y7 L. `( `SouName：要切换的AUDIO 信号源的名称。<br>
5 J& A' W6 O' r% ~8 w" }# G, vDevName：要显示该信号源的监视器的名称。<br>8 a8 s- {; l8 ~! l1 |
执行结果：sSelAudio_nResult↵<br>
1 M. s( K b* F. EnResult 可能取值：<br>
( A C1 ?: w6 \& ]* t$ d @0：成功；<br>
! U1 y! ?- C. q/ ~& e h) L# e1：串口控制功能被禁止；<br>
d* h/ e/ K: f! Z& ~. e9 }2：非法的指令名称；<br>) V" \( _* t! b6 H3 Q4 m
3：非法的信号源名称；<br>6 P9 y" n5 U; H; l+ z6 S* d
4：非法的播放器名称；<br>
6 O* Z# g' q$ f3 ]' x. f1 p3 w5：操作失败。<br>' m/ t3 E" O2 ?* N
13、 sSelVideo2MFD<br>; K% x$ m1 Q/ @5 f5 i+ }# e
功能：将一个VIDEO 信号源选择切换到一个多功能显示设备<br>4 J9 D/ d, D* J! J) n
格式：sSelVideo2MFD_SouName_DevName↵<br>
& b0 @+ Q/ |% U' ^8 u; w. J& e. p3 h参数：<br>
! ^9 ?- m+ F" ZSouName：要切换的VIDEO 信号源的名称。<br>) ^# N* a% O: w- A
DevName：要显示该信号源的多功能显示设备的名称。<br>" f! Q+ M; Y' s& E2 A ]" A
执行结果：sSelVideo2MFD_nResult↵<br>4 w5 @5 f- ?9 a* E
nResult 可能取值：<br>
4 s6 v' }) O( _- }6 C0：成功；<br>
+ c; E5 N4 N _! z: \* u! r! Y1：串口控制功能被禁止；<br>
8 T# i1 u3 ?* \2：非法的指令名称；<br>3 _ Q2 b. c+ j: {4 ?7 t
3：非法的信号源名称；<br>
; o% P. W% J/ b( [4：非法的多功能显示设备名称；<br>* _6 y9 f i4 q4 r
5：操作失败。<br>
% Z6 H9 b; g) L/ H5 I. F! D14、 sSelCamera2MFD<br>
! T6 X+ d; W* m) r. g- Q) e功能：将一个摄像头信号源选择切换到一个多功能显示设备<br>1 p3 c1 a; @4 J
格式：sSelCamera2MFD_SouName_DevName↵<br>
7 f& C/ ?' r1 t% m: x! I7 O参数：<br>
; b9 X5 y8 Z5 s ]' TSouName：要切换的摄像头信号源的名称。<br>
! m: }& f" }: C# JDevName：要显示该信号源的多功能显示设备的名称。<br>
) I5 Q2 g4 ]" S9 ?9 X! b执行结果：sSelCamera2MFD_nResult↵<br>: y3 ^9 y* b+ Y3 K. l. m/ C; O9 T
nResult 可能取值：<br>
: |. W, `# n/ k3 e& e0：成功；<br>
: t" Q2 [% g2 Z- c1：串口控制功能被禁止；<br>
+ j# [3 Y* |4 R3 V5 H: V, a2：非法的指令名称；<br>" }( q! \9 Z( M0 T: R) e
3：非法的信号源名称；<br>1 z3 d4 }. j. {$ a8 T
4：非法的多功能显示设备名称；<br>. \5 z$ _ z. F5 R, c9 ]
5：操作失败。<br>
% F. z- W; j- I' [15、 sSelRGB2MFD<br>! Q6 ~( Y6 D M( }
功能：将一个RGB 信号源选择切换到一个多功能显示设备<br>2 T3 F4 i9 \& k
格式：sSelRGB2MFD_SouName_DevName↵<br>
. T6 B4 \# c" r参数：<br>
, g" z8 M! h+ ]) Q! |SouName：要切换的RGB 信号源的名称。<br>& x' g2 c9 X+ G# E# x0 [
DevName：要显示该信号源的多功能显示设备的名称。<br>. a8 N; g1 ~7 @1 ?5 E0 K8 s: x
执行结果：sSelRGB2MFD_nResult↵<br>
/ y# n) Z- l5 e! vnResult 可能取值：<br>; Z1 @: c1 g1 S9 R4 I8 V
0：成功；<br>/ P3 D( Q. E3 s5 Y$ j4 }
1：串口控制功能被禁止；<br>9 @. B3 Y- _. h. j5 I) i
2：非法的指令名称；<br>5 U6 ]! b: _3 Y+ p2 }: n1 {
3：非法的信号源名称；<br>+ e# D: l1 b5 G2 w; s
4：非法的多功能显示设备名称；<br>
6 ^( A; o3 F& {3 H) v0 \5 }5：操作失败。<br>9 K! n( ?; @. l) M$ A9 e
16、 sSelAudio2MFD<br>6 z8 k6 ~: Q2 E% S4 `% I/ E& U
功能：将一个AUDIO 信号源选择切换到一个多功能显示设备<br>" D6 `8 |& X1 h5 P2 O- g
格式：sSelAudio2MFD_SouName_DevName↵<br>) b" e- J1 r" |
参数：<br>
% @. @ G4 ~6 S! OSouName：要切换的AUDIO 信号源的名称。<br>
* K0 k8 ^0 a$ Y4 }0 {+ |DevName：要显示该信号源的多功能显示设备的名称。<br>
2 t" A4 r [' v: N+ H+ f! N执行结果：sSelAudio2MFD_nResult↵<br># h* W4 |3 D% S, I0 D1 h3 ]/ I7 \5 H
nResult 可能取值：<br>( p* R. |' u2 z' t$ Q* j( `6 y
0：成功；<br>9 o# t8 \6 d8 p2 d' t
1：串口控制功能被禁止；<br>& Y; H; d; g( C) h0 G t/ b) L' ~: {
2：非法的指令名称；<br>: L1 Q2 q S, W" ?4 u, p
3：非法的信号源名称；<br>
; N4 _! T7 ` @8 g+ @: M4：非法的多功能显示设备名称；<br>5 }& _6 a5 p. _( K. w- b" P& J" O5 b: L
5：操作失败。<br>
) K1 s r2 \: p, c* B17、 cSendData<br>
t1 o1 l, l4 P功能：发送数据到指定串口<br>% |5 C* W' E; h
格式：cSendData_PortNo_PortSettings_Length↵Data<br>2 x" K! k$ r) H6 `% w$ j
参数：<br>
7 c! c' C3 s* ]8 Q$ |PortNo：串口名称，譬如COM1<br>6 j0 ~4 a* S* g/ r% Y% f
PortSettings：串口设置，譬如9600,n,8,1<br>9 d, Z4 T- b. A2 m
Length：发送的数据长度<br>3 x* J/ H, i6 d% W/ y( f; p
Data：发送的数据。<br>
$ b& W4 ]; o5 {0 O9 {执行结果：cSendData_nResult↵<br>( C# @! t1 M; I
nResult 可能取值：<br>
% @. M- s% D. ^; g; ~# s: u0：成功<br>
/ r. T% s# Z4 u5 v( P1：串口控制功能被禁止<br>
& m9 ^( |1 P) {: ~: y5 U2 a" }2：非法的指令名称<br>$ k# O* ~. q, Z f
3：非法的端口名称<br>
7 g' b- ~/ {& Z1 L+ a4：非法的串口设置<br>
3 F8 g# s" g6 v5：操作失败。 |
|
|手机版|Archiver|XYCAD中国音响设计网
( 京ICP备14030947号 )
IP卡
狗仔卡
发表于 2006-9-11 17:55
提升卡
置顶卡
沉默卡
喧嚣卡
变色卡
显身卡