Bonjour,
Ayant démarré il y a peu HA, j’ai passé un peu de temps pour réussir à intégrer mes ESP qui sont sous ESPEasy. Je vous propose donc ce petit tuto maintenant qu’ils sont opérationnels.
Introduction
Nativement, les ESP peuvent être intégrés dans HA en utilisant l’addon ESPHome, cependant cet addon nécessite de flasher l’ESP. Si comme moi vous avez déjà ESPEasy d’installé qui est déjà utilisé par autre chose (Jeedom dans mon cas), peut être que vous souhaitez pouvoir utiliser votre appareil dans HA directement, tout en gardant la config actuelle opérationnelle.
Pour ceux qui souhaiteraient migrer complètement, la procédure est expliquée ici
Prérequis
- Un broker MQTT installé et lancé coté HA
Configuration coté ESPEasy
- Connectez vous à votre ESP sur ESPEasy (navigateur sur l’url de l’ESP)
- Onglet « Controllers » → Ajouter un controller
Vérifiez bien les paramètres encadrés, en saisissant nottament :
Protocole HA / MQTT
Controller Ip = l’IP de votre HA
Controller port = le port configuré dans votre broker MQTT
Le user / password de votre broker MQTT
- Onglet « Config »
Assurez vous que le « Unit number » est unique sur votre réseau. Si vous avez plusieurs ESP, veuillez bien mettre un numéro différent pour chacun d’entres eux).
Veuillez bien garder de coté le « Unit name », c’est lui qui sera utile pour la suite pour dialoguer avec HA (nous l’appellerons [UNIT] par la suite.
- Onglet « Devices »
Veuillez vous assurer que chacun des devices avec lesquels vous voulez interagir, aient bien un IDX unique, et que les data sont bien envoyés au contrôleur :
Veuillez bien garder de coté les « Name », « GPIO » et « Values » de chaque device, ce sont eux qui seront utiles pour la suite pour dialoguer avec HA (nous les appellerons [NAME], [GPIO] et [VALUE]).
- Onglet « Tools » → Advanced
Assurez vous de bien cocher les paramètres MQTT :
A ce stade, ESPEasy est en mesure de dialoguer avec votre HA via MQTT.
Configuration coté HA
Afin de pouvoir utiliser chacun des devices ESPEasy, nous allons devoir créer manuellement une entité par device.
Ouvrez votre éditeur de fichier préféré dans HA, pour éditer configuration.yaml, puis déclarez vos entités
- Exemple : Capteur température
sensor:
- platform: mqtt
state_topic: "ESP_PC_Grenier/Temperature1/Temperature1"
name: "PC Grenier temperature départ"
La valeur « state_topic » est renseignée avec les valeurs notées précédemment, nous avons donc [UNIT]/[NAME]/[VALUE].
Le name sera donc le nom de l’entité utilisable dans HA.
- Exemple : Switch
switch:
- platform: mqtt
name: "Circulateur PC Grenier"
command_topic: "ESP_PC_Grenier/gpio/14"
state_topic: "ESP_PC_Grenier/SW1/Etat1"
payload_on: "1"
payload_off: "0"
retain: true
Tout comme le capteur, la valeur « state_topic » est renseignée avec les valeurs notées précédement, nous avons donc [UNIT]/[NAME]/[VALUE].
La valeur « command_topic » est renseignée avec les valeurs notées précédement, nous avons donc [UNIT]/gpio/[GPIO].
Remarque : Si vous utilisez par exemple un PCF8574 pour augmenter le nombre de pins disponibles, alors le « gpio » est à changer en « pcfgpio », donc vous aurez [UNIT]/pcfgpio/[IDX], ou IDX correspond à l’idx spécifié dans votre device (exemple: command_topic: "ESP_Easy_Cave/pcfgpio/4"
).
Redémarrez HA, puis profitez de vos nouvelles entités que vous pouvez consulter dans « Outils développements »:
Puis ajouter dans votre dashboard avec une carte « Entités » par exemple: