Starter ESPHome config
Built from the pinout above. Keys and the Wi-Fi password come from secrets.yaml in ESPHome. Check the pins against your hardware revision before flashing: one model can ship with different boards.
substitutions:
name: shelly-2-5
esphome:
name: ${name}
friendly_name: "Shelly 2.5"
esp8266:
board: esp01_1m # most plugs and relays have 1 MB flash; check yours
logger:
api:
encryption:
key: !secret api_key
ota:
- platform: esphome
password: !secret ota_password
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
ap: {}
captive_portal:
switch:
- platform: gpio
pin: GPIO4
id: relay1
name: "Relay 1" # Relay 1
restore_mode: RESTORE_DEFAULT_OFF
- platform: gpio
pin: GPIO15
id: relay2
name: "Relay 2" # Relay 2
restore_mode: RESTORE_DEFAULT_OFF
binary_sensor:
- platform: gpio
pin:
number: GPIO2
mode: INPUT_PULLUP
inverted: true
name: "Button" # Button 1
on_press:
- switch.toggle: relay1
status_led:
pin:
number: GPIO0
inverted: false # LED 1i
# Other pins from the pinout:
# GPIO5: Switch 2 Input
# GPIO12: i2c SDA
# GPIO13: Switch 1 Input
# GPIO14: i2c SCL
# GPIO16: ADE7953 IRQ (power measurement)
How to flash
- Most devices are flashed over UART: a 3.3 V USB-TTL adapter to RX, TX, GND and 3V3, holding GPIO0 to ground at power-on (ESP8266/ESP32). Mains power disconnected.
- Beken (BK72xx) and Realtek chips are flashed with ltchiptool, or with cloudcutter without opening the case if the firmware allows it.
- Details and board photos: the device page in the ESPHome database.
A config from scratch: ESPHome generator. Which pins are safe: pinout.