FranklinWH Integration
GridMind connects to FranklinWH home energy systems via the FranklinWH cloud API. Monitor your solar production, battery state of charge, grid import/export, and home consumption in real-time alongside all the GridMind features you’d expect — power flow diagrams, energy history, value tracking, and AI insights.
Supported Hardware
- aGate — FranklinWH’s whole-home gateway and transfer switch
- aPower — 13.6 kWh battery (supports multi-battery setups)
- Any solar inverter connected through the aGate
Prerequisites
Before connecting to GridMind, you need:
- A FranklinWH account with your system registered in the FranklinWH app
- Your FranklinWH app email and password
- Your Gateway ID (serial number) — see Step 1 below
FranklinWH uses credential-based authentication (email + password), not OAuth. Your credentials are encrypted and stored securely. GridMind uses them only to communicate with the FranklinWH cloud API on your behalf.
Setup: Step by Step
Step 1: Find Your Serial Number
- Open the FranklinWH app on your phone
- Go to More → Site Devices
- Find the serial number for your gateway — it typically starts with digits and contains letters intermixed (e.g.
10A2B3C4D5E6) - Copy or note it down
Step 2: Connect in GridMind
- In GridMind, go to Settings → Connect Energy System
- Select FranklinWH
- Enter your FranklinWH app email and password
- Enter your Gateway ID from Step 1
- Click Connect
GridMind will verify your credentials and begin collecting data immediately. Your dashboard will populate within 60 seconds.
What GridMind Can Do with FranklinWH
| Capability | Available | Notes |
|---|---|---|
| Real-time solar output | ✓ | kW, updated every 60s |
| Real-time battery SOC | ✓ | %, updated every 60s |
| Real-time battery power | ✓ | Charging/discharging kW |
| Real-time grid import/export | ✓ | kW, updated every 60s |
| Real-time home consumption | ✓ | kW, updated every 60s |
| Energy history | ✓ | Daily generation, consumption, grid totals |
| Power flow diagram | ✓ | Animated real-time flows |
| Value & savings tracking | ✓ | With tariff configuration |
| Solar forecast | ✓ | Weather-based predictions |
| AI energy insights | ✓ | Pro plan |
| Set backup reserve | — | Not available via FranklinWH API |
| Change operation mode | — | Not available via FranklinWH API |
| Storm mode | — | Not available via FranklinWH API |
| GridMind Optimize | — | Requires battery control |
FranklinWH integration is read-only — battery mode, reserve settings, storm mode, and Optimize are not available because the FranklinWH cloud API does not expose control commands. You can still use all monitoring, history, and analytics features.
Data Refresh
GridMind polls your FranklinWH system every 60 seconds when you’re actively viewing the dashboard, and every 5 minutes when idle. This keeps API usage efficient while providing near-real-time data when you need it.
System Configuration
GridMind automatically detects your FranklinWH system configuration:
- Battery count — number of aPower units (each 13.6 kWh)
- Total capacity — calculated from battery count
- Firmware version — reported from the aGate
- Site timezone — used for accurate daily energy summaries
Troubleshooting
Connection failed
Double-check that your email and password match your FranklinWH app login exactly. The Gateway ID must be the serial number shown in the app under More → Site Address. Credentials are case-sensitive.
Data not updating
FranklinWH data is fetched from their cloud service. If your aGate loses internet connectivity, data will stop updating until connectivity is restored. Check the FranklinWH app to verify your system is online.
Missing battery or solar data
Ensure your aPower battery and solar inverter are properly configured and showing data in the FranklinWH app. GridMind reads whatever data the FranklinWH cloud reports — if it’s missing in their app, it will be missing in GridMind too.
Authentication expired
FranklinWH tokens expire periodically. GridMind automatically re-authenticates using your stored credentials. If you change your FranklinWH password, you’ll need to update your credentials in GridMind under Settings.