How nmt-wildlife-monitoring-project/wall-e works
WALL-E is a wildlife-monitoring robot system with ROS 2 drivers, GPS waypoint navigation, and a browser control panel. The principal workflow is sensor and motor bringup, localization and waypoint navigation, then operator monitoring or teleoperation through the web UI. The README documents the system-level launch capabilities; sampled source confirms parts of the LiDAR and web paths. Several ROS package internals were not sampled, so subsystem links are limited to documented relationships.
Main entry points: App.tsx Dashboard UI · robot_launch.py Robot bringup · rosbridge.ts Frontend ROS client · main.py Web API
Components 28
Sensing
- Robot bringup
ros2_ws/src/robot_bringup/launch/robot_launch.py - IMU driver
ros2_ws/src/bno085_driver/bno085_driver/bno085_node.py - GPS driver
ros2_ws/src/nmea_navsat_driver/src/libnmea_navsat_driver/nodes/nmea_tcpclient_driver.py - LiDAR driver
ros2_ws/src/sllidar_ros2/src/sllidar_node.cpp - LiDAR SDK
ros2_ws/src/sllidar_ros2/sdk/src/sl_lidar_driver.cpp - Scan decoding
ros2_ws/src/sllidar_ros2/sdk/src/dataunpacker/unpacker/handler_capsules.cpp
Motion Control
- RoboClaw driver
ros2_ws/src/roboclaw_driver/roboclaw_driver/roboclaw_node.py
Navigation
- Navigation launch
ros2_ws/src/robot_navigation/launch/gps_waypoint_follower.launch.py - GPS localization
ros2_ws/src/robot_navigation/launch/dual_ekf_navsat.launch.py - Waypoint follower
ros2_ws/src/waypoint_server/waypoint_server/waypoint_follower_node.py - GPS waypoint handler
ros2_ws/src/waypoint_server/waypoint_server/gps_waypoint_handler_node.py - Scan matcher
ros2_ws/src/scan_matcher/scan_matcher/scan_matcher_node.py
Web Control
- Dashboard UI
web_app/frontend/src/App.tsx - Joystick control
web_app/frontend/src/components/JoystickControl.tsx - Map panels
web_app/frontend/src/components/GoogleMapsPanel.tsx - Costmap viewer
web_app/frontend/src/components/CostmapViewer.tsx - Robot statistics
web_app/frontend/src/components/StatsPanel.tsx - Camera feed
web_app/frontend/src/components/CameraFeed.tsx - Frontend ROS client
web_app/frontend/src/services/rosbridge.ts - Web API
web_app/backend/main.py - Robot endpoints
web_app/backend/routers/robot.py - Waypoint endpoints
web_app/backend/routers/waypoints.py - Camera endpoint
web_app/backend/routers/camera.py - Backend ROS client
web_app/backend/services/rosbridge_client.py
Other components
- Robot operator
- ROSBridge
- ROS 2 runtime
- USB camera
Connections 36
- Robot operator → Robot bringup: starts sensors
README.md - Robot bringup → RoboClaw driver: launches
README.md - Robot bringup → LiDAR driver: launches
README.md - Robot bringup → IMU driver: launches
README.md - Robot bringup → GPS driver: launches
README.md - LiDAR driver → LiDAR SDK: uses SDK
- LiDAR SDK → Scan decoding: decodes samples
ros2_ws/src/sllidar_ros2/sdk/src/sl_lidar_driver.cpp - GPS driver → ROS 2 runtime: publishes fix
README.md - IMU driver → ROS 2 runtime: publishes IMU
README.md - LiDAR driver → ROS 2 runtime: publishes scans
README.md - Navigation launch → Robot bringup: starts bringup
README.md - Navigation launch → GPS localization: launches EKF
README.md - Navigation launch → Waypoint follower: launches follower
README.md - Navigation launch → ROS 2 runtime: launches Nav2
README.md - GPS waypoint handler → Waypoint follower: handles waypoints
- Robot operator → Dashboard UI: opens dashboard
web_app/frontend/src/App.tsx - Dashboard UI → Joystick control: renders
web_app/frontend/src/App.tsx - Dashboard UI → Map panels: renders
web_app/frontend/src/App.tsx - Dashboard UI → Costmap viewer: renders
web_app/frontend/src/App.tsx - Dashboard UI → Robot statistics: renders
web_app/frontend/src/App.tsx - Dashboard UI → Camera feed: renders
web_app/frontend/src/App.tsx - Dashboard UI → Frontend ROS client: connects through
web_app/frontend/src/App.tsx - Joystick control → Frontend ROS client: sends velocity
web_app/frontend/src/components/JoystickControl.tsx - Map panels → Frontend ROS client: reads map data
web_app/frontend/src/components/GoogleMapsPanel.tsx - Costmap viewer → Frontend ROS client: reads costmap
web_app/frontend/src/components/CostmapViewer.tsx - Robot statistics → Frontend ROS client: reads telemetry
web_app/frontend/src/components/StatsPanel.tsx - Frontend ROS client → ROSBridge: exchanges ROS data
web_app/frontend/src/services/rosbridge.ts - Robot operator → Web API: uses REST API
- Web API → Robot endpoints: registers router
web_app/backend/main.py - Web API → Waypoint endpoints: registers router
web_app/backend/main.py - Web API → Camera endpoint: registers router
web_app/backend/main.py - Web API → Backend ROS client: initializes client
web_app/backend/main.py - Robot endpoints → Backend ROS client: issues robot calls
web_app/backend/routers/robot.py - Backend ROS client → ROSBridge: connects by WebSocket
web_app/backend/services/rosbridge_client.py - Camera feed → Camera endpoint: requests stream
- Camera endpoint → USB camera: streams frames