This project implements an Industrial IoT Gateway in modern C++23, designed to run on an embedded Linux system built with Yocto.
The gateway collects data from sensors (via UART, I²C, SPi, CAN, Modbus, OPCUA), processes it locally, and publishes telemetry to the cloud using TCP/IP and MQTT.
https://github.com/ShayanEram/MPU_Gateway-Yocto
- Multithreaded sensor acquisition and processing
- Asynchronous networking (TCP/IP, MQTT)
- Modular OOP architecture with hardware abstraction
- RAII‑based resource management and smart pointers
- Templates for thread‑safe queues and ring buffers
- File I/O for telemetry logging and configuration
- OTA update checker with async execution
- Yocto recipe + systemd integration
gateway-project/
├── CMakeLists.txt # Build configuration
├── include/ # Public headers
│ ├── GatewayController.hpp # Orchestrates all managers
│ ├── SensorManager.hpp # Manages I2C/UART/PWM sensors
│ ├── DataProcessor.hpp # Processes raw sensor data
│ ├── CommManager.hpp # Handles MQTT/TCP/IP comms
│ ├── Logger.hpp # File logging & telemetry
│ ├── OTAUpdater.hpp # OTA update checks
│ ├── hw/ # Hardware abstraction layer
│ │ ├── UARTPort.hpp # RAII wrapper for UART
│ │ ├── I2CDevice.hpp # RAII wrapper for I2C
│ │ ├── PWMController.hpp # PWM control
│ │ └── SocketClient.hpp # TCP/IP client
│ └── utils/ # Utilities & templates
│ ├── MessageQueue.hpp # Thread-safe queue (templates)
│ ├── RingBuffer.hpp # Circular buffer (templates)
│ ├── ThreadSafeQueue.hpp # Producer-consumer queue
│ └── RAIIHandle.hpp # Generic RAII resource wrapper
├── src/ # Implementations
│ ├── main.cpp # Entry point
│ ├── GatewayController.cpp # Lifecycle management
│ ├── SensorManager.cpp # Sensor polling threads
│ ├── DataProcessor.cpp # Filtering, AI inference
│ ├── CommManager.cpp # MQTT/TCP client logic
│ ├── Logger.cpp # File I/O logging
│ ├── OTAUpdater.cpp # Async OTA logic
│ └── hw/ # HAL implementations
│ ├── UARTPort.cpp
│ ├── I2CDevice.cpp
│ ├── PWMController.cpp
│ └── SocketClient.cpp
├── tests/ # Unit & integration tests
│ ├── test_SensorManager.cpp
│ ├── test_CommManager.cpp
│ ├── test_DataProcessor.cpp
│ └── mocks/ # Mock hardware
│ ├── MockUART.hpp
│ ├── MockI2C.hpp
│ └── MockSocket.hpp
├── configs/ # Config files
│ └── gateway_config.json # Defines sensors, comms, logging
├── scripts/ # Helper scripts
│ ├── run_gateway.sh
│ └── ota_update.sh
├── docs/ # Documentation
│ ├── architecture.md # Class diagram & thread flow
│ ├── design_patterns.md # Observer, RAII, Producer-Consumer
│ └── usage.md # How to run & extend
└── yocto/ # Yocto integration
└── recipes-gateway/
└── gateway/
├── gateway_1.0.bb # Yocto recipe
└── files/
├── gateway.service # systemd unit
└── default.conf
- GatewayController → Starts/stops all managers, coordinates lifecycle.
- SensorManager → Polls sensors (UART/I²C/PWM), pushes data into
ThreadSafeQueue<SensorData>. - DataProcessor → Consumes queue, applies filters/AI, forwards to CommManager + Logger.
- CommManager → Publishes data via MQTT/TCP, handles retries, optional local TCP server.
- Logger → Logs telemetry to CSV/JSON, rotates logs, supports log levels.
- OTAUpdater → Async check for updates, downloads, validates, triggers system update.
- HAL (UARTPort, I2CDevice, PWMController, SocketClient) → RAII wrappers for hardware access.
- Utils (MessageQueue, RingBuffer, RAIIHandle) → Templates and resource management helpers.
- Tests → GoogleTest unit tests with mocks for hardware.
cd /MPU_Gateway
mkdir -p build/External/paho.mqtt.c
mkdir -p build/External/paho.mqtt.cpp
cmake -S External/paho.mqtt.c -B build/External/paho.mqtt.c \
-DPAHO_WITH_SSL=ON \
-DPAHO_BUILD_STATIC=ON \
-DPAHO_BUILD_SHARED=OFF \
-DPAHO_ENABLE_CMAKE_CONFIG=ON
cmake --build build/External/paho.mqtt.c --parallel
cmake --install build/External/paho.mqtt.c --prefix External/paho.mqtt.c/install
cmake -S External/paho.mqtt.cpp -B build/External/paho.mqtt.cpp \
-DPAHO_BUILD_STATIC=ON \
-DPAHO_BUILD_SHARED=OFF \
-DPAHO_WITH_MQTT_C=OFF \
-DCMAKE_PREFIX_PATH=$PWD/External/paho.mqtt.c/install
cmake --build build/External/paho.mqtt.cpp --parallel
cmake --install build/External/paho.mqtt.cpp --prefix External/paho.mqtt.cpp/install
cd External/libmodbus
./autogen.sh
./configure --prefix=$PWD/install
make -j4
make install
cd MPU_Gateway
cmake --preset Debug (Release)
cd build
cmake ..
make
cmake --preset Debug (Release)
Build
Run
./gateway --config ../configs/gateway_config.json- Add
yocto/recipes-gateway/to your Yocto layer. - Build image with:
bitbake core-image-minimal- Setup project skeleton → CMake, folders, headers.
- Implement HAL → UART, I²C, PWM, Socket RAII wrappers.
- Build SensorManager → Poll sensors, push to queue.
- Add DataProcessor → Consume queue, filter/process data.
- Implement CommManager → TCP/IP + MQTT client.
- Add Logger → File I/O, operator overloading for
SensorData. - Add OTAUpdater → Async update checker.
- Integrate GatewayController → Orchestrate all modules.
- Write Unit Tests → GoogleTest with mocks.
- Yocto Recipe → Package app + systemd service.
- Docs → Architecture diagram, design patterns, usage guide.
- OOP: Modular managers, inheritance for sensors.
- Multithreading: Sensor threads, comm threads, OTA async.
- Templates: Generic queues, buffers.
- RAII: Resource wrappers for hardware.
- Smart Pointers: Ownership management.
- Async: OTA updates, logging.
- Operator Overloading: Logging
SensorData. - Constexpr & Enums: Compile-time constants, scoped IDs.
- Design Patterns: Observer, Producer-Consumer, Singleton, RAII.