mirror of
https://github.com/vakius/hassio-addon-lifepo4wered.git
synced 2026-09-27 05:12:23 +03:00
vakuandClaude Fable 5
ac8a4b88f0
Off (default): SIGKILL the daemon on addon stop so the UPS keeps power on. On: SIGTERM it (native behavior) so it saves the RTC and tells the UPS to cut power. Add translations so the option is documented in the HA config UI, and document the difference in the README. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
76 lines
2.9 KiB
Markdown
76 lines
2.9 KiB
Markdown
# hassio-addon-lifepo4wered
|
|
|
|
Home Assistant OS addon for the [LiFePO4wered/Pi+](https://lifepo4wered.com/lifepo4wered-pi+.html)
|
|
UPS: runs `lifepo4wered-daemon` and publishes UPS stats to MQTT with Home
|
|
Assistant autodiscovery.
|
|
|
|
## MQTT monitor
|
|
|
|
`lifepo4wered_monitor.py` polls `lifepo4wered-cli get` (default every 30 s)
|
|
and publishes all registers as one JSON payload to `lifepo4wered/state`.
|
|
Entities appear automatically under one device, "LiFePO4wered/Pi+":
|
|
|
|
- **Sensors**: input/battery/output voltage (V), output current (A)
|
|
- **Binary sensor** "External power": ON when `VIN >= VIN_THRESHOLD`
|
|
(i.e. OFF means running on battery)
|
|
- **Diagnostics**: thresholds, timers, watchdog and state registers
|
|
- **Availability**: `lifepo4wered/availability` with MQTT Last Will, so
|
|
entities go *unavailable* if the addon stops
|
|
|
|
MQTT connection details are taken automatically from the Supervisor when the
|
|
Mosquitto addon is installed. Addon options: `poll_interval` (seconds) and
|
|
optional `mqtt_host`/`mqtt_port`/`mqtt_user`/`mqtt_password` overrides.
|
|
|
|
### Testing off the Pi
|
|
|
|
```
|
|
python3 -m unittest discover -s tests # unit tests, no deps needed
|
|
LIFEPO4WERED_FAKE=1 MQTT_HOST=... python3 hassio-addon-lifepo4wered/lifepo4wered_monitor.py
|
|
```
|
|
|
|
`LIFEPO4WERED_FAKE=1` replaces the CLI with embedded sample data.
|
|
|
|
## Stopping the addon vs. shutting down
|
|
|
|
The `signal_ups_on_stop` option controls what happens to the daemon when
|
|
the addon is stopped:
|
|
|
|
- **Off (default)** — the daemon is killed (SIGKILL) without notifying the
|
|
UPS, so power stays on. Addon stops, restarts and updates are safe. The
|
|
system clock is not saved to the UPS RTC on stop (it still is on
|
|
UPS-commanded shutdowns), and while the addon is stopped, UPS-side
|
|
features (button shutdown, low-battery clean shutdown) are inactive.
|
|
- **On** — the daemon is terminated gracefully (SIGTERM), the native
|
|
LiFePO4wered behavior: it saves the clock to the UPS RTC and reports
|
|
"system shutting down" (`PI_RUNNING = 0`), so the UPS **cuts power to
|
|
the Pi a few seconds after the addon stops**. Only use this if you stop
|
|
the addon exclusively as part of powering the system down.
|
|
|
|
When the UPS itself commands a shutdown (button press, low battery,
|
|
`AUTO_SHDN_TIME` after power loss), the addon performs a clean host
|
|
shutdown through the Supervisor, and the UPS cuts power once shutdown
|
|
completes.
|
|
|
|
## Setup notes
|
|
|
|
|
|
https://www.linkedin.com/pulse/creating-your-first-home-assistant-add-on-issac-goldstand
|
|
|
|
https://lifepo4wered.com/files/LiFePO4wered-Pi+-Product-Brief.pdf
|
|
|
|
https://github.com/xorbit/LiFePO4wered-Pi/blob/master/Dockerfile
|
|
|
|
|
|
https://raspberrypi.stackexchange.com/questions/90315/how-can-i-get-dev-i2c-devices-to-appear-on-alpine-linux
|
|
|
|
Uncomment line
|
|
```
|
|
dtparam=i2c_arm=on
|
|
```
|
|
in `/mnt/boot/config.txt` or `/boot/config.txt` or `/boot/usercfg.txt`
|
|
|
|
Load module at host startup
|
|
```
|
|
echo 'i2c-dev' > /etc/modules-load.d/i2c.conf
|
|
```
|