Tydom smart home integration, free and open source
Control your Delta Dore Tydom devices (shutters, lights, gates, thermostats) through tydom2mqtt.
Published by quentinlegay
- Devices
- Version 2.0.1
- Requires Gladys >=4.86.0
- ★ 0
Control your Delta Dore Tydom devices from Gladys: shutters, lights, gates and garage doors, thermostats, plus their battery level and temperature sensors.
How it works
Tydom gateway <──> tydom2mqtt <──> MQTT broker <──> Gladys (this integration)
The integration runs tydom2mqtt as a sub-container managed by Gladys. tydom2mqtt connects to your Tydom gateway and publishes your devices on your MQTT broker. The integration reads them from the broker and sends your commands back through it.
You need an MQTT broker reachable from Gladys, for instance the Mosquitto broker installed by the Gladys MQTT integration.
Configuration
- Open the Configuration tab of the integration.
- Tydom gateway
- MAC address: printed under the gateway, it starts with
001A25. - Password: the one printed under the gateway. You can leave it empty and fill in your Delta Dore account (e-mail + password) instead: tydom2mqtt then retrieves the gateway password itself.
- IP address: the local IP of the gateway (recommended, give it a fixed
IP in your router). Leave
mediation.tydom.comto go through the Delta Dore cloud.
- MAC address: printed under the gateway, it starts with
- MQTT broker: host, port, user and password of your broker. Use the LAN
IP address of the machine running the broker —
localhostwould point inside the containers. - Save. Gladys starts tydom2mqtt with these settings; your devices show up in the Discovery tab within a minute, ready to be added.
Every change of configuration restarts tydom2mqtt with the new values.
Already running tydom2mqtt?
If you already run tydom2mqtt yourself (docker-compose, Home Assistant add-on…) on the same broker, disable Run tydom2mqtt from Gladys: the integration then only reads its topics. Only the MQTT fields are needed.
Supported devices
| Tydom device | In Gladys |
|---|---|
| Shutter | Open / close / stop + position (0 = closed) |
| Garage door | Open / close / stop + position |
| Light | On/off + brightness |
| Gate, door (impulse) | Switch: each command sends a TOGGLE impulse |
| Thermostat / boiler | Target temperature + current temperature |
| Sensors | Battery, temperature, humidity, power, energy |
Not supported yet: alarm, heating modes and presets, shutter tilt.
Actions
- Resynchronize Tydom devices — asks tydom2mqtt to reload the Tydom configuration and republish every device. Use it after adding a device to your Tydom installation.
Troubleshooting
- No device in Discovery: check the tydom2mqtt sub-container logs in the
integration page.
Connected to mqtt brokerand devicescreated / updatedmust appear. A wrong MAC or password shows as an authentication error towards the gateway. - "MQTT broker unreachable": the host must be reachable from the Gladys
containers (LAN IP, not
localhost), and the user/password accepted by the broker. - A gate does the opposite of what is shown: gates are driven by impulses, the state shown is the last one reported by the Tydom gateway.
Set LOG_LEVEL=debug for the full detail of the integration logs.
Configuration settings
These are the settings Tydom asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| How it works | section | No | This integration runs tydom2mqtt next to Gladys: it connects to your Tydom gateway and publishes your devices on your MQTT broker. Gladys then reads and controls them through that broker. You need an MQTT broker reachable from Gladys (for instance the one of the Gladys MQTT integration). |
| Tydom gateway | section | No | The MAC address is printed under the gateway (it starts with 001A25). The password is the one printed under the gateway, or leave it empty and fill in your Delta Dore account so tydom2mqtt retrieves it. |
| Tydom MAC address | string | Yes | |
| Tydom password | secret | No | |
| Tydom IP address | string | Yes | Local IP address of the gateway (recommended). Leave mediation.tydom.com to go through the Delta Dore cloud. |
| Delta Dore account e-mail | string | No | Optional: only needed when the Tydom password is left empty. |
| Delta Dore account password | secret | No | |
| Tydom polling interval (s) | number | No | |
| MQTT broker | section | No | Use the LAN IP address of the broker host: localhost would point inside the containers. |
| MQTT host | string | Yes | |
| MQTT port | number | No | |
| MQTT user | string | No | |
| MQTT password | secret | No | |
| Run tydom2mqtt from Gladys | boolean | No | Disable it if you already run tydom2mqtt yourself on the same broker: Gladys will only read its topics. |
How to install Tydom in Gladys
- In Gladys, open Integrations: Tydom appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/quentinlegay/gladys-tydom:2.0.1), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/quentinlegay/gladys-tydom.
Tydom requires Gladys >=4.86.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
Tydom is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by quentinlegay, not by the Gladys core team.
- Browse all external integrations
- Discover the native integrations built into Gladys
- Build and publish your own external integration
- Source code on GitHub — source of this documentation