beautypg.com

Type translator, Typetranslator.xml, Type translator -1 – Echelon i.LON 100 e2 Internet Server User Manual

Page 181: Typetranslator.xml -1, 12 type translator, 1 typetranslator.xml

background image

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.