Programming Strings
15
AMX Lighting PROlink/AXlink Programming
Programming Strings
Strings
A string is a set of values grouped together with single and/or double quotes. Character arrays
(strings) are enclosed between double quotes while ASCII strings are enclosed within single
quotes. All ASCII strings are character arrays. If an ASCII string needs to be sent with non-ASCII
characters, it must first be enclosed in double quotes and then the non-ASCII characters must be
delineated with commas. Axcess looks at:
PROlink Programming Strings
PROlink accepts ASCII commands from the AXlink connection. These commands take the form of
a Send_String command to the AXlink device. Most commands are terminated with a carriage
return. A carriage return is represented by the decimal value 13 or the hexadecimal form $0D.
Response (feedback) values for presets, time values, and dimmer levels are usually three characters.
The AMX Lighting controller is both an AXlink and PROlink device. You can send PROlink
commands through the AXlink COM port, but you cannot send AXlink commands to the PROlink
port.
A sample command structure is shown below:
The 'RT5' are ASCII characters and the '13' are decimal characters. Everything within the double
quotes gets sent out when followed with a carriage return, <CR> like $0D.
The ASCII character
C
or $0C precedes all responses from the AMX Lighting controller. The
PROlink response will have a carriage return $0D and a line feed $0A at the end of each response.
For example purposes the <device> is always named 'LTS' and the <CR> will be substituted with
the Decimal numerals 13. Levels are expressed in percent from level 0 (zero) to 99 with full On or
100% expressed as two characters, FF.
In the command format, such as the one shown below, the <n> parameter refers to the individual
dimmer number or group of dimmers. The value <n> can be in the range from 1 to 60. It can be
expressed as a compound number using the - (dash) and & (ampersand). The letter A for ALL
('include all 60 dimmers') is also valid as a value for <n>. The string '
1&3-6&9L99
' is an example
of a compound group consisting of dimmers 1, 3, 4, 5, 6, and 9. The example string '
AL0T0
' would
send all 60 dimmers to level 0 instantly. The following is a generalized PROlink command structure
example:
• ASCII characters
These characters are surrounded with single quotes.
• Hexadecimal characters These characters begin with a $. An example is $0D that acts as a
carriage return and enters the information.
• Decimal characters
These characters are numerical and are not enclosed with any quota-
tion but are separated from other types of characters by a comma.
• Example:
SEND_STRING <device>,"'<command string>', <CR>"
• Example 2:
Send_String LTS, "'RT5', 13"
• PROlink response example:
C
RAMPTIME SET AT 005
Содержание ProLink PRO-DP8
Страница 1: ...instruction manual Lighting Control AMX Lighting PROlink AXlink Programming ...
Страница 4: ......
Страница 8: ...iv AMX Lighting PROlink AXlink Programming Table of Contents ...
Страница 14: ...Introduction 6 AMX Lighting PROlink AXlink Programming ...
Страница 22: ...Pre Installation Settings 14 AMX Lighting PROlink AXlink Programming ...
Страница 46: ...Appendix A PROlink vs AXlink Commands 38 AMX Lighting PROlink AXlink Programming ...
Страница 65: ...Appendix C Troubleshooting 57 AMX Lighting PROlonl AXlink Programming ...