https://github.com/elektrobeckhoff/ha-twincat-iot-communicator
Unofficial Home Assistant integration for the Beckhoff TwinCAT IoT Communicator (TF6730)
https://github.com/elektrobeckhoff/ha-twincat-iot-communicator
beckhoff beckhoff-4026 beckhoff-twincat-plc hacs hacs-integration home-assistant home-assistant-integration integration integrations mqtt mqtt-broker mqtt-client plc twincat twincat3
Last synced: 3 months ago
JSON representation
Unofficial Home Assistant integration for the Beckhoff TwinCAT IoT Communicator (TF6730)
- Host: GitHub
- URL: https://github.com/elektrobeckhoff/ha-twincat-iot-communicator
- Owner: ElektroBeckhoff
- License: mit
- Created: 2026-03-04T12:19:15.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-03-24T11:41:03.000Z (3 months ago)
- Last Synced: 2026-03-25T14:47:09.183Z (3 months ago)
- Topics: beckhoff, beckhoff-4026, beckhoff-twincat-plc, hacs, hacs-integration, home-assistant, home-assistant-integration, integration, integrations, mqtt, mqtt-broker, mqtt-client, plc, twincat, twincat3
- Language: Python
- Homepage:
- Size: 272 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# TwinCAT IoT Communicator for Home Assistant
[](https://github.com/hacs/integration)
[](https://github.com/ElektroBeckhoff/ha-twincat-iot-communicator/actions/workflows/validate.yaml)
[](https://github.com/ElektroBeckhoff/ha-twincat-iot-communicator/actions/workflows/hassfest.yaml)
Unofficial Home Assistant integration for the [Beckhoff TwinCAT IoT Communicator (TF6730)](https://www.beckhoff.com/en-en/products/automation/twincat/tfxxxx-twincat-3-functions/tf6xxx-connectivity/tf6730.html).
Connects Home Assistant to Beckhoff TwinCAT PLCs via MQTT. The integration auto-discovers all devices and widgets (lights, blinds, climate, fans, switches, sensors, and more) and exposes them as native Home Assistant entities.
## Features
- Auto-discovery of PLC devices and widgets via MQTT
- Supported widgets: Lighting, RGBW, RGBW_EL2564, Blinds, SimpleBlinds, Plug, AC, Ventilation, EnergyMonitoring, ChargingStation, TimeSwitch, BarChart, General
- Raw PLC datatype support (BOOL, INT, REAL, STRING) incl. one-dimensional arrays
- Widget sub-devices with automatic area assignment from PLC view hierarchy
- Desc watchdog — automatic PLC offline detection when Desc messages stop
- PLC push messages with acknowledge/delete actions
- OAuth / JWT authentication (PKCE)
- Blueprint automations included
## Installation
### HACS (recommended)
> ⚠️ **Installation Notice**
>
> This integration is currently **not yet listed in the official HACS default repositories** and is still undergoing the review and validation process.
>
> For now, it can only be installed via a **custom repository** in HACS:
>
> 1. Open HACS
> 2. Go to **Custom Repositories**
> 3. Add the URL of this GitHub repository:
https://github.com/ElektroBeckhoff/ha-twincat-iot-communicator
> 4. Select category: **Integration**
> 5. Install the integration as usual
>
> Once the review process is complete, the integration will be available directly through the standard HACS search.
>
> Until then, use at your own risk. Feedback and testing are highly appreciated!
### Manual
1. Copy `custom_components/twincat_iot_communicator/` to your `config/custom_components/` directory
2. Restart Home Assistant
3. Go to **Settings** > **Devices & services** > **Add integration** > **TwinCAT IoT Communicator**
## Documentation
- [Documentation](docs/DOCUMENTATION.md) — full setup guide, entities, actions, OAuth, troubleshooting
- [Changelog](docs/changelog.md) — release history
- [HA docs source](docs/twincat_iot_communicator.markdown) — formatted for the official Home Assistant documentation site
## Disclaimer
This project is an unofficial Home Assistant integration for the TwinCAT IoT Communicator (TF6730).
This project is not affiliated with or endorsed by Beckhoff Automation GmbH.
## License
See [LICENSE](LICENSE) for details.