---

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

Inverter

Inverter Signals

#	Entity Display Name	Unit
1	Status
2	Power Factor
3	Output Mode
4	Last Startup Time
5	Last Shutdown Time
6	Daily Energy	kWh
7	Total Energy Produced	kWh
8	Current Active Power	kW
9	Reactive Power	kvar
10	Rated Power	kW
11	Grid Frequency	Hz
12	Phase A Current	A
13	Phase B Current	A
14	Phase C Current	A
15	Phase A Voltage	V
16	Phase B Voltage	V
17	Phase C Voltage	V
18	Temperature	°C
19	Insulation Resistance	MΩ

PV Signals

#	Entity Display Name	Unit
1	[PV 1] Input Voltage	V
2	[PV 1] Input Current	A
3	[PV 1] Input Power	W

* [PV 1] can be [PV 1] to [PV 20] depending on your device.

Optimizer Metrics

#	Entity Display Name	Unit
1	Output Power	W
2	Total Energy	kWh
3	Input Voltage	V
4	Running Status
5	Temperature	°C
6	SN
7	Optimizer Number
8	Output Voltage	V
9	Input Current	A

Battery

Battery Status Signals

#	Entity Display Name	Unit
1	Operating Status
2	Charge/Discharge Mode
3	Rated Capacity	kWh
4	Backup Time	min
5	Energy Charged Today	kWh
6	Energy Discharged Today	kWh
7	Charge/Discharge Power	kW
8	Bus Voltage	V
9	State of Charge	%

Battery Module Signals

#	Entity Display Name	Unit
1	[Module 1] No.
2	[Module 1] Working Status
3	[Module 1] SN
4	[Module 1] Software Version
5	[Module 1] SOC	%
6	[Module 1] Charge and Discharge Power	kW
7	[Module 1] Internal Temperature	°C
8	[Module 1] Daily Charge Energy	kWh
9	[Module 1] Daily Discharge Energy	kWh
10	[Module 1] Total Discharge Energy	kWh
11	[Module 1] Bus Voltage	V
12	[Module 1] Bus Current	A
13	[Module 1] FE Connection
14	[Module 1] Total Charge Energy	kWh
15	[Module 1] Battery Pack 1 No.
16	[Module 1] Battery Pack 2 No.
17	[Module 1] Battery Pack 3 No.
18	[Module 1] Battery Pack 1 Firmware Version
19	[Module 1] Battery Pack 2 Firmware Version
20	[Module 1] Battery Pack 3 Firmware Version
21	[Module 1] Battery Pack 1 SN
22	[Module 1] Battery Pack 2 SN
23	[Module 1] Battery Pack 3 SN
24	[Module 1] Battery Pack 1 Operating Status
25	[Module 1] Battery Pack 2 Operating Status
26	[Module 1] Battery Pack 3 Operating Status
27	[Module 1] Battery Pack 1 Voltage	V
28	[Module 1] Battery Pack 2 Voltage	V
29	[Module 1] Battery Pack 3 Voltage	V
30	[Module 1] Battery Pack 1 Charge/Discharge Power	kW
31	[Module 1] Battery Pack 2 Charge/Discharge Power	kW
32	[Module 1] Battery Pack 3 Charge/Discharge Power	kW
33	[Module 1] Battery Pack 1 Maximum Temperature	°C
34	[Module 1] Battery Pack 2 Maximum Temperature	°C
35	[Module 1] Battery Pack 3 Maximum Temperature	°C
36	[Module 1] Battery Pack 1 Minimum Temperature	°C
37	[Module 1] Battery Pack 2 Minimum Temperature	°C
38	[Module 1] Battery Pack 3 Minimum Temperature	°C
39	[Module 1] Battery Pack 1 SOC	%
40	[Module 1] Battery Pack 2 SOC	%
41	[Module 1] Battery Pack 3 SOC	%
42	[Module 1] Battery Pack 1 Total Discharge Energy	kWh
43	[Module 1] Battery Pack 2 Total Discharge Energy	kWh
44	[Module 1] Battery Pack 3 Total Discharge Energy	kWh
45	[Module 1] Battery Pack 1 Battery Health Check
46	[Module 1] Battery Pack 2 Battery Health Check
47	[Module 1] Battery Pack 3 Battery Health Check
48	[Module 1] Battery Pack 1 Heating Status
49	[Module 1] Battery Pack 2 Heating Status
50	[Module 1] Battery Pack 3 Heating Status

