FieldServer FS-8700-97 User Manual

A Sierra Monitor Company
Driver Manual
(Supplement to the FieldServer Instruction Manual)
FS-8700-97 Lutron Machine
APPLICABILITY & EFFECTIVITY
Effective for all systems manufactured after May 1, 2001
FS-8700-97_Lutron_Machine Manual Table of Contents
TABLE OF CONTENTS
1. Lutron Machine Description.............................................................................................3
2. Driver Scope of Supply.....................................................................................................4
2.1. Supplied by FieldServer Technologies for this driver ...................................................4
2.2. Provided by the Supplier of 3rd Party Equipment..........................................................4
2.2.1. Hardware...................................................................................................................4
2.2.2. Required 3rd Party Software......................................................................................4
2.2.3. Required 3rd Party Configuration...............................................................................4
3. Hardware Connections.....................................................................................................5
4. Configuring the FieldServer as a Lutron Machine Client..............................................7
4.1. Data Arrays/Descriptors ...............................................................................................7
4.2. Client Side Connection Descriptions ............................................................................8
4.3. Client Side Node Descriptors .......................................................................................9
4.4. Client Side Map Descriptors .........................................................................................9
4.4.1. FieldServer Related Map Descriptor Parameters......................................................9
4.4.2. Driver Related Map Descriptor Parameters ..............................................................9
4.4.3. Timing Parameters..................................................................................................10
4.4.4. Map Descriptor Example 1 - Binary Output (Zone and Area Machine)...................11
4.4.5. Map Descriptor Example 2 - Binary Input (Zone Machine) .....................................12
4.4.6. Map Descriptor Example 3 - Binary Input (Area Machine)......................................13
4.4.7. Map Descriptor Example 4 - Analog Output 1 (Area Machine)...............................14
4.4.8. Map Descriptor Example 5 - Analog Output 1 (Zone Machine)...............................15
4.4.9. Map Descriptor Example 6 - Analog Output 2 (Zone and Area Machine)...............16
4.4.10. Map Descriptor Example 7 - Analog Input (Area Machine)..................................18
4.4.11. Map Descriptor Example 8 - Analog Input (Zone Machine).................................19
4.4.12. Map Descriptor Example 9 - Multistate Output (Zone and Area Machine)...........20
4.4.13. Map Descriptor Example 10 - Binary Value (Zone and Area Machine) ...............22
4.4.14. Map Descriptor Example 11 - Analog Value (Zone and Area Machine) ..............23
Appendix A. Revision History .............................................................................................24
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 3 of 11
1. Lutron Machine Description
The Lutron Machine driver allows the FieldServer to transfer data to and from devices over RS­232 using Lutron eLumen protocol. The FieldServer can emulate either a Server or Client, although the Lutron Machine driver is only available in Client configuration. Any Server drivers are for FieldServer testing purposes only.
Max Nodes Supported
FieldServer Mode Nodes Comments
Client 1
Server 1
The Lutron Grafik Machine Zone/Area Machine driver, hereafter simply referred to as the Lutron Machine driver, provides a BACNet IP interface to a Lutron eLumen panel. The driver can be configured to represent zones or areas as used in the Lutron eLumen panel. The FieldServer acts as both Client and Server to provide BACNet objects to an external BACNet Client. In Server mode, the FieldServer collects data from the eLumen panel and holds the data ready for reads from an external BACNet Client. In Client mode, the FieldServer executes pre-defined commands on the eLumen panel, for example, running scripts.
Only one Lutron Machine driver Client node is able to be connected to a Lutron eLumen panel. One BACNet IP node provides an upstream interface to the Lutron eLumen panel.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 4 of 11
2. Driver Scope of Supply
2.1. Supplied by FieldServer Technologies for this driver
FieldServer Technologies PART #
FS-8915-10 UTP cable (7 foot) for RS-232 use FS-8917-02 RJ45 to DB9F connector adapter FS-8700-97 Driver Manual.
Description
2.2. Provided by the Supplier of 3rd Party Equipment
2.2.1. Hardware
Part # Description
Lutron eLumen Panel
2.2.2. Required 3rd Party Software
An external BACnet IP Client to interface to the Lutron Machine on the FieldServer.
2.2.3. Required 3rd Party Configuration
BACnet IP Client must be set up to access FieldServer over the network.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 5 of 11
3. Hardware Connections
The FieldServer is connected to the Lutron eLumen panel as shown in the connection drawing below:
Configure the eLumen panel according to manufacturer’s instructions.
FS-8917-02
FS-8917-02
LUTRON SERIAL RS-232 INTERFACE PART # 470-784
CAT 5 CABLE
FS-8915-10
Serial
RxTx RxTx
EthernetEIA232 USB EIA485
FS-B2010
Power OK
FUNCTION FROM TO COLOUR
RX RJ45-01 DB9M-02 WHITE CTS RJ45-02 DB9M-08 BROWN DSR RJ45-03 DB9M-06 YELLOW
GND RJ45-04 DB9M-05 GREEN GND RJ45-05 RED DTR RJ45-06 DB9M-04 BLACK
RTS RJ45-07 DB9M-07 ORANGE
TX RJ45-08 DB9M-03 BLUE
-
+
8917-02 WIRE LIST
(408)-262-2299
LUTRON ELUMEN RS-232
CONNECTION DIAGRAM
BASE NAME: FILE NAME: FS-T28700-84 .VSD
DATE: 11/12/04 BY: MC
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 6 of 11
120V 15A Dedicated Control Feed
Wallstation link
To control stations
Aux Link (RS-485)
User Interface link
Inter-processor link
Serial
RxTx RxTx
EthernetEIA232 USB EIA485
FS-B2010
eLumen
Processor
Power OK
Dimmer panel link
-
+
To dimmer panels
(408)-262-2299
LUTRON ELUMEN RS-485
CONNECTION DIAGRAM
BASE NAME: FILE NAME: FS-T28700-84 .VSD
DATE: 11/12/04 BY: MC
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 7 of 11
4. Configuring the FieldServer as a Lutron Machine Client
For a detailed discussion on FieldServer configuration, please refer to the FieldServer instruction manual. The information that follows describes how to expand upon the factory defaults provided in the configuration files included with the FieldServer (See “.csv” sample files provided with the FieldServer).
This section documents and describes the parameters necessary for configuring the FieldServer
to communicate with a Lutron eLumen panel.
4.1. Data Arrays/Descriptors
The configuration file tells the FieldServer about its interfaces, and the routing of data required. In order to enable the FieldServer for Lutron Machine communications, the driver independent FieldServer buffers need to be declared in the “Data Arrays” section, the destination device addresses need to be declared in the “Client Side Nodes” section, and the data required from the Servers needs to be mapped in the “Client Side Map Descriptors” section. Details on how to do this can be found below.
Note that in the tables, * indicates an optional parameter, with the bold legal value being the default.
Section Title
Data_Arrays
Column Title Function Legal Values
Data_Array_Name Provide name for Data Array
Data_Array_Format
Data_Array_Length
Example
// Data Arrays
Data_Arrays Data_Array_Name, Data_Format, Data_Array_Length Binary_Output, Bit, 512 Binary_Input, Bit, 512 Analog_Output, Uint16, 512 Analog_Input, Uint16, 512
Provide data format. Each Data Array can only take on one format.
Number of Data Objects. Must be larger than the data storage area required by the Map Descriptors for the data being placed in this array.
Up to 15 alphanumeric characters Float, Bit, UInt16, SInt16, Packed_Bit, Byte, Packed_Byte, Swapped_Byte
1-10,000
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 8 of 11
4.2. Client Side Connection Descriptions
Section Title
Connections
Column Title Function Legal Values
Specify which port the device
Port
Protocol Specify protocol used eLumen Baud* Specify baud rate 9600 Parity* Specify parity None Data_Bits* Specify data bits Stop_Bits* Specify stop bits
Handshaking*
Poll _Delay* Time between internal polls 0-32000 seconds, 1 second
Example
// Client Side Connections
Connections Port, Protocol, Baud, Parity, Handshaking, Poll_Delay P1, eLumen, 9600, None, None, 0.100s
is connected to the
P1-P8, R1-R21
FieldServer
8 1
Specify hardware handshaking
None
1
Not all ports shown are necessarily supported by the hardware. Consult the appropriate Instruction
manual for details of the ports available on specific hardware.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 9 of 11
4.3. Client Side Node Descriptors
Section Title
Nodes
Column Title Function Legal Values
Node_Name Provide name for node Up to 32 alphanumeric characters
The eLumen processor address.
Node_ID
Only decimal values are allowed: e.g. 11 hex must be entered as
17.
Protocol Specify protocol used eLumen
Connection
Node_type
Specify which port the device is connected to the FieldServer Specifies the eLumen command and data format
Example
// Client Side Nodes
Nodes Node_Name, Node_ID, Protocol, Port, Node_Type LUT_GRF6_0, 17, eLumen, P1, Hex
0-255
P1-P8, R1-R2
Hex, decimal
1
4.4. Client Side Map Descriptors
4.4.1. FieldServer Related Map Descriptor Parameters
Column Title Function Legal Values
Map_Descriptor_Name
Data_Array_Name
Data_Array_Offset
Function
Name of this Map Descriptor Name of Data Array where data is to be stored in the FieldServer Starting location in Data Array Function of Client Map Descriptor
Up to 32 alphanumeric characters
One of the Data Array names from “Data Array” section above
0 to maximum specified in “Data Array” section above ARCO, AWT, RDBC, Passive_Client
4.4.2. Driver Related Map Descriptor Parameters
Column Title Function Legal Values
Node_Name Name of Node to fetch data from
Grafik_Command
Specifies the command that will be sent to the eLumen.
One of the node names specified in “Client Node Descriptor” above Area Machine: run_script_AB area_sts_offscene sel_scene_in_area run_script_multi
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 10 of 11
Column Title Function Legal Values
area_status sys_var_val_bin sys_var_val
Zone Machine: run_script_AB zone_intensity fade_zone run_script_multi zone_intensity sys_var_val_bin sys_var_val
Name of Data Array that contains a
DA_Lut_List
list of parameters needed to
A Data Array name.
execute the command.
DA_Lut_List_Offset
The offset into the DA_Lut_List Data Array from where the list data is to be used.
0 to the maximum offset into the DA_Lut_List Data Array.
Name of Data Array that contains
DA_Lut_Parms
parameters needed to execute the
A Data Array name.
command.
DA_Lut_Parms_Offset
The offset into the DA_Lut_Parms Data Array where the driver will retrieve the parameters.
0 to the maximum offset into the DA_Lut_Parms
Data Array. Area GRAFIK system area number 0 – 511 Sys_var GRAFIK system variable number 0 – 65535 Zone GRAFIK system zone number 0 – 511
Length of Map Descriptor. The
Length
length is an indication of the number of data elements this Map Descriptor is responsible for updating. It is used in the overall points calculation of the
See example Map
Descriptors for individual
lengths per Map
Descriptor.
FieldServer. The length of the Data Array
Multi_Scripts_Length
specified under DA_Lut_List when used with Grafik command:
1 – 10,000
run_script_multi
4.4.3. Timing Parameters
Column Title Function Legal Values
Scan_Interval
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Rate at which data is polled
0.001s
FS-8700-97_Lutron_Machine Manual Page 11 of 24
4.4.4. Map Descriptor Example 1 - Binary Output (Zone and Area Machine)
A write to the Binary Output Data Array which is shared by a BACNet IP Map Descriptor will execute one of two scripts on the eLumen panel. The script numbers corresponding to binary inactive (0) and active (1) are specified in the Data Array specified by “DA_Lut_List” from offset specified by “DA_Lut_List_Offset”. Script numbers range from 0 to 65535.
BACnet IP Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Data_Type, Object_ID, Length, Relinquish_Default SMD00_BO, Binary_Output, 0, Server, Virtual_BCU_11, BO, 1, 512, 0
Lutron Machine Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Grafik_Command, DA_Lut_List, DA_Lut_List_Offset, Length Run_Script_0, Binary_Output, 0, AWT, LUT_GRF6_0, run_script_AB, Script_list_BO, 0, 512
The Data Array specified under “DA_Lut_List” must be preloaded with script numbers as shown below:
//================================================================================ // Binary Output Scripts Setup // // All values are in decimal (0 - 65535) // ScriptA in even locations, ScriptB in uneven locations, values in Preload_Data_Value // ScriptA will be run when writing zero into the Object ID // ScriptB will be run when writing non-zero into the object ID
Preloads Data_Array_Name , Preload_Data_Format , Preload_Data_Value , Location
// Binary Output Object ID 1 Script_list_BO , Uint16 , 1 , 0 Script_list_BO , Uint16 , 2 , 1
// Binary Output Object ID 2 Script_list_BO , Uint16 , 3 , 2 Script_list_BO , Uint16 , 4 , 3
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 12 of 24
4.4.5. Map Descriptor Example 2 - Binary Input (Zone Machine)
A read from the Binary Input Data Array which is shared by a BACNet IP Map Descriptor will return the relay state for the given zone. The Lutron Machine Map Descriptor regularly polls the eLumen panel to retrieve the value of zone intensity. The value of each BACNet object presenting Binary Output is inactive if the intensity is zero and active if the intensity is non-zero. Zone numbers range from 0 to 511
BACNet IP Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Data_Type, Object_ID, Length, Relinquish_Default SMD00_BI, Binary_Input, 0, Server, Virtual_BCU_11, BI, 1, 512, 0
Lutron Machine Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Grafik_Command, Zone, Length Zone_int_0, Binary_Input, 0, ARCO, LUT_GRF6_0, zone_intensity, 0, 512
The ARCO function is the same as RDBC except that the length of the Map Descriptor is taken as the number of zones to poll. The start zone number is specified under the “Zone” Map Descriptor field. More than one ARCO Map Descriptor may be used to poll two series of zone numbers, eg. from 5-10 and from 300-340. ARCO Map Descriptors with Length 1 perform the same function as RDBC Map Descriptors with the same length.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 13 of 24
4.4.6. Map Descriptor Example 3 - Binary Input (Area Machine)
A read from the Binary Input Data Array which is shared by a BACNet IP Map Descriptor will return the scene-on state for the given area. The Lutron Machine Map Descriptor regularly polls the eLumen panel to retrieve the scene-on state for the given area. The value returned by the BACNet object is inactive (0) if the off scene is selected and active (1) if any other scene is selected. The off scene numbers range from 0 to 65535 and are preloaded in the Data Array specified under “DA_Lut_List”.
BACNet IP Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Data_Type, Object_ID, Length, Relinquish_Default SMD00_BI, Binary_Input, 0, Server, Virtual_BCU_11, BI, 1, 512, 0
Lutron Machine Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Grafik_Command, Area, DA_Lut_List, DA_Lut_List_Offset, Length Area_sts_0, Binary_Input, 0, ARCO, LUT_GRF6_0, area_sts_offscene, 0, off_scene, 0, 512
The ARCO function is the same as RDBC except that the Map Descriptor length is taken as the number of areas to poll. The start area number is specified under the “Area” Map Descriptor field. More than one ARCO Map Descriptor may be used to poll two series of area numbers, eg. from 5-10 and from 300-340. ARCO Map Descriptors with Length 1 perform the same function as RDBC Map Descriptors with the same length.
The Data Array specified under “DA_Lut_List” must be preloaded with scene numbers as shown below:
//================================================================================ // Binary Input Scenes Setup // // All values are in decimal ( 0 - 65535 ) // Insert the off-scene number in the preload_data_value field Preloads Data_Array_Name , Preload_Data_Format , Preload_Data_Value , Location
// Binary Input Object ID 1 off_scene , Uint16 , 0 , 0
// Binary Input Object ID 2 off_scene , Uint16 , 1 , 1
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 14 of 24
4.4.7. Map Descriptor Example 4 - Analog Output 1 (Area Machine)
A write to the Analog Output Data Array which is shared by a BACNet IP Map Descriptor will command an area to a preset scene on the Lutron eLumen panel. Scenes range from 0 to 65535 and area numbers range from 0 to 511
BACNet IP Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Data_Type, Object_ID, Length, Relinquish_Default SMD000_AO, Analog_Output, 0, Server, Virtual_BCU_11, AO, 1, 512, 0
Lutron Machine Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Grafik_Command, area, Length Sel_scene_0, Analog_Output, 0, AWT, LUT_GRF6_0, sel_scene_in_area, 0, 512
The area field must be used to indicate the start area number that will be associated with the first element of the Data Array specified under Data_Array_Name. Area numbers increase with the Length field in association with increasing offset into the Data Array.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 15 of 24
4.4.8. Map Descriptor Example 5 - Analog Output 1 (Zone Machine)
A write to the Analog Output Data Array which is shared by a BACNet IP Map Descriptor will command a zone on the Lutron eLumen panel to the written intensity. Intensities are written as a percentage value (0 to 100%).
BACNet IP Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Data_Type, Object_ID, Length, Relinquish_Default SMD000_AO, Analog_Output, 0, Server, Virtual_BCU_11, AO, 1, 512, 0
Lutron Machine Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Grafik_Command, zone, DA_Lut_Parms, DA_Lut_Parms_Offset, Length Fade_to_lvl_0, Analog_Output, 0, AWT, LUT_GRF6_0, fade_zone, 0, Zone_pars_AO1, 0, 512
The zone field must be used to indicate the start zone number that will be associated with the first element of the Data Array specified under Data_Array_Name . Zone numbers increase with the Length field in association with increasing offset into the Data Array.
Fade and Delay times per zone must be preloaded into the Data Array specified under “DA_Lut_Parms”: //================================================================================ // Analog Output1 Settings Setup // // All values are in decimal ( 0 - 65535 ) // Fade time in even locations, Delay time in uneven locations // Fill in time values under Preload_Data_Value
Preloads Data_Array_Name , Preload_Data_Format , Preload_Data_Value , Location
// Analog Output1 Object ID 1 Zone_pars_AO1 , Uint16 , 0 , 0 Zone_pars_AO1 , Uint16 , 1 , 1
// Analog Output1 Object ID 2 Zone_pars_AO1 , Uint16 , 2 , 2 Zone_pars_AO1 , Uint16 , 3 , 3
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 16 of 24
4.4.9. Map Descriptor Example 6 - Analog Output 2 (Zone and Area Machine)
A write to the Analog Output Data Array which is shared by a BACNet IP Map Descriptor will execute one of multiple scripts on the Lutron eLumen panel. The value written into the Analog Output Data Array is used as an offset into the Data Array defined under “DA_Lut_List” to retrieve a script number. Script numbers range from 0 to 65535.
BACNet IP Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Data_Type, Object_ID, Length, Relinquish_Default SMD512_AO, Analog_Output, 512, Server, Virtual_BCU_11, AO, 513, 512, 0
Lutron Machine Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Grafik_Command, DA_Lut_List, DA_Lut_List_Offset, Length, Multi_Scripts_Length Run_script_512, Analog_Output, 512, AWT, LUT_GRF6_0, run_script_multi, Scr_lst_AO2_512, 0, 1, 10
The Multi_Scripts_Length field is used to indicate the maximum size of the Data Array specified under Data_Array_Name. One Map Descriptor per object must be defined with a Multi_Scripts_Length value of 1 or greater.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 17 of 24
The script numbers per BACNet object element need to be preloaded into the Data Arrays defined under “DA_Lut_List”.
//==================================================================== // Analog Output2 Settings Setup // // All values are in decimal ( 0 - 65535 ) // Specify up to 10 scripts for each Object ID by editing Preload_Data_Value Preloads Data_Array_Name , Preload_Data_Format , Preload_Data_Value , Location
// Analog Output2 Object ID 513 Scr_lst_AO2_512 , Uint16 , 100 , 0 Scr_lst_AO2_512 , Uint16 , 200 , 1 Scr_lst_AO2_512 , Uint16 , 300 , 2 Scr_lst_AO2_512 , Uint16 , 400 , 3 Scr_lst_AO2_512 , Uint16 , 500 , 4 Scr_lst_AO2_512 , Uint16 , 600 , 5 Scr_lst_AO2_512 , Uint16 , 700 , 6 Scr_lst_AO2_512 , Uint16 , 800 , 7 Scr_lst_AO2_512 , Uint16 , 900 , 8 Scr_lst_AO2_512 , Uint16 , 65000 , 9
// Analog Output2 Object ID 514 Scr_lst_AO2_513 , Uint16 , 101 , 0 Scr_lst_AO2_513 , Uint16 , 201 , 1 Scr_lst_AO2_513 , Uint16 , 301 , 2 Scr_lst_AO2_513 , Uint16 , 401 , 3 Scr_lst_AO2_513 , Uint16 , 501 , 4 Scr_lst_AO2_513 , Uint16 , 601 , 5 Scr_lst_AO2_513 , Uint16 , 701 , 6 Scr_lst_AO2_513 , Uint16 , 801 , 7 Scr_lst_AO2_513 , Uint16 , 901 , 8 Scr_lst_AO2_513 , Uint16 , 65001 , 9
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 18 of 24
4.4.10. Map Descriptor Example 7 - Analog Input (Area Machine)
A read from the Analog Input Data Array which is shared by a BACNet IP Map Descriptor will return the last scene selected in a given area on the Lutron eLumen panel. The Lutron Machine Map Descriptor regularly polls the Lutron eLumen panel to retrieve the scene numbers.
BACNet IP Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptors_ Name, SMD00_AI, Analog_Input, 0, Server, Virtual_BCU_11, AI, 1, 1, 0, 0, 100, 0, 100
Data_Array_ Name,
The last scene value may be scaled:
//================================================================================ // Analog Input Settings Setup // // All values are in decimal ( 0 - 65535 ) // Insert a first available scene number under the Data_Array_High_Scale field for each Object ID or // use the scale fields as desired to scale scene numbers. // Object IDs are contiguous
Lutron Machine Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_Name, Grafik_Command, Area, Length Last_scene_0, Analog_Input, 0, ARCO, LUT_GRF6_0, area_status, 0, 512
The ARCO function is the same as RDBC except that the length of the Map Descriptor is taken as the number of areas to poll. The start area number is specified under the “Area” Map Descriptor field. More than one ARCO Map Descriptors may be used to poll two series of area numbers, eg. from 5-10 and from 300-340. ARCO Map Descriptors with Length 1 fullfil the same function as RDBC Map Descriptors with the same length.
Data_Array_ Offset,
Function, Node_name, Data_Type, Object_
ID,
Length, Relinquish_Default, Data_Array_
Low_Scale,
Data_Array_ High_Scale,
Node_ Low_Scale,
Node_ High_Scale
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 19 of 24
4.4.11. Map Descriptor Example 8 - Analog Input (Zone Machine)
A read from the Analog Input Data Array which is shared by a BACNet IP Map Descriptor will return the intensity to which a given zone is set on the Lutron eLumen panel. The Lutron Machine Map Descriptor regularly polls the Lutron eLumen panel to retrieve the zone intensities. The intensity value returned is scaled to a percentage value (0 to 100%). Zone numbers range from 0 to 511.
BACNet IP Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Data_Type, Object_ID, Length, Relinquish_Default SMD00_AI, Analog_Input, 0, Server, Virtual_BCU_11, AI, 1, 512, 0
Lutron Machine Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Grafik_Command, zone, Length Zone_inta_0, Analog_Input, 0, ARCO, LUT_GRF6_0, zone_intensity, 0, 512
The ARCO function is the same as RDBC except that the length of the Map Descriptor is taken as the number of zones to poll. The start zone number is specified under the “zone” Map Descriptor field. More than one ARCO Map Descriptors may be used to poll two series of zone numbers, eg. from 5-10 and from 300-340. ARCO Map Descriptors with Length 1 fullfil the same function as RDBC Map Descriptors with the same length.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 20 of 24
4.4.12. Map Descriptor Example 9 - Multistate Output (Zone and Area Machine)
A write to the Multistate Output Data Array which is shared by a BACNet IP Map Descriptor will execute one of multiple scripts. The multiple scripts are specified in the Data Array defined under “DA_Lut_List”. The value written into the Multistate Output Data Array is used as the offset into the Data Array defined under “DA_Lut_List” to retrieve a script number from the Data Array. Script numbers range from 0 to 65535.
BACNet IP Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Data_Type, Object_ID, Length, Relinquish_Default, SMD00_MO, MultiSt_Output, 0, Server, Virtual_BCU_11, MO, 1, 512, 0,
Lutron Machine Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Grafik_Command, DA_Lut_List, DA_Lut_List_Offset, Length, Multi_Scripts_Length Run_scriptms_0, MultiSt_Output, 0, AWT, LUT_GRF6_0, run_script_multi, Scr_lst_MSO_0, 0, 1, 10
The Multi_Scripts_Length field is used to indicate the maximum size of the Data Array specified under Data_Array_Name. One Map Descriptor per object must be defined with a Multi_Scripts_Length value of one or greater.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 21 of 24
The scripts per object element must be preloaded into the Data Array defined under “DA_Lut_List”:
//===================================================================== // Multistate Output Scripts Setup // // All values are in decimal ( 0 - 65535 ) // Specify up to 10 scripts for each Object ID by editing Preload_Data_Value
Preloads Data_Array_Name Preload_Data_Format Preload_Data_Value Location
// Multistate Output Object ID 1 Scr_lst_MSO_0 , Uint16 , 110 , 0 Scr_lst_MSO_0 , Uint16 , 210 , 1 Scr_lst_MSO_0 , Uint16 , 310 , 2 Scr_lst_MSO_0 , Uint16 , 410 , 3 Scr_lst_MSO_0 , Uint16 , 510 , 4 Scr_lst_MSO_0 , Uint16 , 610 , 5 Scr_lst_MSO_0 , Uint16 , 710 , 6 Scr_lst_MSO_0 , Uint16 , 810 , 7 Scr_lst_MSO_0 , Uint16 , 910 , 8 Scr_lst_MSO_0 , Uint16 , 65010 , 9
// Multistate Output Object ID 2 Scr_lst_MSO_1 , Uint16 , 120 , 0 Scr_lst_MSO_1 , Uint16 , 220 , 1 Scr_lst_MSO_1 , Uint16 , 320 , 2 Scr_lst_MSO_1 , Uint16 , 420 , 3 Scr_lst_MSO_1 , Uint16 , 520 , 4 Scr_lst_MSO_1 , Uint16 , 620 , 5 Scr_lst_MSO_1 , Uint16 , 720 , 6 Scr_lst_MSO_1 , Uint16 , 820 , 7 Scr_lst_MSO_1 , Uint16 , 920 , 8 Scr_lst_MSO_1 , Uint16 , 65020 , 9
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 22 of 24
4.4.13. Map Descriptor Example 10 - Binary Value (Zone and Area Machine)
A read from the Binary Value Data Array which is shared by a BACNet IP Map Descriptor will return the current value of a system variable in the Lutron eLumen panel. The value returned is inactive (0) if the system variable is zero and active (1) if non-zero. The Lutron Machine Map Descriptor regularly polls the Lutron panel to retrieve the system variable values. A write to the Binary Value Data Array will set the system variable to 255 on active (1) write or to zero on inactive (0) write.
BACNet IP Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Data_Type, Object_ID, Length, Relinquish_Default SMD00_BV, Binary_Value, 0, Server, Virtual_BCU_11, BV, 1, 512, 0
Lutron Machine Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Grafik_Command, Sys_Var, Length Zone_var_0, Binary_Value, 0, ARCO, LUT_GRF6_0, sys_var_val_bin, 0, 512
The ARCO function is the same as RDBC except that the length of the Map Descriptor is taken as the number of system variables to poll. The start system variable number is specified under the “Sys_Var” Map Descriptor field. More than one ARCO Map Descriptor may be used to poll two series of system variable numbers, eg. from 5-10 and from 300-340. ARCO Map Descriptors with Length 1 fullfil the same function as RDBC Map Descriptors with the same length.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 23 of 24
4.4.14. Map Descriptor Example 11 - Analog Value (Zone and Area Machine)
A read from the Analog Value Data Array which is shared by a BACNet IP Map Descriptor will return the current value of a system variable in the Lutron eLumen panel. The variable values range from 0 to 255. The Lutron Machine Map Descriptors are regularly updated with system variable values from the active Binary Value Map Descriptors. A write to the Analog Value Data Array will set the system variable to the written value.
BACNet IP Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Data_Type, Object_ID, Length, Relinquish_Default SMD00_AV, Analog_Value, 0, Server, Virtual_BCU_11, AV, 1, 512, 0
Lutron Machine Map Descriptor
// Client Side Map Descriptors
Map_Descriptors Map_Descriptor_Name, Data_Array_Name, Data_Array_Offset, Function, Node_name, Grafik_Command, Sys_Var, Length Zone_vara_0, Analog_Value, 0, Passive_Client, LUT_GRF6_0, sys_var_val, 0, 512
The Passive_Client function is used to prevent double-polling the Lutron eLumen panel for system variables. The Analog Value Map Descriptors should be set up identical to the Binary Value Map Descriptors in terms of the Sys_Var and Length fields to ensure system variable values will be stored correctly.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
FS-8700-97_Lutron_Machine Manual Page 24 of 24
Appendix A. Revision History
Date Resp Format
Driver Ver.
Doc. Rev.
Comment
07/04/03 DR 1.00 0 Created 07/08/03 DR 1.01 1 Updated driver version, SPR2912
09/05/03 DR 1.02 1 Updated with ARCO Map Descriptor usage
09/09/03 DR 1.02 2 Updated with passive Client mapdescs
10/15/03 MF 1.02 3
Updated according to DUR0215. Updated formatting
1/21/04 JD 1.02 4 Releasing
3/22/04 DR 1.02 5 Updated for release
3/24/04 MC MC 1.02 6
Updated formatting. Added new revision table. Changed page setup to letter.
6/10/04 JD 1.02 7 Releasing
11/3/04 Meg Meg 1.03 0
Changed references to Grafik to eLumen – DUR0484. Connection diagrams added for RS-232 and
12/30/04 Meg Meg 1.03 1
RS-485. Modifications to scope of supply table. Table formatting. Map Descriptor example titles added. Added RS-485 compatibility.
4/12/05 JD JD 1.03 1 Releasing
4/27/05 JD JD 1.03 2 Corrected page numbering. Releasing.
FieldServer Technologies 1991 Tarob Court Milpitas, California 95035 USA Web:www.fieldserver.com
Tel: (408) 262-2299 Fax: (408) 262-9042 Toll_Free: 888-509-1970 email: support@fieldserver.com
Loading...