Adapter for FoxEss Inverters

[Wondermusic]

What kind of device or service would you like to see an adapter for?
Fox-ess Inverter

Is the device connected to the internet or only available on a local network?
It is connected to the Internet and is not availabe in local network (in my case the T-Series, other may be also available in LAN).

Is an official App or Website available?
Yes.
Homepage: https://de.fox-ess.com/
Cloudsite: https://www.foxesscloud.com/

Is an official API including documentation available?
I think so, but I'm not sure.

Are other libraries for an integration available?
Ideally in JavaScript/npm, but also other programming languages are interesting, add links please

Is this device already integrated in other Smart Home systems?
Yes in Home Assistant via HACS: https://github.com/macxq/foxess-ha

Is this device already integrated in homebridge? Might the ham adapter in combination with the homebridge plugin be sufficient?
No

[goebel-joerg]

Would be great to get an adapter for the Fox ess series

[mcm1957]

@goebel-joerg
Please use Thumbs-Up at first post to show your interest. This allows sorting of Requests by most requested adapters.
See https://github.com/ioBroker/AdapterRequests#how-to-use-this

[Wondermusic]

@mcm1957
Sorry, haven't got any notifications about new posts.
What do you mean with - Hardware needed? I can test, if that help's.

[mcm1957]

Hardware Needed is a general marker for potential developers indicating that an implementaion is not (really) possible without access to a matching hardware. Of course this need not be a physical device at the location of a developer - a cooperation with any user having access to a matching hardware will be ok too. In this case access to the webservice could be sufficient too if someone will share access data.

Thanks for your offer to support a potential developer. If someone will start a development he/she will contact you. DO NOT POST ANY ACCESS DATA HERE.

[arneproft]

I´ve got the Modbus Protocol. Maybe it helps for direct connecting to the Hybrid Inverters from H1 and H3 (incl. AIO) Series. :-)
T-Series and the other non-Hybrids are actually not available.
Cheers!

H3&AIO-H3 Hybrid Inverter modbus Protocol_20220710.pdf
H1-Modbus Register Definitions_Single Phase Hybrid Inverter_V1.01.pdf

[Schlicky]

I have a FOX ESS AIO H3 inverter and i can test the adapter as well.

Here is the Fox Cloud API Document: Fox Cloud API Document

Fox Cloud (FC):
FC provide the broker depending on MQTT V3.1.1 version, allow the account that has been
registered in FC platform and has access to achieve data to subscribe the data info of inverter,
battery and monitor module via MQTT protocol.
The specific scope of authority is authorized and managed by the platform manufacture

[Schlicky]

Here is a similiar project ... it might help the developers
macxq/foxess-ha - FOX ESS with Home Assistant Integration

[gbackus]

Fox Cloud (FC): FC provide the broker depending on MQTT V3.1.1 version, allow the account that has been registered in FC platform and has access to achieve data to subscribe the data info of inverter, battery and monitor module via MQTT protocol. The specific scope of authority is authorized and managed by the platform manufacture

Has anyone tried to use the mqtt client to get data from the FOX Inverter?

[lordheandl]

Gibt es hierzu schon was neues?
Habe auch einen fox ess h3 wechselrichter und die App dazu ist grauenhaft. Würde gerne die Daten in mein iobroker integrieren. Ein Adapter wäre genial

[forrestfunk]

Für android gibt es eine schlankere app, nennt sich "energy stats".
Der momentane Weg (bis es vielleicht irgendwann einen nativen adapter gibt) ist über den modbus zu gehen. Ich empfehle hierzu in diesem Thread quer zu lesen:
https://www.photovoltaikforum.com/thread/178210-erfahrungen-mit-fox-ess/?pageNo=207

[DutchmanNL]

hat schonmal jemand probiert die API aus zu lesen, laut Dokumentation ist es ein MQTT api diese sollte man theoretisch auch mit dem MQTT adapter auslesen können. Ich habe gerade einen Kunden wo ein Fox ESS converter verbaut ist, leider noch nicht in betrieb genommen.

Sobald dieser in betrieb ist werde ich auch mal schauen was man machen kan das wird aber noch ein wenig dauern

[lordheandl]

Endlich DutchmanNL nimmt sich der Sache an. Dann gibt es bald einen Adapter🙏

[mcm1957]

diese sollte man theoretisch auch mit dem MQTT adapter auslesen können

Den mqtt Adapter gibt es bereits :-)

[lolmeister77]

Ich konnte hier die Cloud API von Fox ESS finden:
https://www.foxesscloud.com/i18n/en/OpenApiDocument.html

//Edit: API Keys lassen sich hier anlegen:
https://www.foxesscloud.com/user/center

[DutchmanNL]

Ich konnte hier die Cloud API von Fox ESS finden:

https://www.foxesscloud.com/i18n/en/OpenApiDocument.html

Vielen Dank, das hilft und die api ist gut dokumentiert

"Before using this api, please go to the api management of the cloud platform personal center to generate your apikey."

Währe der nächste Schritt für einen Entwickler (ich habe dieses Gerät nicht und auch keinen Zugang zu jemanden der es hat)

Ich arbeite gerade an einem zentralen Modul um derartige API einfacher in einen ioBroker Adapter zu integrieren, diese API währe ein potenzieller Kandidat

[lolmeister77]

In der Dokumentation ist ein Beispiel Python Script, welches inkl API Key auf Anhieb funktioniert.:

 python foxwrtest.py
'status_code:200'
('content:b\'{"errno":0,"msg":"success","result":[{"datas":[{"unit":"kW","name":"PV1Power","variable":"pv1Power","value":0.0},{"unit":"kW","name":"PV2Power","variable":"pv2Power","value":0.0},{"unit":"%","name":"SoC","variable":"SoC","value":81.0}],"time":"2023-11-12 '
 '19:16:15 CET+0100","deviceSN":"XXXXXXXXXXXX"}]}\'')

Ich bekomme beim Testen nur recht schnell die Meldung:

'status_code:200'
('content:b\'{"errno":40400,"msg":"Your requests are too frequent. Please try '
 'again later"}\'')

Zusätzlich scheint man bei Fox nur 20 Calls pro Tag frei zu haben. Wenn ich einen API Key anlege sehe ich wie viele Abfragen noch zur Verfügung stehen.

[GonzoTheNose]

Ich konnte hier die Cloud API von Fox ESS finden:
https://www.foxesscloud.com/i18n/en/OpenApiDocument.html

Vielen Dank, das hilft und die api ist gut dokumentiert

"Before using this api, please go to the api management of the cloud platform personal center to generate your apikey."

Währe der nächste Schritt für einen Entwickler (ich habe dieses Gerät nicht und auch keinen Zugang zu jemanden der es hat)

Ich arbeite gerade an einem zentralen Modul um derartige API einfacher in einen ioBroker Adapter zu integrieren, diese API währe ein potenzieller Kandidat

Habe das Device und kann Tests dazu ausführen.

[DutchmanNL]

@GonzoTheNose @lolmeister77

Das problem was ich hier sehe sind dis API abfragen (max 20 pro tag) wodurch ich eine Implementierung dieser API als nicht wirklich sinnvoll interpretiere. Man koennte im grunde maximal jede stunden einmalig die API ihre daten ermitteln.

Wir sollten das klarstellen ehe ein API adapter entsteht mit ungewünschten Effekten.

Endlich DutchmanNL nimmt sich der Sache an. Dann gibt es bald einen Adapter🙏

Mein Kunde hat nur leider die integration auf naestes Jahr verschoben daher habe ich keinen Zugang zu einem system um es mir an zu schauen grr

Fox Cloud (FC): FC provide the broker depending on MQTT V3.1.1 version, allow the account that has been registered in FC platform and has access to achieve data to subscribe the data info of inverter, battery and monitor module via MQTT protocol. The specific scope of authority is authorized and managed by the platform manufacture

Has anyone tried to use the mqtt client to get data from the FOX Inverter?

Was anyone able to communicate by MQTT to the device ? As mentioned (in German) above the API has a 20 call rate limit.
If we are able to connect locally (which is also my preference on top of an web API) it would be more suistanable.

[GonzoTheNose]

@GonzoTheNose @lolmeister77

Das problem was ich hier sehe sind dis API abfragen (max 20 pro tag) wodurch ich eine Implementierung dieser API als nicht wirklich sinnvoll interpretiere. Man koennte im grunde maximal jede stunden einmalig die API ihre daten ermitteln.

Wir sollten das klarstellen ehe ein API adapter entsteht mit ungewünschten Effekten.

Endlich DutchmanNL nimmt sich der Sache an. Dann gibt es bald einen Adapter🙏

Mein Kunde hat nur leider die integration auf naestes Jahr verschoben daher habe ich keinen Zugang zu einem system um es mir an zu schauen grr

Fox Cloud (FC): FC provide the broker depending on MQTT V3.1.1 version, allow the account that has been registered in FC platform and has access to achieve data to subscribe the data info of inverter, battery and monitor module via MQTT protocol. The specific scope of authority is authorized and managed by the platform manufacture

Has anyone tried to use the mqtt client to get data from the FOX Inverter?

Was anyone able to communicate by MQTT to the device ? As mentioned (in German) above the API has a 20 call rate limit. If we are able to connect locally (which is also my preference on top of an web API) it would be more suistanable.

Die Rahmenbedingungen sind mir bekannt und damit kann ich leben...

[lolmeister77]

Ich bin zwischenzeitlich doch auf die lokale Modbus Schnittstelle gewechselt, da man hier Werte in Echtzeit bekommt.
Ein Ticket, welche weiteren lokalen Abfragen noch möglich sind, ist bis jetzt noch bei Fox offen.
Ich denke trotzdem, dass ein Adapter, der die täglichen Statistiken abrufen kann, sinnvoll wäre.
Ich habe vom Fox Support erfahren, dass Anfang 2024 eine neue "Version" der Cloud kommen soll. Vielleicht ändern sich dann auch die Limitierungen.

[DutchmanNL]

Ich bin zwischenzeitlich doch auf die lokale Modbus Schnittstelle gewechselt, da man hier Werte in Echtzeit bekommt.
Ein Ticket, welche weiteren lokalen Abfragen noch möglich sind, ist bis jetzt noch bei Fox offen.
Ich denke trotzdem, dass ein Adapter, der die täglichen Statistiken abrufen kann, sinnvoll wäre.

wuerdest du deine Modus Konfiguration als template bereits stellen damit andere es auch einfacher übernehmen können (Modus ist nicht jedermann sein ding)

Ich habe vom Fox Support erfahren, dass Anfang 2024 eine neue "Version" der Cloud kommen soll. Vielleicht ändern sich dann auch die Limitierungen.

man müsste die requirements fuel einen adapter durchnehmen, abrufen von Statistiken macht so sinn ein wirklich live daten verbrauch eher weniger

[lolmeister77]

Das ist das Holding-Register, was ich aktuell verwende.
Frei übernommen von:
https://github.com/StealthChesnut/HA-FoxESS-Modbus

