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: xiangshang-xs-ssa05-smar
esphome:
name: ${name}
friendly_name: "Xiangshang XS-SSA05 Smart Plug"
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: GPIO12
id: relay1
name: "Relay" # Relay 1
restore_mode: RESTORE_DEFAULT_OFF
binary_sensor:
- platform: gpio
pin:
number: GPIO13
mode: INPUT_PULLUP
inverted: true
name: "Button" # Button 1
on_press:
- switch.toggle: relay1
status_led:
pin:
number: GPIO0
inverted: true # Red Status LED (External)
# Other pins from the pinout:
# GPIO4: Blue LED (Internal)
# GPIO15: Blue Link LED (External)
# GPIO1: None
# GPIO2: None
# GPIO3: HLW8012 SELi
# GPIO9: None
# GPIO10: None
# GPIO16: None
# GPIO17: ADC Input 1
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.