The Energy window, to read and switch an EcoFlow battery
The Energy window shows the state of your EcoFlow power stations and switches their outlets. It goes through EcoFlow's official API, with your own developer keys. Open it from the dock, with the battery icon.
Creating your EcoFlow keys
The window needs two keys: an access key and a secret key. EcoFlow gives them on its developer portal.
- Open developer-eu.ecoflow.com if your EcoFlow account is European. Otherwise, open developer.ecoflow.com.
- Sign in with the account of your EcoFlow app.
- Choose "Become a Developer".
- Wait for EcoFlow to approve the request. The portal shows "Under review", and EcoFlow says the review takes up to 5 working days.
- Once the request is approved, create an access key and a secret key.
In the Energy window, paste both keys and choose the account region: Europe or Rest of the world. Then click "Save the keys".
What the window shows
One tab per device on the account. The coloured dot shows whether it is online.
For the chosen device, the window shows:
- the battery, in percent;
- the input and output power, in watts;
- the time left until full, or until empty.
A dash means the device did not give the value. An offline battery shows dashes, and zero only ever means a real reading of zero.
The window reads the device again every 30 seconds while it is open. "All values" opens the full list of what the device sends.
Switching a device
Three models can be switched: DELTA 2, DELTA 2 Max and RIVER 2 Pro. The commands come from EcoFlow's official page for each model.
| Command | DELTA 2 | DELTA 2 Max | RIVER 2 Pro |
|---|---|---|---|
| AC outlets | yes | yes | yes |
| USB / DC outlets | yes | yes | no |
| 12 V outlet | yes | yes | yes |
| Charge limit, 50 to 100 % | yes | yes | yes |
| Discharge limit, 0 to 30 % | yes | yes | yes |
An outlet goes on with "Turn on" and off with "Turn off". Type a limit in percent, then click "Apply".
Other EcoFlow models are shown read only, and the window says so under the values. The model is recognised by the name EcoFlow gives. A device without a name is read only too.
After a command
The window waits 2 seconds, reads the device again, then shows one of these messages:
- "done, the device confirms it": the new value was read back from the device.
- "EcoFlow accepted it, but the device still shows": EcoFlow received the command, and the device still shows the old value.
- "sent, but the device did not report the value": the read came back without that value.
- "sent, result unknown": EcoFlow took too long to answer. The command may still land, and the window reads the device again.
The AC outlets
The AC setting also carries the voltage, the frequency and X-Boost. The window keeps your device's own settings.
On the DELTA 2 Max, it reads X-Boost and the frequency just before, then sends them back unchanged. If the device does not report them, it sends nothing and says so.
On the DELTA 2 and the RIVER 2 Pro, EcoFlow's documentation gives no "keep" value. The window uses the ones from a widely used Home Assistant integration. It compares X-Boost and the frequency before and after. If they changed, a red message says so: check them in the EcoFlow app.
Your keys
The keys are sealed on this computer, like your API keys. The window receives them once and never shows them again. No cartridge from the store can reach them.
"Forget the keys" deletes the file. The window then asks for the keys again.
What goes through EcoFlow
Readings and commands go through EcoFlow's servers, as with their app. So you need internet, and EcoFlow sees the commands. Mnemosyne OS writes none of this to a vault.