Lorawan-test-device

This repo shows hardware and software configurations to build a device used to test Lorawan on WSN or rpi_lorawan WSN modules.

Table of Contents

1. Features
2. Hardware Needed
3. Assembling The Device
4. Installing Software
5. Connect MKR WAN 1310 to Computer

1. Future Work

TODO: Add section about getting the deveui of the mkrwan. Use a setup.ino file that prints deveui?

Features

• Waits to perform the test until a button is pressed.
• Sends a join request to lorawan network then a packet. If both are succesful shows a pass in the display.
• Shows a fail in the display if join request or packet sending are not succesful.
• Shows a loading animation in the display while the test is being performed.
• You can use the device to test multiple gateways by ensuring that the Lorawan Network servers (Chirpstack) are configured with the same App key and deveui as the device.
• Compatible with our lorawan testing script.

Hardware Needed

• Micro USB Wire (other end must be able to connect to your computer)
• Arduino MKR WAN 1310
• Male/Male Jumper Wires
• Breadboard
• OLED Display

TODO: Add button you end up using

Assembling The Device

TODO: include instructions on how to build it

Installing Software

1. To connect to the MKR WAN 1310 board, you will need to install the Arduino IDE

2. Once you installed the IDE, you need to further install the board's software support by following the SAMD21 core for MKR boards Documentation

   

3. You will also need the library for mkrwan. Under Library Manager, look up "mkrwan" and install MKRWAN by Arduino.

   

   NOTE: At the time of configuring the board MKRWAN_v2 was not used because of bug issues related to the library.

4. Two Arduino libraries must be installed to start using the display. The SSD1306 driver library is used to initialize the display and provide low level display functions. The GFX library provides graphics functions for displaying text, drawing lines and circles, etc. Both these libraries are available from Adafruit.

   NOTE: if these two libraries are not found in the library manager, you can also follow this tutorial

5. Install the SSD1306 Driver Library. Under Library Manager, look up "Adafruit SSD1306" and install Adafruit SSD1306 by Adafruit.

   

6. Install the GFX Library. Under Library Manager, look up "adafruit gfx library" and install Adafruit GFX Library by Adafruit.

   

7. An additional library must be installed to get "i2c header", look up "Adafruit BusIO library" and install Adafruit BusIO by Adafruit.

   

Connect MKR WAN 1310 to Computer

1. Connect the board to your computer with the Micro USB wire

   • You should see a green light glow on the board

2. Go to Tools in Arduino IDE and select Board then select Arduino SAMD Boards (32-bits ARM Cortex-M0+) for the type of board. Finally select Arduino MKR WAN 1310 for the board as shown:

   

3. Then select the correct serial port for the arduino as shown:

   

   NOTE: If Arduino MKR WAN 1310 is not showing up, pressing the "RST" (reset) button twice in quick succession will put the board in bootloader mode. Instead of running a sketch the Arduino will wait until a sketch is uploaded helping the board to show up in your Arduino IDE.

Future Work

• Configure to use LED if display is not detected.
• include instructions on how to connect the hardware