various package updates

2026-06-19 11:38:07 +12:00
parent d4f123600c
commit 79597fb021
17 changed files with 2540 additions and 397 deletions
@@ -0,0 +1,170 @@
+#:########################################################################################:#
+# Package: BYD Charging Schedule At Home
+# File:    byd_charging_schedule_athome.yaml
+# Version: v1.0.1
+# Date:    2026-06-19
+#
+# Purpose:
+#   Enables the BYD Atto 3 charging schedule when the car arrives home.
+#   Disables the schedule only after the car has been confirmed away for a
+#   configurable delay, to avoid rapid toggling from uncertain presence detection.
+#
+# Behaviour:
+#   - Confirmed arrival home:
+#       Turns ON switch.atto_3_schedule_enabled,
+#       but only if the car had previously been confirmed away.
+#
+#   - Confirmed away:
+#       After away_confirm_minutes, turns OFF switch.atto_3_schedule_enabled.
+#
+#   - Manual control:
+#       If the car is already home and the user or another HA automation turns
+#       the schedule OFF manually, this package will not turn it back ON unless
+#       the car is later confirmed away and then arrives home again.
+#
+# Notes:
+#   - Home Assistant usually stores the device_tracker home state as "home",
+#     even if the UI displays "At Home".
+#   - Change away_confirm_minutes below if you want a longer/shorter debounce.
+#:########################################################################################:#
+
+input_boolean:
+  byd_atto3_charging_schedule_confirmed_away:
+    name: "BYD Atto 3 Charging Schedule - Confirmed Away"
+    icon: mdi:car-off
+
+automation:
+  #:######################################################################################:#
+  # ARRIVAL - Turn schedule ON only after a confirmed away period
+  #:######################################################################################:#
+  - id: byd_atto3_charging_schedule_arrival_enable
+    alias: "BYD Atto 3 Charging Schedule - Arrival Enable"
+    description: >
+      Turns the BYD charging schedule ON when the car arrives home, but only if
+      it was previously confirmed away. This prevents brief away/home glitches
+      from undoing a manual OFF while the car is actually still at home.
+    mode: single
+    variables: &byd_charging_schedule_vars
+      tracker_entity: device_tracker.byd_atto3_ibeacon_bur4c2a_bermuda_tracker
+      schedule_switch_entity: switch.atto_3_schedule_enabled
+
+      # HA normally stores "At Home" as "home".
+      home_state: "home"
+
+      # Adjustable YAML-only delay before the car is treated as truly away.
+      away_confirm_minutes: 15
+
+      # These states will not be treated as confirmed away.
+      ignored_tracker_states:
+        - "unknown"
+        - "unavailable"
+
+    triggers:
+      - trigger: state
+        entity_id: device_tracker.byd_atto3_ibeacon_bur4c2a_bermuda_tracker
+
+    conditions:
+      - condition: template
+        value_template: >-
+          {{ trigger.to_state is not none
+             and trigger.from_state is not none
+             and trigger.to_state.state == home_state
+             and trigger.from_state.state != home_state }}
+
+    actions:
+      - choose:
+          - conditions:
+              - condition: state
+                entity_id: input_boolean.byd_atto3_charging_schedule_confirmed_away
+                state: "on"
+            sequence:
+              - action: switch.turn_on
+                target:
+                  entity_id: "{{ schedule_switch_entity }}"
+
+      - action: input_boolean.turn_off
+        target:
+          entity_id: input_boolean.byd_atto3_charging_schedule_confirmed_away
+
+  #:######################################################################################:#
+  # DEPARTURE - Turn schedule OFF only after confirmed away timeout
+  #:######################################################################################:#
+  - id: byd_atto3_charging_schedule_departure_disable_after_timeout
+    alias: "BYD Atto 3 Charging Schedule - Departure Disable After Timeout"
+    description: >
+      When the car leaves home, waits for the configured away timeout. If the car
+      is still away after that delay, turns the BYD charging schedule OFF and
+      marks the car as confirmed away.
+    mode: restart
+    variables: *byd_charging_schedule_vars
+
+    triggers:
+      - trigger: state
+        entity_id: device_tracker.byd_atto3_ibeacon_bur4c2a_bermuda_tracker
+
+    conditions:
+      - condition: template
+        value_template: >-
+          {% set new_state = trigger.to_state.state if trigger.to_state is not none else '' %}
+          {{ new_state != home_state
+             and new_state not in ignored_tracker_states }}
+
+    actions:
+      - delay:
+          minutes: "{{ away_confirm_minutes | int(15) }}"
+
+      - condition: template
+        value_template: >-
+          {% set current_state = states(tracker_entity) %}
+          {{ current_state != home_state
+             and current_state not in ignored_tracker_states }}
+
+      - action: switch.turn_off
+        target:
+          entity_id: "{{ schedule_switch_entity }}"
+
+      - action: input_boolean.turn_on
+        target:
+          entity_id: input_boolean.byd_atto3_charging_schedule_confirmed_away
+
+  #:######################################################################################:#
+  # STARTUP SAFETY - If HA restarts while the car is away, re-arm arrival logic
+  #:######################################################################################:#
+  - id: byd_atto3_charging_schedule_startup_away_check
+    alias: "BYD Atto 3 Charging Schedule - Startup Away Check"
+    description: >
+      On Home Assistant startup, if the car is already away and remains away
+      beyond the configured timeout, turn the schedule OFF and mark the car as
+      confirmed away so that the next confirmed arrival can enable the schedule.
+    mode: single
+    variables: *byd_charging_schedule_vars
+
+    triggers:
+      - trigger: homeassistant
+        event: start
+
+    actions:
+      - delay: "00:01:00"
+
+      - condition: template
+        value_template: >-
+          {% set current_state = states(tracker_entity) %}
+          {{ current_state != home_state
+             and current_state not in ignored_tracker_states }}
+
+      - delay:
+          minutes: "{{ away_confirm_minutes | int(15) }}"
+
+      - condition: template
+        value_template: >-
+          {% set current_state = states(tracker_entity) %}
+          {{ current_state != home_state
+             and current_state not in ignored_tracker_states }}
+
+      - action: switch.turn_off
+        target:
+          entity_id: "{{ schedule_switch_entity }}"
+
+      - action: input_boolean.turn_on
+        target:
+          entity_id: input_boolean.byd_atto3_charging_schedule_confirmed_away