ChamSys Ltd www.chamsys.co.uk
MagicQ User Manual 268 Version 1.4.9.0
The protocol can also be used to remote control the MagicQ console or MagicQ PC software via a simple
set of text commands.
Note that the use of the ChamSys Remote Ethernet Protocol on MagicQ PC is only enabled when it is
connected to a MagicQ PC Wing.
On MagicQ commands are placed in the Macro field of the Cue Stack and are transmitted when the Cue
starts to execute. In addition MagicQ will accept commands received according to a pre-defined protocol.
31.1 ChamSys Remote Ethernet Protocol
Enable ChamSys Remote Ethernet Protocol in the View Settings view of the Setup Window.
ChamSys Remote Ethernet Protocol is an Open Protocol – i.e. you do not need permission to use it for
your own purposes. It is a UDP/IP based protocol using port 6553 in broadcast mode.
The structure of the UDP/IP packets are:
long32 chamsys;
word16 version;
byte seq_fwd;
byte seq_bkwd;
word16 length;
byte data;
where long32 is 4 bytes, word16 is 2 bytes and byte is 1 byte.
ChamSys is 4 characters C R E P. Note that on MagicQ this is stored as little-endian, so that on the
network it will appear as P E R C.
The version is initially 0 and allows for future expansion of the protocol.
The fwd sequence number is an incrementing sequence number. It enables the receiving end to determine
if packets are missed. In addition the receiving end should sends back the last sequence number it
received in the backward sequence number.
Length is the length of the data field. It does not include the length of the ChamSys header.
31.2 Writing to the Ethernet port
Commands are transmitted from the Ethernet port by placing the command in the Macro field of the Cue
Stack window (use Page Right to find the Macro field). In the View Settings view of the Setup Window,
set the Ethernet Remote Protocol to “ChamSys Rem tx”.
The format of Ethernet commands is Y followed by the data. To send Ethernet data, the Y command must
be the only macro command in the macro field. The Y command is followed by ASCII data contained
within “ “ or ‘ ‘ or by decimal values separated by commas. For example to send Hello World followed
by a carriage return:
Y”Hello World”,10,13
To send the hexadecimal data stream 00 01 02 03 04
Y0,1,2,3,4
To Next Page
Loading...
Need help?
General
