What Is Sent In A Message; Maximizing Message Integrity - Christie Boxer 30 Technical Reference

Options
Query enabled state
Query minimum/maximum

What is sent in a message

Although you send and read messages as strings of ASCII characters, the actual message travels as a
sequence of bytes. Each character in this sequence requires one byte.
The following example illustrates a lamp limit is 2000 hours reply from the projector.
ASCII = ( L
HEX = 0x28 0x4

Maximizing message integrity

For additional reassurance and/or maximum message integrity, insert one or two special characters.
Message Description
requirement
Acknowledgments For assurance from Boxer 30 (or group of projectors) that a set message has been
processed, request an acknowledgment.
The acknowledgment is returned after the message has been received and fully executed
by Boxer 30 (such as in the case of a source switch it is not sent until the switch is
complete). If the message cannot be executed for some reason (such as invalid
parameters, time-out, and so on) a NAK is returned instead (not-acknowledge).
Requesting an acknowledgment serves no purpose when included in a request message,
as the acknowledgment is redundant to the actual reply from Boxer 30. However, if
requested, the dollar sign ($) acknowledgment from Boxer 30 follows the reply.
There are two types of acknowledgments:
This is a quick way to confirm success with set messages and is useful with long distance
communication links or where the projectors and/or images are not visible from the
controller. Acknowledgments can also be a type of flow control.
Checksums For maximum message integrity, add a checksum character ampersand (&) just after the
start code bracket. You must also include the correct checksum total (0-255) just before
Boxer 30 Technical Reference–Serial API Commands
020-102096-08 Rev. 1 (08-2020)
Copyright © 2020 Christie Digital Systems USA, Inc. All rights reserved.
Function
QUERY test pattern enabled state
REPLY test pattern (enabled)
REPLY test pattern (disabled)
QUERY gamma slider minimum/
maximum
REPLY gamma minimum/maximum
P L
0x50 0x28
• Simple Acknowledgments—Insert a dollar sign ($) character just after the start code
bracket. This only returns a $. This only returns a dollar sign ($) on success, or a
caret (^) on failure (NAK).
• Full Acknowledgments—Insert a hash (#) character just after the start code bracket.
This returns the message sent, as a reply.
Communicating with Boxer 30
Example
(ITP?E)
(ITP!E000)
(ITP!E001)
(GAM?M)
(GAM!M1000 3000)
! 2 0
0x21 0x32 0x30
0 0 )
0x30 0x30 0x29
12