-
-
Notifications
You must be signed in to change notification settings - Fork 16
Battery System Setup
PowerSync supports two methods for accessing your Tesla Powerwall. Choose one — you don't need both.
The easiest setup option. Teslemetry is a third-party proxy service for Tesla API.
| Pros | |
|---|---|
| Simple API key authentication | No OAuth complexity |
| Works with localhost | No public domain needed |
| 2-minute setup | Just copy/paste API key |
| Reliable service | Well-maintained proxy |
Setup:
- Sign up at https://teslemetry.com
- Connect your Tesla account
- Copy your API key
- Paste into PowerSync settings
Direct OAuth access to Tesla's Fleet API. Completely free but requires more setup.
Setup:
- Install the official Tesla Fleet integration in Home Assistant
- Settings > Devices & Services > Add Integration > "Tesla Fleet"
- Follow the OAuth login flow
- PowerSync automatically detects your Tesla Fleet credentials
- Leave the Teslemetry field empty during PowerSync setup
Supports H1, H3, H3-Pro, H3 Smart, and KH model families via Modbus TCP or RS485 serial. No cloud API required for battery control — all control is done locally via Modbus.
| Model Family | Type | Register Space | Notes |
|---|---|---|---|
| H1 | Single Phase | 31xxx/41xxx | LAN has limited register access |
| H3 | Three Phase | 31xxx/41xxx | Full register access |
| H3-Pro | Three Phase (Higher Power) | 37xxx/46xxx/49xxx | 32-bit power registers |
| H3 Smart | Three Phase (Native WiFi) | 37xxx/46xxx/49xxx | Built-in WiFi Modbus TCP |
| KH | Single Phase Hybrid | 31xxx/41xxx | Full register access including BMS |
Modbus TCP (Recommended for H3 Smart)
- Port: 502 (default)
- Slave ID: 247 (default)
- For H3 Smart: Connect directly to the inverter's IP address — no external adapter needed
RS485 Serial
- Baud rate: 9600 (default)
- Slave ID: 247 (default)
- Requires an RS485 adapter (USB or network gateway like Elfin EW11)
The H3 Smart has a built-in WiFi Modbus TCP server. No external RS485 adapter is needed.
- Find the inverter's IP address — it appears as "espressif" on your network (it uses an ESP WiFi module)
- Ensure firmware is up to date — the Modbus TCP server requires current firmware
- Use default settings — Port 502, Slave ID 247
- PowerSync will auto-detect the model as H3 Smart during setup
Troubleshooting: If the connection test fails:
- Check your router for a device named "espressif" to find the correct IP
- Update inverter firmware to the latest version
- Verify port 502 is not blocked by your network
Cloud credentials are only needed for tariff data from FoxESS Cloud. They are not required for battery control.
| Mode | Value | Description |
|---|---|---|
| Self Use | 0 | Default operation |
| Feed-in First | 1 | Export priority |
| Backup | 2 | Backup mode |
| Force Charge | 3 | Force charge from grid |
| Force Discharge | 4 | Force discharge/export |
Full support for Sigenergy hybrid inverters with integrated battery storage.
- Tariff Sync via Cloud API — Uploads pricing to Sigenergy Cloud using 30-minute TOU format
- Real-Time Energy Data via Modbus — Reads solar, battery, grid power and SOC from your inverter
- DC Solar Curtailment — Controls DC solar via Modbus TCP during negative prices (load-following mode)
| Connection | Purpose | Required |
|---|---|---|
| Cloud API | Tariff sync to Sigenergy | Yes |
| Modbus TCP | Real-time energy data + DC curtailment | Yes |
Important: Modbus TCP Server must be enabled on your Sigenergy inverter before PowerSync can connect. This setting is typically configured by your installer via the SigenStor app or installer portal.
Device ID Note: If you have an AC Charger installed, it uses Device ID 1 by default. The inverter must be set to a higher ID (e.g., 2).
What You Need:
| Credential | Description | Where to Find |
|---|---|---|
| Your Sigenergy account email | Your login email | |
| Password | Your Sigenergy account password | Your normal password |
| Device ID | 13-digit numeric identifier | Browser dev tools (see below) |
| Station ID | Your Sigenergy station identifier | SigenAI or browser dev tools |
Getting Device ID:
- Go to https://app-aus.sigencloud.com/ in your browser (don't log in yet)
- Open Developer Tools (F12) > Network tab > check "Preserve log"
- Log in normally
- Find the
oauth/tokenrequest > Payload tab > userDeviceId is your Device ID
Getting Station ID:
- Ask SigenAI in the app: "Tell me my StationID"
- Or find it in dev tools network requests
- Select Sigenergy as your battery system
- Enter Cloud credentials (email, password, device ID)
- Select your station from the list
- Enter your inverter's Modbus IP address
- Optionally enable DC solar curtailment
Full support for Sungrow SH-series hybrid inverters via direct Modbus TCP. No cloud API required.
- Direct Modbus Control — All control via local Modbus TCP
- Force Charge/Discharge — Manual or automatic battery control
- Rate Limiting — Set maximum charge and discharge rates (kW)
- Export Limit Control — Limit grid export power
- Backup Reserve — Configure minimum SOC for backup power
- Battery Health Monitoring — Read SOH directly from BMS
- AEMO Spike Auto-Discharge — Automatic VPP participation for Globird users
| Series | Type | Battery Control |
|---|---|---|
| SH-series | Hybrid Inverter | Full support |
| SG-series | String Inverter | AC curtailment only (no battery) |
| Setting | Default |
|---|---|
| Port | 502 |
| Slave ID | 1 |
| Register | Function |
|---|---|
| 13021 | Battery SOC (0.1%) |
| 13022 | Battery SOH (0.1%) |
| 13050 | EMS Mode (0=Self-consumption, 2=Forced) |
| 13051 | Charge Command (0xAA=Charge, 0xBB=Discharge, 0xCC=Stop) |
| 13059 | Minimum SOC / Backup Reserve (0.1%) |
| 13066 | Max Discharge Current (0.001A) |
| 13067 | Max Charge Current (0.001A) |
| 13074 | Export Power Limit (W) |
Globird's VPP program pays premium rates during AEMO price spikes ($3000/MWh or above). PowerSync can automatically participate:
- Enable AEMO Spike Auto-Discharge in the mobile app Controls screen
- Select your NEM region (NSW1, VIC1, QLD1, SA1, TAS1)
- When AEMO prices hit $3000/MWh, PowerSync automatically forces battery discharge
- When the spike ends, battery returns to normal operation
- Push notifications are sent for both spike start and end
Tip: If you also have a separate AC-coupled solar inverter, configure it in the AC Inverter Curtailment section. PowerSync will validate that your Sungrow battery and AC inverter don't use the same Modbus slave ID.