loudify

Running a GNU Radio flowgraph in a ZMQ client <-> broker <-> worker setup.

Loudify: LoRa cloudified

Explore the docs »

Report a bug Request a feature

Summary

This project consist of three different parts namely the client that is running a GNU Radio flowgraph, the worker receiving the data and doing the actual demodulation process and the broker connecting the two together. This repo holds the code for all the parts, be sure to check out gr-lora_sdr to see how this codes integrates into GNU Radio.

Docs

Documentation is built automatically on commits, and can be visited by going to docs

Why

This project together with the GNU Radio code located in gr-lora_sdr is part of my graduation project which is called a Centralized Radio Acces Network gateway for LoRa. Its purpose is to research if it is possible to be able to aggregate LoRa packets originating from different LoRa gateways by making a central point (aka the broker) that all gateways can connect to. The overall high level idea is to let LoRa gateways share information on the reception of their signals.

Installing

Installing the project can be done in two ways, by installing the normal PyPi release

pip install loudify

Or by installing directly from the repo either by doing pip git install

pip install git+https://github.com/martynvdijke/loudify.git

Or by cloning the repo and running flit install

pip install flit
git clone https://github.com/martynvdijke/loudify
cd loudify
flit install

Architecture

For a more detailed overview of the entire architecture and to be able to see how everything is connected visit architecture

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Make sure to add or update tests as appropriate.

Acknowledgments

This project builds upon the example source code from zguide under the MIT license.

Changelog