WiSH WalT Framework

This markdown contains instructions for WiSH WalT Framework. For more details about the framework, please refer to our paper at [WiSH-WalT: A Framework for Controllable and Reproducible LoRa Testbeds] (https://hal.archives-ouvertes.fr/hal-01835904/document).

There are five core elements of the project:

  • LoRa STM32 module with our custom application
  • WiSHfull local controller change radio parameters for connected mote
  • WiSHfull global controller to control local controllers
  • The Things Network server
  • The Things Network Client to download data (optional)

We provide source code and examples for our application.

LoRa Mote application

You can find LoRA application on the following [link] (https://gricad-gitlab.univ-grenoble-alpes.fr/Drakkar-LIG/WiSHFUL-LoRa-connector/tree/master/code/Projects/Multi/Applications/LoRa/End_Node)

This code needs to be copied on the board for the project to work. You can use pySerial or directly copy, paste the code on the USB drive which appears after you plugin the module.

WiSHFul Local and Global controllers

To change the radio parameters you need WiSHfull framework, you can read more about the project [here] (http://www.wishful-project.eu/documents).

For our project, you need have LoRa UPI's installed, you can build the project from our source code and they will be installed automatically.

We also provide tutorial for getting started [here] (https://gricad-gitlab.univ-grenoble-alpes.fr/Drakkar-LIG/WiSHFUL/tree/master/examples/Get_Started_Examples/LoRaWan_Example). It discusses in details the changes required and examples for global and local controllers.

TTN Client

We used TTN server for our experients. We provide a [script] (https://gricad-gitlab.univ-grenoble-alpes.fr/Drakkar-LIG/WiSHFUL/tree/master/examples/Get_Started_Examples/LoRaWan_Example/ttn-client) to download data from TTN server. It can be run as a background process to download packets sent to TTN server, as the server does not store any packets.

Walt Images

Finally, we also provide following walt images with wishful framework already installed and configured:

  • wishful-global-controller
  • wishful-local-controller

For the WiSHFUL experiments you can clone wishful-global-controller and wishful-local-controller Walt images. The former is a X86 image and should be booted either by physical hardware or by a virtual node.

$ walt image clone wishful-global-controller

The later is a raspberry pi image and should be booted by a raspberry pi node.

$ walt image clone wishful-local-controller