Support Request: Clearer documentation on room-by-room cleaning

invent-ed commented 1 year ago

Describe Your Problem:

I don't really get how to set up room-by-room cleaning. When I initially set up the Roomba, in my Home app I saw 2 toggle buttons, both named "Roomba", one with the I/O logo and one without. When I ran cleaning for one room in the iRobot app, a new toggle button appeared, so I know for sure that is for the room I ran it for. But now the previous two toggle buttons became circular buttons? And I still don't know what the button without the I/O logo is for (see screenshot)...

Additionally, the instructions say to "then go and change the blue switch from auto (blue) to manual (grey)" (for the room toggles). It's not clear what "auto" and "manual" does... Does setting it to manual mean "when the Roomba gets turned on, do not clean that room"? Or vice versa?

Expected behavior:

Clear instructions on how to setup and use room-by-room cleaning.

Logs:

???

Config:

{
    "name": "Roomba",
    "email": "*",
    "password": "*",
    "roombas": [
        {
            "autoConfig": true,
            "info": {
                "ver": 2
            }
        }
    ],
    "manualDiscovery": false,
    "lowBattery": 20,
    "offAction": "stop:dock",
    "status": "cycle:clean",
    "eveStatus": "inverted:cycle:clean",
    "bin": "none",
    "ignoreMultiRoomBin": true,
    "hideStuckSensor": false,
    "disableMultiRoom": false,
    "platform": "iRobotPlatform"
}

Node Version:

v12.22.5

NPM Version:

7.5.2

Homebridge Version:

??

Plugin Version:

??

Operating System:

Ubuntu

goshawk2929 commented 1 year ago

It took me a few weeks to figure this out but was able to make it work.

Instructions are almost 100% accurate but leave out a few key points.

You have to do some organizing in apple HomeKit app. You have to "break apart" the irobot group into separate tiles to better organize and rename them.

right click on your irobot in home app and access accessory details. Then scroll down to "show in seperate tiles" in order to break out the room/map sliders the instructions mention.

Once have them separated, follow the instructions and start a job via irobot app for a single room. You will then see a "switch" tile show up with the same name as your irobot in home app. You can then click on that switch, and change name. It shows up in home bridge UI log, you won't see that name in home app unless you delete the name (it then shows up in gray) but rename it..
End the job, send back to home, and restart a new job (in irobot app) for every room and do same renaming process.
You should end up with multiple switches. I left the switches separated as if you tile them all into one, you lose the room names.