-
🔄 Effectuez une synchronisation après la mise à jour
- Permet de détecter correctement les équipements
- Recrée les commandes en fonction du type réel (API / BLE)
-
🔵 Les adresses MAC sont migrées automatiquement
📡 Portée Bluetooth
La portée Bluetooth dépend de la distance, des murs et des interférences radio. Une antenne Bluetooth externe peut améliorer la réception si vos appareils sont loin de votre box Jeedom.
🔵 Conflit avec d'autres plugins Bluetooth
Si vous utilisez d'autres plugins qui utilisent le Bluetooth (comme BLEA), des conflits peuvent apparaître pendant un scan. Il est recommandé de stopper temporairement le démon de ces plugins le temps du scan, puis de le redémarrer ensuite.
🔁 Synchronisation de l'état depuis l'application SwitchBot
Si vous actionnez un appareil directement depuis l'application SwitchBot (et non depuis Jeedom), l'état dans Jeedom sera mis à jour au prochain rafraîchissement automatique (toutes les 5 minutes en mode API).
Présentation
Le plugin SwitchBot intègre les équipements SwitchBot dans Jeedom. Il permet de piloter vos interrupteurs, volets, serrures, capteurs de température, détecteurs de mouvement, ampoules et prises connectées, directement depuis votre domotique.
Il fonctionne de trois façons différentes selon votre installation :
- ☁️ API Cloud — via Internet avec un Hub SwitchBot
- 📡 Bluetooth local — directement depuis votre box Jeedom, sans Hub
- 🔄 Mode Auto — les deux combinés pour tirer le meilleur de chaque appareil
Équipements supportés
| Appareil | API Cloud | Bluetooth |
|---|---|---|
| Bot (interrupteur physique) | ✅ | ✅ |
| Curtain (volet) | ✅ | ✅ |
| Curtain 3 (volet) | ✅ | ✅ |
| Lock (serrure) | ✅ | ✅ |
| Meter (thermomètre + hygromètre) | ✅ | ✅ |
| Meter Plus | ✅ | ✅ |
| Outdoor Meter (capteur extérieur) | ✅ | ✅ |
| Meter Pro CO2 | ✅ | — |
| Motion Sensor (détecteur de mouvement) | ✅ | ✅ |
| Contact Sensor (détecteur d'ouverture) | ✅ | ✅ |
| Presence Sensor | ✅ | — |
| Water Leak Detector | ✅ | — |
| Color Bulb (ampoule couleur) | ✅ | ✅ |
| LED Strip Light (bandeau LED) | ✅ | ✅ |
| Plug Mini EU (prise connectée) | ✅ | ✅ |
| Humidifier | ✅ | — |
Prérequis
Pour le mode API Cloud :
- Un Hub SwitchBot (Hub Mini, Hub 2 ou Hub Plus) connecté à votre réseau Wi-Fi
- Un compte SwitchBot avec un Token et un Secret (obtenus dans l'application officielle)
Pour le mode Bluetooth :
- Un Jeedom avec un adaptateur Bluetooth (intégré ou clé USB Bluetooth)
- Les appareils SwitchBot à portée Bluetooth de la box (environ 10 mètres selon les obstacles)
- Les dépendances du plugin installées (bouton disponible dans la page de gestion du plugin)
Installation
- Installez le plugin depuis le Market Jeedom
- Activez le plugin
- Allez dans Plugins → Gestion des plugins → SwitchBot → Configuration
- Cliquez sur Installer les dépendances et attendez la fin (quelques minutes)
- Choisissez votre mode de fonctionnement puis suivez la configuration correspondante ci-dessous
Les trois modes de fonctionnement
Mode API Cloud ☁️
Le plugin communique avec vos appareils via Internet, en passant par les serveurs SwitchBot. Vos appareils doivent être couplés à un Hub SwitchBot.
✔ Avantages
- Compatible avec tous les appareils (y compris ceux sans Bluetooth direct)
- Aucun conflit avec d'autres plugins Bluetooth
- Stable et fiable
✘ Inconvénients
- Nécessite un Hub SwitchBot et une connexion Internet
- La mise à jour des états se fait toutes les 5 minutes (pas en temps réel)
Mode Bluetooth local 📡
Le plugin communique directement avec vos appareils via Bluetooth, sans passer par Internet. Idéal sans Hub SwitchBot ou pour une installation 100 % locale.
✔ Avantages
- Fonctionne sans Internet, sans Hub, sans compte SwitchBot
- Les capteurs envoient leurs données en temps réel (dès qu'une valeur change)
- Confidentialité totale, rien ne sort de votre réseau
✘ Inconvénients
- Appareils à portée Bluetooth uniquement
- Risque de conflit si d'autres plugins utilisent le Bluetooth en même temps
Mode Auto (combiné) 🔄
Le plugin utilise les deux méthodes simultanément, selon ce qui est le plus adapté.
En mode Auto, le plugin exploite intelligemment les deux canaux :
Les capteurs (température, humidité, mouvement, ouverture de porte…) utilisent le Bluetooth en temps réel : dès qu'un appareil détecte un changement, l'information arrive dans Jeedom en moins d'une seconde, automatiquement.
Les commandes (allumer, éteindre, ouvrir/fermer les volets, verrouiller…) passent par l'API Internet si un Hub est disponible, ou directement en Bluetooth si l'appareil est à portée.
La mise à jour de l'état est aussi assurée toutes les 5 minutes via l'API, en complément des notifications instantanées Bluetooth.
En pratique : votre capteur de température transmet sa valeur dès qu'elle change, votre interrupteur Bot répond immédiatement à une commande — sans que vous ayez à configurer quoi que ce soit de particulier. Vous obtenez le meilleur des deux méthodes.
Configuration de l'API Cloud
Pour utiliser l'API SwitchBot, vous avez besoin d'un Token et d'un Secret issus de votre compte SwitchBot.
Obtenir les clés API depuis l'application SwitchBot
- Ouvrez l'application SwitchBot sur votre téléphone
- Allez dans Profil (icône en bas à droite)
- Appuyez sur Préférences
- Descendez tout en bas et appuyez 10 fois rapidement sur "Version de l'application"
- Une nouvelle section Options développeur apparaît
- Copiez le Token et le Secret
Renseigner les clés dans Jeedom
- Dans la configuration du plugin, collez votre Token dans le champ dédié
- Collez votre Secret
- Cliquez sur Enregistrer Token / Secret
Les clés API sont liées à votre compte SwitchBot. Si vous changez votre mot de passe ou révoquez les clés depuis l'application, pensez à mettre à jour la configuration dans Jeedom.
Configuration du Bluetooth
- Sélectionnez le mode Bluetooth BLE local (ou Auto) dans la configuration
- Choisissez votre adaptateur Bluetooth dans la liste (en général
hci0) - Ajustez la durée du scan si nécessaire (10 secondes par défaut)
Synchronisation et ajout des équipements
Depuis l'API Cloud
Après avoir configuré vos identifiants API, cliquez sur Synchroniser les appareils API. Tous vos appareils couplés au Hub SwitchBot apparaissent automatiquement dans Jeedom avec leurs commandes prêtes à l'emploi.
Depuis le Bluetooth
Cliquez sur Scanner les appareils BLE. Le scan dure environ 10 secondes. Tous les appareils SwitchBot détectés à portée sont créés automatiquement.
Si votre appareil n'est pas détecté, rapprochez-le de votre box Jeedom ou assurez-vous qu'il est bien en mode actif (appuyez une fois sur le bouton physique de l'appareil pour le "réveiller").
Manuellement
Depuis Plugins → Objets connectés → SwitchBot, cliquez sur Ajouter. Renseignez le type d'appareil et son identifiant (visible dans l'application SwitchBot ou dans le résultat d'un scan).
Les commandes disponibles
Les commandes sont créées automatiquement selon le type d'appareil. Voici les plus courantes :
| Commande | Type | Description |
|---|---|---|
| Rafraîchir | Action | Force la mise à jour de l'état de l'appareil |
| Etat | Info | Allumé (1) ou éteint (0) |
| On | Action | Allume / active l'appareil |
| Off | Action | Éteint / désactive l'appareil |
| Température | Info | Température en °C |
| Humidité | Info | Humidité en % |
| Batterie | Info | Niveau de batterie en % |
| Luminosité | Info | Niveau de luminosité actuel (%) |
| Régler luminosité | Action | Définit la luminosité (1–100) |
| Couleur | Info | Couleur actuelle (format HEX #RRGGBB) |
| Régler couleur | Action | Définit la couleur (RGB / HEX) |
| Température de couleur | Info | Température actuelle (Kelvin) |
| Régler température | Action | Définit la température de couleur |
| Mode couleur | Info | Mode actif (couleur ou blanc) |
| Effet | Info | Effet lumineux actif |
| Régler effet | Action | Active un effet prédéfini |
| Position | Info | Position du volet (0 = ouvert, 100 = fermé) |
| Aller à la position | Action | Déplace le volet à la position souhaitée (0–100) |
| Mouvement détecté | Info | Mouvement en cours (1) ou non (0) |
| Ouverture | Info | Porte ouverte ou fermée |
| Verrouiller | Action | Verrouille la serrure connectée |
| Déverrouiller | Action | Déverrouille la serrure connectée |
Le démon Bluetooth
En mode Bluetooth ou Auto, le plugin lance un service en arrière-plan (le démon) qui écoute en permanence les signaux Bluetooth de vos appareils SwitchBot.
Vous n'avez rien à faire. Le plugin :
- Démarre le démon automatiquement au lancement de Jeedom
- Le surveille en permanence et le relance si nécessaire
- L'arrête proprement quand vous changez de mode ou désactivez le plugin
Quand redémarrer le démon manuellement ?
Uniquement si vos appareils Bluetooth ne répondent plus ou ne se mettent plus à jour. Dans ce cas :
- Allez dans Plugins → Gestion des plugins → SwitchBot
- Cliquez sur Redémarrer le démon dans le bandeau du plugin
Si le démon ne parvient pas à démarrer, vérifiez :
- Que les dépendances sont bien installées
- Que votre adaptateur Bluetooth est reconnu par le système (visible dans la page Santé)
- Qu'aucun autre plugin Bluetooth ne monopolise l'adaptateur au même moment
Page Santé
La page Santé vérifie en un coup d'œil l'état de toute votre installation :
- Connexion API — Token et Secret valides et fonctionnels (vrai test de connexion)
- Python — moteur nécessaire au Bluetooth présent et opérationnel
- Démon — actif ou arrêté
Accès : depuis la liste des équipements SwitchBot, cliquez sur l'icône Santé en haut de page.
Utilisation dans Jeedom
Une fois les équipements créés, ils apparaissent dans Plugins → Objets connectés → SwitchBot.
Leurs commandes peuvent être utilisées directement dans :
- les scénarios Jeedom
- les widgets du tableau de bord
- les interactions vocales
- les alertes et notifications
Les commandes sont générées automatiquement à partir des profils d'appareils intégrés au plugin — aucune configuration manuelle des commandes n'est nécessaire.
Résolution des problèmes
Le scan Bluetooth ne trouve aucun appareil
- Vérifiez que votre adaptateur Bluetooth est bien sélectionné dans la configuration
- Rapprochez vos appareils SwitchBot de la box Jeedom pendant le scan
- Appuyez une fois sur le bouton physique de l'appareil pour le rendre visible
- Si un autre plugin utilise le Bluetooth (BLEA, etc.), arrêtez son démon le temps du scan
- Vérifiez l'état du démon et des dépendances dans la page Santé
L'API ne fonctionne pas
- Vérifiez que votre Token et votre Secret sont corrects et à jour
- Utilisez la page Santé pour tester la connexion en temps réel
- Vérifiez votre connexion Internet et l'état de votre Hub SwitchBot dans l'application officielle
- Si vous avez récemment changé votre mot de passe SwitchBot, régénérez vos clés dans l'application
Les valeurs des capteurs ne se mettent plus à jour
- En mode Bluetooth : redémarrez le démon depuis la page de gestion du plugin
- En mode API : vérifiez l'état de votre Hub SwitchBot et votre connexion Internet
- Consultez les logs du plugin (Analyse → Logs → switchbot) pour identifier une éventuelle erreur
La commande "Aller à la position" n'envoie pas la bonne valeur
- Vérifiez que la commande est de type Curseur (slider) dans la configuration de l'équipement
- La valeur doit être un nombre entre 0 (ouvert) et 100 (fermé)
- Si la valeur est vide ou absente, le plugin signale maintenant une erreur explicite dans les logs
L'état dans Jeedom ne correspond pas à l'état réel de l'appareil
- En mode API, l'état est rafraîchi automatiquement toutes les 5 minutes. Cliquez sur Rafraîchir pour une mise à jour immédiate
- En mode Bluetooth, le démon met à jour l'état dès que l'appareil envoie un signal. Si rien ne se passe, redémarrez le démon