TOIP Pty TBS12 User manual

TBS12 Console
Version 1.05
February 2020
Copyright TOIP Pty Ltd

Table of Contents
1. Introduction................................................................................................4
2. oftware installation...................................................................................5
3. Hardware setup.........................................................................................6
3.1. Connect COM Port............................................................................6
3.1.1. TB 12H (T shaped PCB for Otto MP)....................................6
3.1.2. TB 12 .....................................................................................7
3.1.3. TB 12B.....................................................................................7
3.1.4. TB 12 PC-F ............................................................................8
3.2. Install Batteries..................................................................................8
3.2.1. TB 12B.....................................................................................8
3.2.2. TB 12 .....................................................................................9
3.2.3. TB 12H.....................................................................................9
3.2.4. TB 12 PC-F ............................................................................9
3.3. ensor Connection..........................................................................10
3.3.1. TB 12H...................................................................................10
3.3.2. TB 12B and TB 12 ..............................................................10
3.3.3. TB 12PC-F ...........................................................................10
4. Connecting to the TB 12.........................................................................12
4.1. Operation Mode...............................................................................13
5. TB 12 Configuration equence..............................................................15
5.1. Board Information............................................................................16
5.2. Time ettings...................................................................................17
5.3. chedule ettings............................................................................17
5.4. LoRa Module ettings.....................................................................18
5.4.1. LoRa RF..................................................................................18
5.5. ensor Configuration.......................................................................19
5.5.1. TB 12 - DI Commands.........................................................19
5.5.2. TB 12PC Pulse Inputs............................................................20
5.5.3. TB 12F Float witch Inputs.................................................21
5.6. ave Config for This Device............................................................23
5.7. Writing a Configuration to the TB 12..............................................23
5.8. Using the Direct Command Mode...................................................24
5.8.1. LoRa WAN Commands...........................................................24
5.8.2. DI-12 ensor Testing...........................................................26

5.9. Checking Firmware Revision...........................................................26
1.1. tarting the Unit Logging.................................................................28
6. Other Functions.......................................................................................29
6.1. View Options....................................................................................29
6.1.1. Clearing the Log......................................................................29
6.1.2. Displaying the Time/Date of events.........................................29
6.1.3. Displaying Log Events.............................................................29
6.2. Reading ettings from TB 12.........................................................29
6.2.1. Displaying the Battery Voltage................................................29
6.2.2. Viewing the Device ID.............................................................30
6.2.3. Viewing the Firmware Version.................................................30
6.2.4. Reading the Date-Time...........................................................30
6.2.5. Reading the LoRa ettings.....................................................30
6.2.6. Reading the ensor ettings..................................................30
6.2.7. Reading the chedule ettings...............................................30
7. TB 12 Data format..................................................................................31
7.1. Battery data format..........................................................................31
7.2. ensor data format..........................................................................31
7.2.1. TB 12 , TB 12B, TB 12 M.................................................31
7.2.2. TB 12PC-F Pulse Count Mode............................................32
7.2.3. TB 12PC-F Flow witch Mode............................................33
8. Backend etup........................................................................................34
8.1. Configuration Requirements............................................................36
9. TB 12 Console Log Files........................................................................38
10. TB 12 Firmware Upgrade.....................................................................39
10.1. Equipment Required......................................................................39
10.2. Preparation....................................................................................40
10.2.1. TB 12B, TB 12 , TB 12PC................................................40
10.2.2. TB 12PC/F .........................................................................41
10.3. Firmware Update...........................................................................41
11. Rising HF Modem Firmware Upgrade...................................................43
11.1. Preparation....................................................................................43
11.1.1. TB 12B & TB 12 ................................................................44
11.1.2. TB 12PC/F .........................................................................44
11.2. Upgrade Process...........................................................................45

1. Introduction
The DI12-LoRa Console is used to program the various versions of the
TB 12, DI-12 to LoRaWAN Bridge which are manufactured by Tekbox.
These include:
TB 12H Head for Otto oil Moisture Probe (Otto-LO)
TB 12B Enclosure mounted unit with dry cell batteries
TB 12 Enclosure mounted solar powered unit with
rechargeable battery
TB 12PC dual input pulse counter
TB 12F dual input flow switch (alarm)
TB 12T LoRa WAN Temperature Tracker
The TB 12 must be connected to a computer via a U B to FTDI adaptor.
Once connected the Console can be used to set all the board’s operational
parameters (time settings, DI-12 commands, LoRaWan settings) and
send commands to DI-12 sensors or the LoRaWAN module on the board
and to display the received responses.
This manual is written around version 1.04 of the TB 12 firmware and
Console program.

2. Software installation
To avoid issues with permissions, copy the Console application files to the
“AppData/Local/Programs” directory for the current user:
C:/<user name>/AppData/Local/Programs/TB 12
After creating the folder and copying the files, make a new desktop
shortcut, linked to the file “ConsoleApplication.exe”.
The TB 12 Console is written in the C# (C harp) programming language
and utilises the Microsoft “.NET Framework 4”. This is supplied with the
package (Newtonsoft.json.dll).
The application consists of 4 files plus an optional default file. During
operation, it will automatically create a “Logs” directory to store logging
information and errors.
Configuration files should be stored in the JsonFile directory.

