python-roborock 6.2.1__py3-none-any.whl → 7.2.0__py3-none-any.whl

{python_roborock-6.2.1.dist-info → python_roborock-7.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: python-roborock
-Version: 6.2.1
+Version: 7.2.0
 Summary: A package to control Roborock vacuums.
 Project-URL: Repository, https://github.com/python-roborock/python-roborock
 Project-URL: Documentation, https://python-roborock.readthedocs.io/

{python_roborock-6.2.1.dist-info → python_roborock-7.2.0.dist-info}/RECORD

@@ -1,55 +1,57 @@
 roborock/__init__.py,sha256=jpp3MEmevRvoJ5tq2waCDGH5VfJk--Lv1DmrwEdDyEQ,375
 roborock/broadcast_protocol.py,sha256=fjNQW7NdBKRzSy6126TfCSoYGpT2Esj9Jd-t7tXFc_E,4015
 roborock/callbacks.py,sha256=w2yPXtWFH7zfoFsLPYoCTbfwbE9p1ivA7iDcw20lJQI,4300
-roborock/cli.py,sha256=3AZHW8Co1H0Bqi7o1nMKA2MkfPuld_OdbPHQh_sNzCA,63478
+roborock/cli.py,sha256=3OrJAmd9c52cyKLC9jF4-O5UkVXJAWZilOzvnxP7jyc,64097
 roborock/const.py,sha256=fWpgUPrCgLnaXmncgjCLZET-t7wHWQlpyzV8qHtTjb4,2860
-roborock/device_features.py,sha256=MGpyUPFkAD4ntYS9RbZoYaojy26XQZvbAWrWmAnrMv4,45433
-roborock/diagnostics.py,sha256=YIc7BhC6Cy6W2a6hykvfSRPG8NpLrPZCc_7jTX2Zdho,5091
+roborock/device_features.py,sha256=i4YrJUfS8ZPB8azK8grAiBxoLS2MyGJcdwOvGtnUuFg,45866
+roborock/diagnostics.py,sha256=OVfPCjBVidAlQtFz-WRlgCWOBIaXlO-73xQloXJaLwI,5107
 roborock/exceptions.py,sha256=t2YvfSRMymZPtdPV238itjxVJTaTq5-uBL_EM5FTlfg,3159
 roborock/protocol.py,sha256=eNUL6UGmtSdfsGM1mlYjmorukGGudV45iKXUA7a-Qa8,20193
 roborock/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-roborock/roborock_message.py,sha256=-y66O_JapRoHEyhKd5kyogCpE3d9TSuKysVLnxQ6Fd4,11678
+roborock/roborock_message.py,sha256=VWsytnm7nQqOMBj7oYbiqPPqwE9qClDSI03CFuHXsds,11822
 roborock/roborock_typing.py,sha256=xppavdf57-Cu6elj3MP403uT75Tjw5Zs6bLGPLQmZf4,15483
 roborock/util.py,sha256=mjw329ujLjoWPPAr9mG0VZstaVL06dmVvNnYACB-Pxk,1650
 roborock/web_api.py,sha256=M_A4PiRK5cwkoT3oS8fvglOU97s1jpWKuuCxeeCiF_E,37507
 roborock/data/__init__.py,sha256=jSZHOrd-LfVN-TdBkjNW334ef99rGBz4-hPT_7KvoLs,278
-roborock/data/code_mappings.py,sha256=5c7hW3nN8uad8j3fyv8upYoIAfGlOsaZDeivpL4VAWc,9450
-roborock/data/containers.py,sha256=zgT2lm4NIz5_og8wmdgg2PREPN4PIuZ_BI-Z8JdGey0,17129
+roborock/data/code_mappings.py,sha256=SGLJvHSdibUsXqCbQcqCGKm3x09JqhRKLoCgMCN1_s0,9769
+roborock/data/containers.py,sha256=r46o2Xf6gfpw2SHBZnkVbfJIYYbpgTPYWDmAHWdgL8E,17228
 roborock/data/b01_q10/__init__.py,sha256=E4lwJcz4AI1z92FcYOJ-cY3fcfHSoXqvYVgfA-TgaRk,71
 roborock/data/b01_q10/b01_q10_code_mappings.py,sha256=UBFkxCWLYCGQatENmNwR0owkXrcB8AosnD-hICfS2AY,15203
-roborock/data/b01_q10/b01_q10_containers.py,sha256=jieHxHeWIRm2NHVdv15J6kYSeHjAZunGrvZsob-RIH8,11130
+roborock/data/b01_q10/b01_q10_containers.py,sha256=HE1qAhYKDTz35oRgekYItNfD1iWTi7605-wpETcDzxU,11823
 roborock/data/b01_q7/__init__.py,sha256=D-Cd8eB0njf1PQPM6Exl_9A0AhpzIjrL0hapGOCEkkA,69
-roborock/data/b01_q7/b01_q7_code_mappings.py,sha256=EHSCZSv_Os049NcenKo4tkPjDOB4vpmQ2p2Psr9FRCc,10698
+roborock/data/b01_q7/b01_q7_code_mappings.py,sha256=aOJqNFrJWqRSvgruVIpuaB6tP7gwvr-sSGHVsCOJAHk,11072
 roborock/data/b01_q7/b01_q7_containers.py,sha256=jNEHoNEdq276XJZGGUmtSyJ81cSIzJwem-O_NOgmfdQ,10270
 roborock/data/dyad/__init__.py,sha256=Ksx7Ri1alsAYAyILOpj9iNbCC_6sF7xvETFRnTO4rdM,65
 roborock/data/dyad/dyad_code_mappings.py,sha256=PGzEpkdc1jsR5RLRnjVnI2Y87O_HFAFulwOjjjbT4B0,2872
 roborock/data/dyad/dyad_containers.py,sha256=klJD2wV-2McjAoSN8Bthuyeid59L7M8nzSvc3MtmqOI,434
-roborock/data/mower/__init__.py,sha256=v-bMapgWFzlb0jJVJBmsnmDfgnER7oTjP0OH3ikwGdE,79
-roborock/data/mower/mower_containers.py,sha256=mCsRFTE2AZ2wC9wzrzsr-3z7T2M63CH5ax9kPqPygIY,3194
+roborock/data/mower/__init__.py,sha256=RXFcOE0-rchWViq3F-cLXB9Jnx4nKrn98TUR917szWM,114
+roborock/data/mower/mower_code_mappings.py,sha256=T3NJEjgkYv3svIt7-gqFgrnNmVeBOkqit8_D52vSIao,1741
+roborock/data/mower/mower_containers.py,sha256=PYNVhbGCafkchenBlBmG_fUnIC-9WfxF8gNB0C4_9Yo,4106
 roborock/data/v1/__init__.py,sha256=Lx_D6baZrCMxp57D0NcdiA8rssJ5NnInZwUwrT79XOI,91
-roborock/data/v1/v1_clean_modes.py,sha256=71_olE6rsdx_UwxkBEPlcHTz0vnyKSnURGxIwuqhOwM,14056
+roborock/data/v1/v1_clean_modes.py,sha256=ZUhMqrM9MwnXFl3btZj9_LEAOmhNIl80krW-AiuWouk,13866
 roborock/data/v1/v1_code_mappings.py,sha256=_2ycHU9VH86SayZXPLXY1Ej6bJxRvOT_GDIdHsNUR04,12934
 roborock/data/v1/v1_containers.py,sha256=UBScIG6VKziEAC0FaQRHnfrGWDY06nITY8NkFJEzhiE,17256
 roborock/data/zeo/__init__.py,sha256=VxG5qG4M24DGOq2YAaxownWp6bEfj9DEOgOMHmTpcqY,63
-roborock/data/zeo/zeo_code_mappings.py,sha256=MaTs9UqvwC2t2eaLRpeTT2RkP1TYNLVcxe5iJBfzLHw,8364
+roborock/data/zeo/zeo_code_mappings.py,sha256=mfm2xoI8RllPZfyZE0HmUhUhLECwRD0llkMNWfaEHvw,8057
 roborock/data/zeo/zeo_containers.py,sha256=huDeisutagKz1rzsLZr_tGAietec_qOd0KB3i09YGgo,4339
 roborock/devices/README.md,sha256=zjssyRIlFWTgQz8hLdsJC9_stlHdUQybz7r2af_8q1k,2186
 roborock/devices/__init__.py,sha256=yOWuncnp5wwKPLzcnblsBMGD0v8hcDDDC_x7YdSrN70,129
 roborock/devices/cache.py,sha256=V3KC16LzTEAp_cdAirNtWPjZAgz6ugn3zfsYPyrbWsE,4633
-roborock/devices/device.py,sha256=8lHdjLlHhrENPjrZxllpYU0CEh7Os9rp9spnwhdUOoc,9678
+roborock/devices/device.py,sha256=bhRvHsZC2yhNiwg2yBJVjC8ZO_BJ_NkZMajuABXMHuo,10122
 roborock/devices/device_manager.py,sha256=RPuvbhYxLjdCBrsjYP91dvHTnO8inODsa26m5987VR4,11777
 roborock/devices/file_cache.py,sha256=-G2Bm4ra8K_DvSBjntv5hGaRDB-VzSoKWcI0Y_kK6jw,2724
 roborock/devices/rpc/__init__.py,sha256=MDtZovvHi3F4Wbgyzu6gyjAjkZ6xYGU1LRQmtiIapuU,561
-roborock/devices/rpc/a01_channel.py,sha256=cUwxaG3DdCDZrKDXNqbtKrgd8pFybeGrql_xwPNk5DY,3776
+roborock/devices/rpc/a01_channel.py,sha256=R33NQ3hK6pWjPzF2kaWVv93r9RrTWskg6_YWi3Oiiq4,3886
 roborock/devices/rpc/b01_q10_channel.py,sha256=nT7fsTtti37alm68CHzId8Wy3GMd6npiSNB8Gjegy3I,3494
-roborock/devices/rpc/b01_q7_channel.py,sha256=cxJR_DjJobP6SsAch_O3tNcJdiQGMIwpxH8Wx8bb9xA,7689
+roborock/devices/rpc/b01_q7_channel.py,sha256=sE3U5r8RlSqSCXxSdd_a_4nPkOSkIPFvCTwxKMtcOnU,8738
 roborock/devices/rpc/v1_channel.py,sha256=xCQ9YqgTFteU-ptc9-H0w6HtZK3OyH8GBS4QNsxi18w,24365
 roborock/devices/traits/__init__.py,sha256=YaL9qoxG6IBG0XXDP0HMTvoc0Jkmq7AF6iH2oYWNtcg,765
 roborock/devices/traits/common.py,sha256=n3fHK4i4bkTU1QL7skMStJiUPIDlpN37z0T9mPQYoOY,4588
 roborock/devices/traits/traits_mixin.py,sha256=7t15l_Ty1cN-3-fKNtRH1XR6-mfadPnTBCQRZP4rAtc,2092
-roborock/devices/traits/a01/__init__.py,sha256=i-us9zLPWPfSQ5XWq8t0MiYLYe5NkcLvk3aEQTYT7E0,8104
+roborock/devices/traits/a01/__init__.py,sha256=GKu_SWJ9l57u0DU_vd8ec4j6smwrR9s4gUF0yMB-xWA,13284
+roborock/devices/traits/a01/device_feature.py,sha256=6--fV8kRv4nxWIaQlxHt0XFyovhqk6dGeVm-E1n5y_U,13514
 roborock/devices/traits/b01/__init__.py,sha256=pGN6wEocE6Fr2BTasG8Z_75crD6OdTwpju59Vw7eTDk,202
-roborock/devices/traits/b01/q10/__init__.py,sha256=ZFQw1_fwTyjOpJ6ggeFl4JTutleu8R7sCK-j6OYD_UI,6212
+roborock/devices/traits/b01/q10/__init__.py,sha256=BpeCO7vrM11ISy8JZwBiSkHsTs5-vp68c9YwnWKEIDk,6747
 roborock/devices/traits/b01/q10/button_light.py,sha256=_CCWSjFe_iZnnSXgBHOju31VUmwG1KKd_jGkmSpLew4,994
 roborock/devices/traits/b01/q10/child_lock.py,sha256=bTsbAMxn7AF1zpWteyZCkQm4jj3NiWD8ddZTM3tlG_0,1131
 roborock/devices/traits/b01/q10/clean_history.py,sha256=OsuzliXtWl2RDMAdKElCaebp9Pr2czVOex180k4jzVs,6672
@@ -58,16 +60,17 @@ roborock/devices/traits/b01/q10/common.py,sha256=Qxl3zBAUulqdrjFZJ0DPEFEIJLvlPqU
 roborock/devices/traits/b01/q10/consumable.py,sha256=MbtMgYKqzNdVn6M1iyOAqZPCYTbN_Q_Pr4h8EYGEiuY,669
 roborock/devices/traits/b01/q10/do_not_disturb.py,sha256=klyGQZ_nHyO6bhPlwBl8vElTnMwPf4A8VXwxkU8rMlM,1157
 roborock/devices/traits/b01/q10/dust_collection.py,sha256=LM-0YH4pMrEqLUCFP2g-DymhL5ZUQ4bHd-2EyKHmucY,1582
-roborock/devices/traits/b01/q10/map.py,sha256=2feJhw2N7j1niGheTDvgHrxXFW94GeGpRiWoK-DO4Ss,6064
+roborock/devices/traits/b01/q10/map.py,sha256=1_gFfiSTgJ0XbdfBsiH6QM2Nh6aF25i-IElojEf85v4,7541
+roborock/devices/traits/b01/q10/maps.py,sha256=qWk1K47aIf3iJead3A2zQ3Lo0wZ1wcS2mo4qVfiiTDw,2101
 roborock/devices/traits/b01/q10/network_info.py,sha256=XiCr6YPu7xkvhgeaGwXli-_4SB88QW63ykiegyaau2k,656
 roborock/devices/traits/b01/q10/remote.py,sha256=8-fg4SA5M-tdMufHPeD9hIcax7y9Qh7pzcE7rBBVW_o,1267
 roborock/devices/traits/b01/q10/status.py,sha256=JAPixbsQ8jfN3OvI7o_NxISXFk8l7rGHFYcL4pH97Jk,859
 roborock/devices/traits/b01/q10/vacuum.py,sha256=w2FftNH5n-Tb-9drR3-5OiMy85FJfTDNmtt34LklC8w,4374
 roborock/devices/traits/b01/q10/volume.py,sha256=UnT0yYDQntxYwnpv4_NVychm0FnGAYRAWA_FJR4yJag,1001
-roborock/devices/traits/b01/q7/__init__.py,sha256=y3NV-DYHyQoPcpWnmGppX5Y1GjF9MylVxyoIVldKFCA,7935
+roborock/devices/traits/b01/q7/__init__.py,sha256=wHe2uncF49MlfPwyIgs0xbwnQo8q0eDEyHTh33iHq80,8549
 roborock/devices/traits/b01/q7/clean_summary.py,sha256=M43iJVeYjrkBV6ZxXdHtn4Rd5Mx-KAK7WLU5fABiN8I,2742
 roborock/devices/traits/b01/q7/map.py,sha256=NfPQAEwNCUsb0SYGMxmGeq4q4rEHqDJK0zTD5cE-ESs,1299
-roborock/devices/traits/b01/q7/map_content.py,sha256=5l7WJSDEfUzXkwXYcvTWhuNz3mlXvA_u2o5Pnh6f5kE,3372
+roborock/devices/traits/b01/q7/map_content.py,sha256=M0anKPY82kN3wZZAu-vVWqpq_Cw-FA5YJ6QsMef9YPo,4722
 roborock/devices/traits/v1/__init__.py,sha256=gzp5b2aJCugHF_9jqEZG7ycsv_xCMZa8ymhtm3Nqofg,16986
 roborock/devices/traits/v1/child_lock.py,sha256=NeaPqcEoBRXvEzKZGonkyINkwCBOK3xa4zSWvJW66kA,1161
 roborock/devices/traits/v1/clean_summary.py,sha256=2uDl3Tg6H9INf7HTEPPat_PBgodoWeX_ko5MJgWggn8,4625
@@ -87,7 +90,7 @@ roborock/devices/traits/v1/obstacle_photos.py,sha256=Aul1sOxJ6AxLWqI5AbeHHSzxfUP
 roborock/devices/traits/v1/rooms.py,sha256=PKNEvzL_Pk5pxGpiMC-XgGpgWVRjivMw_yv7vpGlz3s,6221
 roborock/devices/traits/v1/routines.py,sha256=BfktlpnyDjD2DB3zBDS5BnmjZPE38aHa-wjMontPnik,931
 roborock/devices/traits/v1/smart_wash_params.py,sha256=6K3XrF5SRS39BWaMjjtGJgKX3lZ24jPsb6Nia4a9GVM,634
-roborock/devices/traits/v1/status.py,sha256=Y5VBJPZQhmlGDPQvPIp8mFCFsUf4hheZ5k_nnxOoXHI,5071
+roborock/devices/traits/v1/status.py,sha256=HPEUnpCbOxoZ6O_Dz3C3mJpYiIiq9vs8zvrzc78oxAw,5078
 roborock/devices/traits/v1/valley_electricity_timer.py,sha256=vE9bLJe8TdFGVh_9mDRkEoC3_DTBkDcdlSMSiYq0YTw,1863
 roborock/devices/traits/v1/volume.py,sha256=etRIYE0ynZZLEo2ez7Dm7_JbijmElrdjpn59hyLWqsQ,814
 roborock/devices/traits/v1/wash_towel_mode.py,sha256=bSXtaJ0ObDlXsJYuCHWCN3J0GyHEibPsDvOqBCxQW3Q,2039
@@ -97,8 +100,8 @@ roborock/devices/transport/local_channel.py,sha256=kU49v6v3wsT6MQeN4wN-XkTxr-zBy
 roborock/devices/transport/mqtt_channel.py,sha256=dpL1mZIoI4Glk3hfUO9JweWFHG1tZWLrWbt9f4RbvhQ,4789
 roborock/map/__init__.py,sha256=L3WHujuxUHCTTPaOElkJsTN_FkYhw01drfR-W4blgFc,146
 roborock/map/b01_grid_layers.py,sha256=VluAmKEIBTsvzGB5pUrr8iYFiyEx5siyDwBKft1C2vA,12290
-roborock/map/b01_map_parser.py,sha256=UacKI3qfPvjEX3zkSq360lMukitFdMhlB24IyLQR8Dw,4160
-roborock/map/b01_q10_map_parser.py,sha256=qR1So58HrrO2GxCr1CWY_GlUQBJcOldRYd03jGQXEOw,29923
+roborock/map/b01_map_parser.py,sha256=tTeeWH4fA4Pv4DvqN7PBQs92DuWTaD2rvD44Mo_t3OY,4433
+roborock/map/b01_q10_map_parser.py,sha256=EQMx2ZNVjHKsmKr6vR8JS7o86IZu85dNg3bKi5S0ZYw,29985
 roborock/map/b01_q10_overlays.py,sha256=JmriUbT4-oe6NiE94VttMplFc1HHQrAGNQIiZHj5QKk,6640
 roborock/map/b01_q10_render.py,sha256=0K7x5AErSaowAH3ZUkStUXFgH4GM0debu0jIEJhlgVk,13360
 roborock/map/map_parser.py,sha256=2Rse_VhC2HEfjO2aXw7p-QhYN3NLl9JoRbxqxGGPR64,7275
@@ -115,14 +118,15 @@ roborock/protocols/a01_protocol.py,sha256=LpFsrZ9epwuTNsPprYGL0KgQD37DfvXfFrNuc_
 roborock/protocols/b01_q10_protocol.py,sha256=Ac3_VHJ2DAwBiXFMPYOHExEV0prxS9Ju0djiC8nKtiI,4935
 roborock/protocols/b01_q7_protocol.py,sha256=o8repRrxhxknzspsg1K27ds643rs87ilWXbj8RJtOCs,4619
 roborock/protocols/v1_protocol.py,sha256=ntFQoGn1IF7v_BwjiGow478SJHBSKr6jq6M2s01OdaI,12918
-roborock/testing/__init__.py,sha256=cveoyU-mQVQ2TezMEHc_OT5ga-7QIKY7ew-Xs_0AOz8,4581
+roborock/testing/__init__.py,sha256=rji4a-JBIWC_I6SUTG9j4r2bGxfhYUoopdDAzYQ1tmA,5086
+roborock/testing/a01_simulator.py,sha256=M4R0ATgebIva6Jl0BPKfwdGqdZjmjGZHlozAVVteJ5I,10477
 roborock/testing/b01_q10_simulator.py,sha256=7k2poUIDI0akTw0rEcCpTUZq0gjr8z3kfTkgA33fFis,7004
 roborock/testing/channel.py,sha256=vjulT5MHBe8lAq6XITUqcxJVcCILWx7ZEcw5imTx0Tk,7243
-roborock/testing/cloud.py,sha256=tAZ8oT8UX5w1OziY1kSGQ4Q6-erTQH9IG2bZC1ih_7w,11566
+roborock/testing/cloud.py,sha256=L2L0KlZDYaMuoV19KUQUoq5EAUDeNQ1lJ8Ew5YaOgjo,11946
 roborock/testing/simulator.py,sha256=g8ZUWVSjgAzuRRxWOCeOq-7deodyEItwUpqEw9RzCmQ,4347
 roborock/testing/v1_simulator.py,sha256=TQ2PsRoP_4kJvVn-Tm532ByHuaCKltsVjvTa2Ju4PAo,14407
-python_roborock-6.2.1.dist-info/METADATA,sha256=Se_oCY7u4yDt8OSULGKisD3C8594Yvic4oHzKKHTYQ8,5278
-python_roborock-6.2.1.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
-python_roborock-6.2.1.dist-info/entry_points.txt,sha256=EvC1nMqi9ZXKgZnqlNXA33v_3nzgPNjnM0mzWlrehnY,47
-python_roborock-6.2.1.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-python_roborock-6.2.1.dist-info/RECORD,,
+python_roborock-7.2.0.dist-info/METADATA,sha256=FIUbTM4uQDYeOtX_WjwGgRQz7MqfiYsDlQFlNGQsZoM,5278
+python_roborock-7.2.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+python_roborock-7.2.0.dist-info/entry_points.txt,sha256=EvC1nMqi9ZXKgZnqlNXA33v_3nzgPNjnM0mzWlrehnY,47
+python_roborock-7.2.0.dist-info/licenses/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+python_roborock-7.2.0.dist-info/RECORD,,

{python_roborock-6.2.1.dist-info → python_roborock-7.2.0.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.31.0
+Generator: hatchling 1.32.0
 Root-Is-Purelib: true
 Tag: py3-none-any

roborock/cli.py

@@ -594,9 +594,9 @@ async def maps(ctx, device_id: str):
     await _display_v1_trait(context, device_id, lambda v1: v1.maps)
 
 
-# The Q10 pushes its map ~9s after a dpRequestDps; firmware throttles pushes to
-# ~once per 60-70s, so a single request is answered quickly but rapid re-requests
-# may not be. This bounds how long a one-shot CLI command waits for that push.
+# The Q10 publishes its map asynchronously after a dpMultiMap list/get request.
+# Firmware throttles pushes to ~once per 60-70s, so rapid re-requests may not be
+# answered immediately. This bounds how long a one-shot CLI command waits.
 _Q10_MAP_PUSH_TIMEOUT = 30.0
 
 
@@ -607,13 +607,12 @@ async def _await_q10_map_push(
     timeout: float = _Q10_MAP_PUSH_TIMEOUT,
     allow_cached_on_timeout: bool = False,
 ) -> bool:
-    """Nudge a Q10 to push its map/trace and wait for a fresh update.
+    """Request Q10 map content and wait for usable map-trait state.
 
-    The Q10 map API is entirely push-driven: there is no synchronous get-map
-    request. A ``dpRequestDps`` causes the device to publish a ``MAP_RESPONSE``,
-    which the device's subscribe loop feeds into the map trait. Here we register
-    an update listener, send the request, and wait for a newly pushed update to
-    satisfy ``predicate``. Returns whether it did within ``timeout``.
+    A Q10 needs a saved-map ID before it can request content. The map list and
+    content have independent refresh schedules, so the list is requested only
+    when no ID is stored. The content then arrives as a later ``MAP_RESPONSE``
+    and is published through the standard trait update interface.
     """
     loop = asyncio.get_running_loop()
     updated: asyncio.Future[None] = loop.create_future()
@@ -624,8 +623,23 @@ async def _await_q10_map_push(
 
     unsub = properties.map.add_update_listener(on_update)
     try:
-        await properties.refresh()
-        await asyncio.wait_for(updated, timeout=timeout)
+        async with asyncio.timeout(timeout):
+            if properties.maps.current_map_id is None:
+                map_list_updated: asyncio.Future[None] = loop.create_future()
+
+                def on_map_list_update() -> None:
+                    if properties.maps.current_map_id is not None and not map_list_updated.done():
+                        map_list_updated.set_result(None)
+
+                unsub_maps = properties.maps.add_update_listener(on_map_list_update)
+                try:
+                    await properties.maps.refresh()
+                    if properties.maps.current_map_id is None:
+                        await map_list_updated
+                finally:
+                    unsub_maps()
+            await properties.map.refresh()
+            await updated
         return True
     except TimeoutError:
         return allow_cached_on_timeout and predicate()
@@ -706,7 +720,10 @@ async def q10_position(ctx, device_id: str, include_path: bool):
         click.echo("Feature not supported by device")
         return
     properties = device.b01_q10_properties
-    got_trace = await _await_q10_map_push(properties, lambda: bool(properties.map.path))
+    got_trace = await _await_q10_map_push(
+        properties,
+        lambda: bool(properties.map.path),
+    )
     if not got_trace:
         click.echo("No live trace available (the robot only reports position while cleaning).")
         return

roborock/data/b01_q10/b01_q10_containers.py

@@ -83,11 +83,32 @@ class Q10CleanRecord(RoborockBase):
         return None
 
 
+@dataclass
+class Q10MapInfo(RoborockBase):
+    """A saved map reported by ``dpMultiMap``.
+
+    Q10 firmware represents the map identifier as a string on the wire. The
+    value is sent back unchanged in a subsequent ``{"op": "get"}`` request.
+    """
+
+    id: str
+    name: str | None = None
+    timestamp: int | None = None
+
+
 @dataclass
 class dpMultiMap(RoborockBase):
+    """Response envelope for the Q10 ``dpMultiMap`` data point."""
+
     op: str
     result: int
-    data: list
+    data: list[Q10MapInfo] = field(default_factory=list)
+
+    @property
+    def current_map_id(self) -> str | None:
+        """Return the first saved-map identifier, if one was reported."""
+        first = next((map_info for map_info in self.data if map_info.id), None)
+        return first.id if first else None
 
 
 @dataclass

roborock/data/b01_q7/b01_q7_code_mappings.py

@@ -1,3 +1,5 @@
+from typing import Self, cast
+
 from ..code_mappings import RoborockModeEnum
 
 
@@ -15,6 +17,16 @@ class WorkStatusMapping(RoborockModeEnum):
     UPDATING = ("updating", 8)
     MOP_CLEANING = ("mop_cleaning", 9)
     MOP_AIRDRYING = ("mop_airdrying", 10)
+    WORKING_SLEEP = ("working_sleep", 11)
+    UNKNOWN = ("unknown", -1)
+
+    @classmethod
+    def from_code(cls, code: int) -> Self:
+        """Map unrecognized Q7 statuses to UNKNOWN without failing the response."""
+        try:
+            return super().from_code(code)
+        except ValueError:
+            return cast(Self, cls.UNKNOWN)
 
 
 class SCWindMapping(RoborockModeEnum):

roborock/data/code_mappings.py

@@ -72,14 +72,21 @@ class RoborockModeEnum(StrEnum):
 
     code: int
     """The integer code associated with the enum member."""
+    _display_name_: str | None
 
-    def __new__(cls, value: str, code: int) -> Self:
+    def __new__(cls, value: str, code: int, display_name: str | None = None) -> Self:
         """Creates a new enum member."""
         member = str.__new__(cls, value)
         member._value_ = value
         member.code = code
+        member._display_name_ = display_name
         return member
 
+    @property
+    def display_name(self) -> str:
+        """Return the canonical user-facing name for the mode."""
+        return self._display_name_ or self.value
+
     @classmethod
     def from_code(cls, code: int) -> Self:
         for member in cls:
@@ -149,8 +156,8 @@ class RoborockModeEnum(StrEnum):
 
     @classmethod
     def keys(cls) -> list[str]:
-        """Returns a list of all member values."""
-        return [member.value for member in cls]
+        """Returns a de-duplicated list of canonical member names."""
+        return list(dict.fromkeys(member.display_name for member in cls))
 
     def __eq__(self, other: Any) -> bool:
         if isinstance(other, str):

roborock/data/containers.py

@@ -162,13 +162,14 @@ class RoborockBase:
 
         return result
 
-    def as_dict(self) -> dict:
+    def as_dict(self, exclude: set[str] | None = None) -> dict:
+        exclude_set = exclude or set()
         return asdict(
             self,
             dict_factory=lambda _fields: {
                 _camelize(key): value.value if isinstance(value, Enum) else value
                 for (key, value) in _fields
-                if value is not None
+                if value is not None and key not in exclude_set
             },
         )
 

roborock/data/mower/__init__.py

@@ -1,3 +1,4 @@
 """Dataclasses for Roborock mower devices."""
 
+from .mower_code_mappings import *
 from .mower_containers import *

roborock/data/mower/mower_code_mappings.py

@@ -0,0 +1,72 @@
+"""Code mappings for Roborock mower devices."""
+
+from roborock.data.code_mappings import RoborockEnum
+
+
+class RoborockMowerStateCode(RoborockEnum):
+    """Detailed mower operating state reported by DPS 123."""
+
+    unknown = -999
+    idle = 0
+
+    map_initializing = 1
+    map_undocking = 2
+    map_undock_fault = 3
+    map_locating = 4
+    map_prepare_boundary = 5
+    map_prepare_island = 6
+    map_prepare_path = 7
+    map_boundary = 8
+    map_island = 9
+    map_path = 10
+    map_boundary_auto = 11
+    map_erasing = 12
+    map_save = 13
+    map_wait = 14
+    map_recoverable_fault = 15
+    map_fault = 16
+    map_emergency_stop = 17
+    map_waiting_fault = 18
+
+    mow_initializing = 51
+    mow_undocking = 52
+    mow_locating = 53
+    mow_adjust_cutter = 54
+    mow_zig_zag = 55
+    mow_edge = 56
+    mow_goto = 57
+    mow_suspend = 58
+    mow_recoverable_fault = 59
+    mow_fault = 60
+    mow_docked_rainfall = 61
+    mow_docked_do_not_disturb = 62
+    mow_docked_low_battery = 63
+    mow_wait = 64
+    mow_prepare_remote = 65
+    mow_remote = 66
+    mow_emergency_stop = 67
+    mow_docked_manual = 68
+    mow_dock_fault = 69
+    mow_remote_undocking = 70
+    mow_to_dock_initializing = 71
+    mow_to_dock_locating = 72
+    mow_to_dock_recoverable_fault = 73
+    mow_to_dock_fault = 74
+    mow_to_dock_emergency_stop = 75
+    mow_to_dock_charging = 76
+    mow_to_dock_charge_completed = 77
+
+    free = 101
+    free_initializing = 102
+    free_locating = 103
+    free_docked_manual = 104
+    free_docked_mow_end = 105
+    free_docked_plan_end = 106
+    free_emergency_stop = 107
+    free_recoverable_fault = 108
+    free_fault = 109
+
+    charge_charging = 151
+    charge_completed = 152
+    charge_waiting = 153
+    charge_fault = 154

roborock/data/mower/mower_containers.py

@@ -1,11 +1,13 @@
 """Data containers for Roborock mower devices."""
 
-from dataclasses import dataclass, field
-from typing import Any
+from dataclasses import dataclass, field, fields
+from typing import Any, Self
 
 from roborock.data.containers import RoborockBase
 from roborock.roborock_message import RoborockMowerDataProtocol
 
+from .mower_code_mappings import RoborockMowerStateCode
+
 
 @dataclass
 class MowerStatus(RoborockBase):
@@ -14,7 +16,9 @@ class MowerStatus(RoborockBase):
     error_code: int | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.ERROR_CODE})
     battery: int | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.BATTERY})
     mow_type: int | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.MOW_TYPE})
-    mow_state: int | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.MOW_STATE})
+    mow_state: RoborockMowerStateCode | None = field(
+        default=None, metadata={"dps": RoborockMowerDataProtocol.MOW_STATE}
+    )
     mapping_type: int | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.MAPPING_TYPE})
     mapping_state: int | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.MAPPING_STATE})
     ota_state: int | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.OTA_STATE})
@@ -41,3 +45,25 @@ class MowerStatus(RoborockBase):
     )
     afs_status: int | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.AFS_STATUS})
     network_channel: int | None = field(default=None, metadata={"dps": RoborockMowerDataProtocol.NETWORK_CHANNEL})
+
+    @classmethod
+    def from_dps(cls, dps: dict[int | str, Any] | None) -> Self:
+        """Create mower status from raw DPS data.
+
+        Cloud snapshots use string DPS keys while decoded MQTT messages may use
+        integer keys. Unknown and malformed keys are ignored.
+        """
+        field_by_dps = {
+            int(field_info.metadata["dps"]): field_info.name
+            for field_info in fields(cls)
+            if "dps" in field_info.metadata
+        }
+        values: dict[str, Any] = {}
+        for key, value in (dps or {}).items():
+            try:
+                dps_id = int(key)
+            except (TypeError, ValueError):
+                continue
+            if field_name := field_by_dps.get(dps_id):
+                values[field_name] = value
+        return cls.from_dict(values)

roborock/data/v1/v1_clean_modes.py

@@ -29,7 +29,7 @@ class CleanRoutes(RoborockModeEnum):
     DEEP = ("deep", 301)
     DEEP_PLUS = ("deep_plus", 303)
     FAST = ("fast", 304)
-    DEEP_PLUS_CN = ("deep_plus", 305)
+    DEEP_PLUS_CN = ("deep_plus_cn", 305, "deep_plus")
     SMART_MODE = ("smart_mode", 306)
     CUSTOMIZED = ("custom", 302)
 
@@ -118,10 +118,7 @@ def get_clean_modes(features: DeviceFeatures) -> list[VacuumModes]:
         modes.append(VacuumModes.MAX_PLUS)
     if features.is_pure_clean_mop_supported:
         # If the vacuum is capable of 'pure mop clean' aka no vacuum
-        if features.is_support_main_brush_up_down_supported:
-            modes.append(VacuumModes.OFF_RAISE_MAIN_BRUSH)
-        else:
-            modes.append(VacuumModes.OFF)
+        modes.append(VacuumModes.OFF)
     else:
         # If not, we can add gentle
         modes.append(VacuumModes.GENTLE)
@@ -134,16 +131,19 @@ def get_clean_modes(features: DeviceFeatures) -> list[VacuumModes]:
 
 def get_clean_routes(features: DeviceFeatures, region: str) -> list[CleanRoutes]:
     """The routes that the vacuum will take while mopping"""
+    if not features.is_clean_route_setting_supported:
+        return []
     if features.is_none_pure_clean_mop_with_max_plus:
         return [CleanRoutes.FAST, CleanRoutes.STANDARD]
-    supported = [CleanRoutes.STANDARD, CleanRoutes.DEEP]
+    supported = [CleanRoutes.STANDARD]
+    if not features.is_clean_efficiency_supported:
+        supported.append(CleanRoutes.DEEP)
     if features.is_careful_slow_mop_supported:
-        if not (
-            features.is_corner_clean_mode_supported
+        if (
+            not features.is_corner_clean_mode_supported
             and features.is_clean_route_deep_slow_plus_supported
             and region == "cn"
         ):
-            # for some reason there is a china specific deep plus mode
             supported.append(CleanRoutes.DEEP_PLUS_CN)
         else:
             supported.append(CleanRoutes.DEEP_PLUS)
@@ -218,17 +218,11 @@ def get_cleaning_mode_options(features: DeviceFeatures) -> list[CleaningMode]:
 
 
 def get_mop_only_vacuum_mode(features: DeviceFeatures) -> VacuumModes:
-    """Determine the vacuum mode to use when you just want to mop.
-
-    There are three cases that must be handled:
-    1. The device does not support only mopping.
-    2. The device supports raising the vacuum brush while mopping
-    3. All other cases.
-    """
+    """Return the vacuum mode used by the app for mop-only cleaning."""
     if not features.is_pure_clean_mop_supported:
         raise RoborockUnsupportedFeature("Mop-only cleaning is not supported")
-    if features.is_support_main_brush_up_down_supported:
-        return VacuumModes.OFF_RAISE_MAIN_BRUSH
+    # Main-brush lift is a device capability, not an alternate fan-power
+    # command. The app still sends CleanModeZero (105) for mop-only cleaning.
     return VacuumModes.OFF
 
 

roborock/data/zeo/zeo_code_mappings.py

@@ -1,8 +1,5 @@
 """Zeo (washing machine) device enums.
 
-Member-level comments show the manufacturer's official identifiers
-extracted from the React Native app plugin bundle.
-
 For enums that map between protocol-level positions and physical units
 (e.g. spin speed, temperature), the comment format is
 ``# L<N>, <physical-value>`` where ``L<N>`` is the protocol position
@@ -18,12 +15,7 @@ from ..code_mappings import RoborockEnum
 
 
 class ZeoFeatureBits(RoborockEnum):
-    """Bit positions in DP 237 (FEATURE_BITS).
-
-    Extracted from the official Roborock Washer app plugin bundle
-    (index.ios.bundle, module 726).  Each member's integer value
-    is the exact bit offset the device reports at DP 237.
-    """
+    """Bit positions in DP 237 (FEATURE_BITS)."""
 
     smart_hosting = 0
     silent_mode = 1
@@ -52,7 +44,7 @@ class ZeoFeatureBits(RoborockEnum):
 
 
 class ZeoMode(RoborockEnum):
-    null = 0  # (not found in app bundle)
+    null = 0
     wash = 1
     wash_and_dry = 2
     dry = 3
@@ -60,6 +52,7 @@ class ZeoMode(RoborockEnum):
 
 
 class ZeoState(RoborockEnum):
+    null = 0
     standby = 1
     weighing = 2  # Checking
     soaking = 3
@@ -83,7 +76,7 @@ class ZeoState(RoborockEnum):
 
 
 class ZeoProgram(RoborockEnum):
-    null = 0  # (not found in app bundle)
+    null = 0
     standard = 1  # Mixed
     quick = 2
     sanitize = 3  # Sterilization
@@ -152,6 +145,7 @@ class ZeoSoak(RoborockEnum):
 
 
 class ZeoTemperature(RoborockEnum):
+    null = 0
     normal = 1  # L1, 0 C
     low = 2  # L2, 30 C
     medium = 3  # L3, 40 C
@@ -203,11 +197,13 @@ class ZeoSoftenerType(RoborockEnum):
 
 
 class ZeoDetergentExpansionType(RoborockEnum):
+    null = 0
     concentrated_detergent = 1
     detergent = 2
 
 
 class ZeoSoftenerExpansionType(RoborockEnum):
+    null = 0
     softener = 1
     softener_expansion = 2
     wool_detergent = 3
@@ -241,6 +237,7 @@ class ZeoError(RoborockEnum):
 
 
 class ZeoDryingMethod(RoborockEnum):
+    null = 0
     l1 = 1  # L1, Saving
     l2 = 2  # L2, Standard
     l3 = 3  # L3, SuperFast
@@ -255,11 +252,13 @@ class ZeoSteamVolume(RoborockEnum):
 
 
 class ZeoDryAndCare(RoborockEnum):
+    null = 0
     soft = 1
     normal = 2
 
 
 class ZeoDryerStartError(RoborockEnum):
+    null = 0
     dryer_running = 1  # Washer-Dryer Pairing cannot start: Dryer is running.
     dryer_error = 2  # Washer-Dryer Pairing cannot start: Dryer has an error.
     dryer_done = 3  # Dryer drying is complete, please remove the clothes first.
@@ -269,7 +268,7 @@ class ZeoDryerStartError(RoborockEnum):
     dryer_network_fail = 7  # Please check the dryer network connection.
 
 
-# The following are App-internal lookup tables extracted from the bundle.
+# The following are App-internal lookup tables.
 # They are NOT DP protocol enums — the device never receives these values.
 # They control how the official app adjusts recommended dosages or UI visibility.
 #