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

i.LON SmartServer 2.0 Programmer’s Reference 3-4
3.3.3 User-Defined Network Variable Type (UNVT) Device Resource Files
Device manufacturers create UNVT device resource files to describe non-standard, manufacturer
specific network variables. Using the same mechanisms as the standard resource files, these files
describe how to format data from a particular manufacturer's device. On the SmartServer, you can find
all device resource files in the /root/lonworks/types directory.
To specify UNVT formats a fully qualified format name is required as follows:
#[].
In this syntax, the “ #”, “[“, “]” and “.” characters are literal characters. A hex byte string (in the
“ RAW_HEX_PACKED” format described below) represents the program ID. The selector is a one-digit
string. It represents a filter that indicates relevant parts of the program ID, and may be one of the
following:
0 - Standard
1 - Device Class
2 - Device Class and Usage
3 - Manufacturer
4 - Manufacturer and Device Class
5 - Manufacturer, Device Class, and Device Subclass
6 - Manufacturer, Device Class, Device Subclass, and Device Model
The format name syntax is similar to that used for SNVT types, except that the type name starts with
“UNVT” instead of “SNVT”. For example:
#800001128000000[4].UNVT_date_event
3.3.4 User-Defined Configuration Property Type (UCPT) Device Resource
Files
This is a set of files that describes the data structures within UCPTs and also describes the formats
used to display UCPT data. On the SmartServer, these files may be found in the
/root/lonworks/types directory. The files are named BAS_Controller.ENU,
BAS_Controller.TYP, BAS_Controller.FMT and BAS_Controller.FPT.
Echelon added these UCPTs for configuration properties used by SmartServer applications that have
no SCPT definition. You can browse the UCPT resource files online at http://types.echelon.com.
3.3.5 Data Point Templates
There is a set of data point templates in the root/config/template/lonworks/Dp directory that provide
the default configurations for new instances of specific data point types. These XML files contain the
default presets and the default heartbeat, throttle, and offline configuration properties for a number of
common data types, including SNVT_switch, SNVT_occupancy, SNVT_temp (including #SI and
#US formats), and SNVT_temp_f (including #SI and #US formats). This is very useful for working
with the data points of the external devices that you may add to the SmartServer.
3.3.6 Data Formatting
In order to keep the SOAP/XML interface neutral across regions, most of the rules for formatting data,
which would normally be changeable in LNS, are not changeable on the SmartServer. The one
exception is the support of measurement system locale, which was introduced in version 1.1 of the
SOAP/XML interface. The following list describes the various regional settings used by the
SmartServer SOAP / XML interface:
Decimal Symbol – Always period "."