Intégration domotique Bosch Smart Home, gratuite et open source

Contrôleur Bosch Smart Home en local : chauffage, contacts, fumée, prises, volets, alarme.

• Publiée par guim31
• Appareils
• Version 1.0.1
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Reliez votre Bosch Smart Home Controller (première ou deuxième génération) à Gladys, sur votre réseau local, sans aucun cloud : le chauffage de chaque pièce (température, consigne, mode), les thermostats de radiateur et d'ambiance, les contacts de porte et de fenêtre, les détecteurs de mouvement, les détecteurs de fumée, les prises, les interrupteurs, les volets, les détecteurs de fuite d'eau, les interrupteurs universels et l'état de l'alarme intrusion.

Développée sans le matériel : vos retours sont les bienvenus. Cette intégration a été construite à partir de l'API locale publique du contrôleur et du travail de la bibliothèque boschshcpy, et testée contre un contrôleur simulé, pas un vrai. Si quelque chose ne fonctionne pas comme décrit, dites-le sur le forum Gladys ou dans les issues.

Cette intégration n'est ni affiliée à Bosch, ni approuvée par Bosch.

Ce qu'il vous faut

• Gladys Assistant 5.1.0 ou plus récent.
• Un Bosch Smart Home Controller (I ou II), installé avec l'application Bosch Smart Home, sur le même réseau local que Gladys.
• Son adresse IP. L'application l'affiche dans Paramètres → Système → Smart Home Controller ; votre box l'affiche aussi. Donnez une adresse fixe au contrôleur (réservation DHCP dans votre box) : l'intégration le joint à cette adresse.
• Son mot de passe système, choisi à l'installation du contrôleur. Il ne sert qu'une fois, pour l'appairage.
• Un accès au contrôleur, pour appuyer sur son bouton pendant l'appairage.

Mise en place

Le contrôleur ne parle qu'aux clients qu'il a appairés. L'appairage enregistre Gladys comme client du contrôleur, avec un certificat que l'intégration génère et garde dans son volume /data.

1. Dans Gladys, ouvrez Intégrations → Bosch Smart Home → Configuration.
2. Saisissez l'Adresse IP du contrôleur (ex. 192.168.1.20) et le Mot de passe système, puis enregistrez.
3. Allez au contrôleur et appuyez sur son bouton (en façade) jusqu'à ce que ses voyants clignotent : le contrôleur est en mode appairage, pour un court moment.
4. De retour dans Gladys, cliquez aussitôt sur Appairer. Après quelques secondes, le résultat s'affiche sous le bouton : Appairé. N appareil(s) trouvé(s).
5. Ouvrez l'onglet Découverte et ajoutez les appareils voulus.

Une fois l'appairage fait, le mot de passe système est effacé de la configuration de Gladys : il ne sert plus. L'appairage apparaît dans l'application Bosch (sous le nom oss_Gladys_Assistant), où vous pouvez le supprimer à tout moment.

Tester la connexion relit le contrôleur et donne sa version logicielle et le nombre d'appareils pris en charge.

Les autres réglages :

• Langue des noms : la langue des noms de fonctionnalités donnés aux nouveaux appareils et des textes envoyés par l'intégration (français par défaut).
• Durée d'un mouvement : un détecteur de mouvement ne donne que l'heure de chaque détection ; c'est le temps pendant lequel sa fonctionnalité Mouvement reste ensuite active (1 minute par défaut).
• Autoriser l'armement depuis Gladys : désactivé par défaut, voir Alarme intrusion plus bas.
• Ne pas vérifier le certificat du contrôleur : désactivé. Seulement pour un contrôleur dont le certificat a expiré parce qu'il est resté hors ligne des années : la connexion échoue alors sur une erreur de certificat.

Appareils

Chaque appareil pris en charge du contrôleur devient un appareil Gladys, nommé comme dans l'application Bosch. Les états arrivent en temps réel : l'intégration garde un abonnement aux événements ouvert sur le contrôleur (long polling, comme le recommande Bosch), et relit tout toutes les 15 minutes par sécurité. Un appareil que le contrôleur déclare indisponible affiche le badge injoignable.

Chauffage

Bosch gère le chauffage par pièce : pour chaque pièce équipée de thermostats de radiateur, le contrôleur a une régulation de pièce, qui devient l'appareil Chauffage <pièce> :

Fonctionnalité	Ce qu'elle fait
Température	Température de la pièce mesurée par le contrôleur.
Consigne	Température voulue, de 5 à 30 °C par demi-degré. En mode manuel, elle est conservée.
Mode de chauffage	Arrêt (été), Manuel (consigne fixe) ou Programme (le programme hebdomadaire de l'application Bosch).
Demande de chauffe	Si un radiateur de la pièce demande de la chaleur.

En mode Programme, une nouvelle consigne vaut jusqu'à l'étape suivante du programme, comme dans l'application Bosch. Quand la pièce est en mode éco, une nouvelle consigne quitte le mode éco.

Les thermostats de radiateur et les thermostats d'ambiance sont aussi des appareils : Température, Humidité (thermostats d'ambiance qui la mesurent) et Batterie faible.

