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

;16 <TIME> <AREA> <CHANNELS> <CR>
Example: Toggle channels 5, 9 and 11 in area 5 in 3 seconds.
;16 30 5 5 9 11 <CR>
Response:
:16 30 5 5 9 11 <CR>
*16<CR>
3.4 Bump
This command will wait DE AY1 then fade to EVE 1 in TIME1. It will then wait
DE AY2 then fade to EVE 2 in TIME2. If EVE 2 is greater than 100 the channels
will fade to the level that they were before the command started. Channel numbers in the
specified area are affected by the command. All DE AY and TIME parameters are in
tenths of seconds but must be specified in whole seconds.
Command format:
;14 <LEVEL1> <DELAY1> <TIME1> <LEVEL2> <DELAY2> <TIME2> <AREA>
<CHANNELS> <CR>
Example: Fade channels 1, 20 and 30 in area 1 to 40% in 3 seconds after a 1 second delay
then to 20% in 2 seconds after a 3 second delay.
;14 40 10 30 20 30 20 1 1 20 30 <CR>
Response:
:14 40 10 30 20 30 20 1 1 20 30 <CR>
*14<CR>
4 Preset Control
4.1 Recall Presets
This command will fade the selected presets on the lights. More than one AREA,
PRESET pair may be included before the carriage return so that multiple presets can be
recalled at the same time.
Command format:
;20 <AREA> <PRESET> <CR>
Example: Recall preset 3 in area 1 and preset 5 in area 6.
;20 1 3 6 5 <CR>
Response:
7

:20 1 3<CR>
:20 6 5<CR>
*20<CR>
Note: A separate response line will be sent for each area, preset pair.
4.2 Freeze Preset
This command stops preset fading in the specified areas. Multiple areas may be
specified.
Command format:
;23 <AREA> <CR>
Example: Freeze preset raising or lowering in area 5 and 2.
;23 5 2 <CR>
Response:
:23 5<CR>
:23 2 <CR>
*23<CR>
5 Time Clock Control
5.1 Disable Time Cloc
This command is used to disable selected time clocks. Time clocks are numbered from 2
to 128.
Command format:
;50 <TIME CLOCKS><CR>
Example: Disable time clocks 4 and 2.
;50 4 2 <CR>
Response:
:50 4<CR>
:50 2<CR>
*50<CR>
8

5.2 Enable Time Cloc
This command is used to enable selected time clocks. Time clocks are numbered from 2
to 128.
Command format:
;51 <TIME CLOCKS><CR>
Example: Enable time clocks 2 and 12.
;51 2 12 <CR>
Response:
:51 2<CR>
:51 12 <CR>
*51<CR>
5.3 Set Time
This command is used to set the date and time of the DX3 SCU clock.
Command format:
;54 <HOUR> <MINUTE> <MONTH> <DAY> <DAY OF WEEK> <YEAR> <CR>
Parameter ranges are as follows:
HOUR 0-23 (24 hour format)
MINUTE 0-59
MONTH 1-12
DAY 1 - 31
DAY OF WEEK 1 = Sunday, 2 = Monday, 3 = Tuesday.........7 = Saturday.
YEAR 1992 - 2091
The date and time may be checked using this command. Only parameters that are within
the specified range will set the respective time or date element. Parameters that are
outside the range will not result in an error but will remain at their current setting. This is
useful when only one parameter needs to be adjusted. However, all parameters must be
included in the command.
Example: Set the date and time to 1:05pm Tuesday March 11th 2016.
;54 13 5 3 11 3 2016<CR>
Response:
:54 13 5 3 11 3 2016<CR>
*54<CR>
9

Example: Only set the minutes to 25.
;54 100 25 100 100 100 5000<CR>
Response:
:54 13 25 3 11 3 2016<CR>
*54<CR>
Only the minutes will have been changed because it is the only parameter that is within
range. Note that the response returned all the time parameters.
6 Station Control
6.1 Loc Station Group
This command is used to lock stations by group. Groups are numbered 1 through 8. The
response is a list of Station IDs that were locked, followed by a list of groups that were
locked. Station ID is defined in section 2.2.1 . A response beginning with :30 means the
following station is locked. Note that stations can only be locked if they are assigned to a
lock group.
Command format:
;33 <GROUPS><CR>
Response:
:30 <STATION ID>
….
:33 <GROUP>
…
Example: ock station groups 4 and 8.
;33 4 8 <CR>
Response:
:30 0D02h<CR>
:30 0D03h<CR>
:30 0E00h<CR>
:30 0E01h<CR>
:33 4<CR>
:33 8<CR>
*33<CR>
Note that the response shows the station IDs that were locked as a result of locking the
groups. For the example, assume that all of the stations in the response were in either
lock group 4 or 8.
10

