How filippabodecker/autonomous-dog-search-robot works
This is an embedded autonomous dog-search robot: the K10 coordinates LiDAR navigation, on-device dog detection, detection responses and voice-triggered mission completion, while an ESP32 relays mission reports and images to Telegram. The README documents the end-to-end subsystem behavior; the K10 firmware is only partially excerpted, and the ESP32 firmware is not sampled, so those paths and relationships rely on the README where indicated.
Main entry points: autonomous_dog_search_robot.cpp Detection Response · telegram_gateway.ino ESP32 Gateway
Components 14
K10 Firmware
- K10 Mission Loop
src/k10/autonomous_dog_search_robot.cpp - LiDAR Navigation
src/k10/autonomous_dog_search_robot.cpp
Mission Workflow
- Dog Detection
src/k10/autonomous_dog_search_robot.cpp - Detection Response
src/k10/autonomous_dog_search_robot.cpp - Voice Command
src/k10/autonomous_dog_search_robot.cpp - Mission Completion
src/k10/autonomous_dog_search_robot.cpp - Captured Images
src/k10/autonomous_dog_search_robot.cpp
Robot Hardware
- Maqueen Platform
- Treat Servo
- Display and Audio
Reporting
- ESP32 Gateway
src/esp32/telegram_gateway.ino - Telegram
Other components
- LiDAR
- Camera
Connections 19
- Camera → Dog Detection: provides frames
README.md - LiDAR → LiDAR Navigation: provides distances
README.md - K10 Mission Loop → LiDAR Navigation: starts task
src/k10/autonomous_dog_search_robot.cpp - K10 Mission Loop → Dog Detection: checks detections
src/k10/autonomous_dog_search_robot.cpp - LiDAR Navigation → Maqueen Platform: drives motors
README.md - Dog Detection → Detection Response: triggers response
README.md - Detection Response → LiDAR Navigation: pauses navigation
README.md - Detection Response → Maqueen Platform: stops and lights
README.md - Detection Response → Captured Images: captures and saves
README.md - Detection Response → Treat Servo: dispenses treat
README.md - Detection Response → Display and Audio: shows photo
README.md - Detection Response → ESP32 Gateway: sends detection event
README.md - K10 Mission Loop → Voice Command: checks command
src/k10/autonomous_dog_search_robot.cpp - Voice Command → Mission Completion: ends mission
README.md - Mission Completion → Maqueen Platform: stops robot
README.md - Mission Completion → Display and Audio: reports completion
README.md - Mission Completion → ESP32 Gateway: sends summary and images
README.md - Captured Images → ESP32 Gateway: uploads over HTTP
README.md - ESP32 Gateway → Telegram: forwards reports
README.md