IIoTGateway

IIoTGateway is a protocol bridge platform that enables reading from and writing to Modbus RTU devices through the MQTT protocol, allowing Modbus networks to be seamlessly integrated into modern monitoring and control systems.

The platform is delivered as a custom Linux distribution built with Buildroot for Raspberry Pi devices, where all required applications are pre-integrated and ready to run. It combines the protocol gateway, a web-based management interface, and the underlying operating system into a single solution, making deployment straightforward and consistent.

---

Features

• Modbus RTU read and write support
• MQTT-based data publishing and control
• Web-based dashboard for configuration and monitoring
• Embedded Linux distribution built with buildroot
• Targeted for Raspberry Pi hardware

---

Requirements

These requirements apply only to the development environment, not to the target Raspberry Pi system.

Toolchain

• GCC ≥ 11.4.0
• CMake ≥ 3.20
• Python ≥ 3.10.12

Dependencies

• Emscripten 3.1.56
• Qt 6.8.3
  • Desktop
  • WebAssembly (single-threaded)
  • Modules:
    • Qt HTTP Server
    • Qt Serial Bus
    • Qt Serial Port

Libraries

• googletest v1.16.0 (via CMake FetchContent)
• paho.mqtt.cpp v1.5.1 (via CMake FetchContent)

#TODO Provide docker images for cross-compilation and WebAssembly builds.

---

Project Structure

.
├── dashboard   # Web-based UI for configuration and monitoring
├── distro      # Buildroot-based embedded Linux distribution
└── gateway     # Core service (Modbus ↔ MQTT bridge

• dashboard: Browser-based interface for system configuration and operation
• gateway: Core application responsible for protocol translation and device communication
• distro: Custom Linux image for Raspberry Pi, bundling the gateway and dashboard

Architecture diagram:

---

Documentation

• Modbus Request Structure
• Dashboard Default Settings

---

Building

The default build targets a Raspberry Pi 3.

To run a default build of the IIoTGateway platform:

python3 build.py --default

This will execute the full build using the default configuration for the Raspberry Pi 3.

Additional command-line options are available to customize the build process (e.g., cleaning artifacts, adjusting parallel jobs, or skipping components). Use --help to see all available options:

python3 build.py --help