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] (hhttps://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](https://gricad-gitlab.univ-grenoble-alpes.fr/Drakkar-LIG/WiSHFUL/tree/master/examples/Get_Started_Examples/LoRaWan_Example/pyserial/pyserial-master) 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](https://gricad-gitlab.univ-grenoble-alpes.fr/Drakkar-LIG/WiSHFUL/tree/master/upis/wishful_upis/lora) 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:
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.
@@ -6,3 +47,4 @@ The former is a X86 image and should be booted either by physical hardware or by
The later is a raspberry pi image and should be booted by a raspberry pi node.