Skip to content

v1.10.16-alpha.1 — River 3 Plus support (experimental, PR #40)

Pre-release
Pre-release

Choose a tag to compare

View all tags
@TarasKhust TarasKhust released this 31 May 17:05
v1.10.16-alpha.1
9fa1f16

🧪 Experimental: River 3 Plus support (#40)

Initial River 3 Plus monitor-only support, contributed by @ShikyC and tidied up against the project review. River 3 Plus isn't exposed via the Developer REST quota API (error 1006), so this uses app-authenticated MQTT with a protobuf decoder.

Sensors: battery SOC, temperature, AC input power, total in/out power, PCS AC/DC temperature, AC in/out voltage & current. Monitor-only (all controls are blocked — read-only device).

Setup: add the device as River 3 Plus and enter your EcoFlow app email/password (not Developer API keys).

Review fixes on top of the original PR

  • Protobuf decoder decoupled from Home Assistant; River3PlusState TypedDict removes all typing.Any.
  • Removed duplicate device-type routing keys; HomeAssistantError+NoReturn read-only guard.
  • A dead MQTT link now surfaces as unavailable instead of serving stale data.
  • Sensor defs moved to devices/river3plus/const.py; added protobuf-decoder unit tests (incl. the field 28 regression).

🧪 Pre-release / untested build. This could not be verified locally (no River 3 Plus hardware, no Python toolchain in the build env) — it's published specifically so River 3 Plus owners can test. Some values (voltage/current) are known to be approximate. Please report whether entities populate and whether the values look sane.

Contributors

ShikyC
Assets 2
Loading