---

Note

For some development (e.g. batteries, optimizers & car chargers) I will need access to an account which has access to (one of) these devices. If you are willing to help by granting me access to your account, please open an issue.

FusionSolarPlus

This integration brings full FusionSolar support to Home Assistant, with entities for plants, inverters, and more. It authenticates using your FusionSolar username and password. No northbound API, OpenAPI, or kiosk URL required. I originally built it as a custom Python script that sent data via MQTT, but realizing others might want a Home Assistant integration with full entity support, I ported it with AI assistance into a proper integration for easier use.

Setup

Click the button below and download the FusionSolarPlus integration.

Once installed:

1. Restart Home Assistant and head over to Settings » Devices & Services.
2. Click on "Add Integration."
3. Search for "FusionSolarPlus."
4. Enter your FusionSolar username, password and subdomain.
5. Select the device type you want to add, then choose the specific device.

Repeat step 2 - 5 for each of the devices you want to add.

Energy Dashboard

FusionSolarPlus is fully compatible with the integrated Home Assistant energy dashboard. Please make sure you’ve already added the correct device types (See step 2-5 above).

When configuring the energy dashboard you need to provide the following settings:

	Energy dashboard setting	Device Type	Entity
Electricity Grid	Grid Consumption	Power Sensor	Negative Active Energy
	Return to Grid	Power Sensor	Positive Active Energy
Home Battery Storage	Energy going in to the battery	Battery	Energy Charged Today
	Energy coming out of the battery	Battery	Energy Discharged Today
Solar Panels	Solar Production	Inverter	Daily Energy (for each inverter)

Entities

Click here to see the list of entities [Outdated!]

Inverter & Plant

#	Inverter Entity	Unit		Plant Entity	Unit
1	Current Active Power	kW		Current Power	kW
2	Daily Energy	kWh		Today Energy	kWh
3	Grid Frequency	Hz		Monthly Energy	kWh
4	Insulation Resistance	MΩ		Yearly Energy	kWh
5	Last Shutdown Time	Datetime		Total Energy	kWh
6	Last Startup Time	Datetime		Today Income	ISO 4217
7	Output Mode	Text		Self Used Energy Today**	kWh
8	Phase A Current	A		Consumption Today**	kWh
9	Phase A Voltage	V
10	Phase B Current	A
11	Phase B Voltage	V
12	Phase C Current	A
13	Phase C Voltage	V
14	Power Factor	Ratio
15	Rated Power	kW
16	Reactive Power	kvar
17	Status	Text
18	Temperature	°C
19	Total Energy Produced	kWh
20	[PV X] Input Voltage	V
21	[PV X] Input Current	A
22	[PV X] Input Power	W

*X ranges from 1 to 20 depending on how many PV Strings your inverter has connected.

**These entities only show up if you have a power meter connected.

Battery & Optimizer

