Skip to content

Commit cf4bb78

Browse files
authored
Update README.md
1 parent 05e04bb commit cf4bb78

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

README.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,32 @@
22

33
[![Type](https://img.shields.io/badge/Type-Custom_Component-orange.svg)](https://github.com/dlarrick/hass-kumo) [![hacs_badge](https://img.shields.io/badge/HACS-Default-orange.svg)](https://github.com/custom-components/hacs)
44

5+
> [!CAUTION]
6+
> ## New Mitsubish Comfort app breakage
7+
>
8+
> **TL;DR: Mitsubishi has changed their cloud components. DO NOT uninstall/reinstall or reconfigure the Kumo integration or you will lose access.**
9+
>
10+
> Adapting to these changes is a goal, but PyKumo / Hass-Kumo is a side / weekend project for the primary maintainer. Assistance greatly appreciated! Leave a comment in [#189](https://github.com/dlarrick/hass-kumo/issues/189) if you're able & willing to help.
11+
>
12+
> ### Summary
13+
> - Mitsubishi rolled out a new Kumo app and corresponding server-side cloud infrastructure. It appears there's a new firmware version for the indoor unit WiFi adapters as well. This rollout did not go well for them.
14+
> - The new server-side cloud infrastructure has broken pykumo's ability to retrieve the information needed to achieve access to the indoor units' local API that PyKumo depends on.
15+
> - The rollout de-stabilized the whole Kumo ecosystem, causing interruption of even local access for indoor units that encountered errors talking to the cloud. (This issue may have existed previously but was made worse by the upgrade.)
16+
> - Early indications are that the local indoor unit API has not changed substantially and still works OK for those who waited out the storm.
17+
>
18+
> ### Unknowns
19+
> - Does switching to the new Mitsubishi iOS and/or Android app cause the indoor units to lose compatibility with PyKumo / Hass-Kumo? (I think the answer is "no" but have not confirmed).
20+
> - Can we continue to get access tokens etc. from the new Kumo Cloud service?
21+
> - Are there minor changes to the local API that we need to accommodate?
22+
> - Are there changes to the local API that we can take advantage of?
23+
>
24+
> ### Plan
25+
> - Verify if PyKumo's cloud account/login is fully broken, or just needs adjustment
26+
> - Snoop/capture a login session from the new app (likely needs standard iOS / Android man-in-the-middle traffic capture unless there's a new web app)
27+
> - Use this to restore cloud account/login to PyKumo
28+
> - Snoop/capture local communication from the new app to an indoor unit and compare to what PyKumo does
29+
30+
## Home Assistant component
531
Mitubishi Kumo Cloud (Kumo for short) is a custom component for Home Assistant that allows you to control Mitsubishi mini-split units that are connected to the Mitsubishi KumoCloud service.
632

733
- For US (North American) market mini-splits with a KumoCloud WiFi interface (for example, PAC-USWHS002-WF-2).

0 commit comments

Comments
 (0)