Echelon i.LON SmartServer 2.0 - Manual (Page 44)

i.LON SmartServer 2.0 Programmer’s Reference 4-3
• The data points on the SmartServer’s internal automated systems device (i.LON App), which
contains the functional blocks representing the SmartServer’s built-in applications, are stored in a
Dp.xml file in the root/config/network/Net/LON/iLONApp directory on the SmartServer flash
disk by default.
• The data points for an external L
ON W ORKS digital input/output device connected to the
SmartServer might be stored in a Dp.xml file in the root/config/network/Net/LON/DIO-2
directory on the SmartServer flash disk.
• The data points on the SmartServer’s internal systems device (i.LON System), which contains
Interoperable Self-Installation (ISI) data points and data points containing connection manager and
LonTalk statistics, are stored in a Dp.xml file in the root/config/network/Net/VirtCh/iLONSystem
directory on the SmartServer flash disk.
• Note: The directories containing the Data Server’s Dp.xml files also contain separate
_Dp.xml files in which the data points’ driver properties are stored. The properties in
these files relate to a specific bus—L
ON W ORKS , Modbus, M-Bus, Virtual, or FPM—and not the
Data Server. These driver-specific properties and how to use the List, Get, Set, and Delete
functions on them are described in Chapters 14–17.
You can manage the Dp.xml files manually using an XML text editor, and download them to the
root/config/network///
directory of the SmartServer
via FTP. Echelon does not recommend this, as the SmartServer will require a reboot to read the
configuration of the downloaded XML files. Additionally, the SmartServer performs error checking
on all SOAP messages it receives before writing to the XML files. It will not perform error checking
on any XML files you download via FTP, and so the application may not boot properly.
However, if you plan to create or modify any XML files manually, you should review the rest of this
chapter first. This chapter describes the elements and properties in the Data Server configuration files
that define each data point’s configuration.
4.2 Overview of the Data Point XML File
The Dp.xml files on the SmartServer store the configurations of the data points that you have added to
the SmartServer under their respective parent network/channel/device directories. Each data point is
signified by an element of a Dp_Cfg type in the XML file. The configuration properties
contained in each element define the configuration of a data point, and are described later in
this chapter.
You can create new data points using the Set function, or by manually editing the Dp.xml file. You
can read the current value and status of a data point using the Read function, and you can write updated
values to data point using the Write function.
The following code represents a snippet of a sample Dp.xml file with one data point of an external
L
ON W ORKS digital input/output device connected to the SmartServer:
0
xsi:type="Dp_Cfg">
Net/LON/DIO-3/Digital Output[0]/DO_Digital_1
Dp_In;xsi:type="LON_Dp_Cfg"
0
2008-03-17T16:00:02.202-07:00
Digital value to output
#0000000000000000[0].SNVT_switch
2
LonFormat="UCPTdirection">DIR_IN
% of full level
field="state">state code
LonFormat="UCPTbaseType">BT_STRUCT
2
0.0
0.0