#############################################
#############################################
# MAIN BATHROOM FAN/HEAT COMBO SWITCH 
# V1.1 2025-08-26 Minor Changes (MQTT)
# V1.0 2025-06-01 Initial Version
#############################################
# 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-mainbathfancombo"
  friendly_name: "Main Bathroom Fan/Heat Combo Switch (2)"
  description_comment: "Main Bathroom Fan/Heat Switch using a Zemismart KS-811 Double Push Button. Extract Fan (1), IR heater (2)"
  device_area: "Laundry" # Allows ESP device to be automatically linked to an 'Area' in Home Assistant.  
  
  # Project Naming
  project_name: "Zemismart Technologies.KS-811-2 (Double)" # Project Details 
  project_version: "v1.1"  # Project V denotes release of yaml file, allowing checking of deployed vs latest version
  
  entity_prefix: "Main Bathroom" # Simple device name where we want to prefix a sensor or switch, eg "Load" Current. 

  # 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-mainbathfancombo_ip
  mqtt_command_main_topic: !secret mqtt_command_main_topic
  #mqtt_status_main_topic: !secret mqtt_status_main_topic
  
  # Device Settings
  #relay_icon: "mdi:heating-coil"
  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

  # MQTT REMOTE Controls
  mqtt_remote_device1_name: "masterbath-towelrail"
  mqtt_remote_device1_command_topic: "${mqtt_command_main_topic}/${mqtt_remote_device1_name}/operation"
  mqtt_remote_device1_command1: "BOOST"

##########################################################################################
# PACKAGES: Included Common Packages
# https://esphome.io/components/packages.html
##########################################################################################
packages:
  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}"
  common_api: !include
    file: common/api_common.yaml
    vars:
      local_api_key: "${api_key}"
  #common_webportal: !include
  #  file: common/webportal_common.yaml
  common_mqtt: !include
    file: common/mqtt_common.yaml
    vars:
      local_device_name: "${device_name}"
  common_sntp: !include
    file: common/sntp_common.yaml
  common_general_sensors: !include
    file: common/sensors_common.yaml
    vars:
      local_friendly_name: "${friendly_name}"
      local_update_interval: "${update_interval}"

#############################################
# 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}"
  platformio_options:
    build_flags:
      - "-Os"                   # optimize for size
      - "-Wl,--gc-sections"     # drop unused code/data
      - "-fno-exceptions"       # strip C++ exceptions
      - "-fno-rtti"             # strip C++ RTTI
#  on_boot:       
#    priority: 200
#    then:
#      - switch.turn_on: Relay_3

#############################################
# 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)
  #esp8266_store_log_strings_in_flash: false
  #tx_buffer_size: 64

#############################################
# STATUS LED
# https://esphome.io/components/status_led.html
#############################################
# Status LED for KS-811 is gpio2
#############################################
status_led:
  pin:
    number: GPIO2
    inverted: yes

#############################################
# BINARY SENSORS
# https://esphome.io/components/binary_sensor/
#############################################
# Buttons for KS-811-2 are GPIO16, GPIO05
#############################################
binary_sensor:
  - platform: gpio
    pin:
      number: GPIO16
      mode: INPUT
      inverted: True
    name: "Button 1: Extract Fan"
    on_press:
      - switch.toggle: "Relay_1"

  - platform: gpio
    pin:
      number: GPIO05
      mode: INPUT
      inverted: true
    name: "Button 2: IR Heater"
    filters:
      - delayed_on: 20ms
      - delayed_off: 20ms

    on_multi_click:
      # ── Single click: one quick press & release ─────────────────
      - timing:
          - ON for at most 400ms
          - OFF for at least 200ms
        then:
          - switch.toggle: "Relay_2"

      # ── Double click: two quick presses/releases ───────────────
      - timing:
          - ON for at most 400ms
          - OFF for at most 400ms
          - ON for at most 400ms
          - OFF for at least 200ms
        then:
          - mqtt.publish:
              topic: "${mqtt_remote_device1_command_topic}"
              payload: "${mqtt_remote_device1_command1}"

#############################################
# SWITCH COMPONENT
# https://esphome.io/components/switch/
#############################################
# Relays for KS-811-2 are GPIO13, GPIO12
#############################################
switch:
  - platform: gpio
    name: "Relay 1: Extract Fan"
    pin: GPIO13
    id: Relay_1
    
  - platform: gpio
    name: "Relay 2: IR Heater"
    pin: GPIO12
    id: Relay_2
    # Always run the fan when IR heater on.  Not critical for this heat/lamp product
    # as it has its own failsafes and fan switching on temp, but an added safety measure
    on_turn_on:
      switch.turn_on: "Relay_1"