eWeLink Remote Control sous Tasmota

Introduction

eWeLink-Remote Control est une solution de contrôle à distance exclusive aux appareils SONOFF, qui est une optimisation sur la base du contrôle RF 433MHz traditionnel.
Les appareils utilisant eWeLink Remote Control (S-MATE2 et R5) sont des dispositifs Bluetooth Low Energy (BLE) qui peuvent être utilisés pour contrôler vos appareils domotiques.
Actuellement, seuls les modules sous le firmware d’origine eWeLink (BASICR4, MINIR4, MINIR3, DUALR3, DUALR3 Lite) permettent d’échanger avec ces appareils eWeLink Remote Control.
Le but de ce sujet est de permettre de décoder depuis n’importe quel ESP32 sous Tasmota les échanges de ces modules eWeLink.

Caractéristiques

• Compatible avec les modules eWeLink :
  • S-MATE2 (3 boutons)
  • R5 (6 boutons)
• Détection automatique des appareils eWeLink
• Interface web intuitive pour la configuration
• Actions multiples par bouton :
  • Clic simple
  • Double-clic
  • Appui long
• Messages MQTT personnalisables
• Événements Tasmota pour l’automatisation
• Historique sur l’accueil des appuis sur 1 heure

Prérequis

• Un ESP32 avec Tasmota installé.
• Tasmota Mi32-bluetooth.
• Berry activé.
• Bluetooth activé dans Tasmota : SetOption115 1

Installation

Manuelle

1. Téléchargez le fichier remote.be
2. Dans l’interface Tasmota, allez dans :
   • Console
   • Manage File System
   • Cliquez sur « Choose File » et sélectionnez remote.be
   • Cliquez sur « Upload »
3. Et chargez-le : br load('remote.be')

Automatique

Copiez ce code dans votre ESP32 via Tasmota web interface (Console -> Berry Scripting Console)

import path
def start_eweremote_setup()
 var cl = webclient()
 var url = 'https://raw.githubusercontent.com/Flobul/Tasmota-eWeLinkRemote/main/remote.be'
 cl.begin(url)
 var r = cl.GET()
 if r != 200
   print('error getting remote.be')
   return false
 end
 var s = cl.get_string()
 cl.close()
 var f = open('remote.be', 'w')
 f.write(s)
 f.close()
 load('remote.be')
end
start_eweremote_setup()

Configuration

Si l’ESP32 est à portée de l’appareil eWeLink, on peut directement le lier dans la page de configuration « eWeLink Remote ».

Ajout d’un appareil eWeLink

1. Appuyez sur un bouton de votre appareil eWeLink.
2. Il apparaît automatiquement dans sur la page d’accueil Tasmota de votre ESP32.
3. Cliquez sur « Save Device » pour l’enregistrer.

Configuration des boutons

Une fois l’appareil enregistré, allez dans le menu eWelink Remote pour configurer des actions sur le/les relais de l’ESP32.

Pour chaque bouton, vous pouvez :

1. Sélectionner le relais à contrôler.
2. Choisir les actions qui déclencheront le relais :
   • Simple : clic simple
   • Double : double-clic
   • Hold : appui long
3. Cliquer sur « Add » pour créer l’association.

Messages MQTT

Chaque appui génère un message MQTT :

{
  "Button1": {
    "Action": "simple"
  },
  "Signal": -90,
  "DeviceType": "S-MATE2",
  "Sequence": 73,
  "Timestamp": 1741982724
}

Le topic MQTT peut être configuré en deux formats :

• Standard Tasmota (par défaut)
• Simplifié : tele/tasmota_ble/<deviceId>

Commandes Tasmota

Gestion des télécommandes

# Liste les télécommandes enregistrées

EweAddDevice

# Ajoute une télécommande

EweAddDevice <id>

# Supprime une télécommande

EweRemoveDevice <id>

Gestion des associations

# Ajoute une association

EweAddBinding <deviceId>_<button>_<relay>_<actions>

# Supprime une association

EweRemoveBinding <deviceId>_<button>_<relay>

Configuration MQTT

# Configure le format du topic

EweTopic <mode>
# 0=standard, 1=simplifié

Dépannage

• Vérifiez que le Bluetooth est activé (SetOption115 1).
• Vérifiez que vous utilisez bien le firmware tasmota mi32.
• La LED de l’appareil eWeLink doit clignoter à l’appui.
• Portée maximale : environ 150 mètres en champ libre.
• Consultez les logs dans la console Tasmota.

Liens

• Code source sur GitHub
• Documentation Tasmota

Note technique

Ce module est développé en Berry, le langage de script intégré à Tasmota. Il utilise le système de configuration Tasmota et sauvegarde ses paramètres dans un fichier JSON.

La détection des appareil eWeLink utilise le protocole BLE pour intercepter et décoder les paquets envoyés par les télécommandes eWeLink.

N’hésitez pas à contribuer ou signaler des problèmes sur GitHub !