正在连接信源…

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 表示后台测量状态。

文档