Cave à vin Haier dans Home Assistant : intégrer hOn en 2026

J’ai une cave à vin Haier HWS34GGH1 dans le salon, et comme tout bon homelabbeur je voulais la voir dans Home Assistant. Température, consommation, allumage de la LED interne, durée de fonctionnement… bref, le combo complet. Sauf que l’intégration historique Andre0512/hon est morte depuis 2024, et cliquer sur « Ajouter l’intégration » balance un magnifique :

Le flux de configuration n'a pas pu être chargé : {"message":"Invalid handler specified"}

Voici comment je suis passé au fork actif gvigroux/hon en 15 minutes, et comment j’ai repris la main sur la LED via un template switch dans Home Assistant.

Pourquoi Andre0512/hon ne marche plus en 2026

Pour ceux qui débarquent : Andre0512 avait pondu l’intégration Haier hOn qui gérait lave-linge, clim, lave-vaisselle, etc. Elle a eu jusqu’à 1 500 étoiles sur GitHub. Excellent boulot.

Sauf qu’en juillet 2024, Haier a envoyé un takedown notice au dev pour forcer la suppression du repo. La communauté a forké le code 2 000 fois en réaction (impossible à supprimer), mais Andre0512 a arrêté la maintenance. Résultat : la dernière release v0.14.0 date de mi-2024 et n’est plus compatible avec les versions récentes de Home Assistant — d’où l’erreur « Invalid handler specified » quand tu tentes de configurer l’intégration.

Autre limite de fond : Andre0512/hon n’a jamais supporté les caves à vin. Le code est spécifique à chaque type d’appareil (lave-linge, AC, dishwasher…) et les caves n’étaient pas dans le scope. Donc même si tu arrivais à la faire tourner, ta HWS34GGH1 ne remonterait aucune entité utile.

gvigroux/hon : le fork actif à utiliser

Après un passage par le thread officiel de la communauté HA, une alternative ressort clairement : gvigroux/hon. Le repo est actif, maintenu, et sa philosophie est fondamentalement différente :

Au lieu de coder en dur chaque type d’appareil, gvigroux expose directement tous les paramètres de l’API hOn officielle que l’app mobile utilise. Concrètement : si ton appareil fonctionne dans l’app iOS/Android hOn, il fonctionnera dans Home Assistant — quel que soit son type, y compris les caves à vin, pianos-cuisson et autres appareils de niche.

C’est 243 étoiles, 50 downloads via HACS (niche mais suffisant), et surtout un dev réactif. L’autre fork notable mmalolepszy/hon-revived reprend le code d’Andre0512, donc hérite de ses limites : à oublier pour notre cas d’usage.

Désinstaller Andre0512/hon proprement

Avant d’installer le fork, on nettoie. Dans Home Assistant :

• HACS → Intégrations → Haier hOn → Supprimer
• Si l’intégration avait été ajoutée dans Paramètres → Appareils et services, supprime aussi la config entry
• Redémarrage Home Assistant obligatoire — sinon HA garde une référence fantôme au handler manquant

Installer gvigroux/hon via HACS

gvigroux/hon n’est pas dans le store par défaut en catégorie Integration côté HACS. Il faut l’ajouter comme repo custom :

• HACS → 3 points en haut à droite → Dépôts personnalisés
• Coller gvigroux/hon en URL, catégorie Intégration
• Chercher « Hon » dans HACS, cliquer sur la nouvelle entrée, Télécharger
• Redémarrer Home Assistant (obligatoire pour charger le nouveau module Python)
• Paramètres → Appareils et services → Ajouter une intégration → « hOn »
• Renseigner tes credentials de l’app hOn (mail + mot de passe)

Si tout se passe bien, HA découvre tes appareils automatiquement. Chez moi, ma cave HWS34GGH1 est remontée instantanément avec 11 entités : température intérieure, consigne, température ambiante, nom de programme, mode, code d’erreur, statut, détecteur de lumière, et deux boutons utilitaires (Get programs details + Get settings details) qui servent à rafraîchir manuellement l’état depuis l’API.

Piloter la LED interne avec un template switch

Par défaut, l’intégration expose un binary_sensor.cave_a_vins_light en lecture seule — juste l’état « allumée / éteinte ». Pas top pour un dashboard où on veut cliquer et toggle.

La bonne nouvelle : gvigroux/hon expose les services hon.turn_light_on et hon.turn_light_off. Il suffit de les wrapper dans un template switch pour avoir un vrai interrupteur utilisable partout.

