water_box_custom_mode.md

Water Box Custom Mode

Gets / sets the water quantity control during the cleaning process.

Get Water Box Custom Mode

Command

Key	Value	Comment
method	"get_water_box_custom_mode"
id	id	Random integer which is returned in the response used to link request and response.

Example

{
    "method": "get_water_box_custom_mode",
    "id": 17735
}

Response

Key	Example	Description
-	201	Water flow mode, see values of Modes

On some devices (Roborock Q7 Max) more fine-grained control is available:

Key	Example	Description
water_box_mode	201	Water flow mode, see values of Modes
distance_off	205	Fine-grained water control see Levels

Example

{
    "result": [201],
    "id": 17735
}

{
    "result": {"water_box_mode": 207, "distance_off": 60},
    "id": 17735
}

Set Water Box Custom Mode

Command

Key	Value	Comment
method	"set_water_box_custom_mode"
params	[water_flow_mode]	Desired water_flow_mode, see Modes
params	{"water_box_mode": value, "distance_off": off}	Desired configuration for devices with custom levels support, see Levels
id	id	Random integer which is returned in the response used to link request and response.

Modes

Mode	Flow
Off	200
Low	201
Medium	202
High	203
Customize (Auto)	204
Custom (Levels)	207

The "Customize" switch in the Xiaomi app only shows on when both the Custom Mode is set to Auto=106 and the Water Box Custom Mode is set to Auto=204.

Levels

The Xiaomi app allows 30 levels, the distance_off is calculated as 210 - 5 * level, thus ranging from 205 to 60.

The level is applied only when water_box_mode is 207.

Example

{
    "method": "set_water_box_custom_mode",
    "params": [202],
    "id": 17694
}

{
    "method": "set_water_box_custom_mode",
    "params": {"water_box_mode": 207, "distance_off": 60},
    "id": 17694
}

Response

Standard response to succeeded command.

Example

{
    "result": ["ok"],
    "id": 17694
}

Note

For the S5max you can't set the level with method": "set_water_box_custom_mode", "params": {"water_box_mode": 207, "distance_off": 60}, the mode will set, but the level (distance_off) not.

I checked the network traffix and found out, that is done by 'method': 'set_water_box_distance_off', 'params': {'distance_off': 105}}