prefixkit Ask an engineerAsk Support RU

ESPHome devices

Generic Glass Touch Switch with 1, 2, 3 pole variants: ESPHome

Generic Glass Touch Switch with 1, 2, 3 pole variants (wall switches, ESP8266): GPIO pinout and a starter ESPHome config with relays, buttons, LED. Local Home Assistant control with no cloud.

Type
Wall switches
Chip
ESP8266
Region standard
US

Pinout

PinFunction
GPIO3Button, Top
GPIO4Relay, Top _(Labeled L4)_
GPIO5Button, Middle
GPIO12Button, Bottom
GPIO13Relay, Bottom _(Labeled L2)_
GPIO15Relay, Middle _(Labeled L3)_
GPIO16Status LED
GPIO0Status LED _(alternative, some switches)_
GPIO14LED, Top _(some switches)_
GPIO1LED, Middle _(some switches)_
GPIO14LED, Bottom _(some switches)_

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: generic-glass-touch-swit

esphome:
  name: ${name}
  friendly_name: "Generic Glass Touch Switch with 1, 2, 3 pole variants"

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, Top _(Labeled L4)_
    restore_mode: RESTORE_DEFAULT_OFF
  - platform: gpio
    pin: GPIO13
    id: relay2
    name: "Relay 2"  # Relay, Bottom _(Labeled L2)_
    restore_mode: RESTORE_DEFAULT_OFF
  - platform: gpio
    pin: GPIO15
    id: relay3
    name: "Relay 3"  # Relay, Middle _(Labeled L3)_
    restore_mode: RESTORE_DEFAULT_OFF

binary_sensor:
  - platform: gpio
    pin:
      number: GPIO3
      mode: INPUT_PULLUP
      inverted: true
    name: "Button 1"  # Button, Top
    on_press:
      - switch.toggle: relay1
  - platform: gpio
    pin:
      number: GPIO5
      mode: INPUT_PULLUP
      inverted: true
    name: "Button 2"  # Button, Middle
    on_press:
      - switch.toggle: relay2
  - platform: gpio
    pin:
      number: GPIO12
      mode: INPUT_PULLUP
      inverted: true
    name: "Button 3"  # Button, Bottom
    on_press:
      - switch.toggle: relay3

status_led:
  pin:
    number: GPIO16
    inverted: true  # Status LED

# Other pins from the pinout:
#   GPIO0: Status LED _(alternative, some switches)_
#   GPIO14: LED, Top _(some switches)_
#   GPIO1: LED, Middle _(some switches)_
#   GPIO14: LED, Bottom _(some switches)_

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?