ETC Emphasis Lighting Control System, User Manual

Page: 210 / 292

200 Emphasis Console v1.4.0 User Manual
Emphasis Serial Button Protocol
Emphasis Serial Button Protocol (SBP) allows you to send commands to your Emphasis
Control System through a serial connection.
Commands
Commands are either quoted strings, strings of digits or keywords with associated
arguments. The argument types are specific to each keyword.
A quoted string will pass each of the characters to Emphasis Console as un-interpreted
characters. This is the same as typing on a keyboard plugged into a Facepanel or the
Emphasis Server keyboard when the Emphasis Console application is visible, or in
Emphasis mode. Because of this you can use some of the Emphasis Console keyboard
shortcuts. For example, c1t5f will be interpreted by Emphasis Console (if you’re not in label
mode) as [Channel] [1] [Thru] [5] [Full] . Serial Button Protocol communicates with
Emphasis Console only, so you cannot use any of the Emphasis Visualization shortcuts
here.
Digits that appear outside of arguments for keywords will be interpreted as pressing the
appropriate numeric keys on the Facepanel.
Individual commands are normally separated by a space, a tab or a semicolon (;). Adjacent
commands only have to be separated if they both are alphabetic (a-z). Commands cannot
span more than one line.
Arguments
Arguments come in three types:
•
Numeric. . . . . . . . . This is a string of digits interpreted as a number. Numeric
arguments can be preceded by “+” or “–”. Negative numbers are
normally only used for wheel movements.
e.g.:-12345
• Cue Name . . . . . . . This is a string of digits (and possibly a decimal point) interpreted
as a cue name. Only three digits before and one digit after the
decimal point are supported.
e.g.:123.4
• Level . . . . . . . . . . . This is used for pot, channel and dimmer levels. It is normally a
number between 0 and 100 and is interpreted as a percentage. An
optional “%” can follow the number.
If the number is followed by a “#”, it is interpreted as 0-255. 100,
100% and 255# all mean full.
FL will be recognized as 100%. Case is ignored.
Levels will normally be preceded by the @ symbol but it is not
necessary.
e.g.:100, 100%, 255#, FL, fl . . . . . . . . . . All these mean full.
In the table at the end of this document arguments are indicated as follows:
•
# . . . . . . . . . . . . . . numeric
• Q . . . . . . . . . . . . . . cue name
• L . . . . . . . . . . . . . . level
• @. . . . . . . . . . . . . . at sign before level (This can be left out).