par Table des matières
🎉 Introduction
Je suis ravi de vous présenter le plugin ConnectLife pour Jeedom, qui vous permet de piloter et superviser vos appareils électroménagers connectés des marques Hisense, Gorenje, ASKO, ATAG, Pelgrim et MORA directement depuis votre box domotique Jeedom !
📱 Qu’est-ce que ConnectLife ?
ConnectLife est l’application mobile développée par Hisense qui permet de contrôler à distance une large gamme d’appareils électroménagers connectés. Que ce soit votre réfrigérateur, votre lave-linge, votre climatiseur ou votre cave à vin, tous ces appareils peuvent être pilotés via l’application ConnectLife.
Le plugin Jeedom que j’ai développé utilise la même API que l’application mobile officielle pour communiquer avec vos appareils, garantissant ainsi une compatibilité maximale.
🔧 Fonctionnalités principales
Synchronisation automatique
Le plugin détecte automatiquement tous les appareils enregistrés sur votre compte ConnectLife et les ajoute comme équipements dans Jeedom. Chaque appareil est créé avec :
- ✅ Son nom personnalisé
- ✅ Son type (réfrigérateur, climatiseur, lave-linge…)
- ✅ Toutes ses commandes info (température, état, modes…)
- ✅ Toutes ses commandes action (changer température, activer modes…) (N’hésitez pas à remonter les bugs ou commandes manquantes)
Mise à jour en temps réel
Deux modes de fonctionnement sont disponibles :
- Mode Polling : Rafraîchissement périodique via cron (configurable de 1 minute à 1 heure)
- Mode WebSocket (optionnel) : Réception des mises à jour en temps réel via démon
Diagnostic intégré
Une fonctionnalité unique : le diagnostic automatique de vos appareils !
Directement depuis Jeedom, vous pouvez lancer un self-check complet de votre appareil qui vérifie :
- 🔍 État des capteurs de température
- 🔍 Fonctionnement des ventilateurs
- 🔍 Communication des cartes électroniques
- 🔍 État de la carte d’affichage
- 🔍 Détection des pannes potentielles
En cas de problème détecté, le plugin affiche :
- ❌ Le composant défaillant
- 📖 Une description claire du problème
- 🛠️ Un guide de résolution étape par étape
L’historique des 10 derniers diagnostics est conservé pour suivre l’évolution de l’état de santé de vos appareils.
Gestion avancée de l’authentification
Le plugin intègre un système d’authentification OAuth2 robuste avec :
- 🔐 Génération automatique des tokens
- ♻️ Rafraîchissement automatique avant expiration
- 📊 Statistiques détaillées sur les tokens
- 🧪 Testeur de validité des tokens
- 🎛️ Interface de gestion complète
Tout cela est géré de manière transparente, vous n’avez qu’à saisir vos identifiants ConnectLife une seule fois !
📦 Appareils supportés
Le plugin supporte actuellement les types d’appareils suivants :
| Type | Code | Exemples de fonctionnalités |
|---|---|---|
| Climatiseur | 009 | Température, mode, vitesse ventilation, swing |
| Déshumidificateur | 012 | Humidité, mode, vitesse |
| Cave à vin | 015 | Température zones, alarmes |
| Lave-vaisselle | 016 | Programme, temps restant, consommation |
| Lave-linge | 020 | Programme, température, essorage, temps restant |
| Réfrigérateur | 026 | Températures, alarmes portes, modes Eco/Super Freeze |
| Congélateur | 027 | Température, alarmes, mode Super Freeze |
| Sèche-linge | 030 | Programme, temps restant, séchage |
| Four | 032 | Température, programme, préchauffage |
Chaque type d’appareil dispose de commandes spécifiques adaptées à ses fonctionnalités.
🚀 Installation et configuration
Étape 1 : Installation
L’installation est simple et rapide :
- Dans Jeedom, allez dans Plugins → Gestion des plugins
- Recherchez “ConnectLife” dans le Market
- Cliquez sur Installer stable
- Activez le plugin
- Lancez l’installation des dépendances (bouton “Relancer”)
- Attendez la fin de l’installation (extensions PHP : openssl, json, pcntl, sockets)
Étape 2 : Configuration
Rendez-vous dans Plugins → Communication → ConnectLife → Configuration :
-
Section Identifiants
- Saisissez votre email ou numéro de téléphone ConnectLife
- Saisissez votre mot de passe
- Cliquez sur Se connecter
✅ Le plugin génère automatiquement les tokens OAuth2 nécessaires
-
Section Synchronisation
- Choisissez la fréquence de rafraîchissement (recommandé : toutes les 5 minutes)
- Cliquez sur Sauvegarder
-
Section Démon (optionnel)
- Si vous souhaitez les mises à jour temps réel, activez le démon
- Le démon se connecte au WebSocket ConnectLife
Étape 3 : Découverte des appareils
Dès la sauvegarde, le plugin lance une première synchronisation :
- 🔍 Tous vos appareils ConnectLife sont détectés
- 📝 Un équipement Jeedom est créé pour chacun
- 🎛️ Toutes les commandes sont générées automatiquement
Rendez-vous dans Plugins → Communication → ConnectLife pour voir vos équipements !
🎨 Interface utilisateur
Page des équipements
L’interface reprend le design natif de Jeedom avec :
- 📊 Vue liste ou tuile
- 🔍 Recherche et filtres
- ⚙️ Actions rapides (éditer, dupliquer, supprimer)
- 🎯 Catégorisation automatique par type d’appareil
Page d’un équipement
Pour chaque appareil, vous disposez de :
- 📝 Onglet Équipement : Configuration générale
- 🎛️ Onglet Commandes : Liste des commandes info/action
- 🏥 Bouton Diagnostic : Lancement du self-check
- 🔔 Bouton Notifications : Historique des notifications
Modale de diagnostic
L’interface de diagnostic est moderne et intuitive : Onglet Historique (affiché par défaut) :
- 📅 Liste des diagnostics avec date et heure
- ✅ Compteur OK/KO pour chaque diagnostic
- 📂 Panneaux dépliables pour voir le détail
- 🎨 Code couleur (vert = OK, rouge = problème)
Onglet Diagnostic actuel :
- ▶️ Bouton “Lancer le diagnostic”
- ⏱️ Indicateur de progression
- 📊 Résultats en temps réel
- 🛠️ Guides de résolution pour les pannes
🔐 Sécurité et confidentialité
Le plugin respecte votre vie privée :
- 🔒 Les identifiants sont stockés de manière sécurisée (chiffrés dans la base Jeedom)
- 🔐 Les tokens OAuth2 sont automatiquement rafraîchis
- 🌐 Communication directe avec les serveurs ConnectLife (pas de serveur tiers)
- 📡 Aucune donnée n’est envoyée à des services externes
Le code source est open-source (licence AGPL-3.0), vous pouvez l’auditer librement sur GitHub.
🐛 Gestion des erreurs
Le plugin intègre une gestion d’erreur robuste :
Logs détaillés
Tous les événements sont enregistrés dans les logs Jeedom :
- 📋 Log principal :
connectlife - 🔌 Log démon :
connectlife_daemon - 📦 Log dépendances :
connectlife_dep
Outils de diagnostic
Si vous rencontrez un problème :
- Testez le token : Bouton “Tester” dans la configuration
- Consultez les statistiques : Bouton “Statistiques” pour voir l’état détaillé
- Logs en mode Debug : Activez le niveau Debug pour plus de détails
- Forum communautaire : Posez vos questions sur le forum Jeedom en fournissant les logs
Problèmes courants et solutions
Token invalide → Cliquez sur “Se connecter” pour régénérer Démon ne démarre pas → Vérifiez qu’au moins un équipement est actif Commandes non mises à jour → Augmentez la fréquence du cron Signature check fail → Le plugin gère maintenant automatiquement les signatures, effacez les tokens et reconnectez-vous
🤝 Contributions
Le plugin est open-source et les contributions sont les bienvenues !
Vous pouvez participer en :
- 🐛 Signalant des bugs sur Jeedom community
- 💡 Proposant de nouvelles fonctionnalités
- 📝 Améliorant la documentation
- 🔧 Ajoutant le support de nouveaux appareils (si vous avez un appareil non supporté, contactez-moi sur Jeedom community !)
- 🌍 Traduisant le plugin dans d’autres langues
📚 Ressources
Documentation
🎬 Conclusion
Le plugin ConnectLife pour Jeedom représente plusieurs mois de travail pour vous offrir une intégration native et complète de vos appareils électroménagers connectés.
Avec ses fonctionnalités avancées (diagnostic, notifications, gestion intelligente des tokens…), il va au-delà d’une simple synchronisation et vous permet de réellement piloter et superviser vos appareils depuis votre box domotique.
J’espère que ce plugin vous sera utile et je reste à l’écoute de vos retours et suggestions d’amélioration !
N’hésitez pas à partager vos scénarios et vos usages dans les commentaires ou sur le forum Jeedom 😊
Bon automatisation à tous ! 🏠🤖