#	Battery Entity	Unit		Optimizer Entity	Unit
1	Operating Status	Text		Output Power	W
2	Charge/Discharge Mode	Text		Total Energy	kWh
3	Rated Capacity	kWh		Input Voltage	V
4	Backup Time	min		Running Status	Text
5	Energy Charged Today	kWh		Temperature	°C
6	Energy Discharged Today	kWh		Serial Number (SN)	Text
7	Charge/Discharge Power	kW		Optimizer Number	Text
8	Bus Voltage	V		Output Voltage	V
9	State of Charge	%		Input Current	A
10	[Module X] No.	Text
11	[Module X] Working Status	Text
12	[Module X] SN	Text
13	[Module X] Software Version	Text
14	[Module X] SOC	%
15	[Module X] Charge and Discharge Power	kW
16	[Module X] Internal Temperature	°C
17	[Module X] Daily Charge Energy	kWh
18	[Module X] Daily Discharge Energy	kWh
19	[Module X] Total Discharge Energy	kWh
20	[Module X] Bus Voltage	V
21	[Module X] Bus Current	A
22	[Module X] FE Connection	Text
23	[Module X] Total Charge Energy	kWh
24	[Module X] Battery Pack 1 No.	Text
25	[Module X] Battery Pack 2 No.	Text
26	[Module X] Battery Pack 3 No.	Text
27	[Module X] Battery Pack 1 Firmware Version	Text
28	[Module X] Battery Pack 2 Firmware Version	Text
29	[Module X] Battery Pack 3 Firmware Version	Text
30	[Module X] Battery Pack 1 SN	Text
31	[Module X] Battery Pack 2 SN	Text
32	[Module X] Battery Pack 3 SN	Text
33	[Module X] Battery Pack 1 Operating Status	Text
34	[Module X] Battery Pack 2 Operating Status	Text
35	[Module X] Battery Pack 3 Operating Status	Text
36	[Module X] Battery Pack 1 Voltage	V
37	[Module X] Battery Pack 2 Voltage	V
38	[Module X] Battery Pack 3 Voltage	V
39	[Module X] Battery Pack 1 Charge/Discharge Power	kW
40	[Module X] Battery Pack 2 Charge/Discharge Power	kW
41	[Module X] Battery Pack 3 Charge/Discharge Power	kW
42	[Module X] Battery Pack 1 Maximum Temperature	°C
43	[Module X] Battery Pack 2 Maximum Temperature	°C
44	[Module X] Battery Pack 3 Maximum Temperature	°C
45	[Module X] Battery Pack 1 Minimum Temperature	°C
46	[Module X] Battery Pack 2 Minimum Temperature	°C
47	[Module X] Battery Pack 3 Minimum Temperature	°C
48	[Module X] Battery Pack 1 SOC	%
49	[Module X] Battery Pack 2 SOC	%
50	[Module X] Battery Pack 3 SOC	%
51	[Module X] Battery Pack 1 Total Discharge Energy	kWh
52	[Module X] Battery Pack 2 Total Discharge Energy	kWh
53	[Module X] Battery Pack 3 Total Discharge Energy	kWh
54	[Module X] Battery Pack 1 Battery Health Check	Text
55	[Module X] Battery Pack 2 Battery Health Check	Text
56	[Module X] Battery Pack 3 Battery Health Check	Text
57	[Module X] Battery Pack 1 Heating Status	Text
58	[Module X] Battery Pack 2 Heating Status	Text
59	[Module X] Battery Pack 3 Heating Status	Text

*The optimizer entities can be found under the Diagnostic section for Inverter devices. The optimizer entities are automatically created if your inverter has optimizers connected.

**X ranges from 1 to 4 depending on how many modules your battery has.

⚠️ Note: Currently, this integration only supports battery modules 1 and 2. If your battery has 3 or 4 modules, please open an issue.

Power Sensor & Car Charger

#	Power Sensor Entity	Unit		Charger Entity	Unit
1	Meter Status	Text		Connector Number	Text
2	Positive Active Energy (Exported Energy)	kWh		Connector Type	Text
3	Negative Active Energy (Imported Energy)	kWh		Rated Power	kW
4	Reactive Power	Var		Status	Text
5	Active Power	W		Relay Status	Text
6	Power Factor	Ratio		Connector Temp	℃
7	Phase A Active Power	W		Phase A Voltage	V
8	Phase B Active Power	W		Phase B Voltage	V
9	Phase C Active Power	W		Phase C Voltage	V
10	Phase A Voltage	V		Phase A Current	A
11	Phase B Voltage	V		Phase B Current	A
12	Phase C Voltage	V		Phase C Current	A
13	Phase A Current	A		Output Power	kW
14	Phase B Current	A		Total Energy	kWh
15	Phase C Current	A		PWM Duty	%
16	Grid Frequency	Hz		Connector Lock	Text
17				Working Mode	Text
18				Departure Time	DateTime
19				Planned Charge Energy	kWh
20				Connection Status	Text
21				Charging Duration (s)	s
22				Serial Number	Text
23				Model	Text
24				Charger Temp	℃
25				Port Count	Text
26				Bluetooth Name	Text

Issues

If you encounter any problems while using the integration, please open an issue. Be sure to include as much relevant information as possible, this helps with troubleshooting and speeds up the resolution process.

Development

To contribute or run FusionSolarPlus locally, follow these steps:

1. Install VS Code:
   Download and install Visual Studio Code.

2. Install Docker:
   Download and install Docker.

3. Clone the repository:

   git clone https://github.com/JortvanSchijndel/FusionSolarPlus.git && cd FusionSolarPlus

4. Copy the dev container configuration:

   cp .devcontainer/devcontainer.json.sample .devcontainer/devcontainer.json

5. Open the project in VS Code:

   code .

6. Start the development container:

   • Open the Command Palette (Mac: Cmd+Shift+P, Windows/Linux: Ctrl+Shift+P)
   • Type Dev Containers: Rebuild and Reopen in Container and press Enter.

This will set up a reproducible development environment with all dependencies installed and Home Assistant will be accessible at http://localhost:8123.

Legal Notice

This integration for Home Assistant uses a custom modified version of FusionSolarPy.