RIVER MINI: Fix Main Battery Level and add DC (12V) output control

[Suenee]

Summary

I would like to suggest two small improvements to the existing EcoFlow RIVER MINI support:

1. Fix the Main Battery Level sensor, which currently reports an unknown/unavailable value.
2. Add support for reading and controlling the DC (12V) / car output.

I tested both changes on a real EcoFlow RIVER MINI. They are currently running successfully in Home Assistant, including bidirectional synchronization of the DC output between Home Assistant and the EcoFlow mobile app.

Environment

• Device: EcoFlow RIVER MINI
• EcoFlow-Cloud integration: v1.4.1
• Home Assistant: Home Assistant OS on Home Assistant Green
• Integration file modified:
  custom_components/ecoflow_cloud/devices/internal/river_mini.py

---

1. Main Battery Level fix

Current behavior

The existing Main Battery Level entity for the RIVER MINI does not provide a valid battery percentage.

The device telemetry, however, contains the correct SOC value in:

bmsMaster.soc

This value matches the battery percentage reported by the EcoFlow mobile app and the actual device state.

Tested fix

Changing the RIVER MINI battery sensor to use bmsMaster.soc fixes the problem:

LevelSensorEntity(
    client,
    self,
    "bmsMaster.soc",
    const.MAIN_BATTERY_LEVEL,
).attr(
    "bmsMaster.maxChargeSoc",
    const.ATTR_DESIGN_CAPACITY,
    0,
),

Result

After restarting Home Assistant, the Main Battery Level entity correctly reports the RIVER MINI battery percentage.

I verified the reported value against the EcoFlow mobile app at different battery levels.

---

2. DC (12V) output state and control

The RIVER MINI telemetry also contains:

pd.carSwitch

This value correctly represents the current state of the DC/car output:

0 = OFF
1 = ON

I added the following EnabledEntity to switches():

EnabledEntity(
    client,
    self,
    "pd.carSwitch",
    const.DC_ENABLED,
    lambda value: {
        "moduleType": 0,
        "operateType": "TCP",
        "params": {
            "id": 34,
            "enabled": value,
        },
    },
),

This creates the expected:

DC (12V) Enabled

switch in Home Assistant.

---

DC switch test results

I tested both reading and writing on the physical RIVER MINI.

EcoFlow app -> RIVER MINI -> Home Assistant

When the DC output is switched ON or OFF using the EcoFlow mobile app:

• the physical DC output changes correctly;
• pd.carSwitch changes accordingly;
• the DC (12V) Enabled switch in Home Assistant updates to the correct state.

Home Assistant -> RIVER MINI -> EcoFlow app

When DC (12V) Enabled is switched ON or OFF in Home Assistant:

• the physical DC output changes correctly;
• the new state is reflected in the EcoFlow mobile app;
• Home Assistant continues to report the correct state.

Therefore the DC implementation has been successfully tested bidirectionally.

---

Suggested changes to river_mini.py

Battery

Use:

"bmsMaster.soc"

for MAIN_BATTERY_LEVEL.

DC output

Add this entity to switches():

EnabledEntity(
    client,
    self,
    "pd.carSwitch",
    const.DC_ENABLED,
    lambda value: {
        "moduleType": 0,
        "operateType": "TCP",
        "params": {
            "id": 34,
            "enabled": value,
        },
    },
),

---

Tested result

With these two changes, my RIVER MINI currently provides:

• working Main Battery Level;
• working DC (12V) Enabled state;
• working DC ON/OFF control from Home Assistant;
• correct DC state synchronization from the EcoFlow mobile app back to Home Assistant.

Both modifications are currently running successfully on the physical device.

I can provide additional diagnostic data or testing if needed.