ESP-Hi AI 对话机器狗 复刻全流程
ESP-Hi AI 对话机器狗 从采购、打印、组装到装软件、标定和训练的 229 个步骤,附物料表、购买链接与官方出处。
立创页“复刻成本”栏为 49.9 元(创作者估算,页面无 BOM 明细,未写是否含舵机底座、电池、3D 打印与运费);乐鑫不销售,Tindie 第三方卖家 49.00 美元(2026‑11‑01,运费另计)
采购
- 选择 MAX98357A 功放
使用带数字 I2S 输入的 MAX98357A 功放模块,将扬声器接到功放的两个输出端。
- 识别 HT517 功放模块
通过外观识别 HT517 模块。使用时,应按实际模块规格核对输入、供电、使能和喇叭插头,不能只按图中排针位置互换。
- 选择 8 欧姆扬声器
本页选择 8Ω、3W 扬声器。
- 核对 4 欧姆扬声器选项
如果选择 4Ω 扬声器,需要另核对功放负载和电源余量。
- 选择两块 400 孔面包板
选择两块可拼的 400 孔面包板。
- 选择面包板短跳线
选择用于面包板的短跳线。
- 选择匹配的杜邦线
按模块和主板排针选择杜邦线端头。
- 选择可选轻触按钮
轻触按钮为可选项。安装前确认导通关系,因为同侧引脚可能已经连通。
- 选择 128×32 OLED
需要该分辨率时,可选择 0.91 英寸 128×32 OLED 显示屏。
- 选择 128×64 OLED
需要该分辨率时,可选择 0.96 英寸 128×64 OLED 显示屏。
- 初次搭建跳过 4G 模块
第一次搭建 Wi-Fi 版无需购买 4G 模块。
- 准备本体装配材料
在装配 ESP-Hi 本体前,按材料表准备好所需材料。
- 准备底座装配材料
在装配机器狗底座前,按材料表准备好所需材料。
- 准备ESP-Hi扬声器
准备 8 欧、1 瓦、2014B 方形腔体喇叭。
- 准备ESP-Hi麦克风
准备 4 个 1.5 毫米麦克风。
- 准备ESP-Hi显示屏
准备 0.96 寸京东方 TFT 插接式胶铁一体显示屏。
- 准备底座锂电池
准备 702040 聚合物锂电池,为底座的舵机和电源电路供电。
- 准备底座舵机
准备 180 度 SG92R 舵机。机器狗底座由四个舵机构成。
- 购买 HU-087 手表形态套件
从文档给出的商品链接购买该手表形态套件,它是最便宜的套件之一。
打印与加工
- 下载开源结构文件
从附件下载 ESP-Hi 的开源结构件文件,用于复刻打印件。
- 准备本体打印件
准备一个打印外壳和一个遮光消噪结构件;本体的正面亚克力面板厚度为 1 mm。
- 准备机器狗底座打印件
为机器狗底座准备 4 个 3D 打印零件,并按爆炸图确认各零件的位置。
- 制作 1.2 毫米主板
制作 ESP-Hi MainBoard PCB 时,打板厚度选择 1.2 mm。
- 制作机器狗底座 PCB
制作机器狗底座使用的 ServoDogBoard PCB 板。
组装
- 布置面包板
拼接两块面包板,把主控放在中间,并在两侧插入模块。
- 检查面包板孔位分组
注意中间每排的两组五孔由沟槽隔开。布线前确认孔位导通关系以及电源长轨是否中断。
- 连接共享 I2C 的 OLED
这两种屏幕可以共享 GPIO41/42 的 I2C 接线。
- 接线前断开所有电源
开始任何接线前,断开所有电源。
- 按 GPIO 丝印定位排针
根据开发板 GPIO 编号和电源丝印寻找位置,不要按照片左右方向或排针序号推断。还要确认面包板电源长轨是否在中间断开。
- 为麦克风和 OLED 供电
将 INMP441 和本文所述 OLED 接到 3V3,不要接 5V。
- 从 5V 节点给功放供电
MAX98357A 模块使用开发板上的 5V 电源节点。先核对板卡原理图;此处仅适用于电源连线与官方原理图一致、由 USB 单独供电的 DevKitC-1。
- 连接各模块信号地
将各模块的信号地连接到开发板 GND。功放的扬声器负端不属于信号地。
- 避免裸引脚取电和重复供电
不要从稳压器裸引脚取电,也不要另外向开发板的 5V 或 3V3 注入第二路电源。
- 完成当前方案的完整接线
按照完整接线图连接麦克风、功放、扬声器和 OLED,再使用后面的表格逐根检查连接。
- 对应 44 针乐鑫标准版
使用 44 针位置总图查找带标注的排针。搭建 Wi-Fi 版时,跳过整个 4G/LDO 分支,并按本页方案从开发板 5V 节点给功放供电。
- 对应 42 针果云版
使用 42 针位置总图,因为该板的电源排针位置不同。搭建 Wi-Fi 版时,跳过整个 4G/LDO 分支,并按本页方案从开发板 5V 节点给功放供电。
- 核对两种板型的信号关系
两张图中的信号关系相同:麦克风使用 GPIO4/5/6,功放使用 GPIO7/15/16,OLED 使用 GPIO41/42。使用同一个 bread-compact-wifi 构建前,还要确认芯片、内存和模块均匹配。
- 不要用板子左右位置推断 GPIO
根据名称标出的 GPIO 识别每项连接,不要把开发板左右位置当成 GPIO 编号。
- 连接 INMP441 麦克风
按图中的 GPIO4/5/6 信号关系、3V3 供电和开发板 GND 连接 INMP441。麦克风 SD 是输出,接到固件的输入 DIN;供电和声道选择依据 INMP441 数据手册。
- 检查麦克风排针方向
先确认模块哪一面朝上,再按丝印上的同名信号对应。44 针板或 42 针板排针反装时,分别使用对应位置图;电气信号仍按 WS、SCK、SD 对应。
- 设置功放并连接扬声器
连接功放与扬声器,并按模块厂商的默认工作设置处理 SD/MODE、GAIN。若裸板需要外部电阻或使能信号,应先补齐模块电路,不能假定输入悬空也能工作。
- 直连麦克风与功放
不使用面包板时,按图识别麦克风与 MAX98357A 之间的连接。信号对应关系应与音频表一致,并按本页选定的电源和实际模块工作设置调整图示的 3V3 功放支路与短接线。
- 连接 I2C OLED
连接 OLED 的 VCC、GND、SDA、SCL 四根线。本板型使用 I2C 地址 0x3C;128×32 与 128×64 屏幕需选择不同固件变体,SH1106、SPI 屏幕或其他地址不能仅靠改接线变成同一方案。
- 连接可选外接按键
需要外接按钮时,将 GPIO0、GPIO40、GPIO39 的另一端分别通过按钮接到 GND,对应本版 BOOT、音量加、音量减。四脚轻触开关应先确认内部已连通的两脚,且不能把按钮两端插进面包板同一个连通排。
- 检查模块下方隐藏接线
装上模块前先拍照检查模块下方,确认电源、GND 与信号没有错一排,并检查面包板长电源轨的跨接是否完整。
- 核对整体布局与接线
根据照片核对整体布局、焊线或杜邦线接法以及 OLED 完成状态。
- 按方案连接功放与4G电源
按已经确定的方案连接功放与 4G 电源,不要用照片中的线色代替信号名。
- 固定扬声器和 PCB
先将扬声器固定在本体结构件上,再将 PCB 固定到打印外壳上。
- 嵌入天线并放入 USB 口
先将左侧和顶部嵌入外壳,再利用 3D 打印外壳的韧性将 USB 口放入外壳,注意天线与外壳距离很近。
- 安装遮光消噪结构件
在 PCB 与打印面板之间安装遮光消噪结构件,以降低麦克风拾音噪声。
- 粘贴显示屏到亚克力面板
将显示屏粘贴到正面亚克力面板。先把屏幕固定到附件中的粘贴治具上,粘贴完成后取下屏幕。
- 安装底座 PCB 电池和舵机
先将 PCB 板、电池和四个舵机依次装入底部外壳。
- 按丝印连接舵机引脚
按照 PCB 板上的丝印标号插入舵机引脚,避免接错引脚顺序。
- 安装 PCB 前盖板
将 PCB 前盖板装到底座上。
- 安装外壳上盖
将外壳上盖装到底座上。
- 固定舵臂到打印腿
从舵机配件包中选出最小的舵臂,用最小的螺丝将其固定在 3D 打印腿上。
- 将打印腿装到舵机
将装好舵臂的打印腿安装到舵机上,并用螺丝固定。
- 连接 USB Type-C 供电
使用 USB Type-C 供电,并通过 RT9013 将电压降至 3.3 V,供 MCU 与音频部分使用。
- 选择低调整率稳压芯片
ESP32-C3 在 Wi-Fi 发包时瞬态电流较高,推荐使用负载调整率尽可能低的 LDO 或 DCDC 芯片。
- 分离麦克风电源噪声
在麦克风电源端增加低通滤波电路,分离麦克风与 MCU 的电源轨,防止电源噪声引入麦克风端。
- 连接驻极体麦克风电路
使用驻极体咪头拾音,以跨阻抗放大器将输出电流转换为电压,再经电阻偏置送至 ESP32 的 ADC。
- 连接差分 I2S-PDM 输出
发声部分使用 I2S-PDM 信号直出,并以差分方式传输,以避免 Wi-Fi 传输干扰输出信号。
- 设置 NS4150B 音频放大
I2S-PDM 输出经过 RC 滤波后,由 NS4150B 音频运放放大,输出放大倍数设为 7.2 倍。
- 组装四舵机底座
用四个舵机构成机器狗底座,并将舵机控制线通过 USB-C 直连 ESP-Hi 本体。舵机由电池直接供电,底座将电池电压升压到 5 V 后为 ESP-Hi 本体供电。
软件与固件
- 保持自定义板卡配置独立
如果自定义板卡的 IO 配置与现有板卡不同,请创建新的板卡类型,或使用 `config.json` 中的 `builds` 数组生成具有不同 `sdkconfig` 宏的独立固件名称。为每个板卡设置唯一标识和独立的固件更新通道。
- 创建自定义板卡目录
在 `main/boards/` 下创建一个目录,命名样式为 `[vendor]-[model]`,例如 `m5stack-tab5`。
- 构建自定义板卡固件
将板卡目录作为参数传给 `python scripts/build.py` 来构建固件。
- 创建板卡 JSON 配置
创建 `config.json`,将 `type` 设为 `my-custom-board`、`target` 设为 `esp32s3`,添加名为 `my-custom-board` 的构建,并在 `sdkconfig_append` 中加入 `CONFIG_ESPTOOLPY_FLASHSIZE_8MB=y` 和 `CONFIG_PARTITION_TABLE_CUSTOM_FILENAME="partitions/v2/8m.csv"`。`type` 表示板卡系列,`target` 必须与实际芯片匹配,`name` 表示固件变体,`sdkconfig_append` 会合并到默认 sdkconfig 中。
- 验证板卡和构建名称
`type` 和 `name` 只能使用小写字母、数字、句点和连字符,不能使用下划线、空格或大写字母。发布后保持 `type` 稳定,`name` 通常应与 `type` 相同。
- 添加常用 sdkconfig 项
文档中的常用配置项可设置 4MB 或 8MB 闪存、4MB 或 8MB 分区表,以及通过 `CONFIG_USE_DEVICE_AEC=y` 启用设备端 AEC。将板卡配置需要的项目加入 `sdkconfig_append`。
- 避免重复默认设置
项目在适用目标上默认使用 16MB 闪存和 `partitions/v2/16m.csv`。不要重复与项目当前有效配置相同的值。
- 创建板级源文件
创建 `my_custom_board.cc`,用于实现板级功能。
- 声明板级类
通过继承 `WifiBoard` 或 `Ml307Board` 声明板级类。
- 添加板级初始化辅助函数
添加 I2C、显示屏、按键以及 IoT/MCP 工具的初始化辅助函数。示例定义了 I2C 和 SPI 初始化函数,并保存编解码器 I2C 总线、启动按键和显示屏对象。
- 实现所需的虚函数重写
实现 `GetAudioCodec()`、`GetDisplay()` 和 `GetBacklight()` 等虚函数重写。
- 注册板级类
使用 `DECLARE_BOARD(ClassName)` 注册板级类。
- 初始化 SPI 总线
使用总线配置和自动 DMA 通道完成 SPI 2 初始化。
- 配置启动按键
注册启动按键的点击回调。设备启动期间进入 Wi-Fi 配置模式,否则切换聊天状态。
- 配置显示屏 SPI 接口
创建 LCD SPI 接口配置,使用定义的 CS、DC 引脚、SPI 模式 2 和 80 MHz 像素时钟。
- 配置 LCD 命令参数
将 SPI 事务队列深度设为 10,并为 LCD 命令和参数都使用 8 位,然后创建面板 SPI 接口。
- 创建 ST7789 显示面板
将面板配置为无复位 GPIO、RGB 元素顺序和每像素 16 位,然后创建 ST7789 面板。
- 初始化并设置面板方向
初始化面板、启用颜色反转,并应用定义的轴交换和镜像设置。
- 创建 SPI LCD 显示屏
使用面板接口、面板句柄、定义的尺寸和偏移、镜像设置及轴交换设置创建 SpiLcdDisplay。
- 添加 MCP 工具入口
将 InitializeTools 函数保留为按照 docs/mcp-usage.md 注册 MCP 工具的位置。
- 初始化自定义开发板
使用配置的启动按键 GPIO 构造开发板,依次初始化 I2C、SPI、显示屏、按键和工具,并将背光亮度设为 100。
- 配置 ES8311 音频编解码器
在 I2C 总线 0 上创建 ES8311 音频编解码器,并使用定义的输入和输出采样率。
- 连接音频编解码器引脚
使用定义的 I2S MCLK、BCLK、WS、数据输出、数据输入、功放和 ES8311 地址引脚配置编解码器,然后返回该编解码器。
- 返回显示屏实例
返回开发板初始化时创建的显示屏实例。
- 配置 PWM 背光
使用定义的背光 GPIO 和输出反转设置创建 PWM 背光,然后返回背光实例。
- 声明自定义开发板
使用开发板声明宏声明 MyCustomBoard。
- 添加自定义板卡 Kconfig 条目
在 `main/Kconfig.projbuild` 的 `choice BOARD_TYPE` 块中添加 `BOARD_TYPE_MY_CUSTOM_BOARD`。使用大写字母和下划线分隔的标识符,并将 `depends on` 设置为匹配的目标,例如 `IDF_TARGET_ESP32S3` 或 `IDF_TARGET_ESP32C3`。
- 添加自定义板卡 CMake 分支
打开 `main/CMakeLists.txt`,在板卡类型链中添加 `elseif(CONFIG_BOARD_TYPE_MY_CUSTOM_BOARD)` 分支。将 `BOARD_DIR` 设置为 `my-custom-board`,选择 `BUILTIN_TEXT_FONT` 和 `BUILTIN_ICON_FONT`,并可选地将 `DEFAULT_EMOJI_COLLECTION` 设置为 `twemoji_64`。
- 选择显示字体和表情集合
根据显示屏分辨率选择字体大小:128x64 OLED 使用 `font_puhui_basic_14_1` 和 `font_awesome_14_1`,240x240 使用 `font_puhui_basic_16_4` 和 `font_awesome_16_4`,240x320 使用 `font_puhui_basic_20_4` 和 `font_awesome_20_4`,480x320 及更大屏幕使用 `font_puhui_basic_30_4` 和 `font_awesome_30_4`。小屏幕使用 `twemoji_32`,大屏幕使用 `twemoji_64`。
- 设置 ESP32 目标芯片
为自定义板选择 ESP32-S3、ESP32-C3 或 ESP32。首次配置板或切换目标时运行此步骤。
- 清理过期的构建配置
在配置和构建板之前删除过期配置。
- 选择自定义板类型
打开 menuconfig,进入 `Xiaozhi Assistant -> Board Type` 并选择自定义板。
- 构建、烧录并监控固件
构建固件,将其烧录到板并启动串口监视器。
- 自动配置并构建板
当自定义板目录包含 `config.json` 时,使用板名称运行构建脚本以自动配置并构建。
- 选择语言和唤醒词
使用 `--language` 设置界面语言和语音提示,并使用 `--wake-word` 覆盖基于语言的默认唤醒词。默认语言为 `en-US`;中文使用 `zh-CN`,其他区域设置列在 `main/assets/locales/` 下。
- 为目标匹配唤醒模型
ESP32-C3、C5 和 C6 目标使用 WakeNet9s(`wn9s_*`)模型。ESP32-S3、P4 和 S31 目标使用 AFE 引擎并要求 PSRAM;ESP32 同样要求 PSRAM,并使用不带 AFE 的引擎。
- 在板上启用唤醒词检测
在不受支持或明确禁用的板上启用唤醒词检测的请求,会在 SDK 配置前被拒绝。受支持的目标会选择兼容模型,并遵循文中所述的 PSRAM 要求。
- 准备 Custom 和 Emote 资源
Custom 和 Emote 资源保留其 UI 资源,但其打包语音模型会被当前 `sdkconfig` 中选择的模型替换,或在禁用唤醒词检测时移除。最终软件包必须能容纳在 assets 分区内。
- 列出语言和唤醒词
以文本或 JSON 格式查询可接受的语言和唤醒词值。
- 列出前解析 ESP-SR 组件
唤醒词列表读取自当前解析出的 ESP-SR 组件。如果尚未填充 `managed_components/`,请先运行 `idf.py reconfigure`。
标定与测试
- 不要仅依赖 RGB LED 判断
不要将 RGB LED 点亮视为接线成功的通用判断,应检查按钮、显示屏、录音/播放和对话功能。
- 检查替代麦克风模块
如果用 ZTS6672 或 ICS43434 替代 INMP441,使用前应检查引脚方向、通道和固件配置。
- 检查 HT517 模块规格
识别 HT517 模块后,检查其实际输入、供电、使能行为和扬声器连接器规格,不要仅凭排针位置直接替换。
- 单独检查 4Ω 扬声器
将封闭式 4Ω 扬声器作为示例,并单独检查放大器负载和功率余量。
- 检查 OLED 兼容性
不能仅通过重新接线,将 SH1106 显示屏、SPI 显示屏或其他地址的显示屏视为与该 OLED 等效。
- 采用当前按钮行为定义
按钮行为应以当前开发板实现为准,而不是旧图片中的“reset Wi-Fi”标签。
- 安装模块前检查连接
安装模块前拍摄并检查电源、GND 和信号连接,包括跨接分体电源轨的桥接线。
- 断电检查全部接线
断开电源并检查每根电源线和信号线。
- 确认电气连接正确
确认没有电源轨短路、两个放大器输出均未接地,并且没有错位一针的连接。
- 检查显示屏和启动声音
重启开发板并检查显示屏和启动声音。
- 不要仅依靠 LED 颜色判断
不同 DevKit 版本的 RGB 引脚不同,因此不能仅凭 LED 颜色判断是否成功。
- 测试一次 BOOT 对话
先使用 BOOT 开始一次对话,然后再测试所选固件支持的唤醒词。
- 检查自动唤醒词选择
在受支持的板上,省略 `--wake-word` 时,`zh-CN` 和 `zh-TW` 选择“你好小智”,其他语言选择“Hi ESP”。不受支持的板和明确选择退出的变体保持禁用。
- 选择有效的唤醒词选项
唤醒词选项接受 ESP-SR 模型名称、`nihaoxiaozhi`、`hiesp` 或 `disabled`。两个别名会为目标选择兼容模型。
- 为手动构建配置唤醒词
直接使用 `idf.py` 构建时,在 `menuconfig` 中明确选择唤醒词实现和模型。芯片默认值不会选择模型,全新的手动配置会保持唤醒词检测禁用。
- 逐步启动开发板
先启动显示屏,再启动音频,最后启动完整系统。
- 检查硬件兼容性
检查编解码器、PMIC 和触摸控制器组合的兼容性。
- 排查显示异常
如果显示异常,请检查 SPI 配置、镜像设置和颜色反转设置。
- 排查无音频问题
如果没有音频,请检查 I2S 接线、PA 使能引脚和编解码器 I2C 地址。
- 排查 WiFi 连接问题
如果无法连接 WiFi,请重新检查 WiFi 凭据和配置方式。
- 排查服务器连接问题
如果无法连接到服务器,请验证 WebSocket 或 MQTT 端点配置。
- 测试面包板电源轨
保持断电,用通断测试确认电源长轨是否连通、是否在中途断开。
- 核对 OLED 针脚顺序
按自己的屏幕丝印核对针脚顺序与 VCC/GND 位置。
- 初次测试使用低音量
初次测试从低音量开始,因为 USB 供电能力、线材和功放负载会影响稳定性。
- 断电检查全部接线
断电后检查每一根电源线和信号线,确认电源轨未短路、功放两个输出未接地,且接线没有误入相邻排针。
- 测试对话与唤醒词
先按 BOOT 开始一轮对话,再测试所选固件支持的唤醒词。
- 确认机器人已经完成
确认 OLED 显示完整、启动提示可听见,并且设备已联网并出现在自己的控制台。
- 测试对话与语音播放
按键开始对话,检查设备能听到问题并播放回答,同时确认播放时设备不会重启。
- 配置 BUTTON3 短按功能
将 BUTTON3 配置为短按时打断或唤醒。
- 配置 BUTTON1 音量增加
将 BUTTON1 配置为音量增加。
- 配置 BUTTON2 音量减少
将 BUTTON2 配置为音量减少。
- 重启并检查启动提示
关闭连接,按下 RESET/EN 或给设备断电重启,然后检查启动提示。
- 验证已烧录的固件
确认写入和校验均已成功。重启后,检查预期的开发板固件和版本是否正在运行,并确认显示了预期画面且播放了启动音。
- 设置舵机微调值
使用 `self.electron.set_trim` 设置单个舵机的微调值,范围为 `-30` 到 `30`。微调值会永久保存;示例将 `head` 舵机的 `trim_value` 设为 `0`。
- 读取舵机微调值
调用 `self.electron.get_trims` 读取当前微调值。
- 按麦克风灵敏度调整 R18
ESP32-C3 的电压采集范围约为 0~1 V,应根据所选咪头的实际灵敏度调整 R18。
用起来
- 执行头部动作
通过 `self.electron.head_move` 调用头部动作:`1` 抬头、`2` 低头、`3` 点头一次、`4` 回中、`5` 连续点头。示例参数为 `steps: 1`、`speed: 1000`、`angle: 5`。
- 调节头部舵机
通过 `self.electron.servo_move` 调用单舵机调节,可以使用完整舵机名或短键。示例调节 `head` 舵机到 `position: 100`,速度为 `800`;角度会按固件安全范围自动裁剪。
- 调节身体舵机
使用短键 `rp` 调用 `self.electron.servo_move`,将对应舵机移动到 `position: 120`,速度为 `800`。角度会按固件安全范围自动裁剪。
- 创建普通移动序列
通过 `self.electron.servo_sequences` 调用动作序列,`sequence` 必须是 JSON 字符串。普通移动动作示例同时设置 `rp`、`lp` 和 `h` 舵机位置,并设置速度 `v` 和持续时间 `d`。
- 创建振荡动作序列
在 `sequence` 的 JSON 字符串中使用 `osc` 定义振荡动作。示例设置振幅 `a`、振荡范围 `o`、相位 `ph`、周期 `p` 和循环次数 `c`。
- 通过 WebSocket 调用序列
通过 WebSocket 使用 `self.electron.servo_sequences` 调用完整动作序列。示例的 `sequence` JSON 字符串同时包含普通移动动作和振荡动作。
- 复位舵机
动作完成后,调用 `self.electron.home` 显式复位。
- 查询机器人状态
调用 self.electron.get_status 查询机器人状态。
- 查询机器人 IP 地址
调用 self.electron.get_ip 查询机器人的 IP 地址。
- 查询电池电量
调用 self.battery.get_level 查询电池电量。
- 设定机器人角色与自由度
将角色设定为可爱的桌面级机器人,并配置左手 pitch/roll、右手 pitch/roll、身体旋转和头部上下六个自由度。
- 配置动作情绪表达
配置点头、挥手、举手、低头和抬头等动作,用于表达同意、打招呼、高兴、思考、好奇和告别。
- 优先使用简短自然动作
对话时优先选择简短自然的动作。
- 编排复杂动作并复位
复杂表现使用 self.electron.servo_sequences 分段编排动作,完成后调用 self.electron.home 复位。
- USB 接口仅用于充电
板载 USB 接口没有连接到 ESP32-S3 的 USB 引脚,只能用于充电。
常见问题
物料
- 头部:ESP-Hi MainBoard(ESP32‑C3,4 MB Flash,1.2 mm 板厚),RT9013 LDO 供 3.3V
- 4×1.5 mm 驻极体麦克风、8Ω 1W 2014B 腔体喇叭、NS4150B 功放、0.96 寸京东方插接式 TFT
- 头部结构:3D 打印外壳与遮光消噪件、1 mm 亚克力面板、M2×4 自攻螺丝
- 机器狗底座:ServoDogBoard、4 个 180° SG92R 舵机、702040 500 mAh 锂电池、4 个 3D 打印件、TC‑005 公头 Type‑C 插头;电池升压到 5V 供头部
工具
- PCB 打板选 1.2 mm 板厚;贴片焊接工具
- 3D 打印机;附件含屏幕辅助粘贴治具
- 烧录用 USB 线(按住 Boot 键上电进入下载模式)
技能
- 贴片焊接与小件装配(舵机线序按丝印插接)
- ESP‑IDF 编译烧录,或直接烧录附件固件(地址 0x00)
- 小智 AI 配网与 xiaozhi.me 后台配置
软件
- xiaozhi-esp32 的 espressif/esp-hi 板型(python scripts/build.py espressif/esp-hi),内置 esp-hi.local 网页控制
- Gitee 例程:web_control、servo_dog、audio_loop_test、wake_word_test、lcd_audio、music_player、sensor_test 与出厂固件
- 乐鑫组件库 espfriends/servo_dog_ctrl 0.2.0(2026‑07‑15,适配 IDF v6)