正在连接信源…

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 配置

文档