Sensus DIAVASO User manual

© SENSUS 2016
DIAVASO Datalogger
User Guide

1
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
MS 7000 | DIAVASO Datalogger User Manual
DIAVASO Datalogger User’s Guide
Revision
Date
Notes
Responsible
Revision 0.1
November 22, 2015
Draft versions
Michael André
Revision 1.0
April 30,2016
Final version
Ján Janeka
Revision 1.1
December 19, 2017
DL app 0.5.0
Ján Janeka
Revision 1.2
February 2, 2018
DL ver. 0.5.1
Ján Janeka
Revision 1.3
May 14, 2018
DL ver. 0.5.4
Lukáš Skala

[email protected]
2
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
Contents
CONTENTS .......................................................................................................................................... 2
1PURPOSE .................................................................................................................................... 4
2OVERVIEW.................................................................................................................................. 4
3REQUIREMENTS ........................................................................................................................... 4
4USER INTERFACE .......................................................................................................................... 4
4.1 HEADER.............................................................................................................................. 4
4.2 NAVIGATION DRAWER........................................................................................................... 5
4.3 DEVICE LIST ......................................................................................................................... 6
5SETTINGS.................................................................................................................................... 6
5.1 SIRT CONNECTION SETTINGS.................................................................................................. 6
5.1.1 CONNECTION SETTINGS ................................................................................................. 7
5.1.2 SIRT SETTINGS............................................................................................................. 7
5.1.3 SIRT STATUS ............................................................................................................... 7
5.2 LOGGING SETTINGS............................................................................................................... 8
5.3 APPLICATION LANGUAGE ....................................................................................................... 8
5.4 ENCRYPTION KEY .................................................................................................................. 8
5.5 ENCRYPTION KEYS IMPORT ..................................................................................................... 8
5.6 LICENSE .............................................................................................................................. 8
5.7 IMPORT AND EXPORT SETTINGS............................................................................................... 8
5.7.1 FTP SETTINGS............................................................................................................ 10
5.7.2 DEVICE .........................................................................ERROR!BOOKMARK NOT DEFINED.
6ABOUT ..................................................................................................................................... 12
7COLLECTING LOGS ...................................................................................................................... 13
7.1 DEVICES............................................................................................................................ 13
7.1.1 DEVICE COUNTER ....................................................................................................... 14
7.1.2 ADD DEVICE .............................................................................................................. 14
ADD DEVICE .................................................................................................................................. 14
ADD NEARBY METERS...................................................................................................................... 15
IMPORT METERS FROM FILE.............................................................................................................. 16
7.1.3 DEVICE LIST............................................................................................................... 16
DEVICE STATUSES ........................................................................................................................... 16
7.2 GATHERING LOG DATA ........................................................................................................ 18
7.2.1 SEND RESULTS ........................................................................................................... 21
7.2.2 DOWNLOADED LOGS................................................................................................... 22
7.3 TEMPLATE MANAGEMENT.................................................................................................... 22
7.3.1 SAVE TEMPLATE ......................................................................................................... 23
7.3.2 LOAD TEMPLATE ........................................................................................................ 23
7.3.3 DELETE TEMPLATES .................................................................................................... 24
7.4 DATA VISUALIZATION .......................................................................................................... 24
7.4.1 TABLE ...................................................................................................................... 24
7.4.2 GRAPH ..................................................................................................................... 25
8LICENSING &REGISTRATION ........................................................................................................ 25
8.1 SENDING REQUEST FOR A LICENSE KEY.................................................................................... 26

3
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017

[email protected]
4
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
1Purpose
The aim of this document is to describe the usage of DIAVASO Data Logger application.
2Overview
DIAVASO Data Logger is an Android application that allows to collect datalogger and FDR data
from SensusRF endpoints.
This application is a part of the DIAVASO solution and can be installed and launched through
the DIAVASO dashboard.
3Requirements
•Android device with:
•Android version 4.2 (Jelly Bean) and higher
•Screen size at least 4 inches
•Bluetooth support
•Network access
•SIRT
•accessible FTP server (optional)
4User interface
The user interface consists of three parts: header, device list and navigation drawer. User can see
header and device list in the Figure 1 and navigation drawer in the Figure 2.
4.1 Header
Header consists of six buttons (from left to right): navigation drawer, multiselect, delete devices,
refresh devices, send files and basic filter. Navigation drawer opens screen as can be seen in the
Figure 2. Further details about navigation drawer are

