|
|
亲，只有注册或登录才能下载更有用的哦
您需要 登录 才可以下载或查看，没有账号？注册
×
VWAS 串口控制协议<br>
8 M- n. I0 A- o& o" |( L, a" Q |$ S一、概述<br>
: Q5 x- }7 t+ a1 g为了实现AMX 等串口设备对显示墙管理系统（VWAS）的操作功能，VWAS 需要提供串口<br>
* y6 ]1 M9 r: j" E8 t& c! F控制的接口。本文描述该接口的控制协议。<br># w" U1 A$ U O9 o( R/ N7 r: p" \
VWAS 串口控制协议中包含了一系列的指令。每条指令及其参数无歧义的描述了可以通<br>
& r) h4 s+ h5 N; x' l0 e过VWAS 实现的对显示墙系统的某项操作。这些操作包括：机芯开关、执行模式、关闭所有<br># E* r1 O' |1 L6 t& ?
机芯直通窗口、关闭所有处理器窗口、关闭所有处理器应用和信号源选择。<br>' Y2 |7 x3 l4 F$ I* |, m
该协议可根据以后的功能需求进行扩展。<br>
5 G/ ]+ G8 W) `5 g! v二、指令的命名和格式<br>
/ u1 W8 v) o( |) {( g) D' s0 k指令的命名采用如下规则：第一个字母小写，表示操作类型。e 表示机芯操作，p 表示<br>7 X0 q8 {6 D" j; w9 m# r
处理器操作，m 表示模式操作，s 表示信号源操作，d 表示多功能设备操作，c 表示串口操作；<br>
5 _* e% C8 G( }* F7 M f其余字母是其功能的英文描述的简写。<br>, J% |* D3 i, W0 N* o9 w8 M* x
指令及其参数、指令的执行结果均用字符串表示。<br>
5 i" F% v/ E3 C9 J每条指令的最后一个字符必须为结束符，指令及其参数之间用分隔符分开。本协议采用<br>5 t2 y) `( F. q9 h
的结束符为回车符（0x0D，以下用↵表示），分隔符为0x0B（以下用_表示）。<br>0 C" H: ~$ D* ^
指令的参数按类型可分为整型值和字符串。整型参数直接用其十进制值的字符串表示。<br>
! o% i1 I5 K) O( C" \指令的参数按照性质可分为必要参数和可选参数。可选参数用[]表示。<br>( ~% P$ W2 A n& Y( `/ e
指令的执行结果的格式与此类似，由指令的名称和返回的执行结果代码（整型值）组成。<br>' O4 C2 r, P& T
执行结果代码为0 表示成功，其他值的含义与指令相关。<br>8 v( w6 B/ F" s% y1 t7 V
三、指令描述<br>
$ u0 m' r$ e3 V9 O4 C' K1、 ePowerOn<br>5 r5 y# o2 J0 |- `. H
功能：机芯开机<br>
7 Q9 h% R. { S: M格式：ePowerOn[_WallName][_ProjNo]↵<br>& j6 s+ n3 E8 O! Z9 w! j
参数：<br>8 W# x/ O$ p* b" y3 t
WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙，此时ProjNo<br>
# w4 ~6 x- s9 v; w9 X! g" v也必须省略。<br>/ L- g. w2 J" e) [. e. u. g
ProjNo：要进行该操作的机芯编号。如果省略或为0，表示指定拼墙的所有机<br>
" T& R. T; e! @1 s) l; V( w- @: Q7 W芯。<br>8 R% c6 y$ ^/ N' \9 f5 {: A
执行结果：ePowerOn_nResult↵<br>
{' k! ^5 u y8 f( o2 SnResult 可能取值：<br>% J! ^+ o* X' k. N9 Q. s2 ~
0：成功；<br>' }1 q2 g x/ B. h$ u' m1 q7 H; @
1：串口控制功能被禁止；<br>
+ n2 Z) M6 \, L1 f. k2：非法的指令名称；<br>' j! P! c8 }' H/ e( S) E- S
3：非法的拼墙名称；<br>
" r1 n; E3 [* ~; k6 P: y$ C9 D. w, L9 I4：非法的机芯编号；<br>2 u% I+ y# y: u! d& J
5：操作失败。<br>
( P& }* |% E3 @" {9 _2、 ePowerOff<br>
1 K/ J1 {+ b4 E b p$ v' ^功能：机芯关机<br>
' n3 ?2 h) z V6 m4 g* w2 ^格式：ePowerOff[_WallName][_ProjNo]↵<br>
& w6 w; {6 f7 K8 h M# T6 E参数：<br>. i/ x) A% h5 Q$ y, \( J% y: G" w
WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙，此时ProjNo<br>
5 j' n1 ^+ o/ w, [0 M# T4 R也必须省略。<br>
; p9 S5 a. w! T* N" ZProjNo：要进行该操作的机芯编号。如果省略或为0，表示指定拼墙的所有机<br>; j, E+ B3 m6 O( \# \7 R
芯。<br>4 t4 B( Z4 v; A1 L
执行结果：ePowerOff_nResult↵<br>7 x0 m/ T; S! ^2 I" S5 f$ |/ p- ^, u
nResult 可能取值：<br># v: W4 V8 @0 ^/ g! C5 n8 X, R
0：成功；<br>; }$ a; v" K" N; w, W
1：串口控制功能被禁止；<br>+ O, w: M4 p% f# O
2：非法的指令名称；<br>
1 {! f0 F- H, \1 `% p8 {3：非法的拼墙名称；<br>9 l, T; j, u: [
4：非法的机芯编号；<br>% s$ n C b; P- k
5：操作失败。<br># T) V' v' n4 ^
3、 dPowerOn<br>
; p! X7 G) a: z+ \0 r; \$ Y1 n功能：多功能显示设备开机<br>9 I, o) v- y/ r0 N' H' x
格式：dPowerOn_DevName↵<br>
; z) V4 k$ K3 O$ U, g# |. q参数：<br> R7 [- x3 }- }# Y
DevName：要进行该操作的多功能显示设备的名称。<br>; q3 @3 m$ V# C
执行结果：dPowerOn_nResult↵<br>
! x( `) g9 \2 V" F9 }# ynResult 可能取值：<br>6 l& X# }# Y* E0 N( @$ k# f
0：成功；<br>( b; p. T6 @4 V, U x: |; D
1：串口控制功能被禁止；<br>
& x. G* g9 e! l8 U$ c9 ~- A2：非法的指令名称；<br>
* r! e0 U) J" l4 ]! @3：非法的多功能显示设备名称；<br>6 @) U/ I4 b4 \ |+ A/ R- d% |4 t+ j
4：操作失败。<br>& |9 y" d* m) c6 O, S3 s4 R
4、 dPowerOff<br>. y# Q7 S8 ?5 o* U7 Y3 H4 L
功能：多功能显示设备关机<br>+ t, g) s! P9 R9 \0 b
格式：dPowerOff_DevName↵<br>
4 J! i$ i! _8 Z) U* s& [参数：<br>
7 i, x; K# j& R) j# ]1 FDevName：要进行该操作的多功能显示设备的名称芯。<br>
" h* J/ d" }8 B! i% G执行结果：dPowerOff_nResult↵<br>
: a' V: N% U# ?4 m& }nResult 可能取值：<br>3 a! w( c0 b u8 [) T
0：成功；<br>
/ A% [1 h, d7 P+ U3 ?( H0 c1：串口控制功能被禁止；<br>
* R9 h$ x; w7 h$ z4 Z6 p, }2：非法的指令名称；<br>' _, A% p% P0 M3 a- F
3：非法的多功能显示设备名称；<br>
- y$ T3 e+ b. H0 X5 E2 `4：操作失败。<br>
2 y4 x3 {6 u z& B7 ]& b# o3 H( ?9 G5、 eCloseWin<br>
4 Q" r' K: I% }3 Y4 E; ?功能：关闭所有机芯直通窗口<br>
9 m+ |! D" C( a1 K) z格式：eCloseWin[_WallName]↵<br>/ p F# ]0 c1 l$ {& M, k( }* o# f
参数：<br>" E# G: S9 @# }0 M) a
WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙。<br>
+ l. \# M7 t' s3 }6 `" b) P1 H& M$ F执行结果：eCloseWin_nResult↵<br>( ?! ]/ s' s6 E- N
nResult 可能取值：<br>8 g/ r* `7 l' \. _, L% j
0：成功；<br>: \5 `1 V. k4 p! O- S+ c
1：串口控制功能被禁止；<br>
- ]) x% A; A, X+ J# @2：非法的指令名称；<br>$ n1 U, ^/ v3 `1 ?' k+ T5 _
3：非法的拼墙名称；<br>
# z: W% g1 {0 \/ U# F) j9 ?4：操作失败。<br>% s: i |4 ^' q* l" ?
6、 pCloseApp<br>- n9 w0 l% V' B: K
功能：关闭所有处理器应用实例<br>
, q3 u" b, ~5 D9 r格式：pCloseApp[_WallName]↵<br>
. W, T4 U) \# R参数：<br>; M) e1 }, T; F- W- Q5 I
WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙。<br>
- @( [, E( v0 X+ I+ o B3 c h执行结果：pCloseApp_nResult↵<br>
& A3 x$ X% i8 v0 D: WnResult 可能取值：<br>
$ {/ O5 ?5 V' W/ f0：成功；<br>
: z( c; ]% p: G4 j6 `1：串口控制功能被禁止；<br>+ Q; T! L2 x3 W- i: \* U0 e
2：非法的指令名称；<br>) l% K J) M3 X; L3 `
3：非法的拼墙名称；<br>
) A2 z; `! L, k# Y K4：操作失败。<br>
) }+ {8 X7 X! B- Z( [4 t7、 pCloseWin<br>% w$ h, g* m" S& q8 N+ ?! P
功能：关闭所有处理器窗口<br>
4 X2 m5 [9 _$ L- m( i' g4 k格式：pCloseWin[_WallName]↵<br>+ N7 o, u+ ]( ^8 N$ ?6 g( L
参数：<br>6 q/ b+ i" ^! @' q% l2 v
WallName：要进行该操作的拼墙的名称。如果省略，表示所有拼墙。<br>' }3 S9 M$ \% \+ j7 o+ e& N& R
执行结果：pCloseWin_nResult↵<br>+ O: ]& g9 z) U) {5 U8 A {
nResult 可能取值：<br>* V0 L# R* \4 R- c4 A' b# `" Y" _
0：成功；<br>; v* {) z$ s2 Y1 X
1：串口控制功能被禁止；<br>2 w1 x" s) r' ~+ J }
2：非法的指令名称；<br>
' \: c3 A9 {+ n- @" _: W3：非法的拼墙名称；<br>1 N* [1 o" |: L
4：操作失败。<br>/ `$ ?6 G4 @2 S3 r
8、 mApply<br>) V9 ]3 g. M+ b8 T2 D
功能：执行已经定义的模式<br>
' I# { N0 F+ ^2 V0 ?0 d% _+ _格式：mApply_ModeName↵<br>
$ C2 M s2 F! W. I3 f参数：<br>
# |0 z: y, \6 Q* l2 HModeName：要执行的模式的名称。<br>4 v0 W7 T5 e4 a* {; h
执行结果：mApply_nResult↵<br>( A3 _/ r! O6 }. O; R# T
nResult 可能取值：<br>
1 w4 X% y) S) ?3 A# `0 i3 D% ^* X: C- [0：成功；<br>: ^( w9 Z+ i2 Z
1：串口控制功能被禁止；<br>
2 `# t- M: ~* r: @2：非法的指令名称；<br>' Z! |) {- [1 ^! a& ?( v
3：非法的模式名称；<br>3 t& g8 `- w, }0 B4 [+ \
4：操作失败。<br>
, v6 |, J9 b o' h( o" v9、 sSelVideo<br>
$ {1 U0 ^6 ]- i" v1 x* l; i! [: S功能：将一个VIDEO 信号源选择切换到一个监视器<br>4 ^6 b. @) L- @ G: I8 K
格式：sSelVideo_SouName_DevName↵<br>
& l) O6 E- ^ w9 P! q参数：<br>/ O4 b: \% Q ~/ j4 Y0 X1 y
SouName：要切换的VIDEO 信号源的名称。<br>
+ V) N. e# V# F$ I0 g, Q+ m, fDevName：要显示该信号源的监视器的名称。<br>- @% B/ o" P& W; G" T$ T+ K
执行结果：sSelVideo_nResult↵<br>8 \5 [, ?( k2 p$ \3 \1 S5 A
nResult 可能取值：<br>
1 P5 P# L. I: }" `) i0：成功；<br>( N C" |/ U/ k! s+ [ d1 ^. y/ J
1：串口控制功能被禁止；<br>1 ]3 B1 K2 [8 G- ^4 l+ z
2：非法的指令名称；<br>
9 R: s4 }9 N8 o: K# s3：非法的信号源名称；<br>
. k# m! J! V$ ?4：非法的监视器名称；<br>6 P# N2 Q0 j: ~2 K5 M
5：操作失败。<br>3 |% v8 o7 ^: ]2 e* G# |" i! q4 ^
10、 sSelCamera<br>
7 ^- ?( k( l* n& D/ X# M功能：将一个摄像头信号源选择切换到一个监视器<br>
. g0 @, B/ P% o' I$ N) {格式：sSelCamera_SouName_DevName↵<br>7 N* C* P+ M" `- n9 g
参数：<br>' k/ n+ B! x0 h7 o( V6 H
SouName：要切换的摄像头信号源的名称。<br>. r1 {/ Y/ Z% e! ?9 T- X
DevName：要显示该信号源的监视器的名称。<br>
4 J. W& D, z; K执行结果：sSelCamera_nResult↵<br>
8 L' }4 I/ V5 y! k( }nResult 可能取值：<br>+ N0 i5 l% ?7 N2 K/ [
0：成功；<br>
# o" l& v+ s' [- H" c& l1：串口控制功能被禁止；<br>+ S+ h" G: j2 j; }
2：非法的指令名称；<br>
" c+ P) L$ Q6 ^2 a3 w9 I! l3：非法的信号源名称；<br>
0 X5 E+ i" D+ |: b: C% E4：非法的监视器名称；<br>3 ^; U5 H# v6 T: q" B/ S- q
5：操作失败。<br>
9 w% I9 j$ y4 h2 x \% R; f R11、 sSelRGB<br>
( j/ b* z; K& N: A& l4 u! ^功能：将一个RGB 信号源选择切换到一个显示器<br># p% r. ^% D: m& F( R9 a* j$ J
格式：sSelRGB_SouName_DevName↵<br>
4 \ Z0 H5 j: ]7 q; X参数：<br>
2 f5 `' ^- ^, h, m" U3 }SouName：要切换的RGB 信号源的名称。<br>$ L7 Q$ v2 u7 ]0 |
DevName：要显示该信号源的显示器的名称。<br>
) K2 _( v" v7 }8 q& r执行结果：sSelRGB_nResult↵<br>
! t$ Q R) n/ z: u( dnResult 可能取值：<br>
( k/ f ^' d3 P0 e& I0：成功；<br>
6 \# G4 X& Q8 z7 y/ E% u3 b, ^1：串口控制功能被禁止；<br>: |" W3 l! b" \6 U8 M, R8 V
2：非法的指令名称；<br># G) u+ ~7 G6 S4 j8 L
3：非法的信号源名称；<br>
. e7 H& D: F! }# [4：非法的显示器名称；<br> a; y$ I! m9 u% K4 {
5：操作失败。<br>: O M3 }% x+ O5 v/ V
12、 sSelAudio<br>
% w0 T2 B/ {- U# X功能：将一个AUDIO 信号源选择切换到一个播放器<br>
# S/ v- X3 k, B+ n0 C格式：sSelAudio_SouName_DevName↵<br>
- @' l( P6 h" j( {5 i参数：<br>
5 i0 U B) K& c; ^* d/ _ `SouName：要切换的AUDIO 信号源的名称。<br>2 w6 {. F& g G0 D7 k5 f& S
DevName：要显示该信号源的监视器的名称。<br>' n' X+ Z6 L. ~: T, U9 y% v _2 I" x* e: ~
执行结果：sSelAudio_nResult↵<br>% Z" x+ [+ Z* r: G
nResult 可能取值：<br>- A4 N; A7 H- E5 k
0：成功；<br>
* {, `: I4 s i: f- w1：串口控制功能被禁止；<br>0 c1 b3 M a8 A* V) y
2：非法的指令名称；<br>
/ @9 [( p2 ?2 {, W3 ]' n3：非法的信号源名称；<br>" J6 s1 ]: R, i) e, c: ]2 ?
4：非法的播放器名称；<br>
( |- I* P# y7 i' M" }4 i5：操作失败。<br>
* S% u9 V+ d2 A1 t5 ]; l' B13、 sSelVideo2MFD<br>
( O& d5 p' N2 r" g功能：将一个VIDEO 信号源选择切换到一个多功能显示设备<br>2 P- G0 h/ K3 q5 }
格式：sSelVideo2MFD_SouName_DevName↵<br>
+ q) J0 k; E! n5 @2 H' k* |参数：<br>
, ]- G7 H' h6 \4 V9 USouName：要切换的VIDEO 信号源的名称。<br>3 {" d) c% A! F: X. R
DevName：要显示该信号源的多功能显示设备的名称。<br>4 c, J5 y, F j% J; v
执行结果：sSelVideo2MFD_nResult↵<br>
3 n# ]. M( g% L- snResult 可能取值：<br>1 ~# E \: j, n' q5 X4 b. h1 E
0：成功；<br>3 R& X V% d; A4 U0 J0 |1 ~6 m8 V
1：串口控制功能被禁止；<br>
4 M2 A& F) j: M. B$ _2：非法的指令名称；<br>' A8 C3 J( U! s8 r# s0 t- Y! t/ W
3：非法的信号源名称；<br>, ~9 f$ x9 C2 \0 d' V# @/ }
4：非法的多功能显示设备名称；<br>
! e& y$ T1 p* [1 a# Y8 G, K/ d2 Z$ M5：操作失败。<br>
9 U2 |- j8 a* N14、 sSelCamera2MFD<br>4 W# w% l# M. l! W; _% h6 R8 k" v
功能：将一个摄像头信号源选择切换到一个多功能显示设备<br>+ N0 `3 k3 K: f1 b
格式：sSelCamera2MFD_SouName_DevName↵<br>
2 O, {& |. |, [9 o参数：<br>
7 B3 L7 ]5 j% i, ?$ bSouName：要切换的摄像头信号源的名称。<br>
* S% _- y6 W$ y) a2 g& F. f2 |DevName：要显示该信号源的多功能显示设备的名称。<br>
* @( f- k9 k/ b7 C, R5 T执行结果：sSelCamera2MFD_nResult↵<br>
1 y- ?- n8 G. j7 B' r1 cnResult 可能取值：<br>
, z( Y2 K/ L; ?4 T: I5 }0：成功；<br>
& M2 {7 Z9 F. y, p1：串口控制功能被禁止；<br>
' z: Z3 r8 T9 t2：非法的指令名称；<br>
) D& q% W$ g! r. S3：非法的信号源名称；<br>- ^: N5 K. M0 P, h% F3 Q) F: O
4：非法的多功能显示设备名称；<br>
# Y j% b# c7 b* u$ v4 h5：操作失败。<br>8 P. |- n2 N& s6 o
15、 sSelRGB2MFD<br>
0 F0 \& C& k8 d% l1 ~& Y: Y功能：将一个RGB 信号源选择切换到一个多功能显示设备<br>
o3 ]3 T% X o* m9 n2 a- c格式：sSelRGB2MFD_SouName_DevName↵<br>7 R* }6 Q& n4 M
参数：<br>. o: ~. Z9 q6 g+ z2 ^7 I7 j2 b: I: V2 L
SouName：要切换的RGB 信号源的名称。<br>" ]9 R5 }4 b; i5 E. a
DevName：要显示该信号源的多功能显示设备的名称。<br>7 Q" i7 z# x: m/ a! `8 C
执行结果：sSelRGB2MFD_nResult↵<br>, d2 r% k+ O5 b, x. W% @2 O2 U) h
nResult 可能取值：<br>
; i% X& Y7 I. d0 z) w/ x; ~0：成功；<br>5 U4 @: t0 Q4 R5 j: j9 ]3 H
1：串口控制功能被禁止；<br>6 C- M K4 o- f/ \+ B0 E% {% ^
2：非法的指令名称；<br>
4 T; q1 M6 X! a' `3：非法的信号源名称；<br> u; t( c- `0 K6 M# F8 N
4：非法的多功能显示设备名称；<br>9 _( I4 O6 b9 ~4 ?8 f9 N5 a
5：操作失败。<br>
$ R7 [5 s1 Z1 t7 y2 P$ z `16、 sSelAudio2MFD<br>- t# X$ `( ^/ I3 n) c& g, T
功能：将一个AUDIO 信号源选择切换到一个多功能显示设备<br>3 v6 H, Z9 }- t7 Z9 f- q; T
格式：sSelAudio2MFD_SouName_DevName↵<br>! G" y; r+ [$ `' C
参数：<br>/ l# d( B0 ?, I1 @' P M
SouName：要切换的AUDIO 信号源的名称。<br>
3 n+ |' T# E! [) fDevName：要显示该信号源的多功能显示设备的名称。<br>
9 r$ r( }2 A4 Z: ^& K* f& Y/ }+ r执行结果：sSelAudio2MFD_nResult↵<br>
* ^8 g9 Q3 [" H) r, i/ A& r+ O9 snResult 可能取值：<br>6 {, ]/ o5 S; E% n% u4 H' c8 l$ B
0：成功；<br>$ {) _' J# ?/ \/ r* m3 l& t
1：串口控制功能被禁止；<br>" B9 A8 c5 h4 [9 [" b1 C
2：非法的指令名称；<br>
* [6 r* N! ]/ Q" [- D2 J3：非法的信号源名称；<br>
- _4 @; e: c$ _1 [4：非法的多功能显示设备名称；<br>% K3 m% U7 t' |* I! `6 E8 {3 s
5：操作失败。<br>
- t6 F) g5 {" C7 v- I17、 cSendData<br>
, Q6 b1 v) y V功能：发送数据到指定串口<br>7 S. P/ o! k& `2 R: ~6 y! j
格式：cSendData_PortNo_PortSettings_Length↵Data<br>
. w* p5 v" v7 I) Z4 U) _参数：<br>: ^0 b' f5 _* V+ k5 z4 r
PortNo：串口名称，譬如COM1<br>- S9 P7 ?, g9 p, {% M! ~! Y
PortSettings：串口设置，譬如9600,n,8,1<br>
2 Z. D, t6 ]( c. _Length：发送的数据长度<br>
5 w& C- V" f0 K, Z% m( fData：发送的数据。<br>
+ R" c5 f) L1 n. K) T6 D$ Q }" N1 a执行结果：cSendData_nResult↵<br>
$ W5 b, M' z6 X/ R& V% S1 M4 Z' ?nResult 可能取值：<br>; ?/ {% S' W5 d/ I
0：成功<br>' t* V& L9 }. X7 |, b* F
1：串口控制功能被禁止<br>, N( N; n" j7 [1 s+ E, E( u
2：非法的指令名称<br> l" I/ Y' @4 l, `2 w. U( i$ y
3：非法的端口名称<br>
+ S# b- a& w! w' D0 v/ z7 _3 W4：非法的串口设置<br># w& C9 o; e) m
5：操作失败。 |
|
|手机版|Archiver|XYCAD中国音响设计网
( 京ICP备14030947号 )
IP卡
狗仔卡
发表于 2006-9-11 17:55
提升卡
置顶卡
沉默卡
喧嚣卡
变色卡
显身卡