Initial commit

2026-08-10 21:37:46 -07:00
commit 56e75d9cde
25 changed files with 8285 additions and 0 deletions
@@ -0,0 +1,86 @@
+# Example power profile: solar failover
+#
+# Links one Anker SOLIX device (read-only data source) to one Shelly switch
+# channel (the actuator). Rules decide when the Shelly turns on or off.
+# The Anker device is never commanded.
+#
+# Replace the source and target filenames with your own. List them with:
+#     solixauto devices
+#
+# Validate before running:
+#     solixauto run solar-failover --test
+
+name: solar-failover
+description: >
+  Charge from the grid when the battery is low or solar cannot keep up.
+  Stay off the grid whenever the sun is carrying the load.
+
+enabled: true
+
+poll_interval: 10s
+
+source:
+  profile: REPLACE-WITH-YOUR-ANKER-PROFILE.yaml
+  stale_after: 300s
+  on_stale: safe_state
+
+target:
+  profile: REPLACE-WITH-YOUR-SHELLY-PROFILE.yaml
+  channel: 0
+
+# The plug supplies power TO the Anker device, so every failure path should
+# end with charging enabled rather than disabled.
+safe_state: on
+
+# Checked before every rule below, bypasses the rate limits, and latches once
+# tripped so nothing can turn charging off again until the battery recovers.
+safety:
+  battery_floor:
+    at_or_below: 20
+    release_at: 40
+    then: target.on
+    for: 30s
+    notify: true
+    notify_release: true
+
+notifications:
+  enabled: true
+  channels: [ntfy]
+  title: "{profile}"
+  template: >-
+    {source_name} battery {battery_soc}%, solar {pv_total}W.
+    {target_name} turned {action}.
+  throttle: 5m
+  on:
+    - action
+    - stale
+
+rules:
+  - name: top up from grid when low
+    when: battery_soc <= 35
+    for: 2m
+    then: target.on
+
+  - name: stop charging when full enough
+    when: battery_soc >= 85
+    for: 2m
+    then: target.off
+
+  # pv_surplus is solar minus everything drawing from the unit. Positive means
+  # the sun is covering the load and the excess is charging the battery.
+  #
+  # The long dwell matters: a variable load such as a desktop PC will cross
+  # zero constantly, and a short dwell would cycle the relay all afternoon.
+  - name: solar is carrying the load, stay off the grid
+    when: pv_surplus > 200 and battery_soc > 50
+    for: 15m
+    then: target.off
+
+  - name: solar cannot keep up, fall back to the grid
+    when: pv_surplus < -200 and battery_soc <= 50
+    for: 15m
+    then: target.on
+
+limits:
+  min_seconds_between_actions: 60
+  max_actions_per_hour: 20