* [Module 1] can be [Module 1] to [Module 4] depending on your device.

Power Sensor

Power Sensor Signals

#	Entity Display Name	Unit
1	Meter Status
2	Positive Active Energy	kWh
3	Negative Active Energy	kWh
4	Reactive Power	var
5	Active Power	W
6	Power Factor
7	Phase A Active Power	W
8	Phase B Active Power	W
9	Phase C Active Power	W
10	Phase A Voltage	V
11	Phase B Voltage	V
12	Phase C Voltage	V
13	Phase A Current	A
14	Phase B Current	A
15	Phase C Current	A
16	Grid Frequency	Hz

Emma A02 Signals

#	Entity Display Name	Unit
1	Forward Active Energy	kWh
2	Reverse Active Energy	kWh
3	Reactive Power	kvar
4	Active Power	kW
5	Power Factor
6	Phase A Active Power	kW
7	Phase B Active Power	kW
8	Phase C Active Power	kW
9	Phase A Voltage	V
10	Phase B Voltage	V
11	Phase C Voltage	V
12	Phase A Current	A
13	Phase B Current	A
14	Phase C Current	A
15	RS485-2 Port Mode
16	WiFi Signal Strength	dBm
17	Signal Strength	dBm

DTSU666-FE Signals

#	Entity Display Name	Unit
1	Communication Status
2	AB Line Voltage	V
3	BC Line Voltage	V
4	CA Line Voltage	V
5	Phase A Voltage	V
6	Phase B Voltage	V
7	Phase C Voltage	V
8	Phase A Current	A
9	Phase B Current	A
10	Phase C Current	A
11	Active Power	kW
12	Reactive Power	kVar
13	Power Factor
14	Phase A Active Power	kW
15	Phase B Active Power	kW
16	Phase C Active Power	kW
17	iAcMeter
18	iAcMeter IP
19	Comm Status
20	iAcMeter Mode
21	Meter Data Source

Charger

Charging Pile Signals

#	Entity Display Name	Unit
1	Connector Number
2	Connector Type
3	Rated Power	kW
4	Status
5	Relay Status
6	Connector Temp	°C
7	Phase A Current	A
8	Phase C Current	A
9	Phase B Current	A
10	Output Power	kW
11	PWM Duty	%
12	Connector Lock
13	Working Mode
14	Departure Time
15	Planned Charge Energy	kWh
16	Connection Status
17	Charging Duration (s)	s

Charger Device Signals

#	Entity Display Name	Unit
1	FW Version
2	HW Version
3	Serial Number
4	Rated Power	kW
5	Phase A Voltage	V
6	Phase B Voltage	V
7	Phase C Voltage	V
8	Model
9	Total Energy	kWh
10	Charger Temp	°C
11	Port Count
12	Bluetooth Name
13	Device Status

Plant

Plant Signals

#	Entity Display Name	Unit
1	Monthly Energy	kWh
2	Total Energy	kWh
3	Today Income
4	Today Energy	kWh
5	Yearly Energy	kWh
6	Self Used Energy Today	kWh
7	Consumption Today	kWh
8	PV Self Consumption	kWh
9	PV Feed-In Energy	kWh
10	Imported Grid Energy	kWh
11	Total Consumption	kWh
12	Grid Import Ratio	%
13	Self Consumption Ratio	%
14	Self Consumption Ratio (by PV production)	%
15	Flow Solar Power	kW
16	Flow Battery Power	kW
17	Flow Load Power	kW
18	Flow Buy Power	kW

BackupBox

BackupBox Signals

#	Entity Display Name	Unit
1	Status
2	Grid A Phase Voltage	V
3	Grid B Phase Voltage	V
4	Grid C Phase Voltage	V
5	Phase A Voltage of Backup Load	V
6	Phase B Voltage of Backup Load	V
7	Phase C Voltage of Backup Load	V
8	Internal Ambient Temperature	°C

EMMA

EMMA Signals

#	Entity Display Name	Unit
1	Forward Active Energy	kWh
2	Reverse Active Energy	kWh
3	Reactive Power	kvar
4	Active Power	kW
5	Power Factor
6	Active Power Pa	kW
7	Active Power Pb	kW
8	Active Power Pc	kW
9	Phase A Voltage	V
10	Phase B Voltage	V
11	Phase C Voltage	V
12	Phase A Current	A
13	Phase B Current	A
14	Phase C Current	A

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.