How beebotv2/bee_bot_v2 works
Bee bot V2 is a ROS 2 mobile-manipulation robot stack, with Isaac-based reinforcement-learning environments and a host-side simulator/operator interface. A principal documented workflow is mission commands entering the mission manager, which sends execution plans to the coordinator; the manager also consumes perception signals and tracked objects. The repository tree shows broader perception, navigation, skills, hardware, and mapping capabilities. Several are unsampled, so their internal links are omitted; the README provides no additional architecture detail.
Main entry points: slot_env.py Slot environment · mission_manager.cpp Mission manager · operator_tool.py Operator CLI · common.py Isaac shared models
Components 19
Mission execution
- Mission manager
lv2_module6/ros2_ws/src/plan/src/mission_manager.cpp - Mission solver
lv2_module6/ros2_ws/src/plan/include/plan/mission_solver.hpp - Plan coordinator
lv2_module6/ros2_ws/src/plan/src/coordinator.cpp - Robot skills
lv2_module6/ros2_ws/src/skills
Robot runtime
- Perception
lv2_module6/ros2_ws/src/perception - State manager
lv2_module6/ros2_ws/src/manager/src/state_manager.cpp - Hardware control
lv2_module6/ros2_ws/src/control - RL navigation
lv2_module6/ros2_ws/src/ml/src/rl_nav_controller.cpp - Mapping and SLAM
lv2_module6/ros2_ws/src/ros_system
Learning and simulation
- Isaac shared models
lv2_module6/isaac/rl/bee_isaac/common.py - Pick environment
lv2_module6/isaac/rl/bee_isaac/tasks/pick_env.py - Place environment
lv2_module6/isaac/rl/bee_isaac/tasks/place_env.py - Slot environment
lv2_module6/isaac/rl/bee_isaac/tasks/slot_env.py - Host simulator
lv2_module6/tools/cli/ros/docker/vazebo/main.py
Operator tooling
- Operator CLI
lv2_module6/tools/cli/operator_tool.py - CLI bus commands
lv2_module6/tools/cli/op/bus.py - Topic monitor
lv2_module6/ros2_ws/src/faker/src/monitor_manager.cpp - Topic input
lv2_module6/ros2_ws/src/faker/src/input_manager.cpp
Other components
- Mission command
Connections 14
- Mission command → Mission manager: commands
- Mission manager → Plan coordinator: sends plans
- Mission manager → Mission solver: parses starts
- Pick environment → Isaac shared models: imports
lv2_module6/isaac/rl/bee_isaac/tasks/pick_env.py - Place environment → Isaac shared models: imports
lv2_module6/isaac/rl/bee_isaac/tasks/place_env.py - Slot environment → Isaac shared models: imports
lv2_module6/isaac/rl/bee_isaac/tasks/slot_env.py - Slot environment → Pick environment: imports
lv2_module6/isaac/rl/bee_isaac/tasks/slot_env.py - Slot environment → Place environment: imports
lv2_module6/isaac/rl/bee_isaac/tasks/slot_env.py - Host simulator → Topic monitor: reads debug files
lv2_module6/tools/cli/ros/docker/vazebo/main.py - Topic input → Host simulator: reads input files
- Operator CLI → CLI bus commands: loads fake bus
lv2_module6/tools/cli/operator_tool.py - Operator CLI → State manager: subscribes state
lv2_module6/tools/cli/operator_tool.py - Topic monitor → Operator CLI: writes debug output
- Topic input → State manager: publishes topic input