Awesome Open Source
Awesome Open Source

MQTT enabled CoDeSys 3 Home Automation

Releases Gitter License

This CoDeSys 3.5 project is built for home automation purposes. The goal of the approach is to perform any critical operations like reading inputs, switching light, controlling sunscreens, etc. Inside the PLC itself and make use of MQTT events to send events to an MQTT broker. Using MQTT subscriptions it's possible to send commands to the PLC to control -for example- outputs.

The purpose? Redundancy on a software level but also on a hardware level!

  • PLCs are very (very) robust controllers: no PC, SoC, etc. is more robust and failure resistant.
  • Hardware continuity: Home automation providers often renew their modules every X years, modules aren't sold anymore or a full upgrade is required when something breaks. PLCs models and their modules are sold decades after their initial release date. For an example, check out the Wago 750 series controllers and modules.
  • Avoid performing critical operations that should work 24/7 inside a less redundant controller (it will fail sooner or later).
  • Keep your wive/girlfriend happy when you're not at home and your Rpi, Odroid, Banana Pi, Pc crashes (running your MQTT broker, OpenHab, Home Assistant, etc.).

Supported Runtimes

The project is developed using the IEC 61131-3 standard, there are multiple development environments with their own runtime that support the standard:


Core processing logic is executed in the (robust) PLC. Meaning that events like reading pushbuttons/switches, updating outputs are executed in the PLC software. To enable integration with external software the PLC sends out events to an MQTT broker when events occur (like pushbutton events, outputs that change state). MQTT subscriptions are enabled as well to allow control from the external software to control -for example- outputs.


Software Architecture

More information on the software architecture here.

Function blocks

Basic function blocks

Basic function blocks for basic IO events and operations.

Virtual function blocks

Function blocks developed to easily set and get values from the processing logic through MQTT.

Modbus RTU over RS485

With many PLCs having a onboard RS485 serial port it is a popular protocol to create a robust Modbus RTU sensor network.

Using Modbus RTU

How to use Modbus RTU differs depending on the PLC/development environment used. The topics belows address the usage of Modbus RTU in several development environments:

RS485 function blocks

To translate the byte array received by the modbus device to their actual value and send their values through MQTT the function blocks below have been developed. Note that a specific function block is required for each type of Modbus RTU device.

In addition to the above a buscontroller function block (FB_RS485_BUSCONTROLLER) is used to control access to the RS485 bus between multiple RS485 device function blocks.

Additional functionality



The following libraries are used in this PLC project and can be found under src\Libraries:

Special thanks to StefanDreyer for his assistance in some of the MQTT aspects of this project and his great work on his open-source CoDeSys MQTT library.

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
mqtt (312
home-assistant (213
home-automation (213
homeautomation (24
openhab (22
plc (21

Find Open Source By Browsing 7,000 Topics Across 59 Categories