Plugin Sonoff-DIY Documentation

sonoffdiy icon

Présentation du plugin

Ce plugin va vous permettre de commander vos équipements Sonoff-DIY sans aucun flashage du module.

La marque Sonoff (Itead) lance une nouvelle gamme de produits labellisés DIY (Do It Yourself).

Cette gamme spécialisée pour la domotique n’a plus besoin de “flashage”, le positionnement d’un cavalier bascule ces modules en mode DIY.Les nouveaux produits n’ont même plus de cavalier, tout se fait sans rien démonter.

Les produits sont extrêmement peu chers.

Sans avoir à sortir le fer à souder ni de flasher le module, ce plugin (et la documentation qui correspond) vont permettre aux moins expérimentés d’entre nous , d’utiliser avec Jeedom ces modules très facilement.

Quelques produits sont actuellement lancés mais d’autres viendront :

Modèle Sonoff a intégré le Mode DIY Supporté par Sonoff-DIY
Mini et Mini R2
Mini R3 Nouveau depuis 14/02/2022
Basic R3
4CH 4CH Pro R3
RF R3
D1
POW R2
POW R3 Nouveau
Dual R3
SPM Nouveau depuis 22/01/2022

La page Sonoff des équipements supportés n’est pas à jour mais est une bonne indication.

Aucun protocole radio ou domotique n’est indispensable, les modules se placent sur le réseau wifi et fonctionnent grâce au plugin.

Le retour d’état fonctionne et les commandes ON et OFF fonctionnent très bien, elles sont extrêmement rapides.

Le Sonoff SPM donne la consommation en temps réel (puissance active, réactive et apparente+tension+courant).

Plugin développé en php, JS Aucun démon ou dépendance, tout est dans le plugin.

Installation du Plugin Sonoff-DIY

Installer le Plugin depuis le Market
installationalexaapi1

Aller ensuite dans le Market et sélectionner Sonoff-DIY

Puis Activer le plugin

Vidéo de présentation des SONOFF-DIY

Passage en mode DIY puis intégration à Jeedom

Commandes disponibles
On / Off

Ces commandes actionnent le relais du module,

  • ON = allumé
  • OFF = éteint

Nota : La commade info Etat du relais permet de récupérer cette information.

Pulse On/Off

Les modules sont équipés d’une option « Pulse ».

Si cette option est sur ON et qu’un nombre de milli-secondes est spécifié, lorsque l’utilisateur passera le module à On, il s’éteindra au bout de la tempo spécifiée.

  • Pour désactiver l’option, lancer la commande « Pulse Off« 
  • Pour activer l’option, lancer la commande « Pulse On » avec un nombre de milli-secondes (5000 par exemple pour 5 secondes)

Le nombre de multisecondes doit être un multiple de 500 (1/2 seconde).

Ces commandes sont à programmer une fois pour toute en fonction de l’utilisation de votre modufle, cela ne doit pas être envoyé à chaque changement d’état. C’est une valeur de paramétrage du module et reste enregistrée dans le module.

Nota : La commade info Etat à la mise sous tension permet de récupérer cette information.

Etat Initial

Les modules sont équipés d’une option « Startup ».

Cela correspond à l’état (on/off) sur lequel se place le module à sa mise sous tension.

  • Pour que le module s’allume à la mise sous tension, choisir On
  • Pour que le module soit reste eteint à la mise sous tension, choisir Off
  • Pour que le module garde son dernier état à la mise sous tension, choisir Stay

Ces commandes sont à programmer une fois pour toute en fonction de l’utilisation de votre modufle, cela ne doit pas être envoyé à chaque changement d’état. C’est une valeur de paramétrage du module et reste enregistrée dans le module

A noter que ces commandes (qui sont très peu utilisées une fois le module en service) doivent être programmées via un scénario.

Si cette commande est lancée depuis le bouton « test » de l’écran des commandes du device, c’est l’état Stay qui est envoyé (Mise à jour version 10/05/2020)

Nota : La commade info Etat de la fonction Pulse et Tempo de la fonction Pulse permet de récupérer cette information.

Rafraîchir

Cette commande actualise les états du modules.

Nota : Cette commande sera que très peu utilisée puisque les états sont actualisés automatiquement et instantanement.

Informations disponibles