Capteurs

Appareil	Fonctionnalités
Contact de porte/fenêtre	Ouverture, Batterie faible
Détecteur de mouvement	Mouvement, Batterie faible
Détecteur de fumée	Fumée, Batterie faible
Détecteur de fuite d'eau	Fuite d'eau, Batterie faible
Interrupteur universel	Batterie faible

Fumée est active quand le détecteur lui-même détecte de la fumée. Quand c'est un autre détecteur de la maison, tous les détecteurs sonnent, mais seul celui de la pièce enfumée affiche Fumée : le déclencheur Détecteur de fumée en alarme distingue les deux cas.

Prises, interrupteurs et volets

Appareil	Fonctionnalités
Prise connectée, prise compacte	Marche/Arrêt, Puissance (W), Énergie (kWh)
Interrupteur d'éclairage, micromodules lumière et relais	Marche/Arrêt (et Puissance, Énergie si mesurées)
Commande de volet, modules volet et store	Position (0 % fermé, 100 % ouvert), Ouvrir/Fermer (ouvrir, fermer, arrêter)

Énergie est le compteur de la prise : Gladys y ajoute les fonctionnalités de consommation et de coût dans les écrans d'énergie.

Alarme intrusion

Quand le contrôleur a le système d'alarme intrusion, l'appareil Alarme intrusion affiche :

• Armée : active quand le système est armé ;
• Alarme déclenchée : active pendant une pré-alarme ou une alarme ;
• État de l'alarme : Désarmée, Armement en cours, Armée, Pré-alarme, Alarme ! ou Alarme coupée.

L'alarme est en lecture seule par défaut. Avec Autoriser l'armement depuis Gladys, l'action de scène Armer l'alarme intrusion peut l'armer. La désarmer ou la couper n'est jamais possible depuis Gladys : une scène, un assistant vocal ou un tableau de bord partagé ne doivent pas pouvoir couper la protection de la maison. Utilisez l'application Bosch pour cela.

Tableau de bord

