Professional Documents
Culture Documents
User Manual Taiga Tracker - en
User Manual Taiga Tracker - en
DESCRIPTION
Taiga Tracker is designed to track the assets both in open areas
using a navigation receiver, and indoors, using the iBeacon
Bluetooth tag scanner.
FUNCTIONALITY
APPLICATIONS
• Asset tracking
• Logistics
• Equipment usage activity tracking
• Indoor geolocation
CONNECTIVITY
1
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
TABLE OF CONTENTS
DESCRIPTION .................................................................................................................................................1
FUNCTIONALITY.............................................................................................................................................1
APPLICATIONS ...............................................................................................................................................1
CONNECTIVITY...............................................................................................................................................1
TABLE OF CONTENTS .....................................................................................................................................2
SPECIFICATIONS ............................................................................................................................................4
DEVICE OPERATION PRINCIPLE .....................................................................................................................5
Device operation behavior .........................................................................................................................5
Geolocation ................................................................................................................................................6
Device modes .............................................................................................................................................6
MOBILE APPLICATION ...................................................................................................................................7
Application description ...............................................................................................................................7
Connecting to device ..................................................................................................................................7
Application features ...................................................................................................................................8
DEVICE CONFIGURATION ..............................................................................................................................9
Geolocation ................................................................................................................................................9
GNSS receiver ...........................................................................................................................................10
iBeacon scanner........................................................................................................................................10
Movement detector .................................................................................................................................11
Motion activity..........................................................................................................................................11
Turn detector ............................................................................................................................................11
Shock detector ..........................................................................................................................................12
Temperature sensor .................................................................................................................................12
Modem *TaigaTracker-NB only ................................................................................................................13
MQTT *TaigaTracker-NB only ...................................................................................................................14
CoAP *TaigaTracker-NB only ....................................................................................................................14
Update server *TaigaTracker-NB only ......................................................................................................14
LoRaWAN *TaigaTracker-LW only ............................................................................................................15
Hibernation ...............................................................................................................................................16
DATA EXCHANGE PROTOCOL ......................................................................................................................17
Uplink packet structure ............................................................................................................................17
GNSS geolocation frame ...........................................................................................................................19
Motion activity frame ...............................................................................................................................20
Shock detection frame..............................................................................................................................20
Bluetooth iBeacon geolocation frame ......................................................................................................21
2
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
3
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
SPECIFICATIONS
Enclosure and dimensions
Color Black
Material Glass filled polyamide
Ingress protection rating IP-68
Dimensions 125х75х37 mm
Weight 300 g
Operational conditions
Operational temperature range -40…+85 °С
Humidity 0-100%
Storage temperature range -60 … +100 °C
Power supply
Operational voltage 3.0 V
Battery model 3x CR123 (LiMnO2)
Battery type LiMnO2
Battery lifetime Up to 3 years (depending on settings)
Summary battery capacity 4500 mAh
GNSS geolocation
Antenna type Embedded ceramic
Supported GNSS navigation satellite systems GLONASS/GPS
Number of channels 72
Sensitivity -167 dBm
Cold start time 40 s
Hot start time 3s
Embedded RTC sync with GNSS Yes
Data transmission TaigaTracker-LW TaigaTracker-NB
Communication standard LoRaWAN 1.0.3 class A LTE cat. NB2
Radio frequency range RU864/EU868 B1, B3, B5, B8, B20, B28
Maximum transmit power 16 dBm 23 dBm
Sensitivity -137 dBm -129 dBm
Indoor geolocation
Geolocation method Bluetooth low energy
Scanning period/duration Configurable
Bluetooth beacon format iBeacon
Bluetooth beacon filtration Yes
Additional features
Motion activity tracking Yes, with configurable interval and sensitivity
Start/stop movement detection Yes, with configurable timeout
Shock detection Yes, with configurable sensitivity
Turn detection Yes, with configurable angle threshold
Temperature measurement Yes, with configurable interval
Configuration
Configuration interface With Android/IOS mobile application
Identification
Identification method Embedded NFC tag with device information
4
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
Data generation
regular or event Data transmission
based regular or triggered
Geolocation
FIFO queue LoRaWAN
Movement detector
*for TaigaTracker-LW
Motion activity
Nb-IoT
Turn detector *for TaigaTracker-NB
Shock detector
Temperature sensor
TaigaTracker have several software modules that generate data, module for data transmission and FIFO
queue in between.
In addition, data generation software modules is able to trigger immediate geolocation or data
transmission when new data or events is generated by these modules.
Embedded queue can store up to 200 records of data and have FIFO operational principle. The oldest data
is transmitting first. If device goes out of network coverage, all measured data will be saved and
transmitted when device goes back to the network.
This architecture allows user to make different flexible asset tracking configurations like:
• Regularly track the asset
• Track asset only when it starts moving and stop moving
• Get location of shock or turn accidents
• Monitor temperature conditions of asset
• Track activity of asset usage
5
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
Geolocation
If both geolocation methods is enabled in the device settings, iBeacon scanner will be used first. In case if
device can not find any beacon around, it will power on GNSS receiver to find real geographical position.
Device modes
The device is delivered in hibernation mode. It is inactive. Hibernation must be disabled to enable device.
Hibernation mode allows the device to be transported. It is inactivated, emits no messages, and consumes
very little power.
Once activated, device switch between RUN and SLEEP mode based on accelerometer data. These modes
can be used to fine tune the device behavior in the settings. For example, it is possible to disable regular
geolocation in sleep mode.
In SLEEP mode device does not active in Bluetooth for configuration app connection.
6
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
MOBILE APPLICATION
Application description
A mobile application (iOS or Android) allows configuration of the device via a Bluetooth connection.
Name of the Application: TAIGA IOT
The app can be downloaded from:
• Apple's AppStore – https://apps.apple.com/ru/app/taiga-iot/id1564919917?l=en
• Google's PlayStore - https://play.google.com/store/apps/details?id=com.taiga.confapp
Connecting to device
• Launch the TAIGA IOT Application (make sure that Bluetooth is active)
• Select your device. Please note that it may take 10-15 seconds before your device shows up in the list.
If it doesn’t show update, activate your device by shaking it, as it may be sleeping.
• Enter the password.
For Android smartphone geolocation need to be enabled as well, otherwise mobile app will
not be able to connect devices. This is Android OS requirement.
7
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
Application features
The operation of device can be controlled through SETTINGS, STATE, COMMANDS and DEBUG pages of
mobile configuration application.
8
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
DEVICE CONFIGURATION
Geolocation
TaigaTracker can launch geolocation process, that assume both iBeacon and GNSS geolocation if enabled
on regular base with predefined period. GNSS receiver and iBeacon scanner can be optionally
enabled/disabled.
If both iBeacon scanner and GNSS receiver is enabled, device use iBeacon scanner first,
then GNSS receiver. If iBeacons scan attempt is successful, GNSS receiver will not be launched.
If both GNSS and iBeacon scanner is disabled, no geolocation will be done, despite the
geolocation settings.
At the end of geolocation process data transmission can be optionally triggered. If this option not enabled,
frame generated in result of geolocation will be saved in queue and transmitted later on regular base or
by another enabled external trigger. External triggers does not impact on regular geolocation, but run
additional geolocation attempt. Regular geolocation could be disabled if devise does not move (SLEEP
mode).
To initiate force geolocation attempt, please use “Run geolocation” command on the COMMANDS
page of mobile application
9
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
GNSS receiver
Looking for position – after power on GNSS receiver it needs a time to resolve position. Time, that is
needed is depends from type of receiver start. For cold start resolving position under clear sky takes
around 40-60 seconds. In worst conditions it can take up to 120 sec. Time for satellite search setting
specify a timeout, after that device will stop attempts to find position and generate empty GNSS
geolocation frame.
Holding position – after position is found, device will leave GNSS receiver in turned on state for satellite
hold time to improve accuracy of position. This is needed because usually, first coordinates, generated by
GNSS receiver after position is found is not quite accurate (error can be up to 100 meters).
Generate frame – after position is found and hold time is elapsed, device will generate GNSS geolocation
frame with founded position and put it in queue.
iBeacon scanner
Looking for beacons – after power on iBeacon scanner device will look for iBeacon devices radio signals
nearby for time, specified in scanner duration setting.
Apply filter – at the end of the scan, list of visible iBeacons can be filtered by Major field value, provided
in settings. If filtering is not needed, please set this setting to zero
Choose best 3 beacons – since the Bluetooth geolocation frame only contains up 3 beacons, device will
choose from list of visible beacons three with best RSSI values.
10
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
Generate frame – at the end of filtering and sorting, device will generate frame with best 3 visible beacons
and put it in queue. If less than 3 beacons found, device will generate frame anyway.
If no beacons are visible, or pass the filter, frame will not be generated
Movement detector
Movement detector is work based on embedded accelerometer readings and allow device to switch
between RUN and SLEEP modes. This module is always enabled. Ability to generate start/stop packets can
be enabled/disabled, but the module itself is always working. Sensitivity allows user to define how much
acceleration need to be applied to device to switch it from SLEEP to RUN mode. Stop detection timeout
defines how much time device should not move to switch from RUN to SLEEP mode. Data transmission
and geolocation can be optionally triggered.
If both trigger geolocation and trigger data transmission options is enabled together and
trigger data transmission in geolocation settings enabled as well, data transmission will be
triggered twice. Once after start/stop move, and then after geolocation. This will cause
additional energy consumption.
Motion activity
Device is able to track motion activity of asset with predefined measurement interval and sensitivity.
Activity changing is measured twice per second based on accelerometer data and averaged in
measurement interval. Data transmission can be optionally triggered.
Turn detector
11
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
Turn detector is work based on embedded accelerometer readings and can detect asset turns in according
with turn angle threshold, defined in settings. After turn is detected, device will ignore another turns, that
could happens in time, defined in turn timeout setting. Data transmission and geolocation can be
optionally triggered. If turn detection functionality is not needed, module can be disabled.
Shock detector
Shock detector is work based on embedded accelerometer readings and can detect asset shocks with
defined in settings sensitivity. Data transmission and geolocation can be optionally triggered. If shock
detection functionality is not needed, module can be disabled.
Temperature sensor
Device is able to provide periodical asset temperature data with period, specified in settings. Data
transmission can be optionally triggered.
If “stop geolocation if no movement” option is enabled, it’s possible that no packets will be
generated during the stop state of device. In this case, periodical temperature measurement
can be used to generate periodical packets once/twice per day to provide heart bit signal to
the tracking platform.
12
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
Device will enable modem periodically for regular data transmission with defined in settings regular data
transmission interval. If no one of “trigger data transmission” options in data generation modules is
enabled, all data, that embedded queue contains will be send on regular base. Nb-IoT modem can use
several data transmission methods to the tracking system:
• MQTT protocol
• CoAP protocol
• Non-IP data delivery (NIDD)
Before start using device, please enable LTE bands, that available in your region and specify Access Point
Name for both IP and Non-IP (if used) connectivity methods. To find what bands is available and right APN
names, please contact your telco.
To initiate force join network attempt, please use “Join network” command on the
COMMANDS page of mobile application
13
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
If MQTT protocol is used to transmit device data to the tracking platform please specify in the settings
credentials to access MQTT broker and topic, device should publish data to. Optionally, device can attach
it’s serial number at the end of the provided topic. This is reasonable for some software tracking
platforms.
If CoAP protocol is used to transfer device data to the tracking platform please specify in the settings
credentials to access CoAP server and uri path, device should send data to.
TaigaTracker have over the air firmware and settings update functionality. To get OTA server software,
please contact Taiga IoT company.
14
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
Device can send data regularly through LoRaWAN networks. TaigaTracker-LW support LoRaWAN
specification version 1.0.3 with OTAA join method. Adaptive Data Rate algorithm is disabled. Regional
frequency plan and data transmission.
If confirmation option is enabled, device will not remove packets from embedded queue until it receive
packet delivery confirmation from the network. If disabled, device will remove packets from embedded
queue immediately.
Disabled confirmation is reduce load on LoRaWAN network and increase network capacity,
but can cause packet loss. Please disable this setting only if you clearly understand what you
do.
Rejoin interval setting specify interval, device will make attempts to join network. this option is used only
when device still not joined to the network. Once joined, periodical rejoins is disabled.
Device credentials (DevEUI and keys) can be found in the Personalization page of mobile
application (or by scanning the QR code of the device).
To initiate force join network attempt, please use “Join network” command on the
COMMANDS page of mobile application
15
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
Hibernation
Device have hibernation mode, that can be enabled/disabled through the settings. This mode is needed
for device storage or transportation. In this mode no of software modules is working and device stay in
power saving mode.
16
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
Each uplink packet in W-protocol should be composed in according with described below structure. One
packet can contain one or more frames. Frames count is variable. All fields with a field width more than
one byte have little-endian byte order.
17
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
Each packet consists from fixed size packet header and one or series of frames. Field “Serial number” used
only in case, when data exchange network protocol has no embedded ability to unique identify end devices
(Wi-Fi, Nb-IoT, LTE, etc..). For network protocols like LoRaWAN with embedded ability to identify device
this fields is not used, that indicated by “serial presence indicator” field.
Examples:
MQTT/CoAP/Non-IP – Serial number field present in packet
LoRaWAN – Serial number field not present in packet
18
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
19
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
20
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
This frame lists three visible Wi-Fi access points with strongest RSSI.
Field Field width Description Width Possible values
For this type of frame always ==
Type of frame 12 LSB bits
0x09
Frame
2 bytes Frame event code. Indicates a
header 0x00 – frame generated on regular
reason why this frame was 4 MSB bits
base
generated
Frame
Any positive value from
generation 4 bytes Unixtime (UTC) 32 bits
0x00000000 to 0xFFFFFFFF
timestamp
Major field of first visible
Major1 2 bytes 16 bits Any value from 0 to 65535
iBeacon
Minor field of first visible
Minor1 2 bytes 16 bits Any value from 0 to 65535
iBeacon
Received signal strength
RSSI1 1 byte 8 bits Any value from -128 to 0
indicator for first visible beacon
Major field of second visible
Major2 2 bytes 16 bits Any value from 0 to 65535
iBeacon
Minor field of second visible
Minor2 2 bytes 16 bits Any value from 0 to 65535
iBeacon
Received signal strength
RSSI2 1 byte indicator for second visible 8 bits Any value from -128 to 0
beacon
Major field of third visible
Major3 2 bytes 16 bits Any value from 0 to 65535
iBeacon
Minor field of third visible
Minor3 2 bytes 16 bits Any value from 0 to 65535
iBeacon
Received signal strength
RSSI3 1 byte indicator for third visible 8 bits Any value from -128 to 0
beacon
RFU 7 LSB bits RFU
Additional
1 byte Movement flag (based on 0 – if device is not in movement
Flags 1 MSB bit
accelerometer data) 1 – if device in movement
21
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
Temperature frame
22
taigaiot.com
User manual
TAIGA TRACKER - ASSET TRACKING DEVICE
CONTACTS
Internet of things laboratory LLC
630102, Shevchenko street, building 11, Novosibirsk, Russian Federation
E-mail – info@taigaiot.com
Website – https://taigaiot.com/
23
taigaiot.com