TOIP Pty TBSL1 User manual

User Manual
TBSL1 and Console
Copyright TOIP Pty Ltd
Version 04.00.01.30
January 2021
1

Table of Contents
1. Introduction....................................................................................................4
1.1. Hard are setup......................................................................................5
1.2. TBSL1 Data Path....................................................................................8
2. Soft are Installation....................................................................................10
2.1. Ne Installation....................................................................................10
2.2. Upgrading from Earlier Version.............................................................11
3. Using the TBSL1 GUI..................................................................................12
3.1. Connecting to the TBSL1......................................................................12
3.2. Create and Save a Configuration File for the Device...........................14
3.3. Changing the Configuration Defaults...................................................14
3.4. Changing Operating Mode...................................................................15
3.5. Configuring the TBSL1.........................................................................17
3.5.1. LoRaWAN Settings.......................................................................17
3.5.2. Packet Ackno ledgement Settings..............................................18
3.5.3. LoRa Frequency Settings.............................................................19
3.6. Time Settings........................................................................................21
3.7. Schedule Settings.................................................................................22
3.8. SDI -12 Sensor Settings:......................................................................24
3.9. Adding Pulse Sensors..........................................................................26
3.10. Adding Analogue Sensors..................................................................27
3.11. Setting up Alarms................................................................................31
3.11.1. Setting the Board ID...................................................................33
3.12. Writing a Configuration to the TBSL1.................................................33
3.13. 4G RTU Configuration – Cellular Settings..........................................35
3.13.1. Checking the MQTT Java Midlet................................................36
3.13.2. MQTT Configuration...................................................................37
3.13.3. Testing 4G Connectivity..............................................................40
3.13.4. Monitoring MQTT Server Traffic.................................................42
4. Sensor and LoRaWAN Testing....................................................................44
4.1. SDI-12 Sensor Testing..........................................................................44
4.2. LoRaWAN Testing.................................................................................45
4.2.1. LoRa WAN Testing Via Console...................................................45
4.2.2. LoRa WAN Testing from Console Menu.......................................48
4.2.2.1 Check RSSI...........................................................................48
4.2.2.2 Check Transmission..............................................................48
4.3. Starting the TBSL1 Logging.................................................................49
4.3.1. Starting the TBSL1 immediately...................................................49
2

4.3.2. Using the Hibernate Function.......................................................49
5. TBSL1 Packet Format..................................................................................50
5.1. Common Data Messages.....................................................................50
5.2. Data or Parameter Messages...............................................................52
5.2.1. Pulse Data Messages...................................................................52
5.2.2. Analogue Sensor Messages.........................................................54
5.2.3. SDI-12 Sensor Messages............................................................55
6. Firm are and Console Update....................................................................58
6.1. To Check the Current Version...............................................................58
6.1.1. Obtaining the Console GUI Version.............................................58
6.1.2. Obtaining RTU Firm are Version.................................................58
6.2. Upgrading the Console GUI.................................................................58
6.3. Upgrading the TBSL1 Firm are...........................................................58
6.3.1. Upgrading Via Console GUI.........................................................59
6.3.2. Upgrading Via ST-Link..................................................................62
6.4. Using the Debug Firm are...................................................................62
6.5. 4G Modem Firm are Upgrade.............................................................63
7. Diagnostics and Troubleshooting................................................................67
7.1. TBSL1 GUI Log Files............................................................................67
7.2. Diagnostic Mode – Error Log................................................................67
7.3. Clearing the RTU Memory....................................................................68
7.4. Do nloading Readings from Memory..................................................68
7.5. 4G Modem Testing................................................................................69
7.5.1. Testing from Monitoring Menu......................................................69
7.5.2. Testing from the Command Line..................................................70
7.5.2.1 Signal Strength Testing.........................................................70
7.5.2.2 APN Connection Testing........................................................71
7.5.2.3 Other Modem Commands.....................................................74
8. Backend Setup.............................................................................................75
8.1. Configuration Requirements.................................................................76
8.2. Passing Data to the Tekbox LoRa WAN Broker...................................79
8.3. Accessing the Broker............................................................................79
3

1. Introduction
The TBSL1 from Tekbox is a high capacity data logger ith integrated
telemetry. It is fitted ith an SDI-12 input channel as ell as an analogue and
pulse input. The TBSL1 may be fitted ith a communications board for either
LoRa WAN (TBSL1-LO) or mobile phone (cellular) communications (TBSL1-
4G).
The TBSL1 GUI is used to program the TBSL1 via a serial connection. It can
be used to set all the board’s operational parameters (time settings, SDI-12
commands, LoRaWan settings) and send commands to SDI-12 sensors or the
LoRaWAN module on the board and to display the received responses.
4

1.1. Hardware setup
The picture belo sho s the designations of the various connectors on the
TBSL1.
The TBSL1 connects to a PC using a Type B USB connection. In addition to
the connector on the case, there is a second connector on the PCB.
Using a Number 1 Philips Scre driver, undo the 4 scre s holding the cover to
the TBSL1 case and remove the cover.
Before fitting the battery, make sure that the antenna is scre ed on to the TNC
connector on top of the case and that the UFL cable from the antenna is fitted
to the upper most socket on the LoRaWAN PCB.
For the standard TBSL1 the battery is a 3.6V Lithium-Ion cell ith internal
thermistor and 3 pin JST connector. The battery is secured to a plastic holder
hich sits on 4 standoffs installed on top of the PCB. Connect the battery lead
to the matching socket on the upper left of the TBSL1 PCB.
5

