/LWN-Simulator

A LoRaWAN nodes' and network simulator that works with a real LoRaWAN environment (such as Chirpstack) and equipped with a web interface for real-time interaction.

Primary LanguageGoMIT LicenseMIT

LWN Simulator

Build Status GitHub license made-with-Go GitHub go.mod Go version of a Go module GitHub release

A LoRaWAN nodes' simulator to simulate a LoRaWAN Network.

Table of Contents

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.

dashboard

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.

Tutorials

English

Coming Soon

Italian

Coming Soon

Arabic (thanks to IdealBit)

How to Install on Linux or WLS

How to Install on Windows

How to use LWN Simulator with ChirpStack

Publications and Citations

Lightweight Root Key Management Scheme in Smart Grid IoT Network based on Blockchain Technology