Lehigh DX3 Installation manual

DX3 A/V Command Reference
Version 1.3
P/N F529
© 2016 ehigh Electric Products Co.

TECHNICAL INQUIRY
This equipment uses sensitive electronic components. Only individuals experienced with
electrical and electronic equipment should remove the panels or attempt to service this
system. Tampering with this equipment could cause component damage.
All questions regarding this equipment should be referred to:
ehigh Electric Products Company
6265 Hamilton Boulevard
Allentown, PA 18106-9789
Phone: [phone]
Fax: [phone]
Web Site: www.lehighdim.com
WARRANTY
Subject to the terms of this paragraph, the supplier warrants its title to the products sold
by it and warrants to the Purchaser that its products are free of defects in workmanship or
material and are in conformity with applicable specifications and descriptions of the
supplier. No claim shall be maintained hereunder unless the facts giving rise to it are
discovered within 16 months from the date of shipment from the factory, or 12 months
after initial energization of said equipment, with the one expiring first given precedence,
and written notice thereof given to the supplier
within 30 days of discovery. The sole and exclusive liability of the supplier, for Breach
of Warranty shall be, at its option, to replace or repair the product or part concerned
F.O.B. its factory or such place as it may designate. The warranties stated in this
paragraph are exclusive of all other warranties, written or oral, statutory, expressed or
implied, none of which shall apply to the sale of the suppliers products hereunder.

Table of Contents
1 Telnet Interface.................................................................................................................1
2 General Command Info.....................................................................................................1
2.1 Command ine Rules................................................................................................1
2.2 Specifying Parameters...............................................................................................2
2.2.1 Station ID............................................................................................................3
2.3 Command ine Response..........................................................................................4
2.4 Unsolicited Feedback.................................................................................................5
3 Channel Control................................................................................................................6
3.1 Fade to evel..............................................................................................................6
3.2 Freeze Channels.........................................................................................................6
3.3 Toggle.........................................................................................................................6
3.4 Bump..........................................................................................................................7
4 Preset Control....................................................................................................................7
4.1 Recall Presets.............................................................................................................7
4.2 Freeze Preset..............................................................................................................8
5 Time Clock Control...........................................................................................................8
5.1 Disable Time Clock....................................................................................................8
5.2 Enable Time Clock.....................................................................................................9
5.3 Set Time.....................................................................................................................9
6 Station Control................................................................................................................10
6.1 ock Station Group..................................................................................................10
6.2 Unlock Station Group..............................................................................................11
6.3 Toggle Station Group...............................................................................................11
7 Partition Control..............................................................................................................12
7.1 Open Wall................................................................................................................12
7.2 Close Wall................................................................................................................12
7.3 Toggle Wall..............................................................................................................13
8 Miscellaneous Controls...................................................................................................13
8.1 Play Script or Chase.................................................................................................13
8.2 Recall Backup CUE.................................................................................................14
8.3 Panic ON/OFF.........................................................................................................14
9 System Status..................................................................................................................14
9.1 Serial Number..........................................................................................................15
9.2 Date..........................................................................................................................15
9.3 Time.........................................................................................................................15
9.4 Firmware Version.....................................................................................................16
9.5 Area Status...............................................................................................................16
9.6 Partition Status.........................................................................................................17
9.7 Time Clock Status....................................................................................................17
9.8 Station Status...........................................................................................................18
9.9 Channel Status.........................................................................................................18
9.10 Sunrise Sunset Status.............................................................................................19
9.11 Backup Cue Status.................................................................................................20
9.12 ist Areas...............................................................................................................20

9.13 ist Channels.........................................................................................................21
9.14 ist Presets.............................................................................................................22
9.15 ist Scripts and Chases..........................................................................................23
9.16 ist Wall Partitions.................................................................................................23
9.17 ist Fade Time.......................................................................................................24
9.18 ist Preset evels...................................................................................................24
9.19 ist System Dimensions........................................................................................25
9.20 ist Stations...........................................................................................................26
9.21 ist ock Status.....................................................................................................27
10 Record Commands........................................................................................................27
10.1 Record Preset.........................................................................................................27
10.2 Record Fade Time..................................................................................................27
10.3 Record Area Name.................................................................................................28
10.4 Record Preset Name...............................................................................................28
10.5 Record Channel Name...........................................................................................28
10.6 oad Preset.............................................................................................................29
11 Quick reference Guide..................................................................................................30
12 Installation.....................................................................................................................33

