LoRaWan Starter Kit

Start your IoT project with Microchip Starter Kit

Buy your starter kit in our webshop

Overview and Scope

The intention of the Kit is to help developers, and entrepreneurs to start their LoRaWan project using Microchip module and Actilty ThingPark Wireless network server. Using this document, you should be able to connect both module and gateways to ThingPark Wireless network server and be able to send your first message.

Table of Contents

1     Create an account on THING PARK. 1
2     CONNECT YOUR GATEWAY. 3
3     SETUP THE SODAQ EXPLORER Board: 5
4     Activate your device. 8
4.1    Install LoRaWan sketch. 8
4.2    Create your device on your ThingPark Account 9
5     Using the Wireless Logger. 10
6     VISUALISING THE DATAS in CAYENNE. 13
7     DOCUMENTATION & USEFULL LINK. 13

Overview and Scope

The intention of the Kit is to help developers, and entrepreneurs to start their LoRaWan project using Microchip module and Actilty ThingPark Wireless network server.

Using this document, you should be able to connect both module and gateways to ThingPark Wireless network server and be able to send you first message.

 

1        Create an account on THING PARK

  1. Go to https://partners.thingpark.com
  2. Click on the “Try” button on top
  3. Fill out the form with all the required information

Note: The information given here need to be unique in our system otherwise the registration will fail.

  1. Click on “Create new account”
  2. An email should be sent at the given address.

 

 

 

You are now all set to start using the THINGPAK PARTNER PORTAL.

2        CONNECT YOUR GATEWAY

  • Open the box of the gateway.
  • Connect the Antenna
  • Connect the Ethernet cable to the gateway and your internet connexion.
  • Plug the power Supply to the gateway. That’s it.

Note: The Gateway comes completely configure: No manual work is needed
Contact Actility if the validation process is stuck.

– IP Backhaul: Ethernet. Wifi or LTE are not configured
– Gateway needs a DHCP server with dynamic address capability.
– Ports 21,22 and 2404 need to be open on your firewall

  1. Go to your ThingPark Account and select Network Manager.

  1. Look the back of the gateway and check for the serial code as bellow

Select the last 8 digits of the BS ID. In our case C0000195

  1. Under the “Add Base station” section, click on the “Create” button
  1. In the pop up dialog, enter the following information.
  • Identification code: select LRR ID
  • LRR ID: Enter BSD ID number
  • SMN: Put 0000-XX-0000-0000
  • Model: “Ufispace gateway picocell v1.5”

 

 

Note: This information need to be accurate or the Gateway will not be recognized by the system.

  1. Click on “Create” button to add the gateway.

The gateway will appear and the status will show as  “NEVER CONNECTED”

Wait few minutes and refresh the screen. The gateway should now highlight the version of the firmware and all other lines should be green. Alarm should be green and set to 1.

Congratulation, your gateway is up and running and ready to receive some packets.

3        SETUP THE SODAQ EXPLORER Board

  1. Download install and start the latest Arduino IDE for your operating system
    https://www.arduino.cc/en/Main/Software
  2. Prepare the Arduino IDE to be used with Sodaq board by:
  • Setting preferences
  • Installing Sodaq board
  • Installing Sodaq librairies
  1. Setting preferences:
  • Go to File→Preferences
  • Fill with URLs with following informations:

http://downloads.sodaq.net/package_sodaq_index.json
http://downloads.sodaq.net/package_sodaq_samd_index.json

  1. Installing Sodaq board
  • Go to Tools→Boards→Boards Manager…
  • Select SODAQ and install latest SAMD boards

  1. Installing Sodaq librairies
  • Go to Sketch → Include Library → Manage Library
  • Install the following library
  • SODAQ RN2483
  • SODAQ Wdt
  1. Configure the hardware board:
    • Select the SODAQ Explorer board: Tools→Boards→ “SODAQ ExploRer”
    • Connect the Explorer board to your PC using the USB cable

You are done. At this stage, the board is connected and you are ready to try the first sketch.

4     Activate your device

4.1   Install LoRaWan sketch

  1. From the Sodaq portal http://support.sodaq.com/sodaq-one/lorawan/ download the “Send Temperature with LoRaWan
  2. Make sure OTAA mode is selected
  3. Compile and run the program.

Please note the LoRa HWEUI as you will need it to provion your device

4.2   Create your device on your ThingPark Account

  1. In the Device Manager, click on “Devices” in the left-hand side section
  2. Under the “Add devices” section, click on the “Create” button

  1. In the pop up dialog, enter the following information:
    1. Administrative data:
      • Device Name: “MicroChip Explorer”
    2. Device identification:
      • Device activation: “Activation By Personalisation (ABP)”
      • DevEUI: Obtained by the sketch
      • DevAdrr: Use the last 4 bytes of the DevEUI
      • NwkSKey: Paste here the DevEUI twice
      • AppKey: Paste here the DevEUI twice
      • Device profile:
        1. RN2483A:
          LoRaWAN 1.0 – class A – ETSI – Rx2_SF12
        2. RN2903A:
          LoRaWAN 1.0 – class A – FCC – Rx2_SF12
  2. Network parameters:
    • Connectivity plan: select the default plan to allow for device activation
      1. Application layer handling:
    • Select the default Application server routing profile

Note: This information need to be accurate otherwise the device will not be recognized by the system. Please make sure they are accurate.

  1. Click on “Create” button to add the device
  2. Click on the “List” tab then on the “Search” button
  3. The device should be in the list now
  4. Go to the Arduino sketch
  5. Set OTAA to false
  6. Update the DevAddr, NwkSkey, AppSKey
    Example: DevAddr 11223344 → 0x11, 0x22, 0x33, 0x44
  7. Compile and upload to the Explorer

5        Using the Wireless Logger

  1. On the computer, from the partner portal dashboard, launch the Wireless Logger using the link on the left-hand side menu

Note: The Partner portal dashboard is https://partners.thingpark.com/en/dashboard.

  1. The Wireless Logger should display a list of all the packets it has receive from the list of devices registered under this subscriber account. Since only one is currently registered, it should display only the packet from this device
  2. The Wireless Logger embedded a set of built in decoders to display most MAC commands being sent, in this case the JoinRequest
  3. Expanding the messages allows to see more specific information about the radio signal parameters for each gateway that received the message.
  4. The DevAddr is empty because at this stage, the device does not have a DevAddr. The next uplink will then use the network allocated DevAddr.
  5. On the device, click on the button, the device should send a new uplink.
  6. On the Wireless Logger, click on the “Refresh” button
  7. In the updated list, check that a new packet has been received.

6        VISUALISING THE DATAS in CAYENNE.

Cayenne is a very nice Application server which will allow you to visualize the data coming from the device. To do so, you need to setup a free account on https://mydevices.com/

Once done,  follow the instructions in Cayenne to setup the correct routing profile and application server:

7        DOCUMENTATION & USEFULL LINK

For more information please refer to

Sodaq:

Actility:

  • Actilty partner portal https://partners.thingpark.com/ to log to your network server
  • FAQ for devices and gateways common questions: https://partners.thingpark.com/en/dashboard/faq
  • Advanced user guide for detailed description of the tools

https://partners.thingpark.com/sites/default/files/2017-11/AdvancedThingParkDeveloperGuide_V4.pdf