Documentation switch Wi-Fi

Produit associé

Table of contents:

1. Installation
   1.1. Switch Wi-Fi seul
   1.2. Switch Wi-Fi avec un interrupteur physique
   1.3. Switch Wi-Fi avec 2 interrupteurs (va-et-vient)
2. Configuration logicielle
   2.1 Premier démarrage
3. Intégrations standards
   3.1 Interface web

1. Installation

Il est possible d'installer l'interrupteur Wi-Fi de 3 manières:

Légendé:

L-in: entrée phase
N-in: entrée neutre

L-out: sortie phase 
N-out: sortie neutre

S1: cable d'interrupteur
S2: cable d'interrupteur

: cables de phase
: cables neutres
—: cables d'interrupteurs

Important:
 - ne branchez jamais de cables porteurs de courant dans les entrées d'interrupteurs S1 ou S1 !!!
 - veuillez respecter les entrées/sorties de phase et neutre

1.1. Switch Wi-Fi seul

1.2. Switch Wi-Fi avec un interrupteur physique

Wifi switch with a single rocker switch

1.3. Switch Wi-Fi avec 2 interrupteurs (va-et-vient)

2. Configuration logicielle

2.1 Premier démarrage

La première fois que vous mettez sous tension l'interrupteur Wi-Fi, un réseau Wi-Fi de la forme tasmota-XXXXXX-XXXX doit apparaitre:
ex:
 
Une fois connecté à ce réseau Wi-Fi une fenêtre de connexion apparait:
cms plugin media image
vous devrez alors renseigner les identifiants de votre réseau Wi-Fi domestique.
Une fois l'interrupteur connecté à votre réseau il vous montrera l'adresse IP qu'il a obtenu afin de vous connecter à son interface web.
cms plugin media image

3.Intégrations standards

3.1 Interface web

Vous pouvez simplement utiliser l'interface web pour controler votre interrupteur Wi-Fi.
Entrez l'adresse IP de votre module dans la barre d'adresse d'un navigateur web (ou ladresse IP préfixée de "http://" ex: http://192.168.1.71)
 
L'interface affichée doit ressembler à celle-ci :
Si vous avez un élément electrique connecté connecté au switch appuyez alors sur le bouton "Toggle" et les informations de consommation doivent alors varier:

3.2. MQTT

3.2.1 Introduction
Le protocole MQTT est une des meilleures solutions si vous hébergez un système libre de domotique

En utilisant ce protocole vous ne surchargerez pas les rssources votre système de domotique si vous avez beaucoup d'objets connectés à la maison.

Avant tout vous devez avoir de disponible un broker MQTT.
Nous recommandons le broker Mosquitto pour votre domotique personnelle.
Vous pouvez installer et configurer votre broker MQTT sur la plupart des systèmes de domotique libres (Domoticz/Jeedom/Home Assistant/...)
3.2.2 Exemple de configuration

Pour configurer votre switch Wi-Fi avec votre broker MQTT rendez-vous dans le "Menu principal" > "Configuration" > "Configure MQTT".
Un exemple de configuration :
Avec la configuration suivante :
  • Topic: mini-switch
  • Full Topic: home/salon/%topic%/
Votre interrupteur Wi-Fi enverra ses messages (statut/consommation électrique/...) dans le topic : home/salon/mini-switch
 
Exemple de messages envoyés par l'interrupteur Wi-Fi :
Topic Valeur
home/salon/mini-switch/POWER ON
home/salon/mini-switch/SENSOR {
  "Time":"2023-10-31T16:37:07",
  "Switch1":"ON",
  "Switch2":"ON",
  "ENERGY":{
    "TotalStartTime":"2023-09-22T13:38:46",
    "Total":0.030,
    "Yesterday":0.018,
    "Today":0.007,
    "Period":1,
    "Power":12,
    "ApparentPower":25,
    "ReactivePower":22,
    "Factor":0.47,
    "Voltage":248,
    "Current":0.101
  }
}

3.2.3 Changer l'état du switch

Si votre topic principal est home/salon/mini-switch

Pour allumer l'interrupteur Wi-Fi vous devez envoyer le message ON à votre broker dans le topic home/salon/mini-switch/cmnd/POWER1
Pour allumer l'interrupteur Wi-Fi vous devez envoyer le message  OFF à votre broker dans le topic home/salon/mini-switch/cmnd/POWER1

Action Topic Valeur
Allumer l'interrupteur {MAIN TOPIC}/cmnd/POWER1

(ex: home/salon/mini-switch/cmnd/POWER1)
ON
Eteindre l'interrupteur {MAIN TOPIC}/cmnd/POWER1

