2. Communication protocol definitions
Mnemonic
Modifier
Value T arget
Limitations 4 bytes 1 byte N bytes, max 6 bytes N bytes, max 4
Inclusion Required
Optional Optional Optional
Example
POWR
A
1
CR
Mnemonic bytes (4 bytes)
The m nemonic is a 4 byte ASCII com mand (key identifier). This is required in all serial comm unications.
Modifier byte (1–2 bytes)
The modifier is used to constrain or modify the mnemonic comm and.
Modifier
Description
R
Relative cha nge. Given v alue will be relative to existing value. e.g. BR IG10 will increase brightness by 10 steps.
A
Not normally used. Manually request acknowledgement/read bac k t he result of the com mand.
? Get cu r ren t value
?M Get ma ximum value
?N Get m inimum value
?D Get default value
?S Get default step value
Terminator
The t erminator informs the projector (in case of transmission) or the computer (in c ase of reception) tha t the data transfer is complete
and that the interpretation of t he comm and and data by tes can start.
Acknowledgement
If the com mand is understood by the projector then an ’ACK’ comm and is sent back. The ’ACK’ c omm and uses the following protocol:
Ack. Address
Separator Command Separator
Value Terminator
Limitations 1 byte 1–3 by tes 1 byte 4 bytes 1 byte 6 bytes 1 byte
Definition ASCII %
Projector
address
ASCII space
Mnemonic
ASCII space
Numeric
value
Carriage
Return (Hex
0x0D)
Example
%
001
Space POWR Space
000001
CR
Some commands c ould return a v alue that is more than 6 bytes, for example, strings. This is identified by the acknow ledgement
including the alphanumeric va lue ’eX XXX X’.
Address functionality is no longer u sed. Addres
s b ytes will always be 001.
For example:
> :seri ?
> %001 SERI e00001 07010001
Invalid command
If the input command is not valid, then the projector acknowledgement may include an er ror m essage in the value field.
Ack. Address Separator Command Separator Value Terminator
Limitations 1 byte 1–3 by tes 1 byte 4 bytes 1 byte 6 bytes 1 byte
Definition ASCII % Projector
address
ASCII space Mnemonic ASCII space Numeric
value o f error
Carriage
Return (Hex
0x0D)
Example
%
001
Space POWR Space
!00001
CR
Error code Error message Description
!00001 Access denied
User does not have su fficient access rights to perform this com man d.
4 601–0381–00 F(L)35, FS35 IR, F85 21/10/2015