npettiaux / atomit Goto Github PK

The Atom-IT server is a lightweight, cross-platform, RESTful microservice for Internet of Things (IoT) applications.

The Atom-IT server provides a simple framework to define IoT workflows through configuration files. Its small footprint makes it usable on most hardware architectures, from the Raspberry Pi to cloud systems. Its simplicity also makes it a valuable candidate to showcase IoT networks as a vendor-neutral pedagogical platform.

The software comes out-of-the-box with the following features:

• Centralization of time series coming from multiple data sources and different network protocols.
• Built-in Web server that can be used to receive messages from callbacks provided by professional IoT networks (such as Sigfox and Proximus MyThings).
• Lua scripting to transcode packets.
• Support of the MQTT protocol, both as publisher and subscriber, which can be used to receive messages from The Things Network broker.
• Support of the IMST iC880A board to setup standalone LoRa gateways with a Raspberry Pi.
• Decoding of LoRa packets.
• HTTP POST client in order to transmit messages to other IoT systems.
• Built-in REST API that can be used to drive the server from external heavyweight software, from scripts, or from Web applications.
• Export and import to/from files (notably in the CSV file format).
• Long-term storage of messages within SQLite databases.

The server also features a simple Web interface in order to explore the content of its database.

• Quick Start
• Usage:
  • Compilation
  • Basic concepts
  • Configuration
  • Available filters
  • Lua scripting
  • REST API
• Samples of IoT workflow:
  • Connecting to Proximus MyThings
  • Connecting to Sigfox
  • Connecting to The Things Network
  • Standalone LoRa gateway

If you don't find an answer to some question in this documentation, please ask the official discussion forum!

The Atom-IT server is provided as free and open-source software licensed under GPLv3+ courtesy of WSL. WSL is the key partner of techno-entrepreneurs in the Walloon region of Belgium. The Atom-IT server was created as a shared platform to support the Atom-IT project by WSL.