Skip to content

Modbus Fox ESS Inverters (Solakon ONE, Avocado 22 Pro, etc.) ​

This binding integrates the FoxESS solar inverters into openHAB.

Supported Inverters ​

As FoxESS inverters are sold in slightly different configurations, inverters of several brands might be supported.

This one is tested:

  • Solakon ONE

Others are untested, but might work:

  • FoxESS Avocado 22 Pro

Supported Things ​

The binding supports only one Thing:

  • mq2200-inverter: The FoxESS MQ-2200 inverter (also sold with the product name Solakon ONE or Avocado 22 Pro), connected via Modbus TCP.

Preparation ​

The data from the inverter is read via Modbus. So you need to configure a Modbus TCP Slave tcp as bridge first. The inverter can be connected via LAN or WLAN. As of now, you need to get the IP address of the inverter from your Router. IP is obtained via DHCP. I have not found a way to set a static IP on the Solakon ONE.

To troubleshoot, it is recommended to open a telnet connection to port 502. If it connects, you have likely found your device with an active Modbus server.

Thing Configuration ​

Once you've configured the Modbus TCP Slave as Bridge, you can configure the mq2200-inverter Thing. You just have to select the configured bridge and optionally configure the polling interval.

The foxinverter binding supports autodiscovery, so if you enable discovery in the bridge options, you can just press the scan button to add your inverter to the inbox.

FoxESS MQ-2200 Inverter (mq2200-inverter) ​

NameTypeDescriptionDefaultRequiredAdvanced
pollIntervalintegerInterval the device is polled in ms.5000yesno
maxTriesintegerSpecifies how many times the binding should retry reading data if a read attempt fails.
Set to 1 to disable retries and use a single attempt.
3yesno

Channels ​

NOTE: All channels are currently read-only. Writing is not yet implemented.

The mq2200-inverter Thing has channels that serve the current state of the FoxESS inverter, as you are used to from the vendor app.

Channel Type IDItem TypeDescriptionAdvancedChannel Group
fi-inverter-powerNumber:PowerInverter Active PowernoOverview
fi-home-import-powerNumber:PowerPower flow with home networknoOverview
fi-daily-pv-generationNumber:EnergyDaily PV GenerationnoOverview
fi-total-pv-generationNumber:EnergyTotal PV GenerationnoOverview
fi-internal-temperatureNumber:TemperatureInternal TemperatureyesOverview
fi-meter-connectedContactSmart Meter is ConnectedyesOverview
fi-status-alarmContactSystem WarningnoOverview
fi-status-operationContactSystem in Operational ModenoOverview
fi-status-standbyContactSystem in Standby Mode (not yet off)yesOverview
fi-pv-powerNumber:PowerPV PowernoMPPT Information
fi-mppt1-voltageNumber:ElectricPotentialMPPT1 VoltageyesMPPT Information
fi-mppt1-currentNumber:ElectricCurrentMPPT1 CurrentyesMPPT Information
fi-mppt1-powerNumber:PowerMPPT1 PowernoMPPT Information
fi-mppt2-voltageNumber:ElectricPotentialMPPT2 VoltageyesMPPT Information
fi-mppt2-currentNumber:ElectricCurrentMPPT2 CurrentyesMPPT Information
fi-mppt2-powerNumber:PowerMPPT2 PowernoMPPT Information
fi-mppt3-voltageNumber:ElectricPotentialMPPT3 VoltageyesMPPT Information
fi-mppt3-currentNumber:ElectricCurrentMPPT3 CurrentyesMPPT Information
fi-mppt3-powerNumber:PowerMPPT3 PowernoMPPT Information
fi-mppt4-voltageNumber:ElectricPotentialMPPT4 VoltageyesMPPT Information
fi-mppt4-currentNumber:ElectricCurrentMPPT4 CurrentyesMPPT Information
fi-mppt4-powerNumber:PowerMPPT4 PowernoMPPT Information
fi-battery-voltageNumber:ElectricPotentialBattery VoltageyesBattery Information
fi-battery-currentNumber:ElectricCurrentBattery CurrentyesBattery Information
fi-battery-levelNumber:DimensionlessBattery LevelnoBattery Information
fi-battery-charging-powerNumber:PowerBattery Charging PowernoBattery Information
fi-battery-temperatureNumber:TemperatureBattery TemperaturenoBattery Information
fi-battery-minimum-socNumber:DimensionlessBattery Min Charging LevelyesBattery Information
fi-battery-maximum-socNumber:DimensionlessBattery Max Charging LevelyesBattery Information
fi-battery-minimum-soc-on-gridNumber:DimensionlessBattery Min Charging Level on GridyesBattery Information
fi-phase-a-voltageNumber:ElectricPotentialPhase A VoltageyesGrid Information
fi-phase-b-voltageNumber:ElectricPotentialPhase B VoltageyesGrid Information
fi-phase-c-voltageNumber:ElectricPotentialPhase C VoltageyesGrid Information
fi-grid-frequencyNumber:FrequencyGrid FrequencyyesGrid Information
fi-grid-export-powerNumber:PowerOverall Power Export to GridnoGrid Information
fi-status-on-gridContactPower Grid AvailableyesGrid Information
fi-eps-outputSwitchEnable EPS OutputnoEPS
fi-eps-export-powerNumber:PowerEPS Output PowernoEPS