Tu peux soit éditer configuration.yaml, soit passer par l’UI (plus propre) : Paramètres → Appareils et services → Helpers → Créer un helper → Template → Template a switch.

Voici la config que j’ai utilisée :

name: Cave à Vin Lumière
value_template: "{{ is_state('binary_sensor.cave_a_vins_light', 'on') }}"
turn_on:
  - action: hon.turn_light_on
    data:
      device: c654b470e773134bc86ac81dd5df1d83
turn_off:
  - action: hon.turn_light_off
    data:
      device: c654b470e773134bc86ac81dd5df1d83

Le device_id est visible dans Paramètres → Appareils et services → Cave à vins → icône engrenage.

Résultat : une nouvelle entité switch.cave_a_vin_lumiere qui reflète l’état réel et commande la LED. Clic → la lumière s’éteint physiquement. Testé, validé.

Attention au polling : le binary_sensor d’origine met parfois 2 à 5 minutes à se mettre à jour côté Home Assistant après une commande. La LED se coupe bien physiquement tout de suite, mais le switch peut afficher le mauvais état pendant quelques minutes. Normal — c’est la limite du polling de l’API hOn. Un optimistic: true dans le template switch peut masquer le délai si ça te gêne.

Intégrer la cave à vin dans les dashboards

Une fois le switch en place, j’ai monté un mini bloc cave à vin complet dans mon dashboard de monitoring :

• Température intérieure (gauge avec la consigne 15 °C en rouge)
• Switch lumière (bubble-card pleine largeur, pattern Nuki/Hue Sync)
• Puissance instantanée (utile pour voir les cycles du compresseur)
• Consommation du mois + coût
• Durée de fonctionnement sur 24 h

Et dans mon dashboard portrait principal, j’ai ajouté une simple icône dans la section « Lumières » pour pouvoir allumer la LED quand je sers un verre sans ouvrir trois menus.

Pour la mesure de consommation, j’utilise une prise connectée externe qui alimente la cave — l’API hOn n’expose malheureusement pas la consommation directement. C’est devenu un réflexe dans mon homelab : toute prise de matos électroménager passe par une prise Shelly ou un TP-Link Tapo, ça ne coûte rien et ça remonte des données précieuses dans Home Assistant.

Limites et pièges à éviter

• Le polling API est lent. gvigroux interroge l’API hOn toutes les 3 à 5 minutes par défaut. Si tu veux du quasi-temps-réel, appuie sur le bouton Get settings details — il force un refresh immédiat. Tu peux aussi le mettre dans une automation qui tourne toutes les minutes, mais attention au rate-limiting côté Haier.
• Tous les paramètres ne sont pas commandables. Sur ma HWS34GGH1, la consigne de température n’est pas modifiable via l’API (read-only). Ça dépend du modèle — certains appareils hOn sont en full read/write, d’autres en lecture seule, d’autres en hybride. Le service hon.send_custom_request permet d’envoyer n’importe quel payload à l’API si tu veux bidouiller, mais c’est du terrain glissant.
• Haier peut re-serrer la vis. Si demain Haier change son API ou bloque les reverse engineering, tout l’écosystème hOn community peut casser d’un coup. C’est le risque quand tu dépends d’un cloud proprio. Pour les usages critiques (surveillance température cave, alertes coupure), double avec un capteur indépendant type Zigbee.

Conclusion

En gros : Andre0512/hon est mort, gvigroux/hon prend le relais et gère mieux que son ancêtre. 15 minutes pour migrer, et ma cave à vin est enfin pilotable depuis Home Assistant — LED comprise. Pour les caves, fours, lave-linge et clims Haier/Candy/Hoover de 2024+, c’est clairement la voie à suivre en 2026.

Si tu veux aller plus loin, le prochain chantier naturel c’est une automation Telegram qui t’alerte si la température monte au-dessus de 18 °C pendant plus de 15 minutes (typiquement une coupure compresseur). Je couvrirai ça dans un prochain article dédié aux alertes Home Assistant + Telegram.

Pour aller plus loin

• Installer Home Assistant sur Proxmox — la base de mon homelab domotique
• Mes automatisations Home Assistant préférées — pour aller plus loin côté scénarios
• Zigbee2MQTT avec Home Assistant dans Docker — pour ajouter un capteur Zigbee de sauvegarde sur la cave
• Linus Dashboard Home Assistant — pour intégrer proprement la cave dans un dashboard visuel

FAQ