`_address	name	description	unit	type	len	factor	offset	formula	role	room	poll	wp	cw	isScale
30000	foxess_inv1_model	Inverter Model		string	1						true	false	false	false
30016	foxess_inv1_master_version	Master Version		uint16be	1	0,01					false	false	false	false
30018	foxess_inv1_manager_version	Manager Version		uint16be	1	0,01					false	false	false	false
30019	foxess_inv1_bms_version	BMS Version		uint16be	1						false	false	false	false
30020	foxess_inv1_battery_1_version	Battery 1 Version		uint16be	1						false	false	false	false
30021	foxess_inv1_battery_2_version	Battery 2 Version		uint16be	1						false	false	false	false
30022	foxess_inv1_battery_3_version	Battery 3 Version		uint16be	1						false	false	false	false
31000	foxess_inv1_pv1_voltage	PV1 Voltage	V	int16be	1	0,1					true	false	false	false
31001	foxess_inv1_pv1_current	PV1 Current	A	int16be	1	0,1					true	false	false	false
31002	foxess_inv1_pv1_power	PV1 Power	kW	int16be	1	0,001					true	false	false	false
31003	foxess_inv1_pv2_voltage	PV2 Voltage	V	int16be	1	0,1					true	false	false	false
31004	foxess_inv1_pv2_current	PV2 Current	A	int16be	1	0,1					true	false	false	false
31005	foxess_inv1_pv2_power	PV2 Power	kW	int16be	1	0,001					true	false	false	false
31006	foxess_inv1_grid_voltage_R	RVolt	V	int16be	1	0,1					true	false	false	false
31007	foxess_inv1_grid_voltage_S	SVolt	V	int16be	1	0,1					true	false	false	false
31008	foxess_inv1_grid_voltage_T	TVolt	V	int16be	1	0,1					true	false	false	false
31009	foxess_inv1_inv_current_R	RCurrent	A	int16be	1	0,1					true	false	false	false
31010	foxess_inv1_inv_current_S	SCurrent	A	int16be	1	0,1					true	false	false	false
31011	foxess_inv1_inv_current_T	TCurrent	A	int16be	1	0,1					true	false	false	false
31012	foxess_inv1_inv_power_R	Rpower	kW	int16be	1	0,001					true	false	false	false
31013	foxess_inv1_inv_power_S	Spower	kW	int16be	1	0,001					true	false	false	false
31014	foxess_inv1_inv_power_T	TPower	kW	int16be	1	0,001					true	false	false	false
31015	foxess_inv1_grid_frequency	Grid Frequency	Hz	int16be	1	0,01					false	false	false	false
31016	foxess_inv1_eps_voltage_R	EPS RVolt	V	int16be	1	0,1					false	false	false	false
31017	foxess_inv1_eps_voltage_S	EPS SVolt	V	int16be	1	0,1					false	false	false	false
31018	foxess_inv1_eps_voltage_T	EPS TVolt	V	int16be	1	0,1					false	false	false	false
31019	foxess_inv1_eps_current_R	EPS Rcurrent	A	int16be	1	0,1					false	false	false	false
31020	foxess_inv1_eps_current_S	EPS Scurrent	A	int16be	1	0,1					false	false	false	false
31021	foxess_inv1_eps_current_T	EPS Tcurrent	A	int16be	1	0,1					false	false	false	false
31022	foxess_inv1_eps_power_R	EPS RPower	kW	int16be	1	0,001					false	false	false	false
31023	foxess_inv1_eps_power_S	EPS SPower	kW	int16be	1	0,001					false	false	false	false
31024	foxess_inv1_eps_power_T	EPS TPower	kW	int16be	1	0,001					false	false	false	false
31025	foxess_inv1_eps_frequency	EPS Frequency	Hz	int16be	1	0,01					false	false	false	false
31026	foxess_inv1_meter1_power_R	Meter RPower	kW	int16be	1	0,001					true	false	false	false
31027	foxess_inv1_meter1_power_S	Meter SPower	kW	int16be	1	0,001					true	false	false	false
31028	foxess_inv1_meter1_power_T	Meter TPower	kW	int16be	1	0,001					true	false	false	false
31029	foxess_inv1_load_power_R	Load RPower	kW	int16be	1	0,001					true	false	false	false
31030	foxess_inv1_load_power_S	Load SPower	kW	int16be	1	0,001					true	false	false	false
31031	foxess_inv1_load_power_T	Load TPower	kW	int16be	1	0,001					true	false	false	false
31032	foxess_inv1_inverter_temperature	Inverter Temperature	°C	int16be	1	0,1					true	false	false	false
31033	foxess_inv1_ambient_temperature	Inner Temperature	°C	int16be	1	0,1					true	false	false	false
31034	foxess_inv1_inv_battery_voltage	InvBatVolt	V	int16be	1	0,1					false	false	false	false
31035	foxess_inv1_inv_battery_current	InvBatCurrent	A	int16be	1	0,1					false	false	false	false
31036	foxess_inv1_battery_power	InvBatPower	kW	int16be	1	0,001					true	false	false	false
31037	foxess_inv1_battery_temperature	Battery Temp	°C	int16be	1	0,1					true	false	false	false
31038	foxess_inv1_battery_soc	Battery Soc	%	int16be	1	1					true	false	false	false
31039	foxess_inv1_bms_charge_rate	BMS Max Charge Current	A	int16be	1	0,1					false	false	false	false
31040	foxess_inv1_bms_discharge_rate	BMS Max Discharge Current	A	int16be	1	0,1					false	false	false	false
31041	foxess_inv1_state_code	Inverter State Code		int16be	1						true	false	false	false
31044	foxess_inv1_fault_1_code	Inverter Fault 1 Code		int16be	1						false	false	false	false
31045	foxess_inv1_fault_2_code	Inverter Fault 2 Code		int16be	1						false	false	false	false
31046	foxess_inv1_fault_3_code	Inverter Fault 3 Code		int16be	1						false	false	false	false
31047	foxess_inv1_fault_4_code	Inverter Fault 4 Code		int16be	1						false	false	false	false
31048	foxess_inv1_fault_5_code	Inverter Fault 5 Code		int16be	1						false	false	false	false
31049	foxess_inv1_fault_6_code	Inverter Fault 6 Code		int16be	1						false	false	false	false
31050	foxess_inv1_fault_7_code	Inverter Fault 7 Code		int16be	1						false	false	false	false
31050	foxess_inv1_fault_8_code	Inverter Fault 8 Code		int16be	1						false	false	false	false
32000	foxess_inv1_pv_energy_total	PV Energy Total	kWh	uint32be	1	0,1					true	false	false	false
32002	foxess_inv1_pv_energy_today	PV Energy Today	kWh	uint16be	1	0,1					true	false	false	false
32003	foxess_inv1_charge_energy_total	Charge Energy Total	kWh	uint32be	1	0,1					true	false	false	false
32005	foxess_inv1_charge_energy_today	Charge EnergyToday	kWh	uint16be	1	0,1					true	false	false	false
32006	foxess_inv1_discharge_energy_total	Discharge Energy Total	kWh	uint32be	1	0,1					true	false	false	false
32008	foxess_inv1_discharge_energy_today	Discharge Energy Today	kWh	uint16be	1	0,1					true	false	false	false
32009	foxess_inv1_feed_in_energy_total	Feed In Energy Total	kWh	uint32be	1	0,1					true	false	false	false
32011	foxess_inv1_feed_in_energy_today	Feed In EnergyToday	kWh	uint16be	1	0,1					true	false	false	false
32012	foxess_inv1_grid_consumption_energy_total	Grid Consumption Energy Total	kWh	uint32be	1	0,1					true	false	false	false
32014	foxess_inv1_grid_consumption_energy_today	Grid Consumption Energy Today	kWh	uint16be	1	0,1					true	false	false	false
32015	foxess_inv1_output_energy_total	Output Energy Total	kWh	uint32be	1	0,1					false	false	false	false
32017	foxess_inv1_output_energy_today	Output EnergyToday	kWh	uint16be	1	0,1					false	false	false	false
32018	foxess_inv1_input_energy_total	Input Energy Total	kWh	uint32be	1	0,1					false	false	false	false
32020	foxess_inv1_input_energy_today	Input Energy Today	kWh	int16be	1	0,1					false	false	false	false
32021	foxess_inv1_load_energy_total	Load Energy Total	kWh	uint32be	1	0,1					false	false	false	false
32023	foxess_inv1_load_energy_today	Load Energy Today	kWh	int16be	1	0,1					false	false	false	false
41000	foxess_inv1_work_mode	Work Mode		int16be	1	1					false	false	false	false
41007	foxess_inv1_max_charge_current	Max Charge Current	A	int16be	1	0,1					false	false	false	false
41008	foxess_inv1_max_discharge_current	Max Discharge Current	A	int16be	1	0,1					false	false	false	false
41009	foxess_inv1_min_soc	Min SoC	%	int16be	1	1					false	false	false	false
41010	foxess_inv1_max_soc	Max Soc	%	int16be	1	1					false	false	false	false
41011	foxess_inv1_min_soc_on_grid	Min SoC (On Grid)	%	int16be	1	1					false	false	false	false

[JayVee2]

Hiet hat einer in Python schon gute Arbeit geleistet:

https://pypi.org/project/foxesscloud/0.2.7/#description

[CPU-6502]

@DutchmanNL : Ich habe bei mir einen FOX ESS H3 sowie iobroker auf Raspberry Pi am Laufen. Bin gerne bereit dich bei der Entwicklung/Test zu unterstützen!

Stefan

[gbackus]

Da wäre ich sofort mit an Board mit meinem FOX ESS F3000.
Diese dämliche Cloud ist im Moment das letzte Puzzlestück, das in meiner ioBroker-Heimsteuerung fehlt.

[kohennigs]

Moin Moin!

Mein H3 und ich sind bei unter der Sonne 🤭 und ich versuche mich gerade zu orientieren was in Richtung iobroker gerade geht und wo man was machen / ich evtl helfen kann.

Bin hab ich aber gestern erst die API Doku entdeckt.

Laut API Doku hat sich da was getan:

Da steht was von real-time data und:

Each inverter under a single account has a total of 1440 interface calls per day.
The query interface is limited to once per second, and mach interface is calculated separately.
Inserting update interfaces is limited to once every 2 seconds, and each interface is calculated separately.