Yann RITTER Tuto Home Assistant
Quand le contrôle de la PAC devient possible! Intégration d'une pompe à chaleur Atlantic Alfea extentia duo (modèle de 2015 non AI)
Voir la liste des appareils compatibles : https://github.com/fredlcore/BSB-LAN
Un petit tuto qui explique les étapes clés et les détails importants afin d'intégrer ton moyen de chauffage dans home assistant.
Je remercie Frederik initiateur du projet pour ces travaux et sa réactivité.
Le git du projet : https://github.com/fredlcore/BSB-LAN
Je ne suis pas le DEV des intégrations nécessaires, mais juste un passionné ayant assimilé la technique et les différentes manipulations et je souhaite t'aider en partageant tout ça ! 😉
Si, tu lis ça ! Non mais, Y’a pas que le tuto qui compte ! On a deux trois bricoles importantes à te dire avant. Maintenant tu es adulte, t’as bien grandi, alors tu comprends que toutes les manipulations que tu vas faire sont sous ta responsabilité ! Si ton aspi recule au lieu d’avancer, qu’il danse la samba, qu’il va aspirer la salle de bains au lieu de passer la serpillière dans la cuisine, que ton Home Assistant plante, ou que ton Raspberry explose… On n’y est pour rien ! Tout ce qui suit a été d’abord installé, testé par nos soins. Ça fonctionne. Et on l’utilise au quotidien ! Donc tu prends ton temps, tu lis bien, tu ne fais pas l’enfant à vouloir aller trop vite et sauter des étapes en mode « Ouais c’est bon je sais ! » Ce n’est pas un tuto sur les bases, alors certaines étapes sont pour nous acquises et ne seront pas détaillées ici. Y’a toujours le groupe si vraiment tu as besoin d’aide… On y va ?
Avoir Mosquitto broker d'installé
J'utilise la configuration par défaut du module
Tu as un système de chauffage compatible et acheté / branché la carte à ton système de chauffage ? Sinon, tu peux consulter le git du projet (https://github.com/fredlcore/BSB-LAN) et tu peux contacter Frederik par e-mail en Allemand ou Anglais à l'adresse suivante : bsb@code-it.de
Si oui, tu peux continuer la lecture.
Dans mon cas, j'utilise la version ESP32 : https://1coderookie.github.io/BSB-LPB-LAN_EN/QSG_ESP32.html
Et je souhaite faire communiquer le module BSB-LAN via MQTT, ainsi le module me pousse les valeurs toutes les X secondes et lors de changements demandés en MQTT.
Créer ou réutiliser un utilisateur home assistant pour permettre l'authentification MQTT.
Dans home assistant vas dans Paramètre \ Personnes puis dans onglet utilisateur
Clique sur le bouton créer un utilisateur et compléte comme ci-dessous :
Dans Paramètre \ Intégration assure toi de bien avoir l'intégration MQTT, sinon ajoute la.
- broker : localhost
- port : 1883
- utilisateur : celui créé précédemment
- mot de passe : idem celui lié à l'utilisateur
Tu dois à présent paramétrer le module BSB-LAN
Depuis un navigateur web : http://bsb-lan.local/
La page suivante doit s'afficher
Clique ensuite sur le menu Setting et modifie les paramètres suivants :
- La configuration avancée va permettre de saisir le paramétrage MQTT.
- Le write access lui de permettre la modification depuis l'interface web et MQTT / HTTP
Puis tu vas modifier les paramètres spécifiques MQTT
- Logging mode --> activer le mqtt
- Interval (seconds) --> délais maxi entre chaque remontées
- Parameters --> liste des paramètres que tu souhaites remonter / utiliser dans HA la liste complete est disponible via le menu Heater Function
- Usage --> format du message mqtt, le plus simple (plain text)
- IP address broker --> l'adresse ip de ton serveur mosquitto (dans mon cas mon instance HA)
- username --> nom d'utilisateur pour la connexion MQTT, donc celui créé à l'étape précédente dans HA
- Password --> le mot de passe associé à l'utilisateur
Tu vas pouvoir contrôler les remontées graces à l'application MQTT explorer par exemple : http://mqtt-explorer.com/
Connecte toi avec le user / mot de passe sur l'adresse ip du broker MQTT et normalement les paramètres s'affiche au bout de max 30 secondes, si tu as copié ma configuration bsb lan.
Tu vas pouvoir récupérer les données dans Home assistant.
Dans le fichier configuration.yaml ajoute la configuration tel que ci-dessous :
############################################################
## MQTT ##
############################################################
mqtt:
sensor: !include mqtt/mqtt.yaml
Puis dans le dossier "config", créer un dossier "mqtt", et un fichier "mqtt.yaml"
Et ajoute la configuration suivante pour permettre la remontée des paramètres précédemment renseignés dans BSB-LAN.
############################################################
## MQTT BSB LAN ##
############################################################
- name: "Mode de chauffe"
state_topic: "BSB-LAN/700.00"
- name: "Mode ESC"
state_topic: "BSB-LAN/1600.00"
- name: "Température consigne confort"
state_topic: "BSB-LAN/710.00"
unit_of_measurement: °C
device_class: temperature
- name: "Température consigne reduit"
state_topic: "BSB-LAN/712.00"
unit_of_measurement: °C
device_class: temperature
- name: "Température sonde exterieur"
state_topic: "BSB-LAN/8700.00"
unit_of_measurement: °C
device_class: temperature
- name: "Température thermosat interieur"
state_topic: "BSB-LAN/8740.00"
unit_of_measurement: °C
device_class: temperature
- name: "Etat du circuit de chauffage"
state_topic: "BSB-LAN/8000.00"
- name: "Etat de l'ECS"
state_topic: "BSB-LAN/8003.00"
- name: "Etat pompe à chaleur"
state_topic: "BSB-LAN/8006.00"
- name: "Température de retour pompe à chaleur"
state_topic: "BSB-LAN/8410.00"
unit_of_measurement: °C
device_class: temperature
- name: "Température de départ pompe à chaleur"
state_topic: "BSB-LAN/8412.00"
unit_of_measurement: °C
device_class: temperature
- name: "Etat pompe ECS"
state_topic: "BSB-LAN/8820.00"
- name: "Etat résistance électrique ECS"
state_topic: "BSB-LAN/8821.00"
- name: "Température mesurée ECS"
state_topic: "BSB-LAN/8830.00"
unit_of_measurement: °C
device_class: temperature
Sauvegarde la configuration puis redémarrer home assistant pour prise en compte du paramétrage
Tu as maintenant les valeurs disponibles dans des sensors pour home assistant.
Voici un exemple :
La modification depuis home assistant.
Je vais à present tester la modification d'une valeur via MQTT pour passer du mode hors-gel en mode automatique.
Pour ce faire, je dois envoyer "1" sur le paramètre "700".
Depuis l'intégration MQTT, il est possible de tester la publication d'un paquet.
Tu peux constater que le mode de chauffage a basculé en mode automatique.
Je vais te montrer comment changer l'état depuis un bouton virtuel dans HA
Dans le "configuration.yaml", ajoute le lien button comme ci-dessous :
############################################################
## MQTT ##
############################################################
mqtt:
sensor: !include mqtt/mqtt.yaml
button: !include mqtt/button.yaml
Puis créer le fichier "button.yaml" dans le dossier "mqtt"
et ajoute le contenu suivant :
############################################################
## MQTT BSB lan bouton ##
############################################################
- unique_id: "PAC mode auto"
name: "PAC mode auto"
command_topic: "BSB-LAN"
payload_press: "S700=1"
availability:
- topic: "BSB-LAN/status"
qos: 0
retain: false
entity_category: "config"
Explication :
- command_topic : sujet à appeler
- payload_press : commande à envoyer lors du clique
- /S pour de la modification puis le code element à modifier = la valeur à renseigner
- entity_category : dit que tu agis sur de la configuration availability: - topic: "BSB-LAN/status" permet de gérer l'état si le sensor est non disponible
La création d'un thermosat MQTT pour le pilotage de la PAC
Dans le "configuration.yaml", ajoute le lien climate comme ci-dessous :
############################################################
## MQTT ##
############################################################
mqtt:
cover: !include cover/volet.yaml
sensor: !include mqtt/mqtt.yaml
button: !include mqtt/button.yaml
climate: !include mqtt/climate.yaml
Puis créer le fichier "climate.yaml" dans le dossier "mqtt"
et ajoute le contenu suivant :
############################################################
## MQTT BSB LAN ##
############################################################
- name: "Pompe à chaleur"
payload_on: 1
payload_off: 0
modes:
- auto
- heat
- cool
- 'off'
mode_state_topic: "BSB-LAN/700.00"
mode_state_template: >-
{% set values = { '0 - Mode protection':'off', '1 - Automatique':'auto', '2 - Réduit':'cool', '3 - Confort':'heat'} %}
{{ values[value] if value in values.keys() else 'off' }}
mode_command_topic: "BSB-LAN"
mode_command_template: >-
{% set values = { 'off':'S700=0', 'auto':'S700=1', 'cool':'S700=2', 'heat':'S700=3'} %}
{{ values[value] if value in values.keys() else '0' }}
current_temperature_topic: "BSB-LAN/8740.00"
min_temp: 17
max_temp: 24
temp_step: 0.5
temperature_state_topic: "BSB-LAN/710.00"
temperature_command_topic: "BSB-LAN"
temperature_command_template: "{{'S710='+ (value| string)}}"
Explication :
voici la doc : https://www.home-assistant.io/integrations/climate.mqtt/
- mode_state_topic: rubrique retournant le mode de chauffage
- mode_state_template : template pour convertir les réponses en mode connu home assistant, je n'ai rien trouvé d'autre que cool pour le mode réduit (éco)
- mode_command_topic : topic à appeler pour l'envoi d'un message
- mode_command_template : template pour convertir le choix sur HA en code connu bsb-lan
- current_temperature_topic : rubrique retournant la température courante (thermostat)
- min_temp: pour définir la température min sélectionnable
- max_temp : pour définir la température max sélectionnable
- temp_step : précision par palier de 0.5 degrés
- temperature_state_topic: rubrique retournant la température de consigne confort paramétrée
- temperature_command_topic : topic à appeler pour l'envoi d'un message
- temperature_command_template : template pour convertir la température sélectionnée en message de mise à jour bsb-lan
Le resultat en image
Et puisque je suis sympa, on va créer un switch pour allumer ou éteindre la production d'eau chaude
Dans le "configuration.yaml", ajouter la liste switch comme ci-dessous :
La configuration s'étoffe au fil du tuto
############################################################
## MQTT ##
############################################################
mqtt:
cover: !include cover/volet.yaml
sensor: !include mqtt/mqtt.yaml
button: !include mqtt/button.yaml
climate: !include mqtt/climate.yaml
switch: !include mqtt/switch.yaml
Puis créer le fichier "switch.yaml" dans le dossier "mqtt"
et ajoute le contenu suivant :
############################################################
## MQTT BSB LAN ##
############################################################
- name: "Activation ECS"
state_topic: "BSB-LAN/1600.00"
command_topic: "BSB-LAN"
payload_on: "S1600=1"
payload_off: "S1600=0"
state_on: "1 - Marche"
state_off: "0 - Arrêt"
Explication :
Le lien de la doc officiel : https://www.home-assistant.io/integrations/switch.mqtt/
- state_topic: rubrique retournant le mode de production d'eau chaude
- command_topic : topic à appeler pour l'envoi d'un message
- payload_on : valeur à transmettre à l'activation du switch
- payload_off : valeur à transmettre à la désactivation du switch
- state_on: valeur transmise par bsb-lan et à interpréter pour rendre l'interrupteur actif
- state_off : valeur transmise par bsb-lan et à interpréter pour rendre l'interrupteur désactivé
En image dans HA
Tu peux à présent modifier toutes sortes de valeurs et les afficher.
Libre à toi de créer des automatisations.
Voici mes quelques idées :
- Changement de mode avec activation de l'alarme
- Changement de mode sur absence programmé dans l'agenda
- Changement de mode si fenêtre ouverte depuis plus de x minutes
Une petite doc, un tuto, qui je l'espère t’a aidé le mieux possible. Je l'ai réalisé avec plaisir dans un esprit d’entre-aide, bénévolement, en parallèle de mon métier et ma vie. Je n'assure pas le support de tous les problèmes mais je serais là si besoin sur le groupe, comme d’habitude. Si tout fonctionne, remercie-moi.
Yann Ritter
Si vous aimez mes tutos, likez 🌟 mon repo !
Si vous souhaitez m'offrir une petite bière ou un café ou participer à l'investissement materiel : https://www.paypal.com/paypalme/YannRitter Merci !