Add freeClean support for newer robots

[JBG-brad]

Summary

Newer robots like the DEEBOT X11 OmniCyclone and X9 PRO OMNI use the freeClean clean type instead of spotArea for room cleaning via clean_V2. Without this change, room cleaning commands fail with error 20011 "unknown type".

• Adds FREE_CLEAN value to the CleanMode enum
• Adds CleanAreaFreeClean command class that sends {"type": "freeClean", "value": "<cleanings>,<room_ids>"}
• Updates the huhcip (ilt3k8) hardware definition to use CleanAreaFreeClean
• Adds test cases for the new command class

Follow-up to #1457.

Testing

Tested on a DEEBOT X11 OmniCyclone — room cleaning commands now work correctly via Home Assistant.

Edit:

Misunderstanding how the hardware definitions work; I assumed the X9 PRO OMNI was the same as the X11. A new PR is coming to define the X11 OmniCyclone.

[edenhaus]

Is freeClean just used for Area/Room cleaning or also for other things?

[JBG-brad]

Is freeClean just used for Area/Room cleaning or also for other things?

As best as I can tell it's just the for area cleaning.

Theres some nonsensical (I haven't deciphered it yet) data associated with freeClean that I think is to send the robot to clean only a carpet in the room.

[shmuelzon]

Hey @JBG-brad, I was just looking into this since HA added the clean_area action and I see the same is also true for my X9 Pro (lwmdoj) but I believe it'll be the same for the X9 Omni too (ilt3k8).
Is there a reason why you reverted the change that fixed this functionality there too and opted to create a new file for the X11? If it's just that you didn't know if it's relevant for those model then I can confirm that it is.

My app sends the same clean_V2 when cleaning two rooms (where the room IDs are 15 and 12) with:

{
    "data": {
        "act": "start",
        "content": {
            "type": "freeClean",
            "value": "1,15;1,12"
        }
    }
}

The only thing that doesn't seem to match from your PR is the value. Where you wrote:

"value": f"{cleanings},{','.join(str(int(i)) for i in area)}",

I would have expected something like the following:

"value": ";".join(f"{cleanings},{int(i)}" for i in area),

(Not even sure what the cleanings/1 value really is)

[edenhaus]

Please merge this command into the clean area above as the only difference is, how the value is specified.
So create a if statement to change it in case of free clean