ESPHome 深睡节点：留出可靠的 OTA 维护窗口

esphome:
  name: hixinwu-h09
  friendly_name: Hixinwu H09
  min_version: 2026.9.1
  includes:
    - h09_runtime.h
  on_boot:
    priority: -100
    then:
      - text_sensor.template.publish:
          id: wake_report
          state: !lambda return h09::wake_info();
      - logger.log: "H09 boot: normal 60s window; hold GPIO5 LOW for maintenance"

esp32:
  board: esp32-s3-devkitc-1
  variant: ESP32S3
  flash_size: 8MB
  flash_mode: qio
  flash_frequency: 80MHz
  toolchain: esp-idf
  framework:
    type: esp-idf
    version: 5.5.5

psram:
  mode: octal
  speed: 80MHz

logger:
  baud_rate: 115200
  hardware_uart: UART0
  level: DEBUG

api:
  encryption:
    key: !secret api_key
  reboot_timeout: 0s

ota:
  - platform: esphome
    encryption:
      key: !secret api_key
    on_begin:
      then:
        - lambda: h09::runtime().ota_begin();
        - deep_sleep.prevent: sleep_control
    on_error:
      then:
        - lambda: h09::runtime().ota_failed();
        - deep_sleep.prevent: sleep_control
        - logger.log: "H09 OTA_ERROR_HOLD; repair/retry, then explicitly release maintenance"
    on_abort:
      then:
        - lambda: h09::runtime().ota_failed();
        - deep_sleep.prevent: sleep_control
    on_end:
      then:
        - logger.log: "H09 OTA complete callback; reboot clears RAM holds, physical switch still applies"

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password
  reboot_timeout: 0s
  ap:
    ssid: "hixinwu-h09 Maintenance"
    password: !secret fallback_password
    ap_timeout: 90s

captive_portal:

i2c:
  sda: GPIO8
  scl: GPIO9
  frequency: 100kHz
  scan: true

deep_sleep:
  id: sleep_control
  run_duration: 60s
  sleep_duration: 5min
  wakeup_pin:
    number: GPIO5
    inverted: true
    allow_other_uses: true
    mode: INPUT
  wakeup_pin_mode: KEEP_AWAKE

binary_sensor:
  - platform: gpio
    id: physical_maintenance
    name: "Physical Maintenance"
    pin:
      number: GPIO5
      inverted: true
      allow_other_uses: true
      mode: INPUT
    filters:
      - delayed_on_off: 25ms
  - platform: template
    id: sample_valid
    name: "Sample Valid"
    entity_category: diagnostic

switch:
  - platform: template
    id: maintenance_mode
    name: "API Maintenance Hold"
    lambda: return h09::runtime().api_hold || h09::runtime().ota_error;
    turn_on_action:
      - lambda: h09::runtime().hold_api();
      - deep_sleep.prevent: sleep_control
    turn_off_action:
      - lambda: |-
          if(!h09::runtime().request_exit())ESP_LOGW("H09","Exit refused during active OTA");

button:
  - platform: template
    name: "Exit Maintenance"
    on_press:
      then:
        - lambda: |-
            if(!h09::runtime().request_exit())ESP_LOGW("H09","Exit refused during active OTA");

sensor:
  - platform: sht4x
    address: 0x44
    precision: High
    heater_max_duty: 0
    update_interval: 5s
    temperature:
      id: room_temperature
      name: "Last Temperature"
      accuracy_decimals: 2
      filters:
        - timeout:
            timeout: 15s
            value: !lambda return NAN;
      on_value:
        then:
          - lambda: h09::runtime().set_temperature(x,h09::now_ms());
    humidity:
      id: room_humidity
      name: "Last Humidity"
      accuracy_decimals: 2
      filters:
        - timeout:
            timeout: 15s
            value: !lambda return NAN;
      on_value:
        then:
          - lambda: h09::runtime().set_humidity(x,h09::now_ms());

text_sensor:
  - platform: template
    id: wake_report
    name: "Wake Reason"
    update_interval: never
  - platform: template
    id: maintenance_phase
    name: "Maintenance Phase"

