2026-11-16 23:22:43 -05:00
2026-04-18 19:11:26 -04:00
2026-11-16 23:22:43 -05:00
2026-11-16 23:22:43 -05:00
2026-10-19 01:38:10 -04:00
2026-09-30 21:03:06 -04:00
2026-02-11 02:32:38 -05:00
2026-11-16 23:22:43 -05:00
2026-11-16 23:08:30 -05:00
2026-11-16 23:08:30 -05:00
2026-11-06 23:24:24 -05:00
2026-10-08 00:11:32 -04:00
2026-11-16 23:22:43 -05:00
2026-11-13 16:59:14 -05:00

Multi Roomba Rover

A system for controlling create 2 compatible roombas through a webpage.

You can explore my basement through this project here: https://rover.otter.land

some of this code was created with help from large language models, and some of it was written by me. This project would not have been possible for me to create without it.

This guide is a work in progress, it will cover:

  • Building rovers
  • Installing roverd on a Debian-based rover computer
  • Setting up the server
  • Configuration

Building a rover

You WILL need some common hobby electronics knowledge to build one of these, I will not be making a super detailed wiring or assembly guide, some of building your rover will be up to you, things such as a protective cage, camera and electronics mounting will not be covered in any great detail.

Parts per rover

This parts list describes my Pi/AIY build. Roverd also supports other Linux hosts and configurable camera/audio devices.

Part Notes
Create 2 compatible Roomba with the mini DIN port Tested only with 600 series Roombas, your mileage may vary with newer models
4S li-ion -> 5v Voltage regulator I use cheapo 12-24v USB car chargers, tear them apart, and solder wires onto them
7 pin mini DIN cable Adafruit sells these labeled as a cable specifically for the iRobot Create 2
Logic level shifter I use ones from adafruit, the Roomba is 5v logic and the pi is 3.3v logic
Google voice AIY hat v1 This serves three purposes: speaker, microphone, and a high current LED driver. None of these things are required to make a rover with a camera that can drive around, but it makes it much more fun. The design of this hat also makes it very easy to connect all of the various wires to all the IO on the pi that they need to go to.
Raspberry pi zero 2 W This will run roverd to control the rover and manage some Roomba safety things locally. You can probably use any pi you want, but these are usually the cheapest.
A good wifi adapter Has to work with Linux 6.12 (I use ones with the MT7921AU chipset and they work great), ideally wifi 6 with MU-MIMO if you are running multiple rovers on one AP. The built in wifi on the pi zero 2 W is NOT good enough for this.
A USB hub hat (if using a pi zero) If you are using a raspberry pi zero, you will want a USB hub hat for your wifi adapter, I would not recommend using an OTG adapter as it may not provide enough power.
----CAMERA STUFF---- ----Below here is all camera related things that youll need----
A compatible camera Select the rpicam profile for a Raspberry Pi CSI camera or V4L2 for a USB camera. Custom profiles can use other capture/encoder commands.
Cheap 5v servo Unless you have a VERY wide camera lens, you will want to have a servo plugged into the pi to be able to tilt the camera up and down.
LED for toggling the headlight I use white LEDs attached to one of the "driver" pins on the AIY hat to trick one of those generic pi camera LED floodlights into turning on / off on demand.
Optional laser pointer A laser pointer can be wired to another high-current-capable GPIO driver, with GPIO 27 used by default in the rover config.
Pi zero camera cable The pi zero has a smaller version of the camera ribbon connector, you will need the right cable for your camera

I do not have any exact numbers, but with cheap used Roombas it seems like on average one of my rovers takes about $100 USD to build from scratch.

Physical assembly of the rover

This is going to be the very loose section of this guide, the way yout build your rover is up to you. I have mine built out with durable protective metal cages as they are open to the internet and people like breaking things. The electronics on top of the roomba can be as simple as a pi, level shifter, and a camera if you just want to run it around yourself, things like a speaker, microphone, servo, headlight, laser pointer, are all totally optional and can be disabled in the configuration on the raspberry pi.

These are the basics of how evertything is connected on my rovers, this is hard to organize and illustrate through text but hopefully it will give you a good idea:

  1. 7 pin mini DIN cable
    1. Voltage regulator on the two pairs of VBAT wires
      1. 5v output of voltage regulator connected to the power input on the AIY hat
    2. level shifter's high voltage side attached to 5v from regulator, ground, TX, RX, and BRC from the DIN cable
  2. Level shifter low voltage side connected to 3.3v from the pi, with serial TX and RX, and the BRC pin on their respective low side level shifter lines. BRC pin goes to GPIO 4 on the pi.
  3. Google voice AIY hat:
    1. speaker
    2. microphone
    3. servo motor on GPIO pin 26
  4. Camera stuff:
    1. ov5647 camera
    2. full size to pi zero style camera ribbon cable, plug camera into pi
    3. an LED connected to a high current driver output on the AIY hat, GPIO 22 by default. This is meant to be poked into the LDR sensor on a pi camera IR floodlight to make it toggleable by the driver.
    4. optionally, a laser pointer connected to another high current driver output, GPIO 27 by default.

Software on your rover

Roverd targets Debian-based systems with ARMv6, ARMv7, ARM64, or AMD64 binaries. For the existing AIY Voice HAT rover, use Raspberry Pi OS Bookworm; that hardware setup has not been verified on Trixie.

Download rover/bootstrap.sh onto the rover and run sudo bash bootstrap.sh. It asks only for the rover name and the full server WebSocket address, creates the managed checkout at /opt/roverd, installs the matching binary from the repository, and starts roverd.

Configure audio devices, media profiles, and optional Pi GPIO through Fleet Management. Media and native Pi GPIO are disabled by default. Updates use the same installer and restart the service without rebooting the host. See installation and updates.

Roverd supervises the selected streamer commands itself. Disable/remove any previously installed streamer services before starting it. The AIY profiles may request a one-time reboot to activate their boot overlay. See media profiles and audio routing for configuration and deployment checks.

Configuration is now a complete JSON object. See roverd management for schema/default export, local validation, the management API, and deployment checks.

The roverd rework is in progress; see the implementation tracker. Native GPIO now lives under piGpio, with its parent enabled switch disabled by default. Enable that switch only on hosts using the internal Pi GPIO peripheral, and configure its camera servo, headlight, laser, and BRC children there. See hardware configuration notes for the existing AIY Voice HAT setup and pin constraints.

Build rover binaries with make -C rover/roverd all, or select one architecture with make -C rover/roverd build ARCH=armv6 (also armv7, arm64, or amd64). Artifacts are dist/roverd-linux-<architecture> and remain in the repository. These builds share the same configuration and peripheral support; there is no laptop-specific build.

Setting up the server

S
Description
No description provided
Readme
299 MiB
Languages
JavaScript 92.9%
Go 2.8%
C++ 1.5%
Python 1.3%
Shell 0.9%
Other 0.5%