Intégrer Ecojoko à Home Assistant : le guide complet (2026)

La communauté domotique déborde d'énergie. Plusieurs développeurs maintiennent des dépôts personnalisés accessibles directement via HACS (Home Assistant Community Store). Cette approche « plug-and-play » vous demande juste de rechercher le composant et de renseigner l'adresse IP du boîtier. Je vous conseille quand même une certaine prudence. Les mises à jour du Core HA tombent régulièrement cette année. Un plugin abandonné cassera net votre configuration.

Voici ma technique préférée. Votre assistant communique silencieusement sur votre réseau Wi-Fi local. Interrogez directement son adresse IP et vous récupérerez un fichier JSON rempli de vos précieuses valeurs de consommation. C'est robuste. Vous supprimez toute dépendance à un développeur tiers ou à un serveur distant capricieux. La plateforme native de votre serveur gère tout de bout en bout.

Cette option cible les fondus de reverse engineering. L'idée consiste à faire tourner un script Python en tâche de fond. Ce petit programme écoute le trafic réseau de l'appareil et expédie les trames vers un broker MQTT comme Mosquitto. Nous tenons là la solution ultime pour un rafraîchissement fulgurant. C'est le setup parfait pour gérer un délestage ultra-rapide.

Votre équipement réclame une adresse fixe pour rester visible par le serveur.

• Connectez-vous à l'interface d'administration de votre box internet ou routeur.

• Cherchez la liste des équipements connectés en Wi-Fi.

• Repérez l'appareil. Le routeur l'identifie souvent par une suite de chiffres ou le nom « Espressif ».

• Configurez un bail DHCP statique sur cette adresse IP précise.

Mettons les mains dans le moteur. Ouvrez votre fichier configuration.yaml via File Editor ou Studio Code Server. Vous allez ajouter un bloc de code pour interroger directement l'API.

sensor:
  - platform: rest
    name: "Ecojoko Puissance Instantanée"
    resource: "http://VOTRE_IP_ECOJOKO/api/v1/status"
    method: GET
    scan_interval: 15
    value_template: "{{ value_json.power | int }}"
    unit_of_measurement: "W"
    device_class: power
    state_class: measurement

Remplacez simplement VOTRE_IP_ECOJOKO par l'adresse fixée plus haut. Sauvegardez le fichier et redémarrez votre système.

Vos entités HA existent enfin. Mais vous devez les déclarer pour forcer la carte Lovelace à les accepter. Les attributs device_class: power et state_class: measurement ajoutés dans le code précédent préparent déjà le terrain. Le suivi en kWh réclame une petite manipulation supplémentaire. Vous allez créer un capteur de type Somme de Riemann (Integration sensor) à partir de cette puissance brute en Watts. Il ne vous restera plus qu'à l'afficher fièrement sur votre tableau de bord énergétique.

C'est l'erreur classique par excellence. Le boîtier perd souvent sa connexion. Un défaut de communication avec le compteur fausse vos relevés de la même manière. Nous l'expliquons d'ailleurs en détail dans notre guide sur le diagnostic quand le contact sec Linky ne fonctionne pas. Concrètement, un boîtier sans adresse IP fixe coupe le flux de données. Vérifiez l'interface de votre routeur. Un redémarrage complet de la machine domotique résout souvent le blocage après une grosse mise à jour.

Vous constatez un écart entre l'affichage du fabricant et votre écran personnel. Tout se joue dans le paramètre scan_interval du fichier YAML. Cette valeur dicte la fréquence de vos requêtes réseau. Une valeur basse booste la réactivité. Je vous déconseille toutefois de bombarder la puce Wi-Fi de requêtes par seconde. Le matériel risque de planter. Un intervalle de 10 à 30 secondes offre un équilibre parfait.

L'ajout de panneaux solaires corse brutalement l'exercice. La clé locale doit impérativement interpréter le surplus réinjecté sur le réseau. Affichez le fichier JSON brut dans votre navigateur web. Assurez-vous que les valeurs de puissance basculent en négatif lors de l'injection. Sinon, traquez la clé spécifique du JSON qui gère ce flux sortant. Vous devrez adapter votre value_template en conséquence. D'ailleurs, si vos autres systèmes de monitoring tombent en panne, n'hésitez pas à jeter un œil à notre guide de dépannage S-Miles Enduser 2026 pour remettre vos suivis d'équerre.