正在连接信源…

Sesame 开源四足机器人(Sesame Robot Project) 复刻全流程

Sesame 开源四足机器人(Sesame Robot Project) 从采购、打印、组装到装软件、标定和训练的 286 个步骤,附物料表、购买链接与官方出处。

README 称硬件约 50–60 美元,需自备 3D 打印机;不含耗材、工具与运费。FCE 整套套件 100 美元、电子套件 85 美元(2026‑10‑31 均标售罄)

物料 · Core Electronics (Both Builds)

零件数量
180 degree MG90S all-metal micro servos · Amazon8 (buy 10 for spares
0.96" SSD1306 I2C OLED · Amazon1
USB-C data/power cable · Amazon1
Rocker power switch (KCD1, panel mount) · Amazon1
22AWG silicone wire kit · Amazon1
30AWG silicone wire kit · Amazon1
Heat-shrink assortment · Amazon1
Small zip ties · Amazon1 pack

物料 · Wiring Option A – S2 Mini / Hand-Wired Harness

零件数量
Lolin/WeMos ESP32-S2 Mini · Amazon1
Small protoboard (approx. 5×7 cm) · Amazon1
3-pin male headers · Amazon8
Buck converter (5–12 V in to stable 5V/3A out) · Amazon1

采购

  • 选择接线策略并查阅构建指南

    选择适合现有零件的接线策略,然后按照 docs/build-guide/README.md 中的构建流程进行。

  • 购买 180 度 MG90S 金属齿轮舵机

    购买 8 个 180 度 MG90S 全金属微型舵机;也可购买 10 个并留作备用。它们是髋部和腿部的主要执行器,附带舵机盘,但应保留多余舵机盘。

  • 购买 0.96 英寸 SSD1306 OLED

    购买 1 个 0.96 英寸 SSD1306 I2C OLED。这是 128×64 显示器,可滑入顶盖插槽。

  • 购买 USB-C 数据与电源线

    购买 1 根 USB-C 数据与电源线。线缆需要支持 5V/3A,用于刷写和有线连接模式。

  • 购买 KCD1 翘板电源开关

    购买 1 个面板安装式 KCD1 翘板电源开关。它会卡入顶盖开孔。

  • 购买 22AWG 硅胶线套件

    购买 1 套 22AWG 硅胶线,用于电源和地线总线。

  • 购买 30AWG 硅胶线套件

    购买 1 套 30AWG 硅胶线,用于信号引线和密集布线。

  • 购买热缩管套装

    购买 1 套热缩管,用于 OLED、开关和电池接头的绝缘。

  • 购买小号扎带

    购买 1 包小号扎带,用于在机架内部捆扎电线。

  • 购买 ESP32-S2 Mini

    购买 1 个 Lolin/WeMos ESP32-S2 Mini;它带原生 USB-C 接口,可安装在洞洞板上。

  • 购买小型洞洞板

    购买约 5×7 cm 的小型洞洞板 1 个,用于安装排针矩阵和电源轨。

  • 购买三针公排针

    购买 3 针公排针 8 个,用于制作舵机转接板;间距需与 MG90 插头匹配。

  • 购买降压转换器

    购买 1 个输入 5–12 V、输出稳定 5V/3A 的降压转换器,用于电池供电时为电机和 MCU 供电。

  • 确认套件中的配电板

    购买 Sesame Build Kit 时,套件已包含完成装配并预刷写的 V2 配电板,无需另行订购这些零件。

  • 确认已有 V1 板

    仅在已经拥有 V1 配电板时选择此旧版方案;V1 已停产,但仍受支持。

  • 购买 ESP32-DevKitC-32E

    购买 1 个 ESP32-DevKitC-32E(ESP32-WROOM-32)作为 V1 配电板的底板。可使用带浮动 PCB 天线的 32E,或使用需要在内部布设天线的 32U。

  • 购买电解电容

    购买 1 个 1000 µF 电解电容,用于平滑降压转换器的输出电压;建议额定电压为 10V 或更高。

  • 购买四针连接器排针

    购买 1 个 4 针 JST-XH 或 PH 排针,作为 PCB 上可选的外部连接器接口。

  • 购买两针螺钉端子

    购买 1 个 2.54 mm 间距的两针螺钉端子,作为 PCB 上可选的电池输入接口。

  • 购买 M2.5 隔柱

    购买 4 个 M2.5×5 mm 公母隔柱,用于将 PCB 垫高在 DevKit 安装孔上方。

  • 选择兼容的库存电池

    Bambu Lab 14500 7.4V 800mAh 锂离子电池可装入新的标准电池仓;V3 需要打印新的内部框架。

  • 每条腿使用两个舵机

    为每条腿选择一个髋关节舵机和一个膝关节舵机。

  • 选择Sesame Distro Board V3

    Distro Board V3是当前版本。它预装了最新固件,并支持Bambu Lab电池。

  • 从零搭建可选Lolin S2 Mini

    Lolin S2 Mini手工接线构建仍受完整支持。如果从零开始搭建,文档推荐使用该方案。

  • 收集零件

    准备八个 MG90 舵机、一个 S2 Mini 或 Distro Board、OLED 显示屏和电源。完整物料清单见仓库中的 BOM。

  • 购买 Sesame 所需零件

    准备八个 MG90 伺服器、一个 ESP32(Lolin S2 Mini 或 Sesame Distro Board)、一个 128x64 OLED 显示器、一个 5 V 3 A 电源和 PLA 打印丝,总成本约为 50 至 60 美元。

  • 准备构建工具和软件

    准备 3D 打印机或打印服务、烙铁、小号螺丝刀,以及安装了 Arduino IDE 和 ESP32 boards package 的电脑。

  • 获取 Sesame 项目文件

    从 GitHub 仓库获取 CAD、STL 文件、固件、Sesame Studio、物料清单和构建指南。

  • 使用套件内预刷写主板

    Sesame Build Kits 已包含预刷写的 Sesame Distro Board V3 或更早的 V2,因此无需另行订购或组装主板。

  • 选择 S2 Mini 手工接线

    从零制作时,建议采用 S2 Mini 手工接线方案。V2/V3 配电板使用需要专业焊接技能或 PCB 组装服务的高级 SMD 元件。

  • 购买预组装 V3 主板

    可从 Full Contact Engineering 购买数量有限的预组装 Sesame Distro Board V3。V3 的 USB-C PD 12V 协商芯片测试尚不充分,因此必须使用高质量 PD 电缆。

  • 获取 V1 设计文件

    所有 V1 文件都位于 distro-v1/ 目录中。

  • 收集电子件、连接器和紧固件

    在开始焊接前,按照BOM收集电子件、电源部件、连接器和紧固件。根据接线方案准备6至8个主要电子部件。

  • 确定供电方案和连接器

    在USB-C PD与电池加降压转换器之间选择供电方案,并采购匹配的连接器。两个14500锂离子电池可装入原设计的2× AAA电池槽。

  • 备齐焊接耗材和M2硬件

    备齐焊锡、助焊剂、热缩管、扎带和M2硬件。

  • 选择接线方案

    根据现有元件和对线束管理的熟悉程度,选择 Lolin S2 Mini 手工接线、Sesame Distro Board V3 或旧版方案。

  • 获取Sesame配电板

    Sesame Distro Board V1 是专为该项目设计的定制 PCB,可安装在 ESP32-DevKitC-32E 顶部。更多 PCB 信息见文档的硬件部分。

  • 选择布线方案

    比较文档中的原型板和定制 PCB 方案。DIY 搭建者推荐使用 Lolin S2 Mini;Sesame Build Kit 随附的 V3 或早期 V2 Distro Board 已预刷写固件,可直接使用。

  • 采购电子元件

    按照 bom/README.md 中的逐项清单采购电子元件,并确认电源满足 5V/3A 要求。

  • 收集所需电子元件

    查看物料清单以获取完整的硬件列表。选择支持的主控配置、8个MG90舵机,以及使用USB-C PD、电池加降压转换器或文中所列Bambu Lab电池选项的5V 3A电源。

打印与加工

  • 使用 PLA 打印 Sesame

    大多数零件无需支撑,但顶盖需要在指定区域使用支撑。

  • 选择顶盖样式

    目前有三种顶盖样式,推荐使用 Enclosed v91;它具有磁性帽子安装座、覆盖式显示屏布线和多色细节支持。更多样式见 stl/top-covers/。

  • 打印升级用内部框架

    旧版 Sesame 升级到 Bambu Lab 14500 Li-ion 电池时,使用新的内部框架 STL 打印零件。

  • 设置打印材料

    打印材料使用 PLA 或 PLA+。

  • 设置填充与墙层

    填充率为 8–10%,墙层圈数为 2,填充图案为蜂窝。

  • 打印右关节 R1

    使用 R1-v117.stl 打印右关节 R1;此零件不需要支撑。

  • 打印右关节 R2

    使用 R2-v117.stl 打印右关节 R2;此零件不需要支撑。

  • 打印右关节 R3

    使用 R3-v117.stl 打印右关节 R3;此零件不需要支撑。

  • 打印右关节 R4

    使用 R4-v117.stl 打印右关节 R4;此零件不需要支撑。

  • 打印左关节 L1

    使用 L1-v117.stl 打印左关节 L1;此零件不需要支撑。

  • 打印左关节 L2

    使用 L2-v117.stl 打印左关节 L2;此零件不需要支撑。

  • 打印左关节 L3

    使用 L3-v117.stl 打印左关节 L3;此零件不需要支撑。

  • 打印左关节 L4

    使用 L4-v117.stl 打印左关节 L4;此零件不需要支撑。

  • 打印内部框架

    使用 Internal-Frame-v121.stl 打印内部框架;此零件不需要支撑。

  • 打印底盖

    使用 Bottom-Cover-v121.stl 打印底盖;此零件不需要支撑。

  • 打印顶盖

    从 stl/top-covers/ 选择顶盖并打印;顶盖需要支撑。推荐使用 Enclosed v91。

  • 重大尺寸变更时重新设计组件

    如果进行重大尺寸更改,可能需要重新设计某些组件。

  • 使用 Fusion 360 编辑原生文件

    使用 Autodesk Fusion 360 个人许可打开原生 `.f3d` 文件;更改尺寸前启用 Design History 时间线以查看组件的装配过程。

  • 使用 FreeCAD 调整 STEP 模型

    将 `.step` 文件导入 FreeCAD,调整草图,并重新导出 STL 或 STEP 文件而不丢失引用;使用 Part Design 工作台进行参数化编辑。

  • 在浏览器中使用 Onshape 编辑

    使用 Onshape 免费方案上传 STEP 文件,并直接在浏览器中编辑。它适合 Chromebook 用户或需要实时协作的情况。

  • 使用 Meshmixer 或 Blender 快速修改

    需要削 openings 或添加文字时,将 STL 导入 Meshmixer 或 Blender,完成修改后重新导出。对于尺寸关键的内容,应使用参数化源文件。

  • 分支编辑并保留原始 CAD

    保持原始 STEP 或 Fusion 文件不变,将编辑分支到副本中。这样在上游发布新硬件版本时,可以始终将修改重新基于上游设计。

  • 订购 V3/V2 配电板

    订购 1 块 Sesame Distro Board V3/V2 PCB;该板采用全 SMD 设计,可使用 PCBway 装配服务,或由熟练人员手工焊接。

  • 订购 V1 配电板 PCB

    通过 PCBway 订购 1 块 Sesame Distro Board V1 PCB,并使用文件 `Gerber_Sesame-Distro-Board_PCB_Sesame-Distro-Board_V1.zip`。

  • 打印 V3 内部框架

    使用 Distro Board V3 时,打印新的内部框架,以便电池装入新的标准电池仓。

  • 订购 V3.1 配电板 PCB

    通过 PCBway 一键订购 Sesame Distro Board V3.1 PCB。V3.1 修正了走线和电池连接器极性,新板无需手动改动。

  • 上传 Gerber 文件制造 PCB

    向 PCBway 上传 Gerber 文件,以制造Sesame 机器人板。

  • 下单完整 PCB 装配服务

    上传 Gerber、BOM 和 Pick-and-Place 文件,以获得完整装配的板子;文档推荐 V2 使用此选项。

  • 让股节连杆平放打印

    股节连杆采用方形截面,而不是圆角截面,使其能够平放在打印床上。零件被设计为无需支撑即可打印。

  • 打印机器人框架

    使用 PLA 打印框架,并采用最少的支撑材料。打印大约需要一个下午。

  • 打印 Sesame 框架

    使用 PLA 打印框架,并尽量减少支撑。打印大约需要一个下午。

  • 打印并清理全部塑料件

    打印11个塑料部件,包括内部框架、上盖、下盖和R1–R4/L1–L4关节,然后清理打印件。

  • 打印外壳和关节

    按照 printing/README.md 中的预设,从 hardware/printing/stl 准备 3D 文件。

  • 下载并打印STL文件

    下载STL文件并按照打印指南操作。打印件采用PLA设计,只需最少量支撑。

组装

  • 按图排列全部连接器

    焊接前,按照接线图所示顺序摆放每个连接器,避免数据线交叉。

  • 先焊电源轨和降压转换器

    先给电源轨和降压转换器上锡并焊接,再布置信号线。为靠近髋部结束的电机留出充足线长。

  • 用标签标记舵机引线

    每个舵机引线焊好后,可选用胶带旗标标记为S0–S7。

  • 暂不焊接开关和OLED

    暂时不要永久焊接电源开关或OLED;这些最终接头应在电子件装入框架后完成,以准确调整线长。

  • 完成并固定线束

    按照接线图完成线束并对所有接头进行应力消除。舵机引线按去向松散捆扎,电源开关和OLED引线预先剪断但保持未焊状态。

  • 准备四个髋关节

    找出四个髋关节和舵机电机袋中的一侧舵机盘,忽略袋中附带的额外螺钉。

  • 压入舵机盘短边

    舵机盘有较高和较低两侧。将短边压入髋关节,间隙应刚好允许舵机盘齐平压入。

  • 固定舵机盘

    保持舵机盘平整,用螺纹峰间距较大的 M2 × 5 mm 自攻螺钉穿过第二个孔并拧入塑料至牢固。

  • 完成其余三个髋关节

    对 R1、R2、L1 和 L2 四个髋关节重复压入和固定舵机盘的步骤。

  • 暂不安装舵机

    不要把髋关节装到舵机上,因为校准要求每个电机轴都能自由旋转。

  • 将腿壳套上电机

    在机架安装前,将每个腿壳套在对应电机上,并利用内置间隙布线,避免夹压电线。

  • 从侧槽引出电机线

    将电机电线穿过腿件侧面的槽口。

  • 将电机推入腿件

    将电机推入腿件带孔的一侧,并确保电机轴位于最顶部。

  • 固定腿中的电机

    确认电机齐平就位,然后使用自攻螺钉将电机永久固定在腿件中。

  • 完成其余腿关节

    对其余各条腿重复套壳、引线、插入电机和固定电机的步骤。

  • 安装电源开关

    将电池开关牢固压入顶盖背面的槽位。暂时不要连接导线。

  • 为 OLED 显示屏焊接导线

    在显示屏的针脚排上涂少量焊锡进行预镀锡。使用预压接的 JST 连接器导线,按显示屏上的对应标记匹配并焊接。

  • 固定 OLED 显示屏

    将已接线的 OLED 显示屏轻推入顶盖内的槽位。在显示屏旁的小螺孔中拧入自攻螺丝,将显示屏永久固定。

  • 安装电池支架

    将电池支架插入内部框架部件的背面。沿着槽位将红线和黑线向上引出。

  • 安装四个侧向电机

    保持电池导线的位置,将剩余四个侧向电机插入内部框架,电机轴朝向外侧。电机先以一定角度插入,再完全压入,底部不要夹住任何导线。

  • 固定四个侧向电机

    使用自攻螺丝将四个侧向电机永久固定在框架上。确保电机轴最靠近框架外缘。

  • 修剪并整理松散导线

    在放入硬件前,修剪或捆扎多余导线,防止其摆入舵机齿轮,并再次确认所有连接都朝上引出。

  • 将长线向上预布线

    将长线预先向上布置,使其自然贴合未来的顶盖。

  • 放入电子线束

    将电子线束放入机腔,同时让 USB 端口朝向后方。

  • 固定 S2 控制器

    使用框架提供的安装孔,用螺钉直接固定控制器;可选的原型板也可一同固定。

  • 固定可选原型板

    如果制作了小型原型板背板,使用内部框架的备用孔固定,以便日后接触舵机插头。

  • 安装 V1 板支柱

    安装四个 M2.5 × 5 mm 公母支柱,将 Sesame Distro Board V1 抬高,使其与 ESP32 DevKit 保持间隙。

  • 固定抬高的 V1 板

    随后使用顶部螺钉固定整个组件。

  • 安装 V3/V2 主板

    将电缆轻推向中心,使主板能够正确就位,再把主板固定到内部框架。主板角落有两个安装孔,使用自攻螺钉固定。

  • 确认电路板方向

    缺口表示前方,USB 端口表示后方;方向不清楚时使用这两个标志判断。

  • 连接控制门户

    在手机或电脑上查找 Wi-Fi 网络,连接 Sesame 板创建的接入点以打开控制器门户。桌面端无法自动显示时,在浏览器中访问 `sesame-root.local`;推荐使用手机。

  • 确认电机编号与位置

    使用图示将电机编号与实际位置对应起来,并确保机架大致朝向正确。

  • 连接全部八个电机

    从电机 0 开始,将连接器插入对应的电路板排针;棕色线必须对准接地轨。重复操作连接全部 8 个电机,每次连接后电机应转动并保持位置。

  • 安装髋关节

    让电机保持“Stand”模式,为每个电机选择匹配的髋关节,并以 45 度角将髋关节压到电机轴上。

  • 紧固髋关节

    确认髋关节位置正确后,用 M2.5 机器螺钉穿过主孔并拧入电机轴。轻轻拧紧,避免过度紧固导致电机断电复位。

  • 安装腿部关节

    对腿部关节重复相同安装过程,分别用“Rest”和“Stand”检查运动与碰撞情况,再用螺钉固定。

  • 连接电池

    将电池线插入板上的螺丝端子,并用平头螺丝刀牢固拧紧。

  • 整理并固定导线

    将机器人翻转,把所有导线牢固压入底部的导线槽中。

  • 分组扎束导线

    将导线轻轻分成左右两组,分别套上束线带,折返一次并收紧,使上盖能够贴合。

  • 安装上盖

    轻轻收拢所有线束,缓慢将上盖压在电子元件上。操作要非常轻柔,以免造成短路或断开连接。

软件与固件

  • 确认是否需要刷写固件

    Sesame Build Kit 的 Distro Board V3 及更早的 V2 版本已预装最新固件。仅当需要自定义固件或升级到更新版本时才刷写固件。

  • 启用网络模式

    设置 WiFi 密码,并将 ENABLE_NETWORK_MODE 设为 true 以启用网络模式。将 ENABLE_NETWORK_MODE 保持为 false 时仅使用接入点模式。

  • 上传固件

    在 Arduino IDE 中点击 Upload 按钮,等待编译和上传完成。

  • 修复 Linux USB 权限

    如果端口未出现或出现权限拒绝错误,将当前用户加入 dialout 组,然后注销并重新登录。

  • 排查固件上传问题

    If uploading fails, hold the BOOT button while uploading or try a different USB cable. For S3-based boards, check the USB CDC On Boot setting when the port is not found after a reset.

  • 安装 USB 驱动

    为 S2 Mini 安装 CP210x 驱动,或为某些 ESP32 开发板安装 CH340 驱动。Windows 10/11 通常已包含这些驱动。

  • 修复网络连接

    确认 ENABLE_NETWORK_MODE 为 true,且 SSID 和密码正确。在 Serial Monitor 中检查连接状态,使用 2.4GHz WiFi 网络,或增加代码中的连接超时时间;当前为 10 秒和 20 次尝试。

  • 解决 mDNS 主机名解析

    在 Windows 上安装 Bonjour Print Services。在 Linux 上确保已安装并运行 avahi-daemon。如果路由器阻止 mDNS 流量,请尝试使用 Serial Monitor 中显示的 IP 地址。

  • 排查 API 命令问题

    向 /api/command 发送 POST 请求,将 Content-Type 请求头设为 application/json,并检查 Serial Monitor 中的错误消息和已解析的命令输出。首先使用简单的 cURL 命令测试连接。

  • 打开固件入口文件

    打开 `sesame-firmware-main.ino` 作为固件入口。将 `face-bitmaps.h`、`movement-sequences.h` 和 `captive-portal.h` 与其一同保留,分别用于 OLED 表情、动作动画和网页远程控制界面。

  • 使用 Arduino-ESP32 构建固件

    使用 Arduino-ESP32 框架构建固件。固件运行在单核事件循环上,并使用硬件 PWM 定时器控制电机。

  • 启用双模式 WiFi

    使用 `WiFi.mode(WIFI_AP_STA)` 配置 ESP32,使接入点模式和站点模式同时运行。

  • 初始化 SoftAP

    使用 `WiFi.softAP()` 初始化 ESP32 接入点。配置 `DNSServer` 监听 UDP 端口 53,并将通配符 DNS 查询重定向到内部网关 `192.168.4.1`。

  • 通过 mDNS 发布机器人

    使用 `ESPmDNS` 库将机器人广播为 `sesame-robot.local`,使客户端无需硬编码 IP 地址即可发现机器人。

  • 配置 Web API 端点

    配置 `WebServer`:使用 `/cmd?go=[dir]` 控制传统移动、`/cmd?pose=[name]` 触发传统姿势、`GET /api/status` 获取 JSON 状态,以及 `POST /api/command` 发送 JSON 命令。

  • 支持仅面部命令

    让 `/api/command` 将不含 `command` 字段的请求识别为仅面部更新,只更新显示而不触发动画。

  • 实现非阻塞命令处理

    用 `pressingCheck(String cmd, int ms)` 替代 `delay()`,在动画帧期间轮询 `server.handleClient()` 和 `dnsServer.processNextRequest()`。将此协议用于移动命令,使行走动作仅在按钮按住时播放。

  • 配置设置端点

    添加 `/getSettings` 端点以获取参数配置,并添加 `/setSettings` 端点以修改配置。

  • 启动麦克风语音识别

    创建语音识别器并循环打开麦克风,打印“Listening...”,同时在监听时将机器人表情设为 idle。

  • 限时捕获语音

    以五秒超时监听音频,捕获音频后将机器人表情设为 thinking。

  • 识别语音并显示情绪

    使用 Google 识别捕获的音频,打印识别出的文本,分析其情绪,并在启用说话表情时显示对应情绪。

  • 暂停后恢复中性状态

    处理命令后等待两秒,然后保留分析出的情绪并关闭说话状态。

  • 处理语音识别错误

    语音识别超时时显示 sleepy 表情,识别值未知时显示 confused 表情。

  • 定义通知处理函数

    导入 requests,并定义使用 Sesame Robot 本地地址的 robot_notification 函数。

  • 将通知类型映射为情绪

    开始建立通知情绪映射,将 doorbell 映射为 surprised、alarm 映射为 angry、reminder 映射为 thinking。

  • 发送映射后的表情命令

    使用 success 和 error 完成情绪映射,未匹配的类型使用 default,并将选定表情发送到机器人命令 API。

  • 添加可选的门铃动作

    收到门铃通知时,可选择发送挥手命令并配合 happy 表情。

  • 自定义空闲眨眼间隔

    打开 sesame-firmware-main.ino,将 scheduleNextIdleBlink() 设置为在随机眨眼之间间隔 3000–7000 毫秒。

  • 自定义空闲眨眼间隔

    修改 sesame-firmware-main.ino 中的时间值。文档中的设置使用 3000 毫秒作为眨眼最小间隔,7000 毫秒作为最大间隔。

  • 上传Sesame固件

    将固件目录中的代码上传到机器人。文档说明需要使用Arduino IDE。

  • 准备Arduino IDE

    使用Arduino IDE准备并上传固件代码。

  • 在Sesame Studio中创建机器人动画

    使用Sesame Studio以可视化方式设计机器人的姿态和动画序列。

  • 在3D视图中调整机器人姿态

    打开Sesame Studio桌面应用,使用实际打印的STL几何结构在3D视图中可视化调整机器人姿态。

  • 编排动画帧

    将帧编排成复杂动画,并设置自定义转场和延迟。

  • 设计OLED面部位图

    设计128x64 OLED面部位图,或直接打开、编辑并保存Arduino的`face-bitmaps.h`文件。

  • 生成固件动画代码

    生成包含舵机角度和位图的C++代码,以便粘贴到固件中。

  • 设置 ESP32 固件

    按照链接中的固件文档配置 `sesame-firmware-main.ino`。该固件负责机器人的运动学、面部显示和 WiFi 控制界面。

  • 通过网页界面连接

    将手机连接到机器人内置的无线接入点。使用网页界面控制机器人。

  • 添加自定义机器人表情

    按照固件文档中的指南添加自己的位图作为自定义表情。

  • 使用预装固件的V3版本

    使用Distro Board V3时,直接采用板上预装的最新固件。

标定与测试

  • 打开串口监视器

    从 Tools 打开 Serial Monitor,将波特率设置为 115200,然后重置开发板。此时应显示启动消息和网络信息。

  • 测试单个电机

    使用 Serial Monitor 中的单个电机控制功能测试机器人并排查电机问题。

  • 排查电机不转动问题

    如果机器人不转动,请检查电源和舵机连接。如果发生欠压,请在 Web 设置中增大 motorCurrentDelay。

  • 检查 ESP32 PWM 定时器分配

    使用 `ESP32PWM::allocateTimer(n)` 预留硬件定时器 0-3,以避免外设冲突并提供 50Hz PWM 信号。如果自定义固件出现网络错误,请检查定时器分配。

  • 设置舵机脉宽映射

    将腿部舵机的 0-180 度映射为 732us-2929us,必要时编辑 `servos[i].attach()` 调用。对于 270 度舵机,使用 833us-2167us。

  • 调整连续电机电流延迟

    根据电源配置调整 `motorCurrentDelay`,其默认值为连续脉冲之间 20ms。使用强力独立电源时可以尝试将其设为零;运行时也可通过 AP 控制器设置菜单进行更改。

  • 使用默认接入点

    使用密码 12345678 连接 Sesame-Controller-BETA WiFi 网络。机器人的 IP 地址是 192.168.4.1。

  • 打开 WiFi 设置面板

    连接 Sesame-Controller-BETA 接入点并打开强制门户。进入 Settings → WiFi / Network。

  • 选择 2.4GHz WiFi 网络

    点击 Scan for Networks 并选择你的 2.4GHz 网络。对于隐藏的 SSID,勾选 Enter name manually。

  • 让机器人连接 WiFi

    输入网络密码并点击 Connect。连接大约需要 15 秒;机器人切换 WiFi 信道时,手机可能会短暂断开,之后会自动重新连接。

  • 重启后重新输入 WiFi 凭据

    通过网页界面输入的 WiFi 凭据不会持久保存,因为固件设置了 WiFi.persistent(false)。重启后,机器人会返回接入点模式,必须重新输入凭据。

  • 检查 OLED WiFi 信息

    在最初 30 秒没有输入时,屏幕会滚动显示 AP 的 SSID 和 IP、连接时的网络名称和 IP、mDNS 主机名以及 captive portal 提示。首次输入后,WiFi 信息会消失,只显示表情;同时连接 AP 和网络时,会显示两者的连接详情。

  • 读取和更新固件设置

    使用 GET /getSettings 读取当前的 frameDelay、walkCycles、motorCurrentDelay 和 faceFps 值。使用 GET /setSettings 和所选查询参数更新这些值。

  • 快速测试MG90舵机

    使用舵机测试器或Arduino快速测试MG90舵机,提前发现失效单元。

  • 调整并封装降压转换器

    将降压转换器输出调整为5.1 V并用热缩管封装。

  • 校准前拆下关节

    校准时绝不能连接关节。

  • 保持电机轴自由转动

    此时所有电机轴都应能够自由转动。

  • 检查测试线束

    检查线束,确保测试时没有裸露导体可能造成短路;需要时添加热缩管或胶带。

  • 打开电机测试指南

    打开文档中的电机测试指南。

  • 为 V3/V2 板供电

    将电路板连接到强力 USB 电源;手机快速充电器或笔记本电脑充电器均可使用。V3/V2 套件板已预刷 Sesame 固件,无需连接电脑或使用 Arduino IDE 刷写。

  • V2 板必须使用 USB-C

    V2 Distro Board 的电池系统目前存在不稳定性,不能使用电池运行,必须通过 USB-C 供电。

  • 初始化 PWM 通道

    在门户中点击“Standby”按钮来初始化 PWM 通道。插入电机后,它会立即移动到正确的激活位置。

  • 测试髋关节角度

    在门户中点击“Rest”,髋关节应与机身完全平行;再点击“Stand”,髋关节应返回 45 度。交替测试以确认安装正确。

  • 测试开关

    确认电池已充电并装入,翻转开关,检查是否出现 Wi-Fi 网络或显示屏是否点亮;如果不能工作,请再次检查连接。V2 Distro 板用户目前必须通过 USB-C 使用 Sesame。

  • 调整电机启动电流延迟

    如果电源余量不足,在网页设置中提高motorCurrentDelay,无需修改代码。固件会错开电机启动,以降低同时启动造成的电流峰值。

  • 连接 Sesame 控制器

    连接到机器人创建的接入点后,打开强制门户控制器。控制器可让机器人行走、转向、触发表情,并调整校准和速度等设置。

  • 通过串口测试命令

    使用串口命令行执行与 HTTP API 相同的命令,进行工作台测试。

  • 测试 Sesame 的动作和显示

    测试 Sesame 的行走、转向、挥手、跳舞、指向、俯卧撑和蠕行动作,并确认 OLED 能显示动画表情。

  • 通电前检查电源与接地

    启动机器人前,仔细检查电源线和接地线。

  • 遮盖裸露导线

    遮盖所有裸露导线,避免它们接触插针并损坏ESP32。

  • 通电前测试连接

    在接通电源之前测试所有连接。

  • 配置WiFi接入点

    在固件刷写完成后配置WiFi AP设置。

用起来

  • 以 AP 模式连接

    仅使用 AP 模式时,连接密码为 12345678 的 Sesame-Controller-BETA WiFi 网络,然后访问任意网站。

  • 以网络模式连接

    在网络模式下,在 Serial Monitor 中查找“Connected to network!”消息。通过 http://sesame-robot.local 或显示的 IP 地址访问机器人。

  • 打开强制门户

    连接网络后,访问任意网站以打开强制门户控制界面。如果默认密码无法连接,可在代码中修改 AP_PASS。

  • 打开机器人网络地址

    连接成功后,面板会显示 http://sesame-robot.local 链接和分配的 IP 地址。

  • 使用旧版端点控制移动

    发送旧版移动请求,让机器人前进、后退、左转、右转或停止。

  • 触发机器人姿势

    通过旧版姿势端点请求挥手、跳舞、休息或站立姿势。所有可用姿势参见 movement-sequences.h。

  • 设置单个电机角度

    指定 1 至 8 号电机,并将每个电机设置为 0 至 180 度的角度。

  • 获取机器人 JSON 状态

    请求 GET /api/status,读取当前命令、当前表情、网络连接状态、AP IP 和网络 IP。

  • 发送 JSON 移动命令

    使用 Content-Type: application/json,将包含 command 和 face 的 JSON 正文 POST 到命令端点。示例执行前进命令并使用 walk 表情。

  • 仅更新机器人表情

    POST 仅包含 face 字段的 JSON 正文,在不触发移动的情况下更改表情。示例将表情设置为 happy。

  • 远程停止机器人

    POST 将 command 设置为 stop 的 JSON 正文,通过 JSON API 停止机器人。

  • 查询机器人状态

    向 GET /api/status 发送 HTTP 请求,读取机器人状态和当前表情。

  • 发送机器人命令

    向 POST /api/command 发送移动命令、表情或两者。任何能发出 HTTP 请求的程序都可以驱动 Sesame,包括 Python 脚本、JavaScript 和家庭自动化。

  • 使用 OLED 表情动画

    行走、舞蹈、死亡、蠕虫等每个表情都有对应的 OLED 帧,待机动画会自行眨眼。对话表情包括开心、悲伤、愤怒、惊讶、困倦、爱、兴奋、困惑和思考,每种都有 talk_ 变体。

  • 创建动画、表情和脚本

    在 Sesame Studio 中创建动画,为机器人添加表情,或者通过 API 编写控制脚本。

  • 通过 Wi-Fi 控制 Sesame

    通过手机连接 Sesame 自身的 Wi-Fi 控制面板进行控制,不需要应用或蓝牙配对。

  • 使用 JSON API 驱动机器人

    使用 Sesame 的 JSON API,让 Python、JavaScript 或家庭自动化系统驱动机器人。

常见问题

  • PCB 订购与制造限制阻碍项目构建 #77 #67
  • 舵机设置缺少精确定位与平滑运动调节 #17 #75 #61
  • 固件因 movement-sequences.h 语法错误而无法编译 #34 #39
  • 电池供电构建在舵机负载下因重启而失败 #56 #85
  • 提供的 CAD 和 STL 文件损坏或不含几何数据 #13 #52 #70
  • 接线图未清晰对应舵机排针与 ESP32 引脚 #4 #31
  • 克隆 ESP32 在接入点模式下复位且需固件变通 #54
  • 打印外壳壁过薄且缺乏机械韧性 #16

物料

  • 180° MG90S 全金属微型舵机 ×8(建议买 10 个备用;必须是 180° 版)
  • 0.96 寸 SSD1306 I2C OLED(128×64)
  • 主控二选一:Lolin S2 Mini 加洞洞板手工接线(自制推荐),或 Sesame Distro Board V3.1(ESP32‑S3,全贴片,套件预烧录)
  • 供电 5V 3A:USB‑C PD,或电池加降压模块;推荐拓竹 14500 7.4V 800 mAh 锂电
  • KCD1 船型开关、22/30AWG 硅胶线、热缩管、M2×5 自攻螺丝约 40 颗、M2.5×5 螺丝 10 颗
  • 11 个 PLA 打印件:8 个关节、内框、上盖、底盖(8–10% 填充,仅上盖需支撑)

工具

  • 3D 打印机(或代打印服务)
  • 烙铁、焊锡、助焊笔与吸锡带
  • 斜口钳与精密螺丝刀
  • 自焊 Distro Board 需热风枪,或用 PCBWay 贴片服务

技能

  • 基础焊接与线束制作
  • Arduino IDE 与 ESP32 板包(ESP32Servo 需用 3.0.9)
  • 舵机校准(装关节前完成)
  • 可选:用 Python 或 JavaScript 调用 JSON API

软件

  • Arduino 固件 sesame-firmware-main.ino:网页控制、JSON API、串口命令行
  • Sesame Studio:Python 动画与表情编辑器,生成固件 C++ 代码
  • Sesame Companion App:Python 语音伴侣(Gemini 或本地大模型)
  • 社区:Rust 浏览器仿真器与 sesame-ml 强化学习工具

文档