If your TBSL1 is going to be po ered via a solar cell, ire the solar panel up
according to the diagram belo (Port 3). If the solar panel has been supplied
ith your unit it ill be pre- ired ith the required connector. In most
applications a 6V 2W solar panel ill operate the TBSL1 although a 5W unit
can be used if you have concerns about the po er budget or have sensors
hich dra high current or if you are using the cellular version ith 15 minute
logging/transfer.
CAUTION: Do not use the TBSL1 ith 12V solar panels. The maximum
permissible open circuit panel voltage is 7.2V. Using a panel ith a higher
voltage rating ill damage the TBSL1.
The image belo sho s the input connectors hen vie ed from the bottom or
the TBSL1. The orientation is the same as this picture hen looking do n on
the Plugs i.e. if you put the 7 pin plug in to the connector, do up the lock nut
and then remove the back-shell from the connector, hen you look do n on
the solder buckets they ill be in the same order.
6

The t o input connectors are ired in parallel. This allo s you to easily
connect t o sensors. Should you need to connect more than t o cables, you
can add a TBS04 Junction Box.
The back of the TBSL1 case is fitted ith a mounting bracket. This can be
used to secure the unit to a 40 to 50mm post using a stainless steel hose
clamp.
The colour code for the cables supplied ith the TBSL1 is as follo s:
Pin Solar
(5 pin)
Sensor
(7 pin)
1 Blue – SP + Analogue 1
2 Bro n – SP - Bro n - GND
3 Link to Pin 4 Analogue 2
4 Link to Pin 3 Pulse
5 - Green/Yello - SDI-12
6 - Blue - PWR
7 -
If you are using either of both of the Analogue inputs or the Pulse Input, you
may need to use a 6 or 7 core cable. Or you can re- ire one socket to carry
the analogue/pulse inputs and the other the SDI-12.
When using the TBSL1 ith a solar panel, mount the solar panel facing North
(south in the Northern Hemisphere) and the fit TBSL1 on the opposite side of
the pole, facing south. This ay the solar panel helps shade the TBSL1 from
the sun. If you are fitting the TBSL1 ith an external antenna, you can mount
the antenna as high as possible on the post and the TBSL1 unit directly belo
the solar panel.
7

Radio range is governed by a number of factors including terrain. Radio range
can be maximised by:
raising the height of the Gate ay antenna
raising the height of the TBSL1 antenna.
Often a compromise must be sought bet een raising the antenna height for
best coverage versus keeping it lo to allo machinery to pass over the site. If
regular machinery movement is an issue, consider using a tilt do n base pole.
The follo ing factors ill cause a decrease in range:
hills bet een the TBSL1 and the Gate ay
tree canopy bet een the TBSL1 and the Gate ay, particularly trees
ith fine needle leaves hich act can absorb signal hen they are et
metal objects placed close to the TBSL1 antenna.
1.2. TBSL1 Data Path
The path of data from a LoRa WAN Node to the Presentation soft are (the
default is to use Sensori) is sho n in the image belo .
The readings from the sensors connected to the TBSL1 are saved in the unit’s
memory. At the programmed Send Interval (e.g. 15 min) the readings are
8

transmitted via LoRa WAN to a radio base station – hich in a LoRa WAN
environment is called a Gate ay.
The Gate ay sends all the received messages (or packets) to a LoRa WAN
Server.
A LoRa WAN Server ill contain one or more “Applications” hich belong to
different users. Each Application ill in turn contain a number of “Devices”
(telemetry units or RTUs). Each Device is has a unique identifier.
When devices are created on the LoRa WAN Server, they are allocated a set
of encryption keys: one is used to signal that a device has a legitimate right to
use the net ork, the other is used to encrypt the data.
When the LoRa WAN Server receives a message, it checks to see if it
recognises the Devices unique identifier (its EUI). If not, it rejects the
message. If it does, it unencrypts the message and saves the contents in its
database.
Over time the LoRa WAN Server ill accumulate sets of readings for each
Device. These can then be collected by the programmes used to display and
interpret the readings
•the servers typically offer t o or more ays to access this data
•the first is using a proprietary URL based XML format
•the second is by using an open protocol called MQTT.
One of the complications of LoRa WAN is that the LoRa WAN Server does not
kno anything about the sending device and hence hat type of sensors(s)
are connected. So if you are orking ith devices hose configuration can
vary, you must manually unpick the contents of each data packet based on
information about the values it contains.
This can get very complex if large numbers of devices are in use or if the
configuration changes.
To deal ith this complexity, Tekbox offers an IoT Broker hich does this ork
for you.
The Broker is configured ith the details of each device including the LoRa
WAN server to hich the device belongs and the sensors attached to it. When
9

packets are received, the Broker then unpicks them (parses the packets). The
readings are then saved along ith any there relevant information, such as the
units, the type of sensor etc.
The biggest benefit of this approach is that it scales easily to hundreds or
thousands of devices. It also means that the presentation soft are can be
given other relevant information about each device: such as its type, its GPS
coordinates etc. Similarly it gets the “meta-data” for each sensor.
In the Cellular units, the data is sent to the Tekbox IoT Broker hich in turn
passes it to Sensori
2. So tware Installation
2.1. New Installation
The TBSL1 Console Installer ill install the program in the directory:
C:\Program Files (x86)\TekBox Digital Solutions Viet Nam\
TBSLnConfiguration
When prompted, select "Install for all users".
You can change the installation directory another location during the
installation. The installer ill create a Start Menu entry for the program.
If you have installed for all users, the configuration files ill be saved in the
directory:
C:/Users/Public/Public Documents/TBSL1 Configuration Tool/Json
The installer ill create a shortcut on the Desktop. To ensure that you can
create and edit configuration files, edit the Shortcut and set the properties to
“Run as administrator”.
The TBSL1 GUI program and TBSL1 Firm are must be maintained at the
same version
the GUI soft are checks the TBSL1 firm are version henever it
connects
if the versions do not match, an error ill display on the screen
10