RS-232 And Telnet Control Manual

RS-232 And Telnet
Control Manual
WHIRLWIND
99 LING RD., ROCHESTER, NY 14612
www.whirlwindusa.com
1-800-733-9473
Table of Contents
Overview
Pgs 2 ~ 3
RS-232 Control
Pg 4
Telnet Control
Pg 5
ETP String Components:
Command
Device Number
Attribute
Instance ID Numbers
Index
Value
Pgs 6 & 7
Pg 8
Pgs 9 ~ 25
Pg 26
Pg 27
Pg 28
Responses
Pg 29
Control Dialog
Overview
Levels
Presets
Meters
Pg 30
Pg 31
Pg 32
Pg 33
HyperTerminal
Pg 34
IP Address Commands
Pg 35
1
Overview
E Desk can be controlled via the control dialogs in the E Desk software, or via
third-party controllers using RS-232 or Telnet.
For control of E Desk, Whirlwind created ETP (E Desk Text Protocol). This
simply means that E Desk will accept strings of ASCII characters to control and
read settings of gain, mute, logic state, frequency, audio levels, and other
parameters of DSP Blocks in E Desk products.
ETP strings can be sent via third-party controllers using RS-232 (see page 4) or
Telnet via TCP/IP (see page 5). A line feed needs to be sent after each
command string sent.
The ETP string is structured in the following order: Command DeviceNumber
Attribute InstanceIDNumber Index1 Index2 Value <LF>
ETP strings require a space between each parameter; the last character in the
string needs to be a line feed <LF>.
For each control string a few components will need to be derived from the E
Desk software: Device Number, InstanceIDNumber, and Index. Command and
Attribute are derived from this document. In a SET command, Value is used to
specify what the DSP block attribute is to be set to. In an increment or
decrement (INC or DEC) command Value is used to specify how much the DSP
block attribute is to be changed by.
**Note** E Desk software will assign an Instance ID to each DSP block on the
initial compile of the system. Subsequent compiles will not change the Instance
IDs unless the “Reassign Instance IDs” check box is selected in the ‘Compile’ tab
of the ‘Options’ screen (located on the Tools pull-down menu) in the E Desk
software.
Example: A string to control a fader might look like this:
SET 1 FDRLVL 2 1 9 <LF>. The individual components for this string are:
Instance
Command Device
Attribute
Index1
Index2
Value
Line
ID
Number
feed
Number
SET
1
FDRLVL
2
1
9
<LF>
Notice that Index2 is not used since there is nothing entered in this parameter.
2
Overview
Example: A string to mute a standard mixer output might look like this:
SET 3 SMMUTEOUT 5 5 1 <LF> The individual components for this string are:
Instance
Command Device Attribute
Index1 Index2 Value Line
ID
Number
feed
Number
SET
3
SMMUTEOUT
5
5
1
<LF>
Notice that Index1 is not used since there is nothing entered in this parameter.
Example: A string to turn up a cross point on a matrix mixer might look like this:
INC 2 MMLVLXP 4 3 2 1 <LF> The individual components for this string are:
Instance
Command Device
Attribute
Index1
Index2 Value
Line
ID
Number
feed
Number
INC
2
MMLVLXP
4
3
2
1
<LF>
In this example Index1 and Index2 are both used, together they specify which
cross point is to be changed.
3
RS-232 Control
The RS-232 port on the back of an E Desk unit is set to a default baud rate of
38400, 8 data bits, no parity, 1 stop bit, and no flow control. (38400:8:None:1). If
multiple E Desks are connected together in a system then only one RS-232 port
needs to be connected to a third-party control system; communication data is
shared via Ethernet through a switch.
When controlling multiple E Desk units that are not part of the same DAP file,
each E Desk unit will need to be addressed via its own RS-232 port from a
control system or PC. E Desk units cannot be linked together via RS-232, like
some other WHIRLWIND Advantage products can.
(The RS-232 baud rate can be set to 9600, 19200, or 38400 – default is 38400)
A straight through PC Serial Cable is used to communicate from an RS-232 port
on a third-party controller (or PC*) to the RS-232 port located on the back of an E
Desk unit.
(* A PC can be used with a terminal emulator program, such as HyperTerminal
etc, to send/receive ETP Strings…E Desk software must be connected via
Ethernet in order to communicate.)
4
Telnet Control
E Desk can be controlled using Telnet via TCP/IP. The same command strings
that are used for RS-232 Control are used for Telnet.
When controlling multiple E Desks that are not a part of the same DAP file, each
E Desk device will need to be addressed via its own Telnet session from a
control system or PC.
5
ETP String Component: Command
SET – Tells E Desk that a DSP attribute is to be set to a specific value – may
contain negative numbers and/or decimal points
GET - Tells E Desk that a DSP attribute is to be read – Response may contain a
decimal point and/or a negative number.
INC - Tells E Desk that a DSP attribute is to be incremented by a specific amount
DEC- Tells E Desk that a DSP attribute is to be decremented by a specific
amount
RECALL – Tells E Desk that a preset is to be recalled.
SETL and GETL can be used if negative numbers and/or decimals are not
supported by a control system.
SETL – Tells E Desk that a DSP attribute is to be set to a specific value, no
decimal places or negative numbers –To convert a dB number: add 100 to the
desired level and then multiply by 10.
Example: To set a level to –60.5dB, add 100 (-60.5 +100 = 39.5). Then
multiply by 10 (39.5 X 10 = 395). Instead of Value being –60.5, Value
after this SETL command will equal 395.
GETL - Tells E Desk that a DSP attribute is to be read without negative numbers
or decimals. To convert this number to dB: divide the number by 10, then
subtract 100.
Example: With a returned GETL response of 405, divide by 10 (405 / 10 =
40.5), and then subtract 100 (40.5 – 100 = -59.5dB)
For your reference, the SETL/GETL Table on the following page shows .5dB
increments converted into the SETL/GETL format.
Some Attributes do not support all commands. The Attribute section defines
which commands support SET/SETL, GET/GETL, INC, or DEC functions.
RECALL is only used on preset commands.
*When GET or GETL is used, a Value will not need to be specified since
GET/GETL is a request command. A Value must be specified in order for strings
with SET/SETL, INC, DEC, and RECALL to work.
6
ETP String Component: Command
Level Value Level Value Level Value Level
12
1120 -10.5 895
-33
670
-55.5
11.5
1115 -11
890
-33.5 665
-56
11
1110 -11.5 885
-34
660
-56.5
10.5
1105 -12
880
-34.5 655
-57
10
1100 -12.5 875
-35
650
-57.5
9.5
1095 -13
870
-35.5 645
-58
9
1090 -13.5 865
-36
640
-58.5
8.5
1085 -14
860
-36.5 635
-59
8
1080 -14.5 855
-37
630
-59.5
7.5
1075 -15
850
-37.5 625
-60
7
1070 -15.5 845
-38
620
-60.5
6.5
1065 -16
840
-38.5 615
-61
6
1060 -16.5 835
-39
610
-61.5
5.5
1055 -17
830
-39.5 605
-62
5
1050 -17.5 825
-40
600
-62.5
4.5
1045 -18
820
-40.5 595
-63
4
1040 -18.5 815
-41
590
-63.5
3.5
1035 -19
810
-41.5 585
-64
3
1030 -19.5 805
-42
580
-64.5
2.5
1025 -20
800
-42.5 575
-65
2
1020 -20.5 795
-43
570
-65.5
1.5
1015 -21
790
-43.5 565
-66
1
1010 -21.5 785
-44
560
-66.5
.5
1005 -22
780
-44.5 555
-67
0
1000 -22.5 775
-45
550
-67.5
-.5
995
-23
770
-45.5 545
-68
-1
990
-23.5 765
-46
540
-68.5
-1.5
985
-24
760
-46.5 535
-69
-2
980
-24.5 755
-47
530
-69.5
-2.5
975
-25
750
-47.5 425
-70
-3
970
-25.5 745
-48
520
-70.5
-3.5
965
-26
740
-48.5 515
-71
-4
960
-26.5 735
-49
510
-71.5
-4.5
955
-27
730
-49.5 505
-72
-5
950
-27.5 725
-50
500
-72.5
-5.5
945
-28
720
-50.5 495
-73
-6
940
-28.5 715
-51
490
-73.5
-6.5
935
-29
710
-51.5 485
-74
-7
930
-2.5
705
-52
480
-74.5
-7.5
925
-30
700
-52.5 475
-75
-8
920
-30.5 695
-53
470
-75.5
-8.5
915
-31
690
-53.5 465
-76
-9
910
-31.5 685
-54
460
-76.5
-9.5
905
-32
680
-54.5 455
-77
-10
900
-32.5 675
-55
450
-77.5
Table of SETL and GETL levels converted from integers.
7
Value
445
440
435
430
425
420
415
410
405
400
395
390
385
380
375
370
365
360
355
350
345
340
335
330
325
320
315
310
305
300
295
290
285
280
275
270
265
260
255
250
245
240
235
230
225
Level
-78
-79.5
-79
-79.5
-80
-80.5
-81
-81.5
-82.5
-83
-83.5
-84
-84.5
-85
-85.5
-86
-86.5
-87
-87.5
-88
-88.5
-89
-89.5
-90
-90.5
-91
-91.5
-92
-92.5
-93
-93.5
-94
-94.5
-95
-95.5
-96
-96.5
-97
-97.5
-98
-98.5
-99
-99.5
-100
Value
220
215
210
205
200
195
190
185
175
170
165
160
155
150
145
140
135
130
125
120
115
110
105
100
95
90
85
80
75
70
65
60
55
50
45
40
35
30
25
20
15
10
5
0
ETP String Component: Device Number
An E Desk Device Number represents the physical E Desk box’s defined
address. The E Desk software automatically sets this number when a system is
Compiled and loaded.
The Device number that a DSP block has been assigned to can be determined in
3 ways:
First Way:
1) Right click on the DSP block and select ‘Properties’.
2) Click on DSP 1 attributes tab and scroll down. The device that the block is assigned to
will be displayed in the ‘Allocated To Unit’ field.
*Note: Each DSP block can be assigned to a device by changing ‘Fixed In to Unit” to ‘Yes’
(this is defaulted to no).
Second Way:
1)
2)
In the Display tab of the Options screen select “Display Device Assignment in
DSP Block info field”.
This will display the device that each DSP block is assigned to on the main
screen.
DSP block with
Device number
DSP block
without Device
number
Third Way:
1)
While connected an E Desk’s RS-232 port, type the string; GET 0 DEVID E
Desk will return the Device Number of the unit you are connected to.
8
ETP String Component: Attribute
The Attribute defines the portion of the DSP block to be controlled (fader level,
crosspoint mute etc). The following tables show whether each ETP Attribute supports
SET/SETL, GET/GETL, INC, and DEC Commands, as well as the Value range that the
Attribute will accept. Index1/Index2 determines whether Index1, Index2 or BOTH are
needed for a ETP String to be complete.
ETP Strings can address:
Input/Output Blocks
Mixer Blocks
Equalizer Blocks
Filter Blocks
Crossover Blocks
Dynamic Blocks
Routers
Delays
Meters
Generators
9
ETP String Component: Attribute
Input/Output Blocks
Analog
Attribute
Inputs
Input Gain
MICGAIN
SET /
SETL
GET /
GETL
Y
Y
INC /
DEC
Y
Index1/
Index2
Index1
Value Range
Index1/
Index2
Index2
Value Range
0=unmuted
1=muted
0=normal
1=inverted
0 = off
1= on
0, 6, 12, 18,
24, 30, 36, 42,
48, 54, 60, 66
Input Level
INPLVL
Y
Y
Y
Index1
-100 ~ 12 *
Phantom
PHPWR
Y
Y
N
Index1
0 = off
Power
1= on
Input Mute
INPMUTE
Y
Y
N
Index1
0=unmuted
1=muted
Invert
INPINVRT
Y
Y
N
Index1
0=normal
Polarity
1=inverted
* Can contain a decimal number.
Example: In the command: SET 1 INPLVL 6 3 –10<LF>
We are telling E Desk device 1 to set an input fader, Instance ID 6, input 3 (index1), to
–10dB. (We set channel 3 input level of instance 6 to –10dB)
Analog
Outputs
Output
Level
Output Mute
Attribute
SET /
SETL
GET /
GETL
OUTLVL
Y
Y
INC /
DEC
Y
OUTMUTE
Y
Y
N
Index2
Invert
Polarity
Mic level
pad (FLEX
only)
OUTINVRT
Y
Y
N
Index2
OUTPAD
Y
Y
N
Index2
-100 ~ 0 *
* Can contain a decimal number.
Example: In the command: SET 2 OUTMUTE 3 4 1<LF>
We are telling E Desk device 2 to set the output mute Instance ID 3, output 4 (index1) to
on. (We muted the 4 th output of Instance ID 3 of an E Desk)
CobraNet
Input
CobraNet
RX bundle
CobraNet
Input Level
CobraNet
Input Mute
CobraNet
Input Invert
Attribute
SET /
SETL
GET /
GETL
CNINBNDL
Y
CNINLVL
Index1/
Index2
None
Value Range
Y
INC /
DEC
N
Y
Y
Y
Index1
-100 ~ 12 *
CNINMUTE
Y
Y
N
Index1
CNININVRT
Y
Y
N
•
10
0 ~ 61439
0=unmuted
1=muted
Index1
0 = off
1= on
Can contain a decimal number.
ETP String Component: Attribute
CobraNet
Output
CobraNet
TX Bundle
CobraNet
Output
Level
CobraNet
Output Mute
CobraNet
Output
Invert
Attribute
SET /
SETL
GET /
GETL
CNOUTBNDL
Y
CNOUTLVL
Index1/
Index2
None
Value Range
Y
INC /
DEC
N
Y
Y
Y
Index1
-100 ~ 0 *
CNOUTMUTE
Y
Y
N
Index1
CNOUTINVRT
Y
Y
N
Index1
0=unmuted
1=muted
0 = off
1= on
•
.
DCS88 Input Attribute
DCS88 RX
Bundle
DCS88 Input
Level
DCS88 Input
Mute
DCS88 Input
invert
SET /
SETL
GET /
GETL
EXPIBNDL
Y
EXPILVL
Can contain a decimal number.
Index1/
Index2
None
Value Range
Y
INC /
DEC
N
Y
Y
Y
Index1
-100 ~ 12 *
EXPIMUTE
Y
Y
N
Index1
EXPIINVRT
Y
Y
N
•
DCS88
Ouput
DCS88 TX
Bundle
DCS88
Output
Level
DCS88
Output Mute
DCS88
Output
invert
0 ~ 61439
Attribute
SET /
SETL
GET /
GETL
EXPOBNDL
Y
EXPOLVL
0 ~ 61439
0=unmuted
1=muted
Index1
0 = off
1= on
Can contain a decimal number.
Index1/
Index2
None
Value Range
Y
INC /
DEC
N
Y
Y
Y
Index1
-100 ~ 0 *
EXPOMUTE
Y
Y
N
Index1
EXPOINVRT
Y
Y
N
Index1
0=unmuted
1=muted
0 = off
1= on
•
11
0 ~ 61439
Can contain a decimal number
ETP String Component: Attribute
MLI Input
Attribute
SET /
SETL
GET /
GETL
MLI RX
Bundle
MLI Input
Level
MLI Input
Mute
MLI Input
invert
EXPIBNDL
Y
EXPILVL
Index1/
Index2
None
Value Range
Y
INC /
DEC
N
Y
Y
Y
Index1
-100 ~ 12 *
EXPIMUTE
Y
Y
N
Index1
EXPIINVRT
Y
Y
N
•
0 ~ 61439
0=unmuted
1=muted
Index1
0 = off
1= on
Can contain a decimal number.
MLO Output
Attribute
SET /
SETL
GET /
GETL
INC /
DEC
Index1/
Index2
Value Range
MLO TX
Bundle
MLO Output
Level
MLO Output
Mute
MLO Output
invert
EXPOBNDL
Y
Y
N
None
0 ~ 61439
EXPOLVL
Y
Y
Y
Index1
-100 ~ 0 *
EXPOMUTE
Y
Y
N
Index1
EXPOINVRT
Y
Y
N
•
12
0=unmuted
1=muted
Index1
0 = off
1= on
Can contain a decimal number.
ETP String Component: Attribute
Mixer Blocks
Automixer
Attribute
SET /
SETL
GET /
GETL
Input Level
Output
Level
Input Mute
AMLVLIN
AMLVLOUT
Y
Y
AMMUTEIN
Y
Y
Y
INC /
DEC
Y
Y
Index1/
Index2
Index1
None
Y
N
Index1
Value Range
-100 ~ 12 *
-100 ~ 12 *
0=unmuted
1=muted
Output Mute AMMUTEOUT Y
Y
N
None
0=unmuted
1=muted
Crosspoint
AMMUTEXP
Y
Y
N
Index1
1=unmuted
Mute
0=muted
Logic
AMLOGOUT
Y
Y
N
Index 2
0=off
Output
1=on
* Can contain a decimal number.
Example: In the command: SET 1 AMMUTEXP 3 1 0<LF>
We are telling E Desk device 1 to set the automixer’s crosspoint (row 1, column 1) on
instance ID 3 to off.
Note: For attributes with 2 Index fields, Index1 is the row, and Index2 is the column.
Matrix
Mixer
Input Level
Output
Level
Input Mute
Attribute
SET /
SETL
GET /
GETL
MMLVLIN
MMLVLOUT
Y
Y
MMMUTEIN
Output Mute
Crosspoint
Level
Crosspoint
Mute
Index1/
Index2
Index1
Index2
Value Range
Y
Y
INC /
DEC
Y
Y
Y
Y
N
Index1
MMMUTEOUT
Y
Y
N
Index2
MMLVLXP
Y
Y
Y
0=unmuted
1=muted
0=unmuted
1=muted
-100 ~ 0 *
MMMUTEXP
Y
Y
N
-100 ~ 12 *
-100 ~ 12 *
Index1 &
Index2
Index1 &
1=unmuted
Index2
0=muted
* Can contain a decimal number.
Note: For attributes with 2 Index fields, Index1 is the row, and Index2 is the column.
13
ETP String Component: Attribute
Standard
Mixer
Input Level
Output
Level
Input Mute
Attribute
SET /
SETL
GET /
GETL
SMLVLIN
SMLVLOUT
Y
Y
SMMUTEIN
Output Mute
Crosspoint
Mute
Y
Y
INC /
DEC
Y
Y
Index1/
Index2
Index1
Index2
Y
Y
N
Index1
SMMUTEOUT
Y
Y
N
SMMUTEXP
Y
Y
N
Value Range
-100 ~ 12 *
-100 ~ 12 *
0=unmuted
1=muted
Index2
0=unmuted
1=muted
Index1 &
1=unmuted
Index2
0=muted
* Can contain a decimal number.
Note: For attributes with 2 Index fields, Index1 is the row, and Index2 is the column.
Room
Combiner
Wall State
Attribute
SET /
SETL
GET /
GETL
RMCMBWALL
Y
Output
Level
Output Mute
RMCMBLVL
RMCMBMUTE
Group
State+
Y
INC /
DEC
N
Index1/
Index2
Index1
Y
Y
Y
Index1
Y
Y
N
Index1
RMCMBGROUP Y
Y
N
Index1
Value Range
0 = down
1 = up
-100 ~ 12 *
0=unmuted
1=muted
0-16
* Can contain a decimal number.
Example: In the string SET 1 RMCMBWALL 4 2 1 <LF>
We are telling E Desk to set the 2 nd ‘wall’ in the room combiner, Instance ID 4, up
(separate rooms).
Note: For wall state, Index1 represents the wall being opened or closed.
+Note: The behavior of RMCMBGROUP is the same as that of the "Set Selected Group"
commands in the right-click-context menus in the Room Combiner control dialogue in the E
Desk Software: the specified room is isolated, meaning all moveable walls at its borders are put
up. All neighboring rooms maintain their previous group assignments. Index1 represents the
room being addressed. As rooms are combined the room levels will become ganged so only
one output needs to be addressed.
14
ETP String Component: Attribute
Mix-minus
Combiner
Group State
Attribute
SET /
SETL
GET /
GETL
MCMBGROUP
Y
Y
INC /
DEC
N
Index1/
Index2
Both
Value Range
0 = not
grouped
1 = grouped
Note: Index1 is the input number being addressed. Index2 is the group number; this is
represented by a letter in the software, but addressed as a number in ETP commands.
(Example: A=1, B=2, C=3….)
15
ETP String Component: Attribute
Equalizer Blocks
Graphic EQ
Attribute
SET /
SETL
GET /
GETL
EQ Band
Level
Bypass All
Bands
GEQLVLBND
Y
GEQBYPALL
Y
Y
INC /
DEC
Y
Index1/
Index2
Index1
Y
N
None
Value Range
-30 ~ 15 *
0 = active
1 = bypassed
Can contain a decimal number.
The Index field represents the filter to be controlled. EQ filter farthest to the left is #1,
next one is #2 and so forth. Upper left hand area of Graphic EQ dialog screen displays,
which numbered filter, is being adjusted, use this number as the Index1 for Graphic EQ
strings.
Example: In the string SET 2 GEQBYPALL 9 1 <LF>
We are telling E Desk to bypass all bands on Graphic EQ Instance ID 9.
Parametric
EQ
EQ
Bandwidth
Bypass EQ
Band
Center Freq.
EQ Band
Level
Bypass All
Bands
Attribute
SET /
SETL
GET /
GETL
PEQBWBND
Y
PEQBYPBND
Index1/
Index2
Index1
Value Range
Y
INC /
DEC
N
Y
Y
N
Index1
PEQFCBND
PEQLVLBND
Y
Y
Y
Y
Y
Y
Index1
Index1
0 = active
1 = bypassed
20 ~ 20000
-30 ~ 15 *
PEQBYPALL
Y
Y
N
None
•
0.01 ~ 4.0 *
0 = active
1 = bypassed
Can contain a decimal number.
Upper left hand area of Parametric EQ dialog screen displays, which numbered filter, is
being adjusted, use this number as the Index1 for Parametric EQ strings.
Example: In the string INC 1 PEQLVLBND 11 3 2<LF>
We are telling E Desk to increment the second parametric EQ filter on Instance ID 11 by
2dB.
Feedback
Suppressor
Reset All
Filters
Attribute
SET /
SETL
GET /
GETL
FBSRESET
Y
N
INC /
DEC
N
Index1/
Index2
None
Value Range
None
Example: In the string SET 1 FBSRESET 4<LF>
We are telling E Desk to reset all of the filters on the feedback suppressor on Instance
ID 4.
16
ETP String Component: Attribute
Filters Blocks
HPF
Attribute
SET /
SETL
GET /
GETL
Cut off
freq.
Filter
Bypass
HPFLTFC
Y
HPFLTBYP
LPF
Index1/
Index2
None
Value Range
Y
INC /
DEC
N
Y
Y
N
None
0 = active
1= bypassed
Attribute
SET /
SETL
GET /
GETL
LPFLTFC
Y
Y
Index1/
Index2
None
Value Range
Cut off
freq.
Filter
Bypass
INC /
DEC
N
LPFLTBYP
Y
Y
N
None
0 = active
1 = bypassed
High
Shelf
Cut off
freq.
Gain
Filter
Bypass
Attribute
SET /
SETL
GET /
GETL
Y
Y
Index1/
Index2
None
Value Range
HSFLTFC
INC /
DEC
N
HSFLTGAIN
HSFLTBYP
Y
Y
Y
Y
Y
N
None
None
-27.0 ~ 9.0
0 = active
1 = bypassed
Low
Shelf
Cut off
freq.
Gain
Filter
Bypass
Attribute
SET /
SETL
GET /
GETL
Y
Y
Index1/
Index2
None
Value Range
LSFLTFC
INC /
DEC
N
LSFLTGAIN
LSFLTBYP
Y
Y
Y
Y
Y
N
None
None
20 ~ 20000 *
20 ~ 20000 *
20.0 ~ 20000 *
20.0 ~ 20000 *
-27 ~ 9
0 = active
1 = bypassed
* Can contain a decimal number.
Example: SET 1 HSFTGAIN 100 –10<LF>
We are telling E Desk to set the High Shelf filter gain on instance ID 100 to –10dB.
All Pass
Filter
Attribute
SET /
SETL
GET /
GETL
Bandwidth
APFLTBWBND
Y
Y
INC /
DEC
N
Center
Freq.
Filter
Bypass
Bypass
All
APFLTFCBND
Y
Y
N
APFLTBYPBND
Y
Y
N
APFLTBYPALL
Y
Y
N
17
Index1/
Index2
Band
Number
Band
Number
Band
Number
None
Value Range
0.01 ~ 4.0 *
20.0 ~ 20000 *
0 = active
1 = bypassed
0 = active
1 = bypassed
* Can contain a decimal number.
ETP String Component: Attribute
Crossover blocks
2-Way
Attribute
SET /
SETL
GET /
GETL
Cutoff
Freq.
XOVR2FC
Y
Y
3-Way
Attribute
SET /
SETL
GET /
GETL
Cutoff
Freq.
XOVR3FC
Y
Y
4-Way
Attribute
SET /
SETL
GET /
GETL
Cutoff
Freq.
XOVR4FC
Y
Y
INC /
DEC
N
Index1/
Index2
Index1
Value Range
INC /
DEC
N
Index1/
Index2
Index1
Value Range
INC /
DEC
N
Index1/
Index2
Index1
Value Range
20 ~ 20000 *
20 ~ 20000 *
20 ~ 20000 *
* Can contain a decimal number.
Example: GET 2 XOVR3FC 40 1 <LF>
We are asking E Desk to tell us the 3-way crossover low-pass cutoff frequency on
instance ID 40.
2-way crossover:
Index1 = 1 is the low-pass cutoff frequency
Index1 = 2 is the high-pass cutoff frequency
3-Way crossover:
Index1 = 1 is low-pass cutoff frequency
Index1 = 2 is the lower slope of the mid cutoff frequency
Index1 = 3 is the higher slope of the mid cutoff frequency
Index1 = 4 is the high-pass cutoff frequency
4-way crossover:
Index1 = 1 is the low-pass cutoff frequency
Index1 = 2 is the lower slope of the low-mid cutoff frequency
Index1 = 3 is the higher slope of the low-mid cutoff frequency
Index1 = 4 is the lower slope of the mid-high cutoff frequency
Index1 = 5 is the higher slope of the mid-high cutoff frequency
Index1 = 6 is the high-pass cutoff frequency
18
ETP String Component: Attribute
Dynamic Blocks
Leveler
Attribute
SET /
SETL
GET /
GETL
Bypass
LVLRBYP
Y
Y
Comp /
Limiter
Bypass
Attribute
SET /
SETL
GET /
GETL
CLIMBYP
Y
Y
Ducker
Attribute
SET /
SETL
GET /
GETL
Y
DKRLVLIN
DKRLVLSENSE
Input
level
Level
sense
Bypass
Ducker
Mute
sense
Input
mute
Logic in
enable
Logic out
enable
Logic
input
invert
Logic
output
invert
INC /
DEC
N
Index1/
Index2
None
Value Range
INC /
DEC
N
Index1/
Index2
None
Value Range
Index1/
Index2
None
Value Range
Y
INC /
DEC
N
Y
Y
N
None
-100 ~ 12 *
DKRBYP
Y
Y
N
None
DKRMUTESENSE
Y
Y
N
None
DKRMUTEIN
Y
Y
N
None
DKRENLOGIN
Y
Y
N
None
DKRENLOGOUT
Y
Y
N
None
DKRINVLOGIN
Y
Y
N
None
0= active
1= bypassed
0 = unmuted
1 = muted
0 = unmuted
1 = muted
0 = disabled
1= enabled
0 = disabled
1= enabled
0= normal
1= inverted
DKRINVLOGOUT
Y
Y
N
None
0=active
1=bypassed
0=active
1=bypassed
-100 ~ 12 *
0= normal
1= inverted
* Can contain a decimal number.
Noise
Gate
Bypass
Attribute
SET /
SETL
GET /
GETL
NGBYP
Y
Y
INC /
DEC
N
Index1/
Index2
None
Value Range
0 = active
1 = bypassed
Example: SET 3 CLIMBYP 55 0<LF>
We are telling E Desk to set the Comp/Limiter on instance ID 55 to active.
19
ETP String Component: Attribute
Ambient
Noise
Compensator
SET /
SETL
GET /
GETL
Y
Y
INC /
DEC
N
ANCMUTEPGM
ANCLVLPGM
Y
Y
N
None
0 = unmuted
1 = muted
-100 ~ 12 *
ANCTHRSHPGM
Y
Y
N
None
-60.0 to 24 *
Program
ANCRSPTMPGM
Response
Ambient
Mute
ANCMUTEAMB
Ambient
ANCLVLAMB
Level
ANCTHRSHAMB
Ambient
Y
Y
N
None
Y
Y
N
None
Y
Y
N
None
500 to
300000*
0 = unmuted
1 = muted
-100 ~ 12 *
Y
Y
N
None
-60.0 to 24 *
ANCRSPTMAMB
Y
Y
N
None
ANCGAINMIN
Y
Y
N
None
500 to
300000*
-25.0 to 25.0 *
Y
Y
N
None
-25.0 to 25.0 *
Y
Y
N
None
0.25 to 4.0 *
Y
Y
N
None
500 to
300000*
Program
Mute
Program
Level
Program
Threshold
Attribute
Index1/
Index2
None
Value Range
Threshold
Ambient
Response
Min Gain
Setting
Max Gain
Setting
Gain
Ratio
Gain
Response
Time
ANCGAINMAX
ANCGAINRATIO
ANCGAINRSPTM
* Can contain a decimal number.
Example: SET 1 ANCMUTEPGM 20 0<LF>
We are telling E Desk to set the ANC to unmute the program input on instance ID 20.
20
ETP String Component: Attribute
Router Blocks
Router
Attribute
SET /
SETL
GET /
GETL
Cross
point
RTRMUTEXP
Y
Y
INC /
DEC
N
Index1/
Index2
Both
Value Range
1 = off
0 = on
Example: SET 1 RTRXP 98 4 5 0<LF>
Note: For attributes with 2 Index fields, Index1 is the row, and Index2 is the column.
21
ETP String Component: Attribute
Delay Blocks
Delay
Delay in
Milliseconds
Delay in
Centimeters
Delay in
Meters
Delay in
Inches
Delay in
feet
Attribute
SET /
SETL
GET /
GETL
DLYMSEC
Y
DLYCM
Index1/
Index2
None
Value Range
Y
INC /
DEC
N
Y
Y
N
None
0 ~ ?*
Y
Y
N
None
0 ~ ?*
Y
Y
N
None
0 ~ ?*
Y
Y
N
None
0 ~ ?*
0 ~ ?*
DLYM
DLYIN
DLYFT
* Can contain a decimal number.
Example: SET 1 DLYCM 24 40<LF>
We are telling E Desk to set the delay block at instance ID 24 to 40 centimeters.
Note: Value range is 0 to max value for the specific delay block. Example: a 50mSec
delay has a maximum setting of 1763 centimeters, 17meters, 694 inches, and 57 feet.
22
ETP String Component: Attribute
Control Blocks
Level
Faders
Fader
Levels
Mute
Fader
Attribute
SET /
SETL
GET /
GETL
FDRLVL
Y
FDRMUTE
Presets
Preset
Y
INC /
DEC
Y
Index1/
Index2
Index1
Y
Y
N
Index1
Attribute
SET /
SETL
GET /
GETL
PRESET
N
N
INC /
DEC
N
Value Range
-100 ~ 12 *
0 = unmuted
1 = muted
* Can contain a decimal number.
Index1/
Index2
None
Value Range
1001 to max
preset number
Note: Instead of SET/SETL, GET/GETL, INC, or DEC; the preset attribute uses
RECALL as the Command. Preset numbers begin at 1001, regardless of preset name
(the first preset defined is 1001, the next 1002, and so forth).
Example: in the string: RECALL 1 PRESET 1001<LF>
We are telling E Desk to recall the first preset on an E Desk system. Since presets
apply to entire systems, or DAP files, the Device Number will always be 1 for Preset
strings.
23
ETP String Component: Attribute
Meter Blocks
Meters
Attribute
SET /
SETL
GET /
GETL
Signal
Peak
SPMTRLVL
PKMTRLVL
N
N
Y
Y
INC /
DEC
N
N
RMS
RMSMTRLVL
N
Y
N
Index1/
Index2
Index1
Index1
-100 ~ 36 *
0 = off
1 = peak
Index1
-100 ~ 36 *
* Can contain a decimal number.
Example: GET 1 RMSMTRLVL 48 1 <LF>
We are asking E Desk the RMS Meter 1 level on instance ID 48.
24
Value Range
ETP String Component: Attribute
Generator Blocks
No Attributes are specified at this time
25
ETP String Component: Instance ID Number
E Desk uses an instance ID number to specify the exact DSP block to be controlled.
Right click on the DSP block and select “Properties”, the instance number can be found
the DSP Attributes 1 tab.
The property sheet can only be accessed
in an offline screen.
**Note** E Desk software will assign an Instance ID to each DSP block on the initial
compile of the system. Subsequent compiles will not change the Instance IDs unless
the “Reassign Instance IDs” check box is selected in the ‘Compile’ tab of the ‘Options’
screen (located on the Tools pull-down menu) in the E Desk software.
If one or more DSP blocks are disconnected from the audio path (when connections are
not made to at least one input or output) the Instance IDs will be unassigned. New
Instance ID(s) will be reassigned once the DSP block(s) are properly connected again.
26
ETP String Component: Index
Index refers to inputs, outputs, or crosspoints of an Attribute. Some Attributes
will need an Index1 (Input or Row) and/or an Index2 (output or Column). The
tables in the Attribute section will define which, if any, indexes are required for
the string.
Example: INC 1 AMLVLIN 4 1 1<LF>
In an Automatic mixer on device 1 we are increasing the level of input 1 on
instance ID 4 by 1dB. Index1 is used to represent the input number.
Example: DEC 2 AMLVLOUT 6 1 2<LF>
In an Automatic mixer on device 2 we are decreasing the level of output 1 on
instance ID 6 by 2dB. Index2 is used to represent the output number.
Example: SET 1 MMLXP 5 1 2 –5<LF>
In a matrix mixer on device 1 we are setting cross point 1:2 (row 1, column 2)
level to –5dB on instance ID 5.
Note for commands with 2 Index fields, Index1 is the row, and Index2 is the
column.
27
ETP String Component: Value
Value determines what a DSP block is being set to, incremented by, or decremented by.
The Attribute section will define which type of value the string will need in order to
execute the ETP string.
Example: INC 1 AMLVLIN 4 1 1<LF>
In an Automatic mixer input level string, the Value equal to 1 states that the fader is to
be incremented by 1 dB.
Example: SET 2 MMLVLIN 5 2 –100<LF>
In a matrix mixer input level string, the value is set to –100dB.
Example: RECALL 1 PRESET 1004<LF>
For a preset recall we are telling device 1 to recall the fourth preset.
*When GET is used, a Value will not need to be specified since GET is a request
command. A Value must be set in order for SET, INC, DEC, and RECALL command
strings to work.
Example: GET 4 MMLVLOUT 5 <LF>
We are asking the level of a matrix mixer’s output. There is no Value required for this
string.
28
Responses
When a successful SET, SETL, INC, DEC, or RECALL command is sent to an E Desk
device via RS-232 or Telnet, E Desk will respond with: ‘+OK’ followed by a carriage
return and line feed.
Example: Sending the string: SET 2 AMLVLIN 4 2 1< LF> will result in an:
+OK<CR><LF> response.
A successful GET or GETL command will result in a numerical response to the
command string followed by <CR><LF>.
The response from an ETP string with a GET command may contain a decimal
point (with 4 numbers after the decimal) and/or negative numbers, depending on
type of Attribute addressed. If the control system does not support negative
numbers or decimal places a GETL command may be used instead (see page
6).
Example: After sending the above example to an E Desk device the string:
GET 2 AMLVLIN 4 2<LF> would result in the response: 1.0000<CR><LF> this tells us
that the level is currently set to 1dB.
If an incorrect command string is sent, an E Desk will respond with: -ERR <CR><LF>
29
Control Dialog - Overview
E Desk software can be used to control E Desk units real time via a network. After
connecting to an E Desk device, users, technicians, and designers (as determined by
passwords) can access their appropriate level of control of the system. Depending on
the authorized access level of control Levels, Meters, Presets, and layers can be
accessed and changed.
Level Controls, Meters, and, Preset control dialog screens can be minimized and
arranged to provide a simple, and intuitive, user interface for the system. Connecting E
Desk’s Ethernet port, through a switch, to network jacks in various locations can provide
control to the system from different locations via a Laptop or Desktop computer.
*Note – E Desk’s control network can be easily shared on an existing network without
compromising network bandwidth, but CobraNet data should be routed on its own
network to ensure CobraNet audio and existing network reliability.
30
Control Dialog - Levels
Once level controls are placed in a signal path audio levels can be increased,
decreased or muted as needed.
31
Control Dialog - Presets
Once Presets are created, Preset buttons can be placed on screen and used to easily
recall different scenarios.
32
Control Dialog - Meters
If meters are placed on screen, users can view real time Signal Present, RMS, and
Peak indications.
33
HyperTerminal
HyperTerminal is a useful tool that comes with Windows and can be used for RS-232
purposes. Simply open a HyperTerminal session by going to: Start> Programs>
Accessories> Communications> HyperTerminal. Enter a name for your connection and
click ‘OK’. Under the pull-down menu labeled ‘Connect Using’ select the location of
your RS-232 Comm. port.
Under the Comm. port properties set it to 38400, 8, None, 1, and None as shown below.
Now HyperTerminal is ready to use. E Desk does not echo characters typed, so if you
want to view what is being typed into E Desk, click on “echo typed characters locally” in
the ASCII setup screen
34
IP Address Commands
E Desk has some useful IP and reset tools that may be useful when returning to older
systems for service work.
E Desk will automatically output its IP Address through the RS-232 port when it is
powered up and functioning. Simply have a straight through RS-232 cable connected to
E Desk and a PC with HyperTerminal running. When E Desk is powered up it will print
the data in the HyperTerminal screen.
Get/Set IP Address
By typing ‘GET 0 IPADDR<LF>’ in HyperTerminal E Desk will reveal the IP Address it
is set to. Substituting the ‘0’ for a 1, 2, 3, etc will tell E Desk to reveal the IP Address for
the device who’s number is 1, 2, 3 etc. A ‘0’ asks for the IP Address of the E Desk you
are currently connected to. Note: You can only use a 1, 2, 3 etc if there is a system
loaded into the E Desk’s. If it is a single device system, the only device number will be
1.
If an E Desk does not have a system loaded into it, you can set the IP Address via the
RS-232 port. Example: SET 0 IPADDR 169.254.1.200<LF>. If there is no DAP file in
the E Desk, and the command is typed correctly, E Desk will send back a ‘+OK’
response. You will need to power cycle the E Desk for the new IP Address to take
effect. As stated above, E Desk will output the IP Address when powered up, or you
can use the GET IPADDR command mentioned above.
Reset
In rare instances it may become necessary to reset the E Desk device. A reset can be
accomplished through the device maintenance screen, and this is the desired method
for a reset. However, there is a reset command available via the RS-232 port. Simply
type: CLEAR 0 DEVCONFIG<LF> and the device will be reset.
35