Full Example ​

This example shows how to configure a FoxESS inverter connected via Modbus and uses the most common channels.

mq2200.things ​

dsl
Bridge modbus:tcp:powerplant [ host="10.0.0.2", port=502, id=1, enableDiscovery=false ] {
    Thing mq2200-inverter inverter "FoxESS Inverter" [ pollInterval=5000 ]
}

mq2200.items ​

dsl
// Groups
Group inverter "FoxESS Inverter" <solarplant> ["Inverter"]
Group overview "Overview" <line> (inverter)
Group mppt "MPPT Information" <solarplant> (inverter)
Group batteryInformation "Battery information" <battery> (inverter)
Group gridInformation "Grid information" <energy> (inverter)
Group eps "Emergency Power Supply" <energy> (inverter)

// Overview
Number:Power active_power "Inverter Power" <line> (overview) ["Measurement", "Power"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-overview#fi-inverter-power"}
Number:Power battery_power "Home Import Power" <line> (batteryInformation,overview) ["Measurement", "Power"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-overview#fi-home-import-power"}
Number:Energy daily_pv_generation "Daily PV Generation" <line> (overview) ["Measurement", "Energy"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-overview#fi-daily-pv-generation"}
Number:Energy total_pv_generation "Total PV Generation" <line> (overview) ["Measurement", "Energy"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-overview#fi-total-pv-generation"}
Number:Temperature internal_temperature "Internal Temperature" <temperature> (overview) ["Measurement", "Temperature"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-overview#fi-internal-temperature"}
Contact meter_connected "Meter is Connected" (overview) ["Measurement"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-overview#fi-meter-connected"}
Contact status_alarm "Status Alarm" (overview) ["Measurement"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-overview#fi-status-alarm"}
Contact status_operation "Status Operation" (overview) ["Measurement"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-overview#fi-status-operation"}
Contact status_standby "Status Standby" (overview) ["Measurement"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-overview#fi-status-standby"}

// MPPT information
Number:Power pv_power "PV Power" <line> (mppt,overview) ["Measurement", "Power"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-pv-power"}
Number:ElectricPotential mppt1_voltage "MPPT1 Voltage" <energy> (mppt) ["Measurement", "Voltage"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-mppt1-voltage"}
Number:ElectricCurrent mppt1_current "MPPT1 Current" <energy> (mppt) ["Measurement", "Current"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-mppt1-current"}
Number:Power mppt1_power "MPPT1 Power" <line> (mppt) ["Measurement", "Power"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-mppt1-power"}
Number:ElectricPotential mppt2_voltage "MPPT2 Voltage" <energy> (mppt) ["Measurement", "Voltage"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-mppt2-voltage"}
Number:ElectricCurrent mppt2_current "MPPT2 Current" <energy> (mppt) ["Measurement", "Current"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-mppt2-current"}
Number:Power mppt2_power "MPPT2 Power" <line> (mppt) ["Measurement", "Power"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-mppt2-power"}
Number:ElectricPotential mppt3_voltage "MPPT3 Voltage" <energy> (mppt) ["Measurement", "Voltage"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-mppt3-voltage"}
Number:ElectricCurrent mppt3_current "MPPT3 Current" <energy> (mppt) ["Measurement", "Current"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-mppt3-current"}
Number:Power mppt3_power "MPPT3 Power" <line> (mppt) ["Measurement", "Power"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-mppt3-power"}
Number:ElectricPotential mppt4_voltage "MPPT4 Voltage" <energy> (mppt) ["Measurement", "Voltage"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-mppt4-voltage"}
Number:ElectricCurrent mppt4_current "MPPT4 Current" <energy> (mppt) ["Measurement", "Current"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-mppt4-current"}
Number:Power mppt4_power "MPPT4 Power" <line> (mppt) ["Measurement", "Power"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-mppt-information#fi-mppt4-power"}

// Battery information
Number:Dimensionless battery_level "Battery Level [%.0f %%]" <battery> (batteryInformation,overview) ["Measurement", "Energy"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-battery-information#fi-battery-level", unit="%"}
Number:Power battery_charging_power "Battery Charging Power" <line> (batteryInformation,overview) ["Measurement", "Power"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-battery-information#fi-battery-charging-power"}
Number:ElectricPotential battery_voltage "Battery Voltage" <energy> (batteryInformation) ["Measurement", "Voltage"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-battery-information#fi-battery-voltage"}
Number:ElectricCurrent battery_current "Battery Current" <energy> (batteryInformation) ["Measurement", "Current"]
{channel="modbus:mq2200-inverter:powerplant:inverter:fi-battery-information#fi-battery-current"}
Number:Temperature battery_temperature "Battery Temperature" <temperature> (overview) ["Measurement", "Temperature"]{channel="modbus:mq2200-inverter:powerplant:inverter:fi-battery-information#fi-battery-temperature"}
Number:Dimensionless battery_minimum_soc "Battery Min Charging Level [%.0f %%]" <battery> (batteryInformation) ["Control"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-battery-information#fi-battery-minimum-soc", unit="%"}
Number:Dimensionless battery_maximum_soc "Battery Max Charging Level [%.0f %%]" <battery> (batteryInformation) ["Control"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-battery-information#fi-battery-maximum-soc", unit="%"}
Number:Dimensionless battery_minimum_soc_on_grid "Battery Min Charging Level on Grid" <battery> (batteryInformation) ["Control"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-battery-information#fi-battery-minimum-soc-on-grid", unit="%"}

// Grid information
Number:ElectricPotential phase_a_voltage "Phase A Voltage" <energy> (gridInformation) ["Measurement"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-grid-information#fi-phase-a-voltage"}
Number:ElectricPotential phase_b_voltage "Phase B Voltage" <energy> (gridInformation) ["Measurement"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-grid-information#fi-phase-b-voltage"}
Number:ElectricPotential phase_c_voltage "Phase C Voltage" <energy> (gridInformation) ["Measurement"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-grid-information#fi-phase-c-voltage"}
Number:Frequency grid_frequency "Grid Frequency" <pump> (gridInformation) ["Measurement"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-grid-information#fi-grid-frequency"}
Number:Power grid_export_power "Export Power" <line> (gridInformation) ["Measurement", "Power"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-grid-information#fi-grid-export-power"}
Contact status_on_grid "Status Power Grid Available" (gridInformation) ["Measurement"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-grid-information#fi-status-on-grid"}

// EPS
Switch eps_output "EPS Output Enabled" (eps) ["Control"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-emergency-power-supply#fi-eps-output"}
Number:Power eps_export_power "EPS Export Power" <energy> (eps) ["Measurement", "Power"] {channel="modbus:mq2200-inverter:powerplant:inverter:fi-emergency-power-supply#fi-eps-export-power"}