Skip to content

Latest commit

 

History

History
134 lines (102 loc) · 4.93 KB

clean_summary+record.md

File metadata and controls

134 lines (102 loc) · 4.93 KB

Clean Summary

These commands retreive the cleaning history from the vacuum.

Get Clean Summary

Command

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

Example

{
    "method": "get_clean_summary",
    "id": 2
}

Response

Key Example Description
- 16414 Total cleaning time in sec
- 252165000 Total area (in cm2)
- 9 Total # cleanups
- [1497139200, 1496966400, 1496620800, 1496534400, 1496448000, 1496361600] Array of cleaning records ID's

Example

{
    "result": [16414, 252165000, 9, [1497139200, 1496966400, 1496620800, 1496534400, 1496448000, 1496361600]],
    "id": 2
}

Get Clean Record

Command

Key Value Comment
method "get_clean_record"
params [cleaning_id] cleaning_id can be taken from the array of get_clean_summary.
id id Random integer which is returned in the response used to link request and response.

Example

{
    "method": "get_clean_record",
    "params": [1497139200],
    "id": 263
}

Response

Key Example Description Restrictions
- 1497163727 Start time (unix timestamp)
- 1497165195 End time (unix timestamp)
- 1468 Cleaning duration (in s)
- 22902500 Area (in cm²)
- 0 Errors??
- 1 Completed (0=no, 1=yes)
- 2 Unknown s5e
- 3 Mode (1=full, 2=zone, 3=room) s5e
- 60 Unknown s5e

Example (generic)

{
    "result": [[1497163727, 1497165195, 1468, 22902500, 0, 1]],
    "id": 263
}

Example (s5e)

{
    "result": [[1497163727, 1497165195, 1468, 22902500, 0, 1, 2, 2, 60]],
    "id": 263
}

Get Clean Record Map

Gets part of the URL to fetch the map from the Xiaomi cloud. With the proper cloud decoding it can be retreived from the cloud independently of the Mi Home app File can be retreived from the Xiaomi cloud https://[country server].api.io.mi.com/app/home/getmapfileurl while passing the response from below get_map_v1 as parameter. The response from this is a URL which the RR enconded map can be downloaded.

For decoding of the mapfile see RR Map File

Command

Key Value Comment
method "get_clean_record_map"
params [cleaning_id] cleaning_id can be taken from the array of get_clean_summary.
id id Random integer which is returned in the response used to link request and response.

Example

{
    "method": "get_clean_record_map",
    "params": [1497139200],
    "id": 263
}

Response

Key Example Description
- "roboroommap%2255512245%2F1" Pointer to map data

Returns ["retry"] without internet.

Note: this URLdecodes to roboroommap"2255512245/1 where 2255512245 is the decimal representation of the deviceId, the digit after / appears to be a sequencial number

Example

{
    "result": ["roboroommap%2255512245%2F1"],
    "id": 2475
}