5
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
FIGURE 1:DEVICES SCREEN
explained in Section 4.2. Multiselect allows to select multiple devices at once and proceed to
obtain logs from all of them. Delete devices deletes all listed devices with an option to undo this
after deletion. Refresh device tries connect to all listed devices and gets current data from them.
Send files sends files to ftp server as configured in settings 5.7.1. Sending files to ftp server is
explained in detail in Section 7.2.1. Basic filter is used to find specific meter through text or status.
4.2 Navigation drawer
Navigation drawer, shown in Figure 2, serves as the place from which other screens of the
application can be accessed. The navigation drawer can be opened either by touching the icon on
the left side of the application’s header or by sliding your finger from the left edge of the device’s
screen.
FIGURE 2: NAVIGATION DRAWER SCR EEN

[email protected]
6
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
The top section of the navigation drawer contains an option to access the Device list screen
described in section 7.1.
First item in the bottom section is the SIRT connection button that allows to quickly connect to
the SIRT or to go to the SIRT settings. Below are Settings and About options described in sections 5
and 6 respectively.
4.3 Device list
Device list serves for selecting accessible devices to get data from as can be seen in section 7.
5Settings
The configuration screen shown at Figure 3 is divided into multiple sections that group similar
types of settings together. Each section is described separately below.
FIGURE 3: SETTINGS
5.1 SIRT connection settings
Bluetooth connection to the SIRT and SIRT itself can be configured on the screen shown on Figure
4.

7
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
FIGURE 4: CONNECTION SETTINGS
5.1.1 Connection settings
•Bluetooth settings –displays the Bluetooth status of the device and provides direct access to
the system Bluetooth settings
•SIRT to use –allows to select a SIRT to connect to. For SIRT to appear on the list, it must be a
paired device on the system (device pairing is done in system Bluetooth settings)
•SIRT connection state –switch that connects to the selected SIRT, connecting to a SIRT can
take a while and after a successful connection the switch is switched to ON state.
5.1.2 SIRT settings
•Expected BUP interval –time that represents how often meters send BUP telegrams
•Auto switch-off time-out –the time after which SIRT turns off automatically
•Use external antenna –if checked, then the SIRT is activated with the setting to use external
antenna
5.1.3 SIRT status
This section shows information about SIRT when SIRT is connected. The status information
consists of the hardware version, firmware version, frequency and remaining battery capacity.

[email protected]
8
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
5.2 Logging settings
Allows to enable or disable logging of communication with SIRT and upload the logs to FTP server.
5.3 Application language
Allows to change the language used by the application and shows current state. The user can use
either System default setting or select one of the provided languages. The latter uses the selected
language regardless of the system language. The former uses the system language if there is a
translation provided for that language and defaults to English if it is not.
5.4 Encryption key
Allows to change the SRF key used for telegram decryption. The application uses the default
encryption key by default and user can always go back to using the default key after changing it.
This option is not available when trial version expires.
5.5 Encryption keys import
Allows to import Encryption keys for individual SRF addresses. XML, JSON and CSV formats are
supported. XML format may contain SRF keys encrypted with AES cypher, in such a case an
encryption key must be provided. Imported keys have priority against encryption key set in
Encryption key option as described in 5.4. Remote file name input expects name of existing file on
FTP server. See 5.7.1
5.6 License
The section provides user information about the license that is being used by the application and
also the means to request the license key from Sensus and apply the received key.
Device serial ID unique device ID used for license generation
Request license opens a pre-filled email that can be sent to Sensus in order to receive a license
key
License key here can be inserted the received license key from Sensus
5.7 Import and export settings
5.7.1 Import and export

