{"id":22004798,"url":"https://github.com/cybrox/wroomba","last_synced_at":"2025-05-05T17:33:44.184Z","repository":{"id":73481365,"uuid":"85927468","full_name":"cybrox/wroomba","owner":"cybrox","description":"ESP32 (w)roomba project","archived":false,"fork":false,"pushed_at":"2017-03-28T07:07:44.000Z","size":31,"stargazers_count":14,"open_issues_count":1,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-05-05T17:32:49.111Z","etag":null,"topics":["c","esp32","espressif","irobot","irobot-roomba","roomba"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cybrox.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,"zenodo":null}},"created_at":"2017-03-23T08:53:08.000Z","updated_at":"2025-04-26T10:12:22.000Z","dependencies_parsed_at":null,"dependency_job_id":"8b269baa-cfac-4cfd-b60b-8eee80dacdfd","html_url":"https://github.com/cybrox/wroomba","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybrox%2Fwroomba","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybrox%2Fwroomba/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybrox%2Fwroomba/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cybrox%2Fwroomba/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cybrox","download_url":"https://codeload.github.com/cybrox/wroomba/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252542615,"owners_count":21764998,"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","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":["c","esp32","espressif","irobot","irobot-roomba","roomba"],"created_at":"2024-11-30T00:17:15.199Z","updated_at":"2025-05-05T17:33:44.178Z","avatar_url":"https://github.com/cybrox.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WROOMBA!\niRobot Roombas are great for cleaning. - But pretty damn expensive. Especially the higher-tier models that actually support scheduling or remote control are not exactly cheap. The main goal of this project is to modify my Roomba 560 and add scheduled cleaning myself.    \nMaybe this will go further...\n\n### Hardware\nThe project hardware is dead simple. Roomba exposes an open interface at the top (Roomba Open Interface) which is a 7-pin Mini-DIN pug. (If you're like me and don't have those lying around, you can also use a 6-PS2 plug, since the roomba interface has 2 Vpp and 2 GND lines one of which is conveniently placed where the PS2 plug has a missing pin).\n\nOther than that, you will need:\n- An Espressif ESP32 development board\n- A little circuit to get 3.3V from roomba's ~20V battery\n\n### Software\nThe software is a standard ESP32 project. Check out [their docs](http://esp-idf.readthedocs.io/en/v1.0/) for more information.\n\n### Usage\nSince for my application, the actual scheduling of tasks is done on a central device. Wroomba merely needs to add an API between that scheduler and the Roomba Open Interface. This Software exposes a very simple HTTP API with the following endpoints:\n- `GET /info` Returns \"wroomba!\"\n- `POST /clean` Sends `start` + `clean` command to roomba\n\nIf you want to use this, please remember to change the WiFi login credentials in `secret/wifi.h`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybrox%2Fwroomba","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcybrox%2Fwroomba","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcybrox%2Fwroomba/lists"}