可维护漏水设备：本地报警、自检与 HA 通知

esphome:
  name: hixinwu-h10
  friendly_name: Hixinwu H10
  min_version: 2026.9.1
  includes:
    - h10_alarm.h

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

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

captive_portal:

switch:
  - platform: gpio
    id: indicator
    pin: GPIO4
    internal: true
    restore_mode: ALWAYS_OFF

output:
  - platform: ledc
    id: piezo_signal
    pin: GPIO10
    frequency: 4000Hz
    zero_means_zero: true

sensor:
  - platform: adc
    id: loop_voltage
    name: "Loop Voltage"
    pin: GPIO7
    attenuation: 12db
    samples: 16
    sampling_mode: avg
    update_interval: 1s
    on_value:
      then:
        - lambda: |-
            h10::device().update(x,h10::now_ms());
            ESP_LOGI("H10","v=%.3f circuit=%s; qualify actual complete circuit",x,h10::device().circuit_label());

binary_sensor:
  - platform: gpio
    id: self_test_button
    name: "Self Test Physical"
    pin:
      number: GPIO5
      inverted: true
      mode: INPUT
    filters:
      - delayed_on_off: 30ms
    on_press:
      then:
        - lambda: |-
            if(!h10::device().start_test(h10::now_ms()))ESP_LOGW("H10","Self-test refused: require confirmed dry and no latched alarm");
  - platform: gpio
    id: acknowledge_button
    name: "Acknowledge Physical"
    pin:
      number: GPIO6
      inverted: true
      mode: INPUT
    filters:
      - delayed_on_off: 30ms
    on_press:
      then:
        - lambda: |-
            if(!h10::device().acknowledge(h10::now_ms()))ESP_LOGW("H10","Ack refused: require confirmed dry and test finished");
  - platform: template
    id: input_valid
    name: "Input Valid"
    entity_category: diagnostic
  - platform: template
    id: wet_now
    name: "Wet Now Raw"
    device_class: moisture
  - platform: template
    id: alarm_latched
    name: "Alarm Latched Raw"
  - platform: template
    id: self_test_active
    name: "Self Test Active"
  - platform: template
    id: tone_command
    name: "Tone Command"
    entity_category: diagnostic

button:
  - platform: template
    name: "Start Self Test"
    on_press:
      then:
        - lambda: |-
            if(!h10::device().start_test(h10::now_ms()))ESP_LOGW("H10","Self-test refused: require confirmed dry and no latched alarm");
  - platform: template
    name: "Acknowledge Dry Alarm"
    on_press:
      then:
        - lambda: |-
            if(!h10::device().acknowledge(h10::now_ms()))ESP_LOGW("H10","Ack refused: still wet/fault/checking or test active");

text_sensor:
  - platform: template
    id: circuit_state
    name: "Circuit State"
  - platform: template
    id: device_phase
    name: "Device Phase"

interval:
  - interval: 20ms
    then:
      - lambda: |-
          auto &d=h10::device();const auto now=h10::now_ms();d.tick(now);
          if(d.led(now))id(indicator).turn_on();else id(indicator).turn_off();
          id(piezo_signal).set_level(d.tone(now)?0.5f:0.0f);
  - interval: 250ms
    then:
      - lambda: |-
          auto &d=h10::device();const auto now=h10::now_ms();
          id(input_valid).publish_state(d.valid());
          id(wet_now).publish_state(d.circuit==h10::Circuit::WET);
          id(alarm_latched).publish_state(d.latched);
          id(self_test_active).publish_state(d.testing(now));
          id(tone_command).publish_state(d.tone(now));
          id(circuit_state).publish_state(d.circuit_label());
          id(device_phase).publish_state(d.phase(now));

# HA Core2026.10.2 source-checked only; replace all actual source entity IDs.
# Main package creates one fixed-ID HA notification card; no phone push enabled.
input_boolean:
  h10_phone_sent:
    name: "H10 Phone Sent For Current Incident"
    # No initial value: restore across HA restarts instead of rearming each time.
template:
  - binary_sensor:
      - name: "H10 Alarm Active"
        unique_id: hixinwu_h10_alarm_active_v1
        device_class: moisture
        availability: "{{ is_state('binary_sensor.hixinwu_h10_input_valid','on') }}"
        state: "{{ is_state('binary_sensor.hixinwu_h10_alarm_latched_raw','on') }}"
automation:
  - id: hixinwu_h10_card_v1
    alias: "H10 create or update the same alarm card"
    triggers:
      - trigger: state
        entity_id: binary_sensor.h10_alarm_active
        to: "on"
      - trigger: homeassistant
        event: start
    conditions:
      - condition: template
        value_template: "{{ is_state('binary_sensor.h10_alarm_active','on') }}"
    actions:
      - action: persistent_notification.create
        data:
          notification_id: hixinwu_h10_water
          title: "H10 漏水报警待确认"
          message: "现场可能已湿或曾湿后锁存。先检查真实探头/电压/设备状态；确认干燥后按实体 ACK；重启也会清除设备RAM锁存，不能作为历史消警证据。网络恢复只更新这张卡，不补发每条旧状态。"
    mode: single
  - id: hixinwu_h10_rearm_v1
    alias: "H10 rearm on confirmed valid dry with latch cleared"
    triggers:
      - trigger: state
        entity_id: binary_sensor.h10_alarm_active
        to: "off"
    conditions:
      - condition: template
        value_template: >-
          {{ is_state('binary_sensor.hixinwu_h10_input_valid','on')
             and is_state('sensor.hixinwu_h10_circuit_state','DRY')
             and is_state('binary_sensor.hixinwu_h10_alarm_latched_raw','off')
             and not is_state('binary_sensor.hixinwu_h10_self_test_active','on') }}
    actions:
      - action: input_boolean.turn_off
        target:
          entity_id: input_boolean.h10_phone_sent
      - action: persistent_notification.dismiss
        data:
          notification_id: hixinwu_h10_water
    mode: single
  - id: hixinwu_h10_fault_card_v1
    alias: "H10 input fault has a separate card"
    triggers:
      - trigger: state
        entity_id: sensor.hixinwu_h10_circuit_state
        to: "FAULT"
        for: "00:00:05"
    actions:
      - action: persistent_notification.create
        data:
          notification_id: hixinwu_h10_fault
          title: "H10 探头回路不可用"
          message: "检查整只插头/SIG支路、偏置电阻位置、实际GPIO7电压；此状态不等于干燥。修复后核对三次有效输入，并手动关闭故障卡。"
    mode: single

# OPTIONAL, disabled until the real Companion App service is replaced and tested.
# Merge this automation list into HA; it relies on the main package helper/rearm.
automation:
  - id: hixinwu_h10_optional_phone_v1
    alias: "H10 optional phone once per acknowledged incident"
    initial_state: false
    triggers:
      - trigger: state
        entity_id: binary_sensor.h10_alarm_active
        to: "on"
    conditions:
      - condition: template
        value_template: >-
          {{ is_state('binary_sensor.h10_alarm_active','on')
             and is_state('input_boolean.h10_phone_sent','off') }}
    actions:
      - action: notify.mobile_app_replace_with_real_device
        data:
          title: "H10 漏水提醒"
          message: "检查现场与设备锁存；普通重连按helper去重；HA崩溃或通知响应失败仍可能重复，发送也不证明手机收到。"
      - action: input_boolean.turn_on
        target:
          entity_id: input_boolean.h10_phone_sent
    mode: single