Protocol Encoding
Planar UltraRes Series RS232 User Manual 7
• OPERAND indicates the data to be sent with the message. In some cases, there
can be multiple operands. See the “Operands”column in the table.
• Enumerated operands can be written either with their named value or their
numeric value (see "Examples" on page 7).
• String operands are written with quotation marks at the beginning and end.
Example: “this is a string operand”.
• Integer (or signed integer / unsigned integer) are always numeric values.
• Note that enumerated and integer values can be written either in decimal or
hexadecimal. For example, a decimal value of ‘50’ can be written in
hexadecimal as ‘0x32’.
• TERM is the termination character for the command. This can either be the
ASCII carriage return character (0x0D) or a semicolon. The response will use the
same termination character.
Protocol Encoding
• All parts of the command structure are case insensitive (e.g. “BRIGHTNESS”,
“brightness” and BrIgHtNeSs” are all the same). Responses will always be in
capital letters.
• Excessive white space is allowed (e.g. “BRIGHTNESS=50”,“BRIGHTNESS = 50”
and “BRIGHTNESS = 50” are all the same).
• Modifiers and operands can be separated by commas, spaces or both (e.g.
“GAIN=100,100,100”, “GAIN=100 100 100” and “GAIN=100, 100, 100” are all the
same). Responses will always separate with one space between modifiers and
operands).
Examples
Note: [CR] is the ASCII carriage return character (0x0D).
Command Response Notes
brightness = 100 [CR] BRIGHTNESS:100 [CR] Sets the Brightness value to 100
brightness = 100; BRIGHTNESS:100; Also sets the Brightness value to 100,
but uses the ‘;’ termination character
instead of [CR]. The response uses the
same termination character.
200=100 [CR] 200:100 [CR] “200”is the numeric command code for
“BRIGHTNESS”
brightness+ [CR] BRIGHTNESS:101 [CR] Increments the current Brightness
value
brightness- [CR] BRIGHTNESS:100 [CR] Decrements the current Brightness
value
