FoxESS MQ2200 (pv)
The FoxESS MQ2200 is a hybrid solar inverter sold under several brand names, including Avocado, Avocado Pro, and ONE. This template connects to the inverter over Modbus TCP and reads two PV-side registers: instantaneous total PV input power and cumulative PV energy generation. With these values in your ModbusCloud portal, you can track real-time solar production and long-term yield from a single device without polling the FoxESS cloud. The ModbusCloud Gateway connects to the inverter over your local network on TCP port 502.
- Protocol
- Modbus TCP
- Connection
- Ethernet, Modbus TCP
- Registers
- 2, read only
- Brand
- FoxESS
- Compatible models
- Avocado · MQ2200 · ONE · Avocado Pro
- Last updated
Registers (2)
2 read, 0 write
| Name | Unit | Access | Address (Hidden until you enter your email) | Function (hidden) | Type (hidden) |
|---|---|---|---|---|---|
| power | W | Read | |||
| energy | Wh | Read |
Loading registers…
Send your device list
If a device is not in the library yet, we build the template for free as soon as we have the register data.
Use cases
- Monitor real-time total PV input power to verify the array is producing during daylight hours.
- Track cumulative PV energy generation to calculate monthly and annual yield reports.
- Alert on a sudden drop in PV power to detect string or inverter faults quickly.
- Compare daily PV output against forecast irradiance data to spot underperforming periods.
- Verify that PV production resumes correctly after a firmware update or grid fault event.
Installation
Confirm Modbus TCP is active on the FoxESS MQ2200: connect the inverter to your LAN via its built-in Ethernet or Wi-Fi interface, then verify port 502 responds by opening a telnet connection to the inverter's IP address on port 502.
Connect the ModbusCloud Gateway to the same local network as the MQ2200 inverter, ensuring both devices can reach each other over TCP; note the inverter's IP address from your router's DHCP table.
In the ModbusCloud portal, add a new device, import the FoxESS MQ2200 (pv) template, and enter the inverter's IP address and unit ID (default 247) in the connection settings.
Trigger a manual poll in the portal and spot-check the power register (address 39118): a non-zero value during daylight confirms the link is working correctly.
Things to watch for
Register 39118 reads zero even when the sun is shining. Why?
The raw register value uses a gain of 1000 (the native unit is watts expressed as an int32). If your integration applies no scaling, zero or implausible values can appear. Confirm the template is loaded correctly in the portal and that the inverter firmware is current, as older firmware versions alter the register map.
The Gateway connects but neither register returns any value.
First verify the inverter's Modbus server is active by opening a telnet connection to port 502 on the inverter's IP. If it times out, the Modbus TCP service may not be running. Some firmware versions require the inverter to be fully commissioned and grid-connected before the Modbus service starts.
The cumulative energy register (39149) shows an unexpectedly high or inconsistent value.
Address 39149 is a 32-bit unsigned integer representing cumulative generation with a gain of 100 in the FoxESS protocol. Ensure your portal template is reading both 16-bit words as a single uint32. Reading only the high or low word will give an incorrect result.
The inverter IP changes after a reboot and the Gateway loses connection.
The MQ2200 obtains its IP via DHCP and does not expose a static IP configuration in all firmware versions. Assign a DHCP reservation for the inverter's MAC address in your router to keep the IP stable, then update the device IP in the ModbusCloud portal if it has already changed.
Want to see how it works?
