Se rendre au contenu

← Intégration ESPHome | Sommaire | Suivant : Vue d'ensemble Lambda →

DimmerLink — Intégration ESPHome Lambda

← Intégration ESPHome


Intégration du variateur AC TRIAC DimmerLink avec Home Assistant via ESPHome à l'aide de fonctions lambda.

Tip
Pour une approche plus simple sans code lambda, consultez le [composant externe](https://github.com/robotdyn-dimmer/DimmerLink/tree/main/components).



Sommaire


Sections principales

  1. Introduction — Vue d'ensemble, prérequis, connexion, configuration de base
  2. Entités — Entités prêtes à l'emploi pour votre configuration
  3. Exemples — Configurations YAML complètes et fonctionnelles
  4. Référence Lambda — Référence des registres I2C et des fonctions lambda
  5. Dépannage — Intégration Home Assistant, dépannage, feuille de route



Démarrage rapide


1. Connexion

text
ESP32          DimmerLink
─────          ──────────
3.3V     →     VCC
GND      →     GND
GPIO21   →     SDA
GPIO22   →     SCL


2. Configuration minimale

yaml
esphome:
  name: dimmerlink

esp32:
  board: esp32dev

logger:
api:
ota:

wifi:
  ssid: "YOUR_WIFI"
  password: "YOUR_PASSWORD"

i2c:
  sda: GPIO21
  scl: GPIO22
  id: bus_a

output:
  - platform: template
    id: dimmer_out
    type: float
    write_action:
      - lambda: |-
          uint8_t level = (uint8_t)(state * 100.0f);
          uint8_t data[2] = {0x10, level};
          id(bus_a).write(0x50, data, 2, true);

light:
  - platform: monochromatic
    name: "Dimmer"
    output: dimmer_out
    gamma_correct: 1.0


3. Flasher le firmware

bash
esphome run dimmerlink.yaml

30 lignes — et le variateur est dans Home Assistant !




Types d'entités

Entité Plateforme Description
Light monochromatic Variateur principal avec réglage de luminosité
Sensor template Fréquence AC, niveau, version
Binary Sensor template Statut de disponibilité, indicateur d'erreur
Text Sensor template Code d'erreur (texte)
Select template Sélection de la courbe de variation
Number template Contrôle direct du niveau
Button template Réinitialisation, recalibrage

En savoir plus sur les entités




Exemples de configuration

Exemple Description Lien
Minimal Light + I2C basique
Standard Light + capteurs + Select
Étendu Toutes les entités + diagnostics
Multi-appareil 2+ variateurs sur un seul bus
Avec bouton Contrôle par bouton physique
Production Pour environnement de production

Tous les exemples




Carte des registres (résumé)

Adresse Nom R/W Description
0x00 STATUS R État de l'appareil
0x01 COMMAND W Commandes de contrôle
0x02 ERROR R Dernier code d'erreur
0x10 DIM0_LEVEL R/W Luminosité 0–100 %
0x11 DIM0_CURVE R/W Courbe 0–2
0x20 AC_FREQ R Fréquence AC
0x30 I2C_ADDRESS R/W Adresse I2C

Référence complète




Document Description
External Component Composant ESPHome DimmerLink (sans lambda)
I2C Communication Détails du protocole I2C
Hardware Connection Schémas de câblage



Historique des versions

Version Date Modifications
1.0 2026-02 Première publication

← Intégration ESPHome

← Intégration ESPHome | Sommaire | Suivant : Vue d'ensemble Lambda →