Overview
This is a custom integration to monitor Eaton UPS Companion devices in Home Assistant. Track battery health, power metrics, and runtime estimates for your Eaton UPS from your smart home dashboard.
Features
The integration provides comprehensive sensor data for monitoring your Eaton UPS:
Power Status
Running status — detects when on utility power vs. battery backup
Output load level as a percentage of rated capacity
Real-time output power in watts and nominal power rating
Output voltage monitoring
Battery Monitoring
Battery charge level percentage
Battery status — charging, discharging, or floating
Estimated battery runtime in seconds
Total energy consumed during discharge events (kWh)
Diagnostics & Alerts
Battery fault detection and reporting
Overload, shutdown imminent, and internal failure status indicators
Device firmware version tracking
Configuration
Add the integration via the Home Assistant UI. Enter your Eaton UPS Companion device details:
Host — IP address or hostname of your Eaton UPS Companion server
Port — Communication port (default: 4679)
Scan interval — Polling frequency in seconds (default: 30s)
Installation
The recommended way to install is via HACS. Search for "Eaton UPS Companion" in the Home Assistant Community Store, download, and restart.
Manual installation: Copy the custom_components/eaton_upsc folder into your Home Assistant config directory and restart.
GitHub
View the source code, report issues, or contribute on GitHub — sockless-coding/ha-eaton-ups-companion.