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