How gigi74168/openrobots works
Aérobot is a local Roomba-control system: an ESPHome device speaks the Roomba Open Interface, exposes robot state and controls to Home Assistant, and Home Assistant provides vacuum controls, scheduling, notifications, and a joystick. A separate AppDaemon mapper turns pose and collision data into a persisted occupancy map and publishes it through MQTT. The README says the firmware and integrations have not been verified on hardware; edges reflect documented flows and the shown mapper calls, not an inspected end-to-end deployment.
Main entry points: roomba_oi.cpp Roomba OI component · roomba_map.py Mapper app · dashboard.yaml HA dashboard · roomba.yaml ESPHome configuration
Components 15
Robot interface
- ESPHome configuration
firmware/roomba.yaml - Roomba OI component
firmware/components/roomba_oi/roomba_oi.cpp - ESPHome component setup
firmware/components/roomba_oi/__init__.py - Roomba 696
Home Assistant
- HA dashboard
ha/dashboard.yaml - Joystick card
ha/www/aerobot-joystick-card.js - Vacuum and automations
ha/aerobot_package.yaml - Home Assistant
- Map image and stats
ha/aerobot_package.yaml
Room mapping
- Mapper app
mapper/appdaemon/roomba_map.py - Occupancy map
mapper/mapper_core.py - Saved map state
mapper/appdaemon/roomba_map.py - MQTT broker
Physical hardware
- MPU6050 gyroscope
Other components
- Home user
Connections 19
- Home user → HA dashboard: uses
README.md - HA dashboard → Joystick card: hosts
README.md - HA dashboard → Vacuum and automations: offers controls
README.md - Vacuum and automations → Home Assistant: configures
README.md - Joystick card → Home Assistant: calls services
ha/www/aerobot-joystick-card.js - Home Assistant → ESPHome configuration: sends controls
README.md - ESPHome configuration → ESPHome component setup: configures
- ESPHome component setup → Roomba OI component: registers
firmware/components/roomba_oi/__init__.py - Roomba OI component → Roomba 696: serial commands
README.md - Roomba 696 → Roomba OI component: sensor stream
README.md - MPU6050 gyroscope → Roomba OI component: feeds heading
README.md - Roomba OI component → Home Assistant: publishes state
README.md - Home Assistant → Mapper app: provides pose and collisions
README.md - Mapper app → Occupancy map: updates and renders
mapper/appdaemon/roomba_map.py - Mapper app → Saved map state: loads and saves
mapper/appdaemon/roomba_map.py - Mapper app → MQTT broker: publishes PNG and stats
mapper/appdaemon/roomba_map.py - MQTT broker → Home Assistant: delivers map
README.md - Home Assistant → Map image and stats: exposes map
README.md - Map image and stats → HA dashboard: appears on
README.md