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.