interval:
  - interval: 100ms
    then:
      - lambda: |-
          auto &r=h09::runtime();
          const bool physical=id(physical_maintenance).has_state()&&id(physical_maintenance).state;
          if(r.blocked(physical))id(sleep_control).prevent_deep_sleep();else id(sleep_control).allow_deep_sleep();
          id(sample_valid).publish_state(r.sample_valid(h09::now_ms()));
          id(maintenance_phase).publish_state(r.mode(physical));
  - interval: 5s
    then:
      - if:
          condition:
            api.connected:
              state_subscription_only: true
          then:
            - homeassistant.event:
                event: esphome.hixinwu_h09_report
                data:
                  node: h09
                  valid: !lambda |-
                    return h09::runtime().sample_valid(h09::now_ms()) ? "true" : "false";
                  wake: !lambda return h09::wake_info();
                  mode: !lambda return std::string(h09::runtime().mode(id(physical_maintenance).state));
            - logger.log: "H09 report dispatched; confirm actual receipt in HA event listener"
          else:
            - logger.log: "H09 no API state subscriber; no HA receipt claim, no offline report buffer"

# HA Core2026.10.2 source-checked; actual HA config/runtime pending.
# Replace the device_id filter using the real event listener output.
# No initial value: helpers restore previous actual receipt data after HA restarts.
input_boolean:
  h09_ever_reported:
    name: "H09 Ever Reported"
  h09_ever_good:
    name: "H09 Ever Good Sample"
input_datetime:
  h09_last_report:
    name: "H09 Last Actual Report"
    has_date: true
    has_time: true
  h09_last_good:
    name: "H09 Last Good Report"
    has_date: true
    has_time: true
automation:
  - id: hixinwu_h09_report_v1
    alias: "H09 remember real received events"
    triggers:
      - trigger: event
        event_type: esphome.hixinwu_h09_report
        event_data:
          node: h09
    conditions:
      - condition: template
        value_template: "{{ trigger.event.data.device_id == 'replace_with_real_device_id' }}"
    actions:
      - action: input_datetime.set_datetime
        target:
          entity_id: input_datetime.h09_last_report
        data:
          timestamp: "{{ now().timestamp() }}"
      - action: input_boolean.turn_on
        target:
          entity_id: input_boolean.h09_ever_reported
      - if:
          - condition: template
            value_template: "{{ trigger.event.data.valid == 'true' }}"
        then:
          - action: input_datetime.set_datetime
            target:
              entity_id: input_datetime.h09_last_good
            data:
              timestamp: "{{ now().timestamp() }}"
          - action: input_boolean.turn_on
            target:
              entity_id: input_boolean.h09_ever_good
    mode: queued
    max: 10
template:
  - sensor:
      - name: "H09 Report Age"
        unique_id: hixinwu_h09_report_age_v1
        unit_of_measurement: s
        availability: >-
          {% set ts = state_attr('input_datetime.h09_last_report','timestamp') %}
          {{ is_state('input_boolean.h09_ever_reported','on') and ts is number and now().timestamp() >= ts }}
        state: >-
          {% set ts = state_attr('input_datetime.h09_last_report','timestamp') %}
          {{ ((now().timestamp() - ts) | int) if ts is number else none }}
      - name: "H09 Good Report Age"
        unique_id: hixinwu_h09_good_age_v1
        unit_of_measurement: s
        availability: >-
          {% set ts = state_attr('input_datetime.h09_last_good','timestamp') %}
          {{ is_state('input_boolean.h09_ever_good','on') and ts is number and now().timestamp() >= ts }}
        state: >-
          {% set ts = state_attr('input_datetime.h09_last_good','timestamp') %}
          {{ ((now().timestamp() - ts) | int) if ts is number else none }}
    binary_sensor:
      - name: "H09 Report Overdue"
        unique_id: hixinwu_h09_overdue_v1
        device_class: problem
        availability: "{{ is_number(states('sensor.h09_report_age')) }}"
        state: "{{ states('sensor.h09_report_age') | float(0) > 900 }}"