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. [. . . ] From the Main page, push the Scenes button. Select the scene you want to delete, push the To Scene. . . This removes all information and dimmers contained within this scene. ALD-H48 Lighting Controller 17 Using The Touch Panel Pages 18 ALD-H48 Lighting Controller Advanced Programming Advanced Programming Introduction This is a reference manual to describe the interface provided between an AMX NetLinx system and a Lutron H48 Lighting Controller. Further, the H48 supports 48 light loads (dimmers) and 24 keypads (addressable as keypad 1 through 24). Overview The COMM module translates between the standard interface described below and the H48 protocol. It parses the buffer for responses from the H48, sends strings to control the H48 and receives commands from the UI module or telnet sessions. A User Interface (UI) module is also provided. This UI uses the standard interface described below and it parses the command responses for feedback. The following diagram gives a graphical view of the interface between the interface code and the Duet module. NetLinx UI Module Virtual Device SNAPI Duet COMM Module Lutron H48 FIG. 13 Interface between code and NetLinx module Some functionality in the device interface may not be implemented in the API interface. In cases where device functions are desired but not API supported, the PASSTHRU command may be used to send any and all device-protocol commands to the device. See the PASSTHRU command and the Adding Functions to Modules section on page 36 for more information. A sample UI module and a touch panel file are provided in the module package. These are not intended to cover every possible application, but can be expanded as needed to meet the requirements of a particular installation. ALD-H48 Lighting Controller 19 Advanced Programming Implementation To interface to the AMX Lutron_H48_Comm. jar module, you must: 1. Define the device ID for the H48 to be controlled. Define the virtual device ID that the Lutron_H48_Comm. jar Duet module will use to communicate with the main program and User Interface. NetLinx virtual devices start with device number 41001. If a touch panel interface is needed, a touch panel file Lutron_H48. TP4 and module Lutron_H48_UI. axs have been created for testing. The NetLinx Lutron_H48_Comm. jar module must be included in the program with a DEFINE_MODULE command. This command starts execution of the module and passes in the following key information: the device ID of the H48 to be controlled, and the virtual device ID for communicating to the main program. An example of how to do this is shown below. DEFINE_DEVICE dvReal =0:5:0 dvTP =128:1:0 vdvLutron =41001:1:0 // The real H48 connected to the NetLinx IP port // The touch panel used for output /* The virtual device use for communication between the Comm module interface and User_Interface (UI) module interface. */ // Virtual device used by keypad 2. vdvKeypd2 =41001:2:0 DEFINE_VARIABLE VOLATILE DEV vdvArray[]={vdvLutron, vdvKeypd2} //Define arrays of button channels used on your own touch panel VOLATILE integer nButtons[]={1, 2, 3, 4, 5, 6, 7} DEFINE_START// Place define_module calls to the very end of the define_start section. // Comm module DEFINE_MODULE 'Lutron_H48_Comm' duet_code(vdvLutron, dvReal) // Touch panel module DEFINE_MODULE 'Lutron_H48_UI' ui_code(vdvArray, dvTP, nButtons) In order to establish a connection with the H48, the PROPERTY- command must be used to provide the Duet module with the correct IP to connect to, and the correct password needed to login. [. . . ] The Duet module will continuously attempt to establish a connection to the H48 as long as the password used in not reported as invalid. ALD-H48 Lighting Controller 35 Advanced Programming Adding Functions to Modules Commands to The Device This module supplies a mechanism to allow additional device features to be added to software using the module. This is the PASSTHRU command, which allows protocol strings to be passed through the module. The device-specific protocol must be known in order to use this feature. As an example, suppose that a module for a projector has not implemented the 'white balance adjustment' feature. [. . . ]