9
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
Import and export options can be configured on the screen shown on Figure 1.
Export method - allows to choose FTP, Email or Local storage export methods.
Figure 6: Import and Export settings
oImport method - allows to choose FTP or Local storage import methods. User can pick file from
local storage of device when Local storage is chosen.
oLocal storage - Path to the directory that is used as main root during import or export.
oFTP Directory - directory on the FTP server where the files will be uploaded. If not set, the FTP root
directory for given user is used. The directory is created if it does not exist.
oEmail address - Recipient Email address
oDate and time format - The format of the date and/or time for exports
5.7.1.1 Custom date and time format
In this dialog, the user can configure the format of date and time. This date and time format is used in the
date time fields of exported files. Initially the format is set to android system date time format, but the
users can change the date and/or time format based on their needs. The user can select format from some
predefined formats or he can define his own format.

[email protected]
10
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
FIGURE 5: CUSTOM DATE AND TIME SETTINGS
Symbols
Meaning
Examples
y, yyyy
Year
18; 2018
M, MM, MMM, MMMM
Month
2, 02, Feb, February
d, dd
Day of month
9, 09
c
Day of week
Fri
h, hh
Hour (0-12)
1, 01
H, HH
Hour (0 –23)
4, 13
m, mm
Minute of hour
8,08
s, ss
Second of minute
5, 54
a
am or pm
AM
, / . :_
delimiters
, / . :
5.7.2 FTP settings
FTP server connection can be configured on the screen shown in the Figure 6. If the
communication with FTP server is not successful then error dialog containing according message is
shown to the user.
FTP protocol –allows to choose Unsecured FTP connection option or one of the secure options
FTPS or SFTP.
•Server address –IP address or network name of the FTP server to use
•Port –allows to specify the port the FTP connection uses. This value is reset to default value
for each protocol when FTP protocol option is changed.

11
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
•Login –user name used for connection with the FTP server. Leave it blank for an anonymous
connection.
•Password –password to be used when the Login option is set.
FIGURE 7: CONNECTION SETTINGS
•Directory –directory on the FTP server where the files with log data will be uploaded. If not
set, the FTP root directory for given user is used. The directory is created if it does not exist.
5.7.3 SMTP
SMTP conguration for export can be configured on the screen shown on Figure 8.

[email protected]
12
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
Figure 8: SMTP settings
oOutbound email host - host-name or IP address of the SMTP server to use for sending emails
oPort - the port the SMTP server uses
oEmail security - security option to use (None, SSL, STARTTLS)
oEmail address -sender email address; the SMTP server must allow sending email from this user
oPassword - password belonging to the sender email address; needed only if the SMTP server
requires it
oTest email recipient - Test the correct configuration of SMTP by sending test email to this email
address by using the Save and test button in this dialog
6About
The About screen contains information about Sensus and also information about the open-source
licenses used in the application. It can be seen in Figure 9. The information in this screen is
interactive. Clicking on a line opens an application that can handle the desired action (e.g. email
client is opened after tapping on email).

13
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
FIGURE 9: ABOUT SCREEN
7Collecting logs
The following chapters explain how the endpoints may be selected for the log collection and how
to configure which data will be collected.
7.1 Devices
Endpoints , their logs are going to be collected must be added to a Device list.
User may add devices using the floating Action (+) button in the bottom right corner of the
screen. It is shown on Figure 10.
FIGURE 10:EMPTY DEVICE LIST WITH ADD DEVICE OPTIONS

[email protected]
14
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
7.1.1 Device counter
Device list screen contains number of devices in header part as shown in Figure 10.
7.1.2 Add device
When the Action button is clicked a menu with two options opens:
Restore deleted devices
Add meter
Add nearby meters
Import meters from file
FIGURE 2EMPTY DEVICE LIST WITH ADD DEVICE OPTIONS
Restore deleted meters
When the user deletes a meter or meters, he or she can add them back to the list by selecting this
option. The user can delete multiple meters and this option will restore them all. The deleted
meters are kept until the user adds another meter to the list (using add methods below) or the
application is restarted.

