ABC Swarm is the developer manual for ROS2GO, Tianbot Mini and RoboMaster TT ROS Swarm Kit.
本分支从 origin/main 重新整理,保留原课程的文件布局和命令。
nodes/ 保留原九个教学脚本,并集中放置新增可执行节点,
不另设 scripts 入口目录。原 launch/includes/ 不变,配置文件保持一层。
- 原课程:继续按视频操作,原有无动捕实车和 Gazebo demo 不新增、不搬迁。
- 新增动捕实验:进入
launch/mocap/,文件统一使用demo_mocap_*命名。 - 公共启动片段:新增部分放在
launch/common/,与原 includes 分开。
加载已有 Noetic 工作区,更新后编译一次:
source /opt/ros/noetic/setup.bash
cd ~/tianbot_mini_ws
catkin_make --only-pkg-with-deps abc_swarm -DPYTHON_EXECUTABLE=/usr/bin/python3
source devel/setup.bash三车三角形手动领航:
roslaunch abc_swarm demo_mocap_three_mini_leader_follower_triangle.launch三车逐车跟随:
roslaunch abc_swarm demo_mocap_three_mini_leader_follower_snake.launch头车自动走圆形路径,后车保持三角形:
roslaunch abc_swarm demo_mocap_formation_leader_follower_path_tracking.launch shape:=circle三角形/蛇形 leader-follower 入口均支持 mode:=manual (默认,键盘遥控)
和 mode:=auto (头车自动画圆)。auto 默认半径 1m、一圈、头车路径速度 0.08m/s,
可通过 radius、laps、clockwise、speed 配置;后车输出上限由 max_linear 配置;切换时退出旧实验后重启。
两种模式默认先 ORCA 入队、纯点镇定精定位、全体稳定到齐,再交给键盘或路径。
默认速度反馈来自动捕;标定用 control_config 显式加载。startup:=false 仅跳过初始入位,仍使用同一任务接口。
一个文件组合驱动、VRPN、算法和所需交互,反馈有效后自动运行,无需手动启用服务。
已有后台时传入 start_driver:=false start_vrpn:=false。
地址和端口只需在 config/mocap.yaml 配置,也可通过启动参数覆盖。
停止实验在 roslaunch 终端按 Ctrl+C;具体摆位和路径范围先看文档。
启动后反馈有效即自动运动,运行前确认目标、朝向与场地范围。
Python 实现可复用核心算法,关键参数可配置;launch 负责驱动、定位、 设备话题/frame 映射、角色、参数和实验组合。相同算法不按 Mini、RMTT、 TOM06S 分别复制。运动模型或控制输出不同的设备,使用必要的适配或对应控制律。 项目开发约定记录在 AGENTS.md。
冻结对比原 main 的 1708f33,不会随未来 main 自动重设基线。
在源码仓库根目录即可检查,不需要启动 ROS 或设备:
python3 tests/check_course_compatibility.pyGitHub 工作流会运行兼容检查、算法回归以及 Noetic 构建和合成 ROS 测试。 推送后还需要在 main 设置必过检查,才会阻止未通过检查的合并。 操作步骤见 兼容保障与 CI。
从设备清单、刚体、起始位置及实验需求生成 launch 和现场运行单,见 AI 客户实验指南。生成器离线运行,生成的 launch 在反馈有效后自动运行;当前支持 Mini 单车/三车动捕实验。
三角形、蛇形跟随之后,可用独立点镇定实验观察各车到达目标位置与最终朝向,见 点镇定实验指南。定位齐全后自动运行;普通模式没有避障,可选 ORCA 模式还包含登记车辆间的绕行和逐车通行,不包含地图或场地边界规划。
simple-pid 2.0.0 已包含在 src/simple_pid,由 catkin 安装,无需单独 pip 安装;原导入方式保持不变。来源与许可证见 第三方代码说明。
在同一三车点镇定中选择 avoidance:=orca,加入参与车辆间避让,见 ORCA 动捕说明。只面向 VRPN 动捕;不包含静态障碍感知,实车结果待验收。
两个独立 demo 自动完成起点点镇定后开始路径跟踪:同圆初始120度间隔、各自跟踪,或正三角形逐边到齐后原地转向。默认尺寸2m、速度上限0.15m/s,可改1.5m。见 三车协调路径指南。