Iot aio

OSIGBApp

Open-Source Internet of Things (IoT) Gateways for Building Automation Applications

This repository will be populated in course of a journal publication (see publications section down below).

General

The IoT gateways are designed to operate as an interface for legacy components in building automation systems and IoT-based applications, e. g. connecting to cloud services via IoT protocols communication like MQTT.

To this end, this repository contains the relevant schematics and PCB design to obtain the interfacing hardware allowing to digitize and convert signals from sensors or to actuators. Here, the following signals are supported:

• Analog communication (0-10 V, 0-20 mA)
• Resistive measurements of passive RTD-probes (2,3,4-wire)
• Digital communication via RS-485/EIA-485 (for instance used in serial Modbus RTU or BACnet MS/TP communication)

Core component of the gateways is the ESP32 microcontroller. Hence, the firmware was developed using the Espressif IoT Development Framework ESP-IDF, which is the official development framework provided by the manufacturer for the ESP32 chip. Accordingly, the developed firmware is provided as well in this repository. In order to ease use and operation of the gateways, we further provide a documentation. Finally, a performance analysis has been conducted comparing the measurement performance with a conversion via a PLC.

Documentation:

• The user Manual "how to operate the gateways" can be found here.

• For using the software, ESP-IDF is needed. We also recommend to use VScode with the ESP-IDF extension for programming.

• Furthermore, tips for using the Menuconfig with this software can be found in the Wiki of the repository.

• All functions in the code are commented and a documentation is generated with Doxygen. The result can be found in the DOC folder. You have to clone the repository and open doc/doxygen/html/index.html to view the complete documentation.

• Documentation on how to build the Aio Configurator webpage can be found here: AIO Configurator

  • The IoT-AIO Configurator is a web page that uses HTML forms to configure the IoT Wireless Adapter. The source code and documentation can be obtained here:
    • Configurator Request
    • Configurator Response

• Further developement Ideas, by Carlo Guarnieri can be found here: Developments

Terms of use

All content provided in this repository is released under the MIT License. If any of the content provided is used, please give credit by referencing the related publication, as decribed in the subsequent section.

Publications and referencing

We kindly ask all publicly disseminated projects employing components of the IoT gateways to cite the following paper:

• Schraven, Markus Hans, Kai Droste, Carlo Guarnieri Calò Carducci, Dirk Müller, and Antonello Monti. 2022. "Open-Source Internet of Things Gateways for Building Automation Applications" Journal of Sensor and Actuator Networks 11, no. 4: 74. https://doi.org/10.3390/jsan11040074

Previous development stages are documented in:

• M.H. Schraven, C. Guarnieri Calò Carducci, M.A. Baranski, D. Mueller, A. Monti, “Designing a Development Board for Research on IoT Appli-cations in Building Automation Systems,” 36th International Symposiumon Automation and Robotics in Construction (ISARC 2019), Banff,Canada, 2019, pp. 82-90, DOI: 10.22260/ISARC2019/0012
• C. Guarnieri Calò Carducci, A. Monti, M. H. Schraven, M. Schumacher and D. Mueller, “Enabling ESP32-based IoT Applications in Building Automation Systems,” 2019 II Workshop on Metrology for Industry 4.0 and IoT (MetroInd4.0&IoT), Naples, Italy, 2019, pp. 306-311, DOI: 10.1109/METROI4.2019.8792852

Further software related to IoT-AIO

IoT-AIO Configurator

Contact

• Kai Droste
• Markus Schraven
• Carlo Guarnieri

EON Energy Research Center (EONERC)
Institute for Automation of Complex Power Systems (ACS)
RWTH University Aachen, Germany