Echelon i.LON 100 e2 Internet Server User Manual

Page 186

Advertising
background image

Table 61 TypeTranslatorGet Output Properties

Property Description

<UCPTindex>

The index number assigned to the Type Translator must be in the range 0-32,767.

As mentioned earlier, you can use the TypeTranslatorSet function to create a new
Type Translator, or to modify an existing Type Translator. If you do not specify an

index number in the <Data> parameter you supply to TypeTranslatorSet, the
function will create a new Type Translator using the first available index number.
If you specify an index number that is already being used, the function will

overwrite the configuration of the Type Translator using that index number with
the settings defined in the <Data> parameter.

<UCPTlastUpdate>

A timestamp indicating the last time the configuration of the Type Translator was
updated. This timestamp uses the following format:
YYYY-MM-DDTHH:MM:SSZ
The first segment of the time stamp (YYYY-MM-DD) represents the date the
configuration of the Type Translator was last updated. The second segment

(THH:MM:SS) represents the time of day the configuration of the Type Translator
was last updated, in UTC (Coordinated Universal Time).
UTC is the current term for what was commonly referred to as Greenwich

Meridian Time (GMT). Zero (0) hours UTC is midnight in Greenwich England,
which lies on the zero longitudinal meridian. Universal time is based on a 24 hour

clock, therefore, an afternoon hour such as 4 pm UTC would expressed as 16:00

UTC. The Z appended to the timestamp indicates that it is in UTC.

<UCPTdescription>

A user-defined description of the Type Translator. This can be a maximum of 228
characters.

<UCPTfbName>

The functional block name assigned to the Type Translator in L

ON

M

AKER

. You can

write to this property, but each time you use the

i.

LON 100 Configuration

Software to view the Type Translator, it will be reset to match the functional block

name defined in L

ON

M

AKER

.

<UCPTTranslatorRule>

The name of the Type Translator Rule that this Type Translator will use. This

determines the network variable type of the data points the Type Translator will
take as input, and the network variable type that these data points will be

translated to. It also determines the value to be assigned to the output data
point(s) after the translation.
The input and output data points you select for a Type Translator must use the

network variable types specified by the Type Translator Rule.

The sections immediately following this table describe the Type Translator Rules

included with the

i.

LON 100 software, the identifiers you can use to reference

them, and the input and output data point types you can use with them. You can
also use the SOAP interface to create your own Type Translator Rules. For more

information on this, see Chapter 13, Type Translator Rules.

If no translator rule is specified, then the Type Translator will convert the input

data point specified for the Type Translator to the format type of the output data

point specified for the Type Translator (e.g. scalar to scalar translation with no
offset and no constant, or enumeration to enumeration). In this case, the value of

the output data point will be updated with the value of the input data point each

time a translation is made.

i.

LON 100 Internet Server Program

12-6

mer’s Reference

Advertising