Afin de permettre aux utilisateur d’exploiter au mieux toutes les possibilités et les options des modules, beaucoup d’informations sont disponibles.

Notez que ces informations sont actualisés automatiquement et instantanement.

Le widget du device sera basé sur ces informations.

Pour les utiliser (ou pas), vous pouvez cocher « Afficher » pour les retrouver sur le widget de l’équipement.

Etat du relais

Cette information (1 ou 0) correspond à l’état allumé ou éteint du module

Screenshot 2020 01 25 Dashboard Jeedom1

Etat à la mise sous tension

Cette information correspond à la configuration choisie par l’option Startup, cf. Commande « Etat initial »

Etat de la fonction Pulse

Cette information correspond à la configuration choisie par l’option Pulse, cf. Commande « Pulse »

Tempo de la fonction Pulse

Cette information correspond à la tempo en milli-secondes choisie pour l’option Pulse, cf. Commande « Pulse »

Nota : cette information est ignorée si Pulse est sur Off

SSID

Cette information correspond au SSID de votre réseau Wifi

RSSI

Cette information correspond à la force du réseau Wifi

Cette valeur de signal est mesurée en décibels de 0 à -120. Plus la valeur est proche de 0, plus le signal sera fort.

  • Entre 0 et -50, c’est extrèmement rare.
  • Entre -50 et -80 est correct.
  • Entre -80 et -100 est mauvais.

Bonus, créer un toggle on/off

Habituellement, le device apparait sous cette forme :

On a donc un bouton On, un bouton Off et un widget indiquant l’etat du relais
Le plugin a été amélioré, on peut maintenant avoir un seul bouton représentant la lumière, un appui dessus allume, un autre appui dessus éteint. Cela est vraiment pratique pour l’intégration dans un Design et évite de passer par un Virtual.

Pour réaliser cela, il faut mettre le même widget sur la commande On et sur la commande Off puis décocher la case Afficher de l’état du relais, tout le reste est géré par le plugin.

Ajout du Sonoff-DIY MINI R3 (jan 2022)

Le Sonoff Mini R3 est sorti et il vient d’être intégré dans le plugin.

Une page spéciale lui est dédiée ici

Ce module n’est pas encore documenté par Sonoff sur leur page officielle, j’ai donc tenté de trouvé les commandes à tatons… et globalement c’est opérationnel.

  • On/Off évidemment fonctionnent
  • Les retours d’état fonctionnent
  • La commande Refresh fonctionne
  • La configuration du Pulse et de l’état initial n’est pas encore implémenté (au 08/01/2022)
  • Les données suivantes sont bien récupérées :

Exemples d’utilisation

Foire Aux Questions FAQ

FAQ1 : Le widget de mon équipement ne change pas d’état quand je l’utilise manuellement

C’est que l’ID du device de cet équipement n’est pas renseigné ou n’est pas exact, suivez cette procédure pour résoudre le souci

FAQ2 : J’ai une erreur 400 quand je veux utiliser la commande « Etat initial » avec la valeur Off ou Stay

Il y a eu une petite erreur glissée dans la version de mai 2020, corrigée depuis la mise à jour de Juillet 2020. Pour ne plus avoir l’erreur, il suffit d’aller dans les commandes du device en question, sur la commande Etat initial et de retirer les espaces après les points virgules, pour obtenir cela :

