Retrieves real-time data from FoxESS Cloud API for solar inverters (e.g., used in Enpal systems) and exposes ioBroker states for home automation:
- Monitor solar power production in real-time
- Track battery state of charge (SoC)
- Analyze grid consumption and feed-in power
- Automate based on power generation
- Visualize energy flows in ioBroker dashboards
pvPower: Current PV power generation (kW)generationPower: Total generation/output power (kW)load: Current load/consumption power (kW)gridConsumption: Power imported from grid (kW)feedinPower: Power exported to grid (kW)
soc: Battery state of charge (%)batCharge: Battery charging power (kW)batDischarge: Battery discharging power (kW)
info.connection: Connection status in1440 calls per day. With an interval of 60 seconds, this limit is perfectly utilized (1440 minutes = 24 hours).
The adapter creates the following data points:
foxesscloud.0.pvPower- PV Power (kW)foxesscloud.0.generationPower- Generation Power/Output (kW)foxesscloud.0.soc- Battery State of Charge (%)foxesscloud.0.load- Load Power (kW)foxesscloud.0.gridConsumption- Grid Consumption/Import (kW)foxesscloud.0.feedinPower- Feed-in/Export Power (kW)foxesscloud.0.batCharge- Battery Charge Power (kW)foxesscloud.0.batDischarge- Battery Discharge Power (kW)foxesscloud.0.info.connection- Connection status
- Install the adapter from the ioBroker admin interface
- Create a new instance
- Configure:
- API Token: Your API key from the FoxESS Cloud portal
- Serial Number (SN): The serial number of your inverter
- Update Interval: Data refresh interval in seconds (default: 60, minimum: 60)
- Save and start the instance
- Log in to FoxESS Cloud
- Go to your profile/settings
- Generate an API key (token)
- Find your inverter serial number in the device list
- This adapter only reads data from FoxESS Cloud API using your personal API token
- Your API token is stored encrypted in the ioBroker database
- (skvarel) Improved: Enabled Node.js 24 support in GitHub Actions workflows.
- (skvarel) Fixed: Issue detected by repository checker.
- (skvarel) Fixed: Issue detected by repository checker.
- (skvarel) Fixed: Issue detected by repository checker.
- (skvarel) Improved: Use node: prefix for core modules and adapter timer wrappers for better compatibility
- (skvarel) Fixed: Added .env.example to .gitignore
- (skvarel) Improved: Removed unnecessary devDependencies (eslint, should, dotenv) to follow ioBroker best practices.
- (skvarel) Improved: Updated test scripts to use standard mocha command instead of hardcoded paths.
- (skvarel) Improved: Switched Node.js core module imports to node:xxx format where applicable.
- (skvarel) Improved: Enforced minimum and maximum interval limits for data polling to comply with Node.js timer restrictions.
- (skvarel) Improved: Code formatting and configuration files updated for consistency with ioBroker standards.
- (skvarel) Fixed: Addressed review feedback for ioBroker latest repository inclusion.
- (skvarel) Added: Full multi-language support for all state names (EN, DE, RU, PT, NL, FR, IT, ES, PL, UK, ZH-CN).
MIT License
Copyright (c) 2026 skvarel skvarel@inventwo.com
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.