LWN Simulator

A LoRaWAN nodes' simulator to simulate a LoRaWAN Network.

General Info
Requirements
Installation
Tutorials
Publications and Citations

General Info

LWN Simulator is a LoRaWAN nodes' simulator equipped with a web interface. It allows to communicate with a real infrastructure LoRaWAN or ad-hoc infrastructure, such as Chirpstack.

The project consists of three main components: devices, forwarder and gateways.

The device

Based specification LoRaWAN v1.0.3;
Supports all LoRaWAN Regional Parameters v1.0.3.
Implements class A,C and partially even the B class;
Implements ADR Algorithm;
Sends periodically a frame that includes some configurable payload;
Supports MAC Command;
Implements FPending procedure;
It is possible to interact with it in real time;

The forwarder

It receives the frames from devices, creates an RXPK object including them within and forwards to gateways.

The gateway

There are two types of gateway:

A virtual gateway that communicates with a real gateway bridge (if it exists);
A real gateway to which datagrams UDP are forwarded.

Requirements

If you don't have a real infrastructure, you can download ChirpStack open-source LoRaWAN® Network Server, or similar software, to prove it;
If you have a real infrastructure, be sure that the gateways and LoRaWAN servers are reachable from the simulator.

Installation

From binary file

You can download it from the releases section the pre-compiled binary file.

Releases Page

From source code

Requirements

You must install Go. Version >= 1.16

Firstly, you must clone this repository:

git clone https://github.com/UniCT-ARSLab/LWN-Simulator.git

After the download, you must enter in main directory:

cd LWNSimulator

You must install all dependencies to build the simulator:

make install-dep

Now you can launch the build of the simulator:

make build

Finally, there are two modes to start the simulator:

from source (without building the source)

make run

from the built binary

make run-release

From docker

First, build the docker image:

docker-compose build

Then, run the built container:

docker-compose up

Configuration file

The simulator realises on a configuration file (config.json) which specifies some configurations for the simulator:

{
    "address":"0.0.0.0",
    "port":8000,
    "configDirname":"lwnsimulator"
}

address: specifies the IP mask from which the web UI is accessible.
port: the web server port.
configDirname: the directory name where all status files will be saved and will be created.