Echelon i.LON 100 e2 Internet Server - Manual (Page 52)

5.2 Creating and Modifying the Data Server XML Files
The i. LON 100 generates all of the Data Server configuration files the first time it boots. The
DP_NVL.XML file will contain an element for each static NV on the device that has
been created with L ON M AKER . New NVL data points will be added to the DP_NVL.XML file
automatically when more local NVs are created in L ON M AKER. The DP_NVC.XML file will
not contain any data point entries the first time the i. LON 100 boots.
You can use the DataServerSet function to add new NVC data points to the Data Server and
to the DP_NVC.XMl file. You can also use DataServerSet to modify the configuration of
existing NVL and NVC data points in the Data Server. The following section, Data Server
SOAP Interface, describes how to use DataServerSet and the other SOAP functions provided
for use with the Data Server.
You can manage the Data Server XML files manually using an XML text editor, and
download them to the /root/config/software directory of the
i. LON 100 via FTP. Echelon does
not recommend this, as the i. LON 100 will require a reboot to read the configuration of the
downloaded XML files. Additionally, the i. LON 100 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. For instructions on creating or
modifying an XML file manually, see Manually Modifying an XML Configuration File on
page 15-1.
5.2.1 Data Server SOAP Interface
The SOAP interface for the Data Server application includes seven functions. Table 8 lists
and describes these functions. For more information, see the sections following Table 8.
Table 8 Data Server SOAP Functions
Function Description
DataServerList Use this function to list the index number, name and location of
each data point that you have added to the Data Server. For
more information, see DataServerList on page 5-10.
DataServerGet Use this function to return the configuration of a data point. For
more information, see DataServerGet on page 5-12.
DataServerSet Use this function to create an NVC data point and add it to the
Data Server, or to modify the configuration of an existing NVL
or NVC data point. For more information, see DataServerSet on
page 5-17.
DataServerRead Use this function to read the current value of a data point, or
group of data points, that has been added to the Data Server.
For more information, see DataServerRead on page 5-19.
DataServerWrite Use this function to write to the value of a data point, or group of
data points. For more information, see DataServerWrite on page
5-24.
i. LON 100 Internet Server Program 5-8 mer’s Reference