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

i. LON 100 Internet Server Programmer’s Reference 12-1
13-1
12 Type Translator
You can use Type Translators to convert data points from one network variable type to
another. This may be useful when comparing data points from different vendors that use
different types, and are not compatible with each other.
When creating a Type Translator, you will choose a Type Translator Rule. The Type
Translator Rule defines the network variable type of the data points the Type Translator will
take as input, and the network variable type it will convert these data points to. The Type
Translator Rule define the scaling factors, case structures for handling enumerations and
fields within structures, and offsets that will be used to determine the value to assign the
output data point.
The
i. LON 100 software includes nine pre-defined Type Translator Rules. Each one is
described in detail later in this chapter. It is also possible to perform translations without
using a Type Translator Rule. This is possible when converting data from one scalar type to
another where no offset or multipliers are required, and when converting one type to another
with the same format description.
You can convert multiple input data points to a single output data point type, or you can
convert a single input data point to multiple output data points of different types using Type
Translators.
You can optionally create your own Type Translator Rules, or modify the Type Translator
Rules provided with the i. LON 100 software, using the TypeTranslatorRule SOAP functions.
For more information on creating Type Translator Rules, or on modifying the Type
Translator Rules provided with the i. LON 100 software, see Type Translator Rules on page
.
In addition, you will specify one or more input data points, and one or more output data
points. The network variable type of each data point will vary, depending on the Type
Translator Rule selected. When any of the input data points are updated, the Type
Translator will read the values of the input data points and assign new values to the output
data points, based on the values it reads and the Type Translator Rule selected.
12.1 TypeTranslator.XML
The TypeTranslator.XML file stores the configuration of all Type Translators you have added
to the i. LON 100.
Each defined Type Translator is signified by a element in the XML file.
You can create additional Type Translators using the TypeTranslatorSet function, or by
manually editing the XML file and downloading it to the i. LON 100 via FTP. The sections
following this example provide instructions and guidelines to follow when doing so.
The following represents a sample TypeTranslator.XML file for an
i. LON 100 with three
defined Type Translators.