ha-pypowerwall

Home Assistant custom integration for Tesla Powerwall via pypowerwall proxy.

How It Works

Home Assistant
    │
    │  aiohttp HTTP GET/POST (no Python pypowerwall library needed)
    ▼
pypowerwall proxy (default :8675)
    │
    ▼
Tesla Powerwall gateway

No Python pypowerwall library required in HA — pure aiohttp.

This integration will set up the following platforms —

Platform	Description
sensor	Power, battery, grid, inverter, PVAC, PV string, island controller, and grid meter data
binary_sensor	Grid status, alerts, pod health flags, PV string connected
number	Backup reserve percentage control (requires control_secret)
select	Operation mode and grid export policy (requires control_secret)
switch	Grid charging toggle (requires control_secret)

Features

• Multi-Powerwall support — Primary, Follower, and Expansion pod detection
• Per-device sensors — TEPOD (battery), TEPINV (inverter), PVAC (solar combiner), PVS strings A–F, TEMSA (grid meter), TESYNC (island controller)
• Grid meter per-leg data — L1/L2 power, voltage, current, reactive power, and lifetime energy counters
• Pod health flags — from /pod endpoint (permanently/persistently faulted, active heating, charge/discharge complete, wobble detected, and more)
• Alert monitoring — per-device and aggregate alert counts
• Backup reserve, operation mode, grid charging & grid export control — requires PW_CONTROL_SECRET configured on the proxy
• Configurable polling interval — 5–300 seconds (default 30 s)

Installation

HACS (Recommended)

Or manually add the custom repository:

1. Open HACS in Home Assistant.
2. Go to Integrations → three-dot menu → Custom repositories.
3. Add https://github.com/nalditopr/ha-pypowerwall with category Integration.
4. Search for PyPowerwall and install.
5. Restart Home Assistant.

Manual

1. Copy custom_components/pypowerwall/ into your HA custom_components/ directory.
2. Restart Home Assistant.

Configuration

1. Go to Settings → Devices & Services → Add Integration and search for PyPowerwall.
2. Enter your pypowerwall proxy host and port (default: 8675).
3. Optionally set the polling interval (default: 30 seconds).
4. Optionally enter the control secret (PW_CONTROL_SECRET) to enable backup reserve and operation mode controls.

Requirements

• Running pypowerwall proxy (e.g. pypowerwall proxy -port 8675)
• Home Assistant 2024.1+

Credits

This integration communicates with the pypowerwall proxy by @jasonacox.

---