Zane zTrack Tube User manual

www.zane.hu
1
Operating Manual
zTrack Tube
Index
Safety information ............................................................................................................................... 2
Correct use .......................................................................................................................................... 2
Specifications ....................................................................................................................................... 2
Disassembly and disposal .................................................................................................................... 2
Commissioning ........................................................................................................................................ 3
zTrack Config Tool to configurate the sensor ...................................................................................... 3
Device parameters .......................................................................................................................... 3
LoraWAN preferences ..................................................................................................................... 5
Integration to TTN Network .................................................................................................................... 6
Payload decoding with TTN ................................................................................................................. 7
Integration to Zane Tracking Solution ..................................................................................................... 7
Using with zTrack Map ........................................................................................................................ 7
zTrack Config tool for firmware upgrade ................................................................................................ 8

www.zane.hu
2
Safety information
Read the operating instructions before setup the device.
Connection, mounting, and setting may only be performed by trained persons.
Not a safety component in accordance with the EU Machinery Directive.
Not a device for absolutely reliable tracking or positioning.
When commissioning, protect the device from moisture and contamination.
These operating instructions contain information required during the life cycle of the sensor.
Correct use
The zTrack Tube is a sensor with build in accelerometer, temperature sensor and GPS receiver
connected to radio-chip for LoRaWAN. The device can be widely used to track pets, children, bicycles,
elderly people, bags, assets. It’s also predestined to check range and coverage of LoRaWAN
gateways. For all tracking applications, the applicable data protection guidelines must be observed in
accordance with local regulations.
Specifications
Frequency Band: 867,1 – 868,8MHz ISM (SKU-EU)
902.000 MHz to 928.000 MHz
(US)
Number of
Channels:
Configurable 8 channels (SKU-
EU)
Battery Specs: Rechargeable by USB charger
3.7V 800 mAh LiPo
Transmit Power: +14 dBm (25 mW) (EU)
up to +18.5 dBm high efficiency
PA (US)
Receive
Sensitivity:
-141 dBm (EU)
-146 dBm (US)
Antenna: Built-in
Operating
Temperature:
-10ºC ~ 50ºC Protection
Requirements:
IP63
Dimensions: D:25 x L:88
(Weight: 40g)
LED indicator: Configurable (Activity, Charging
Power consumption:
In case of average usage (2 hours of motion per day with 5 minutes sending period), zTrack Tube can
work for up to 4 weeks with one single charge.
Disassembly and disposal
The sensor must be disposed of according to the applicable country-specific regulations. Efforts
should be made during the disposal process to recycle the constituent materials (particularly
precious metals). The sensors contain a lithium battery, which must be disposed of separately.

www.zane.hu
3
Commissioning
Requirements
 USB type A cable with micro USB, USB charger.
Before commissioning charge zTrack Tube for 1 h with USB charger.
 zTrack Configuration Tool software
Download the zTrack configuration tool from HERE
Configuration tool is available for Win10.
zTrack Config tool is a free software interface for configuring zTrack devices.
It provides a simple environment for reading and writing device settings and performing firmware
upgrade. The tool offers several features to interact with the device; in addition to firmware upgrade,
you can adjust device settings, LoRaWAN related parameters, switch between
bootloader/application, and reset the device.
zTrack tool to configurate the sensor
First Start zTrack Configuration Tool, second connect zTrack Tube to the computer. Don’t touch the
link for firmware. If you confirm to change firmware ZTrack Tube changes to boot mode, and theres
still no acces to go back to configuration mode.
Device parameters
?????

www.zane.hu
4
Device
Parameter
Value
Description
Motion sensor status Enabled/Disabled
Enable to wake up sensor by
acceleration. If no movement
sensor switches to sleep mode
after “Tracking time” is
elapsed.
GPS
status
Enabled/Disabled
Start / Stop GPS
Motion sensor sensitivity Lvl 1 up to Lvl 9
Sensitivity of
acceleromete
r
default: Lvl 2 = very sensitive
GPS accuracy 10 … 60 seconds
Position average measured
over “GPS accuracy” time
GPS time 0 … 900 seconds
Time to get stable GPS position
data. If no GPS signal is
received for “GPS time”,
tracker sends message
“motion detected”
Tracking time 5 … 1800 seconds
Tracking interval to send GPS
position
Keepalive time 3600 … 21600 seconds
If no
acceleration, sending
keepalive packets to gateway.
Cycle time 60 minutes by
default, max. 6 h
Perform factory reset

www.zane.hu
5
LoraWAN preferences
LoraWan preferences
Value
Description
Adaptive Data Rate Enabled/Disabled
Adaptive Data Rate (ADR) is a
mechanism for optimizing data
rates, airtime and energy
consumption in the network.
It is suggested to leave
disabled for proper operation
LoraWAN datarate
DR0 … DR6
LoraWAN network join type Join by ABP, join by OTAA
Activation By Personalization
(suggested),
Over The Air Activation
Set Device EUI
Hex string
See label zTrack Tube
Set DevAddr Hex string
Device Address
K
ey
from integration
Set NwkSKey Hex string
Network Session Key
from integration
Set AppSKey Hex string
App Session Key
from integration
Single channel operation
1/0
?????
?????

www.zane.hu
6
Integration to TTN Network
Requirements
 Create account at THE THINGS NETWORK
www.thethingsnetwork.org
 Check if there’s a gateway near you
 Login at TTN console
add application
register device
TTN console register device
 Register your zTrack Tube under TTN console  Application  Devices  “register device”
 Setup device under TTN console  Application  Devices  “Device Settings”
TTN device
Label at
Config Tool
TTN
Application ID
Name of TTN application
Device ID
This is the unique
identifier for
the device in this app. The
device ID will be immutable.
only lowercase alphanumeric
characters,
nonconsecutive - and _
and it cannot start or end with
a - or a _
Activation Method
ABP
Choose
activation
method
under device settings

www.zane.hu
7
TTN device
Label at
Config Tool
TTN
Device EUI
Set Device EUI
8 bytes
written on the label of zTrack
Tube
Application EUI
8 bytes
Generated by TTN
Device Address
Set
DevAddr
Assigned by network server
Network Session Key
Set NwkSKey
16 bytes
Network session key will be
generated
App Session Key
Set AppSKey
16 bytes
App session key will be
generated
After device registration, go back to Config tool  “LoraWAN preferences” and fill the form with the
hex strings of yours TTN registration.
After this step, you can receive data from your tube.
Payload decoding with TTN
Payload specification at https://ztrackmap.com/support/
For zTrack Tube you can use this decoder on TTN. Use custom payload.
http://ztrackmap.com/support/usermanual/zTrack_TTN_decoder.txt
Example result for payload:
44 5D 64 06 12 5D 02 AC 02 08 59
{
"alt": 684,
"battery": "59%",
"lat": 48.06901647305881,
"lon": 8.53837455233921,
"temp": 20.8
}
Integration to Zane Tracking Solution
Using with zTrack Map
1. Select the required application
2. Select add integration at Integrations tab
3. Choose HTTP Integration
4. Fill Process ID field - select default key at Acces Key - copy
http://185.187.72.215:8000/ztrackmap to URL - Choose POST at Method
Authorization, Custom Header Name, Custom Header Value can be left empty
5. Click Add integration

www.zane.hu
8
zTrack Config tool for firmware upgrade
Requirements
 USB type A cable with micro USB
 To get proper firmware file for the zTrack Tube : https://ztrackmap.com/support/
 zTrack Config Tool software
Download the zTrack configuration tool from https://ztrackmap.com/support/
compressed file: setup_zTrack_Configuration_Tool_1031.rar
Unpack file and after unzip the bootloader: en.stsw-stm32080.zip
Install: DfuSe_Demo_V3.0.5_Setup.exe
 Connect zTrack to Config Tool and click “Perform device firmware upgrade”
 Windows is installing correct USB driver for DFU device
 If zTrack is not detected by zTrack Configuration Tool follow the instructions below:
o Run the device manager of Windows and find the USB device "DFU in FS Mode"
o Right click on the device and select "Uninstall device"
o When the Uninstall Device window appears check the "Delete the driver software for
this device" and click "Uninstall"
o Disconnect the device
o Connect the device to the PC again.
 Browse the proper firmware file and upload it.

www.zane.hu
9
* Warning: Do not use the “Update automatically to the latest firmware version” option, this
feature is no longer supported.