A lightweight, local integration that surfaces status from Vertiv UPS devices via the Vertiv PowerAssist service and lets you control how and when your system should shut down during a power event.

• Local-only: Talks directly to your PowerAssist instance on your network
• Clean entities: Battery, runtime, load, input/output voltages, and key health flags
• Practical controls: Configure shutdown behavior to match your environment (details below)

• Vertiv PowerAssist running on a reachable host
  • Tested with PowerAssist 2.0.0 on an Arch‑based Linux host

Behavior may differ across UPS models or multi‑UPS environments.

1. Copy this folder to config/custom_components/vertiv and restart Home Assistant.
2. In Home Assistant, go to Settings → Devices & Services → Add Integration → search for “Vertiv PowerAssist”.
3. Provide host and port for the machine running PowerAssist.

During setup you’ll be asked for:

• Hostname or IP of the PowerAssist machine
• Port (default: 8210, unless you changed it)
• Device name

After setup, you can fine‑tune shutdown behavior from the Vertiv device page in Home Assistant.

• UPS status at a glance
  • AC power present, charging/discharging state, overload, battery health
  • Battery capacity (%), runtime to empty (seconds), output load (%), input/output voltages
• Configurable shutdown behavior
  • Shutdown Mode (select):
    • By Battery Minutes Remaining
    • By Battery Percent Remaining
    • After X Minutes
    • Immediately
  • Matching parameter values (numbers/switches):
    • Minutes threshold (for “By Minutes”)
    • Capacity threshold in % (for “By Percent”)
    • Delay value in minutes (for “After X Minutes”)
    • Shut down only if all UPS lose power (toggle)
    • Maintenance mode (toggle)
    • Optional scripted shutdown (toggle + path)

• Sensors
  • Runtime remaining (seconds)
  • Battery capacity (%)
  • Battery voltage (V)
  • Output load (%)
  • Input voltage (V)
  • Output voltage (V)
• Binary sensors
  • AC power present, charging, on battery, battery needs replacement, overload, UPS running, battery low limit reached
• Select
  • Shutdown trigger type (mode)
• Numbers
  • Battery time threshold (minutes), battery capacity threshold (%), shutdown after X minutes
• Switches
  • Maintenance mode, shutdown if all UPS lose power, enable scripted shutdown

• Integration assumes PowerAssist is reachable over HTTPS with a self‑signed certificate (default configuration in PowerAssist); the client is configured accordingly.
• Reported fields and flags can vary by UPS model/firmware.
• Multi‑UPS setups may expose combined settings (e.g., "shutdown if all lose power").

• Can’t connect during setup
  • Verify host/port and that PowerAssist is running and reachable from Home Assistant.

• Vertiv PowerAssist provides the local API this integration communicates with.
• Community inspiration from Home Assistant’s update coordinator and modern entity patterns.