Skip to content
tianbotPublic

About

Ant Bee Cooperative Swarm, indicating air-ground cooperation. This repository is for Tianbot Mini and RoboMaster TT swarm kit.

Topics

Resources

Stars

98 stars

Watchers

6 watching

Forks

Repository files navigation

ABC Swarm

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.py

GitHub 工作流会运行兼容检查、算法回归以及 Noetic 构建和合成 ROS 测试。 推送后还需要在 main 设置必过检查,才会阻止未通过检查的合并。 操作步骤见 兼容保障与 CI。

AI 配置客户实验

从设备清单、刚体、起始位置及实验需求生成 launch 和现场运行单,见 AI 客户实验指南。生成器离线运行,生成的 launch 在反馈有效后自动运行;当前支持 Mini 单车/三车动捕实验。

三车动捕点镇定

三角形、蛇形跟随之后,可用独立点镇定实验观察各车到达目标位置与最终朝向,见 点镇定实验指南。定位齐全后自动运行;普通模式没有避障,可选 ORCA 模式还包含登记车辆间的绕行和逐车通行,不包含地图或场地边界规划。

PID 实现随包提供

simple-pid 2.0.0 已包含在 src/simple_pid,由 catkin 安装,无需单独 pip 安装;原导入方式保持不变。来源与许可证见 第三方代码说明。

动捕点镇定加 ORCA

在同一三车点镇定中选择 avoidance:=orca,加入参与车辆间避让,见 ORCA 动捕说明。只面向 VRPN 动捕;不包含静态障碍感知,实车结果待验收。

三车动捕圆形与正三角形运动

两个独立 demo 自动完成起点点镇定后开始路径跟踪:同圆初始120度间隔、各自跟踪,或正三角形逐边到齐后原地转向。默认尺寸2m、速度上限0.15m/s,可改1.5m。见 三车协调路径指南。

About

Ant Bee Cooperative Swarm, indicating air-ground cooperation. This repository is for Tianbot Mini and RoboMaster TT swarm kit.

Topics

Resources

Stars

98 stars

Watchers

6 watching

Forks

Releases

Packages

Contributors

Languages