documentation

Setting-up and Operating LoRa Edge Trackers

Semtech’s LoRa Edge Tracker Reference Design is shipped in airplane mode in order to not transmit while in transport. This section provides instructions for offsetting-up the device, pairing it with its initialization phone application and connecting to the services it supports.

Download and Install LoRa Edge Config to Your Smartphone

The first step in setting up your devices is to download, install and run the Bluetooth smartphone application that enables the initial configuration of the LR1110 Tracker device. The LR1110 Tracker application is available on Google Play for Android under the name LoRa Edge™ Config.

Create a QR Code for the Device & Application Services Token

  1. Login to the LoRa Cloud portal (https://loracloud.com)
  2. Navigate to LoRa Cloud™ Device & Application Services > Manage Tokens
  3. Copy the value of your created token
  4. Create a QR code using the https://www.qr-code-generator.com/ tool (or something similar -  https://www.qrstuff.com/)
    1. Select the “text” option

Figure 37: Example from QR-Code-Generator.com

Set up Your Tracker

Once the application is downloaded to your phone, perform the following steps:

  1. Open the LoRa Edge Config application, click on the menu icon () then on
  2. Allow the LoRa Edge Config app to access photos, media and files, and your devices
  3. Click Yes on the pop up LoRa Cloud authentication token not set. Do you want to set it now?
  4. Allow LoRa Edge Config to take pictures and record video and then scan your QR code, which was previously generated  (see Create a QR Code for the Device & Application Services Token)
  5. Once done you scan the QR code, the Almanac will be fetched automatically
  6. Go to the Settings page in the mobile app
  7. Under Inspector, change the Inspector mode from Basic mode to Advanced mode
  8. In the FUOTA section of the Settings page, scan your token QR code (if not done in Step 4 above)
  9. Go back to the LoRa Edge Config Start page
    1. Click on the Start Scan icon  and allow LoRa Edge Config to access the configuration parameters of your tracker.
    2. Immediately, put your LoRa Edge Tracker in BLE mode by placing the provided magnet (with the notch-side down) against the oval hole on the device, and then place the flat side of the magnet directly against the device. This should cause a red LED to light up.

Figure 38: Tracker in BLE Mode

  1. At this point, the LoRa Edge Tracker is in pairing mode (the red light is blinking):
    • The device stays in advertising mode for 30 seconds before leaving this state
  2. Go back to the LoRa Edge Config smartphone application

    • On the Scanner page your LoRa Edge Tracker should be displayed, as illustrated in Figure 37:

 

Figure 39: Tracker Detected by Application

Note: the four last digits of the Tracker ID are the DevEUI LSB, which must be the same as the DevEUI printed on the tracker’s label

  1. Connect the LoRa Edge Tracker with the application
    • The red LED is fixed once the connection established.
    • There is a connection timeout of two minutes. This timeout is refreshed after each action a user initiates in the smartphone app.
    • There is an overall connection timeout of five minutes.
  2. Once connected, on the Settings page in the app, complete the following steps in order. (Make sure you’ve enabled Advance Mode, as noted above, to be able access these options.)

    • Under Version and FUOTA:
      • Update your application firmware (if a new version is available) by clicking on Update application firmware
      • Update the LoRa Basics™ Modem-E modem firmware (if a new version is available) by clicking on Update LoRa Basics™ Modem-E firmware
    • Under GNSS:

      • Update almanac by clicking Update almanac
      • Set your GNSS assistance position by entering the Latitude and Longitude coordinates for the physical location of the LR1110 tracker that is being configured.  The Latitude and Longitude coordinates can be found via google maps or other on-line tool.  See LR1110 documentation for a full explanation of assisted GNSS.
    • Under Miscellaneous:

      • Disable Airplane mode
    • Under LoRaWAN® select one of the following options:

      • Semtech derive keys algorithm used Enables Semtech Join Server mode

Note: You will need the DevEUI, JoinEUI, and PIN in order to claim the device (see Claiming a Device above) to register your device with the LoRa Cloud™ Device Join service

Figure 40: Device EUI, JOIN EUI, and PIN code displayed in BLE Application

 

  • Disconnect the app from the LoRa Edge Tracker by clicking on the left-arrow icon:

Note: When you navigate away from the configuration page, the app automatically disconnects from the LoRa Edge Tracker

  • Reset the tracker

Note: When the LoRa Edge Tracker is reset, the BLE mode begins again and lasts 30 seconds

  • The LoRa Edge Tracker application starts and will attempt to join and transmit packets over the ThingPark Community Platform (network server) and send to Tago.IO. Please log into your ThingPark Community Platform and TagoIO accounts to verify you see transmissions coming from your device.
  1. On the mobile application, when asked for LoRa Cloud Authentication, allow the app to take a picture of your created QR code

Figure 41: Set LoRa Cloud Authentication Token

Application Features and Functions

The mobile application has a number of features and functions. It can update both the LoRa Edge Tracker application firmware on the device and the modem firmware. If there are updates for either, the mobile device application will indicate that updates are available in the Versions and FUOTA section of the Settings page.

The Versions and FUOTA section displays the installed versions of the LoRa Edge Tracker Reference Design, as well as LoRa Basics Modem-E firmware.

Note: If the update buttons are greyed-out, no version updates are available.

Figure 42: Settings page; Versions and FUOTA Section

If you want to use GNSS estimation for the tracker, you must check the GNSS feature box to enable it. Enabling the GNSS feature will also update the almanac.

Note: You might need to scroll down past the LoRaWAN section on the screen:

Figure 43: GNSS Settings

You can set the device to receive assistance information at your approximate location.

Note: The input will take “+” for positive latitude (North) and “-“ for negative latitude (South). Similarly for positive longitude use “+” for positive (East) and “-“ for negative (West). The display will ALWAYS should “N” or “E” after latitude or longitude respectively, even if you are at Southern latitudes or Western longitudes. The “-“ sign however, takes precedence. To facilitate the assistance position set you can use Set GNSS assistance position with last known location.

Figure 44: GNSS Assistance Position

 

To enable Wi-Fi scanning, you must check the Wi-Fi Feature box, as illustrated in Figure 45:

Figure 45: Wi-Fi Settings

You can also change a variety of Wi-Fi scan settings with the application including, the number of retries, the maximum number of returned APs, the Wi-Fi type, and the Wi-Fi timeout in milliseconds.

In the Miscellaneous section of the application you can control a variety of features including Airplane Mode, Use accelerometer, the regular and low TX duty cycles, and a full reset of the device.

Figure 46: Miscellaneous Settings