Maker's Pet Mini 激光雷达 ROS 2 教育小车 复刻全流程
Maker's Pet Mini 激光雷达 ROS 2 教育小车 从采购、打印、组装到装软件、标定和训练的 206 个步骤,附物料表、购买链接与官方出处。
120mm Build Pack 77–150 美元(Maker's Pet 官方商店,2026‑11‑01,美元):含打印件与 LD14P 激光雷达 150 美元,自行打印、自备激光雷达最低 77 美元;不含电池,只对寄往加州的订单收销售税,首页称满 150 美元全球免运费,国际订单税费由买家承担。散件另售:BDC‑30P 驱动板 35 美元、LD14P 激光雷达 59 美元、120mm 车体 20 美元起、N20 编码器电机 10 美元、ESP32E 开发板 9 美元
采购
- 准备电脑和 WiFi
使用运行 Windows 且至少有 8GB RAM,或运行 Linux 且至少有 4GB RAM 的本地电脑,并连接 2.4GHz WiFi 网络。
- 选择并订购所需零件
根据所选选项确定所需零件。全选项订单包含 LD14P 激光雷达及连接线、N20 编码电机及配件、轮子、电池硬件、紧固件、底座、脚轮、ESP32 开发板和 BDC-30P 电机驱动板。
- 阅读可充电电池警告
使用可充电电池选项前,阅读 WARNINGS 部分中的附加说明。
- 准备 2.4 GHz 网络
让机器人和电脑连接到同一个 2.4 GHz WiFi 网络。不要使用 5 GHz 网络,因为 ESP32 无法使用它。
- 选择 USB 数据线
为 ESP32 使用 USB 数据线。只能供电的线缆无法工作。
- 准备装配工具
组装机器人前准备一把小螺丝刀和一把剥线钳。
打印与加工
- 下载支架和脚轮零件
下载激光雷达裙边、激光雷达支柱、电路板支柱、脚轮滚轮、脚轮支架和 2S 电池座挡板的 3MF/STL 文件。
- 下载机器人底座
从 v1.0.1 下载链接获取机器人底座的 3MF/STL 文件。
- 下载轮子
下载轮子的 3MF/STL 文件。
- 下载电机夹具
下载电机夹具的 3MF/STL 文件。
- 打印机器人的 3D 打印零件
自行打印全部可 3D 打印零件,并选择喜欢的颜色。此时将“3D Printed Parts”选项设为“None”以节省费用。
组装
- 剥离电机线绝缘层
从电机线上剥离 8–10 毫米的绝缘层。
- 折回裸露线芯
将裸露线芯折回绝缘层上;较粗的一端更容易夹紧。
- 插入电机线
插入电线,使裸露线芯朝上。使用金属触点时,应让金属面朝上。
- 拧紧端子螺钉
拧紧端子螺钉,固定插入的电机线。
- 连接两根电机线
两个端子排均按 M2 红色、M1 白色、GND 蓝色、ENCA 绿色、ENCB 黄色、+Venc 黑色连接。线色不同时按插头针脚顺序和电路板端子标签连接,并轻轻拉动每根线检查是否牢固。
- 安装四个主板支柱
使用沉头 M3 螺钉,将四个较短的支柱安装到底座上。小心扭转每个支柱及其卡扣,使其朝向图示方向。
- 安装四个激光雷达支柱
使用沉头 M3 螺钉将四个较长的激光雷达支柱安装到底座上,并按图示方向放置。
- 安装脚轮支架
使用内六角圆柱头 M3 螺钉,将两个脚轮支架安装到底座后部,并略微留松。
- 穿入脚轮金属轴
将金属轴穿过脚轮滚轮。
- 安装脚轮滚轮
将金属轴两端放入两个脚轮支架中。
- 拧紧脚轮支架
拧紧脚轮支架螺钉,固定滚轮组件。
- 检查脚轮转动
将滚轮压在桌面上,前后移动底座,直到滚轮能够自由转动。
- 将电机装入夹座
将每个电机装入对应夹座,使电机前表面与夹座齐平。
- 固定两个电机
使用三颗沉头 M3 螺钉将每个电机固定到底座上,并让电机轴朝外。不要过度拧紧,以免塑料底座弯曲。
- 检查主板支柱标签
确认没有任何主板支柱标签碰到电机。如果标签压住并阻塞电机,扭转支柱使标签转开。
- 拧紧电机螺丝
检查弯曲的塑料(包括底座)是否会摩擦电机齿轮或编码器盘。将电机螺丝拧到刚好紧固。
- 清除车轮上的杂物
安装前,确保每个车轮都没有杂物。
- 将轮胎压入轮槽
用手指将每个轮胎沿轮槽完全压入。
- 找到电机轴与轮毂的平面
找到电机轴上的平面,以及轮毂中与之配合的平面。
- 将车轮压到电机轴上
将电机轴上的平面与轮毂中配合的平面对齐。用双手将车轮完全压到电机轴上。
- 清洁车轮和轮毂
清洁车轮和轮毂,避免砂粒或塑料碎屑卡住齿轮箱齿轮并烧坏电机。
- 连接电机电缆
将每根电机电缆的插头与电机背面的连接器对齐。轻轻压入插头;如果无法插入,应检查对齐方式,不要强行插入。
- 布置电机电缆
将电机电缆布置在主板下方。在电机插头处轻轻将导线向下弯曲。
- 将主板固定到支柱
使用四颗内六角圆头 M3 螺丝将主板固定到支柱上。
- 检查电机连接器外壳
插入每根电缆前检查电机连接器,因为其塑料外壳可能会从插针上滑脱。
- 连接电池线
将电池盒导线连接到 +BAT、GND 和 ExtVmot 螺丝端子。红色连接 +BAT,黑色连接 GND。
- 检查电池极性
开机前检查电池极性。极性接反会烧坏主板。
- 直插裸露导线
不要折回裸露的导线。将其直直插入螺丝端子。
- 调整 ESP32 模块方向
调整 Maker's Pet ESP32-E 30-pin 开发板模块的方向,使其 USB 接口朝向电池螺丝端子。
- 检查 ESP32 电源引脚
将模块完全压入插座前检查方向。装反会接到错误的电源引脚。
- 插入 ESP32 模块
将方向正确的 ESP32-E 模块完全压入主板插座。
- 按照组装视频操作
按照跟做视频中的说明组装机器人。
- 使用免费电子书
也可以按照免费电子书中的说明操作。
- 阅读可充电电池警告
阅读 FAQ 部分中的说明和可充电电池(仅限带保护电路的电池)使用警告。使用可充电电池为机器人供电的风险由使用者自行承担!
- 安装后立柱
使用底座外侧的备用孔安装后立柱。
- 安装电池座挡片
使用两颗 M3 沉头螺丝,将电池座挡片安装在电池后方的两个备用孔中。
- 使用加宽裙边安装 LiDAR
使用与后立柱位置相匹配的加宽裙边安装 LiDAR。
- 确保PCB凸片不接触电机
确保PCB凸片不接触电机。以任何方式阻碍电机转动,都可能在通电时烧毁电机。
- 安装电机连接器外壳
电机连接器外壳可以朝向电机的磁铁滑脱。小心地将连接器外壳拉回原位。
- 检查电机端子接线
确保电机线连接到正确的板上螺钉端子。
软件与固件
- 下载机器人固件
下载机器人固件。
- 为 Arduino IDE 2.x 安装 SPIFFS 插件
为 Arduino IDE 2.x 安装 SPIFFS Upload 插件。
- 为 Arduino IDE 1.8.19 安装 SPIFFS 插件
为 Arduino IDE 1.8.19 安装 SPIFFS Upload 插件。
- 安装 Microsoft WSL
按照链接中的安装说明安装 Microsoft WSL。
- 安装 Windows 版 Docker
安装 Windows 版 Docker。
- 安装 X server 并设置显示编号
安装 X server,并将 Display number 设置为 0(零)。
- 安装 PowerShell
安装 PowerShell。
- 安装 ROS2 Iron 和 Kaia.ai
如需跳过 Docker,可在 Ubuntu 22.04 上直接安装 ROS2 Iron 和 Kaia.ai 软件包,依次使用 install_ros2_iron_ubuntu_22_04.sh 和 install_kaiaai_iron.sh。
- 使用 Iron Docker 镜像
这些说明使用 kaiaai/kaiaai:iron Docker 镜像。
- 启动 Jazzy Docker 镜像
在 Linux 上使用 start_jazzy.sh 启动 kaiaai/kaiaai:jazzy 镜像。
- 启用共享内存消息传递
编写包含 --net=host 的自定义 docker run 命令时,还要添加 --ipc=host,使容器外的 ROS2 节点能够收到消息。
- 在虚拟机中安装 Ubuntu
仅在安装 WSL2 遇到困难时使用此方法。在 Windows PC 上使用虚拟机安装 Ubuntu 22.02,而不是 WSL2。
- 运行 KaiaAI Docker 容器
使用文中所示的端口映射运行 Docker 容器。如果 Docker 报告 TCP 端口 4430 不可用,请重启 Windows PC。
- 停止现有的 makerspet 容器
如果 Docker 提示 makerspet 容器名称已被使用,请停止现有容器,然后重试 docker run 命令。
- 拉取 KaiaAI Iron 镜像
使用 Docker 拉取 kaiaai/kaiaai:iron 镜像。
- 启动 Docker Desktop
如果 Docker 提示 Docker 引擎未运行,请在 Windows PC 上启动 Docker Desktop。
- 保留容器中的更改
当启动新的容器时,运行中的 makerspet 容器内所做的更改会丢失。将运行中的容器提交到镜像中以保留更改,也可以将这些更改推送到你自己的 Docker Hub 仓库,作为 PC 之外的备份。
- 备份 Iron 镜像
可选地为你自己的 Docker Hub 仓库标记现有的 kaiaai Iron 镜像,然后推送该镜像。
- 在树莓派上安装 Ubuntu
由于 Docker 镜像支持 x86-64 而不支持 ARM64,请在树莓派上原生安装 Ubuntu 22.04。
- 原生安装 ROS2 Iron
在 Ubuntu 22.04 上使用 install_ros2_iron_ubuntu_22_04.sh 安装 ROS2 Iron,也可以回退到官方的 ROS2 Iron Ubuntu .deb 安装说明。
- 安装 Kaia.ai 附加组件
安装 ROS2 Iron 后,使用 install_kaiaai_iron.sh 安装 Kaia.ai 附加组件。
- 原生安装 ROS2 Jazzy
使用 ROS2 Jazzy 时,请采用 Ubuntu 24.04,并使用 install_ros2_jazzy_ubuntu_24_04.sh 安装 ROS2。
- 安装 Jazzy 附加组件
使用 install_kaiaai_jazzy.sh 安装适用于 ROS2 Jazzy 的 Kaia.ai 附加组件。
- 在 Docker 中运行多个机器人
每个机器人运行一个 Docker 容器,使用唯一的容器名称和不同的主机 UDP 端口。将每个机器人的 WiFi 配置指向对应的端口。
- 启用真正的主题命名空间
编辑 /ros_ws/src/makerspet_mini/config 中的 YAML 文件,例如 telem.yaml,以应用 Turtlebot3 风格的主题命名空间。
- Jazzy 容器无需 IPC 主机设置
使用 Jazzy 镜像启动的容器各自拥有独立网络,因此不要添加 --ipc=host。
- 先启动 X 服务器
在 Windows WSL 中启动 RViz 或其他 GUI 程序之前,请确保 X 服务器正在运行。
- 终止卡住的ROS2进程
在另一个Bash窗口中运行ps -al以查找ros2和python3进程,然后终止这两个进程。
- 启动Windows X服务器
在使用ROS2图形界面之前,在Windows电脑上启动X服务器。
- 通过VNC查看ROS2图形界面
Docker镜像中已包含TigerVNC和Xfce。使用指定VNC端口和display启动容器,在容器内启动VNC,然后使用VNC查看器连接localhost:5901。
- 调整第三方电机PID
对于并非从Maker’s Pet购买的第三方电机,如有必要,请在驱动板config.yaml文件中调整电机PID系数。仔细焊接电机编码器上任何松动的元件。
- 配置兼容的电机驱动
固件通过TB6612FNG、DRV8871、DRV8833、DRV8835或L298N驱动的IN1/IN2输入控制电机。将驱动使能引脚保持为高电平:TB6612FNG需将PWMA、PWMB和STBY接高;L298N需通过板载跳线或接至5V使ENA和ENB保持高电平。
- 映射驱动类型和GPIO
在config.yaml中,为上述驱动设置IN1_IN2,为带内置控制器的无刷电机设置PWM_CW,并映射每个电机的GPIO。如果轮子转向错误或无法停止,请交换该电机的in1/in2或编码器a/b连接;文档链接了TB6612FNG连接ESP32的完整示例。
- 防止启动时电机转动
部分ESP32电机驱动GPIO在启动或复位时会悬空或变为高电平,导致固件接管前电机全速旋转。在setup()开始时,明确将电机GPIO引脚驱动为低电平。
- 配置无刷直流电机
在 config.yaml 中将 motor.driver.type 设为 PWM_CW、motor.encoder.type 设为 FG,然后映射每一侧的 FG、PWM 和 CW GPIO。
- 选择 ESP32 开发板
在 Arduino IDE 中进入 Tools -> Board -> ESP32 Arduino,然后选择相应的 ESP32 开发板,通常是 ESP32 Dev Board。
- 选择兼容的 ESP32 软件包
不要使用 ESP32 板卡软件包 2.0.15,因为其中的 HardwareSerial 存在问题。使用 2.0.16 或更新版本,推荐 2.0.17;由于 ESP32 core 3.x 移除了 ledcAttachPin 和 ledcSetup,请使用 2.0.17。
- 防止内置库被替换
重命名 kaiaai 库,例如改为 MotorController_kaia,避免 Arduino IDE 2.x 的库管理器将其静默替换为其他作者编写的同名库。
- 上传 ESP32 sketch 数据
无论使用 30 针 ESP32 开发板,还是带 ESP32-WROOM-32D 模块的 38 针开发板,都上传 sketch 数据。上传后,串口监视器应显示 SPIFFS 挂载成功。
- 进入 ESP32 网页配置
按下并松开 EN,然后在 1 秒内按住 BOOT,以进入网页配置。
标定与测试
- 打开电池电源开关
确保电池电源开关处于ON状态。
- 检查ESP32电源指示灯
在电池电源开关为ON时,检查ESP32板上的电源LED是否亮起。
- 检查电机编码器LED
检查电机上的绿色LED。如果熄灭,说明电机编码器没有获得电源;原因可能是电池断开、电源开关关闭、电机到线缆的连接失败或线缆到电路板的连接失败。
- 释放编码器磁铁
小心将编码器传感器弯回正常位置。确认编码器磁铁能够自由转动,且不会接触传感器。
- 测试电机正转
运行ROS2遥操作应用并按w键。确认机器人的电机向前旋转。
- 检查电机不转的问题
检查是否有线缆阻挡编码器磁铁转动、任一电机是否机械卡住、M1和M2是否可靠连接到电路板,以及电池是否电量充足。交换电机以定位故障;装配视频展示了金属导体未接触的情况。
- 修正单向全速旋转
如果电机无论接收前进、后退或停止指令都始终向一个方向全速旋转,请交换该电机的ENCA和ENCB线。确认两根编码器线与电路板和电机之间均可靠连接,并检查是否存在接触不良。
- 修正电机反向旋转
如果电机方向相反但其他遥操作响应正常,请先交换其ENCA和ENCB编码器线,再交换M1和M2线。检查线缆连接是否不稳定。
- 使用正确的12V电池
当Vmot为12V时,按默认设置闭合JP2,并使用约6–10V的Vbat。3S锂聚合物电池的11.1V无法可靠工作,应使用约7.4V的2S电池组。
- 使用正确的24V电池
当Vmot为24V时,断开JP2,并使用约6–21V的Vbat。
- 使用足够的编码器脉冲分辨率
使用约 1000 PPR 或更高的分辨率;PPR 过低的 FG 信号会导致低速 PID 控制抖动。
- 读取 ESP32 状态指示灯
常亮表示 AP 模式;每秒慢闪表示正在连接 WiFi;每 20 秒极慢闪烁表示已连接 WiFi、正在连接 ROS2 PC;快速闪烁表示已连接 ROS2 PC。
- 验证已加载的机器人配置
确认 /network.yaml 和 /config.yaml 已加载,主控板为 MINI-BDC30P-BODY,配 BDC-30P v1.1.1,雷达为 LDROBOT LD14P,接收缓冲区为 1024 字节、波特率为 230400。电池 ADC 衰减为 7.00、电压为 2.60V,电机驱动类型为 IN1_IN2,电机编码器类型为 AB_QUAD。
- 检查主板和电机配置
确认报告的主板型号、IN1_IN2 电机驱动类型、AB_QUAD 编码器类型、180.00 RPM 最大电机转速、1035.00 编码器 PPR 和 4140.00 TPR。
- 进入网页配置
按下并松开 EN,然后在 1 秒内按住 BOOT,以进入网页配置。
- 检查激光雷达配置
确认激光雷达为 LDROBOT LD14P,接收缓冲区为 1024 字节、波特率为 230400,并且 startLIDAR() 返回 OK。
- 提高激光雷达启动转速阈值
如果激光雷达达到转速前出现电机 RPM 错误,提高 scan_rpm_err_thresh,为其留出更多启动时间。
- 选择 Docker Desktop 后端
选择 WSL 2、Hyper-V 或 Docker VMM。WSL 2 是默认选项,无需管理员权限即可供大多数用户使用。
- 确认 WSL 版本
使用 WSL 2.1.5 或更高版本。如果使用增强容器隔离功能,请使用 WSL 2.6 或更高版本。
- 检查 Windows 版本
使用 Windows 10 22H2 内部版本 19045,或 Windows 11 23H2 内部版本 22631 及更高版本,并选择 Enterprise、Pro 或 Education 版本。
- 启用 Windows Server 服务
启用 Windows Server 服务(LanmanServer),并将其启动模式设置为自动。
- 检查 Hyper-V 的 Windows 要求
使用 Hyper-V 时,请采用 Windows 10 22H2 内部版本 19045,或 Windows 11 23H2 内部版本 22631 及更高版本,并选择 Enterprise、Pro 或 Education 版本。
- 为 Hyper-V 启用服务
启用 Windows Server 服务(LanmanServer),并将其启动模式设置为自动。
- 核对处理器、内存和虚拟化
在 Windows 10 上运行 Client Hyper-V 时,需要配备支持 SLAT 的 64 位处理器和 8GB 系统内存。在 BIOS/UEFI 设置中开启硬件虚拟化支持。
- 检查 Windows 版本支持情况
确认 Windows 版本仍处于 Microsoft 的服务支持周期内。Docker Desktop 不支持 Windows Server 2019、Windows Server 2022 等 Windows 服务器版本。
- 确认 Windows 版本类型
运行 Windows 容器需要 Windows 10 或 Windows 11 专业版或企业版。Windows 家庭版和教育版只能运行 Linux 容器。
- 配置主机虚拟化支持
在 BIOS/UEFI 中启用硬件虚拟化。当 Docker Desktop 在虚拟机中运行时,主机必须提供嵌套虚拟化。
- 在 Arm 系统上使用 WSL 2
Docker VMM 不支持 Arm,安装程序会改用 WSL 2。Docker VMM 不需要 Hyper-V 功能。
- 核对 WSL 版本
确认已安装 WSL 2.1.5 或更高版本。
- 检查 Windows 版本和内部版本
使用 Windows 10 64 位企业版、专业版或教育版 22H2(内部版本 19045),或者 Windows 11 64 位企业版、专业版或教育版 23H2(内部版本 22631)或更高版本。
- 核对 WSL 2 硬件要求
在 Windows 10 或 Windows 11 上运行 WSL 2 时,需要配备支持 SLAT 的 64 位处理器和 8GB 系统内存。在 BIOS/UEFI 中启用硬件虚拟化。
- 重新安装以更改安装模式
若要稍后切换安装模式,请卸载 Docker Desktop 后重新安装。
- 选择容器守护进程
Use Windows containers only with an all-users Docker Desktop installation. From the Docker Desktop menu, select **Switch to Windows containers** or **Switch to Linux containers**; Linux containers are the default.
- 检查非默认硬件的配置
使用非默认电机、LiDAR 型号、轮子、机器人尺寸等设置时,阅读 Kaia.ai 固件 config.yaml 配置参考。
- 检查车轮转动
用手转动每个车轮,确认转动时没有摩擦。
采数据与训练
- 监控机器人遥测数据
监控激光雷达转速、两个车轮的转速、电池电压和 RSSI,以检查机器人运行状态。
用起来
- 选择模拟器学习路径
如果没有实体机器人,可以使用第 6 章的电脑模拟器驾驶机器人、绘制房间地图并将其导航至目标点。第 7 章的程序也可在模拟机器人上运行。
物料
- LDROBOT LD14P 二维激光雷达与 10 cm 转接线(可选,也可换固件支持的其他型号)
- 2 个 12V N20 编码器减速电机(200 RPM)、电机转接线与一对精密电机夹
- BDC‑30P 驱动板(53.2×56.4 mm,31 g):板载 12V/24V 电机升压电源、两路有刷直流电机驱动、两路编码器接口、激光雷达接口与电机 PWM、5V 稳压、电池电压检测与电源开关,插 ESP32 DOIT DevKit v1 兼容的 30 针 ESP32/ESP32E 开发板
- 6×AA 电池盒,或 2 节 18650 串联电池盒加挡板(不含电池;板子按一次性碱性电池设计,18650 须带保护,风险自负)
- 120 mm 车体(PETG 打印,可选自行打印):底板、4 根激光雷达立柱、4 根板柱、雷达护裙、万向滚轮与支架、两个 43 mm 轮,M3 沉头与圆头螺丝、内六角扳手
工具
- 电脑:Windows(8 GB 以上内存,WSL2、Docker Desktop 与 X server)或 Linux(4 GB 以上内存)
- Arduino IDE(ESP32 板卡包 2.0.16 以上,推荐 2.0.17)与 SPIFFS 上传插件,能传数据的 USB 线
- 2.4 GHz Wi‑Fi,且允许局域网设备互连(不支持 5 GHz)
- 可选:3D 打印机(自行打印车体可省钱)
技能
- 机械装配与接线:电机、编码器与电池线接到驱动板的螺丝端子
- 用 Arduino IDE 编译上传 ESP32 固件,并以 SPIFFS 上传 config.yaml;网页配网
- 在 Docker 或 Ubuntu 里运行 ROS 2:launch 文件、RViz、键盘遥控,Cartographer 建图、Nav2 导航与 explore_lite 自主探索
- 换用非套件电机、轮子或激光雷达时,需改 config.yaml 并重新校准 PID(商店不建议新手这样做)
软件
- kaiaai/firmware:ESP32 Arduino + micro-ROS 固件,电机 PID、编码器与激光雷达驱动,config.yaml 配置板卡与零件;最新 v0.8.6(2025‑12‑13)
- kaiaai(ROS 2 包与 kaia 命令行):一个工作区切换多种机型;kaiaai_bringup 建图、导航与前沿探索,kaiaai_gazebo 仿真,kaiaai_teleop 键盘遥控
- Docker 镜像 kaiaai/kaiaai:iron 与 :jazzy(x86‑64);Ubuntu 22.04/24.04 与树莓派可用脚本直接安装 ROS 2 Iron 或 Jazzy
- makerspet_mini:Mini 的 URDF 与 Nav2、Cartographer 配置