mrwiwi / tydom2mqtt

Link between a Delta Dore's Tydom Hub and and a MQTT broker, unofficial of course.
MIT License
28 stars 17 forks source link
deltadore hassio mqtt-broker tydom tydom-hub

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:

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

Configuration

tydom2mqtt can be configured by using the following environment variables.

Environment variable Required Supported values Default value when missing
TYDOM_MAC :red_circle: Tydom MAC address (starting with 001A...)
TYDOM_PASSWORD :red_circle: Tydom password
TYDOM_IP :white_circle: Tydom IPv4 address or FQDN mediation.tydom.com
TYDOM_ALARM_PIN :white_circle: Tydom Alarm PIN None
TYDOM_ALARM_HOME_ZONE :white_circle: Tydom alarm home zone 1
TYDOM_ALARM_NIGHT_ZONE :white_circle: Tydom alarm night zone 2
MQTT_HOST :white_circle: Mqtt broker IPv4 or FQDN localhost
MQTT_PORT :white_circle: Mqtt broker port 1883
MQTT_USER :white_circle: Mqtt broker user if authentication is enabled None
MQTT_PASSWORD :white_circle: Mqtt broker password if authentication is enabled None
MQTT_SSL :white_circle: 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?

TODO

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.