Barco FL35, Command Reference Manual

Page: 8 / 24

2. Communication protocol definitions
Mnemonic Modi fi er Value Target
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 mnemonic is a 4 byte ASCII command (key identi fi er). This is required in all serial communications.
Modi fi er byte (1–2 bytes)
The modi fi er is used to constrain or modify the mnemonic command.
Modi fi er Description
R
Relative change. Given value will be relative to existing value. e.g. BRIG10 will increase brightness by 10 steps.
A Not normally used. Manually request acknowledgement/read back the result of the command.
? Get current value
?M Get maximum value
?N Get minimum value
?D Get default value
?S Get default step value
Terminator
The terminator informs the projector (in case of transmission) or the computer (in case of reception) that the data transfer is complete
and that the interpretation of the command and data bytes can start.
Acknowledgement
If the command is understood by the projector then an ’ACK’ command is sent back. The ’ACK’ command uses the following protocol:
Ack. Address Separator Command Separator Value Terminator
Limitations 1 byte 1–3 bytes 1 byte 4 bytes 1 byte 6 bytes 1 byte
De fi nition ASCII % Projector
address ASCII space Mnemonic ASCII space Numeric
value Carriage
Return (Hex
0x0D)
Example
% 001 Space POWR Space 000001 CR
Some commands could return a value that is more than 6 bytes, for example, strings. This is identi fi ed by the acknowledgement
including the alphanumeric value ’eXXXXX’.
Address functionality is no longer used. Address bytes 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 error message in the value fi eld.
Ack. Address Separator Command Separator Value Terminator
Limitations 1 byte 1–3 bytes 1 byte 4 bytes 1 byte 6 bytes 1 byte
De fi nition ASCII % Projector
address ASCII space Mnemonic ASCII space Numeric
value of error Carriage
Return (Hex
0x0D)
Example
%
001
Space POWR Space
!00001
CR
Error code Error message Description
!00001 Access denied User does not have suf fi cient access rights to perform this command.
4 601–0381–00 F(L)35, FS35 IR, F85 21/10/2015