项目>Sesame Robot>版本与事实校准:热点名、超时与供电口径冲突

版本与事实校准:热点名、超时与供电口径冲突

摘要:逐项核对官方源码、官方文档与中文教程说法不一致的字段,确定自己的板型该信哪个值。

官方文档自己也打架

Sesame 的官方文档、固件源码与中文教程之间存在一批对不上的字段。下面的对照表把已核实的冲突逐项列出:全部说法标注官方出处,抓取日期均为 2026-11-14,适用 main 分支;两边的说法只并列,谁算「真值」不替官方判定,判定方法交给你自己动手核对。

字段级冲突对照

冲突 说法 A(出处) 说法 B(出处) 怎么核对
AP 热点名 固件文档:SSID 为 Sesame-Controller-BETA 固件源码第 15 行:#define AP_SSID "Sesame-Controller" 手机扫 Wi-Fi,两个名字都试连,能连上的就是你手上固件广播的名字
WiFi 连接超时 固件文档排障段:currently 10 seconds / 20 attempts 固件源码第 91 行:WIFI_CONNECT_TIMEOUT_MS = 15000(15 秒) 打开自己烧的 .ino 看这一行,记下你手上这份源码的值
文档重复段落 固件文档「Idle Animation System」一节 同一文档「Asset Pipeline & Face Customization」一节,标题不同、正文重复 对比两节正文;文档仍在编辑中,别按章节标题推断内容范围
star 数 第三方页面跨日期出现过 4,460 / 5,033 / 4.9k / 2.2k / 564 等 GitHub API 快照:5,057 stars / 695 forks(2026-11-14 实测) 引用任何数字都带日期,自己当日查仓库页

V3/V2 供电口径逐来源对照

供电是口径最乱的一块,四个官方文档各有说法,逐来源列出,不做统一结论:

官方出处 说法(抓取 2026-11-14)
官方 BOM Distro Board V3/V2 都支持 USB-C PD(5V/3A)与电池 + buck 两种供电
官方接线指南 V2 为 legacy,「limited to USB power due to battery brownouts」;V3 支持 USB-C PD 与电池
官方构建指南 V2 电池系统不稳定、必须走 USB-C;V3/V2 套件已预刷固件
官方硬件说明 同一页先把 V3 写成 Current(USB-C PD 12V、Bambu Lab 电池接口),又把 V3/V2 合写成 Legacy 且电池 brownout 频发

V2 板的供电,接线指南与构建指南独立给出了一致口径:走 USB-C,照这两份操作即可;V2 能不能可靠用电池,官方文档之间没有答案,别替官方下结论。

电池方案逐来源对照

官方出处 说法(抓取 2026-11-14)
官方 BOM(当前口径) Bambu Lab 14500 7.4V 800mAh 单包 + 配套充电器 + XH2.54 转接线;V3 需把转接线焊到板上
官方构建指南 Phase 1 仍写着「2× 14500 Li-ion cells in a 2× AAA holder」(两节 14500 装 2× AAA 电池盒)
官方接线指南 10440 是旧方案:焊接时必须取出电芯、用专用 Li-ion 充电器单独充,多数 AAA 电池盒不支持安全充电

备料按 BOM 的单包 14500 方案走;构建指南的双 14500 电池盒与接线指南的 10440 都按旧方案与安全边界对待,不写进采购清单。

中文教程常见说法对照

中文教程常见说法 官方事实 官方出处
打印填充 20% 官方打印参数:8–10% Honeycomb 填充、2 圈壁 官方打印指南
「4-DOF 四足」 8 个 180° MG90S 舵机,约 8 自由度 官方 README、官方 BOM
改 config.h 配 WiFi 改 sesame-firmware-main.ino 的 NETWORK_SSID / NETWORK_PASS / ENABLE_NETWORK_MODE 固件文档、固件源码
2×10440 加 AAA 电池盒是主流 当前 BOM 是 Bambu Lab 14500 7.4V 800mAh 单包 官方 BOM
整机约 300 元是官方口径 官方只给 $50–60 预算估算,并明确价格与可得性随时变化 官方 README、官方 BOM
Studio 在 software/sesame-studio/、BOM 在 BOM.md、STL 在 hardware/stl/ 独立仓库 dorianborian/sesame-studio;官方路径为 hardware/bom/README.md 与 hardware/printing/stl/ Sesame Studio 官方 README、官方硬件说明
烧录后机器人会自检一次 官方无自检说法;验证靠串口启动信息与 AP 控制页 固件文档

五步核对自己该信哪个值

先照抄这张核对表,做完每步填一行:

核对项 我的记录
实际广播的 AP 热点名 待填
我这份 .ino 的 WIFI_CONNECT_TIMEOUT_MS 待填
我的板型(S2 Mini / V3 / V2 / V1) 待填
我的电池方案 待填
核对日期 待填
  1. 打开自己烧的 .ino:Arduino IDE 打开 sesame-firmware-main.ino。预期:能看到文件开头的 #define 配置区。
  2. 核对 AP_SSID:看第 15 行的字符串,再用手机扫描实际热点,两个官方名字都试连一次。预期:能连上的名字填进核对表第一行。
  3. 核对 WIFI_CONNECT_TIMEOUT_MS:跳到第 91 行。预期:读到 15000(15 秒);固件文档排障段写的是另一个数,两个数并列记录即可,不用判定谁对。
  4. 对照 BOM 确认板型与电池方案:对着官方 BOM 的电源部分清点手里的板子与电池。预期:得出「板型 + 电池方案」的明确组合;若是 V2 板,供电按 USB-C 口径记录。
  5. 记录自己该信哪个值:把结论与当天日期填进核对表。预期:得到一份自己核对过的口径记录,之后排障、发帖引用这份记录,而不是转抄任何一方的说法。

资料来源

  • Sesame 官方固件文档
  • Sesame 固件源码
  • Sesame 官方 BOM
  • Sesame 官方接线指南
  • Sesame 官方硬件说明

相关内容

60美元四足机器人Sesame实操指南实践