FieldServer FS-8700-97 Computer Drive 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
1.
Page 3 of 11
Lutron Machine Description
The Lutron Machine driver allows the FieldServer to transfer data to and from devices over RS232 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
Client
1
Server
1
Comments
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.
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.
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
2.
Page 4 of 11
Driver Scope of Supply
2.1.
Supplied by FieldServer Technologies for this driver
FieldServer Technologies
Description
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.
Provided by the Supplier of 3rd Party Equipment
2.2.
2.2.1.
Part #
2.2.2.
Hardware
Description
Lutron eLumen Panel
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
3.
Page 5 of 11
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
8917-02 WIRE LIST
CAT 5 CABLE
FS-8915-10
FUNCTION
RX
CTS
DSR
GND
GND
DTR
RTS
TX
FROM
RJ45-01
RJ45-02
RJ45-03
RJ45-04
RJ45-05
RJ45-06
RJ45-07
RJ45-08
TO
DB9M-02
DB9M-08
DB9M-06
DB9M-05
DB9M-04
DB9M-07
DB9M-03
COLOUR
WHITE
BROWN
YELLOW
GREEN
RED
BLACK
ORANGE
BLUE
Power OK
Serial
(408)-262-2299
Tx
Rx
EIA232
Tx
Rx
Ethernet
-
USB
FS-B2010
+
EIA485
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
eLumen
Processor
Aux Link (RS-485)
User Interface link
Dimmer panel link
To dimmer panels
Inter-processor link
Power OK
Serial
Tx
Rx
EIA232
Tx
Rx
Ethernet
-
USB
+
EIA485
FS-B2010
(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
4.
Page 7 of 11
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
Data_Array_Name
Data_Array_Format
Data_Array_Length
Function
Legal Values
Up to 15 alphanumeric
Provide name for Data Array
characters
Float, Bit, UInt16, SInt16,
Provide data format. Each Data Packed_Bit,
Byte,
Array can only take on one format.
Packed_Byte,
Swapped_Byte
Number of Data Objects. Must be
larger than the data storage area
1-10,000
required by the Map Descriptors for
the data being placed in this array.
Example
//
Data Arrays
Data_Arrays
Data_Array_Name,
Binary_Output,
Binary_Input,
Analog_Output,
Analog_Input,
Data_Format,
Bit,
Bit,
Uint16,
Uint16,
Data_Array_Length
512
512
512
512
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
4.2.
Page 8 of 11
Client Side Connection Descriptions
Section Title
Connections
Column Title
Port
Protocol
Baud*
Parity*
Data_Bits*
Stop_Bits*
Handshaking*
Poll _Delay*
Function
Specify which port the device
is
connected
to
the
FieldServer
Specify protocol used
Specify baud rate
Specify parity
Specify data bits
Specify stop bits
Specify
hardware
handshaking
Time between internal polls
Legal Values
P1-P8, R1-R21
eLumen
9600
None
8
1
None
0-32000 seconds, 1 second
Example
//
Client Side Connections
Connections
Port,
Protocol,
P1,
eLumen,
Baud,
9600,
Parity,
None,
Handshaking,
None,
Poll_Delay
0.100s
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
4.3.
Page 9 of 11
Client Side Node Descriptors
Section Title
Nodes
Column Title
Node_Name
Node_ID
Protocol
Connection
Node_type
Function
Provide name for node
The eLumen processor address.
Only decimal values are allowed:
e.g. 11 hex must be entered as
17.
Specify protocol used
Specify which port the device is
connected to the FieldServer
Specifies the eLumen command
and data format
Legal Values
Up to 32 alphanumeric characters
0-255
eLumen
P1-P8, R1-R21
Hex, decimal
Example
//
Client Side Nodes
Nodes
Node_Name,
LUT_GRF6_0,
4.4.
Node_ID,
17,
Protocol,
eLumen,
Port,
P1,
Node_Type
Hex
Client Side Map Descriptors
4.4.1.
FieldServer Related Map Descriptor Parameters
Column Title
Map_Descriptor_Name
Data_Array_Name
Data_Array_Offset
Function
4.4.2.
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
Legal Values
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
Driver Related Map Descriptor Parameters
Column Title
Node_Name
Grafik_Command
Function
Legal Values
One of the node names
Name of Node to fetch data from
specified in “Client Node
Descriptor” above
Area Machine:
run_script_AB
Specifies the command that will be
area_sts_offscene
sent to the eLumen.
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
Column Title
Page 10 of 11
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
list of parameters needed to
execute the command.
The offset into the DA_Lut_List
DA_Lut_List_Offset
Data Array from where the list data
is to be used.
Name of Data Array that contains
DA_Lut_Parms
parameters needed to execute the
command.
The offset into the DA_Lut_Parms
DA_Lut_Parms_Offset Data Array where the driver will
retrieve the parameters.
Area
GRAFIK system area number
Sys_var
GRAFIK system variable number
Zone
GRAFIK system zone number
Length of Map Descriptor. The
length is an indication of the
number of data elements this Map
Length
Descriptor is responsible for
updating. It is used in the overall
points
calculation
of
the
FieldServer.
The length of the Data Array
specified under DA_Lut_List when
Multi_Scripts_Length
used with Grafik command:
run_script_multi
DA_Lut_List
4.4.3.
A Data Array name.
0 to the maximum offset
into the DA_Lut_List
Data Array.
A Data Array name.
0 to the maximum offset
into the DA_Lut_Parms
Data Array.
0 – 511
0 – 65535
0 – 511
See
example
Map
Descriptors for individual
lengths
per
Map
Descriptor.
1 – 10,000
Timing Parameters
Column Title
Scan_Interval
Function
Legal Values
Rate at which data is
≥0.001s
polled
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
4.4.4.
Page 11 of 24
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,
SMD00_BO,
Data_Array_Name,
Binary_Output,
Data_Array_Offset,
0,
Function,
Server,
Node_name,
Virtual_BCU_11,
Data_Type,
BO,
Object_ID,
1,
Length,
512,
Relinquish_Default
0
Lutron Machine Map Descriptor
//
Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
Run_Script_0,
Data_Array_Name,
Binary_Output,
Data_Array_Offset,
0,
Function,
AWT,
Node_name,
LUT_GRF6_0,
Grafik_Command,
run_script_AB,
DA_Lut_List,
Script_list_BO,
DA_Lut_List_Offset,
0,
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 ,
Script_list_BO ,
Uint16
Uint16
,
,
1
2
,
,
0
1
// Binary Output Object ID 2
Script_list_BO ,
Script_list_BO ,
Uint16
Uint16
,
,
3
4
,
,
2
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
Length
512
FS-8700-97_Lutron_Machine Manual
4.4.5.
Page 12 of 24
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,
SMD00_BI,
Data_Array_Name,
Binary_Input,
Data_Array_Offset,
0,
Function,
Server,
Node_name,
Virtual_BCU_11,
Data_Type,
BI,
Object_ID,
1,
Length,
512,
Relinquish_Default
0
Lutron Machine Map Descriptor
//
Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
Zone_int_0,
Data_Array_Name,
Binary_Input,
Data_Array_Offset,
0,
Function,
ARCO,
Node_name,
LUT_GRF6_0,
Grafik_Command,
zone_intensity,
Zone,
0,
Length
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
4.4.6.
Page 13 of 24
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,
SMD00_BI,
Data_Array_Name,
Binary_Input,
Data_Array_Offset,
0,
Function,
Server,
Node_name,
Virtual_BCU_11,
Data_Type,
BI,
Object_ID,
1,
Length,
512,
Relinquish_Default
0
Lutron Machine Map Descriptor
//
Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
Area_sts_0,
Data_Array_Name,
Binary_Input,
Data_Array_Offset,
0,
Function,
ARCO,
Node_name,
LUT_GRF6_0,
Grafik_Command,
area_sts_offscene,
Area,
0,
DA_Lut_List,
off_scene,
DA_Lut_List_Offset,
0,
Length
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
4.4.7.
Page 14 of 24
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,
SMD000_AO,
Data_Array_Name,
Analog_Output,
Data_Array_Offset,
0,
Function,
Server,
Node_name,
Virtual_BCU_11,
Data_Type,
AO,
Object_ID,
1,
Length,
512,
Relinquish_Default
0
Lutron Machine Map Descriptor
//
Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
Sel_scene_0,
Data_Array_Name,
Analog_Output,
Data_Array_Offset,
0,
Function,
AWT,
Node_name,
LUT_GRF6_0,
Grafik_Command,
sel_scene_in_area,
area,
0,
Length
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
4.4.8.
Page 15 of 24
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,
SMD000_AO,
Data_Array_Name,
Analog_Output,
Data_Array_Offset,
0,
Function,
Server,
Node_name,
Virtual_BCU_11,
Data_Type,
AO,
Object_ID,
1,
Length,
512,
Relinquish_Default
0
Lutron Machine Map Descriptor
//
Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
Fade_to_lvl_0,
Data_Array_Name,
Analog_Output,
Data_Array_Offset,
0,
Function,
AWT,
Node_name,
LUT_GRF6_0,
Grafik_Command,
fade_zone,
zone,
0,
DA_Lut_Parms,
Zone_pars_AO1,
DA_Lut_Parms_Offset,
0,
Length
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 ,
Zone_pars_AO1 ,
Uint16
Uint16
,
,
0
1
,
,
0
1
// Analog Output1 Object ID 2
Zone_pars_AO1 ,
Zone_pars_AO1 ,
Uint16
Uint16
,
,
2
3
,
,
2
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
4.4.9.
Page 16 of 24
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,
SMD512_AO,
Data_Array_Name,
Analog_Output,
Data_Array_Offset,
512,
Function,
Server,
Node_name,
Virtual_BCU_11,
Data_Type,
AO,
Object_ID,
513,
Length,
512,
Relinquish_Default
0
Lutron Machine Map Descriptor
//
Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
Run_script_512,
Data_Array_Name,
Analog_Output,
Data_Array_Offset,
512,
Function,
AWT,
Node_name,
LUT_GRF6_0,
Grafik_Command,
run_script_multi,
DA_Lut_List,
Scr_lst_AO2_512,
DA_Lut_List_Offset,
0,
Length,
1,
Multi_Scripts_Length
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 ,
Scr_lst_AO2_512 ,
Scr_lst_AO2_512 ,
Scr_lst_AO2_512 ,
Scr_lst_AO2_512 ,
Scr_lst_AO2_512 ,
Scr_lst_AO2_512 ,
Scr_lst_AO2_512 ,
Scr_lst_AO2_512 ,
Scr_lst_AO2_512 ,
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
,
,
,
,
,
,
,
,
,
,
100
200
300
400
500
600
700
800
900
65000
,
,
,
,
,
,
,
,
,
,
0
1
2
3
4
5
6
7
8
9
// Analog Output2 Object ID 514
Scr_lst_AO2_513 ,
Scr_lst_AO2_513 ,
Scr_lst_AO2_513 ,
Scr_lst_AO2_513 ,
Scr_lst_AO2_513 ,
Scr_lst_AO2_513 ,
Scr_lst_AO2_513 ,
Scr_lst_AO2_513 ,
Scr_lst_AO2_513 ,
Scr_lst_AO2_513 ,
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
,
,
,
,
,
,
,
,
,
,
101
201
301
401
501
601
701
801
901
65001
,
,
,
,
,
,
,
,
,
,
0
1
2
3
4
5
6
7
8
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
4.4.10.
Page 18 of 24
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,
Data_Array_
Name,
Analog_Input,
Data_Array_
Offset,
0,
Function,
Node_name,
Data_Type,
Server,
Virtual_BCU_11,
AI,
Object_
ID,
1,
Length,
Relinquish_Default,
1,
0,
Data_Array_
Low_Scale,
0,
Data_Array_
High_Scale,
100,
Node_
Low_Scale,
0,
Node_
High_Scale
100
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,
Last_scene_0,
Data_Array_Name,
Analog_Input,
Data_Array_Offset,
0,
Function,
ARCO,
Node_Name,
LUT_GRF6_0,
Grafik_Command,
area_status,
Area,
0,
Length
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.
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
4.4.11.
Page 19 of 24
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,
SMD00_AI,
Data_Array_Name,
Analog_Input,
Data_Array_Offset,
0,
Function,
Server,
Node_name,
Virtual_BCU_11,
Data_Type,
AI,
Object_ID,
1,
Length,
512,
Relinquish_Default
0
Lutron Machine Map Descriptor
//
Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
Zone_inta_0,
Data_Array_Name,
Analog_Input,
Data_Array_Offset,
0,
Function,
ARCO,
Node_name,
LUT_GRF6_0,
Grafik_Command,
zone_intensity,
zone,
0,
Length
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
4.4.12.
Page 20 of 24
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,
SMD00_MO,
Data_Array_Name,
MultiSt_Output,
Data_Array_Offset,
0,
Function,
Server,
Node_name,
Virtual_BCU_11,
Data_Type,
MO,
Object_ID,
1,
Length,
512,
Relinquish_Default,
0,
Lutron Machine Map Descriptor
//
Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
Run_scriptms_0,
Data_Array_Name,
MultiSt_Output,
Data_Array_Offset,
0,
Function,
AWT,
Node_name,
LUT_GRF6_0,
Grafik_Command,
run_script_multi,
DA_Lut_List,
Scr_lst_MSO_0,
DA_Lut_List_Offset,
0,
Length,
1,
Multi_Scripts_Length
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 ,
Scr_lst_MSO_0 ,
Scr_lst_MSO_0 ,
Scr_lst_MSO_0 ,
Scr_lst_MSO_0 ,
Scr_lst_MSO_0 ,
Scr_lst_MSO_0 ,
Scr_lst_MSO_0 ,
Scr_lst_MSO_0 ,
Scr_lst_MSO_0 ,
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
,
,
,
,
,
,
,
,
,
,
110
210
310
410
510
610
710
810
910
65010
,
,
,
,
,
,
,
,
,
,
0
1
2
3
4
5
6
7
8
9
// Multistate Output Object ID 2
Scr_lst_MSO_1 ,
Scr_lst_MSO_1 ,
Scr_lst_MSO_1 ,
Scr_lst_MSO_1 ,
Scr_lst_MSO_1 ,
Scr_lst_MSO_1 ,
Scr_lst_MSO_1 ,
Scr_lst_MSO_1 ,
Scr_lst_MSO_1 ,
Scr_lst_MSO_1 ,
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
Uint16
,
,
,
,
,
,
,
,
,
,
120
220
320
420
520
620
720
820
920
65020
,
,
,
,
,
,
,
,
,
,
0
1
2
3
4
5
6
7
8
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
4.4.13.
Page 22 of 24
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,
SMD00_BV,
Data_Array_Name,
Binary_Value,
Data_Array_Offset,
0,
Function,
Server,
Node_name,
Virtual_BCU_11,
Data_Type,
BV,
Object_ID,
1,
Length,
512,
Relinquish_Default
0
Lutron Machine Map Descriptor
//
Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
Zone_var_0,
Data_Array_Name,
Binary_Value,
Data_Array_Offset,
0,
Function,
ARCO,
Node_name,
LUT_GRF6_0,
Grafik_Command,
sys_var_val_bin,
Sys_Var,
0,
Length
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
4.4.14.
Page 23 of 24
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,
SMD00_AV,
Data_Array_Name,
Analog_Value,
Data_Array_Offset,
0,
Function,
Server,
Node_name,
Virtual_BCU_11,
Data_Type,
AV,
Object_ID,
1,
Length,
512,
Relinquish_Default
0
Lutron Machine Map Descriptor
//
Client Side Map Descriptors
Map_Descriptors
Map_Descriptor_Name,
Zone_vara_0,
Data_Array_Name,
Analog_Value,
Data_Array_Offset,
0,
Function,
Passive_Client,
Node_name,
LUT_GRF6_0,
Grafik_Command,
sys_var_val,
Sys_Var,
0,
Length
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
Driver
Ver.
1.00
1.01
1.02
1.02
Doc.
Rev.
0
1
1
2
10/15/03 MF
1.02
3
1/21/04
3/22/04
JD
DR
1.02
1.02
4
5
3/24/04
MC
1.02
6
6/10/04
JD
1.02
7
11/3/04
Meg
Meg
1.03
0
12/30/04 Meg
Meg
1.03
1
4/12/05
4/27/05
JD
JD
1.03
1.03
1
2
Date
Resp Format
07/04/03
07/08/03
09/05/03
09/09/03
DR
DR
DR
DR
JD
JD
MC
Comment
Created
Updated driver version, SPR2912
Updated with ARCO Map Descriptor usage
Updated with passive Client mapdescs
Updated according to DUR0215.
Updated
formatting
Releasing
Updated for release
Updated formatting. Added new revision table.
Changed page setup to letter.
Releasing
Changed references to Grafik to eLumen –
DUR0484.
Connection diagrams added for RS-232 and
RS-485. Modifications to scope of supply table.
Table formatting. Map Descriptor example titles
added. Added RS-485 compatibility.
Releasing
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