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

i.LON SmartServer 2.0 Programmer’s Reference 3-3
3.3 SmartServer Resource Files
There are many configuration properties you can configure with the SOAP functions described in this
document. This document provides a general description of each property, and other information you
will need when configuring each one, such as minimum and maximum values for scalar properties, and
maximum string lengths for string properties. This information is also contained in the SmartServer
resource files. In order to successfully send a SOAP message to the SmartServer, all data in the
message must be formatted as described in this document and in the resource files.
The SmartServer resource files are added to the LNS resource file catalog by the SmartServer software
installation utility, but they also exist locally on the SmartServer. In fact, like LNS, the SmartServer
maintains a catalog of resource files to use when formatting data in SOAP messages, network variable
updates, and web tag data from the SmartServer web server.
You can use the Node Builder Resource Editor, which is included on the SmartServer software
installation CD, to create new resource files for your own custom data point types and formats. Note
that when creating custom resource files on a PC, it is common to organize the files into subdirectories
such as:
C:\LonWorks\Types\User\YourCompany\YourResourceFiles.*
When adding these files to the SmartServer, it is the best practice to FTP them to a location on the
SmartServer flash disk matching the path on your computer:
/root/lonworks/types/User/YourCompnay/YourResourceFiles.*
You only need to FTP your own custom resource files to the SmartServer. If the name of your file set
is "MyResourceFiles", then you must copy every file which starts with the name "MyResourceFiles".
After you have copied these files to the SmartServer you must reboot to be able to use the new type
definitions and formats. During boot the SmartServer reads the resource files in this directory and
updates its local catalog accordingly.
3.3.1 Standard Network Variable Type (SNVT) Device Resource Files
SNVT device resource files describe the data structures within LonMark
®
SNVTs, and the formats
used to display SNVT data. On the SmartServer, you can find these files in the
/root/lonworks/types directory. They are named STANDARD.ENU, STANDARD.TYP,
STANDARD.FMT, and STANDARD.FPT.
The default format for a SNVT is its native format, as described in STANDARD.FMT. When you
add a data point to the SmartServer, you will assign that data point a format type. If a specific SNVT
format is desired for a particular data point, the of that data point must be
set to the name of that SNVT format.
You can browse the entire SNVT device resource files online at http://types.lonmark.org.
3.3.2 Standard Configuration Property Type (SCPT) Device Resource Files
This is a set of files that describes the data structures within SCPTs, and also describes the formats
used to display SCPT data. On the SmartServer, these files can be found in the directory
/root/lonworks/types
directory. These files are named STANDARD.ENU,
STANDARD.TYP, STANDARD.FMT and STANDARD.FPT.
Many configuration properties that are used by the SmartServer applications are based on the SCPTs
defined in these files. The information provided in this document, and in the SCPT resource files, will
help you determine what values to assign to the SCPTs referenced by the SmartServer.
You can browse the entire SCPT device resource files online at http://types.lonmark.org.