6.2 Unloc Station Group
This command is used to unlock a group of stations. Groups are numbered 1 through 8.
The response is a list of Station IDs that were unlocked, followed by a list of groups that
were unlocked. Station ID is defined in section 2.2.1 . A response beginning with :31
means the following station is locked.
Command format:
;34 <GROUPS><CR>
Response:
:31 <STATION ID>
….
:33 <GROUP>
…
Example: Unlock station groups 2 and 3.
;34 2 3 <CR>
Response:
:31 01300h<CR>
:31 01301h<CR>
:31 01202h<CR>
:31 01203h<CR>
:34 2<CR>
:34 3<CR>
*34<CR>
Note that the response shows the station IDs that were unlocked as a result of unlocking
the groups. For the example, assume that all of the stations in the response were in either
lock group 4 or 8.
6.3 Toggle Station Group
This command is used to reverse the lock status of the specified lock groups. The
response is the same as for locking/unlocking groups.
Command format:
;35 <GROUPS><CR>
Example: Toggle station lock group 4.
;35 4 <CR>
11

Response:
:30 0D05h<CR>
:30 0D06h<CR>
:30 01306h<CR>
:30 01307h<CR>
:33 4<CR>
*35<CR>
Partition Control
Partition control commands are used to combine or separate control between adjoining
areas when the wall between them is opened or closed. The wall number to operate on is
specified in the command as 1 - 16.
7.1 Open Wall
This command will combine the control between two areas when the wall separating
them is opened.
Command format:
;40 <WALLS> <CR>
Example: Open walls 1 and 5.
;40 1 5<CR>
Response:
:40 1<CR>
:40 5<CR>
*40<CR>
7.2 Close Wall
This command will separate the control between two areas when the wall separating them
is closed.
Command format:
;41 <WALLS> <CR>
Example: Close walls 1 and 5.
;41 1 5<CR>
Response:
:41 1<CR>
:41 5<CR>
12

*41<CR>
7.3 Toggle Wall
This command will reverse the open/close wall status of the specified walls.
Command format:
;42<WALLS><CR>
Example: Toggle walls 2 and 3.
;42 2 3<CR>
Response:
:40 2<CR>
:41 3<CR>
*42<CR>
Note that the response indicates the actions performed on the walls specified.
8 Miscellaneous Controls
8.1 Play Script or Chase
This command is used to play one script or chase. Scripts and chases are numbered 1 to
64. Note that the default script and chase names do not match the script and chase
numbers. For example, the name “Script 00” is script number 1.
Command format:
;60 <SCRIPT/CHASE><CR>
Example: Play Script 3.
;60 3 <CR>
Response:
:60 3<CR>
:20 1 25<CR>
:20 2 25<CR>
:20 3 25<CR>
*60<CR>
Note that the response will include commands that the script contained. In the example,
the script recalled preset FU in areas 1, 2 and 3.
13

8.2 Recall Bac up CUE
This command is used to recall a backup cue. Backup cues range from 1 through 99. 0
turns all the backup cues off. Only one backup cue can be recalled at a time.
Command format:
;62 <CUES><CR>
Example: Recall backup cue 4.
;62 4<CR>
Response:
:62 4<CR>
*62<CR>
8.3 Panic ON/OFF
This command is used to turn panic settings on or off. Set STATE to 0 to turn the
specified panic off, non-zero to turn it on. There are 2 panic settings specified as 1 or 2.
Both panics may be specified together in the same command.
Command format:
;63 <STATE><PANICS><CR>
Example: Turn both panic settings on.
;63 1 1 2 <CR>
Response:
:63 1 1<CR>
:63 1 2<CR>
*63<CR>
9 System Status
The system status commands are used to report various operating data of the Collage.
The format of the response is:
:<COMMAND ID><RESPONSE DATA><CR>
*<COMMAND ID><CR>
Response data is always given in decimal except where noted. The amount of response
data that is returned is command dependent.
14

9.1 Serial Number
This command will report the unique serial number permanently held in the DX3.
Command format:
;80 <CR>
Example response:
:80 071h 0DAh 085h 09Ch 000h 000h 000h 00Fh<CR>
*80<CR>
9.2 Date
This command is used to report the current date held in the DX3.
Command format:
;81 <CR>
Response format:
;81 <DAY><MONTH><YEAR><DAY OF WEEK><CR>
DAY 1-31
MONTH 1-January, 2-February, 3-March...
YEAR reported in full
DAY OF WEEK 1-Sunday, 2-Monday, 3-Tuesday...
Example response:
:81 20 03 2016 5<CR>
*81<CR>
The response indicates that the date is Thursday March 20th 2016.
9.3 Time
This command is used to report the current time held in the DX3.
Command format:
;82 <CR>
Response format:
:82 <HOURS><MINUTES><CR>
HOURS 24 hour format, 0-23
MINUTES 0-59
15

Example response:
:82 15 13<CR>
*82<CR>
The response indicates that the time is 3:13 pm.
9.4 Firmware Version
This command will report the firmware version of the operating software in the DX3.
Command format:
;83 <CR>
Response format:
The response is three decimal digits identifying the software version.
Example response:
:83 07 15 00<CR>
*83<CR>
The response indicates version 7.15.00
9.5 Area Status
This command reports the preset currently active in the requested area. Multiple areas
may be specified.
Command format:
;84 <AREAS><CR>
Response format:
:84 <AREA><PRESET><CR>
AREA 1-16
PRESET 1-24, 25=FU , 26=OFF
Example: Request status for areas 2 and 3.
;84 2 3<CR>
Response:
:84 2 25<CR>
:84 3 1<CR>
*84<CR>
16