15
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
Add device
When this option is selected an input dialog to insert a meter address (shown on Figure 11) is
opened. The radio address is expected to be in the decimal format with or without dashes. A
warning is displayed if the inserted address has incorrect format. The meter is added to the Device
list when the Add meter button is pushed.
FIGURE 11:ADD METER DIALOG
Add nearby meters
This option allows to add one or more meters that are in range without writing their addresses.
When the option is selected a new dialog is opened. Inside there are all reachable meters shown
as can be seen on Figure 12.
FIGURE 12: ADD NEARBY DEVICES DIALOG
The user may then select a single meter by clicking on it or all currently displayed meters using
the Add all button at right hand side of the dialog header. The selected meters disappear from this
list. The user can also remove unwanted meters from this list by swiping them out of the list. All
these operations have an undo option and work similarly to the way described in section 7.1.3.
This option requires the SIRT to be already connected.

[email protected]
16
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
Import meters from file
This allows to add all meters from a csv file to device list. The format of the file must consist of one
column with meter addresses. When option is selected new dialog window is opened and user has
to insert the name of the file from FTP (Figure 13). It requires configured ftp connection. It does
not import meters that already exist in the list. This option does not require the SIRT to be
connected.
FIGURE 13: IMPORT METERS DIALOG
7.1.3 Device list
When a device is added to the device list it is added with the Not read status. If the SIRT is
connected the application starts requesting SEMI telegrams. When a SEMI telegram related to the
endpoint is captured the status of the device is changed to one of the Read statuses listed below.
This allows the user to recognize which devices are in the range.
Device statuses
not read
read without alarm
read with alarm
wrong key
log collection in progress
log collection is done
A progress message is also shown when an operation is in progress for the device as shown in
the Figure 14. Remaining BUP telegram count is also shown.

17
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
FIGURE 14: DEVICE LIST –READING IN PROGRESS
Apart from the status the device type, signal strength and time of reading is shown for each
device. Readout value and alarms are displayed if the application was able to decrypt the SEMI
telegram. Otherwise a Wrong key label is displayed. Readout value is interpreted to match meter
unit detected from SEMI.
The user can also remove a device from the list by swiping it out (dragging it out) from the list
to left or right. After that an Undo button is shown at the bottom of the screen as displayed on
Figure 15. The previously deleted item is restored when the Undo button is pushed. The button
automatically dismisses after 10 seconds or when another item is deleted.

[email protected]
18
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
FIGURE 15: DEVICE LIST –ALL DEVICES READ,UNDO BUTTON FOR PREVIOUSLY DELETED ITEM SHOWN,ANOTHER METER IS GOING TO BE
DELETED USING SWIPE TO RIGHT SIDE
The list also contains a Refresh button. The button is placed on the right side of the header.
When pushed all the devices are refreshed (i.e. information from more recent telegram is shown)
except for the ones that are being requested for logs at the moment. This is useful to recognize
which devices are still in range after the user moved to a different location. The SEMI telegram is
used only if it is newer than 5 × expected BUP interval that is configured in Settings.
The list remembers all the added devices permanently unless they are deleted by user. This
allows to prepare the devices’ list at office and use it in field later.
7.2 Gathering log data
When a meter item is touched in the list the Log screen is shown (see Figure 16). If a tablet in the
landscape mode is used both the Device list and Log screen are displayed side by side. Otherwise
the Log screen is shown on the whole screen.

19
MS 7000 | DIAVASO Datalogger User Manual | 05/05/2017
FIGURE 16: LOG SCREEN
The screen is divided into two sections, one for Data logger and another for Fixed date
reading. Information about current log related status of the meter and log controls is shown in
both sections.
The Data logger view shows the current Logging interval and Time of last reset time values.
The Fixed date reading view shows the current Day of month and Time of last reset time
values.
In both sections, the user can set the time interval for which the log data will be downloaded
using the From and Until date pickers. All the available log data will be gathered by default –the
From date is set to last reset time and Until date is set to current date. Below, all the available log
counters that are configured for the selected meter are shown. By default all the counters are
switched on and related data will be downloaded.
The log download starts when the Apply button on the right side of the header is pushed. The
application communicates with the meter and collects the desired data in the background. The
download process may take a while and the user is informed about the progress as can be seen on
the Figure 17. The status section shows which log data is being gathered and the user can see
what counters were already processed and which ones is being processed right now.