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. L’intégration à installer pour ça s’appelle hOn. Voici comment la mettre en place proprement et comment j’ai repris la main sur la LED via un template switch dans Home Assistant.

gvigroux/hon : l’intégration à utiliser

Une intégration community historique existait (Andre0512/hon), mais elle n’est plus maintenue depuis 2024 : ne l’installez pas.

L’alternative qui fonctionne aujourd’hui : 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 Haier Smart Home, 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.

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 Haier Smart Home (mail + mot de passe)

Pour la connexion, j’avais créé mon compte Haier Smart Home via Sign in with Apple depuis l’app iOS. Apple génère automatiquement un mail anonyme, il suffit de l’utiliser tel quel dans le formulaire hOn. Ça fonctionne sans souci.

Si tout se passe bien, HA découvre tes appareils automatiquement. Chez moi, ma cave 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.

Au démarrage, j’ai eu quelques latences sur les premières commandes. Depuis, c’est fluide : j’appuie sur allumer ou éteindre la lumière dans HA, ça répond immédiatement.

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: VOTRE_DEVICE_ID
turn_off:
  - action: hon.turn_light_off
    data:
      device: VOTRE_DEVICE_ID

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. 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 cave, 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.
• Dépendance au cloud Haier. Tout passe par l’API du constructeur : si demain Haier change son backend ou coupe l’accès, l’intégration casse. C’est le risque inhérent à toute intégration cloud-dépendante. Pour les usages critiques (surveillance température, alertes coupure), double avec un capteur indépendant type Zigbee.

Conclusion

Aujourd’hui ma cave à vin Haier tourne dans Home Assistant : la température intérieure remonte en temps réel, la LED est pilotable via un template switch depuis n’importe quel dashboard, et l’intégration est stable. Le setup prend 15 minutes chrono. Pour les caves, fours, lave-linge et clims Haier/Candy/Hoover, gvigroux/hon est clairement la voie à suivre en 2026.

La seule contrainte réelle : tout passe par le cloud Haier. Si l’API change ou tombe, l’intégration suit. Pour les usages critiques, un capteur Zigbee indépendant en parallèle reste la bonne pratique.

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

👉 Pour aller plus loin : installer Home Assistant sur Proxmox, mes automatisations Home Assistant et le setup homelab complet.