Skip to content

Latest commit

 

History

History
128 lines (87 loc) · 6.08 KB

README.md

File metadata and controls

128 lines (87 loc) · 6.08 KB
Raw

This repo is now DEPRECATED ! please migrate @fmartinou's fork : https://github.com/fmartinou/tydom2mqtt

As many of you knew, i created tydom2mqtt for my own needs and with my little skills (i'm a paramedic guys ! :D), i will continue to work on the said fork.

Thanks again to @fmartinou for his help and contributions ! And thanks to all of you who made PRs to keep that project growing !

UPDATED hassio addon : https://github.com/fmartinou/hassio-addons.git

tydom2MQTT

Docker pulls License Travis

Link a Delta Dore Tydom hub to an mqtt broker.

Home Assistant tydom2mqtt official thread

Forked from mrwiwi/tydom2mqtt with the following improvements:

  • Multi-arch lighter Docker images
  • Travis continuous integration
  • Python PEP8 code style enforcement
  • Boiler AUTO mode
  • Better default values
  • Improved documentation

Why?

Deltadore doesn't provide any public API so this project is a humble try to fix that injustice.
Hardware is so good, that's really a shame !

Features

Push event based (websocket) to instantly get changes (inspired by tydom_python)

Out-of-the-box Home-Assistant integration thanks to Mqtt discovery

Automatic reconnection to Tydom on connection drop

Automatic reconnection to the Mqtt broker on connection drop

Getting started

Prerequisites

  • MQTT broker (Mosquitto, MQTT Home-Assistant addon...)
  • Docker engine (for Docker users)
  • Hass-io (for Hass.io users)

Configuration

tydom2mqtt can be configured by using the following environment variables.

Environment variable Required Supported values Default value when missing
TYDOM_MAC 🔴 Tydom MAC address (starting with 001A...)
TYDOM_PASSWORD 🔴 Tydom password
TYDOM_IP ⚪ Tydom IPv4 address or FQDN mediation.tydom.com
TYDOM_ALARM_PIN ⚪ Tydom Alarm PIN None
TYDOM_ALARM_HOME_ZONE ⚪ Tydom alarm home zone 1
TYDOM_ALARM_NIGHT_ZONE ⚪ Tydom alarm night zone 2
MQTT_HOST ⚪ Mqtt broker IPv4 or FQDN localhost
MQTT_PORT ⚪ Mqtt broker port 1883
MQTT_USER ⚪ Mqtt broker user if authentication is enabled None
MQTT_PASSWORD ⚪ Mqtt broker password if authentication is enabled None
MQTT_SSL ⚪ Mqtt broker ssl enabled false

Hass.io users

Use this addon repository.
That's all! (thanks to Mqtt auto discovery, no further configuration needed)

Docker users

Run fmartinou/tydom2mqtt with the appropriate environment variables.

N.B. The Docker image is working on the arm/v6, arm/v7, arm64/v8, amd64 platforms.

# Docker-Compose example
version: '3'

services:
  tydom2mqtt:
    image: fmartinou/tydom2mqtt
    container_name: tydom2mqtt
    environment:
      - TYDOM_MAC=001A2502ACE8
      - TYDOM_PASSWORD=azerty123456789
      - TYDOM_IP=192.168.1.33

FAQ

How to reset my tydom password?

In october 2021, Deltadore has released a new version of its Tydom app (v4+) preventing to set or reset the Tydom password.

To set/reset your password, better download the previous version (v3+) which still allows to do it (Aptoide link).

How to prevent my tydom to communicate with deltadore servers?

If you're concerned about your privacy, you can perform the following actions:

  1. Configure you router to forbid your Tydom hub to access internet
  2. Find your tydom local IP address and use it as TYDOM_IP value

Why alarm motion sensor activity isn't reported?

  • Alarm motion sensor activity isn't reported but when the alarm is fired then you get a cdata message so you can get the info (only when alarm is armed, pending and triggered).

TODO

  • Fix parsing of cdata msg type (will not crash anymore in the meantime), coming from an action from an alarm remote (and probably other things), we can get which remote had an action on alarm with it.
  • Fork it to a proper Home Assistant integration with clean on-boarding
  • Add climate, garagedoor, etc.
  • Build a web frontend to see and test (use frontail for now)

Contact & Support

Developer guide

Please find here the developer guide

Changelog

Please find here the changelog

License

This project is licensed under the MIT license.