7
Planar UltraRes X Series RS232 User Manual
020-1397-00B
Page | 7
• TERM is the termination character for the command. This can either be the ASCII carriage
return character (0x0D), the ASCII line feed character (0x0A) or a semicolon. The
response will use the same termination character.
4.2 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).
4.3 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”
bri [CR]
BRIGHTNESS:101 [CR]
Increments the current Brightness
value
brightness- [CR]
BRIGHTNESS:100 [CR]
Decrements the current Brightness
value
gain = 101 102 103 [CR]
GAIN:101 102 103 [CR]
Example command with multiple
operators (sets Red Gain to 101,
Green Gain to 102 and Blue Gain to
103, on the current zone)
gain(current red)+
GAIN(CURRENT RED):102
Increments the Red Gain on the
current zone
gain(zone.1, all) = 104,105,106
GAIN(ZONE.1 ALL):104 105 106
Example command with multiple
modifiers, multiple operators and
different separators between the
modifiers and operators (sets Red
Gain to 104, Green Gain to 105 and
Blue Gain to 106, on Zone 1)
