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