Sommaire
Présentation
Le plugin MatterBridge 2 permet d’installer, piloter et superviser facilement MatterBridge depuis Jeedom.
MatterBridge est une passerelle permettant d’exposer des équipements domotiques vers l’écosystème Matter, afin de les rendre disponibles dans des applications compatibles comme Alexa, Apple Maison, Google Home ou SmartThings.
Le plugin s’appuie sur le plugin officiel Docker Manager de Jeedom pour créer et gérer le conteneur MatterBridge. Il permet notamment de :
- créer automatiquement le conteneur Docker MatterBridge
- démarrer, arrêter et redémarrer le conteneur
- suivre l’état du conteneur directement depuis Jeedom
- ouvrir l’interface web MatterBridge
- conserver les données MatterBridge dans un dossier persistant (sauvegardé par Jeedom)
- choisir automatiquement l’image Docker adaptée à l’architecture du système
- utiliser une image spécifique pour les systèmes 32 bits si nécessaire
Le plugin ne remplace pas l’interface officielle MatterBridge. Il sert principalement à simplifier son installation, sa supervision et son accès depuis Jeedom.
Installation
Prérequis
Avant d’utiliser le plugin MatterBridge 2, assurez-vous que votre installation Jeedom dispose des éléments suivants :
Plugin Docker Manager
Le plugin Docker Manager officiel de Jeedom doit être installé et activé.
Le plugin MatterBridge 2 utilise Docker Manager pour créer, supprimer, démarrer et arrêter le conteneur MatterBridge.
Docker fonctionnel
Docker doit être correctement installé et fonctionnel sur la machine Jeedom.
Vous pouvez vérifier Docker en SSH avec :
sudo docker ps
Si la commande retourne une liste de conteneurs, même vide, Docker est bien accessible.
Réseau
MatterBridge utilise par défaut le port :
8283
L’interface web sera donc accessible à l’adresse :
http://IP_JEEDOM:8283/
Exemple :
http://192.168.1.50:8283/
Assurez-vous que ce port n’est pas déjà utilisé par un autre service.
Guide d’installation
1. Installer le plugin
Installez le plugin MatterBridge 2 dans Jeedom, puis activez-le.
Une fois le plugin activé, ouvrez sa page de configuration.
2. Vérifier la configuration
Dans la configuration du plugin, vérifiez les paramètres suivants :
Nom du conteneur
Par défaut :
matterbridge2
Il est conseillé de conserver ce nom afin d’éviter les conflits avec une autre installation MatterBridge.
Numéro Docker hôte
Par défaut :
1
Ce numéro correspond au Docker hôte configuré dans Docker Manager. Dans la majorité des installations Jeedom, la valeur 1 est correcte.
Dossier des données
Par défaut :
/var/www/html/plugins/matterbridge2/data/matterbridge
Ce dossier contient les données persistantes de MatterBridge :
Matterbridge
.matterbridge
.mattercert
Ces données sont conservées même si le conteneur Docker est supprimé ou recréé.
IP / hôte interface
Si ce champ est vide, le plugin utilise automatiquement l’adresse IP interne de Jeedom.
Vous pouvez aussi renseigner manuellement l’adresse IP de Jeedom, par exemple :
192.168.1.50
Port frontend
Par défaut :
8283
Ce port permet d’accéder à l’interface web MatterBridge.
Image Docker
Le mode recommandé est :
Auto selon architecture
Le plugin choisira automatiquement l’image Docker adaptée :
luligu/matterbridge:latest
ou, pour certains systèmes 32 bits :
luligu/matterbridge:s6-rc-legacy
3. Installer le conteneur Docker
Cliquez sur le bouton :
Installer / recréer le Docker
Le plugin affiche alors un journal de progression.
Les étapes principales sont :
Vérification de Docker Manager
Préparation des dossiers MatterBridge
Création ou mise à jour de l’équipement Docker Manager
Création du conteneur Docker
Attente du démarrage
Vérification de l’état final
Lorsque l’installation est terminée, l’état doit passer à :
Démarré
4. Ouvrir l’interface MatterBridge
Une fois le conteneur démarré, cliquez sur :
Ouvrir MatterBridge
L’interface MatterBridge s’ouvre dans un nouvel onglet.
L’adresse est généralement de la forme :
http://IP_JEEDOM:8283/
5. Sécuriser l’interface
Lors du premier accès à MatterBridge, il est recommandé de modifier le mot de passe depuis l’interface MatterBridge :
Settings → Change password7. Appairer avec Alexa ou un contrôleur Matter
Dans l’application Alexa ou dans un autre contrôleur Matter compatible :
Ajouter un appareil
Autre
Matter
Scanner le QR Code affiché dans MatterBridge
Les équipements exposés par MatterBridge seront ensuite disponibles dans l’écosystème Matter.
Aide à l’utilisation de Matter Bridge
Cette section présente un exemple simple d’utilisation de MatterBridge avec le plugin Shelly.
L’objectif est d’installer le plugin Shelly dans MatterBridge, puis d’exposer uniquement un équipement nommé Chauffe eau grâce à la liste blanche.
Ouvrir l’interface MatterBridge
Depuis Jeedom, ouvrez le plugin MatterBridge 2, puis cliquez sur :
Ouvrir MatterBridge
L’interface MatterBridge s’ouvre dans un nouvel onglet de votre navigateur.
En haut vous trouverez les menus :
HOME : Page d’état, avec une partie Install plugins pour installer les plugins. Dessous la liste des plugins installés et encore dessous la liste des équipements.
DEVICES : Uniquement la liste des équipements.
LOGS : Logs Matter Bridge avec filtre possible.
SETTINGS :
Installer le plugin Shelly
Dans l’interface MatterBridge :
Install plugins
Recherchez le plugin :
matterbridge-shelly
Puis cliquez sur :
Install
Avec MatterBridge en Docker, le plugin Shelly peut généralement être sélectionné et ajouté directement depuis l’interface MatterBridge.
Après installation, MatterBridge peut redémarrer automatiquement. Si ce n’est pas le cas, redémarrez MatterBridge depuis l’interface ou depuis Jeedom avec le bouton :
Redémarrer
- Découverte des équipements Shelly
Le plugin Shelly peut découvrir automatiquement les modules Shelly présents sur le réseau local.
Dans la configuration du plugin Shelly, vérifiez que les options suivantes sont activées :
enableMdnsDiscover
enableStorageDiscover
Si ces options viennent d’être activées, redémarrez MatterBridge pour relancer la découverte. La documentation du plugin Shelly indique que ces options doivent être activées pour permettre la découverte et le chargement des appareils Shelly.
Une fois les équipements découverts, vous devriez voir vos modules Shelly dans l’interface MatterBridge, notamment dans les logs ou dans la liste des devices.
Dans notre exemple, l’équipement à exposer s’appelle :
Chauffe eau
- Mettre uniquement “Chauffe eau” en liste blanche
La liste blanche permet de limiter les équipements exposés à Matter.
Dans la configuration du plugin Shelly dans MatterBridge, cherchez le champ de configuration de type :
whiteList
ou :
Whitelist
Ajoutez uniquement l’équipement souhaité :
Chauffe eau
L’objectif est que MatterBridge n’expose que cet équipement, et ignore les autres modules Shelly détectés.
Exemple de logique attendue :
whiteList:
- Chauffe eau
Selon l’interface et la version du plugin, la saisie peut se faire sous forme de liste, tableau ou champ texte. Il faut reprendre exactement le nom de l’équipement tel qu’il apparaît dans MatterBridge.
Après modification, sauvegardez la configuration du plugin Shelly, puis redémarrez MatterBridge.
- Vérifier que seul “Chauffe eau” est exposé
Après redémarrage, retournez dans l’interface MatterBridge et vérifiez la liste des équipements exposés.
Vous devriez voir uniquement :
Chauffe eau
Si d’autres équipements Shelly apparaissent encore, vérifiez :
que le nom saisi dans la whiteList correspond exactement au nom affiché dans MatterBridge ;
qu’il n’y a pas d’espace en trop ;
que la configuration a bien été sauvegardée ;
que MatterBridge a bien été redémarré après modification.
- Appairer MatterBridge avec Alexa ou un autre contrôleur Matter
Dans l’interface MatterBridge, affichez le QR Code ou le code d’appairage Matter.
Dans l’application Alexa, par exemple :
- → Appareil → Autre → Matter → Scanner le QR Code
Une fois l’appairage terminé, l’équipement Chauffe eau devrait apparaître dans Alexa.
Vous pourrez ensuite le contrôler comme un équipement Matter classique.
Notes importantes pour les équipements Shelly
Pour un fonctionnement fiable, il est recommandé d’avoir une adresse IP stable pour les modules Shelly. La documentation du plugin Shelly conseille de réserver l’adresse IP dans le routeur ou de configurer une IP statique dans l’interface Shelly. C’est particulièrement important pour les modules sur batterie.
Pour les modules Shelly Gen 1, la communication peut nécessiter l’activation de CoIoT dans les paramètres du module Shelly. Pour les modules Gen 2 ou Gen 3 sur batterie, la documentation indique que l’Outbound WebSocket peut être nécessaire avec une adresse du type ws://IP_MATTERBRIDGE:8485.
Dans la majorité des cas simples, les modules Shelly alimentés sur secteur sont découverts automatiquement si MatterBridge, Jeedom et les Shelly sont sur le même réseau local.