Zane zTrack One User manual
www.zane.hu
1
Operating Manual
zTrack One
Index
Safety information................................................................................................................................... 2
Correct use .............................................................................................................................................. 2
Specifications........................................................................................................................................... 2
Disassembly and disposal........................................................................................................................ 2
Battery and Charging............................................................................................................................... 3
Commissioning ........................................................................................................................................ 3
zTrack tool to configurate the device.................................................................................................. 3
Integration to TTN Network .................................................................................................................... 6
Payload decoding with TTN................................................................................................................. 7
Integration to Zane Tracking Solution..................................................................................................... 9
Using with zTrack Map ........................................................................................................................ 9
Downlink Specification.......................................................................................................................... 10
Uplink Specification............................................................................................................................... 11
Status Led .............................................................................................................................................. 14
Motion sensor ....................................................................................................................................... 14
zTrack Configuration Tool for firmware upgrade.................................................................................. 15
Revision history ..................................................................................................................................... 17
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
zTrack One is a GPS tracker which uses the LoRaWan network. The device is a revolutionary small
LoRaWAN based GPS tracking device with a button. The device is widely used to track pets,
children, bicycles, elderly people, bags,
assets. The device will send a message to the LoRaWAN
network when the button pressed. When the GPS tracking is enabled this message will contain
coordinates too. From this point any kind of event can be applied to a button press, it is up to the
application, and the opportunities are endless.
Enabling the built-in accelerometer, the device can detect when it is moved. First of all, if there is no
movement, the tracker sends keepalive packets to the gateway every 60 minutes by default (this
period can be set from 60 minutes to 6 hour). When movement occurs, the tracker activates itself. If
the GPS enabled, the GPS is able to locate the device, the coordinates will be reported to a LoRaWAN
network. In addition, if the GPS receives no coordinates within a specified time, then the module will
only send a short message that motion happened.
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 via uUSB
3.7V 190 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:
IP51
Dimensions:
L:53 x W:39 x H:11mm
(Weight: 25g)
LED indicator:
Configurable (Activity,
Charging)
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
Battery and Charging
The built-in LiPo battery can power the device for around 2 weeks. Battery lifetime highly depends
on the device configuration.
The device sends a low battery notification, see the Uplink specification section.
The battery can be charged with USB charger. Charging takes approx. 2hour and the red LED is
constantly lit. When the battery is fully charged the green LED flashes.
During charging, all activities other than the configuration are turned off.
Commissioning
Requirements
•USB type A cable with micro USB, USB charger.
•zTrack Configuration Tool software
Download the zTrack Configuration Tool configuration tool from
https://ztrackmap.com/support/
Configuration tool is available for Win10.
zTrack Configuration 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 device
First, start zTrack Configuration Tool, second connect zTrack One to the computer. Don’t touch the
link for firmware. If you confirm to change firmware, zTrack One changes to boot mode, and if
there's still no acces to go back to configuration mode.
www.zane.hu
4
Device parameters
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 accelerometer
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 Key
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 One under TTN console →Application →Devices →“register device”
•Setup device under TTN console →Application →Devices →“Device Settings”
TTN device
Label at Configuration 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,
non-consecutive - 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 Configuration 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 Configuration Tool →“LoraWAN preferences” and fill the form
with the hex strings of yours TTN registration.
After this step, you can receive data from your device.
Payload decoding with TTN
See the payload in Uplink Specification section.
For zTrack One you can use this decoder on TTN. Use custom payload.
function Decoder(bytes, port) {
// Decode an uplink message from a buffer
// (array) of bytes to an object of fields.
var decoded = {};
if (port == 204){
lat = bytes[0] << 16;
lat |= bytes[1] << 8;
lat |= bytes[2];
lat = lat/8388606 * 90;
if (lat > 90) lat -= 180;
decoded.lat = lat;
lon = bytes[3] << 16;
lon |= bytes[4] << 8;
lon |= bytes[5];
lon = lon/8388606 * 180;
if (lat > 180) lon -= 360;
decoded.lon = lon;
alt = bytes[6] << 8;
alt |= bytes[7];
decoded.alt = alt;
www.zane.hu
8
temp = (bytes[8] & 0x0F) * 100;
temp += ((bytes[9] & 0xF0) >> 4 ) * 10;
temp += bytes[9] & 0x0F;
if( bytes[8] & 80)
temp /= -10;
else
temp /= 10;
decoded.temp = temp;
bat = ((bytes[10] & 0xF0) >> 4) * 10;
bat += bytes[10] & 0x0F;
decoded.battery = bat + "%";
}
else
if (port == 207 || port == 205){
temp = (bytes[0] & 0x0F) * 100;
temp += ((bytes[1] & 0xF0) >> 4 ) * 10;
temp += bytes[1] & 0x0F;
if( bytes[0] & 80)
temp /= -10;
else
temp /= 10;
decoded.temp = temp;
bat = ((bytes[2] & 0xF0) >> 4) * 10;
bat += bytes[2] & 0x0F;
decoded.battery = bat + "%";
}
return decoded;
}
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
}
www.zane.hu
9
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
10
Downlink Specification
Command
Name
Description
Range
Message
Port
Message
Payload
Example
Keepalive
Time
Adjusts the
Keepalive Time.
1800 –86400
seconds
100
XXXXXX
6 digits
(3 byte) BCD
coded value
2400 seconds:
002400
Tracking
Time
Adjusts the
Tracking Time.
5 –3600
seconds
101
XXXX
4 digits
(2 byte) BCD
coded value
300 seconds:
0300
GPS Fix
Time
Adjusts the time
given to GPS
module to obtain a
fix.
10 –900
seconds
102
XXXX
4 digits (2 byte)
BCD coded value
30 seconds:
0030
GPS
Accuracy
Adjusts the time
for GPS Accuracy
(the settle time
after a fix is
obtained).
5 –60
seconds
103
XX
2 digits (1 byte)
BCD coded value
10 seconds:
10
Payload
Format
Adjusts payload
format
0x00: ZANE
0x01: CayLPP
104
XX (1 byte)
Set CayenneLPP
format: 01
GPS State
Adjusts GPS state.
0x0F: off
0x01: on
105
XX (1 byte)
Turn GPS on:
01
Motion
Sensor
State
Adjusts Motion
Sensor state.
0x0F: off
0x01: on
106
XX (1 byte)
Turn Motion
Sensor on:
01
Adaptive
Data Rate
State
Adjusts ADR state.
0x0F: off
0x01: on
107
XX (1 byte)
Turn ADR on:
01
LoRaWAN
Data Rate
Adjusts the
LoRaWAN Data
Rate.
DR0 –DR5
108
XX (1 byte)
Set Data Rate to
4: 04
Status
Request
Status message
request.
N.A.
109
No payload
required.
N.A.
Reset
Request
Device reset
request.
N.A.
110
No payload
required.
N.A.
Bootloader
Request
Device goes into
bootloader mode
N.A.
111
No payload
required.
N.A.
Force GPS
Fix
Force GPS Fix
request.
GPS is active until
it finds a
coordinate. Device
sends GPS data.
N.A.
112
No payload
required.
N.A.
Confirmed
Message
Adjusts Confirmed
Message.
(Button only)
0x0F: off
0x01: on
114
XX (1 byte)
Enable
Confirmed
Message: 01
www.zane.hu
11
Uplink Specification
Uplink messages contains information sent by the tracker devices. These messages can contain
different information. The port number specifies what will we find in this packet.
Summary of ports mentioned:
- 200: a message sent on cold starts.
- 201: message sent when device battery is low.
- 203: message sent when device is in motion, and GPS is disabled.
- 204: message sent when device can get GPS coordinates.
- 205: the device is in motion, no coordinates because the GPS can’t get GPS data.
- 207: periodic message, the device is not in motion.
- 208: configuration status package, only sent on request.
- 209: message sent when GPS error occurred.
- 213: message sent when device button is pushed.
Cold Start
The messages sent only after the controller performed a restart.
oPort: 200
oPayload: firmware version (BCD 4 digits)
Example device message: 0102 -> Firmware version: 1.0.2
Low Battery report
oPort: 201
oPayload: firmware version (BCD 4 digits)
Example device message: 0102 -> Firmware version: 1.0.2
Motion GPS disable
oPort: 203
oPayload: firmware version (BCD 4 digits)
Example device message: 0102 -> Firmware version: 1.0.2
www.zane.hu
12
Motion GPS fix
oSample Payload:
Payload structure (11 bytes): LLLNNNAATTB
Port: 204
Payload: 43ad230f7343007f027148
latitude (3 bytes), longitude (3 bytes), altitude (2 bytes), temperature (2 bytes),
battery (1 byte)
LAT_MSB, LAT_CSB, LAT_LSB, LON_MSB, LON_CSB, LON_MSB, ALT_MSB, ALT_LSB,
TEMP_MSB, TEMP_LSB, BAT
Latitude: 24 bit long signed hexadecimal number. Positive number means North,
negative means South.
Formula to get latitude from given payload:
latitude = (lat_value/8388606) *90
In our example 43ad23(hex)= 4435235(dec)
latitude = (4435235/8388606) *90=47.584920
Longitude: 24 bit long signed hexadecimal number. Positive number means East,
negative means West.
The formula to get longitude from given payload:
longitude = (lon_value/8388606) * 180
In our example 0f7343(hex) = 1012547(dec)
longitude = (1012547 / 8388606) * 180 = 21.726906
Altitude: 16-bit unsigned hexadecimal number.
In our example 007f(hex) means 127m altitude as decimal value.
Temperature:
- 1. character indicates negative or positive temperature (0 –positive, 1 –negative)
- 2. and 3. character is integer part of temperature
- 4. character is fractional part of temperature
In our example the temperature is 27.1 °C
Battery:
- battery status in percentage (1% - 99%)
In our example the battery level is on 48%.
www.zane.hu
13
Motion No GPS fix
oSample Payload:
Payload structure (3 bytes): TTB
Port: 205
Payload: 027148
temperature (2 bytes), battery (1 byte)
TEMP_MSB, TEMP_LSB, BAT
Temperature:
- 1. character indicates negative or positive temperature (0 –positive, 1 –negative)
- 2. and 3. character is integer part of temperature
- 4. character is fractional part of temperature
In our example the temperature is 27.1 °C
Battery:
- battery status in percentage (1% - 99%)
In our example the battery level is on 48%.
Keepalive
oSample Payload (1 byte):
Port: 207
Payload: 48 ->battery status in percentage (1% - 99%)
Status report
oPort: 208
oPayload: firmware version (BCD 4 digits)
Example device message: 0102 -> Firmware version: 1.0.2
GPS Error
oPort: 209
oPayload: 20
Contact report
oPort: 213
oPayload: firmware version (BCD 4 digits)
Example device message: 0102 -> Firmware version: 1.0.2
www.zane.hu
14
Status Led
There is a RGB LED indicator on the zTrack One to inform you about specific events during operation.
The LED indicates various events during operation with colours and blinking.
Activity
LED colour
Led action
System initialization
Red
1 Blink
Send LoRa uplink
Blue
1 Blink
Receive LoRa downlink
Blue
3 Blink
System enters Sleep mode
Red
2 Blink
Start USB configuration
White
4 Blink
GPS coordinate search failed
Purple
2 Blink
Motion detection activated
Yellow
2 Blink
Motion detection deactivated
Yellow
2 Blink
Motion detection active
Yellow
1 Blink
Motion detection detected
Yellow
1 Blink
The button is pressed (GPS on)
Green
1 Blink
The button is pressed (GPS off)
Light Blue
1 Blink
Device charging
Red
Continuous lighting
Device charged
Green
Blinking
Motion sensor
Motion detection can be activated and deactivated by the length of the button press (approx. 5sec).
On reaching a time of a specific function, the device flashes in a colour accordingly. See the Status
LED section.
On the activating the motion sensing, the device waits 30 seconds before activating the detection.
This is applied to give some time for the user to settle the device.
www.zane.hu
15
zTrack Configuration Tool for firmware upgrade
Requirements
•USB type A cable with micro USB
•To get proper firmware file for the zLamp: 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 One to Config Tool and click “Perform device firmware upgrade”
•Windows is installing correct USB driver for DFU device
•If zTrack One is not detected by zTrack Configuration Tool follow the instructions below:
oRun the device manager of Windows and find the USB device "DFU in FS Mode"
oRight click on the device and select "Uninstall device"
oWhen the Uninstall Device window appears check the "Delete the driver software for
this device" and click "Uninstall"
oDisconnect the device
oConnect the device to the PC again.
•Browse the proper firmware file and upgrade it.
•Finishing upgrade, click to Leave DFU mode.
www.zane.hu
16
Table of contents
Other Zane GPS manuals
