taurgis/homebridge-irobot-v2

A homebridge plugin for controlling iRobot devices

homebridge-iRobot-v2

A Homebridge plugin to integrate iRobot Roombas into HomeKit.

This plugin is based on homebridge-IRobot, but since this plugin has not gotten any updates for a long time, I decided to create a new plugin based on the old one. This plugin is not compatible with the old one, so you have to remove the old plugin and install this one. The general idea for this new plugin is to make fix reported bugs and keep it up to date where necessary.

Once the latest iOS 18 update is released, I will update the plugin to support the new features (if possible).

Plugin Information

• This plugin allows you to view and control your iRobot roombas within HomeKit. The plugin:
  • downloads a device list if your iRobot credentials are supplied
  • controls your devices locally
  • listens for real-time device updates when controlled externally

Supported Devices

Don't See Your Device Below? Let Me Know If It Worked By Filling Out This Template

Model	Supported	Reported By
J7	No	spurzack
j7	No	franciswernet
j7	No	franciswernet
j7	No	VinceBab
i7	Yes	Clouder59
606	No	PvdGulik
Braava m6	Yes	taurgis
m6	Yes	ginoledesma
j7	Yes	ginoledesma
i3	yes	taurgis
980	No	jeanchrijaz
i9	Yes	douginoz
960	Yes	NateUT99
965	Yes	bloomkd46
i8	Yes	bloomkd46

Features:

• Custom UI For Viewing Devices
• On/Off Control
• Room-By-Room Control On Models That Support It (Only Tested When Using One Map)
• Auto-Dicovery Of All Devices On Your Acount
• Battery Percent/Charging ifo
• Binfull Detection In The Form Of Filter/Contact/Motion Sensor
• Stuck Sensor

TODO:

• Approved By Homebridge
• Support iOS 18 Features

Prerequisites

• To use this plugin, you will need to already have Homebridge (at least v1.3.5) or HOOBS (at least v4) installed. Refer to the links for more information and installation instructions.

Setup

• Installation
• Configuration
• Beta Version
• Node Version
• Uninstallation

Help/About

• Common Errors
• Support Request
• Changelog

Credits

• To the creators/contributors of Homebridge who make this plugin possible.
• To homebridge-Meross of which I based this readme, wiki, and homebridge-ui off of
• To homebridge-IRobot which this plugin is based off of
• To Dorita980 Who cracked the iRobot API

Disclaimer

• I am in no way affiliated with iRobot and this plugin is a personal project that I maintain in my free time.
• Use this plugin entirely at your own risk - please see licence for more information.

homebridge-irobot-v2's Issues

Supported Device: Roomba 976

Roomba Model:

976

Did It Work

No

It reads information about device from account, but can't be started or stoped or get information about sensors states

[iRobot] Logging into iRobot...
[13/07/2024, 10:42:59] [iRobot] Configuring roomba: Roomba
[13/07/2024, 10:43:00] [iRobot] Adding new accessory: Roomba
[13/07/2024, 10:43:00] [iRobot] Configured Roomba Accessory: Roomba
[13/07/2024, 10:43:30] [iRobot] Roomba Roomba went offline...
[13/07/2024, 10:43:30] [iRobot] Roomba Roomba connection closed.
[13/07/2024, 10:43:31] [iRobot] Successfully reconnected to roomba Roomba
[13/07/2024, 10:43:33] [iRobot] Starting Clean Cycle
[13/07/2024, 10:43:33] [iRobot] Room By Room: false
[13/07/2024, 10:44:01] [iRobot] Roomba Roomba connection closed.
[13/07/2024, 10:44:02] [iRobot] Successfully reconnected to roomba Roomba

HomeKit Logs flooded by irobot plugin

Describe Your Problem:

I keep receveing many messages on the log viewer on my homebridge like this:

[7/9/2024, 3:45:07 PM] [iRobot] Attempting To Reconnect To Roomba Veral
[7/9/2024, 3:45:07 PM] [iRobot] Roomba Veral went offline, disconnecting...
[7/9/2024, 3:45:07 PM] [iRobot] Roomba Veral connection closed, reconnecting in 5 seconds
[7/9/2024, 3:45:12 PM] [iRobot] Attempting To Reconnect To Roomba Veral
[7/9/2024, 3:45:12 PM] [iRobot] Roomba Veral went offline, disconnecting...
[7/9/2024, 3:45:12 PM] [iRobot] Roomba Veral connection closed, reconnecting in 5 seconds
[7/9/2024, 3:45:17 PM] [iRobot] Attempting To Reconnect To Roomba Veral
[7/9/2024, 3:45:17 PM] [iRobot] Roomba Veral went offline, disconnecting...
[7/9/2024, 3:45:17 PM] [iRobot] Roomba Veral connection closed, reconnecting in 5 seconds

Expected behavior:

No response

Logs:

[7/9/2024, 3:45:07 PM] [iRobot] Attempting To Reconnect To Roomba Veral
[7/9/2024, 3:45:07 PM] [iRobot] Roomba Veral  went offline, disconnecting...
[7/9/2024, 3:45:07 PM] [iRobot] Roomba Veral  connection closed, reconnecting in 5 seconds
[7/9/2024, 3:45:12 PM] [iRobot] Attempting To Reconnect To Roomba Veral
[7/9/2024, 3:45:12 PM] [iRobot] Roomba Veral  went offline, disconnecting...
[7/9/2024, 3:45:12 PM] [iRobot] Roomba Veral  connection closed, reconnecting in 5 seconds
[7/9/2024, 3:45:17 PM] [iRobot] Attempting To Reconnect To Roomba Veral
[7/9/2024, 3:45:17 PM] [iRobot] Roomba Veral  went offline, disconnecting...
[7/9/2024, 3:45:17 PM] [iRobot] Roomba Veral  connection closed, reconnecting in 5 seconds

Config:

{
    "name": "iRobot",
    "email": "[email protected]",
    "password": "xxx",
    "roombas": [
        {
            "autoConfig": true,
            "info": {
                "ver": 2
            }
        }
    ],
    "manualDiscovery": false,
    "lowBattery": 20,
    "offAction": "pause:dock",
    "status": "cycle:clean",
    "eveStatus": "inverted:cycle:clean",
    "bin": "filter:contact",
    "ignoreMultiRoomBin": true,
    "hideStuckSensor": false,
    "disableMultiRoom": false,
    "platform": "iRobotPlatform"
}

Node Version:

20.9.0

NPM Version:

10.1.0

Homebridge Version:

1.8.3

Plugin Version:

3.0.1

Operating System:

Other