This guide will show you step by step how to transmit LoRaWAN packets using a longfi-arduino sketch on a Sparkfun Pro RF - LoRa.
{% hint style="warning" %} Before we begin, please make sure you've followed the steps from this guide, which goes over some initial steps to add your device to Console. {% endhint %}
In this guide, you will learn:
- How to setup your environment
- How to program a basic application that will send packets over the Helium Network
- Verify real-time packets sent to the Helium Console via Hotspot that's in range
For this example, you will need the following:
- Sparkfun Pro RF - LoRa
- Micro USB Type B Cable - Example
- Soldering Iron
- Small gauge wire
This step will cover adding an antenna and closing the LoRaWAN jumpers on this board.
You have two options for adding an antenna on this board.
U.FL Antenna: Connect any 915Mhz compatible antenna, for instance, this small, low cost antenna, to the U.FL port shown in the image below.
Wire Antenna: Solder a short wire(78mm in length for Americas) to the pin-out as shown below.
In order to fully communicate with the LoRa radio transceiver on the board, you'll need to close two jumpers on the underside shown below.
Download and install the latest version of Arduino IDE for your preferred OS.
The Sparkfun Pro RF requires two Arduino board support packages. Follow the instructions below to install both.
To install, open your Arduino IDE:
-
Navigate to (Tools > Boards > Boards Manager...)
-
Search for SAMD Boards (32-bits ARM Cortex-M0+)
-
Select the newest version and click Install
SparkFun SAMD Boards
To install, open your Arduino IDE:
- Navigate to (File > Preferences), (Arduino > Preferences) on MacOS.
- Find the section at the bottom called Additional Boards Manager URLs:
- Add this URL in the text box:
https://raw.githubusercontent.com/sparkfun/Arduino_Boards/master/IDE_Board_Manager/package_sparkfun_index.json
- Close the Preferences windows
Next, to install this board support package:
- Navigate to (Tools > Boards > Boards Manager...)
- Search for SparkFun SAMD Boards
- Select the newest version and click Install
To communicate with Helium's LoRaWAN network, we'll need to install an Arduino library.
To install, open your Arduino IDE:
- Navigate to Library Manager (Sketch > Include Library > Manage Libraries).
- In the search box, type IBM LMIC framework into the search, select the version shown below, and click Install.
This library requires that a config file be setup properly. After you have installed the IBM LMIC framework library, navigate to it's directory on your operating system found below. Next, replace the config.h file in this directory with this config.h file.
linux: /home/{user}/Arduino/libraries/IBM_LMIC_framework/src/lmic
windows: Documents/Arduino/libraries/IBM_LMIC_framework/src/lmic
mac os: Documents/Arduino/libraries/IBM_LMIC_framework/src/lmic
Now that we have the required Arduino board support and library installed, lets program the board with the provided example sketch.
To create a new Arduino sketch, open your Arduino IDE, (File > New). Next, replace the template sketch with the sketch found here, copy and paste the entirety of it.
Next we'll need to fill in the AppEUI, DevEUI, and AppKey, in the sketch, which you can find on the device details page on Console. Be sure to use the formatting buttons to match the endianess and formatting required for the sketch, shown below.
At the top of the sketch, replace the three FILL_ME_IN fields, with the matching field from Console, example shown below.
Next, we need to select the correct board to build for in the Arduino IDE. Navigate to (Select Tools > Board: > SparkFun SAMD21 Pro RF).
Next, we need to place the board into bootloader mode, which allows us to update it with new firmware. To do this, first plug the device into your computer, make sure the power switch is turned on (you should see a red LED on). Next, quickly double click the reset push button on the side of the board, you should see a blue LED come on now too. If you see this then you have successfully entered bootloader mode.
We're almost ready to upload our sketch, the very last step is to select the correct Serial port in the Arduino IDE. Navigate to (Tools > Port: Sparkfun SAMD21 Pro RF). You will also see either COM# or /dev/ttyACM# depending on whether you are on Windows, Mac, or Linux. If you do not see a port, please visit the Drivers section in Sparkfun's guide to make sure you have what's needed for your operating system.
We're finally ready to upload our sketch to the board. In the Arduino IDE, click the right arrow button, or navigate to (Sketch > Upload), to build and upload your new firmware to the board. You should see something similar to the image below at the bottom of your Arduino IDE, when the upload is successful.
When your firmware update completes, the board will reset, and begin by joining the network. Let's use the Serial Monitor in the Arduino IDE to view the output from the board. We first need to select the serial port again, but this time it will be a different port than the one we selected to communicate with the bootloader. Once again, navigate to (Tools > Port: Sparkfun SAMD21 Pro RF), but make sure the serial device, either COM# or ttyACM#, is different! Next navigate to (Tools > Serial Monitor), you should begin to see output similar to below.
Now let's head back to Helium Console and look at our device page, you should see something similar to the screenshot below.
Congratulations! You have just transmitted data on the Helium network! The next step is to learn how to use your device data to build applications, visit our Integrations docs here.