prefixkit Ask an engineerAsk Support RU

ESPHome devices

Sonoff THR320D: ESPHome

Sonoff THR320D (relays, ESP32): GPIO pinout and a starter ESPHome config with relays, buttons, LED. Local Home Assistant control with no cloud.

Type
Relays
Chip
ESP32
Region standard
GLOBAL

Pinout

PinFunction
GPIO0Push Button (HIGH = off, LOW = on)
GPIO4Small Relay (Dry Contact)
GPIO5Display (TM1621) Data
GPIO13Right LED (Green)
GPIO15Middle LED (Blue)
GPIO16Left LED (Red)
GPIO17Display (TM1621) CS
GPIO18Display (TM1621) Write
GPIO19Large/Main Relay pin 1, pull high for relay ON
GPIO22Large/Main Relay pin 2, pull high for relay OFF
GPIO23Display (TM1621) Read
GPIO25Pin 2 of the RJ-9 connector
GPIO27Pin 1 of the RJ-9 connector

Find it in shops: AliExpress

Links open a search in the shop; some are affiliate links: buying through them costs you nothing extra and supports this site. We do not sell devices or get them from manufacturers.

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: sonoff-thr320d

esphome:
  name: ${name}
  friendly_name: "Sonoff THR320D"

esp32:
  board: esp32dev

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"  # Small Relay (Dry Contact)
    restore_mode: RESTORE_DEFAULT_OFF
  - platform: gpio
    pin: GPIO19
    id: relay2
    name: "Relay 2"  # Large/Main Relay pin 1, pull high for relay ON
    restore_mode: RESTORE_DEFAULT_OFF
  - platform: gpio
    pin: GPIO22
    id: relay3
    name: "Relay 3"  # Large/Main Relay pin 2, pull high for relay OFF
    restore_mode: RESTORE_DEFAULT_OFF

binary_sensor:
  - platform: gpio
    pin:
      number: GPIO0
      mode: INPUT_PULLUP
      inverted: true
    name: "Button"  # Push Button (HIGH = off, LOW = on)
    on_press:
      - switch.toggle: relay1

status_led:
  pin:
    number: GPIO13
    inverted: false  # Right LED (Green)

# Other pins from the pinout:
#   GPIO15: Middle LED (Blue)
#   GPIO16: Left LED (Red)
#   GPIO5: Display (TM1621) Data
#   GPIO17: Display (TM1621) CS
#   GPIO18: Display (TM1621) Write
#   GPIO23: Display (TM1621) Read
#   GPIO25: Pin 2 of the RJ-9 connector
#   GPIO27: Pin 1 of the RJ-9 connector

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.

Similar devices

Idea?