Docs
ExamplesGet started with popular boardsGet started with our kits

In this article

Track-and-Trace

The Track-and-Trace Product Kit has been pre-loaded with a demo sketch. Here we will show you how to get this demo running in no-time!

Prerequisites

Hardware

  • Sodaq ONE board
  • GPS module
  • Antenna
  • LiPo battery

Software

If you are using the AllThingsTalk Product kit, the Arduino LoRaWAN SDK and PDK are already installed on your Sodaq ONE.

Setup

Hardware

  • Connect the antenna to your Sodaq ONE
  • Connect the GPS module to your Sodaq ONE
  • Connect the battery to your Sodaq ONE
  • Connect your Sodaq ONE to your computer over USB

Create device

If you did the basic example on the previous page, your device is already created and ready for use.
If not, please check the create device and enter keys sections on that page.

Serial connection

Windows

First we need to know to which COM port our device is connected.

  • Open a command prompt
  • Type powershell to get into powershell command mode
  • To see a list of all available serial ports, type [System.IO.Ports.SerialPort]::getportnames()

Next we will use PuTTy as a terminal emulator to show the settings menu and the communication of the device.

  • Download PuTTy here. No need to install. You can run the downloaded file straight away
  • Open PuTTy
    • Select Serial
    • Enter the correct COM port
    • Enter the correct Baud rate (57600)
    • Open


Regardless of the terminal tool you use, once the serial connection is established, you should see something similar to this



Mac OS X

The default is Terminal which you can find in your Utilities folder

  • Open the Terminal App
  • To see a list of all available serial ports, typ Ls /dev/tty.*
  • The port to which the LoRaWAN™ is connected should be /dev/tty.usbmodem1421
  • Typ screen <port-name> <baud_rate> to establish a simple serial connection,
    for example screen /dev/tty.usbmodem1421 57600

If all went well, you should now be connected and see the configuration menu of your Track-and-Trace device

Terminal commands

Below you will find a list of commands to slightly alter the behaviour of your Track-and-Trace device.

  • q quit (this will start the demo application)
  • s save the current settings and quit the menu (this will start the demo application)
  • r do a factory reset. This resets all values to their default value
Keys
  • dev set the DEVEUI for your Track-and-Trace device
  • app set the application sessions key
  • nwk set the network session key
Use accelerometer

There are 2 different modes

  • 0 accelerometer is not used. Interval for sending data is a fixed time interval
  • 1 sending data is triggered by the accelerometer

Command ac, for example ac=0

Accelerometer sensitivity

Set the sensitivity of your accelerometer. Range between 1 and 10.
Command acs, for example acs=6

Interval

Time interval between sending of data in minutes.
Command int, for example int=5

GPS nr of retries

Amount of retries the GPS module attempts to get a fix before giving up.
Command gps, for example gps=11

Enter keys

To run our demo, we need to fill in the keys of our device. You can find them under SETTINGS > CONNECTIVITY of your device in AllThingsTalk.

  • DEV_ADDR is the DEVEUI for your LoRaWAN™ based Track-and-Trace device. You can also find this key printed on the box of the product kit
  • APPSKEY is the application session key of your device
  • NWKSKEY is the network session key of your device

Fill in these keys using the terminal Keys commands above

For example to set the APPSKEY typ app=26FBF8C4F2CFD09FF8BF19220F584368 (using your own APPSKEY code).

The LoRaWAN™ based Track-and-Trace device will enter into configuration mode

  • when you press the button within 5 seconds after you power on the device
  • or when no device keys are entered yet
    Else the device will start running the Track-and-Trace application straight away.

Run track-and-trace demo

Make sure the correct payload format is set for your device under SETTINGS > Payload Formats in AllThingsTalk. This example uses our default json format so make sure the ABCL checkbox is unchecked.

After saving your keys, the Track-and-Trace application will start automatically.

Next steps

Create pinboard

To visualise your data, all you have to do is click the New pinboard icon. All pinned controls are preset for you!
For more information on pinboards, please check how to use pinboards.


Track and Trace pinboard