Aziz Bench

Générateur de configuration ESPHome

Choisissez la carte, ajoutez des capteurs et des sorties, et obtenez une configuration prête à flasher, avec les clés de chiffrement de l’API et de l’OTA générées dans votre navigateur. Les broches qui pourraient empêcher la carte de démarrer sont signalées avant que vous ne câbliez quoi que ce soit.

Aller au YAML généré ↓
Appareil
Framework

Dans les versions actuelles d’ESPHome, ESP-IDF est le framework par défaut pour l’ESP32. Ne choisissez Arduino que si un composant dont vous avez besoin l’exige.

Lettres minuscules, chiffres et tirets. Il devient le nom d’hôte, par exemple sensor-node.local.

Capteurs et sorties

Aucun composant pour l’instant : ajoutez-en un depuis la liste ci-dessous.

Réseau et Home Assistant

Si le Wi-Fi ne fonctionne pas, la carte ouvre son propre réseau pour que vous puissiez saisir de nouveaux identifiants depuis un téléphone.

Fait gagner une ou deux secondes à chaque connexion, ce qui compte en veille profonde.

Les clés et les mots de passe sont générés dans votre navigateur et enregistrés uniquement à cet endroit : ils restent donc les mêmes quand vous revenez. Créez-en de nouveaux pour chaque nouvel appareil.

Extras

sensor-node.yaml

esphome:
  name: sensor-node
  friendly_name: "Nœud de capteurs"

esp32:
  board: esp32dev
  framework:
    type: esp-idf

logger:

api:
  encryption:
    key: "GENERATED-IN-YOUR-BROWSER"

ota:
  - platform: esphome
    encryption:

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  ap:
    ssid: "Nœud de capteurs Fallback"
    password: "GENERATED-IN-YOUR-BROWSER"

captive_portal:

sensor:
  - platform: dht
    pin: GPIO4
    model: DHT22
    temperature:
      name: "Climat température"
    humidity:
      name: "Climat humidité"
    update_interval: 60s
  - platform: wifi_signal
    name: "Signal Wi-Fi"
    update_interval: 60s
  - platform: uptime
    name: "Temps de fonctionnement"

switch:
  - platform: gpio
    pin: GPIO26
    name: "Relais"
    restore_mode: RESTORE_DEFAULT_OFF
secrets.yaml 
wifi_ssid: "YourNetworkName"
wifi_password: "YourWiFiPassword"

Enregistrez ce fichier à côté de la configuration, dans le dossier d’ESPHome, avec le nom et le mot de passe de votre Wi-Fi.

Comment utiliser le fichier

Installez ESPHome, soit comme module complémentaire ESPHome Device Builder dans Home Assistant, soit avec pip install esphome sur votre ordinateur. Enregistrez la configuration sous le nom de l’appareil, par exemple sensor-node.yaml, et placez dans le même dossier un secrets.yaml avec le nom et le mot de passe de votre Wi-Fi.

Flashez la carte la première fois en USB, avec esphome run sensor-node.yaml ou depuis le Device Builder. Ensuite, les mises à jour passent par le Wi-Fi. Home Assistant découvre l’appareil sur le réseau et demande la clé de chiffrement de l’API, qui se trouve dans la configuration.

Les broches qui peuvent empêcher la carte de démarrer

Certaines broches sont lues au reset pour décider comment la puce démarre. Sur l’ESP32, ce sont les GPIO 0, 2, 5, 12 et 15 ; sur l’ESP8266, D3, D4 et D8. Un capteur ou un module relais qui force l’une d’elles au mauvais niveau à la mise sous tension peut bloquer la carte. Le générateur signale ces broches dans les listes ; le brochage interactif de l’ESP32 les explique une par une.

Mises à jour OTA chiffrées

Depuis la version 2026.9, ESPHome peut chiffrer les mises à jour par le réseau avec la même clé que l’API Home Assistant, et le recommande à la place de l’ancien mot de passe OTA. Le générateur utilise le chiffrement par défaut. Si votre ESPHome est plus ancien, choisissez l’option mot de passe, ou mettez d’abord ESPHome à jour.

Veille profonde sur batterie

En veille profonde (deep sleep), la carte se réveille, envoie ses mesures et se rendort. Une IP statique raccourcit la connexion et économise de l’énergie à chaque réveil. Pour estimer combien de temps tient une batterie avec votre intervalle de réveil, utilisez le calculateur d’autonomie de batterie pour ESP32.

Questions fréquentes

Faut-il Home Assistant pour utiliser ESPHome ?

Non. L’API sert à Home Assistant, mais ESPHome fonctionne aussi seul avec la page web sur le port 80, ou avec MQTT. Sans Home Assistant, vous pouvez désactiver l’option API et activer la page web.

Où mettre le mot de passe Wi-Fi ?

Dans secrets.yaml, un fichier séparé dans le même dossier que la configuration. La configuration ne fait qu’y renvoyer, avec !secret wifi_ssid et !secret wifi_password : vous pouvez donc partager le YAML sans exposer votre mot de passe.

À quoi sert la clé de chiffrement de l’API ?

Elle chiffre le trafic entre l’appareil et Home Assistant. Home Assistant la demande quand vous ajoutez l’appareil. Avec l’OTA chiffrée, la même clé protège aussi les mises à jour du firmware.

Pourquoi ESPHome m’avertit-il à propos d’une broche de strapping ?

La puce lit les broches de strapping au reset pour décider comment démarrer. Les utiliser est permis, mais un circuit qui les force au mauvais niveau à la mise sous tension peut empêcher la carte de démarrer. Préférez d’autres broches, ou assurez-vous que rien ne les pilote pendant le démarrage.

Quelle carte choisir pour un ESP32 DevKit générique ?

esp32dev convient à la plupart des cartes avec un module ESP32-WROOM-32, y compris le DevKitC et le DOIT DevKit V1 à 30 broches. Ne choisissez les options C3 ou S3 que si la puce de votre carte est un ESP32-C3 ou un ESP32-S3.

Puis-je ajouter d’autres capteurs plus tard ?

Oui. Modifiez le YAML dans ESPHome et renvoyez-le par Wi-Fi. Vous pouvez aussi revenir sur cette page : vos réglages et vos clés sont enregistrés dans votre navigateur.