Chapter 35. ChamSys Remote Protocol Commands

ChamSys remote protocol consists of simple commands consisting of a list parameter values separated by commas ‘,’ and ending in a character A to Z (or a to z). Commands can contain spaces, tabs, and carriage returns; they are all ignored.

The remote protocol is split into remote playback commands and remote programming commands.

35.1. Remote playback commands

The commands are:

<playback number> A

Activate playback

<playback number> R

Release playback

<playback number> T

Test playback (activate with level 100%)

<playback number> U

Un-test playback (release with level 0%)

<playback number> G

Go on playback

<playback number> S

Stop (go back) on playback

<playback number> B

Fast back on playback (no fade)

<playback number> F

Fast forward on playback (no fade)

<playback number> , <level> L

Set playback fader level

<playback number> , <cue id> , <cue id dec>J

Jump to Cue Id on playback

<page number> P

Change page

<channel number> , <level> I

Set intensity channel to level

<program command number> H

Remote programming command

<button id> X

10Scene zone 1 button

<button id> , <state> X

10Scene zone 1 button press or release

<zone id> , <button id> , <state> X

10Scene zone button press or release

The following parameter values are supported

<playback number>

a number between 1 and 10 (202 on MagicQ consoles)

<level>

an integer between 0 and 100.

<page number>

an integer between 0 and 100

<channel number>

an integer between 1 and 32769 DMX channel number

<cue id>

an integer between 1 and 65536

<cue id dec>

an integer between 0 and 99. Note that for Cue ID 1.5 use 50

<button id>

an integer between 1 and 10

<zone id>

an integer between 1 and 20

<state>

1 for button pressed, 0 for button released, 2 for activate, 3 for release

So for example, to set dimmer channel 4 to 50% you would use:

4,50I

To jump to Cue id 2.5 on playback 8 you would use:

8,2,50J

Commands can be sent back to back – e.g.

1A2A1S2G3,4I

MagicQ on PC and Mac only supports control of the first 10 playbacks (PB1 to PB10). On MagicQ consoles all 202 playbacks can be controlled.

35.2. Remote programming commands

Remote programming commands enable simple programming actions to be carried out from a remote terminal. Remote programming commands consist of the program command number followed by parameters and completed with an "H".

The commands are:

\<01> , <start head> , [<end head>] H

Select one or more heads

\<02> , <start head> , [<end head>] H

Deselect one or more heads

\<03> H

Deselect all heads

\<04> , <group number> H

Select group

\<05> , <level> , [<time>] H

Set intensity of selected heads

\<06> , <attribute number> , <value> , [<time>] H

Set attribute value of selected heads

\<07> , <attribute number> , <value> , [<16bit>] H

Increase attribute of selected heads

\<08> , <attribute number> , <value> , [<16bit>] H

Decrease attribute of selected heads

\<09> H

Clear programmer

\<10> , <palette id> H

Include position palette

\<11> , <palette id> H

Include colour palette

\<12> , <palette id> H

Include beam palette

\<13> , <cue id> H

Include cue

\<19> H

Update

\<20>, <palette id> H

Record position palette

\<21> , <palette id> H

Record colour palette

\<22> , <palette id> H

Record beam palette

\<23> , <cue id> H

Record cue

\<30> H

Next head

\<31> H

Previous head

\<32> H

All heads

\<40> H

Locate

\<41> H

Lamp on

\<42> H

Lamp off

\<43> H

Reset

\<71>, <state> H

Remote trigger

\<80> , <Q id> H

Test Cue

\<81> , <Q id> H

Untest Cue

\<82> , <cue stack id> , <level> , <cue id> H

Test Cue Stack, level and cue id are optional (default to 100% and first cue)

\<83> , <cue stack id> H

Untest Cue Stack

\<90> , <show file id> H

Save show showXXXX.shw

\<91> , <show file id> H

Load show showXXXX.shw

\<92> , <import file id> H

Load show importXXXX.csv

\<93> , <import grid id> H

Load grid gridXXXX.csv

\<112> , <state> H

Emergency Hot takeover - <state> is 1 for On, 0 for Off.

\<911> , <state> H

Emergency Hot takeover - <state> is 1 for On, 0 for Off.

\<999> , <state> H

Emergency Hot takeover - <state> is 1 for On, 0 for Off.

[] indicates an optional parameter
The parameter values are:

<level>

an integer between 0 and 100

<palette id>

an integer between 1 and 1024

<Q id>

an integer between 1 and 5000 representing Q in the Cue Store

<16 bit>

0 for change in 8 bit resolution, 1 for change in 16 bit resolution

<time>

an integer time in seconds

<group number>

is an integer between 1 and 200

<start head> and <end head>

integers between 1 and 6145

<show file id>

four digit decimal number between 0000 and 9999.

<state>

is 0 or 1 to set state on/off, or 2 is toggle current state.

35.2.1. Attribute numbers

Intensity (0) Intensity Mode (1)

Pan (4) Tilt (5) Pos1 (46) Pos2 (47) Pos3 (48) Pos4 (49) Pos5 (50) Pos6 (51)

Cyan (16) Magenta (17) Yellow (18) Col mix (19) Col1 (6) Col3 (26) Col2 (7) Col4 (27)

Shutter (2) Iris (3) Gobo1 (8) Gobo2 (9) Gobo3 (28) Gobo4 (29) Rotate1 (10) Rotate2 (11) Rotate3 (30) Rotate4 (31) Focus (12) Zoom (13) Frost1 (32) Frost2 (33) FX1 (14) FX2 (15) FX3 (34) FX4 (35) FX5 (36) FX6 (37) FX7 (38) FX8 (39) Macro1 (22) Macro2 (23) Cont1 (20) Cont2 (21) Cont3 (40) Cont4 (41) Cont5 (42) Cont6 (43) Cont7 (44) Cont8 (45)