Leading Analog & Mixed Signal Products

Site Help

This website provides a locally accessible hub for your LoRa trial. Once your LoRa packet forwarder is pointing here you will be able to do the following things (depending on the type of LoRaMote you’re using):

  • Commission motes;
  • Control their basic functions;
  • Track their location;
  • Create new applications to group your motes;
  • Plot & download performance statistics and application data

More Help

If you have any trouble using this website or your LoRa hardware, please get in touch with your Semtech contact or visit the LoRa Community.

Topics

  1. Getting Your Motes on the Site
  2. Motes
  3. Gateways
  4. Network Map
  5. Applications

Getting Your Motes on the Site

You will need to direct your packet forwarder (gateway) to here if it is not already. The method to do this varies with gateway, but the common details are as follows:

Host:
127.0.0.1
Port:
1680

For the basic packet forwarder included with the LoRa starter kit, you will need to modify the file local_conf.json (or global_conf.json if that doesn’t exist) to include the following lines:

"server_address": "127.0.0.1",
"serv_port_up": 1680,
"serv_port_down": 1680

Be sure to restart your packet forwarder for any changes to take effect.

A mote may be automatically picked up by the website (see ‘Personalised Motes’) otherwise you must register it before it will appear on the network. Registering a mote can be done from the main motes page; the details you need to supply depend on whether the device is configured for personalised or over-the-air activation. In either case you can add the mote to an existing application or to a new application which you can create as part of the mote registration. Go to the main motes page and enter the details under the heading ‘Add a Mote’.

Personalised Motes

Your mote has a default application session key, network session key and device address (four bytes). If the session keys are unchanged, then when you activate your mote and have it picked up by your gateway, the mote will be registered with the website automatically and assigned to application 00-00-00-00-00-00-00-00 (‘defaultApp’). It will then be listed with the programmed device address and an EUI (8 bytes) equal to the device addresses padded with zeros.

If you have changed the mote’s session keys or the mote is not a demonstration LoRaMote then then you will need to register it. Go to the main motes page and at the top under the heading ‘Add a Mote’ type in the mote’s 4-byte address and select the application from the drop-down on the right. Expand the heading ‘More mote options’ and fill in the fields Application session key and Network session key in addition to Address. Click Add.

Over-the-Air Motes

Motes can join the network via over-the-air protocol. In this case your mote is programmed with a device EUI (eight bytes) and an application key, and also the EUI of its application. Go to the main motes page and at the top under the heading ‘Add a Mote’ expand the heading ‘More mote options’. Select Activation: Over-the-air and fill in the fields EUI and Application key. Select the mote’s application from the drop-down on the right. If the application’s EUI cannot be seen in the list then you will have to add it: select New from the drop-down and fill in the fields that appear below it.

When you activate your mote and have it picked up by your gateway, the mote will be registered with the website on the application you specified, and will have a device address (four bytes) dynamically assigned to it.

Motes

The main motes page lists the motes which are active on the network and those which have been active in the past. Here it is possible to view the last gateway on which each mote was detected, and what the most recent frame was, including its raw data as a hexadecimal string. The table can be sorted by many of its columns, so you can view by date or by mote EUI for example.

Clicking on a mote’s EUI will bring up the mote summary page. Depending on the type of mote, several statistics and parameters will be visible. LoRaMotes shipped with the LoRa starter kit and configured for GPS demo mode will report back their location and environment, and this can be seen on the details page. There is also a graph of these factors over the last 24 hours.

If you have added some motes to the site and they are not appearing in the list, check your gateway’s logs to make sure it is forwarding frames from the motes, and ensure the gateway can communicate with the server on port 1680.

Obtaining Mote Data

The data received from the mote can be viewed on the website. To access it go to the mote’s details page and look for the application name in the summary box. Clicking the table icon (Table icon) will take you to the data received from the mote on its current application. You can expand the drop-down ‘Previous applications’ to see the mote’s previous applications and view their data instead. Alternatively, you can click the link ‘View all mote data’ to view everything the mote has transmitted.

You can download the data in CSV format by expanding the Download Data heading by clicking on it, then entering either a date range over which to download data or the number of most recent records you want. You can optionally enter the EUI of a gateway by which you wish to filter. Click Download to receive the file.

The downloaded data will be ordered by descending time starting with the most recent frame.

Gateways

The gateways page lists the gateways that have forwarded frames from motes on the network. Gateways that are live but have not received anything from any motes are not listed. You can view details of a gateway (including its location and a table of recent activity) by clicking on its EUI.

Network Map

The network map shows the location of gateways and motes. On the left of the page are two tabs: Motes and Gateways. Each tab displays a list of the items in question, and the Gateway tab also includes a form to retrieve the historical data of one or all motes in a given time window and plot this on the map.

Only LoRaMotes configured for GPS demo mode and returning valid GPS data are displayed on the map. All gateways will appear on the map, but they may not have known GPS co-ordinates. If you know a gateway’s location you may enter the latitude and longitude for it in its box on the left. These settings are not persistent and will reset after you close your browser.

Applications

Applications can be created and configured. Go to the Applications section of the site and you will see a list of your existing applications and the number of motes that have been configured on them. Click on an application’s name to go to its summary page, where you can see a table of recent mote activity and a link to all data received from the motes. Click on the number in the Configured Motes column to go to the mote configuration page where you can prepare the network to accept frames from motes.

Creating Applications

Creating an application can be done at the same time as adding a mote (see ‘Getting Your Motes on the Site’, above) or as a separate task from the main applications page. Simply enter a name and owner for the application along with an EUI. This EUI must be globally unique; upon pressing the Add button and submitting the form, you will be informed if the EUI has already been used. The owner column can be used to supply a label to help you group associated applications. Neither the application name nor owner can contain any spaces.

Obtaining Application Data

The data received from the motes on an application can be viewed on the website. To access it go to the application’s details page and click ‘View data from all motes’. Alternatively, you can view the data received from individual motes by clicking the table icon (Table icon) next to their EUI.

You can download the data in CSV format by expanding the Download Data heading by clicking on it, then entering either a date range over which to download data or the number of most recent records you want. You can optionally enter the EUI of a gateway by which you wish to filter. Click Download to receive the file.

The downloaded data will be ordered by descending time starting with the most recent frame.

Inline Logs