background image

Once the connection to the TBS12 is established, you can create a 
configuration file for your device

to start with a default configuration, click on File / Load Default 
Settings
if you have an existing file you want to open or to use as the 
template for the new device, select 

File / Load and then 

choose the desired file
from the TBS12 Menu select 

Settings / Boards

the Board configuration screen will display
from the Select Boards list box, choose the TBS12 type you are 
working with e.g. TBS12H/B/S
you can the progress to setting up the various parameters.

5.1. Board Information

The Board Information area shows you the ID number allocated to the unit 
and the firmware version

Device ID: this is a hexadecimal number used to uniquely identify 
the device

this can be used to track the location and history of a PCB

the Device ID should be set when the device is new and then 
remain with the device even if it is moved from one location to 
another

FW Version: this shows the version of the firmware loaded in to the 
board. You can also fetch this from the menu using 

View / Get 

Firmware Version

the TBS12 firmware version must always match the Console 
firmware version.

Summary of Contents for TBS12

Page 1: ...TBS12 Console Version 1 05 February 2020 Copyright TOIP Pty Ltd...

Page 2: ...2B and TBS12S 10 3 3 3 TBS12PC FS 10 4 Connecting to the TBS12 12 4 1 Operation Mode 13 5 TBS12 Configuration Sequence 15 5 1 Board Information 16 5 2 Time Settings 17 5 3 Schedule Settings 17 5 4 LoR...

Page 3: ...6 2 6 Reading the Sensor Settings 30 6 2 7 Reading the Schedule Settings 30 7 TBS12 Data format 31 7 1 Battery data format 31 7 2 Sensor data format 31 7 2 1 TBS12S TBS12B TBS12SM 31 7 2 2 TBS12PC FS...

Page 4: ...hargeable battery TBS12PC dual input pulse counter TBS12FS dual input flow switch alarm TBS12T LoRa WAN Temperature Tracker The TBS12 must be connected to a computer via a USB to FTDI adaptor Once con...

Page 5: ...esktop shortcut linked to the file ConsoleApplication exe The TBS12 Console is written in the C C Sharp programming language and utilises the Microsoft NET Framework 4 This is supplied with the packag...

Page 6: ...for the communications programming port Please ensure that your TBS12 unit has been supplied with the correct adaptor If you are not sure contact TOIP or your distributor Most USB to FTDI adaptors ut...

Page 7: ...er 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 JST plug is polarised so it will only go in one way Plug the heade...

Page 8: ...ader 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 TBS12B is powered by a set of 2 off 1 5Volt alkaline D cells Please ensure yo...

Page 9: ...f the holder 3 2 3 TBS12H The battery for the TBS12H 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...

Page 10: ...y 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 af...

Page 11: ...S12PC pulse count module the switch closes for a brief period typically 20 mSec Whereas with the TBS12FS the switch may be closed for minutes or hours The sensors on the module connect via the two pin...

Page 12: ...unications show the current state i e COM Closed Click on the button to Open the communications port the label will change to COM Open from the menu select Settings COM Port when the Config Com menu d...

Page 13: ...ge to Connecting while the Console attempts to communicate with the TBS12 the label will change to Connected once successful Connection Sequence the two buttons manage the connection firstly to the US...

Page 14: ...y check to see if a USB TTL adaptor is plugged in to the COMMS port If so it will activate the port and check for commands The unit should thus respond within 20 or 30 seconds to a change back to Cons...

Page 15: ...he TBS12 depending on the settings of the board it may take a while for the board to wake If you don t want to wait select Com Open again to close the connection remove the battery and follow the proc...

Page 16: ...e g TBS12H B S you can the progress to setting up the various parameters 5 1 Board Information The Board Information area shows you the ID number allocated to the unit and the firmware version Device...

Page 17: ...nt Interval and Transmit Interval will be set to the same value Transmit Interval set this to how often you want the values to be sent Normally this is the same as the Measurement Interval e g 15 min...

Page 18: ...ge depending on whether you are using ABP Activation by personalisation or OTAA Over the air activation ABP uses NWKSKEY and APSKEY OTAA uses APPLICATIONEUI and APPLICATIONKEY Device Address Device EU...

Page 19: ...when sending the packets Slower data rates will provide longer range but tie up the network for longer The default should be to use a DR of 5 and you can the then try 4 and 3 if you want to get more...

Page 20: ...same format when you add the device in the Tekbox IoT Broker the TBS12 firmware reviews the commands which have been entered and uses the information to assign the Sensori ID and Sub Sensor ID sensor...

Page 21: ...her the sensor is a Rain Gauge or Flow meter Units per Pulse set the Units per Pulse to match the sensor e g 0 2mm per tip for a rain gauge 100 litres per pulse for a flow meter Starting Totaliser if...

