homebridge-hilo

Plugin Homebridge pour Hilo par Hydro-Québec, permet de contrôler vos appareils Hilo par le biais de HomeKit et de l'app Domicile d'Apple.

Note: Ceci n'est pas un plugin officiel, le plugin n'est pas affilié avec Hilo ni Hydro-Québec

Table des matières

• Installation
• Configuration
• Défis Hilo
• Appareils supportés
• Dépannage
• Contributions

Installation

1. Installer Homebridge en suivant les instructions
2. Installer le plugin en utilisant Homebridge Config UI X (REQUIS)

Configuration

Prérequis

• Un compte Hilo actif
• Accès à votre serveur Homebridge via une adresse IP ou un nom de domaine
• Port 8880 accessible sur votre serveur Homebridge

Étapes de Configuration

1. Préparation

   • Notez l'adresse IP ou le nom de domaine de votre serveur Homebridge
   • Assurez-vous que le port 8880 est accessible:
     • Dans la plupart des cas, le port 8880 est accessible sans configuration supplémentaire
     • Pour Docker: Ajoutez -p 8880:8880 à votre commande
     • Pour reverse proxy: Configurez le port 8880

2. Processus d'Authentification

   1. Cliquez sur "Login with Hilo" dans l'interface de configuration
   2. Connectez-vous à votre compte Hilo
   3. Entrez l'URL de redirection (ex: http://192.168.0.10:8880 ou http://homebridge.local:8880)
   4. Cliquez sur "Save" puis "Link account"

      Note: La redirection vers Home Assistant est normale - le plugin utilise leur service de redirection

3. Finalisation

   • Sauvegardez la configuration
   • Redémarrez votre serveur Homebridge

Défis Hilo

⚠️ Depuis la version 6.0.0 les défis Hilo ne sont plus supporté par le plugin ⚠️

Appareils supportés

| Type d'appareil | Statut | Notes | |----------------|--------|-------| | Thermostat | ✅ | | | Thermostat de plancher | ✅ | | | Interrupteur mural | ✅ | | | Gradateur mural | ✅ | | | Prise | ✅ | | | Ampoule intelligente | ✅ * | Couleurs non supportées présentement | | Détecteur de fumée/CO | 🚧 | Développement futur | | Station météo | 🚫 | | | Borne de recharge | 🚫 | |

Obtenir de l'aide

• Consultez les problèmes GitHub pour les problèmes connus
• Créez un nouveau problème si votre problème n'est pas documenté

Contributions

Les contributions sont les bienvenues ! Si vous souhaitez :

• Ajouter le support pour de nouveaux appareils
• Améliorer les fonctionnalités existantes
• Corriger des bogues
• Améliorer la documentation

Veuillez soumettre une Pull Request avec vos modifications.

homebridge-hilo (English)

Homebridge plugin for Hilo by Hydro-Québec, enabling control of your Hilo devices via HomeKit and the Apple Home App.

Note: This is not an official plugin, this plugin is not affiliated with Hilo nor Hydro-Québec.

Table of Contents

• Installation
• Configuration
• Hilo Events (Challenges)
• Supported Devices
• Troubleshooting
• Contributing

Installation

1. Install Homebridge by following the instructions
2. Install this plugin using Homebridge Config UI X (REQUIRED)

Configuration

Prerequisites

• An active Hilo account
• Access to your Homebridge server via IP address or domain name
• Port 8880 accessible on your Homebridge server

Configuration Steps

1. Preparation

   • Note your Homebridge server's IP address or domain name
   • Ensure port 8880 is accessible:
     • In most cases, port 8880 is accessible without additional configuration
     • For Docker: Add -p 8880:8880 to your command
     • For reverse proxy: Configure port 8880

2. Authentication Process

   1. Click "Login with Hilo" in the configuration interface
   2. Log in to your Hilo account
   3. Enter the redirect URL (e.g., http://192.168.0.10:8880 or http://homebridge.local:8880)
   4. Click "Save" then "Link account"

      Note: Redirection to Home Assistant is normal - the plugin uses their redirect service and does not interfere with your home assistant server if you have one.

3. Finalization

   • Save the configuration
   • Restart your Homebridge server

Hilo Events (Challenges)

⚠️ As of 6.0.0 Hilo challenge are no longer supported by the plugin ⚠️

Supported Devices

| Device Type | Status | Notes | |------------|--------|-------| | Thermostat | ✅ | | | Floor Thermostat | ✅ | | | In-wall Switch | ✅ | | | In-wall Dimmer | ✅ | | | Plug-in Switch | ✅ | | | Smart Bulb | ✅ | Colors not currently supported | | Smoke/CO Detector | 🚧 | Futur development | | Weather Station | 🚫 | | | EV Charger | 🚫 | |

Troubleshooting

Getting Help

• Check the GitHub Issues for known problems
• Create a new issue if your problem isn't documented

Contributing

Contributions are welcome! If you'd like to:

• Add support for new devices
• Improve existing features
• Fix bugs
• Enhance documentation

Please submit a Pull Request with your changes.