NodeHexa 复刻全流程
NodeHexa 从采购、打印、组装到装软件、标定和训练的 87 个步骤,附物料表、购买链接与官方出处。
NodeHexa 是一款基于 ESP32 的开源六足机器人,另提供四足构型固件。仓库包含可打印结构件、机械结构与紧固件说明、硬件及固件文档,并提供 Web 控制、校准、动作规划和复刻教程。
采购
- 选用 ESP32 主控制器
主控制器采用 ESP32,具体型号为 NodeMCU-32S。
- 选用 PCA9685 驱动板
舵机驱动采用 PCA9685 PWM 驱动板。
- 购买六足和四足机器人套件
购买 NodeHexa 六足机器人套件或 NodeQuadMini 四足机器人套件。
- 购买六足机器人电路板
购买 NodeHexa 六足机器人电路板。
- 购买推荐 MG90s 舵机
文档强烈推荐使用所列链接中的 MG90s 舵机,并说明劣质舵机更容易过热或烧毁。
- 购买语音 AI 拓展板
购买支持四足和六足机器人的小智 AI 拓展板。
- 进入六足机器人复刻教程
扫描二维码并关注公众号,发送“六足”查看详细复刻教程和交流群;也可以直接打开下方教程列表。
- 按教程准备器材
阅读并执行“六足机器人NodeHexa复刻教程(一)器材准备篇”。
- 准备六足构型紧固件
按六足构型紧固件BOM准备所需紧固件,数量不含备品,但建议另备少量余量。仅在采用M2×12mm等可选连接结构时,才准备相应螺钉和螺母。
- 准备四足构型紧固件
按四足构型紧固件BOM准备所需紧固件。机盖尚未设计,因此无需准备预留的机盖螺丝;采用M2×12mm等可选连接结构时再准备对应螺钉和螺母。
- 下载对应的PCB工程文件
下载所需的PCB工程文件,包括PiHexaSub、PiHexa-V4或PiHexaHatXiaozhi。
打印与加工
- 按需修改设计参数
根据实际需求修改PCB设计参数。
- 导出Gerber文件用于PCB制造
导出Gerber文件,并使用这些文件进行PCB制造。
组装
- 接入 ESP32-S3 CAM Mini
将 ESP32-S3 CAM Mini 接入与机器人相同的 Wi-Fi,并在独立视频控制模式中显示 MJPEG。
- 连接超声波诊断模块
连接超声波模块,Trigger 使用 GPIO4,Echo 使用 GPIO35;Echo 必须为 3.3 V。测距按需执行并进行错误计数,不介入运动决策。
- 配置 WiFi 与 UART2
机器人通信采用 Wi-Fi 与 UART2 串口。
- 连接无源蜂鸣器
如使用无源蜂鸣器,将其连接到 GPIO26。
- 按教程组装腿部
阅读并执行“六足机器人NodeHexa复刻教程(二)腿部组装篇”。
- 按教程组装机身
阅读并执行“六足机器人NodeHexa复刻教程(三)机身组装篇”。
- 焊接左侧驱动板 SJ1 跳帽
DIY 组装时需焊接左侧舵机驱动板的 SJ1 跳帽,使左右驱动板的 IIC 地址不同。购买套件的机器人无需操作,因为出厂已经焊接。
- 按规格使用紧固件
组装前确认紧固件规格和数量符合要求,再将相应紧固件用于各连接部位。
- 在防松部位使用自锁螺母
在需要防松动的连接部位使用自锁螺母。
- 用轴销连接关节
将轴销用于关节连接,并确保关节运动顺畅。
- 保护 GPIO35 的输入电平
超声波模块的 Echo 输出为 5 V 时,增加可靠电平转换或分压后再连接。禁止将 5 V Echo 输出直接连接到 GPIO35。
软件与固件
- 显示电压与估算电量
在主控制页和运动规划页实时显示电池电压与估算电量百分比。
- 配置小智语音拓展
连接小智 AI 拓展板并使用 UART v2;系统自动兼容旧版串口协议。
- 启用 SPIFFS 文件系统
固件使用 SPIFFS 文件系统进行存储。
- 建立固件入口
将主程序入口放在 firmware/src/main.cpp。
- 建立统一机器人接口
通过 robot.h 提供六足与四足共用的统一机器人抽象接口。
- 实现六足机器人模块
使用 hexapod.h/cpp 实现六足机器人,使用 quad_robot.h/cpp 实现四足机器人。
- 实现单腿控制模块
使用 leg.h/cpp 实现单腿控制,由六足和四足分别实现或复用。
- 配置运动控制模块
使用 movement*.h/cpp 保存运动控制算法与配置表。
- 实现动作规划执行器
使用 motion_controller* 执行动作序列和运动规划。
- 实现电源管理模块
使用 power_manager* 实现电池采样、低电量锁存和状态快照。
- 实现 UART 流式协议
使用 uart_protocol* 实现 UART v2 和旧版协议的有界流式处理。
- 实现图传设备控制
使用 camera_link* 管理图传设备状态和配网控制。
- 实现正运动学计算
根据关节角度计算足端位置。
- 实现逆运动学计算
根据目标位置计算关节角度。
- 实现坐标变换
实现世界坐标系与局部坐标系之间的转换。
- 按教程编译并烧录
阅读并执行“六足机器人NodeHexa复刻教程(四)编译烧录篇”。
- 安装 PlatformIO 插件
推荐使用安装了 PlatformIO 插件的 VSCode IDE。
- 选择固件构建环境
根据主板代际选择对应环境,NodeHexa v2 使用 nodehexa-v2 环境。
- 构建应用固件
进入 firmware 目录,并在 nodehexa-v2 环境中构建应用固件。
- 构建并一同烧录 SPIFFS
使用 nodehexa-v2 环境构建 SPIFFS,并将应用固件和 SPIFFS 一起烧录。发布包的 version.json 记录 supportedHardware、uartProtocolVersion 和 legacyUartSupported。
- 配置超声波单次测量
让超声波只在 REST 明确请求时执行一次测量,不自动触发避障或运动。
- 实现 UART v2 数据格式
使用二进制外层和 UTF-8 JSON 载荷。多字节整数采用小端序,最大载荷为 512 字节。
- 处理 UART 半帧超时
接收半帧超过 250 ms 时丢弃该帧并重新同步。
- 校验 UART v2 帧
使用 poly 0x1021、init 0xffff 的 CRC,覆盖从 Version 到 Payload 末尾。REQUEST 的 RESPONSE 使用相同 Sequence,EVENT 不参与请求等待。
- 完成外设 HELLO 握手
外设启动后发送 HELLO,device 可设为 camera、xiaozhi 或通用设备。主控返回协议、机器人类型、固件版本和明确的 power.lowBatteryLatched。
- 检测 UART 外设离线
V2 外设连续超过 6 秒没有有效帧时,在能力接口中标记为离线。
- 连接摄像头至网络
通过 UART HELLO 识别图传板后,主控下发当前 AP 的 SSID 与密码。摄像头只作为 STA 接入 NodeHexa 网络,不创建用户配置热点。
- 设置摄像头图像配置
默认使用 QVGA,可切换到 VGA;JPEG quality 固定为 80。
- 报告摄像头错误
通过 cameraStatus EVENT 和 /api/caps 统计报告摄像头过流、采集错误或编码错误。
- 读取机器人能力与诊断
请求 GET /api/caps,读取机器人、固件、硬件、UART 统计、电源和外设能力信息。
- 通过 REST 切换配置
向 POST /api/camera/profile 提交 {"profile":"qvga"} 或 {"profile":"vga"},选择摄像头图像配置。
- 设置 PlatformIO PATH
在 PowerShell 中运行脚本,将 PlatformIO 添加到当前会话的 PATH。永久生效需手动添加到系统环境变量,也可以每次使用前运行脚本。
- 使用立创EDA标准版打开工程
使用立创EDA标准版导入并打开下载的PCB工程文件。
标定与测试
- 监测电池电压
实时监控电池电压。
- 配置低电压保护
启用低电压锁存告警、不可关闭的蜂鸣器报警,并选择安全卸力、保持姿态或仅报警策略。
- 按教程调试机器人功能
阅读并执行“六足机器人NodeHexa复刻教程(五)功能调试篇”。
- 进入舵机校准页面
访问 /calibration 页面进行舵机校准。
- 调整机器人设置
可在设置中调整 WiFi AP、低电量策略和动作按钮模式。
- 进入校准模式
使用校准功能一键进入校准模式。
- 微调每个舵机角度
在校准页面实时微调每个舵机的角度,并实时查看调整效果。校准数据会自动保存。
- 确认低电量锁存行为
连续两次采样确认低电量后,状态被锁存;只有重新上电才能清除。
- 配置低电量处置策略
使用 /api/settings 设置低电量策略,配置运动和舵机输出的处置方式。LED、Web、UART 与蜂鸣器始终报告锁存状态。
- 测试低电量报警
低电量报警在开机提示音和遥控器连接提示音中具有最高优先级,不能通过 Web 或串口关闭。
- 读取并保存机器人设置
使用 GET /api/settings 读取设置,并使用 POST /api/settings 保存低电量策略与动作按钮模式。
- 检查超声波测量结果
驱动使用 30 ms 硬超时。未接模块或 Echo 超时时,返回 valid=false 并增加超时计数。
用起来
- 连接机器人 WiFi 热点
机器人开机后,连接名为“NodeHexa”的 WiFi 热点,密码为 roboticscv666。
- 打开 Web 控制界面
在浏览器中访问 http://192.168.4.1,进入机器人控制界面。
- 打开运动规划页面
访问 /planner 页面,编排并发送机器人动作序列。
- 开始控制机器人
完成连接和配置后,开始控制机器人运动。
- 执行基础运动控制
使用前进、后退、转向和侧移等运动控制命令。
- 调整机器人姿态
使用三轴旋转和扭转动作控制机器人姿态。
- 运行表演模式
可运行自由律动、节拍摇摆和登场秀表演模式。
- 控制单条腿运动
仅六足机器人可单独选择一条腿,实时控制该腿的平移或抬升。
- 查看实时电量状态
通过电量徽章实时查看电压、估算电量和低电量状态。
- 管理设置和固件信息
从设置入口修改 WiFi AP、低电量策略和动作按钮模式,并查看固件版本。
- 编排并发送动作序列
进入 /planner 编排并发送动作序列,也可直接执行单段动作。
- 查看规划页电量
运动规划页面与主页面同步显示实时电压和电量百分比。
- 执行单段限制动作
执行一段限定周期、步数或距离的动作;姿态类动作仅支持周期。
- 串行执行动作序列
将多段动作串行执行,序列最多包含 5 段。
- 管理动作队列
可向队列追加动作、清空队列,并使用紧急停止。
- 打开摄像头视频流
在浏览器中直接访问摄像头的 81 端口。视频不经过 UART 或主控内存。
- 管理 MJPEG 客户端连接
页面进入后台、退出视频模式或摄像头离线时主动断开 MJPEG,同时只允许一个 MJPEG 客户端。
- 请求超声波测距
GET /api/ultrasonic 返回最近一次测距,增加 ?fresh=1 可异步发起新测量,响应中的 pending 表示后台测量状态。