par Table des matières
Le plugin LocalThings permet de piloter localement les appareils Samsung compatibles depuis Jeedom. Les informations et les commandes transitent directement sur le réseau local en CoAP sur DTLS, sans utiliser l’API cloud SmartThings au quotidien.
Cette intégration locale réduit la dépendance à Internet et au cloud du constructeur. Elle permet également de choisir une fréquence de rafraîchissement courte, jusqu’à 10 secondes, lorsque l’appareil est disponible.
À retenir : aucun compte SmartThings ni jeton cloud n’est demandé par le plugin. Une connexion Internet reste nécessaire lors de l’installation simplifiée des certificats.
Fonctionnement du plugin
LocalThings recherche les appareils compatibles sur le réseau, lit les fonctions réellement publiées par chaque appareil, puis crée automatiquement :
- un équipement Jeedom par appareil détecté ;
- les commandes d’information disponibles ;
- les commandes d’action dont le contrat d’écriture est connu ;
- un widget adapté à la famille de l’appareil.
Le fonctionnement quotidien reste local : Jeedom ouvre une session DTLS avec l’appareil, échange les messages CoAP et décode les données CBOR en PHP.
| Fonctionnement | Plugin LocalThings | Plugin SmartThings |
|---|---|---|
| Chemin des données | Réseau local | Cloud SmartThings |
| Compte Samsung requis par le plugin | Non | Oui |
| Dépendance à Internet au quotidien | Non | Oui |
| Rafraîchissement possible | À partir de 10 secondes | Selon les limites du cloud |
| Appareils concernés | Modèles exposant LocalThings/CoAP-DTLS | Appareils associés au compte SmartThings |
Les deux plugins ne répondent donc pas exactement au même besoin. SmartThings conserve une compatibilité plus large grâce au cloud, tandis que LocalThings privilégie une communication directe et locale.
Appareils pris en charge
Le mappeur reconnaît actuellement les familles suivantes :
- lave-linge et lave-linge séchants ;
- sèche-linge ;
- lave-vaisselle ;
- réfrigérateurs, caves à vin et réfrigérateurs Kimchi ;
- climatiseurs ;
- déshumidificateurs ;
- purificateurs et analyseurs d’air ;
- pompes à chaleur Samsung EHS et eau chaude sanitaire ;
- fours, micro-ondes et cuisinières ;
- tables de cuisson au gaz ou à induction ;
- hottes ;
- purificateurs d’eau ;
- armoires AirDresser ;
- stations d’aspirateur.
La reconnaissance et la génération des commandes sont testées avec les captures publiques du projet mbillow/localthings. La compatibilité réelle dépend néanmoins du modèle et de la version du firmware Samsung.
Les appareils doivent exposer un service CoAP-DTLS sur un port UDP compris entre 49152 et 49160. Les anciens modèles qui proposent uniquement une interface HTTPS sur le port 8888 ne sont pas compatibles.
Prérequis
Avant l’installation, vérifiez les éléments suivants :
- Jeedom 4.4 ou plus récent ;
- Debian 12 ou une plateforme Jeedom compatible ;
- PHP CLI ;
- l’extension PHP OpenSSL et cURL ;
- un exécutable OpenSSL prenant en charge DTLS 1.2 ;
proc_openetexecautorisés dans PHP ;- un accès réseau entre Jeedom et les appareils Samsung concernés.
Un appareil Samsung n’accepte généralement qu’un seul client DTLS local actif. Il faut donc désactiver les autres intégrations LocalThings qui communiquent avec le même appareil, par exemple une instance Home Assistant LocalThings lancée en parallèle.
Installation et configuration
Après l’installation du plugin depuis Jeedom :
- Installez les dépendances du plugin.
- Ouvrez la page Configuration de LocalThings.
- Vérifiez le bloc Transport DTLS avec le bouton Tester.
- Installez les certificats LocalThings.
- Configurez, si nécessaire, les réseaux à analyser.
- Choisissez les intervalles de rafraîchissement en ligne et hors ligne.
- Sauvegardez la configuration.
Affichage de la version, des intervalles de rafraîchissement et du bouton de test du transport DTLS.
Certificats DTLS
Le certificat client est nécessaire pour ouvrir une session locale sécurisée avec les appareils Samsung.
Deux méthodes sont disponibles :
- Installer le bundle communautaire : méthode simple et recommandée pour commencer ;
- Saisir un certificat et une clé : installation manuelle pour les utilisateurs qui souhaitent maîtriser leur propre bundle PEM.
Le bundle communautaire est téléchargé depuis une révision déterminée et son empreinte SHA-256 est vérifiée avant son installation. Les clés privées sont stockées dans le répertoire privé data/ du plugin avec des permissions restrictives.
Lors de la récupération de l’identifiant Samsung nécessaire au certificat client, le plugin tente d’abord une validation TLS complète. Si la chaîne de confiance du système ne le permet pas, il effectue une seconde tentative chiffrée sans validation du certificat et inscrit ce repli dans le journal. La communication n’est jamais envoyée en clair.
Affichage de l’état des certificats et du bouton « Installer le bundle communautaire ».
Réseaux à analyser
Le champ Plages réseau à analyser accepte la notation CIDR, avec une plage par ligne ou séparées par une virgule, par exemple :
192.168.1.0/24
192.168.30.0/24
ou
192.168.1.0/24, 192.168.30.0/24
Si le champ est vide, le plugin utilise automatiquement le sous-réseau /24 correspondant à l’adresse interne de Jeedom. La découverte est limitée à 1 024 adresses afin d’éviter une analyse trop large ou une erreur de configuration.
Intervalles de rafraîchissement
Deux intervalles indépendants peuvent être choisis :
- lorsque l’appareil est en ligne, pour suivre rapidement son fonctionnement ;
- lorsque l’appareil est hors ligne, pour espacer les tentatives inutiles.
Les valeurs proposées vont de 10 secondes à un jour. Par défaut, un nouvel équipement est interrogé toutes les 1 minute lorsqu’il est en ligne et toutes les 5 minutes lorsqu’il est hors ligne.
Après une communication réussie, l’appareil repasse automatiquement sur l’intervalle en ligne. Après un échec, il utilise l’intervalle hors ligne jusqu’à son retour.
Découverte des appareils
Depuis la page du plugin, cliquez sur Découvrir. La recherche s’exécute en arrière-plan afin de ne pas bloquer l’interface Jeedom.
Il est également possible d’utiliser Ajouter par IP pour tester directement l’adresse IPv4 d’un appareil. Cette méthode est utile lorsque la découverte générale ne trouve pas un appareil situé sur un autre VLAN ou sous-réseau.
Affichage des boutons Configuration, Santé, Découvrir et Ajouter par IP.
Chaque appareil détecté crée un équipement avec son adresse IP, son port DTLS, son fabricant, son modèle, son type, sa dernière communication et sa dernière erreur.
Certains firmwares renvoient un numéro de série factice composé uniquement de F ou de 0. Le plugin ignore alors cette valeur et utilise l’identifiant OCF stable annoncé par l’appareil. Ce comportement est normal et évite de créer des équipements en double.
Configuration d’un équipement
La page d’un équipement permet notamment de :
- modifier son nom, son objet parent et sa catégorie ;
- l’activer ou le rendre visible ;
- choisir entre le widget du core Jeedom et le widget LocalThings ;
- consulter ses informations réseau et sa dernière communication ;
- tester immédiatement la communication avec l’appareil ;
- autoriser, pour les modèles concernés, certaines actions sans Smart Control.
L’option Contrôle sans Smart Control doit rester désactivée sauf si le modèle accepte explicitement les commandes concernées. Elle ne permet pas de contourner les protections imposées par le firmware Samsung.
Affichage du choix du widget, des informations locales et du bouton « Tester la communication ».
Commandes générées
Le plugin ne s’appuie pas sur une liste figée de commandes. Il analyse les ressources publiées par chaque appareil et adapte les informations, les unités et les actions disponibles.
Quelques exemples :
| Famille | Informations et actions principales |
|---|---|
| Lave-linge | Programme, température, rinçages, essorage, progression, temps restant, fin différée, démarrage, pause et arrêt |
| Sèche-linge | Programme, niveau de séchage, durée, progression et commandes du cycle |
| Réfrigérateur | Températures, modes rapides, fabrique à glaçons, portes, énergie et alertes |
| Climatiseur | Alimentation, mode, consigne, ventilation, humidité et oscillation selon le modèle |
| EHS | Chauffage/climatisation, eau chaude sanitaire, consignes, modes, absence et son |
| Analyseur d’air | Qualité de l’air, humidité, PM10, PM2,5, PM1, CO₂ et mode Ne pas déranger |
| Four et cuisson | État, mode, température, minuterie, préchauffage et zones annoncées par l’appareil |
Les actions sont créées uniquement lorsque leur format d’écriture est connu. Une information en lecture seule ne devient pas artificiellement une action.
Certaines commandes nécessitent l’activation de Smart Control sur l’appareil. Sur un lave-linge, par exemple, Samsung peut autoriser la préparation locale du programme tout en refusant son démarrage à distance tant que cette sécurité n’est pas activée.
Widget dashboard et mobile
Chaque équipement peut conserver le widget standard de Jeedom ou utiliser le widget LocalThings.
Le widget est organisé en pages pour conserver une lecture simple :
- Principal : état essentiel, progression, réglages et actions courantes ;
- Entretien : alarmes, nettoyage, filtres ou consommables pertinents ;
- Consommation : puissance et énergie lorsqu’elles sont publiées ;
- Informations : informations secondaires utiles, sans doublon avec les autres pages.
Pour un lave-linge, la page principale regroupe visuellement le programme, la température, le nombre de rinçages, l’essorage et les options disponibles. Les actions On/Off apparaissent sous forme d’interrupteurs et les valeurs en pourcentage utilisent une barre de progression.
Les informations numériques historisées sont cliquables et ouvrent directement l’historique natif Jeedom.
Lorsque l’appareil est hors ligne, ses états de fonctionnement devenus obsolètes sont masqués. Le widget est grisé et les actions sont également refusées côté serveur, ce qui évite d’afficher un faux état ou de laisser croire qu’une commande peut être envoyée.
Affichage du widget dashboard : page principal, page résumé d’une alarme ou du nettoyage tambour, puis la page Consommation.
Alarmes et entretien
Les alarmes Samsung sont parfois transmises sous forme de JSON technique. Le plugin les décode avant affichage et ne conserve que les informations utiles, par exemple :
Température élevée — Début : 31/07/2026 23:05
Les alarmes supprimées ou inactives sont ignorées. Lorsqu’un code n’est pas encore connu, il est conservé comme complément de diagnostic sans afficher tout le JSON à l’utilisateur.
Sur un lave-linge compatible, l’onglet Entretien peut également indiquer :
- si un nettoyage du tambour est recommandé ;
- le nombre de lavages prévu avant l’alerte ;
- le nombre de lavages depuis le dernier nettoyage ;
- les alertes de niveau de lessive ou d’adoucissant.
Page Santé
La page Santé vérifie les composants nécessaires au plugin :
- dépendances Jeedom ;
- binaire OpenSSL et prise en charge DTLS ;
- extension PHP OpenSSL ;
- PHP CLI ;
- cURL ;
- fonctions
proc_openetexec; - certificats LocalThings ;
- intervalles de rafraîchissement actifs.
Elle affiche ensuite, pour chaque équipement, son état, son adresse, son port, sa dernière communication, sa dernière erreur et un bouton de test.
Affichage des informations globales et de la liste des appareils.
Dépannage
Aucun appareil n’est découvert
- Vérifiez que Jeedom et l’appareil peuvent communiquer sur le réseau local.
- Contrôlez les VLAN, règles de pare-feu et ports UDP
49152à49160. - Essayez le bouton Ajouter par IP.
- Vérifiez l’état des certificats et du transport dans la page Santé.
- Confirmez qu’aucune autre intégration LocalThings ne monopolise la session DTLS.
Les informations remontent mais les actions échouent
- Allumez l’appareil avant le test.
- Activez Smart Control lorsque le modèle le demande.
- Utilisez Tester la communication pour distinguer un problème réseau d’un refus d’action.
- Consultez la dernière erreur et le journal
localthings.
L’appareil apparaît hors ligne
Un appareil éteint, déconnecté du Wi-Fi ou déjà utilisé par un autre client DTLS peut ne plus répondre. Le plugin espace automatiquement les tentatives selon l’intervalle hors ligne configuré, puis reprend la cadence normale dès que la communication revient.
Sécurité et confidentialité
LocalThings n’ouvre aucun port entrant sur Jeedom. Les échanges avec les appareils sont chiffrés en DTLS et restent sur le réseau local.
Le fonctionnement quotidien n’envoie pas les états et les commandes vers le cloud SmartThings. L’installation simplifiée des certificats constitue l’exception : elle télécharge le bundle public et interroge le certificat de la passerelle Samsung nécessaire à la génération du certificat client.
Limites actuelles
- Seuls les appareils qui publient le service LocalThings sont compatibles.
- Un appareil ne doit pas être piloté simultanément par plusieurs clients DTLS locaux.
- Certaines actions restent soumises aux sécurités du firmware Samsung.
- Le mappeur est validé sur de nombreuses captures publiques, mais tous les modèles ne peuvent pas être testés physiquement par le développeur.
- Une découverte de plusieurs sous-réseaux peut prendre du temps lorsqu’un grand nombre d’adresses ne répondent pas.
Si un modèle n’est pas correctement reconnu, les journaux de découverte et une description précise de l’appareil permettront d’ajouter son cas sans exposer de clé privée.
Liens utiles
