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:

• HACS* pour gérer la mise à jour des composants utilisés.
• variable* merci à rogro82 pour la création et Wibias pour la maintenance.
• Pool Pump Manager* pour piloter la pompe de filtration de ma piscine. Merci à moi même ;-) et à exxamalte pour l'inspiration de son module pool-pump
• Orange Livebox Router* pour récupérer des information de ma livebox. Merci à Cyr-ius
• Blitzortung.org lightning detector* pour détecter les orages près de chez moi. Merci à mrk-its.

(*): intégrations gérées avec HACS

Integrations configurées via l'IHM dans HA

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

• InfluxDB
• SSH & Web Terminal
• Unifi Controller: attention celui là consomme beaucoup de mémoire et peu être la cause racine de problème sur un Rasberry Pi 3.
• deCONZ
• MariaDB pour héberger ma base de donnée Home Assistant.

One more thing

J'ai ajouté d'autres information spécifiques dans le wiki. N'oubliez pas de le visiter. Attention pas encore traduit.

Me contacter

Si vous voulez discuter de ma configuration, vous pouvez le faire à travers les outils suivant:

• GitHub par l'intermédiare des issues ou des discussions.
• Sur le forum officiel anglophone ou sur celui de la communauté HACF en français.
• Sur le Discord de la communauté HACF.

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:

• HACS* to follow updates of custom components and cards.
• variable* integration thanks to rogro82 for creating it and Wibias for maintenance.
• Pool Pump Manager* to manage the swiming pool pump thanks to me ;-) and exxamalte for inspiring me with his pool-pump module.
• Orange Livebox Router* to monitor my ADSL box. Thanks to Cyr-ius
• Blitzortung.org lightning detector* For lightning detection. Thanks to mrk-its.

(*): integrations update managed with HACS

Integrations configured thru HA GUI

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

• InfluxDB
• SSH & Web Terminal
• Unifi Controller: warning this one use a lot of memory and can be the root cause of issues on Raspberry Pi 3.
• deCONZ
• MariaDB to host Home Assisant database.

One more thing

I have and will add specific explanations in the wiki. So don't forget to visit it.

Contact me

If you want to discuss with me about my configuration, you can do it through the following tools:

• GitHub with the issues or the discussions.
• On the official forum in English or on the HACF community one in French.
• On the HACF community Discord in French.