十三步的正确顺序
官方 README 的 Getting Started 是上手入口,把上手分成五步、每步指向一份子文档。站内把它展开成十三页,按下面的序号走,每一步都写明做完能得到什么。
- 先认清项目能做什么、做不到什么,确认自己有基础焊接能力、3D 打印机和 Arduino IDE 基础。《Sesame Robot 是什么:一只会做表情的开源四足机器狗》。做完得到一份明确的能力边界与前置条件清单,据此决定要不要动手。
- 按手上的主控和套件定下组装路线。《认清四条硬件路线:S2 Mini 与 V3/V2/V1 怎么选》。做完锁定一个板型,后面的备料、引脚与供电都按它来。
- 照官方物料清单备齐舵机、屏幕、电源与五金。《按官方 BOM 备齐零件:舵机、屏幕与 5V/3A 电源》。做完得到一份核对过的备料清单,舵机角度标注正确、电源达到官方规格。
- 按官方参数打印外壳并放好顶盖支撑。《打印 Sesame 外壳:11 个零件与顶盖支撑设置》。做完得到全部 PLA 零件,顶盖支撑到位、可直接进装配。
- 在台面上焊出线束与两条公共轨。《焊好 Sesame 线束:30AWG/22AWG 与两条公共轨》。做完得到基本成形的线束,5V 轨与地轨齐全、上电前无短路。
- 把电机、电子件与线束装进机架并合盖。《装配 Sesame 机架:电机入位、OLED 入盖与收尾》。做完得到一台可以通电的机体,关节未提前装上电机轴、开关与屏幕线长已定。
- 按自己的板型选对环境、库版本与引脚组烧进固件。《烧录 Sesame 固件:Arduino IDE 与板型/引脚配置》。做完从串口监视器看到启动信息,确认板型与引脚组对应自己那块板。
- 连上机器狗自己开的热点、打开网页控制页。《连上 Sesame 热点并打开控制页》。做完手机或电脑连上热点、进入控制页并能触发一个动作。
- 逐路校准舵机、装好关节,让它第一次站起来。《校准舵机并让 Sesame 第一次站起来》。做完八路舵机各就各位、关节按官方角度固定,能稳定保持站立姿态。
- 分别用网页、串口和 HTTP 请求驱动动作与表情。《用 Web UI、Serial CLI 与 JSON API 驱动 Sesame》。做完三条通道都能让机器狗动起来、换表情,并读到返回状态。
- 画一个自己的 OLED 表情或编排一段动作。《用 Sesame Studio 做表情与自定义动画》。做完导出可贴回固件的表情或动作代码。
- 逐项核对官方源码、文档与中文教程对不上的字段。《版本与事实校准:热点名、超时与供电口径冲突》。做完确定自己板型该采信哪个热点名、超时与供电口径。
- 按现象定位卡在哪一步并找到解法。《Sesame 故障排查:烧录、供电、舵机与网络》。做完能把故障归到烧录、供电、接线、配网或 API 环节,拿到对应解法。
官方五步与站内页面的对应
README 的五步与站内页面并不一一对应:官方把装配接线算作一步、把烧固件并配置 WiFi AP 也算作一步,站内各拆成两页。对照如下。
| 官方五步(Getting Started) | 对应站内页面 | 这一步做完的验收点 |
|---|---|---|
| ① 对照 BOM 备料 | 《认清四条硬件路线:S2 Mini 与 V3/V2/V1 怎么选》并《按官方 BOM 备齐零件:舵机、屏幕与 5V/3A 电源》 | 板型与零件都定下 |
| ② 下载 STL 按打印指南打印 | 《打印 Sesame 外壳:11 个零件与顶盖支撑设置》 | PLA 外壳件齐、顶盖支撑到位 |
| ③ 照构建指南与接线指南装配接线 | 《焊好 Sesame 线束:30AWG/22AWG 与两条公共轨》并《装配 Sesame 机架:电机入位、OLED 入盖与收尾》 | 线束与机架成形,机体可通电 |
| ④ 用 Arduino IDE 烧固件并配置 WiFi AP | 《烧录 Sesame 固件:Arduino IDE 与板型/引脚配置》并《连上 Sesame 热点并打开控制页》 | 串口见启动信息、控制页能触发动作 |
| ⑤ 用 Sesame Studio 设计姿态与动作 | 《用 Sesame Studio 做表情与自定义动画》 | 导出可贴回固件的表情或动作代码 |
导航备注与关键事实
下面几项最容易在半路卡住,按对应环节提前核对一遍。
| 项目 | 官方口径 | 撞上的环节 |
|---|---|---|
| 热点名 | 固件文档 Sesame-Controller-BETA 与源码 Sesame-Controller 不一致,两个名字都试一下 |
连热点开控制页、版本与事实校准 |
| ESP32Servo 版本 | 必须锁 v3.0.9,新版写一路舵机会影响多通道(issue #103) |
烧录固件 |
| 舵机角度 | 必须买 180° MG90S,买错整机无法工作 |
按 BOM 备料 |
| 轨上供电 | 至少 5V/3A
|
备料与首次上电 |
| WiFi 频段 | 只支持 2.4GHz,ESP32 不支持 5GHz |
连热点后的配网 |