# ESPectre - ESP32-C3 Configuration
# WiFi CSI-based motion detection with Home Assistant integration
#
# Tested boards (community verified):
# - ESP32-C3 Super Mini (AliExpress/Temu, tested by @mvfc, @francescopace)
# - AirM2M Core ESP32-C3 (tested by @WLaoDuo)
#
# ESP32-C3 Super Mini Notes:
# - Set traffic_generator_rate to 94 or less (higher values cause calibration issues)
# - Boards with USB-UART bridges (CH343, CP2102): uncomment hardware_uart in logger section (tested by @gasment)
# - Some cheap clones may require DIO flash mode - see platformio_options below
#
# Provisioning:
# - Via BLE: Use the ESPHome app or Home Assistant companion app
# - Via USB: Use ESPHome web tools (https://web.esphome.io)
# - Via WiFi: Connect to "ESPectre Fallback" AP and configure

substitutions:
  git_ref: main # branch, tag, or commit
  detection_algorithm: mvs # mvs (default) or ml

esphome:
  name: espectre
  friendly_name: ESPectre
  min_version: 2025.11.0
  # Uncomment the next line if you have multiple ESPectre devices (adds MAC suffix to name)
  # name_add_mac_suffix: true
  # Uncomment for ESP32-C3 Super Mini clones with flash issues (use DIO instead of QIO)
  # platformio_options:
  #   board_build.flash_mode: dio
  project:
    name: francescopace.espectre
    version: ${git_ref}

esp32:
  variant: ESP32C3
  framework:
    type: esp-idf

# Load ESPectre component from GitHub
external_components:
  - source:
      type: git
      url: https://github.com/francescopace/espectre
      ref: ${git_ref}
    components: [ espectre ]
    refresh: always

# ESPectre - WiFi CSI Motion Detection
espectre:
  id: espectre_csi
  detection_algorithm: ${detection_algorithm}
  traffic_generator_rate: 100 # Note: For Super Mini boards, keep traffic_generator_rate lower (e.g. 94)

# Dashboard import for easy adoption
dashboard_import:
  package_import_url: github://francescopace/espectre/examples/espectre-c3.yaml@${git_ref}
  import_full_config: true

# WiFi with fallback AP for provisioning
wifi:
  ap:
    ssid: "ESPectre Fallback"

captive_portal:

# Improv provisioning via BLE
esp32_improv:
  authorizer: none

# Improv provisioning via USB
improv_serial:

# Logging
# Note: ESPHome defaults to native USB Serial/JTAG on C3. Boards with external USB-UART
# bridges (like CH343, CP2102) need hardware_uart: UART0 to see logs.
logger:
  # hardware_uart: UART0

# Home Assistant API
api:

# OTA updates
ota:
  - platform: esphome