This chapter guides the operator on creating CTM scripts for devices based on the GVG M2100 protocol (e.g. GVG and Quartz master control switchers). Messages containing the commands to be executed must be inserted within CTM scripts in hexadecimal notation and formatted using a "1-byte" syntax as shown in the following table:
Byte 1
Field - STX
Description: Start of transmission.
Byte 2
Field - ByteLen0
Description: Byte length of the whole message. Does not include the stx itself or the checksum.
Byte 3
Field - CmdClass1
Description: Classification of command to follow.
Byte 4
Field - ByteLen1
Description: Number of bytes for cmdClass1. Does not include itself.
Byte 5
Field - SubCmd1
Description: A command belonging to the preceding cmdClass.
Byte 6-n
Field - Cmd1Data
Description: Optional data associated with subCmd1 (variable number of bytes).
Byte n+1
Field - Checksum
Description: Twos-complement the sum of all bytes in the message (excluding STX).
NB: For detailed information on supported values (i.e. features), please refer to the proper documentation of the used device.
Sample of use
For instance, to create a CTM script for enabling and disabling specific logos, It is required to create one CTM script for each logo to enable and one CTM script for disabling each one of those logos.
In this particular case, messages can be entered using only the fields between CmdClass1 and Cmd1Data excluding ByteLen1, omitting the 1st byte (STX), the 2nd bytes (ByteLen0), the 4th byte (ByteLen1) and the last byte (Checksum) since the device driver automatically calculates them before transmitting them.
In order to enable the Logo 123 the message will be made as follows:
CmdClass1 = 0x01 (CMD = command sent from the automation)
SubCmd1 = 0x76 (MEDIA_IN = activate a certain logo)
Cmd1Data = 0x31 0x32 0x33 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
(123 in ASCII notation followed by 13 characters 0x00 to reach the total length of 16)
Whereas to disable the logo 123 the message will be structured as follows:
CmdClass1 = 0x01 (CMD = command sent from the automation)
SubCmd1 = 0x77 (MEDIA_OUT = deactivate a certain logo)
Cmd1Data = 0x31 0x32 0x33 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00
(123 in ASCII notation, followed by 13 characters 0x00 to reach the total length of 16)
Therefore, the commands to be entered in the CTM script to enable and disable the logo 123 will be respectively:
•For enabling the logo 123 : 01 76 31 32 33 00 00 00 00 00 00 00 00 00 00 00 00 00
•For disabling the logo 123 : 01 77 31 32 33 00 00 00 00 00 00 00 00 00 00 00 00 00