One thought on “Plugin Sonoff-DIY Documentation

  1. Bonjour, super facile de mise en oeuvre. Sauf pour une fonction. Avant de passé en Diy sur des sonoff mini il y avait la possibilité de brancher un bouton poussoir plutôt qu’un inverseur(va et vient). Comment configurer cette fonction dans jeedom?

  2. Je me permet de poster ici car je viens de recevoir mes modules et il semble que le cavalier ai disparu, j’ai démonter le module mais le 2 pins n’y sont plus, on retrouve 2 trous repérés OTA et GND. Pensez vous qu’il faille que je soude un shunt afin de les passer en DIY?

    1. Bonjour, je suis dans le même cas, j’ai commandé un switch DIY Mini chez Domadoo mais il n’y a pas de cavalier, le jumper a disparu de la carte electronique. Il s’agit bien d’un module DIY , c’est marqué sur la boite et sur le manuel fourni avec.

      Je l’ai configuré dans le plug in sonoffdiy, mais je ne peux pas le piloter. Le plugin me renvoie une erreur « souci dans la commande on … »

      Le module fonctionne bien dans ewelink.

      merci de votre aide

  3. Bonjour

    Merci pour cet excellent plugin qui aide bien la vie.

    Par contre, y’a-t’il en prévision une commande pour éteindre les led bleus du signal wifi ?
    C’est relativement casse-pied d’avoir les modules qui flashent toutes les 3 secondes…

    Sinon,
    Merci

  4. Bonjour,
    je remet ici mon msg posté sur le topic todo-list oups… erreur dsl

    J’ai voulu déplacer un module Sonoff mini DYI dans un autre VLAN… Je le ping sans soucis, si j’actionne l’interrupteur l’état de ce module remonte bien dans Jeedom par contre impossible de le piloter à distance j’ai systématiquement une erreur de type :
    [2020-11-19 20:50:55][ERROR] : ║ ******** Souci sur la commande On de Entrée comble ********
    je débute avec Jeedom (V4.0.61)… je n’ai qu’un seul fichier log « sonoffdiy » pas de log « sonoffdiy_mDNS »
    J’ai aussi essayé de le supprimer et de le recréé sans succès…
    Par contre j’ai essayé avec l’outil Sonoff => tout marche correctement… du coup est-ce qu’il y aurait un cache ou quelque chose du genre à vider…

  5. Bonjour,
    J’ai suivi à la lettre les instructions pour intégrer mon sonoff mini dans mon réseau, je le vois sur l’application ewilink, je retrouve bien son ip sur mon router sur le réseau wifi 2.4, mais je ne parviens pas à communiquer dans jeedom, j’ai ce genre de message « Souci sur la commande On de mini « , sur le module je n’ai pas de cavalier. Une idée ? Merci

  6. Bonjour,
    J’ai bien tout installé avec un sonoff mini DIY version 3.6.0 d’emblée (nouvelle version sans le cavalier).
    Tout fonctionne très bien avec eWilink mais rien ne fonctionne avec le plugin.
    J’ai essayé de tout désinstaller et tout réinstaller sans eWilink. Toujours pareil.
    Je suis sur jeedom sur une Raspberry pi connectée en RJ45. Le sonoff est en wifi 2,4GHz. J’ai récupéré l’IP qui est fixe et l’ID du sonoff….
    Je suis à cours d’idée.

    Merci et bonne année !

    1. je confirme…
      J’ai mis 3 hr à essayer de parametrer mon sonoff DIY Basic R3 et c’est voyant ton message (et le lien) que j’ai compris.
      Mon premier Sonoff avait ete installe avec cette procedure (voir mon message plus haut) mais maintenant cela ne fonctionne plus : je ne trouvais pas mon sonoff sur mon reseau wifi.

  7. Bonjour,
    tout d’abord merci pour les tutos qui permettent d’avancer sans etre un expert.
    J’ai egalement un probleme avec un sonoff rfr3 et jeedom; impossible d’etablir une communication
    Poutant sans le cavalier le module fonctionne avec ewelink et même Alexa en vocal
    En DIY avec cavalier, j’ai le message ***souci sur la commande On de sonoff***
    L’IP et l’ID sont bon
    Sympa si qq à une idée
    Slts

  8. J’apporte une petite pierre à l’édifice, j’ai deux petites remarques après l’installation de mes sonoff mini :

    1- lorsque le module est connecté à votre réseau, ne cherchez un equipement avec un nom qui contient sonoff, vous allez chercher très longtemps et croire que le pairing ne s’est pas fait ( comme moi ) et recommencer et recommencer la procédure jusqu’à épuisement. Mes 2 modules étaient reconnus avec un nom commençant par ESP et un numéro dérrière …

    2- En recommençant la procédure je me suis heurté à un souci qui n’en ai pas un aujourd’hui mais qui le sera certainement demain, une fois le module connecté à un wifi il est impossible de faire un hard reset et de le connecter à un autre wifi, la page 10.10.7.1 n’est plus accessible. J’ai tout essayé sans succès et beaucoup sur le net en parlent.

  9. Bonjour, les commandes fonctionnent bien mais sur les sonoff mini, je n’arrive pas à connaître le device Id.
    Je n’ai pas de bouton log sonoffdiy-mDNS. Dans le log je vois les commandes on ou off envoyer avec device Id « ». Comment faire pour avoir un retour d’état ?
    Sinon, super blog.

  10. Bonjour SIgalou et merci pour cette formidable contribution.

    J’ai le petit souci suivant, bien que tout fonctionne normalement (ID correctment renseigné, etc..), j’ai toujours des kilomètres de logs comme suit ; que faire ?

    [2021-03-26 05:17:04][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:03][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:03][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b51533 || Peut-être le device ayant l’IP 192.168.1.31
    [2021-03-26 05:43:03][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:03][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:03][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b56e67 || Peut-être le device ayant l’IP 192.168.1.32
    [2021-03-26 05:43:03][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:03][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:03][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b51533 || Peut-être le device ayant l’IP 192.168.1.31
    [2021-03-26 05:43:03][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:04][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:04][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b56e67 || Peut-être le device ayant l’IP 192.168.1.32
    [2021-03-26 05:43:04][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:04][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:04][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b51533 || Peut-être le device ayant l’IP 192.168.1.31
    [2021-03-26 05:43:04][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:04][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:04][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b56e67 || Peut-être le device ayant l’IP 192.168.1.32
    [2021-03-26 05:43:04][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:04][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:04][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b51533 || Peut-être le device ayant l’IP 192.168.1.31
    [2021-03-26 05:43:04][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:04][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:04][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b56e67 || Peut-être le device ayant l’IP 192.168.1.32
    [2021-03-26 05:43:04][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:05][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:05][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b51533 || Peut-être le device ayant l’IP 192.168.1.31
    [2021-03-26 05:43:05][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:05][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:05][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b56e67 || Peut-être le device ayant l’IP 192.168.1.32
    [2021-03-26 05:43:05][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:05][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:05][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b51533 || Peut-être le device ayant l’IP 192.168.1.31
    [2021-03-26 05:43:05][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:05][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:05][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b56e67 || Peut-être le device ayant l’IP 192.168.1.32
    [2021-03-26 05:43:05][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:06][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:06][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b51533 || Peut-être le device ayant l’IP 192.168.1.31
    [2021-03-26 05:43:06][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:06][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:06][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b56e67 || Peut-être le device ayant l’IP 192.168.1.32
    [2021-03-26 05:43:06][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:06][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:06][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b51533 || Peut-être le device ayant l’IP 192.168.1.31
    [2021-03-26 05:43:06][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 05:43:06][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 05:43:06][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b56e67 || Peut-être le device ayant l’IP 192.168.1.32
    [2021-03-26 05:43:06][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 06:04:03][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 06:04:03][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b51533 || Peut-être le device ayant l’IP 192.168.1.31
    [2021-03-26 06:04:03][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════
    [2021-03-26 06:08:03][WARNING] : ╔══════════════════════[Il y a un souci dans l’ID d’un des devices]═════════════════════════════════════════════════════════
    [2021-03-26 06:08:03][WARNING] : ║ Il devrait y avoir un device avec l’ID : 1000b56e67 || Peut-être le device ayant l’IP 192.168.1.32
    [2021-03-26 06:08:03][WARNING] : ╚═══════════════════════════════════════════════════════════════════════════════════════════════════════════════════════════

  11. Bonjour,
    Les 4 nvx sonoff zigbee seront ils integrables également au travers du zbbridge ? C’est finalement lui seul qui devrait être DIY.
    Avez-vous des plans a ce propos ? N’ai rien vu dans la roadmap.
    Merci.

  12. Bonjour quelqu’un a t il configuré un mini dual R3 ?
    Je compte piloter des VR somfy et bubbendorf filaires mais avant d’en acheter une douzaine j’aimerais ete sur qu’ils se pilotent bien. J’ai lu qqpart qu’apres la synchro
    led combats ne fonctionnent pas

  13. Bonjour,
    J’utilise Jeedom V4.
    J’ai un souci avec le PI SonOff DIY. Je n’arrive pas à créer un widget toggle on/off.
    J’ai bien mis le même widget sur la commande On et sur la commande Off
    J’ai également décocher la case Afficher de l’état du relais dans l’équipement SonOff
    Malheureusement, le widget affiche toujours l’image de la commande off et un clic sur l’image ne le fait pas passer en off
    Une idée d’où peut venir le problème ?
    Merci d’avance
    E. Roudart

Laisser un commentaire