L-INX User Manual
290
LOYTEC
Version 4.0
LOYTEC electronics GmbH
The following clauses describe the Device object‘s properties in detail, subsuming related
properties in a single section in order to provide a coherent overview.
13.3.2 Client Mapping CSV File
Client functionality for the BACnet server objects can be defined by so-called
client
mappings
. These mappings basically specify whether present value properties shall be
written to or polled from the BACnet network, and what the destination address and objects
are. These definitions can be downloaded as a CSV file onto the device using FTP.
The CSV file must be named ‗bacclnt.csv‘ and stored in the directory ‗/var/lib/bacnet‘ on
the device. The file is read when the device boots. If any errors occur they are reported in
‗/tmp/bacclnt.err‘.
The column format is shown in Table 17. Lines beginning with a hash (‗#‘) sign are
comment lines. The example values in Table 17 setup a client mapping named ―Lamp
Room 302‖, which writes (mapping type 2) the present value of the local object AI,4 to the
remote object AO,1 on the device with the instance number 17801.
Column
Field
Example
Description
A
Description
Lamp Room 302
User-defined description of this client mapping. Can be
left empty. Don‘t use commas or semi-colons in the
text!
B
Local Object-Type
AI
The BACnet object type of the local server object (AI,
AO, AV, BI, BO, BV, MI, MO, MV)
C
Local Object
Instance Number
4
The object instance number of the above object.
D
Remote Device
Instance
17801
The device object instance number of the remote
BACnet device
E
Remote Object-
Type
AO
The BACnet object type of the remote server object (AI,
AO, AV, BI, BO, BV, MI, MO, MV)
F
Remote Object
Instance Number
1
The object instance number of the above object.
G
Map Type
2
Defines the type of the mapping: 0=Poll, 1=COV,
2=Write
H
Interval/
Priority
8
Defines the poll interval in seconds for poll mappings
and the COV lifetime in seconds for COV mappings.
For write mappings this defines the write priority
(1..16). Omit this field or set it to ‗-1‘ to write w/o
priority.
Table 17: CSV Columns of the BACnet Client Mappings File.
13.3.3 EDE Export of BACnet Objects
The BACnet server object configuration of the device is accessible as a set of CSV files
following the EDE format convention. They can be downloaded via FTP from the directory
‗/data/ede‘ on the device. The files are
lgate.csv: This is the main EDE sheet with the list of BACnet objects.
lgate-states.csv: This is the state text sheet. For each state text reference in the main
sheet, a line contains the state texts for this multi-state object.
lgate-types.csv: This is the object types text sheet. The file contains a line for each
object type number. Note, that lines for standard object types can be omitted.
lgate-units.csv: This is the unit text sheet. The file contains a line for each engineering
unit enumerator value. Note that lines for standard units can be omitted.