Le widget Bosch Smart Home (dans la liste des widgets d'un tableau de bord) résume la maison : l'état du contrôleur, de l'alarme intrusion, le nombre de portes et fenêtres ouvertes, de piles faibles, d'appareils muets, puis leurs noms. Il est en lecture seule.

Les fonctionnalités elles-mêmes se placent sur un tableau de bord comme d'habitude (widget Appareils de la pièce, widget thermostat…).

Scènes

Déclencheurs

Détecteur de fumée en alarme : un détecteur de fumée détecte de la fumée, ou sonne parce qu'un autre en détecte. Filtres : le détecteur, l'origine (Fumée détectée par ce détecteur ou Alarme relayée d'un autre détecteur). Informations transmises à la scène : Nom du détecteur, Pièce, Origine (detected ou relayed).

Interrupteur universel appuyé : un appui court ou long sur une touche d'un interrupteur universel Bosch. Filtres : l'interrupteur, la touche (haut, bas, et les quatre du modèle à quatre touches), l'appui (Appui court, Appui long). Informations transmises : Nom de l'interrupteur, Pièce, Touche, Appui.

Les autres états (une fenêtre ouverte, une fuite, l'alarme armée) sont des fonctionnalités d'appareil : utilisez le déclencheur habituel État d'un appareil de Gladys.

Actions

Armer l'alarme intrusion : arme le système d'alarme du contrôleur avec un profil de protection : Protection totale, Protection partielle ou Protection personnalisée (tels que réglés dans l'application Bosch). Elle ne fonctionne que si Autoriser l'armement depuis Gladys est activé ; sinon l'action échoue et la scène continue.

Idées de scènes

• Incendie : déclencheur Détecteur de fumée en alarme → allumer toutes les lumières, ouvrir les volets, envoyer à tous un message avec la Pièce du détecteur (depuis le sélecteur de variables).
• Bouton de chevet : déclencheur Interrupteur universel appuyé, touche bas, appui long → fermer tous les volets et éteindre les lumières.
• Fenêtre ouverte, chauffage coupé : déclencheur État d'un appareil sur l'Ouverture de la fenêtre du salon = ouvert pendant 2 minutes → passer le Mode de chauffage de la pièce sur Arrêt (été) ; revenir à Programme une fois fermée.
• Départ de la maison : quand la maison devient vide → Armer l'alarme intrusion (Protection totale), après avoir autorisé l'armement dans la configuration.

Dépannage

• Pas encore appairé : suivez Mise en place ci-dessus ; l'appairage est gardé dans le volume /data de l'intégration et survit aux mises à jour.
• le contrôleur n'est pas en mode appairage : le bouton n'a pas été tenu assez longtemps, ou le mode appairage a pris fin avant le clic. Appuyez jusqu'au clignotement, puis cliquez sur Appairer dans les secondes qui suivent.
• mot de passe système refusé : vérifiez le mot de passe dans l'application Bosch (il peut y être changé), saisissez-le de nouveau, enregistrez et appairez de nouveau.
• le contrôleur ne répond pas à cette adresse : vérifiez l'adresse IP (elle a pu changer : donnez une adresse fixe au contrôleur), et que Gladys joint le contrôleur sur les ports 8443 (appairage) et 8444 (API).
• le contrôleur refuse Gladys (appairez-le de nouveau) : l'appairage a été supprimé dans l'application Bosch, ou le contrôleur a été réinitialisé. Appairez de nouveau.
• le certificat du contrôleur n'est pas un certificat Bosch valide : un autre appareil répond à cette adresse, ou le certificat du contrôleur a expiré. Vérifiez l'adresse ; si c'est la bonne, cochez Ne pas vérifier le certificat du contrôleur.
• Un nouvel appareil de l'application Bosch apparaît de lui-même dans l'onglet Découverte en quelques secondes ; un appareil supprimé y disparaît.
• Journaux détaillés : réglez la variable d'environnement LOG_LEVEL=debug de l'intégration. Les journaux ne contiennent jamais le mot de passe, la clé ni le certificat.

Limites

• Développée sans le matériel : testée contre un contrôleur simulé seulement. Vos retours sont les bienvenus.
• Un seul contrôleur par instance de Gladys.
• Appareils pris en charge : thermostats de radiateur I et II, thermostats d'ambiance, thermostats muraux, contacts de porte/fenêtre I et II, détecteurs de mouvement I et II, détecteurs de fumée I et II, prises connectées et compactes, interrupteurs d'éclairage, micromodules lumière et relais, commandes de volet I et II, modules volet et store, détecteurs de fuite d'eau, interrupteurs universels. Non pris en charge (ignorés) : Twinguard, caméras, sirène extérieure, variateurs et lumières colorées, circuits de chauffage et chaudières, simulation de présence, scénarios et automatisations Bosch.
• Non proposés : la position de vanne des thermostats de radiateur, la luminosité du détecteur de mouvement II, les préréglages boost et éco, le verrouillage enfant et les autres réglages des appareils.
• L'alarme intrusion peut seulement être armée (sur option), jamais désarmée ni coupée.
• Bosch demande aux clients locaux d'utiliser le long polling et de limiter le nombre de requêtes : l'intégration garde une seule requête d'événements ouverte à la fois (30 s chacune), relit tout toutes les 15 minutes (4 requêtes) et renvoie à Gladys les valeurs inchangées toutes les 6 heures.
• L'API locale de Bosch est réservée à un usage privé et non commercial.

Paramètres de configuration

Voici les paramètres demandés par Bosch Smart Home dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Votre Smart Home Controller	section	Non	Smart Home Controller I ou II, sur le même réseau que Gladys. 1. Saisissez son adresse IP et son mot de passe système, enregistrez. 2. Appuyez sur le bouton du contrôleur jusqu'au clignotement. 3. Cliquez sur « Appairer » dans la minute.
Adresse IP du contrôleur	string	Oui	Affichée dans l'application Bosch Smart Home (Paramètres, Système, Smart Home Controller) ou dans votre box. Donnez-lui une adresse fixe.
Mot de passe système	secret	Non	Le mot de passe choisi à l'installation du contrôleur. Utilisé une fois, pour l'appairage, puis effacé de Gladys.
Langue des noms	select	Non	Langue des noms de fonctionnalités des nouveaux appareils et des textes envoyés par l'intégration.
Durée d'un mouvement	select	Non	Le contrôleur n'envoie que l'heure de chaque détection : durée pendant laquelle un détecteur affiche alors « mouvement ».
Sécurité	section	Non	L'alarme intrusion est en lecture seule par défaut. La désarmer ou la couper n'est jamais possible depuis Gladys.
Autoriser l'armement depuis Gladys	boolean	Non	Permet à l'action de scène « Armer l'alarme intrusion » d'armer le système d'alarme du contrôleur.
Ne pas vérifier le certificat du contrôleur	boolean	Non	Seulement si la connexion échoue sur une erreur de certificat (contrôleur resté hors ligne des années). Moins sûr.

Comment installer Bosch Smart Home dans Gladys

1. Dans Gladys, ouvrez Intégrations : Bosch Smart Home apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/guim31/gladys-bosch-shc:1.0.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-bosch-shc.

Bosch Smart Home nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes

Bosch Smart Home est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