BETA

Ceci est une version Bêta. Il y aura probablement des bogues, irritants, etc. Merci pour votre patience et d'ouvrir des "Issues".

Hilo - Home Assistant

Intégration pour Home Assistant d'Hilo

⚠️ Changement majeur à venir, merci de garder votre component à jour ⚠️

L'API sur laquelle nous comptons pour les défis Hilo sera fermée prochainement. Nous travaillons actuellement sur une alternative utilisant Websocket/SignalR. La mise à jour vers la version 2025.2.1 ou ultérieur est fortement recommandée, car les versions précédentes risquent de ne plus fonctionner en raison de la façon dont pip installe les dépendances.

Plusieurs utilisateurs et moi-même sommes en train de migrer nos communications avec l'API Hilo vers Websocket/SignalR plutôt que des appels d'API. Le procéssus se fera graduellement et nous ferons tout ce qu l'on peut pour éviter de briser des installations existantes.

Dans un premier temps, nous mettrons à jour la librairie python-hilo (https://github.com/dvd-dev/python-hilo), ce changement devrait être transparent pour tous.

Ensuite, nous migrerons le capteur de défi (sensor.defi_hilo) vers Websocket/SignalR. La bonne nouvelle avec ça, c'est que les "glitchs" momentanés du capteur de défi sont complètement éliminés par cette méthode.

Ce qui reste à faire de ce côté:

• Les attributs allowed_kWh et used_kWh sont non-fonctionnels actuellement, les informations arrivent morcelées et tous les cas ne sont pas traités encore.
• - L'état "completed" ne fonctionne pas toujours, possiblement une "race condition"
• Certaines informations comme total_devices, opt_out_devices et pre_heat_devices ne persistent pas en mémoire.

Plus de détails disponibles dans issue #486.

L'API servant à la lecture initiale de la liste d'appareils sur votre compte Hilo subira également le même traitement.

Plus de détails disponibles dans issue #564.

📌 Introduction

Cette intégration non-officielle HACS permet d'utiliser Hilo avec Home Assistant. Elle n'est pas affiliée à Hilo ou Hydro-Québec.

⚠️ Ne contactez pas Hilo ou Hydro-Québec pour les problèmes liés à cette intégration.

🔗 Configuration minimale recommandée 🔗 Blueprints : NumerID | Arim215 🔗 Exemples d'automatisations YAML : Automatisations 🔗 Exemples d'interfaces Lovelace : Interfaces

---

🔥 Fonctionnalités principales

✅ Supporte les interrupteurs et gradateurs comme lumières

✅ Contrôle des thermostats et lecture des températures

✅ Suivi de la consommation énergétique des appareils Hilo

✅ Sensor pour les défis et la passerelle Hilo

✅ Configuration via l'interface utilisateur

✅ Authentification via le site web d'Hilo

✅ Capteur météo extérieure avec icône changeante

📌 À faire : Support d'autres appareils, amélioration des compteurs de consommation, documentation API

---

📥 Installation

1️⃣ Vérifier la compatibilité

• L'intégration nécessite le matériel Hilo installé et fonctionnel.
• Testée sous HA OS, Docker (ghcr.io), Podman. D'autres configurations peuvent poser problèmes.
• Problème connu sur Podman/Kubernetes see issue #497.

2️⃣ Installation des fichiers

🔹 Option 1 : Via HACS

1. Assurez-vous d'avoir HACS installé.
2. Dans HACS, cliquez sur + EXPLORE & DOWNLOAD REPOSITORIES, recherchez "Hilo" et téléchargez-le.
3. Redémarrer Home Assistant

🔹 Option 2 : Manuellement

1. Téléchargez la dernière version depuis GitHub.
2. Copiez custom_components/hilo dans le dossier custom_components de Home Assistant.
3. Redémarrer Home Assistant

3️⃣ Ajouter l'intégration à Home Assistant

1. Allez à Paramètres > Appareils et services > Intégrations.
2. Cliquez sur + AJOUTER UNE INTÉGRATION et recherchez "Hilo".
3. Authentifiez-vous sur le site web d'Hilo et liez votre compte.

---

📌 Suivis de la consommation électrique

Si vous souhaitez utiliser la génération automatique des capteurs de consommation électrique, suivez ces étapes :

1. Ajouter la plateforme utility_meter Ajoutez la ligne suivante dans votre fichier configuration.yaml :

   utility_meter:

2. Activer la génération automatique

   • Dans l'interface utilisateur de l'intégration, cliquez sur Configurer.
   • Cochez Générer compteurs de consommation électrique.

3. (Optionnel) Redémarrer Home Assistant

   • Attendez environ 5 minutes. L'entité sensor.hilo_energy_total_low sera créée et contiendra des données.
   • Le status devrait être collecting.
   • L'état state devrait être un nombre supérieur à 0.
   • Toutes les entités et capteurs créés seront préfixés ou suffixés par hilo_energy_ ou hilo_rate_.

4. Erreur connue (à ignorer) Si vous voyez cette erreur dans le journal de Home Assistant, elle peut être ignorée :

   2021-11-29 22:03:46 ERROR (MainThread) [homeassistant] Error doing job: Task exception was never retrieved
   Traceback (most recent call last):
   [...]
   ValueError: could not convert string to float: 'None'
   

5. Ajout manuel au tableau de bord "Énergie" Une fois créés, les compteurs devront être ajoutés manuellement.

---

⚠️ Avertissement

Lorsque l'on active les compteurs, il est recommandé de retirer les anciens capteurs manuels afin d'éviter des données en double.

Si vous rencontrez un problème et souhaitez collaborer, activez la journalisation debug et fournissez un extrait du fichier home-assistant.log. La méthode est expliquée ci-dessous.

---

⚙️ Autres options de configuration

Vous pouvez configurer des options supplémentaires en cliquant sur Configurer dans Home Assistant :

✅ Générer compteurs de consommation électrique

• Génère automatiquement les compteurs de consommation électrique.
• Nécessite la ligne suivante dans configuration.yaml :

  utility_meter:

✅ Générer seulement les compteurs totaux pour chaque appareil

• Calcule uniquement le total d'énergie sans division entre coût faible et coût élevé.

✅ Enregistrer les données de demande et les messages Websocket

• Nécessite un niveau de journalisation debug sur l'intégration et pyhilo.
• Permet un suivi détaillé pour le développement et le débogage.

✅ Verrouiller les entités climate lors des défis Hilo

• Empêche toute modification des consignes de température pendant un défi Hilo.

✅ Suivre des sources de consommation inconnues dans un compteur séparé

• Toutes les sources non Hilo sont regroupées dans un capteur dédié.
• Utilise la lecture du compteur intelligent de la maison.

📌 Nom du tarif Hydro-Québec (rate d ou flex d)

• Définissez le nom du plan tarifaire.
• Valeurs supportées :
  • 'rate d'
  • 'flex d'

⏳ Intervalle de mise à jour (min : 60s)

• Définit le nombre de secondes entre chaque mise à jour.
• Valeur par défaut : 60s.
• Ne pas descendre sous 30s pour éviter une suspension de Hilo.
• Depuis 2023.11.1, le minimum est passé de 15s à 60s.

📌 FAQ et support

🔗 FAQ complète 💬 Rejoignez la communauté sur Discord

Problèmes ? Ouvrez une "Issue" avec les logs debug activés dans configuration.yaml :

logger:
  default: info
  logs:
     custom_components.hilo: debug
     pyhilo: debug

---

👥 Collaborateurs initiaux

• Francis Poisson
• David Vallee Delisle

🎖️ Mentions très honorables

• Ian Couture : Il maintient cet addon depuis un certain temps.
• Hilo : Merci à Hilo pour son soutien et ses contributions.

---

💡 Envie de contribuer ? Consultez la section contribution pour voir comment aider au projet.