{"id":15406372,"url":"https://github.com/otherguy/roomba-wifi","last_synced_at":"2025-10-11T07:30:31.049Z","repository":{"id":98594863,"uuid":"90606956","full_name":"otherguy/roomba-wifi","owner":"otherguy","description":"Connect a Roomba® 580 to the Cloud with a Particle Photon","archived":true,"fork":false,"pushed_at":"2020-04-11T16:58:41.000Z","size":1978,"stargazers_count":12,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-28T17:38:47.205Z","etag":null,"topics":["iot","irobot","irobot-roomba","particle-cloud","particle-photon","roomba","roomba581"],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/otherguy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-05-08T08:55:29.000Z","updated_at":"2024-02-04T10:13:58.000Z","dependencies_parsed_at":"2023-04-10T14:33:00.373Z","dependency_job_id":null,"html_url":"https://github.com/otherguy/roomba-wifi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/otherguy/roomba-wifi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otherguy%2Froomba-wifi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otherguy%2Froomba-wifi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otherguy%2Froomba-wifi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otherguy%2Froomba-wifi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/otherguy","download_url":"https://codeload.github.com/otherguy/roomba-wifi/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/otherguy%2Froomba-wifi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279006618,"owners_count":26084131,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["iot","irobot","irobot-roomba","particle-cloud","particle-photon","roomba","roomba581"],"created_at":"2024-10-01T16:21:38.095Z","updated_at":"2025-10-11T07:30:31.044Z","avatar_url":"https://github.com/otherguy.png","language":"CSS","funding_links":["https://www.paypal.me/basecamptirol"],"categories":[],"sub_categories":[],"readme":"[![Maintained: yes](https://img.shields.io/maintenance/yes/2019.svg?style=flat-square)](https://roomba-wifi.basecamp.tirol)\n[![License: MIT](https://img.shields.io/github/license/otherguy/roomba-wifi.svg?style=flat-square)](https://github.com/otherguy/roomba-wifi/blob/master/LICENSE.md)\n[![Issues](https://img.shields.io/github/issues/otherguy/roomba-wifi.svg?style=flat-square)](https://github.com/otherguy/roomba-wifi/issues)\n\n\n# Cloud Connected Roomba 5xx\n\nConnect a Roomba 581 to the Cloud with a [Particle Photon](https://www.particle.io/products/hardware/photon-wifi-dev-kit).\n\n## Donate\n\nMaking a donation is an act of generosity. Your support, however modest it might be, help to continue to support and improve this project!\n\nYour queries will be given the highest priority, and you will be credited in the source code as a generous donor.\n\n- \u003cimg src=\"assets/img/paypal.svg\" alt=\"PayPal\" width=\"16\" height=\"16\"\u003e Paypal: [Donate](https://www.paypal.me/basecamptirol)\n- \u003cimg src=\"assets/img/flattr.svg\" alt=\"Flattr\" width=\"16\" height=\"16\"\u003e Flattr: [Donate](https://flattr.com/@basecamp.tirol)\n- \u003cimg src=\"assets/img/bitcoin.svg\" alt=\"BitCoin\" width=\"16\" height=\"16\"\u003e Bitcoin: `1Kz88Erut22xptZP8vW6tm5ZH2pFWv9i4L`\n- \u003cimg src=\"assets/img/litecoin.svg\" alt=\"Litecoin\" width=\"16\" height=\"16\"\u003e Litecoin: `LNKP4XvL9mj33HHpFvLxEAWUckAV7FHs9s`\n- \u003cimg src=\"assets/img/ethereum.svg\" alt=\"Ethereum\" width=\"16\" height=\"16\"\u003e Ethereum: `0x9Bf203BE312c8FFD8967bD908C292e3b26B3b94f`\n\n## Prerequisites\n\n### Roomba\n\nObviously, a Roomba is required. I used a Roomba 581, which is part of the [Roomba 500 Series](http://www.irobot.com/For-the-Home/Support/Product-Resources/Roomba-500-Resources.aspx) but it should work with any Roomba with a SCI Mini-DIN 7 port that supports the Open Interface (OI).\n\nThe new [Roomba 900 Series](http://www.irobot.com/For-the-Home/Support/Product-Resources/Roomba-900-Resources.aspx) does no longer have an SCI Mini-DIN 7 port.\n\n### Microcontrollers\n\nThis should work with any of the below mentioned Wi-Fi connected microcontollers although it has onlry been tested with the [Particle Photon](https://www.particle.io/products/hardware/photon-wifi-dev-kit) and with its -- now discontinued -- predecessor, the [Spark Core](https://docs.particle.io/datasheets/core-datasheet/).\n\n#### [Particle Photon](https://www.particle.io/products/hardware/photon-wifi-dev-kit)\n\nThe [Particle Photon](https://www.particle.io/products/hardware/photon-wifi-dev-kit) as well as any variations like the P0 or P1) or its -- now discontinued -- predecessor, [Spark Core](https://docs.particle.io/datasheets/core-datasheet/) or other [Particle Cloud](https://www.particle.io/products/platform/particle-cloud)-connected devices like the [RedBear Duo](https://redbear.cc/duo/) are the recommended microcontrollers. The code here is written for them. Of course it also works with the [Particle Electron](https://www.particle.io/products/hardware/electron-cellular-dev-kit) in the unlikely case that you want 2G/3G connectivity for your Roomba.\n\nMake sure that your microcontroller has the latest firmware. [Here is a guide](https://docs.particle.io/support/troubleshooting/firmware-upgrades/photon/) on how to update the firmware for the Particle Photon.\n\n#### [Adafruit Feather M0 WiFi](https://www.adafruit.com/product/3010) or [Adafruit Feather HUZZAH](https://www.adafruit.com/product/2821)\n\nSince the Feather M0 and the HUZZAH are Arduino compatible, the code should also work with only minor adaptions.\n\n#### Raw ESP8266 Board\n\nSame goes for a raw ESP8266 WiFi microcontroller board, although personally my experience with these is very limited. I always appreciate feedback or pull-requests!\n\n## Hardware Build\n\n### Roomba Mini-DIN 7\n\nMost Roombas, up to the new [Roomba 900 Series](http://www.irobot.com/For-the-Home/Support/Product-Resources/Roomba-900-Resources.aspx) does no longer have an SCI Mini-DIN 7 port with serial `RX`/`TX` pins that can be used to communicate with Roomba over the [OI](#open-interface).\n\nThis connector provides two-way, serial communication at TTL (`0V` – `5V`) levels. The connector also provides an unregulated direct connection to Roomba’s battery, which you can use to power the OI applications. The Mini-DIN connector is located on the top of Roomba, beneath the snap-on decorative cover.\n\n| Pin | Name   | Description                                        |\n|-----|--------|----------------------------------------------------|\n| `1` | `Vpwr` | Roomba battery `+` (unregulated `15.5V` – `18V`)   |\n| `2` | `Vpwr` |                                                    |\n| `3` | `RXD`  | `0V` – `5V` Serial Input to Roomba                 |\n| `4` | `TXD`  | `0V` – `5V` Serial Output from Roomba              |\n| `5` | `DD`   | Device Detect Input (active low) \u003csup\u003e1\u003c/sup\u003e      |\n| `6` | `GND`  | Roomba battery ground                              |\n| `7` | `GND`  |                                                    |\n\n\u003csup\u003e1\u003c/sup\u003e The `DD` pin is used to wake Roomba from sleep. See [Caveats and Issues](#caveats-and-issues) if this does not work for your Roomba.\n\n### Open Interface\n\niRobot® has provided a great specification document for the Open Interface: [iRobot® Roomba 500 Open Interface (OI) Specification](doc/iRobot_Roomba_500_Open_Interface_Spec.pdf)\n\nIt's a good starting point to understand the connections to the microcontroller and how to send commands to Roomba.\n\n### Breadboard Setup\n\n[Fritzing Source](src/breadboard.fzz)\n\n[![Breadboard](img/breadboard.png)](src/breadboard.fzz)\n\n## Caveats and Issues\n\n### Roomba does not wake up from sleep\n\nFor Roomba models that have no wake up input on pin 5 of the external connector, you can connect the Particle Photon to the clean button input and control this from the microcontroller. The code needs to be changed for this to work.\n\nConnect the Particle Photon's `D0` pin to the Roomba's *Clean* button through an 8K Ω resistor.\n\n![Roomba Clean Button](img/clean-button.png)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fotherguy%2Froomba-wifi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fotherguy%2Froomba-wifi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fotherguy%2Froomba-wifi/lists"}