1 Telnet Interface
Telnet is a network protocol that uses a virtual terminal connection, similar to a serial
interface. The DX3 dimmer rack is a Telnet server. Communicate to it with a Telnet
client.
Follow the steps below to initiate the Telnet connection. All Telnet data is in ASCII.
•You will need a special Ethernet cable to connect to the Ethernet ports on the
DX3. Refer to the section 12 .
•Connect the Ethernet port of the DX3 dimmer rack to your AN (router or
switch) or computer. The Ethernet ED on the front panel of the dimmer rack
will be lit when there is a live connection.
•In a telnet client, establish the telnet connection by using the DX3 dimmer rack IP
address and port number 6265. For example:
◦telnet 192.168.1.10 6265
•Once the telnet connection is made, use the commands defined below.
2 General Command Info
2.1 Command Line Rules
A command line is terminated by a carriage return (0Dh). If a command line includes a
line feed (0Ah), it is ignored. Command lines must not exceed 1536 characters. All
commands are comprised of ASCII characters. Backspace is allowed.
All numbers entered in a command are interpreted as base 10. Numbers may be
expressed as hexadecimal by following the number with h or H. Hex numbers may not
begin with an alphabetic character, they must be preceded by a 0 in order to be
interpreted properly. Some examples follow:
Hex number Decimal equivalent
10h 16
ah Interpreted as a label not as a hex number
0ah 10
The case of alphabetic characters in a hex number is not important.
Character strings used to change names may be entered alone or enclosed in double or
single (apostrophe) quotes. The main difference is that a name entered by itself can only
contain alphabetic characters, upper or lower case. A name enclosed in quotes can
1

contain any character including spaces, numbers and punctuation other than quotes.
Some examples follow:
Strin Comments
Ballroom Ok
Ballroom1 Invalid. Unquoted strings cannot contain
anything other than alphabetic characters.
Dining Room Wrong. This will be interpreted as two
separate strings.
“Happy Hour” Ok. This will be interpreted as a single
string.
‘Preset 1' Ok. The apostrophe (single quote) may be
used as an alternative to double quotes to
enclose a string.
It is recommended that all strings be enclosed in quotes so as to not limit the characters
that may be used in a name.
The basic format of a command line is as follows:
; <ID> <PARAMETERS> <CR>
All commands begin with a semicolon followed by a command number and parameters
specific to the command. The amount of parameters varies depending on the command.
A maximum of 32 parameters will be accepted for any command.
2.2 Specifying Parameters
Area
Areas are specified by number, 1 through 16.
Preset
Each area has 24 programmable presets plus FU and OFF. Programmable presets are
specified by a number between 1 and 24. FU is specified by 25 and OFF by 26.
Channel
Channels are specified by number, 1 through 128.
Level
evels are specified as a percentage, 0 to 100. Full on is 100%, off is 0. Any other
number is interpreted as OFF.
2

Time, Delay
The fade time and delay are specified in tenths of a second. However, only whole
seconds may be used. For example, a fade time of 1 second is specified as 10.
2.2.1 Station ID
Wall stations are identified by their Station ID, a combination of the station type and
number, in hex.
Station ID = station type followed immediately by station number (2 digits), ending in 'h'.
Example: Station ID = 0D01h
The station type is 0D, the station number is 01, 'h' means it's a hex number.
Station number is set on the rotary switch on the back of the station.
Station types are given in the following table:
Station Type
Rack Station 00
AV207 05
Receptacle 07
CT500 09
CTE602 0D
CTE603 0E
CTE606R 0F
CTE- CD 10
CTE-IR 11
CTM606 12
CTM612 13
CT600 14
Examples:
1. A CTE602, rotary set to 0. Station ID = 0D00h.
2. A CTE602, rotary set to 1. Station ID = 0D01h.
3. A CTM612, rotary set to 2. Station ID = 1302h.
3

