User manual AMX ALD-H48 AMX NETWORK LIGHTING SOLUTION DIMMER INTERFACE

instruction manual ALD-H48 Network Lighting Solution Lighting Control AMX Limited Warranty and Disclaimer AMX Corporation warrants its products to be free of defects in material and workmanship under normal use for three (3) years from the date of purchase from AMX Corporation, with the following exceptions: · · · Electroluminescent and LCD Control Panels are warranted for three (3) years, except for the display and touch overlay components that are warranted for a period of one (1) year. Disk drive mechanisms, pan/tilt heads, power supplies, and MX Series products are warranted for a period of one (1) year. AMX Lighting products are guaranteed to switch on and off any load that is properly connected to our lighting products, as long as the AMX Lighting products are under warranty. AMX Corporation does guarantee the control of dimmable loads that are properly connected to our lighting products. The dimming performance or quality cannot be guaranteed due to the random combinations of dimmers, lamps and ballasts or transformers. Unless otherwise specified, OEM and custom products are warranted for a period of one (1) year. AMX Software is warranted for a period of ninety (90) days. Batteries and incandescent lamps are not covered under the warranty. · · · This warranty extends only to products purchased directly from AMX Corporation or an Authorized AMX Dealer. All products returned to AMX require a Return Material Authorization (RMA) number. The RMA number is obtained from the AMX RMA Department. The RMA number must be clearly marked on the outside of each box. The RMA is valid for a 30-day period. After the 30-day period the RMA will be cancelled. Any shipments received not consistent with the RMA, or after the RMA is cancelled, will be refused. AMX is not responsible for products returned without a valid RMA number. AMX Corporation is not liable for any damages caused by its products or for the failure of its products to perform. This includes any lost profits, lost savings, incidental damages, or consequential damages. AMX Corporation is not liable for any claim made by a third party or by an AMX Dealer for a third party. This limitation of liability applies whether damages are sought, or a claim is made, under this warranty or as a tort claim (including negligence and strict product liability), a contract claim, or any other claim. This limitation of liability cannot be waived or amended by any person. This limitation of liability will be effective even if AMX Corporation or an authorized representative of AMX Corporation has been advised of the possibility of any such damages. This limitation of liability, however, will not apply to claims for personal injury. Some states do not allow a limitation of how long an implied warranty last. Some states do not allow the limitation or exclusion of incidental or consequential damages for consumer products. In such states, the limitation or exclusion of the Limited Warranty may not apply. This Limited Warranty gives the owner specific legal rights. The owner may also have other rights that vary from state to state. The owner is advised to consult applicable state laws for full determination of rights. EXCEPT AS EXPRESSLY SET FORTH IN THIS WARRANTY, AMX CORPORATION MAKES NO OTHER WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. AMX CORPORATION EXPRESSLY DISCLAIMS ALL WARRANTIES NOT STATED IN THIS LIMITED WARRANTY. ANY IMPLIED WARRANTIES THAT MAY BE IMPOSED BY LAW ARE LIMITED TO THE TERMS OF THIS LIMITED WARRANTY. Software License and Warranty Agreement LICENSE GRANT. AMX grants to Licensee the non-exclusive right to use the AMX Software in the manner described in this License. The AMX Software is licensed, not sold. The AMX Software consists of generally available programming and development software, product documentation, sample applications, tools and utilities, and miscellaneous technical information. Please refer to the README.TXT file on the compact disc or download for further information regarding the components of the AMX Software. The AMX Software is subject to restrictions on distribution described in this License Agreement. YOU MAY NOT LICENSE, RENT, OR LEASE THE AMX SOFTWARE. You may not reverse engineer, decompile, or disassemble the AMX Software. INTELLECTUAL PROPERTY. The AMX Software is owned by AMX and is protected by United States copyright laws, patent laws, international treaty provisions, and/or state of Texas trade secret laws. Licensee may make copies of the AMX Software solely for backup or archival purposes. Licensee may not copy the written materials accompanying the AMX Software. TERMINATION. AMX RESERVES THE RIGHT, IN ITS SOLE DISCRETION, TO TERMINATE THIS LICENSE FOR ANY REASON AND UPON WRITTEN NOTICE TO LICENSEE. In the event that AMX terminates this License, the Licensee shall return or destroy all originals and copies of the AMX Software to AMX and certify in writing that all originals and copies have been returned or destroyed. PRE-RELEASE CODE. Portions of the AMX Software may, from time to time, as identified in the AMX Software, include PRE-RELEASE CODE and such code may not be at the level of performance, compatibility and functionality of the final code. The PRE-RELEASE CODE may not operate correctly and may be substantially modified prior to final release or certain features may not be generally released. AMX is not obligated to make or support any PRE-RELEASE CODE. ALL PRE-RELEASE CODE IS PROVIDED "AS IS" WITH NO WARRANTIES. LIMITED WARRANTY. AMX warrants that the AMX Software will perform substantially in accordance with the accompanying written materials for a period of ninety (90) days from the date of receipt. AMX DISCLAIMS ALL OTHER WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, WITH REGARD TO THE AMX SOFTWARE. THIS LIMITED WARRANTY GIVES YOU SPECIFIC LEGAL RIGHTS. Any supplements or updates to the AMX SOFTWARE, including without limitation, any (if any) service packs or hot fixes provided to you after the expiration of the ninety (90) day Limited Warranty period are not covered by any warranty or condition, express, implied or statutory. LICENSEE REMEDIES. AMX's entire liability and your exclusive remedy shall be repair or replacement of the AMX Software that does not meet AMX's Limited Warranty and which is returned to AMX. This Limited Warranty is void if failure of the AMX Software has resulted from accident, abuse, or misapplication. Any replacement AMX Software will be warranted for the remainder of the original warranty period or thirty (30) days, whichever is longer. Outside the United States, these remedies may not available. NO LIABILITY FOR CONSEQUENTIAL DAMAGES. IN NO EVENT SHALL AMX BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THIS AMX SOFTWARE, EVEN IF AMX HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. BECAUSE SOME STATES/COUNTRIES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES, THE ABOVE LIMITATION MAY NOT APPLY TO YOU. U.S. GOVERNMENT RESTRICTED RIGHTS. The AMX Software is provided with RESTRICTED RIGHTS. Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 or subparagraphs (c)(1) and (2) of the Commercial Computer Software Restricted Rights at 48 CFR 52.227-19, as applicable. This Agreement replaces and supercedes all previous AMX Software License Agreements and is governed by the laws of the State of Texas, and all disputes will be resolved in the courts in Collin County, Texas, USA. Should you have any questions concerning this Agreement, or if you desire to contact AMX for any reason, please write: AMX Corporation, 3000 Research Drive, Richardson, TX 75082. Table of Contents Table of Contents Overview ....................................................................................................................1 Getting Started ..........................................................................................................3 Step 1: Downloading The ALD-H48 Workspace .............................................................. 3 Step 2: Setting The ALD-H48 IP Address ........................................................................ 3 Step 3: Opening The ALD-H48 Workspace ..................................................................... 3 Step 4: Transferring The ALD-H48 Project to A NetLinx Master...................................... 4 Using The Web Interface ..........................................................................................5 Addressing The Dimmers via The Web Interface.............................................................. 5 Controlling Dimmers via The Web Page ........................................................................... 7 Establishing And Modifying Scenes .................................................................................. 8 Establishing And Modifying Groups ................................................................................ 10 Using The Touch Panel Pages ..............................................................................11 Touch Panel Main Page .................................................................................................. 11 Dimmer Light Adjustment....................................................................................................... 12 Setup Page...................................................................................................................... 13 Addressing Dimmers.............................................................................................................. 14 Setting Unique Names ........................................................................................................... 14 Groups Page ................................................................................................................... 14 Creating A Group ................................................................................................................... 15 Scenes Page ................................................................................................................... 16 Creating A Lighting Scene ..................................................................................................... 17 Deleting A Lighting Scene...................................................................................................... 17 Advanced Programming ........................................................................................19 Introduction...................................................................................................................... 19 Overview ......................................................................................................................... 19 Implementation................................................................................................................ 20 Port Mapping ................................................................................................................... 21 Channel Assignment and Feedback ............................................................................... 21 Command Interface......................................................................................................... 23 Command Feedback ....................................................................................................... 30 Device Notes ................................................................................................................... 33 Programming Notes ........................................................................................................ 34 Adding Functions to Modules .......................................................................................... 36 Commands to The Device...................................................................................................... 36 Updating The ALD-H48 Firmware .........................................................................37 ALD-H48 Lighting Controller i Table of Contents Via 232 ............................................................................................................................ 37 Via Ethernet: ................................................................................................................... 37 ii ALD-H48 Lighting Controller Overview Overview The ALD-H48 from AMX is a Lutron lighting solution with a complementary Duet module. The result is a Lutron device that functions within a NetLinx project. After you have installed the ALD-H48, using the installation documentation included with the unit, you can create a NetLinx project and configure the dimmers. You need NetLinx Studio v2.3 or higher and a NetLinx Master capable of running Duet modules (firmware version 3.0.XXX or higher). Using the web interface capabilities of your NetLinx master you can configure dimmers connected to your ALD-H48. The web interface supports: Internet Explorer v 6.0 (and higher) Mozilla Firefox v 1.0 (and higher) ALD-H48 Lighting Controller 1 Overview 2 ALD-H48 Lighting Controller Getting Started Getting Started Step 1: Downloading The ALD-H48 Workspace First you must attain the ALD-H48 Workspace file (.AXW). To download the Duet module go to either amx.com > Dealers > InConcert or the Product Catalog page for the ALD-H48. From the InConcert page you can search for and download the ALD-H48 Duet module, they are indicated by the D within the legend displayed below. FIG. 1 Module Legend Included in the .AXW file: The NetLinx Main Code (.AXS) The Duet module (.JAR) Associated TPD4 files Step 2: Setting The ALD-H48 IP Address In order for the NetLinx Master to locate the ALD-H48, you must set the IP address for the device. 1. Connect your PC to the H48 serial port using a standard DB-9 serial cable. 2. Open your preferred serial client (HyperTerm, TELNET, etc...) 3. Make sure your serial connection baud rate and handshaking settings match the H48 serial settings. (Default Baud Rate 9600, Data Bits: 8, Parity: None, Stop Bits: 1, Flow Control: None) 4. Upon a successful connection, you are prompted with L232>. At the prompt type SETIP,1, xxx.xxx.xxx.xxx . Follow the onscreen instructions from this point. (Where 1 is the number of processors present on the H48 and xxx.xxx.xxx.xxx is the IP address to be decided by you.) Further, at the prompt type HELP and a list of all supported command is displayed. In order to get the correct syntax to set the IP address type at the prompt HELP, SETIP. Step 3: Opening The ALD-H48 Workspace After you have downloaded the ALD-H48 Workspace file you need to open your NetLinx project. The .AXW file provided by AMX is intended to be a starting point for your ALD-H48 project. 1. Launch NetLinx Studio v2.3 or higher. 2. Select File > Open Workspace to launch the Open Workspace dialog. 3. Browse to the location where you saved the ALD-H48 Workspace file (.AXW) and click Open. 4. Manually enter the IP address assigned to the ALD-48 within Lutron_H48_UI.axs and then recompile the project before transferring it to the NetLinx Master. ALD-H48 Lighting Controller 3 Getting Started You can also make any additional edits to the ALD-H48 project or elect to send the file to the NetLinx Master as is. There is a "simple" version of the ALD-H48 files. These files are intended for demonstration purposes only. Step 4: Transferring The ALD-H48 Project to A NetLinx Master NetLinx Studio can transfer the ALD-H48 project file to any connected NetLinx Master with firmware version 3.XX or higher. 1. Select Tools > File Transfer to open the File Transfer dialog. 2. If the Workspace file is not already listed in the window click Quick Load to open the corresponding dialog. 3. In the drop down list select the ALD-H48 Workspace. 4. Click Select All. 5. Click OK. 6. Make sure there is a check in the box next to the ALD-H48 workspace within the File Transfer dialog and click Send. 4 ALD-H48 Lighting Controller Using The Web Interface Using The Web Interface Addressing The Dimmers via The Web Interface Once you have installed the ALD-H48 and dimmers using the hardware installation literature included with the unit, you must now address the dimmers. You can only select addresses available on the bus to which the dimmer is physically connected. For example, if you want to assign address 17 to a particular dimmer, it must be connected to bus 3 of the ALD-H48 as indicated below. Bus Address Location Bus 1 2 3 4 5 6 Address 1-8 9-16 17-24 25-32 33-40 41-48 To address the dimmers: 1. Using your web browser, go to the target NetLinx Master's web page. Refer to the NetLinx Master documentation for more detailed information concerning the NetLinx Master Web Interface. 2. Click on Lights and all connected modules are displayed below Lights. There is only one module per device. Upon your first visit to Lights, the page will have the following message, FIG. 2. FIG. 2 Initial Lights Configuration Page 3. Click Address Mode to set the master to look for available dimmers. 4. Tap the dimmer you wish to address three times to make it available to the master. 5. The displayed addresses are only those that are available on that physical bus that have not been used. Bold text indicates the address has already been assigned. Pick an available number and click Select to address the dimmer. ALD-H48 Lighting Controller 5 Using The Web Interface FIG. 3 Dimmer Address 6 ALD-H48 Lighting Controller Using The Web Interface Controlling Dimmers via The Web Page Once a dimmer has been addressed, you have access to a few basic level controls from the master's web page. 1. Click the button Dimmer Control to open the Dimmer Control page. (FIG. 4) FIG. 4 Dimmer Control Listed in the column on the left are all dimmer addresses available for control. On the right is a percentage bargraph representation of the current state of the selected dimmer. 2. To change the state of a dimmer, select a dimmer address in the column on the left. Click on 100% to ramp the dimmer completely on and 0% to ramp the dimmer off. Click within the bargraph area on the right to shift the dimmer state up and down to a desired percentage. ALD-H48 Lighting Controller 7 Using The Web Interface Establishing And Modifying Scenes Once your dimmers have been addressed and states set, you can create a scene. A scene is a collection of dimmers with specific states for each dimmer, i.e., Scene 1 could be set as a meeting scene where Dimmers 1 and 12 ramp down to 45%, Dimmers 6 and 14 ramp to 80% and Dimmers 2 through 5 ramp to 0% and all dimmers delay 10 seconds after the scene is selected before initiating. A dimmer can be a part of many different scenes. To create a scene: 1. Click the Scenes button at the top of the page. Shown below is the Scene page. FIG. 5 Scene Page 2. Click the Modify button for the Scene you would like to set. This opens the Modify Scene page. 8 ALD-H48 Lighting Controller Using The Web Interface FIG. 6 Modify Scene 3. Moving left to right the first field is a check box. Placing a check in the box includes the dimmer in the scene. Once you have all of your desired dimmers selected you can set the Delay time. The delay time is the duration, in 1/10ths of seconds, it takes the dimmers to respond to the button push. 4. Type a number value in the field Delay Time. The next field is the ramp time. The ramp time is the duration, in 1/10ths of seconds, it takes the dimmers to go from their current intensity state to that set in the scene. 5. Type a number value in the field Ramp Time. The next field is intensity. Intensity is a percentage value, 0-100%, for the luminosity of the light. 6. Type a number value in the field Intensity. 7. Click Save to set your scene. Global Adjustment allows you to select and deselect all dimmers at one time, and to set the Delay Time, Ramp Time and Intensity values for all dimmers, to the same value. When modifying scenes, ignored dimmers will display their current intensity level while dimmers included in the scene will display their defined intensity level, not necessarily the current state. ALD-H48 Lighting Controller 9 Using The Web Interface Establishing And Modifying Groups For the purpose of controlling several dimmers at one time you can place them into groups. The groups can then be manipulated collectively. 1. Click the Groups button to list all available group numbers. 2. Click the Modify button for the Group you would like to set. This opens the Modify Group page. Shown below. FIG. 7 Modify Group In the column on the left is a list of all dimmers available for adding to the group. The column on the right is a list of all dimmers currently included in the selected group. 3. Select an available dimmer on the left and click the ">" button in the center to move it to the included list on the right. You can move all dimmers at one time by clicking on the ">>" button, remove a dimmer from the scene list by clicking the "<" button and remove all dimmers by clicking "<<". 4. Click Save to set your group. 10 ALD-H48 Lighting Controller Using The Touch Panel Pages Using The Touch Panel Pages Touch Panel Main Page After you have loaded the Lutron_H48.TP4 sample file, it is displayed on the Main Page (FIG. 8) of your touch panel. The Main Page is displayed after each subsequent reboot. FIG. 8 Touch Panel Main Page Near the bottom of the panel page are the 4 buttons for configuring your system. Click on any of the buttons to access their pages. The buttons are: Setup - access addressing mode and set addresses for connected dimmers. Groups - create dimmer groups and assign ramping for them. Scenes - create and edit lighting scenes; scenes support intensity, fade time and delay time. Keypad - access basic functionality such as ON and OFF, keypads can be customized. The sample file supports 4 scenes. Click on buttons 1 through 4 to recall a scene. ALD-H48 Lighting Controller 11 Using The Touch Panel Pages Dimmer Light Adjustment The dimmer light adjustment allows you to turn on and off specific dimmers, ramp dimmers up and down and set dimmers to specific levels between 0 and 100%. Toggle Dimmer Ramp Up/Down Keypad Dimmer On Open Keypad Dimmer Off FIG. 9 Dimmer Light Adjustment Toggle Dimmer - moves through all addressed dimmers connected to the ALD-H48. Dimmer Off - turns the selected dimmer off. Dimmer On - turns the selected dimmer on. Ramp Up - click on the button to incrementally raise the dimmer's intensity. Ramp Down - click on the button to incrementally lower the dimmer's intensity. Open Keypad - opens the keypad to set the dimmer intensity percentage. Keypad Enter a percentage for the dimmer intensity. Go - accepts the percentage value entered. Del - deletes value entered into the keypad. Exit - closes the keypad. To adjust a dimmer: 1. Using the buttons, toggle to the addressed dimmer. You can turn the dimmer on or off using the Dimmer On and Dimmer Off buttons. 12 ALD-H48 Lighting Controller Using The Touch Panel Pages Push the Ramp Up and Ramp Down buttons to raise and lower the dimmer levels incrementally. 2. Push the "%" button to open the keypad, type the percentage value for the dimmer. 3. Push Go to set the dimmer intensity. Setup Page Opening the Setup page places the ALD-H48 in addressing mode which will allow you to allocate addresses to attached dimmers. It is recommended you address your dimmers at the time your lighting system is first installed. The Setup page has a total of 48 buttons (8 per each of the 6 buses) shown below. FIG. 10 Setup Page It is important to remember which bus the dimmer is physically connected to when addressing. ALD-H48 Lighting Controller 13 Using The Touch Panel Pages Addressing Dimmers 1. From the Main page, push the Setup button. 2. Push the Addressing Off button, this will place the ALD-H48 in addressing mode. 3. Push the dimmer you wish to address three times. The serial number of the dimmer appears at the bottom of the page as a confirmation. 4. Select the address number for the dimmer. Remember to select the bus to which the dimmer is physically attached. It is recommended you assign unique names to the address buttons after you have addressed them. 5. Upon a succesful addressing of a dimmer, a confirmation message is displayed at the bottom of the page and Addressing mode is turned off automatically Otherwise, an error message is displayed. If you select the wrong bus the addressing fails to assign. Setting Unique Names 1. Press the dimmer address button for three seconds. 2. Type the name you wish to assign to the button. 3. Press Done to save and exit. Groups Page The Groups page allows you to set and edit dimmers into groupings of several dimmers. Represented on the page is 48 buttons for each possible dimmer, grouped according to corresponding buses. The buttons are either numbered, or custom labels if assigned. 14 ALD-H48 Lighting Controller