Plugin Sonoff-DIY Documentation


sonoffdiy icon


 




 

Table des matières

Installation du Plugin Sonoff-DIY

Options de configuration du plugin

Devices compatibles

Vidéo de présentation Sonoff

Programmation des modules

Ajout d'un Device Sonoff Diy

Configurer un nouvel équipement

Commandes disponibles

Informations disponibles

Foire aux Questions FAQ

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 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’utiliser avec Jeedom ces modules très facilement.

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

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 ne fonctionne pas encore, c’est en cours d’étude, le documentation de Sonoff vient de sortir mais les commandes ON et OFF fonctionnent très bien et sont extrêmement rapide.

Plugin développé en php, JS Aucun démon, cron ou dépendance complexe, 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

Options de configuration du plugin

Pas d'option

Devices compatibles

Sont compatibles :

Vidéo de présentation des SONOFF-DIY

Programmation des modules pour les interfacer avec le plugin

Les modules sont livrés comme utilisables avec l'application eWeLink

ewelink

N'utilisez pas cette application, il est même totalement inutile de la configurer avant de passer au mode DIY.

Le seul interet de passer par l'application est de faire une mise à jour, j'ai toujours reçu des modules à jour donc je n'ai jamais utilisé cette fonctionnalité.

Il est conseillé par Sonoff d'utiliser au minimum la version 3.3.0

Etape 1 : Basculer le module en mode DIY

Pour les basculer en mode DIY, il est necessaire de les ouvrir (c'est très simple) et d'ajouter le petit cavalier fourni sur l'emplacement prévu à cet effet :

Sonoff Mini demontage

Cet image présente un Sonoff Mini mais c'est quasiement la même chose pour les autres modules.

Une fois le cavalier posé, fermez le boitier, côté hard (matériel) c'est terminé, votre module est passé en mode DIY.

Etape 2 : créer un point d'accès WIFI avec votre téléphone portable

Cette étape est très simple, utilisez votre téléphhone portable et activez la fonctionnalité, sur un Samsung, il faut par exemple faire :

  • Paramètres
  • Connexions
  • Point d'accès mobile et modem
  • Activer Point d'accès mobile
  • Appuyer dessus
  • Changer le nom du réseau et mettre : sonoffDiy
  • Changer le mot de passe et mettre : 20170618sn
  • Sur les ... en haut à droite, Appareils autorisés puis Désactiver Uniquement les périphériques autorisés

Etape 3 : raccorder le Sonoff à l'électricité

Evidemment avec toutes les précautions d'emploi !!!

  • Connecter N et Lin à une prise de courant
  • Connecter la prise

La diode bleue va clignoter 1 fois toutes les secondes. Dès que la connexion sera faite au point d'accès, elle clignotera 2 fois en 1 seconde.

Etape 4 : connecter un ordinateur au point d'accès sonoffDiy

Sur un ordinateur doté d'une carte wifi, chercher dans la liste des connexions wifi disponibles

Se connecter au réseau sonoffDiy (avec le code 20170618sn)

Etape 5 : Lancer le programme Sonoff DIY mode tool

Télécharger la dernière version du programme sur cette page

diy

  • Si la liste des équipements reste malheureusement vide alors que le point d'accès est bien créé et que le module clignote bien avec deux impulsions bleues, nous avons détecté (merci ezdom) que le souci vient d'un conflit entre le WIFI 2.4Ghz et le 5Ghz. Pour corriger cela, désactivez le 5Ghz dans votre routeur wifi (ou déconnectez les antennes 5Ghz si vous savez faire cela).
  • Si malgré la désactivation du 5Ghz, vous avez toujours une liste vide, utilisez la méthode Google Chrome/Avanced REST Client (ARC). Cette méthode est expliquée sur cette page.

 

  • Noter le numéro qui figure dans la première colonne, il vous servira pour identifier votre module, (si vous avez oublié, le plugin pourra vous le retrouver.)

Etape 6 : Changer SSID Password

En bas à droite, utiliser le bouton Change SSID Password pour mettre le SSID et le mot de passe de votre réseau Wifi

Etape 7 : Débrancher et rebrancher le module Sonoff

C'est terminé, votre module Sonoff doit se retrouver sur votre réseau Wifi

Etape 8 : Aller chercher l'adresse IP de votre nouveau module

L'interface de votre routeur vous donnera l'IP de ce nouveau module, vous devez l'avoir dans les derniers modules détectés et ajoutés par le serveur DHCP de votre routeur. Je vous conseille de lui attribuer une IP fixe à ce stade.

  • Noter l'IP, elle vous sera nécessaire pour commander le module depuis le plugin

Ajout d'un Device Sonoff Diy

Il suffit d'appuyer sur le bouton + pour ajouter un équipement

Screenshot 2020 01 25 Sonoffdiy Jeedom

Configurer un nouvel équipement

Screenshot 2020 01 25 Sonoffdiy Jeedom1

Il y a deux paramètres dans la configuration d'un module :

  • L'adresse IP : Paramètre obligatoire, c'est l'adresse de votre module sur votr réseau wifi, votre routeur vous donnera cette information (cf. Etape 8 de la programmation des équipements)
  • L'ID du Device : Paramètre obligatoire, ce numéro de série vous est donné lors de la configuration du module par le logiciel DIY mode tool.

Important : Si vous n'avez pas spécifié l'ID du device, vous n'aurez pas les retours de changements d'état car le plugin ne saura pas à quel device.

Vous avez un moyen très simple pour retrouver l'ID d'un device :

Trouver l'ID d'un Sonoff

Si vous avez besoin de retourver l'ID d'un device, suivez cette procédure :

  • Allez dans la configuration du plugin, mettez vous en mode "debug" (warning minimum) et pour que ce soit plus simple, ouvrer le log sonoffdiy_mDNS et cliquer sur vider pour le purger

Screenshot 2020 01 27 Sonoff DIY Jeedom

  • Lancer un changement d'état du module en question (le passer sur on ou sur off)
  • Retourner dans la configuration du plugin, ouvrer le log sonoffdiy_mDNS, vous trouverez l'ID dans le log :

Screenshot 2020 01 27 Sonoff DIY Jeedom1

  • Recopiez cette ID dans la configuration de l'équipement, vous ne devriez plus voir ce type de message dans le log et le widget de votre équipement changera d'état automatiquement.

Commandes disponibles

On / Off

Ces commandes actionnent le relais du module,

  • ON = allumé
  • OFF = éteint

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, lancerla commande "Pulse On" avec un nombre de milli-secondes (5000 par exemple pour 5 secondes)

Etat Initial

Les modules sont équipés d'une option "Startup".

Cela correspond à l'état (on/off) sur lequel se pace 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

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.

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.

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


Imprimer   E-mail