zorruno-homeassistant/esphome/esp-garageentrylights.yaml

#############################################
#############################################
# GARAGE ENTRY LIGHTSWITCH (OBK Converted, BK7231N)
# V1.0 2025-11-23 Initial
#############################################
# Zemismart KS-811 Triple push button
# pinout/schematic https://community.home-assistant.io/t/zemismart-ks-811-working-with-esphome/
#
# NOTES
# - 
#
#############################################
#############################################

#############################################
# SPECIFIC DEVICE VARIABLE SUBSTITUTIONS
# If NOT using a secrets file, just replace these with the passwords etc (in quotes)
#############################################
substitutions:
  # Device Naming
  device_name: "esp-garageentrylights"
  friendly_name: "Garage Entry Lightswitch (3)"
  description_comment: "BK7231N - Garage Entry Lightswitch using a Zemismart KS-811 Triple Push Button. Corridor Light (1), Patio Lights (2), Garage Lights (3)"
  device_area: "Garage" # Allows ESP device to be automatically linked to an 'Area' in Home Assistant.  
  
  # Project Naming
  project_name: "Zemismart Technologies.KS-811 Triple BK7231N" # Project Details 
  project_version: "v1.0"  # Project V denotes release of yaml file, allowing checking of deployed vs latest version

  # Passwords
  api_key: !secret esp-api_key # unfortunately you can't use substitutions inside secrets names
  ota_pass: !secret esp-ota_pass # unfortunately you can't use substitutions inside secrets names
  static_ip_address: !secret esp-garageentrylights_ip

  # Device Settings
  log_level: "INFO" # Define logging level: NONE, ERROR, WARN, INFO, DEBUG (Default), VERBOSE, VERY_VERBOSE
  update_interval: "60s" # update time for for general sensors etc

  # Default relay restore mode
  # Options: RESTORE_DEFAULT_OFF, RESTORE_DEFAULT_ON, ALWAYS_ON, ALWAYS_OFF
  relay_restore_mode: "RESTORE_DEFAULT_OFF"
  
  # Switch Naming
  switch_1_name: "Corridor Lights" # Only one light (Garage Side) actually connected to this relay 
  switch_2_name: "Patio Lights" # Output for pario string hanging lights 
  switch_3_name: "Garage Lights" # This is virtual only, no power connected to 3rd relay 

##########################################################################################
# PACKAGES: Included Common Packages
# https://esphome.io/components/packages.html
##########################################################################################
packages:
  #### WIFI, Network (Static/DHCP/IPV6 etc), Fallback AP, Safemode ####
  common_wifi: !include
    file: common/network_common.yaml
    vars:
      local_device_name: "${device_name}"
      local_static_ip_address: "${static_ip_address}"
      local_ota_pass: "${ota_pass}"

  #### HOME ASSISTANT API (choose encryption or no encryption options) ####
  common_api: !include
    file: common/api_common.yaml
    #file: common/api_common_noencryption.yaml
    vars:
      local_api_key: "${api_key}"

  #### MQTT ####
  common_mqtt: !include
    file: common/mqtt_common.yaml
    vars:
      local_device_name: "${device_name}"
  
  #### WEB PORTAL ####
  #common_webportal: !include common/webportal_common.yaml
  #### SNTP (Only use if you want/need accurate timeclocks) ####
  #common_sntp:      !include common/sntp_common.yaml

  #### DIAGNOSTICS Sensors ####
  diag_basic:       !include common/include_basic_diag_sensors.yaml
  #diag_more:        !include common/include_more_diag_sensors.yaml
  #diag_debug:       !include common/include_debug_diag_sensors.yaml
  #diag_resetcount:  !include common/include_resetcount_diag_sensors.yaml

#############################################
# ESPHome
# https://esphome.io/components/esphome.html
#############################################
esphome:
  name: "${device_name}"
  friendly_name: "${friendly_name}"
  comment: "${description_comment}" # Appears on the esphome page in HA
  area: "${device_area}"
  project:
    name: "${project_name}"
    version: "${project_version}"
#  on_boot:       
#    priority: 200
#    then:
#      - switch.turn_on: Relay_3

#############################################
# BUILD FOR BK CHIPSET
# bk72xx
# https://devices.esphome.io/board/bk72xx/
#############################################
bk72xx:
  board: generic-bk7231n-qfn32-tuya

#############################################
# ESP Platform and Framework
# https://esphome.io/components/esp32.html
#############################################
#esp8266:
#  board: esp01_1m
#  early_pin_init: False # Initialise pins early to known values. Recommended false where switches are involved. Defaults to True.
#  board_flash_mode: dout # Default is dout

#############################################    
# ESPHome Logging Enable
# https://esphome.io/components/logger.html
############################################# 
logger:
  level: "${log_level}"  #INFO Level suggested, or DEBUG for testing
  #baud_rate: 0 #set to 0 for no logging via UART, needed if you are using it for other serial things (eg PZEM)
  id: logger_id

#############################################
# STATUS LED
# https://esphome.io/components/status_led.html
#############################################
status_led:
  pin:
    number: P22 #GPIO22
    inverted: true

#############################################
# BINARY SENSORS
# https://esphome.io/components/binary_sensor/
#############################################
binary_sensor:
  - platform: gpio
    pin:
      number: P17
      mode:
        input: true
        pullup: true
      inverted: true
    name: "Button 1: ${switch_1_name}"
    on_press:
      - delay: 50ms
      - switch.toggle: Relay_1

  - platform: gpio
    pin:
      number: P26
      mode:
        input: true
        pullup: true
      inverted: true
    name: "Button 2: ${switch_2_name}"
    on_press:
        - delay: 50ms
        - switch.toggle: Relay_2

  - platform: gpio
    pin:
      number: P24
      mode:
        input: true
        pullup: true
      inverted: true
    name: "Button 3: ${switch_3_name}"
    on_press:
        - delay: 50ms
        - switch.toggle: Relay_3

#############################################
# SWITCH COMPONENT
# https://esphome.io/components/switch/
#############################################
switch:
  - platform: gpio
    name: "Relay 1: ${switch_1_name}"
    pin: P14 #GPIO14
    id: Relay_1
    restore_mode: ${relay_restore_mode}
  - platform: gpio
    name: "Relay 2: ${switch_2_name}"
    pin: P16 #GPIO16
    id: Relay_2
    restore_mode: ${relay_restore_mode}
  - platform: gpio
    name: "Relay 3: ${switch_3_name}"
    pin: P15 #GPIO15
    id: Relay_3
    restore_mode: ${relay_restore_mode}