My Home Assistant config
Welcome to my Home Assistant configuration!
Bienvenue chez ma configuration Home Assistant !
You will find English README content here.
Vous trouverez le contenu en français du README ici.
Pour les francophones
Ne soyez pas effrayés par la structure non standard de cette configuration pour Home-Assistant.
J'ai été inspiré par la structure propsée par Franck Nijhof.
Cette approche est très modulaire et très différente dans sa strucutre des autres configurations que vous trouverez sur Internet.
L'idée c'est que chaque fichier dans ce dépôt ne fait qu'une seule chose !
Vous pouvez ainsi chercher le fichier qui correspond à un composant,
cliquez et vous trouverez rapidement l'information.
Le fichier configuration.yaml
n'est utilisé que pour amorcer le système
et contient des paramètres minimaux, mais vitaux.
Si vous êtes à l'aise en anglais, je conseille le visionnage de la video de Franck
expliquant pourquoi il a fait ces choix.
J'ai essayé d'ajouter des commentaires et des liens vers la documentation pour chaque fichier YAML quand cela à une valeur ajoutée.
Attention: ma décision d'avoir une documentation bilingue en ajoutant le français a été faite dans un second temps.
Donc la partie francophone n'est pas encore complète.
Si vous avez des questions ou voulez discuter de ma configuration,
vous pouvez me retrouver sur le réseau HACF (forum, Discord, organisation GitHub, etc...)
où on y parle français ou sur le réseau Home Assistant officiel.
Appareils utilisés
- Un Microseveur HP Gen8 pour héberger un Machine Virtuelle HassOS
- Les objets Xiaomi:
- Robot aspirateur Roborock cleaner
- Pleins de capteurs et interrupteurs
- Zwaves:
- Prises avec contrôle de la consomation
- Détecteurs incendies
- RFXCOM pour accéder à des capteurs Oregon
- Ampoules Philips Hue et appareils Zigbee compatibles
- Quelques objets DIY à base d'esp32 en utilisant ESPHome
- Telegram pour les notifications
- Google home et Chromecast
- Renault Zoé ma voiture électrique
- Linky
- Serveur Plex qui tourne sur mon NAS
- Conbee 2 pour controler mes appareils Zigbee (Xiaomi, Hue and OSRAM)
- UPC Back-UPS pour protéger des coupures électriques mon Microserveur, mon
switch et mon NAS.
- Un Sonoff POW R2 gérer la pompe de filtration de ma piscine
- Un NAS Synology
- Une imprimante Brother
- Une Livebox pour ma connexion ADSL.
- Les téléphones de la maisons (iOS et Android)
Automations
Vous trouverez dans mes scripts et automations les fonctionalités suivantes:
- Un backup régulier de ma configuration Home-Assistant.
- Surveiller la disponibilité des appareils critiques de ma maison.
- Surveiller la qualité de ma connexion Internet.
- Piloter le robot Aspirteur à partir de Google Home.
- Les routines quotidiennes pour nettoyer avec le robot aspirateur.
- Gestion d'un alarme (besoin de retravailler cette partie).
- Vérification et notification si des lumières devraient être éteintes
- Envoie une notification en cas d'alerte météo ou de pluie attendue
- Envoie un notification si j'ai oublié de brancher ma voiture électrique
- Piloter le calendrier de la pompte de filtration de la piscine.
- Et pleins d'autre choses...
les Custom components utilisés
Les custom components qui m'aident:
(*): intégrations gérées avec HACS
Les integrations suivantes ne sont pas configurées dans les fichiers YAML.
Vous ne les verrez donc pas dans ce dépôt:
-
Application mobile pour intégrer les informations des smartphones de la famille.
- Blitzortung (cf. liste des customs components).
-
Brother pour avoir
l'état de mon imprimante.
- CO2 Signal
-
deCONZ pour piloter mes
appareils Zigbee.
-
ESPHome pour intégrer des
ESP ou SONOFF.
-
IFTTT utilisé pour piloter
le robot aspirateur par la voix.
-
Google Cast utilisé pour
envoyer des message TTS sur ma Google Home
-
Météo-France pour
avoir la météo, les alertes météo et la prévision de pluie dans l'heure.
-
Network UPS Tool (NUT) pour
surveiller mon UPC Back-UPS. Pour les NAS synology il y a une astuce sur le site de Cachem.fr
- Livebox (cf. liste des customs components).
-
Plex pour connceter mon
serveur Plex
-
Renault pour remonter les information de ma Zoe. Big up a @epenet qui a investi beaucoup d'energie (avec un peu de mon aide) pour rendre cette integration officielle et aboutie.
-
RFXTRX pour gérer mes appareils radios.
-
SpeedTest pour surveiller ma connexion ADSL.
-
Synology pour surveiller mon NAS.
-
Waze pour surveiller la durée des trajets quotidiens de la famille.
Addons utilisés
One more thing
J'ai ajouté d'autres information spécifiques dans le wiki.
N'oubliez pas de le visiter. Attention pas encore traduit.
Si vous voulez discuter de ma configuration, vous pouvez le faire à travers les outils suivant:
For English speaking users
Don't be scared by the non standard structure of the Home Assistant configuration folder.
I'm inspired by the strucutre propsed by Franck Nijhof.
This system is very modular and very differently structured compared to other,configurations you'll find online.
Basically, each file in the repository does 1 (one, uno, eins) thing only!
Search file with the name of the component, click through it, you'll get it pretty fast.
The configuration.yaml
is only used to bootstrap the system
and contains some minimal, but vital, settings.
You can watch a video by Franck
explaining why is doing that way.
I try to add comments and link with external documentations for each YAML file when needed.
If you have questions or want to discuss about my configuration,
you can reach me on the HACF network (forum, Discord, GitHub organization, etc...)
where we speak French or on the official Home Assistant network.
Devices used
- A Microserver HP Gen8 to host a HassOS Virtual Machine
- Xiaomi devices:
- Vacuum Roborock cleaner
- Lot of sensors and switchs
- Zwaves:
- Switchs with energy monitoring
- Fire detectors
- RFXCOM to access Oregon sensors
- Philips Hue bulbs and compatible Zigbee devices
- DIY with esp32 using ESPHome
- Telegram
- Google home and Chromecast
- Renault Zoé my electric car
- Linky electrcity monitoring system
- Plex server running on my NAS
- Conbee 2 for managing Zigbee devices (Xiaomi, Hue and OSRAM)
- UPC Back-UPS to protect against power failure my Microserver, my switch and
my NAS.
- Sonoff POW R2 for managing the swiming pool pump (in progress)
- NAS Synology
- ADSL box from Orange.
- Family phones (iOS and Android)
Automations
You can find in my automations and scripts the following features:
- Regular Home Assistant backup
- Monitoring of the availibility of the crtical systems of the house.
- Monitoring the quality of the internet connexion.
- Control thru Google Assistant of the Vacuum.
- Daily routines for cleaning the house with the Vacuum.
- Alarm management (need rework).
- Check and notification if lights could be switch off.
- Send notification in case of weather alert or rain expected.
- Send notification if I forget to plug the electrical car.
- Manage the pool pump schedule.
- And many other things...
Custom components used
To help me I used the following custom components:
(*): integrations update managed with HACS
The following integrations are not configured in YAML files. So you won't see it
in this repository:
-
Mobile App to integrate family smartphones data.
- Blitzortung (cf. customs components list).
-
Brother to have a status
of my new printer.
- CO2 Signal
-
deCONZ pour control my Zigbee devices.
-
ESPHome devices
integration in HA.
-
IFTTT used for piloting the
vacuum robot from the Google Home.
-
Google Cast used for some
TTS messages in the house.
-
Météo-France to
have weather alerts and rain forecast within the hour.
-
Network UPS Tool (NUT) to
monitor my UPC Back-UPS.
- Livebox (cf. custom components list).
-
Plex to connect my Plex
server.
-
Renault to integrate my Zoe data. Kudos to @epenet who has invest a lot of energy with a little support from me to have this official integration.
-
RFXTRX to control my radio devices.
-
SpeedTest to monitor my ISP connexion.
-
Synology to monitor my NAS.
-
Waze to monitor the duration of our commutes.
Addons used
One more thing
I have and will add specific explanations in the wiki.
So don't forget to visit it.
If you want to discuss with me about my configuration, you can do it through the following tools: