正在连接信源…

Pogobot 群体机器人 复刻全流程

Pogobot 群体机器人 从采购、打印、组装到装软件、标定和训练的 209 个步骤,附物料表、购买链接与官方出处。

不出售,无套件。作者论文(arXiv 2504.08686 第 2 版,2025‑11)估计组装成本约 250 欧元一台,未分项,也未说明是否含税;头板需交电子组装厂生产

采购

  • 准备一台机器人所需部件

    准备腹部和头部、3V CR2 可充电 Li-FePO4 电池、3个电机以及全部3D打印部件。

  • 购买兼容的机器人电机

    为机器人购买文档所链接的兼容电机,共需3个。

  • 采购USB UART编程板部件

    准备UMFT234XF板、8针0.5毫米SMD/SMT直角双触点FFC/FPC连接器、8针0.5毫米FFC/FPC排线及USB Micro转USB数据线。

打印与加工

  • 打印全部3D部件

    从“3d-addons”文件夹获取所有部件的3D设计并打印,随后按照其中的装配说明进行装配。

  • 制作USB UART编程小板

    使用“Hardware/usb-uart-progboard”文件夹中的KiCad文件制作用于通过有线方式编程机器人的小板。

  • 打印 IR 遥控器的 3D 结构

    打印 pogoremote_down.stl 和 pogoremote_up.stl 两个文件,构成小型 IR 遥控器的 3D 结构。

  • 制作柔性 PCB 上的 IR 墙灯带

    由于找不到合适的 LED 灯带,作者自行设计了 remote_leds_wall_strip,并在柔性 PCB 上制作。

  • 打印 pogobject 的 3D 结构

    pogobject 是一块包含全部电子器件的大型 PCB,需要放入一个 3D 打印的结构中。

  • 打印裙部、胶囊和帽子

    根据腹部版本,用 Ultimaker2+ 以 PLA、0.2mm 层高、无支撑和无裙边打印裙部、胶囊和帽子。帽子需要翻转后打印。

  • 切出胶囊的卡扣

    胶囊打印完成后,轻轻从下方切开并释放卡扣。

组装

  • 查看硬件全局图

    先查看文档中的硬件全局示意图,了解机器人硬件组成。

  • 连接有线编程器

    将USB转UART设备连接在计算机与头部FFC/FPC连接器之间,用于通过线缆编程机器人。

  • 选择机器人充电方式

    可通过编程线缆充电,也可通过头部正负焊盘充电;多机器人充电器使用 pogopin 接触这些焊盘。

  • 组装多机器人充电器

    使用文件夹中的PCB CAD文件制作充电器,安装所列 pogopin、一个5.1毫米内嵌式电源插口,以及用M3螺钉固定的3D打印支脚和触点锥。

  • 组装小型 IR 遥控器

    将 pogobot 头部、usb-uart-progboard 和打印好的 3D 结构组合在一起,用 2 个 M3x10mm 螺丝固定。

  • 组装带 LED 灯带的大型 IR 遥控器

    把 pogobot 头部、remote、remote_Leds_strip 和 3D 结构组合成大型遥控器,其 LED 为 TSAL6200。

  • 组装 IR 墙

    制作 IR 墙需要 pogobot 头部、remote、remote_leds_wall_ctrl 和 remote_leds_wall_strip,其 LED 为 VSM3940x01。

  • 安装万向轮与配重

    该结构装在 4 个带金属球的万向轮(pololu item 953)上以便被机器人推动,并用铝制配重固定。

  • 将电机放入三个孔位

    首先,将电机放入三个孔内。

  • 将机器人放入胶囊

    然后,将机器人放入胶囊内部。

  • 将机器人和胶囊放入裙部

    最后,将机器人连同胶囊放入裙部内部。

  • 连接机器人与编程板

    使用排线将机器人连接到编程板。

  • 用 USB 连接电脑

    使用 USB 将编程板连接到电脑。

软件与固件

  • 用 C 编写并选择上传方式

    Pogobot 程序用 C 编写。单个机器人可通过 USB 数据线上传,多个机器人可通过远程红外上传器(“shower” / walls)上传。

  • 安装 SDK 和工具链

    编译程序前安装 Pogobot SDK 和工具链。

  • 打开 helloworld 示例

    SDK 安装后,进入 `pogobot-sdk/examples/helloworld` 中的 `helloworld` 示例。

  • 创建程序目录

    创建 `my_program` 目录,其中包含 `main.c` 和 `Makefile`。

  • 复制示例 Makefile

    每个程序的 Makefile 基本相同,因此可从示例中复制。

  • 添加标准程序骨架

    在 `main.c` 中包含 `pogobot.h`,调用 `pogobot_init()`,并在 `while (1)` 循环中使用读取传感器、通信、移动和闪烁 LED 的注释占位。循环末尾执行 `msleep(10)`。

  • 初始化并报告就绪

    调用 `pogobot_init()` 初始化机器人,然后输出 `init ok`。

  • 设置蓝色 LED 和左转

    将 LED 颜色设置为蓝色 `(0, 0, 255)`,让左电机全速运转,右电机停止。

  • 等待并打印问候语

    等待 `500` 毫秒,然后向串行终端打印 `HELLO WORLD !!!`。

  • 设置红色 LED 和右转

    将 LED 颜色设置为红色 `(255, 0, 0)`,让左电机停止,右电机全速运转。

  • 等待并持续重复

    再等待 `500` 毫秒,并在 `while (1)` 循环中持续重复蓝灯左转和红灯右转的序列。

  • 编译并上传程序

    安装 SDK 和工具链后编译程序。单个机器人使用 USB 数据线上传,多个机器人使用远程红外上传器上传。

  • 初始化程序

    每个程序都必须先调用 pogobot_init()。未初始化时,大多数硬件功能将无法工作。

  • 设置头部 LED 颜色

    调用 pogobot_led_setColor(r, g, b) 设置头部 LED 颜色,每个值的范围为 0 → 255。示例将 LED 设置为红色。

  • 等待指定毫秒数

    使用 msleep(milliseconds) 等待指定的毫秒数。示例等待 500 ms。

  • 设置振动电机功率

    Pogobot 有三个振动电机:motorR、motorL 和 motorB。功率级别为 motorStop = 0、motorQuarter = 256、motorHalf ≈ 512、motorThreeQuarter ≈ 716、motorFull = 1023。

  • 打印调试消息

    使用标准 C 打印函数 printf 输出消息。消息会显示在串行终端中,对调试非常有用。

  • 读取环境光传感器

    调用 pogobot_photosensors_read(0) 读取环境光传感器的整数值。传感器编号 0、1、2 分别对应 back、front-left 和 front-right。

  • 读取电池电压

    调用 pogobot_battery_voltage_read() 读取电池电压。返回值的单位为毫伏。

  • 重置并读取秒表

    声明 time_reference_t 计时器并重置它,然后进行计算。经过的时间以微秒读取,并通过 printf 输出。

  • 初始化一秒周期定时器

    声明 time_reference_t 定时器并设置周期为 1000000 微秒。计时器到期时打印“1 second elapsed”,再将计时原点偏移 1000000 微秒。

  • 遵循红外消息工作流程

    依次发送消息、定期更新红外系统、检查消息是否到达,然后读取消息。

  • 向所有方向广播短消息

    创建内容为“hello”的字符消息,并调用 pogobot_infrared_sendShortMessage_omni 发送。该调用会向所有方向广播。

  • 更新红外并接收消息

    调用 pogobot_infrared_update 更新红外系统,并检查是否有消息可用。使用 pogobot_infrared_recoverNextMessage 读取下一条消息,然后打印“Message received”。

  • 使用分布式遗传算法程序

    使用 SDK 中 examples/demo_d2_9BIS 的分布式遗传算法演示程序。该程序演示红外群组通信、分布式决策、变异与选择、LED、电机和随机基因组生成。

  • 生成随机二进制基因组

    每个机器人生成一个随机二进制基因组。

  • 计算适应度分数

    每个机器人计算其基因组的适应度分数。

  • 广播基因组

    每个机器人向邻居广播自己的基因组。

  • 复制邻居的更强基因组

    当接收到的基因组适应度高于当前适应度时,将该更强的基因组复制到自己的数据中。

  • 偶尔执行变异

    每个机器人偶尔对基因组执行变异。

  • 表示基因组和适应度数据

    定义 my_data_t 结构,其中 genome 使用 uint16_t,fitness 也使用 uint16_t。

  • 广播基因组数据

    使用 pogobot_infrared_sendLongMessage_omniGen 发送 my_data 结构,其大小通过 sizeof( my_data ) 指定。

  • 接收并比较基因组

    比较接收到的适应度与 my_data.fitness。如果接收到的适应度更高,就把接收到的 genome 复制到 my_data.genome。

  • 变异一个基因组位

    使用异或运算翻转由 n 指定的基因组位。

  • 编译固件

    在项目文件夹中运行 make。编译成功后应生成 build/firmware.bin 和 build/firmware.elf。

  • 确认编译输出

    确认已生成 build/firmware.bin 和 build/firmware.elf。

  • 通过 USB 连接机器人

    运行 make connect TTY=/dev/ttyUSB0 连接机器人。将 /dev/ttyUSB0 替换为计算机上正确的串行设备。

  • 进入终端交互

    运行 make connect 后按 ENTER。

  • 等待终端提示符

    等待提示符出现。

  • 使用终端命令

    在终端中直接使用命令。

标定与测试

  • 进入配置模式

    将 D9 连接到 VCC,然后重启 Pogobject,以配置 Wi-Fi 的 SSID 和密码。

  • 连接配置热点

    连接名为 PogobjectConfig 的 Wi-Fi,密码为 pogobotconfig。

  • 输入网络信息

    在浏览器中打开 http://192.168.4.1,输入所需的网络信息。

  • 退出配置模式

    将 D9 重新连接到 GND,然后重启 Pogobject。

  • 确认网络连接

    确认 Pogobject 已连接到你的网络。

  • 检查启动指示灯

    正确供电后,LED 通常会在启动时闪烁多种颜色。

  • 确认上传成功

    上传成功后,机器人通常会变成绿色。

  • 观察机器人状态

    观察 LED、运动和调试输出。

  • 接受默认 Singularity 配置

    安装期间如询问自定义配置或 init 文件,使用默认选项。默认操作是保留当前安装的 /etc/singularity/init 和 /etc/singularity/singularity.conf 版本。

  • 检查 Singularity 版本

    运行 singularity version 检查已安装的 Singularity 版本。

  • 通电前检查充电器极性

    插入机器人前,用万用表确认电源插头内触点为+5V、外触点为接地。

  • 用跳线选择 LED 供电来源

    该版本可用 USB 供电或外部供电(最高 12v)以延长遥控距离,电源插口旁的跳线决定 LED 的供电来源。

  • 测试 SDK 编译结果

    运行容器的 test_install 应用,检查 SDK 是否成功编译。

  • 快速校准左右电机

    调用 pogobot_quick_calibrate(),设置 0 到 1023 之间的功率,并通过 leftMotorVal 和 rightMotorVal 获取整数电机值。功率越低,校准越不精确,通常建议保持在 524 到 716 之间。

  • 使用可配置校准函数

    调用 pogobot_calibrate(),设置功率、启动时长、采样时长、尝试次数和修正值;每次尝试先启动电机 startup_duration 毫秒,再采集 try_duration 毫秒的 IMU 数据。快速校准使用启动时长 500 ms、采样时长 750 ms、尝试次数 15 和修正值 50.0f。

  • 反向安装时使用负修正值

    如果 Pogobot 反向安装,可能需要给 correction 参数分配负值。每次校准尝试时,该修正值会应用于其中一个电机。

  • 保持其他滤波参数不变

    其余参数只需初始化一次,之后无需更改。

  • 显示卡尔曼滤波 IMU 值

    将经过和未经过卡尔曼滤波的 IMU 值打印到控制台,i 为当前时间(毫秒)。

采数据与训练

  • 逐渐收敛到最优基因组

    机器人通过比较和复制更强的基因组并偶尔变异,逐渐向最优基因组收敛。

用起来

  • 尝试群组智能应用

    使用这类程序实验群组智能、集体优化、去中心化协调和涌现行为。

  • 运行已上传程序

    在终端中运行 run 启动已上传的程序。

  • 启动所有机器人

    运行 rc_start 启动所有机器人。

  • 用 WiFi 改变物体发出的消息

    pogobject 由 dfrobot firebeatle、pogobot 头部和 pogo_object PCB 组成,其 LED 为 TSAL6200;通过 WiFi 可向头部发送命令以改变物体发出的消息。

  • 按照网页说明操作

    打开网页应用,并按照网页页面提供的说明进行操作。

  • 播放动画

    调用 anim_same 显示动画。

  • 让 LED 闪烁

    让所有 LED 闪烁 number_of_blinks 次。

物料

  • 头板:Lattice iCE40UP5K FPGA(主 README 与论文;SDK README 写作 iCE40LP8K),经 LiteX 运行 VexRiscv 32 位 RISC‑V 软核;4 组红外收发(TS4231)、3 个光传感器、6 轴 IMU、1 颗 LED、FFC 编程口与充电触点
  • 底板:电源与充电管理、3 路电机驱动、4 颗 RGB LED
  • 3 个振动电机(两侧各 1、后部 1);CR2 规格 LiFePO4 充电电池(README 写 3 V,论文写 3.3 V)
  • PLA 打印件:胶囊壳、裙边(装刷毛、TPU 腿、牙刷头或两轮)、顶盖;Pogobot 2026 另有环形标记、红色滤光片与箭头
  • 编程:USB‑UART 编程板(UMFT234XF + 8 针 0.5 mm FFC 座与排线);可选 Pogocharger 弹簧针充电板、Pogoremote/PogoShower 红外遥控、Pogowall 红外墙

工具

  • 3D 打印机(文档用 Ultimaker 2+、PLA、0.2 mm 层高、无支撑)
  • 电子组装厂贴装头板;其余电路板焊接
  • 万用表(接充电板前核对电源极性)
  • 装 Ubuntu 的电脑(SDK 只支持 Ubuntu,测试于 20.04;其他发行版用 Singularity 容器)

技能

  • C 语言编程、Linux 命令行与 make、串口终端
  • 专家模式:LiteX、Yosys、nextpnr、IceStorm 与 RISC‑V GCC 工具链,可改 FPGA 门级设计
  • KiCad 6 改电路板,3D 建模改外壳与运动机构

软件

  • pogobot-sdk:C 语言 API(LED、电机、光传感器、IMU、红外消息、计时器)与示例,含分布式遗传算法演示
  • pogobios 与 pogolib:机载 BIOS 与底层库;预编译固件到 API v2.6
  • Pogosim 模拟器(C++20/C17、SDL2、Box2D,v0.10.10,2026‑06‑22):原样运行机器人 C 代码,支持批量实验
  • pogotrack 视频追踪、pogo-utils 扩展库、PogoWallApp 红外墙网页控制

文档