2.3 Command Line Response
The following summarizes command responses from the DX3.
•A colon (:) begins a line of error-free command response data. It also begins a
line of an unsolicited message.
•An asterisk (*) begins a line that usually closes the response to an error-free
command. In some cases, the (*) line will be transmitted before all response data
lines (:) have been received.
•An exclamation point (!) begins a command response line when the command
contained errors. In some cases response data (:) may be received before the (!)
line.
The usual format of a response to an error-free command is shown below. Refer to the
command description for the exact response.
:<COMMAND><PARAMETERS><CR>
*<COMMAND><CR>
In most cases the command response will be the command echoed with the semicolon
replaced with a colon, as shown above. Some commands will not do this – instead, the
response will be status, indicating the result of the command. For instance, a command
that toggles the lock status of a station will echo back the lock action that was actually
performed.
Response parameters follow the same rules as commands. That is, hex numbers end with
“h” and always begin with a numeric character and name strings are always enclosed in
double quotes. Most response parameters are expressed as decimal numbers.
All response lines will always terminate with <CR>< F> (0dh 0ah). For simplicity sake,
responses are shown in this document as ending with just a <CR>. Software interpreting
the response can use the <CR> or < F> as the effective end of line delimiter.
A command that contains errors will be responded to as follows:
!<COMMAND><ERROR CODE><CR>
COMMAND is the command number that the response is referring to and ERROR
CODE is a number that describes the general nature of the error.
The error codes are explained below.
Code Comments
1 Insufficient parameters. Not enough parameters were included to complete the
command.
2 Invalid parameter. One or more parameters included in the command were out
4

of range.
3 Internal error relating to the fade engine.
4 Parse error.
5 Parse error.
6 Parse error
7 Parse error.
8 Parse error.
9 Internal error
10 Bad command. The command number was unrecognized.
A certain amount of error tolerance is afforded. As an example, if a particular command
takes a list of channels and at least one of those channels is out of range, an error will be
reported but the command will process the valid channels.
2.4 Unsolicited Feedbac
The DX3 will output feedback in response to events initiated at the local connection or
other control sources. The feedback will be in the form of a message beginning with a
colon, the same as a command response. For instance, if a preset were recalled from a
Collage entrance station, the Recall Preset command response would be broadcast as an
unsolicited message to all devices listening on Telnet connections.
It is possible for lines of unsolicited messages to be interleaved with solicited response
lines. All responses and unsolicited messages will always be complete lines beginning
with a colon, asterisk or exclamation point and ending with <CR>< F>. Response lines
will never be nested inside of response lines for another command.
Example: Using the Recall Preset command.
Command:
;20 1 2<CR>
Response that will be heard at the Telnet location that issued the command:
:20 1 2<CR>
*20<CR>
Unsolicited message that will be heard at all other Telnet locations:
:20 1 2<CR>
5

3 Channel Control
3.1 Fade to Level
This command will fade selected channels within an area to the level specified in the
specified time after the specified delay. Multiple channels may be specified. DE AY
and TIME are in tenths of seconds but must be specified in whole seconds.
Command format:
;11 <LEVEL> <DELAY> <TIME> <AREA> <CHANNELS> <CR>
Example: Fade channels 3, 4 and 5 in area 2 to 25% in 2 seconds after a 1 second delay.
;11 25 10 20 2 3 4 5 <CR>
Response:
:11 25 10 20 2 3 4 5 <CR>
*11<CR>
3.2 Freeze Channels
This command will stop selected channels from fading when the fade is initiated by a
preset recall, a bump command, or a toggle command. The freeze remains in effect until
another command affects the channels. This command will report the level that channels
are at when the freeze command was received.
Command format:
;10 <AREA> <CHANNELS> <CR>
Example: Freeze channels 21 and 22 in area 2.
;10 2 21 22 <CR>
Response:
:10 2 21 22 <CR>
:89 2 21 0<CR>
:89 2 22 50<CR>
*10<CR>
3.3 Toggle
This command fades selected channels to off if they are on and to full if they are off in
the TIME specified. TIME is in tenths of seconds but must be specified in whole
seconds.
Command format:
6