User's Guide
Table Of Contents
- Remote Terminal Unit M717
- Table Of Contents
- Introduction
- Installation
- Register the RTU to the M2M Gateway
- The SDI Connector
- The MPI Connector
- The Micro USB Service Connector
- About the Data Acquisition Subsystem
- SDI-12 Sensors
- Create a New Template From an Existing One
- Create a New Template From Scratch
- Interface to a Davis Vantage Pro Console
- Interface to a Thies TDL14 or DL16 Data Logger
- Mechanical Installation
- Operation
- Configuration
- Commands
- General Commands
- help
- ver
- echo
- ps
- date
- log
- attr
- pin
- hwid
- connect
- xfer
- fwupdate
- reboot
- exit
- Data Acquisition Commands
- dacq
- dacq info
- dacq sample
- dacq retrieve
- dacq abort
- dacq date
- dacq interval
- dacq direct
- dacq t
- hist
- hist info
- hist stat
- hist map
- hist purge
- Data Acquisition Legacy Commands
- sdi t
- thi t
- thi direct
- Communication Commands
- net
- net get
- net up
- net down
- net session
- modem
- modem direct
- modem pwrdown
- modem pwrup
- modem reset
- modem mode
- File System Commands
- ls
- mkdir
- cd
- cp
- pwd
- rm
- cat
- Command Line Interface Error Messages
- Attributes
- Technical Specifications
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 sensor’s attributes have been entered, you need to define and add the sensor’s 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 different.
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 sensor’s value in the SDI-12 “Dx” response string; the index numbering
starts with 0.
10