prefixkit Ask an engineerAsk Support RU

ESPHome devices

Tuya 2 Gang Switch Socket: ESPHome

Tuya 2 Gang Switch Socket (wall switches, BK72XX): GPIO pinout and a starter ESPHome config with relays, buttons, LED. Local Home Assistant control with no cloud.

Type
Wall switches
Chip
BK72XX
Region standard
AU

Pinout

PinFunction
P0Bottom Button Blue LED (H)
P6Top Button Relay L2 (H)
P7Top Button Blue LED (H)
P8Top Button (L)
P9Status LED RED (H)
P10Bottom Button (L)
P11GPO Button (L)
P24Bottom Button Relay L1 (H)
P26GPO Relay (H)

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: tuya-2-gang-switch-socke

esphome:
  name: ${name}
  friendly_name: "Tuya 2 Gang Switch Socket"

bk72xx:
  board: generic-bk7231n-qfn32-tuya  # BK7231T or BK7231N: check the chip marking

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: P6
    id: relay1
    name: "Relay 1"  # Top Button Relay L2 (H)
    restore_mode: RESTORE_DEFAULT_OFF
  - platform: gpio
    pin: P24
    id: relay2
    name: "Relay 2"  # Bottom Button Relay L1 (H)
    restore_mode: RESTORE_DEFAULT_OFF
  - platform: gpio
    pin: P26
    id: relay3
    name: "Relay 3"  # GPO Relay (H)
    restore_mode: RESTORE_DEFAULT_OFF

binary_sensor:
  - platform: gpio
    pin:
      number: P0
      mode: INPUT_PULLUP
      inverted: true
    name: "Button 1"  # Bottom Button Blue LED (H)
    on_press:
      - switch.toggle: relay1
  - platform: gpio
    pin:
      number: P7
      mode: INPUT_PULLUP
      inverted: true
    name: "Button 2"  # Top Button Blue LED (H)
    on_press:
      - switch.toggle: relay2
  - platform: gpio
    pin:
      number: P8
      mode: INPUT_PULLUP
      inverted: true
    name: "Button 3"  # Top Button (L)
    on_press:
      - switch.toggle: relay3
  - platform: gpio
    pin:
      number: P10
      mode: INPUT_PULLUP
      inverted: true
    name: "Button 4"  # Bottom Button (L)
    on_press:
      - switch.toggle: relay1
  - platform: gpio
    pin:
      number: P11
      mode: INPUT_PULLUP
      inverted: true
    name: "Button 5"  # GPO Button (L)
    on_press:
      - switch.toggle: relay1

status_led:
  pin:
    number: P9
    inverted: true  # Status LED RED (H)

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?