iobroker.zendure-solarflow

1.12.7 • Public • Published

Logo

ioBroker.zendure-solarflow

NPM version Downloads Number of Installations Current version in stable repository

NPM

Tests: Test and Release

Zendure Solarflow adapter for ioBroker

This project is an ioBroker Adapter to read data from the Zendure Solarflow Cloud API.

Donate

If you find the adapter useful for you and want to support my work, feel free to donate by Paypal. Thank You! (this is an personal Donate link for Nograx, in no relation to the ioBroker Project!)

Donate

Features

  • Get all telemetry data from your Solarflow devices, also those not visible in the offical app - like battery voltage
  • Control your Solarflow HUB like in the offical app. Most of the settings are available.
  • Control the output limit - you are not limited to use a Shelly Pro EM to realize a zero feed-in. You can also design more complex scenarios via script or blockly in ioBroker.
  • Stop input if one battery drops into low voltage (battery protect). Works only when setting the output limit via the adapter
  • Control more than one Solarflow at the same time!
  • Get more precise calculations!
  • Works with all Zendure SolarFlow devices: HUB1200, Hyper2000, HUB2000 and AIO!

Offline-Mode (Disconnect from Zendure Cloud)

As a new feature you can disconnect the Zendure device from the Cloud. You can either use the Solarflow Bluetooth Manager from Reinhard Brandstätter or my own Windows Tool Zendure Cloud Disconnector to disconnect the device from the cloud. It's also possible to redirect DNS requests with your router from "mq.zen-iot.com" to your own MQTT server!

Both tools connect to the Zendure device via bluetooth and simply sets the internal MQTT url to a new url/ip you have to provide. Currently you are forced to use the default MQTT port 1883 on your server. You are also forced to deactivate authentication on the MQTT server as the Zendure device use a hardcoded password.

If the Zendure device communicates with your MQTT server, you can connect this ioBroker adapter to the same MQTT instance. You have to provide the device model and the device key (which is shown in the Zendure Cloud Disconnector app).

You can still do firmware updates with the official Zendure app via bluetooth and use both bluetooth tools to reconnect the device to the cloud!

Notes

  1. Please deactivate/uncheck all modes in the Zendure App, otherwise it is not possible to set the output limit!

    Solarflow Settings Window

  2. You will be logged out of the official iOS or Android App after logging in with the ioBroker adapter. This is a normal behavior. As a workaround you can create an second Zendure account with another e-mail and grant access to your Solarflow HUB to this account. Then use the second account for ioBroker / the Zendure Solarflow adapter.

  3. The Adapter will show a +7W use on battery if no solar input and device is online. This will reflect the "stand-by" usage of the device.

Credits

Credits goes to https://github.com/reinhard-brandstaedter/solarflow which helped a lot with the knowledge about the MQTT server from Zendure! Thanks!

Changelog

1.12.7 (2025-03-24)

  • Add productKey "gDa3tb" for Hyper 2000

1.12.6 (2025-03-21)

  • Fix onMessage Debug message

1.12.5 (2025-03-21)

  • Add Debug messages on log level debug
  • Add schedule for adapter refresh on local mode
  • Fix Change of Discharge limit to 0

1.12.4 (2025-03-19)

  • Fix calculation of SOC if "local" mode is used

1.12.3 (2025-03-19)

  • Add 2 more devices if "local" mode is used
  • Fix mqtt subscription of 2. device in "local" mode

1.12.2 (2025-03-18)

  • Fix reset of calculation values on "local" mode

1.12.1 (2025-03-17)

  • Fix IOT subscription

1.12.0 (2025-03-17)

  • Added possibility to use "local" mode. You have to either route dns request to your own MQTT server or use a tool to modify the Zendure device
  • Some improvements on value calculation
  • Some improvements on AIO 2400 device

1.11.0 (2025-02-11)

  • Drop Standby usage to 7W and 14W if HUB connected with ACE as it is more accurate
  • Added heatState and autoModel (system operation mode) state
  • Added possibility to set the operation mode (autoModel)
  • Fix gridPower state

1.10.7 (2025-01-21)

  • Fix reset calculation values of ACE if connected to HUB

1.10.6 (2025-01-16)

  • Fix start of calculation if HUB is connected with Ace

1.10.4 (2025-01-14)

  • Fix "Grid Input Power" state if connected with Ace

1.10.1 (2025-01-06)

  • Fix input limit when hub is bundled with ace
  • Fix calculation when low voltage block is activated

1.10.0 (2024-12-02)

  • Add setting to perform a full charge if SOC from Zendure is greater than 50% when on low voltage
  • Bugfixes

1.9.3 (2024-11-22)

  • Fix for Low Voltage Block not deactivated

1.9.2 (2024-11-21)

  • Fix some state definitions

1.9.1 (2024-11-21)

  • Improvement for 'Low Voltage Block'.
  • Changed the state "hubState" a an option value.

1.9.0 (2024-11-20)

  • New option to force Solarflow device to go offline when "Low Voltage Block"-option is used.

License

MIT License

Copyright (c) 2025 Peter Frommert

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.

Package Sidebar

Install

npm i iobroker.zendure-solarflow

Weekly Downloads

517

Version

1.12.7

License

GPL-3.0-only

Unpacked Size

6.28 MB

Total Files

70

Last publish

Collaborators

  • bluefox
  • nograx