Page 22: ...interval when the switch turns on a packet will be sent with the new switch state i e 1 the duration will be 0 when the switch turns off again the state will be 0 the duration will be set to the numb...

Page 23: ...you activate the Send Release Packet check box an additional packet will be sent when the switch opens again 5 6 Save Config for This Device Once you have completed all of the setup you should save t...

Page 24: ...old settings If you need to do further testing set the unit to Logging Mode wait while the changes are activated and then go back to Console Mode if the battery has been removed the unit s time will b...

Page 25: ...o check either the Network Session Key or Application Session Key To send a Link Check Message AT MSG the Link Check message is a special form of message which is sent with no payload when a Link Chec...

Page 26: ...ds to the SDI 12 sensors in the Command Line radio buttons activate the Sensors button now type the command you wish to send in to the Command Line to make a test measurement a sensor on address 2 typ...

Page 27: ...le used on the devices To check the Modem firmware version activate the Send Commands to Lora radio button in the command field type AT VER the version will be displayed this should be version 2 1 19...

Page 28: ...ted using the Direct Command Mode send a test message AT MSG and check that an acknowledgement is returned you should also be able to see the message and its reply on the Data Traffic monitor on the L...

Page 29: ...ew Toggle Tag Time This function acts as a Toggle each time you select it the mode will be reversed 6 1 3 Displaying Log Events The Console can also be set to display additional log information Logs a...

Page 30: ...w Get FW Version To display the Console version Help About 6 2 4 Reading the Date Time To read the time from the TBS12 select View Get Time the time will be displayed as below on the Console the forma...

Page 31: ...h mm ss space aa bbb Data format for battery consists of the following a PB header the timestamp YYYY MM dd HH mm ss year month day hour minute second the battery voltage 7 2 Sensor data format Sensor...

Page 32: ...sor 0 if the 2nd command is for the same address it will be Sensor ID 0 Sub Sensor 1 the number of values which follow 01 to 99 the sensor tag value If there are multiple measurements they are separat...

Page 33: ...is still identified with a P type PP18 06 01 17 00011 1 90 Format PP yy mm dd hh mm ss SID SSID n a dur PP header YYYY MM dd HH mm ss timestamp SID Sensor ID 0 P1 1 P2 SSID Mode Sub Sensor ID 2 Flow...

Page 34: ...its LoRaWAN radio module the transmission from the Node is processed by a LoRaWAN Gateway in the LoRa WAN system Gateways are relatively primitive devices after receiving a packet of data they simply...

Page 35: ...for messages to travel back to the LoRaWAN server can cause issues with processing the data packets so on some Gateways it is possible to run the LoRa WAN Server and LoRa App server on the Gateway Th...

Page 36: ...aWAN node Device EUI Dev EUI an identifier allocated to the device by the manufacturer This is normally created to ease configuration all devices with an identical configuration can be given the same...

Page 37: ...u may also need to determine the correct settings for the operating frequencies Channel Plan this is set at the country level Most countries have allocated LoRaWAN frequencies in either the 868 or 900...

Page 38: ...e Log can be found in the directory C Users user name App Data Local TBS12 Logs The file will be named TBS12_Console txt The log can be opened using a text editor such as Notepad To prevent the text e...

Page 39: ...the TBS12 4 pin This will be supplied to you by TOIP a copy of the STM32 ST Link program which can be downloaded from the ST Microelectronics web site you need to register on the site to complete the...

Page 40: ...wdriver remove the lid from the TBS12 case 10 2 1 TBS12B TBS12S TBS12PC The Programmer plugs in to this the 4 pin JST socket TBS12B the socket is to the left of the socket used with the USB to FTDI ad...

Page 41: ...select File Open now locate the folder in which you copied the TBS12 firmware select the file TBS12 x_nn nn hex make sure that the x matches the model number of your device e g S for TBS12S B for TBS1...

Page 42: ...the TBS12 Console You should now restart the TBS12 do this by removing the battery waiting a couple of minutes and then plugging it back in now re open the Console select the correct COM port select...

Page 43: ...ra Putty terminal emulation software with enhanced file upload functionality download from http www extraputty com download php 11 1 Preparation First off check the modem firmware version to ensure th...

Page 44: ...on adaptor Rx left pad you will have to hold the pogo pins in place while you perform the upgrade 11 1 2 TBS12PC FS The TBS12PC FS board has a socket connected directly to the RHF modem It is labelled...

Page 45: ...r a direct firmware upgrade switch back to Extra putty you should see the C character being repeatedly written to the screen as the Modem waits for the downloaded file from the menu select Files Trans...

Page 46: ...the modem will respond with its current firmware version remove the 2nd USB converter and modem upgrade lead...

Reviews: