Homebridge Cleanmate

Cleanmate is a popular robot vacuum cleaner in Sweden. This plugin allows you to control it from HomeKit.

Right now there is no official documentation or API over how to control the robot. To develop this plugin the tcp request to and from the robot has been analyzed.

Note: This plugin has only been tested for the Cleanmate S995. Please make a Pull Request if you get it working with another model.

Features

• Fan as On-/Off-switch
  • Fanspeed controls the cleaning mode (Silent, Standard, Intense)
  • Rotate direction controls the mop mode (configurable in config)
• Pause Switch that will pause the robot when enabled and continues when disabled (optional, and can be inverted in config)
• Motion sensor that will fire if the robot has a problem (optional, and can be inverted in config)
• Occupancy sensor that will fire when the robot is docked (optional and can be inverted in config)
• Volume controll using a Lightbulb (optional)
• Per room Switch (optional, read Room cleaning to understand how it works)

Requirements

• Homebridge HomeKit support for the impatient
• Cleanmate robot The vacuumm cleaner
  • Ip address of the robot (use a static ip)
  • Authentication code for the robot (How to get the authentication code)

Instructions

Installation

This plugin can easily be installed from Homebridge UI or sudo npm install -g homebridge-cleanmate

Config

This is an accessory plugin, the configuration should be set under accessories in the config file. Multiple accessories can be added, make sure they have unique names.

Example config

{
  "bridge": {
    "name": "Homebridge",
    "username": "CC:22:3D:E3:CE:30",
    "port": 51826,
    "pin": "012-34-567"
  },
  "accessories": [
    {
      "accessory": "Cleanmate",
      "name": "Cleanmate robot",
      "ipAddress": "192.168.86.22",
      "authCode": "0123456789",
    }
  ]
}

Parameters

| Parameter | Description | Default | type | | ---------------------------- | ------------------------------------------------------------------------ | :-------: | :-----: | | accessory | always "Cleanmate" | - | String | | name | The name of the robot | - | String | | ipAddress | The ip address of the robot | - | String | | authCode | The authentication code for the robot | - | String | | pollInterval? | How often the status should be updated (in seconds) | 15 | Number | | lowBatteryPercentage? | When should the robot report low battery | 15 | Number | | clockwiseMode? | Which mop mode to use when clockwise is used | 20 (High) | Number | | counterClockwiseMode? | Which mop mode to use when counter clockwise is used | 60 (Low) | Number | | pauseSwitch?.enable | Add a switch that will pause the robot | true | Boolean | | pauseSwitch?.name | The name of the switch | Pause | String | | pauseSwitch?.inverted | Invert the switch, pause on disable | false | Boolean | | motionSensor?.enable | Add a motion sensor that triggers when the robot has a problem | false | Boolean | | motionSensor?.name | The name of the motion sensor | Problem | String | | motionSensor?.inverted | Invert the motion sensor, activate when the robot doesn't have a problem | false | Boolean | | occupancySensor?.enable? | Add a occupancy sensor that will represent if the robot is at dock | false | Boolean | | occupancySensor?.name? | The name of the occupancy sensor | Docked | String | | occupancySensor?.inverted? | Invert occupancy sensor, activate when robot is at dock | false | Number | | volume?.enable? | Add a lightbulb that allows you to control the volume of the robot | false | Boolean | | volume?.name? | The name of the lightbulb | Docked | String | | findSwitch?.enable? | Add a switch that will help you find the robot | false | Boolean | | findSwitch?.name? | The name of the switch | Docked | String | | roomTimeout? | The time to wait for a new room selection | 30 | Number | | rooms?[].id | The id of the room | | Number | | rooms?[].name | The name of the room | | String |

Mop Modes

| Mode | Key | | ------ | --- | | High | 20 | | Medium | 40 | | Low | 60 |

Room cleaning

To start the Room Clean Mode, you can enable/disable the room switches. The cleaning will start after x seconds specified as roomTimeout in config (default 30s). This is the time you have to enable/disable another room. The timeout will restart every time you make a change.

How to get the authentication code

Currenly there is no easy way to get the authentication code (please let me know if there is).

The way to obtain a authentication code is to listen to a tcp packet when your phone sends a command to the robot. Wireshark is a great program to use for listening to network traffic.