Skip to content

SODAQ Universal Tracker

Intro

Follow the Getting Started guide to install the required boardfiles.

Versions

The SODAQ ONE has everything on board to be the perfect tracker.
The latest tracker software can be downloaded from our github.

ONE v1

Download the correct version for your board. Below we listed all versions.

One v1 – SODAQ Payload
https://github.com/SodaqMoja/SodaqOne-UniversalTracker

One v1 – Cayenne LPP
https://github.com/GabrielNotman/SodaqOne-UniversalTracker

ONE v2

One v2 – SODAQ payload and Cayenne LPP
https://github.com/SodaqMoja/SodaqOne-UniversalTracker-v2

ONE v3

One v3 – SODAQ payload and Cayenne LPP
https://github.com/SodaqMoja/SodaqOne-UniversalTracker-v3
This is the end of life version of the SodaqOne tracker made for the ONE v3.

Universal Tracker – SODAQ payload and Cayenne LPP
https://github.com/SodaqMoja/Sodaq_Universal_Tracker
This is the new Universal Tracker made for the ONE v3, AFF and SFF boards.

download

Unzip the packet.
Open the .ino file with the Arduino IDE.
Select the correct Board and Port and upload the sketch to your board.

Note

If you don’t see a port the Sodaq One is maybe in sleep.
1x reset the board will normal reset, tracker code has 30 seconds before it disconnects the usb.
2x reset in a second will manually put the Sodaq One into bootloader mode.

Configure your board

After compiling the source code and uploading it to the board you will be able to configure the board through a menu.

Open the Arduino Serial Monitor to see the bootup menu.
Make sure New Line and Carriage Return are enabled.

The bootup menu will close itself after 30 seconds.
When you don't see the menu send an (empty) command.
After every command the menu will reload with the latest parameters and the timer will reset.
The Serial Monitor needs te be closed in most cases before uploading a new sketch.
A power toggle and pressing the reset button require to close and re-open the Serial Monitor.

The LoRa HWEUI is shown, by default also in the dev= field. Write this Hardware EUI down, you will need it later.

RN2903

There is an issue with RN2903 that the current tracker payload does not fit in SF10.
In the menu settings we have to prevent to use SF10.

  • Turn off ADR: adr=0
  • Set Spreadingsfactor 7, 8 or 9: sf=9

Network

The Things Network

The Things Network provides a global open LoRaWAN network.

Create a free account and login to the console.

KPN

The Dutch Telecom provider KPN has an nation wide LoRaWAN network.
Create a developer account on the KPN Things Portal.

Other LoRaWAN Networks

The RN2XX3 is compliant with any LoRaWAN network.

Dashboard

We have tested the Universal Tracker Code with the following dashboards.

AllThingsTalk

Create your account on and sign-in on the AllThingsTalk Maker.

If you have an activation code, simply claim your device.

Cayenne from MyDevices

Enable the cayenne low power payload by sending cay=1 in the bootmenu of your device.

Create your account on and sign-in on Cayenne.

  1. Select LoRa.
  2. Select your network operator. (Actility for KPN)
  3. Search for SODAQ.
  4. Select the SODAQ ONE.
  5. Put in the Device EUI.
  6. Add device.
  7. Send a message, your data will automatically appear.

KPN Cayenne Setup

KPN Cayenne Data

ThingsBoard

A Thingsboard tutorial will come soon.

Ubidots

Ubidots made a tutorial how to connect our SODAQ ONE sending over The Things Network and show it on the Ubidots dashboard.

Click here to see the Ubidots tutorial

We will send the following values in the downlink:
– Fix interval 23 minutes
– No Alternative fix interval
– GPS timeout of 120 seconds

Al values need to converted to hex, adjusted to correct lenght and converted to little endian.

Fix interval of 23 minutes
23 to hex = 17
Lenght correction: 00 17
Change to little endian: 17 00

No alternative fix interval:
00 00
00 00 00 00
00 00 00 00

GPS:
120 to hex = 78
Lenght correction: 00 78
Change to little endian: 78 00

Combine the values:

1700 0000 00000000 00000000 7800
1700000000000000000000007800

If the queue the hex in your LoRaWAN network, the next time a message from the device is send it will sent the first queued message.

Questions

You can ask us anything on our Forum.