(ex: home/salon/mini-switch/cmnd/POWER1)
OFF
 

3.2.4 Connexion anonyme

De manière générale il est recommander de se connecter à un broker MQTT via un identifiant et mot de passe.
Si vous n'avez pas d'utilsateur configuré ou que vous souhaitez vous connecter de manière anonyme l'interface web Tasmota ne vous validera pas ce choix.
Pour ce faire vous devrez utiliser la commande Tasmota dans le "Menu principal" > "Console", "Enter Command" zone de texte :

backlog mqttuser 0; mqttpassword 0; restart 1

Et appuyer sur la touche "Entrée" au clavier :
Tasmota MQTT anonymous connection

La documentation complète de configuration MQTT sur Tasmota est disponivle sur la page Github : https://tasmota.github.io/docs/MQTT/

3.3 Requêtes HTTP (URLs)

Vous pouvez controler votre interrupteurs Wi-Fi par protocole HTTP (URLs) :
Action Commande
Allumer l'interrupteur http:///cm?cmnd=Power%20On
Eteindre l'interrupteur http:///cm?cmnd=Power%20Off
Changer d'état l'interrpteur http:///cm?cmnd=Power%20Toggle
(où correspond à l'adresse IP de votre interrupteur Wi-Fi)

Si vous souhaitez envoyer des requêtes HTTP de manière connectée à Tasmota vous trouverez ces informations sur la page officielle : https://tasmota.github.io/docs/Commands/#with-web-requests

4. Assistants vocaux

4.1 Alexa

L'interrupteur Wi-Fi se connecte facilement à Amazon Alexa, voici les étapes de configuration à suivre :

1/ Activer l'émulation dans l'interface d'administration Tasmota via le "Menu principal" > "Configuration" > "Configure Other"
  • Dans la zone de texte "Friendly name" indiquez le nom Alexa de votre switch (ex: "lumière du salon")
  • Activez l'émulation "Belkin WeMo"
  • Sauvegardez en cliquant sur le bouton "Save" :
Tasmota Alexa integration
2/ Ouvrez votre application mobile Alexa
Cliquez sur l'onglet "Appareils" :
Alexa > Devices
Cliquez sur le symbol "+" symbol and selectionnez "Ajouter un appareil" :
Alexa add a device
L'interrupteur Wi-Fi est détecté en tant que "prise connectée", sélectionnez un élément dans la liste proposée et laissez Alexa trouver votre interrupteur.
 
Une fois détecté vous pouvez l'utiliser en l'appelant par son nom: "Alexa, allume la lumière du salon".
 
La documentation Tasmota officielle pour l'intégration à Alexa est disponible à l'adresse : https://tasmota.github.io/docs/Alexa/#connecting-to-alexa

4.2 Google Home

L'interrupteur Wi-Fi Tomotics ne possède pas de configuration intégrée pour communiquer avec Google Home (comme avec Alexa).
Pour pouvoir communique avec Google Home l'interrupteur doit être intégré et configuré sur une plateforme de domotique comme Home Assistant/Jeedom/Domoticz/...
C'est cette plateforme de domotique qui prendra en charge la configuration de votre interrupteur.

5. Plateformes de domotique libres

5.1 Jeedom

Nous recommandons d'utiliser le protocole MQTT pour la communication entre votre switch et Jeedom.
Nous expliquerons ici son intégration avec le plugin Jeedom "jMQTT" qui est assez flexible :

1/ Vérifiez que le plugin jMQTT est bien installé et que tout est correctement fonctionnel dans la vue de configuration du plugin :
  - le plugin doit être actif
  - les dépendences et le deamon doivent être en statu OK
  - le broker (Mosquitto) doit être actif et opérationnel (running)
2/ Dans l'interface d'administration Tasmota configurez la partie MQTT (adresse IP, topic choisi, identifiants, ...) cf. Exemple de configuration MQTT
3/ Dans le plugin jMQTT cliquez sur "+ Ajouter", donnez lui un nom et sur la page suivante :
 - choisissez un objet parent (si nécessaire)
 - décochez la case "Ajout automatique des commandes"
 - le champ "Inscript au topic" doit contenir le topic choisi dans l'interface Tasmota et ajouter à la fin : /#
    ex: home/salon/mini-switch/#
4/ Dans la configuration des commandes ajoutez ces commandes :
Name Type Topic Parameters Options
STATUS Info / Autre home/salon/mini-switch/POWER   Afficher
POWER Info / Numerique home/salon/mini-switch/SENSOR
JSON path: [ENERGY][Power]
Unité : w Afficher
Historiser
ON Action / Défaut home/salon/mini-switch/cmnd/POWER1   Afficher
OFF Action / Défaut home/salon/mini-switch/cmnd/POWER1   Afficher
Today Info / Autre home/salon/mini-switch/SENSOR
JSON path: [ENERGY][Today]
Unité : w Afficher
Yesterday Info / Autre home/salon/mini-switch/SENSOR
JSON path: [ENERGY][Yesterday]
Unité : w Afficher
Total Info / Autre home/salon/mini-switch/SENSOR
JSON path: [ENERGY][Total]
Unité : w Afficher
et sauvegardez vos modifications.
 
la configuration doit ressembler à ceci :
 
5/ Allez vur votre dashboard principal, votre interrupteur doit alors apparaitre :

5.2 Domoticz

Prérequis: vous devez avoir un broker MQTT d'installé sur votre plateforme de domotique.
Mosquitto est le plus à même de répondre à votre besoin sur Domoticz et peut être installé sur toutes les plateformes (Linux, Windows, MacOS, Docker, ...).
 
1/ (optionnel) seulement si vous n'avez pas configuré votre broker MQTT sous Domoticz :

Ajouter une interface MQTT.
Dans le menu "Setup" > "Hardware" ajoutez un "MQTT Client Gateway with LAN interface"
et y renseigner:
  • un nom
  • l'adresse IP de votre broker MQTT
  • le port (généralement 1883)
  • un identifiant et mot de passe (si nécessaire)
Domoticz add MQTT interface
Une fois créée, votre interface MQTT apparait en haut de la page :
2/ Ajoutez un interrupteur factice (hardware dummy switch) :
in the menu "Setup" > "Hardware" ajoutez "Dummy (Does nothing, use for virtual switched only)" et donnez lui un nom adapté :
Domoticz add dummy switch
Une fois le bouton "Add" cliqué, le switch factice apparait en haut de la page :
Domoticz dummy switch added
3/ Maintenant créez 2 capteurs virtuels sur votre switch factice en cliquant sur "Create Virtual Sensors" :
Domoticz create virtual sensors
  • Le premier capteur virtuel doit avoir le champ "Sensor type" : Switch
  • Le second capteur virtuel doit avoir le champ "Sensor type": Electric (Instant+Counter)
Domoticz create virtual sensor switch et Domoticz create virtual sensor electric
4/ Vérifiez la création de vos capteur virtuels dans le menu "Setup" > "Devices" et notez les valeur de leurs champs "Idx" :
Domoticz setup devices
5/ Dans l'interface d'aminitration Tasmota de votre interrupteur configurez la partie MQTT :
  • l'adresse du broker MQTT
  • le topic choisi
  • ...
cf. Exemple de configuration MQTT
 
6/ Toujours dans l'interface d'administration Tasmota de votre interrupteur configurez la partie Domoticz :
Dans le "Menu principal" > "Configuration" > "Configure Domoticz"
- Dans le champ "Idx 1" spécifiez la valeur Idx de votre interrupteur (affichée sur Domoticz) 
- Dans le champ "Sensor Idx 4 Power,Energy" spécifiez la valeur Idx de votre capteur (affichée sur Domoticz) 
 
Et sauvegardez vos modifications:
Tomotics switch v1 set Domoticz configuration
 
7/ Testez votre implémentation
 
Si tout est correctement configuré:
  • Dans le menu "Switches" vous devriez voir votre interrupteur Wi-Fi,
    en cliquant sur l'ampoule le statu de votre switch (allumé/éteint) doit pouvoir changer à distance :
  • Dans le menu "Utility" vous devriez voir la consommation électrique actuelle de votre interrupteur,
    (si l'interrupteur est éteint la consommation doit être de "0 Watt")
Domoticz switch power info

5.3 Home assistant

L'interrupteur Wi-Fi est compatible avec Home Assistant en utilisant le protocole MQTT.

1/ (optionnal) Si vous n'en n'avez pas déjà un, intallez un broker MQTT.
Home Assistant recommande d'installer l'add-on Mosquitto MQTT broker
La documentation officielle Home Assistant pour la configuration de MQTT est disponible à cette adresse : https://www.home-assistant.io/integrations/mqtt/here

2/ Dans l'interface Tasmota de votre interrupteur configurez l'adresse IP de votre broker MQTT, le topic choisi, ... comme spécifié ici : Exemple de configuration MQTT

3/ Ensuite suivez les instructions fournies par Home Assitant pour intégrer des appareil Tasmota : https://www.home-assistant.io/integrations/tasmota/
Sections: Documentation