Home Assistant

Home Assistant collecte et visualise les données de votre maison connectée et offre de nombreuses possibilités d’automatisation. evcc est spécialisé dans la charge et le chauffage intelligents. Les deux systèmes se complètent et peuvent être reliés de différentes manières.

Visualiser et automatiser

evcc offre de nombreux réglages pour la charge et le chauffage intelligents, mais ne peut pas couvrir tous les cas d’usage. L’intégration avec Home Assistant vous apporte plus de flexibilité. Voici quelques exemples :

visualiser les mesures dans des tableaux de bord
créer des plans de charge à partir d’événements du calendrier
changer de mode de charge selon la présence
…

Intégration evcc pour Home Assistant (recommandée)

L’intégration ha-evcc de marq24 apporte les données et les fonctions d’evcc directement dans Home Assistant. Cela fonctionne que vous utilisiez evcc comme application Home Assistant ou non. La seule condition est que Home Assistant et evcc soient joignables sur le même réseau.

L’intégration fournit toutes les entités evcc pertinentes : mesures, paramètres, points de charge et véhicules. Après l’installation, vous disposez d’une liste complète d’entités utilisables dans les tableaux de bord et les automatisations.

Installation via HACS :

Ouvrez HACS dans Home Assistant et recherchez « evcc ».
Installez l’entrée evcc☀️🚘- Solar Charging de marq24.
Redémarrez Home Assistant.
Allez dans Paramètres → Appareils et services → Ajouter une intégration, recherchez « evcc » et saisissez l’URL de votre instance evcc.

Pour d’autres options d’installation et plus de détails, consultez le dépôt GitHub.

Pour les tableaux de bord, la hass-evcc-card fournit une carte Lovelace qui affiche la vue d’ensemble d’evcc dans Home Assistant.

Intégration manuelle

Vous pouvez aussi intégrer manuellement les données d’evcc dans Home Assistant via l’API REST ou MQTT.

API REST

evcc propose une API REST. Ce guide de marq24 décrit en détail l’intégration avec Home Assistant.

MQTT

Vous avez besoin d’un broker MQTT (p. ex. Mosquitto, également disponible comme application Home Assistant).

Configurez la connexion au broker dans evcc sous Configuration → MQTT. Le même broker et le même topic doivent être configurés dans Home Assistant pour que les deux systèmes puissent échanger des données.

Vous pouvez utiliser un outil comme MQTT Explorer pour vérifier que les messages sont bien publiés sur les topics. Un guide pour configurer des capteurs MQTT dans Home Assistant est disponible sur le blog d’Alkly (en allemand).

Les topics disponibles sont documentés dans l’API MQTT.

Utiliser les entités Home Assistant

evcc peut se connecter directement à Home Assistant et utiliser ses entités (capteurs, interrupteurs, nombres) comme sources de données. Cela vous permet d’intégrer dans evcc des appareils qui ne sont pas pris en charge nativement, p. ex. des prises connectées Zigbee, des capteurs d’autres intégrations ou des montages faits maison. Tant que les données sont disponibles sous forme d’entité Home Assistant, evcc peut les exploiter.

Types d’appareils pris en charge

Compteurs (réseau, solaire, batterie domestique, etc.) avec puissance, énergie, courants, tensions, niveau de charge
Chargeurs avec statut, activation/désactivation et courant de charge maximal
Prises commutables avec simple commande marche/arrêt (pour prises connectées, relais)
Véhicules avec niveau de charge, autonomie, statut, kilométrage ; en option, des scripts pour le démarrage et l’arrêt
Notifications : sous Configuration → Notifications, vous pouvez envoyer des messages evcc via Home Assistant

Mise en place

Les appareils Home Assistant s’ajoutent comme n’importe quel autre appareil dans l’interface de configuration.

Allez dans Configuration et ajoutez un appareil, p. ex. Ajouter un compteur supplémentaire.
Sélectionnez « Home Assistant » comme fabricant.
Choisissez votre instance. Les instances du réseau local sont détectées automatiquement. Si la liste reste vide, p. ex. parce que Home Assistant tourne dans un autre sous-réseau, saisissez l’adresse manuellement (http://homeassistant.local:8123).
Autorisez l’accès. Home Assistant s’ouvre dans un nouvel onglet où vous vous connectez et confirmez la demande. Votre instance evcc enregistre le jeton et le renouvelle automatiquement.
Attribuez une entité à chaque champ, p. ex. « Puissance ». L’autocomplétion ne vous propose que les entités de votre instance adaptées au champ.
Cliquez sur Valider & enregistrer pour vérifier que les entités peuvent être lues.

Valeurs des entités

Chaque champ attend un certain type de valeur. Une entité qui renvoie unknown ou unavailable est considérée comme temporairement indisponible et sera relue lors de la prochaine mise à jour.

Nombres

Les champs de puissance, d’énergie, de courant et de niveau de charge exigent un simple nombre comme état, p. ex. 1234. Un état tel que 1234 W ne peut pas être lu : l’unité doit figurer dans l’attribut unit_of_measurement de l’entité. W/kW et Wh/kWh/MWh sont convertis automatiquement. Pour inverser le signe, ajoutez - devant le nom de l’entité (-sensor.inverter_power).

Marche/arrêt

Les champs d’activation (chargeur, prise commutable, etc.) acceptent on, true, 1, active et yes, ainsi que leurs contraires off, false, 0, inactive et no.

Statut de charge

Les chargeurs et les véhicules ont besoin d’une entité de statut qui indique si le véhicule est déconnecté, connecté ou en charge. Les états suivants sont reconnus d’office :

Statut	Signification	États
A	déconnecté	`a`, `disconnected`, `not_plugged`
B	connecté	`b`, `connected`, `plugged`, `starting`, `stopped`, `paused`, `complete`, `charging_completed`
C	en charge	`c`, `charging`

De nombreuses intégrations utilisent leur propre terminologie. Si l’entité renvoie un état absent du tableau, le journal affiche la valeur brute avec le nom de l’entité. Ajoutez cette valeur au champ États pour le statut A/B/C correspondant dans les options avancées de l’appareil. Plusieurs valeurs sont séparées par des virgules ; la casse n’a pas d’importance.

statusB: charging_stopped, charging_error
statusC: instant_charging

Un binary_sensor utilisé comme entité de statut nécessite aussi une correspondance explicite, p. ex. statusA: off et statusC: on.

Ressources complémentaires (vidéos)

Les vidéos sont en allemand.