User's Guide

Note: The attribute names, as well as all the parameters must be entered exactly as written; where no value is
given, the field should be left empty. However, you may enter default values for the sdiAddress and
sdiMethod (consult the sensor’s specifications).
After all the sensors attributes have been entered, you need to define and add the sensors tags.
Select the sensor and click the “New Tag” button.
Enter the name of the new sensor (e.g., Temperature”), then select the appropriate sensor template
from the drop-down.
Finally click the "OK" button.
As with the sensors, if you can’t find a template already defined for your tag, you must define one by
yourself. This is similar to the creation of a sensor template, except that the attributes are dierent.
Proceed as follows:
Log in to the M2M Gateway and in the left pane click and expand the Admin entry, then click the
Templates entry.
On the right pane, click the “New Template button.
Name the new template; use a name that can easily identify the new tag, e.g., Temperature.
Select from the Template Class tag” and click "OK". The new template will be generated, however it
will be empty.
Select the newly generated template and click the Attributes tab. You will now add several
attributes.
Click the “New button; in the dialog box that appears you must define the attribute. For a proper
operation of the RTU, a list with the minimum of attributes required and their parameters follows:
addUPItemplate, type: string, R/-, Size: 30, Value: addUPI_ANALOG_TAG_V1_0
EUID, type: int, flags: r/-, Size: , Value: <see note below>
iconName, type: string, flags: a/a, Size: 20, Value: <see note below>
maxValue, type: double, flags: r/-, Size: , Value: <see note below>
minValue, type: double, flags: r/-, Size: , Value: <see note below>
sdiIndex, type: int, flags: a/a,RTU=x, Size: , Value:
Note: The addUPItemplate is not required by the RTU, but it is used by certain application software as e.g.
“Instruments”. It must be entered exactly as shown. The EUID (Engineering Unit ID) is a conventional rule
that associates measurement units (e.g., meter, second, gram, etc.) to an ID (a number). The RTU doesn’t
need it, but it is helpful for application software, as well as for the M2M Gateway, to associate the proper
measurement unit to a tag. The iconName is not required by the RTU; it is a reference to an icon that will
be displayed by the M2M Gateway user interface. Both the proper EUID and the iconName can be found
clicking on the “Info” button on the main menu bar (see picture below). The maxValue and minValue are
not required by the RTU, but are used by the application software, for instance when setting the limits of
a graph. These values must reflect the maximum and minimum values that can be delivered by the
sensor.
Note: The sdiIndex is the position of the sensors value in the SDI-12 “Dx” response string; the index numbering
starts with 0.
10