3. Hardware setup
To ensure that the TB 12 connects to the Console without you having to
wait a full log cycle, connect the COM port prior to fitting the battery.
3.1. Connect COM Port
To keep the TB 12 design simple and to minimise power consumption, the
serial interface on the unit utilises “TTL” signal levels. A level conversion
circuit is thus needed to translate these signals to the U B format used on
a PC. These may be called a U B to FTDI converter or U B to TTL
converter.
All TB 12 variants provide a 3 pin J T socket for the communications /
programming port.
Please ensure that your TB 12 unit has been supplied with the correct
adaptor. If you are not sure, contact TOIP or your distributor. Most U B to
FTDI adaptors utilise the FTDI driver which can be downloaded from:
http://www.ftdichip.com/Drivers/VCP.htm
3.1.1. TBS12H (T shaped PCB for tto SMP)
Current TB 12 M boards have a J T socket fitted. If you have an old
board with the 3 pin header, you will need an adaptor cable.
If you hold the PCB so that the pins on the header are facing you, the pin
on the right is the ground pin.
The 3 pin header is not polarised: When you connect the plug from the
U B Adaptor make sure it is lined up so the black mark is on the side with
the dot on the PCB.

3.1.2. TBS12S
To open the TB 12 , turn the unit upside down and remove the 6 screws
holding the cover to the base. lowly turn the unit back over and collect the
screws as they fall out.
Now remove the cover
the cover is connected to the TB 12 PCB
via the solar panel cable
to remove the cover completely, unplug the 2
pin header (CON2)
The TB 12 PCB is fitted with a 3 pin J T header
which is labelled CON3. If the unit is held with the
antenna on top, the connector is 2/3 the way down
the PCB on the right side.
The J T plug is polarised so it will only go in one way. Plug the header from
your adaptor cable in to this socket and open the Console.
3.1.3. TBS12B
To access the programming port, undo the 4 Philips head screws holding
the lid in place, then lift the cover off.
The TB 12 PCB is fitted with a 3 pin J T header which is labelled CON3.
If the unit is held with the antenna on top, the connector is just below the
bottom left corner of the battery holder.

The J T plug is polarised so it will only go in one way. Plug the header from
your adaptor cable in to this socket and open the Console.
3.1.4. TBS12 PC-FS
The TB 12PC/F is fitted with a 3 pin J T header which is labelled CON 4.
This connector is located on the lower left of the PCB.
3.2. Install Batteries
3.2.1. TBS12B
The TB 12B is powered by a set of 2 off 1.5Volt alkaline D cells. Please
ensure you use high quality cells (Energizer, Duracell) in order to obtain
maximum battery life.
When inserting the cells into the holder, take care to align them according
to the polarities shown on the holder.

3.2.2. TBS12S
The TB 12 battery is a type 18650 rechargeable Lithium Ion cell with a
nominal voltage of 3.7V. It sits in a holder in the centre of the PCB.
To make it easier to remove the battery, a Puller can be made up using a
piece of ribbon: cut an 80mm length of 8 to 12mm wide ribbon. Fold in half
and glue the last 20mm of each end together with superglue. Once the glue
is dry, you can sleeve the ribbon over the battery. The end of the ribbon can
then be used to lift the battery out of the holder.
3.2.3. TBS12H
The battery for the TB 12H is fitted in to the slot cut into the PCB and
secured with a zip tie. Plug the battery cable in to the matching socket on
the PCB.
3.2.4. TBS12 PC-FS
The TB 12PC/F may be powered using the on board batteries or an
external supply
if using the on board batteries, load 2 off Alkaline AA cells in to the
holder
if using an external supply (3.6V lithium cell or regulated 3.3V DC
power supply) connect the supply to CON 6 on the top left of the
PCB.
CAUTION: The Battery plug on the TB 12 M head for the Otto soil probe
is wired reverse to that on the TB 12PC-F . Please check the wiring
before using any pre-wired batteries with these devices.

3.3. Sensor Connection
With the exception of the TB 12H, the sensors connect via an M14 socket.
3.3.1. TBS12H
The TB 12H (T-Head) connects to the Otto soil moisture sensors via 5 Pin
J T connectors. For testing you should ensure that at least one sensor (on
address 0) is connected.
3.3.2. TBS12B and TBS12S
The TB 12B and TB 12 connect to the DI-12 sensors via a 7 pin
waterproof M14 connector. The socket, which is on the bottom of the
enclosure, is wired as follows:
This image is taken looking at the socket on the TB 12 body face on. If you
plug the 7 pin plug into the socket and stand the unit on its head so the
connector is on top, the orientation will be the same when you look down
on the back of the plug from above (after taking off the backshell)
You can test connectivity to and functionality of, the sensors using the
Direct Command mode (Refer section 5.8.2 ).
3.3.3. TBS12PC-FS
The TB 12 PC-F is used with switches which provide a closed contact
when they are active. These may be reed switches fitted to a rain gauge or
flow meter, or switches fitted to an alarm contact or float switch. In all
cases, the switch must make two contacts available: a Common (which is
wired to the ground terminal on the inputs) and the witch input. When the