Ajouter un interrupteur Sonoff dans Domoticz

Dans cet article, le but est de vous montrer la procédure standard concernant l’intégration d’un interrupteur Sonoff dans Domoticz. Avant de commencer, il faut que votre interrupteur Sonoff soit impérativement flashé avec ESPeasy, et cela quel que soit le modèle que vous avez choisi :

• Basic
• RF
• S20

Aussi, il faut que votre ROM ESPeasy soit configurée.

Un fois ces deux étapes terminées, on peut finalement avancer sur l’intégration de votre Sonoff dans Domoticz.
Cela va se dérouler en deux étapes.

Configuration dans ESPeasy

Votre interrupteur est composé d’un ESP (traditionnellement 8266, mais il y a d’autres modèles), mais aussi d’un relais qui est piloter par ce dernier. Un relais fonctionne comme un interrupteur classique, mis à part, qu’il est, ici, commandé par votre ESP, donc par Wifi (et 433MHz pour le Sonoff RF).

Ceci dit, pour que ESPeasy sache comment commander le relais, il faut lui expliquer. Connectez vous premièrement, via votre navigateur, à l’interface ESPeasy de votre Sonoff.

Ajout des devices

Nous avons 3 devices à ajouter, Submit à la fin de chaque ajout :
Attention : les names et tableau values des devices également sont réutilisés après. Ne pas les modifier.

• Le bouton de votre boitier (petit et noir pour les Sonoff Basic et RF, et gros et blanc pour le S20)
  • Device : Switch input – Switch
  • Name : Bouton
  • Enabled : coché
  • Internal PullUp : coché
  • Inversed Logic : coché
  • 1st GPIO : GPIO-0 (D3)
  • Switch Type : Switch
  • Switch Button Type : Normal Switch
  • Send Boot state : décoché
  • Send to Controller : décoché
  • Delay : 0
  • Tableau Values Name: Bouton

• Le relais 220v
  • Device : Switch input – Switch
  • Name : Relais
  • Enabled : coché
  • Internal PullUp : coché
  • Inversed Logic : décoché
  • 1st GPIO : GPIO-12 (D6)
  • Switch Type : Switch
  • Switch Button Type : Normal Switch
  • Send Boot state : décoché
  • Send to Controller : décoché (pour l’instant)Le relai 220v
  • Delay : 0
  • Tableau Values Name: Relais

• La led de votre boitier (Verte pour Basic et RF, Bleu autour du bouton pour le S20)
  • Device : Switch input – Switch
  • Name : Led
  • Enabled : coché
  • Internal PullUp : coché
  • Inversed Logic : décoché
  • 1st GPIO : GPIO-2 (D4)
  • Switch Type : Switch
  • Switch Button Type : Normal Switch
  • Send Boot state : décoché
  • Send to Controller : décoché
  • Delay : 0
  • Tableau Values Name: Led

Vos devices sont configurés.

Ajout des Rules

Il faut, ensuite, expliquer à ESPeasy comment ils interagissent ensembles. Comme vu dans le cahier des charges du projet, nous souhaitons notamment que les actions « physiques » soient conservées dans la solution domotique. Afin de ne pas être esclave d’une connexion réseau ou d’une interface avec la centrale. Ainsi, on souhaite que le bouton de votre boitier fasse office de bouton « On/Off ».
Nous allons donc créer des “Rules”, pour exprimer cela.
Premièrement, il faut les activer dans l’onglet « Tools » et dans le menu “Advanced”.

Deuxièmement, actualiser la page. Ensuite, constater d’un nouvel onglet “Rules” est apparu. Et finalement, copier coller le code suivant :

on Relais#Relais=1 do
  gpio,2,1
  endon
on Relais#Relais=0 do
  gpio,2,0
  endon
on Bouton#Bouton=1 do
  if [Relais#Relais]=0
    gpio,12,1
  else
    gpio,12,0
  endif
endon

Un fois confirmé, vous pouvez donc tester votre bouton. Si vous n’avez pas branché d’appareil sur le Output de votre Sonoff, un clac (le relais) devrait, par conséquent, s’entendre à chaque appui.
Attention, les boutons du Basic et du RF se montrent, des fois, un peu récalcitrant à enregistrer l’appui.

Ajout de votre Sonoff dans Domoticz

Finalement au tour de Domoticz d’apprendre à contrôler votre interrupteur.
On va se rendre, pour cela, dans l’onglet “Réglages”, puis dans le menu “Matériel”.
Si ce n’est pas déjà fait, vous devez, en effet, ajouter un matériel avec la config suivante :

Une fois le matériel ajouté, vous constaterez donc qu’une nouvelle ligne est apparue dans le tableau en haut de page, avec les informations que vous venez de saisir.

Il faut créer un capteur virtuel. Mettez le nom que vous voulez, et aussi “interrupteur” dans le type.

Vous avez maintenant un nouvel interrupteur qui a apparu dans votre onglet “Interrupteurs”. Facile ! … Cependant, c’est pas fini… Afin que Domoticz envoie des commandes au Sonoff, il faut lui donner le chemin, mais aussi l’action à effectuer. C’est pourquoi nous allons modifier l’interrupteur :

Dans les deux lignes action ON et OFF, nous allons donc ajouter des commandes qui se construisent de la manière suivante :

• Action ON : http://[adresseIpSonoff]/control?cmd=GPIO,12,1
• Action OFF : http://[adresseIpSonoff]/control?cmd=GPIO,12,0

Expliquons ces lignes. Votre Sonoff a un mini serveur Web (interface ESPeasy), et est en conséquence capable de recevoir des requètes. Ainsi, nous lui demandons de passer le GPIO 12 soit à 1 ou 0. GPIO 12, qui est celui qui commande le relais.

Il reste ensuite une dernière étape.

Le retour de l’état

Afin que Domoticz soit capable de connaitre l’état de votre relais (ON ou OFF), le serveur attribue un identifiant IDX à votre dispositif. Pour le connaitre, il faut se rendre dans l’onglet “Réglages” et le menu “Dispositifs”. Puis dans le tableau l’interrupteur qui vus interesse et regarder le chiffre de la première colonne.

Il ne reste plus qu’à retourner sur votre Sonoff, et sur le Device du relais :

Ainsi, même si vous utilisez un interrupteur 433MHz ou que vous appuyez sur le bouton du boitier, Domoticz recevra la nouvelle valeur de votre relais en direct.

La config de votre Sonoff dans Domoticz est terminée.

Ne vous arrêtez pas là, et consultez nos autres guides qui sont en relation avec celui-ci :

• Présentation de ESPeasy
• Flasher un Sonoff Basic avec ESPeasy
• Flasher un Sonoff Dual R2 avec ESPeasy