正在连接信源…

Stack-chan(スタックチャン) 复刻全流程

Stack-chan(スタックチャン) 从采购、打印、组装到装软件、标定和训练的 177 个步骤,附物料表、购买链接与官方出处。

成品 M5StackChan 99 美元、带遥控 125 美元(M5Stack 官方商店);Switch Science 18,590 日元含税。DIY 参考:CoreS3 59.90 美元、StackChan Body 55 美元(M5Stack 商店),SCS0009 舵机 1,738 日元(Switch Science),仓库称 SG90 约 500 日元、RS304MD 约 3,000 日元。不含 3D 打印、PCB、电池与运费

采购

  • 选择 StackChan K151 套装

    购买 K151 套装,其中包含预装 CoreS3 的 StackChan 主机、携带袋或盒子、USB Type-C 线、延长线、内六角扳手、角色表情贴纸和纸质用户手册。

  • 选择遥控器套装

    购买 K151-R 套装,其中包含预装 CoreS3 的 StackChan 主机、由 Hat Mini JoyC 和 StickC-Plus 组装的遥控器、携带袋或盒子、USB Type-C 线、延长线、内六角扳手、角色表情贴纸和纸质用户手册。

  • 准备外壳与电子元件

    准备3D打印的外壳组件:Shell、Feet、Bracket和Battery backpack,以及M5Stack Core、Stack-chan board、两个舵机、带PH 2针线缆的3.7V电池和螺丝。

  • 准备主机电脑和所需组件

    准备 Windows、Mac 或 Linux 主机电脑;文档测试环境为 Ubuntu 24.04。还需准备 M5Stack Basic/Core2/CoreS3、USB Type-C 数据线、git 和 Node.js。

  • 购买预组装版 Stack-chan

    The standard M5StackChan AI Desktop Robot (K151) package is enough to get started; the joystick remote controller is optional.

  • 选择舵机类型

    为机器人选择两个舵机:PWM(SG90)成本低,约为500日元,并可使用PortC;串行(RS304MD)约为3000日元,支持速度限制和读取当前舵机角度,但不能使用PortC。

打印与加工

  • 打印STL外壳文件

    打印每个目录中的STL文件,并使用文档下方所示的推荐打印方向。

  • 订购SMD PCB

    使用Gerber文件、BOM(物料清单)和CPL(元件布局清单),通过JLCPCB等PCB制造商订购SMD(表面贴装器件)PCB。

组装

  • 安装腿部舵机齿轮

    将 gear_xl330 小型十字形部件插入 id=1 的伺服电机,并对齐齿轮凸起与 XL330 上的孔。

  • 安装脚部上部

    将组件插入 feet_top,带缺口的一侧朝前,并用 M2.5x6mm 自攻螺丝从背面固定。

  • 滑入脚部下部

    将 feet_bottom 滑入安装位置。

  • 安装颈部舵机齿轮

    像腿部伺服电机一样,将 gear_xl330 插入 id=2 的伺服电机。

  • 固定颈部舵机

    使用 M2.5x6mm 自攻螺丝固定。

  • 安装舵机臂

    安装舵机臂。

  • 连接伺服电缆

    连接伺服电机电缆。

  • 组合上下伺服电机

    使用 bracket_XL330_f 将上方和下方伺服电机组合在一起。

  • 固定上下伺服电机

    使用 bracket_XL330_b 固定上方和下方伺服电机。

  • 连接电路板和伺服电机

    使用电缆连接电路板和伺服电机。

  • 将舵机臂滑入外壳

    将舵机臂滑入外壳。

  • 固定电路板和外壳

    在 4 个点使用 2x4mm 盘头自攻螺丝固定电路板和外壳。

  • 插入 M5Stack 机身

    插入 M5Stack 机身。

  • 组装打印件与电子元件

    使用打印的Shell、Feet、Bracket和Battery backpack,以及M5Stack Core、Stack-chan board、两个舵机、3.7V电池和指定螺丝组装机器人。

  • 将舵机卡入支架

    将两个舵机卡入支架。

  • 将电池装入背包

    将电池装入电池背包。

  • 钩住电池包装入支架

    通过钩住爪钩,将电池包插入支架。

  • 用螺钉固定脚和外壳

    使用 M2-8mm 螺钉固定脚和外壳,每处使用 1 个。

  • 连接舵机和电池线缆

    将舵机和电池线缆连接到开发板,并再次检查每个连接器的方向是否正确。

  • 设置串行舵机轴向

    对于串行舵机,ID 为 1 的舵机用于脚侧(pan 轴),ID 为 2 的舵机用于面部一侧(tilt 轴)。

  • 连接 SCS0009 信号线

    对于 SCS0009,将信号线(白色线缆)连接到 write 引脚。

  • 将开发板固定到机器人

    使用 4 个 M2-4mm 螺钉将开发板固定在机器人上。

  • 将 M5Stack 叠装到机器人

    将 M5Stack 叠装在机器人上。

  • 可选固定 M5Stack

    如果需要固定 M5Stack,使用下方的两个孔,用 2 个 M3-15mm 螺钉将其固定到位。

  • 连接 M5Stack 与电脑

    使用 USB 将 M5Stack 连接到电脑。

软件与固件

  • 安装 CoquiTTS

    使用 pip install TTS 安装 CoquiTTS。如果在 Windows 上安装效果不佳,可通过网络使用另一台 Linux 环境运行的 TTS-Server。

  • 启动 TTS-Server

    在 8080 端口启动 TTS-Server,并使用 tts_models/ja/kokoro/tacotron2-DDC 模型。

  • 配置服务器主机和端口

    通过 --host 指定 TTS-Server 的主机名或 IP 地址,通过 --port 指定端口。通常从 host/app/manifest_local.json 读取,但命令行设置优先;必须在两处之一指定。

  • 设置语音音高偏移

    通过 --shift 设置音高偏移,范围为 0.5 到 2,1 表示保持 CoquiTTS 原始音高。省略时使用输入文件中的 SynthProps.shift;若也未定义,则使用 1.5。启用偏移后,输出采样率为 44.1KHz。

  • 指定输入和输出目录

    通过 --input 指定输入文件,省略时优先使用当前目录中的 speeches.js,否则使用 ./host/modules/audio/assets/sounds/speeches_ja.js。通过 --output 指定输出目录,优先使用输入文件旁的 assets 目录,否则使用输入文件所在目录。

  • 生成 Coqui 语音文件

    在 stack-chan/firmware 目录运行 generate-speech-coqui,并指定示例输入和输出目录。指定选项时,在命令后添加 --。

  • 安装并启动 VOICEVOX

    从 VOICEVOX 网站下载并安装适用于 Windows、MAC 或 Linux 的版本。安装完成后启动 VOICEVOX,语音生成时会同时使用其运行的引擎。

  • 列出 VOICEVOX 角色

    不指定值时显示所有角色,然后退出。指定 SpeakerId 时,只显示具有该 Id 的角色。

  • 设置 VOICEVOX 主机

    指定 VOICEVOX 引擎的主机名或 IP 地址。省略时,默认使用 127.0.0.1。

  • 设置 VOICEVOX 端口

    指定 VOICEVOX 引擎的端口号。省略时,默认使用 50021。

  • 选择 VOICEVOX 角色

    通过 SpeakerId 指定要说话的角色。省略时默认使用 SpeakerId:1 Zundamon (Amaama)。

  • 设置语音速度

    指定语音速度,取值范围为 0.5 到 2。省略时默认值为 1。

  • 调整语音音高

    调整语音的音高,取值范围为 -0.15 到 0.15。省略时默认值为 0。

  • 设置语音语调强度

    指定语音语调的强度,取值范围为 0 到 2。省略时默认值为 1。

  • 设置音频采样率

    指定输出音频文件的采样率。省略时默认值为 11025(11.025KHz)。

  • 指定语音输入文件

    指定输入文件名。省略时,如果当前目录存在 speeches.js 就使用它;否则使用 ./host/modules/audio/assets/sounds/speeches_ja.js,并假定在 ~/stack-chan/firmware 目录执行。

  • 指定音频输出目录

    指定输出目录。省略时,如果输入文件所在目录下存在 assets 目录,就使用该目录;否则使用输入文件所在的同一目录。

  • 生成 VOICEVOX 语音文件

    在 ~/stack-chan/firmware 目录执行示例命令,读取独白 speeches_monologue.js,并将输出放入独白 assets 目录。指定选项时,必须像示例一样在命令后添加“ -- ”。

  • 进入下载模式

    使用 USB Type-C 数据线将 StackChan 连接到电脑;建议使用底座端口,以避免电机运动造成意外。按住 RST 按钮 3 秒,旁边的指示灯变绿后松开;指示灯熄灭表示已进入下载模式。

  • 下载 StackChan World 应用

    从 iOS App Store、Android Play Store 或 Android APK 软件包下载 StackChan World。该应用支持 iOS 和 Android。

  • 启动应用并登录

    安装应用后启动并登录。如果没有账户,请注册 M5Stack 账户,并使用与 UiFlow、M5Burner 和 M5Stack Forum 相同的账户。

  • 启动 StackChan

    通过底部 USB-C 接口连接电源,或短按左侧电源按钮。屏幕将显示欢迎页面。

  • 继续进行设备配对

    舵机测试完成后,连续点击两次 Next,即显示为“Next - Next”。然后在手机上打开 StackChan World 应用。

  • 扫描附近的 StackChan

    在应用中点击 Add a new StackChan。手机会扫描正在广播蓝牙配对请求的附近设备,并将它们显示在列表中。

  • 选择匹配的 StackChan

    选择列表中 ID 与 StackChan 屏幕所显示 MAC 地址一致的设备。按照应用说明开始配置。

  • 配置设备和 AI 设置

    Set Device name, Name, Conversation language, AI model, Voice, speech rate and pitch, User speech recognition speed, Personality, and Memory. Enter the 2.4 GHz Wi-Fi name and password; 5 GHz is unsupported, and the currently connected Wi-Fi name can be filled in automatically after authorization.

  • 完成绑定和设置

    完成上述设置后,StackChan 将自动重启,设备绑定和设置随即完成。

  • 从 App Center 下载应用

    打开 App Center 下载在线应用,例如跳水管小游戏、IMU 稳定器和万能红外学习遥控器。

  • 更新 StackChan 固件

    设备会在线检查固件更新,自动下载并安装,然后重启。

  • 打开 StackChan 移动应用设置

    访问多设备管理、设备名称、AI Agent 配置、MCP、对话历史、设备解绑及其他选项的设置。

  • 在电脑上安装 M5Burner

    Windows 使用 win-x64 ZIP 下载,macOS 使用 mac-x64 DMG 下载,Linux 使用 linux-x64 ZIP 下载 M5Burner。

  • 下载最新官方固件

    打开 M5Burner,搜索 StackChan,勾选 Only Official,然后点击 Download 获取最新固件版本。

  • 将 StackChan 连接到电脑

    使用 USB-C 数据线连接电脑和 StackChan。建议使用底座上的 USB-C 端口以避免设备意外移动,然后按一次电源按钮开机。

  • 允许 macOS USB 访问权限

    如果 macOS 弹出权限提示,请允许访问,以便电脑能够与 StackChan 通信。

  • 刷入出厂固件

    点击 Burn,选择 StackChan 对应的端口,然后点击 Start。等待进度条显示刷写完成。

  • 先编写主机固件

    主机程序提供 Stack-chan 的基本操作。先编写主机,再编写或安装 mod。

  • 安装用户 mod

    用户应用就是 mod。安装后,mod 会替代产品的默认行为,并通过 `onContextCreated` 接收运行时上下文。

  • 创建主机和 mod 清单

    为主机和 mod 分别创建 `manifest.json`、JavaScript 模块源代码以及图像和音频等资源。在 `modules` 中声明模块名称和位置,在 `config` 中声明模块引用的配置。

  • 包含其他清单文件

    一个清单文件可以包含其他清单文件。使用 `include` 字段添加所包含的清单文件。

  • 构建并刷写标准主机程序

    无需 `sudo` 即可构建并刷写标准 M5StackChan CoreS3 主机程序。默认使用 release 模式;需要时可明确传入 `--mode=debug` 或 `--mode=instrument`。

标定与测试

  • 开始舵机测试

    在欢迎页面点击 Start。将 StackChan 放在坚固稳定且无需触碰的表面上,然后再次点击 Start。

  • 完成舵机运动测试

    StackChan 依次向左、向右、向上移动,然后返回初始位置。屏幕最终应垂直于底座,并居中于两个“脚”之间。

  • 配置 Wi-Fi 频道和接收器 ID

    将接收器和发送器置于同一 Wi-Fi 频道。将接收器 ID 设置为非零值;发送器目标 ID 与接收器 ID 相同时可单独控制,设为 0 时会控制所有接收器;多个接收器可共享同一 ID 进行群组控制。

  • 配置 StackChan 设备设置

    在 Setup 中配置 Wi-Fi 网络、屏幕亮度、扬声器音量、时区、舵机校准、RGB 灯带测试、账户解绑、固件更新等设备设置。

  • 校准舵机 home 位置

    Enter the calibration screen, gently rotate the device to its initial position with the screen perpendicular to the base and centered between the two feet, then tap Set Current Position As Home. Rotate it away from the initial position and tap Move To Home; if it returns, tap Done to complete calibration.

  • 确定 StackChan 的 USB 端口

    展开 M5Burner 中的端口列表,断开 StackChan,并记下消失的端口。重新连接设备以确认对应端口。

  • 进入 StackChan 下载模式

    如果设备端口未出现,长按 RST 按钮 3 秒。旁边的指示灯变绿后松开按钮,表示设备已进入下载模式。

  • 在移动应用中配置 StackChan

    打开 StackChan World 移动应用,首次使用 StackChan 时在其中进行配置。

  • 授予蓝牙配对权限

    如果点按“Add a new StackChan”后只显示配对说明而没有附近设备,请检查应用是否已获得蓝牙访问权限和其他必需权限。

  • 重新尝试配对

    授予所需权限后,在 StackChan World 应用中重新尝试配对。

  • 使用受支持的 2.4 GHz 网络

    将 StackChan 连接到 2.4 GHz Wi-Fi 网络。不要使用 5 GHz 网络或需要网页登录认证的网络。

  • 切换网络后重试

    如果网络连接不佳、语音输出断续或绿色监听 LED 未亮起,请切换到其他网络后重试。

  • 确认进入 AI Agent 模式

    尝试语音唤醒前,确认 StackChan 已进入 AI Agent 模式。

  • 靠近设备并提高音量

    靠近 StackChan,按照演示视频中的发音方式,并提高设备音量以尝试唤醒。

  • 点按屏幕唤醒设备

    点按一次屏幕唤醒 StackChan。正常唤醒时,顶部 LED 会亮起绿色。

  • 选择 XL330 的 USB 连接

    在 Options 中选择连接到 XL330 的 USB。

  • 扫描并找到 XL330

    点击 Scan,XL330 将出现在左侧并可以进行通信。

  • 从左侧列表选择 XL330

    从左侧列表中选择 XL330。

  • 更改 ID 和波特率

    分别点击 ID 和 Baud Rate,在右下角下拉菜单中选择“1000000bps”,再按 Save 应用参数。

  • 逐个连接伺服电机

    更改 ID 时逐个连接伺服电机,因为不能连接具有相同 ID 的多个伺服电机。

  • 编辑本地配置

    修改 `stack-chan/firmware/host/app/manifest_local.json` 以设置本地选项。其 `config` 对象有意保持为空,以免提交私有 IP 地址、API 密钥和测试台专用的舵机设置。

  • 在 config 中添加设置

    在清单文件的 `config` 键下写入文档中的设置。所有配置项请参阅 Moddable 官方文档。

  • 选择正确的舵机驱动

    未添加本地驱动设置时,构建可能选择默认的串行舵机驱动。硬件使用其他驱动时,应明确设置 `config.driver.type`。

  • 列出其他清单路径

    在 `include` 键下以列表格式指定其他清单文件的路径。

  • 检查默认俯仰限位

    `m5stackchan` 驱动默认采用 5–85° 俯仰范围,对应 `rotation.p` 从 −85° 到 −5°;请求中立位置 `rotation.p = 0` 时会限制在 5° 下限。更改默认值前应确认机械间隙,因为极端俯仰角度可能导致舵机堵转并造成永久损坏。

  • 选择专用 CoreS3 配置

    使用 M5StackChan CoreS3 专用的舵机、电源和 LED 配置时,选择“M5StackChan CoreS3”。

  • 确认烧录完成

    烧录完成后,Stack-chan 固件即已安装。

  • 更换舵机时修改设置

    如果使用不同类型的舵机,请参阅浏览器中的 Stack-chan 设置更改说明。

  • 测试开发环境

    运行 npm run doctor;成功时会显示 Moddable SDK 版本,并在支持的目标设备中显示 esp32。

  • 更改设备偏好设置

    通过 Stack-chan 浏览器工具更改设备偏好设置。

采数据与训练

  • 检查 EZData 可用性

    EZData 目前尚不可用。

  • 采集并计算基准统计

    运行采集命令,重置已安装的基准测试,并将原始串口输出保存到 `dist/jitome-face-benchmark/run.log`,把计算后的阶段统计写入 `dist/jitome-face-benchmark/result.json`。测试包含静态、仅眨眼以及最坏情况的眼部、视线和嘴部运动四个 18 秒阶段,并丢弃每个阶段的前五个一秒仪器采样。

用起来

  • 试用 MOD 库中的功能

    从 MOD 库中选择一个 MOD,然后在模拟器中或在 M5StackChan 设备上试用。

  • 使用机器人上下文 API

    使用面向能力的上下文 API 控制表情、运动、输入、音频、摄像头和连接功能。

  • 选择支持的电机配置

    Stack-chan 可使用 Feetech、FUTABA、DYNAMIXEL 或 PWM 舵机配置运行。

  • 选择语音服务

    可通过 Stack-chan Voice、VOICEVOX、ElevenLabs 或 OpenAI 生成 Stack-chan 语音。

  • 使用原生 WebRTC 后端

    标准 CoreS3 和 M5StackChan CoreS3 构建支持原生 WebRTC 对话后端。按照链接的启用与验收文档操作。

  • 打开浏览器端机器人工具

    通过浏览器访问固件安装、BLE 首选项、MOD 画廊、积木编辑器、表情编辑器和 WebAssembly 模拟器。

  • 选择界面语言

    固件和网页界面可使用日语、英语或简体中文。

  • 打开 MOD 画廊

    打开 Stack-chan MOD 画廊,查找已发布的 MOD。

  • 搜索并选择 MOD

    按名称或功能搜索 MOD,然后在模拟器或设备上运行它。

  • 检查功能与支持目标

    查看 MOD 卡片上显示的功能和支持的目标。

  • 安装前检查源代码

    如果 MOD 使用外部服务或网络访问,安装前应检查其链接的源代码。

  • 检查安装兼容性

    安装时,画廊会自动检查目标芯片、XS 版本和固件兼容性。

  • 浏览示例源代码

    浏览 examples 目录中的源代码,用于学习 API、测试和本地开发。

  • 启动 StackChan

    单击左侧 USB-C 接口旁的电源按钮。

  • 关闭 StackChan

    按住左侧 USB-C 接口旁的电源按钮。

  • 重置或重启 StackChan

    单击底部 microSD 卡槽旁的 RST 复位按钮。

  • 编排 StackChan 舞蹈

    在移动应用的蓝牙模式下使用 Dance 功能,为 StackChan 的舞蹈设置音乐、动作旋转角度和灯光颜色。

  • 避免连续点按屏幕

    不要连续点按屏幕,因为连续点按可能会意外退出唤醒模式。

  • 浏览 MOD 画廊

    在 MOD Gallery 中查找已发布的 MOD 和迷你应用。

  • 运行或安装 MOD

    选择一个 MOD,然后在模拟器中运行或将其安装到设备上。

物料

  • M5Stack 主机:CoreS3 为标准配置,发行固件也支持 M5Stack Basic 与 Core2
  • 舵机 2 个:SG90(PWM),或 Feetech SCS0009、RS30X(串行,v0 外壳);v1.0 外壳用 DYNAMIXEL XL330 ×2
  • Stack-chan 驱动板:2 路 PWM 或 2 路串行舵机、PortB、外部 5V 与电池充电
  • 3.7V 锂电池(PH 2‑pin,测试过 400/640 mAh)与 M2 螺丝
  • 3D 打印外壳:shell、feet、bracket、battery backpack(STEP/STL 公开)
  • 成品 M5StackChan:CoreS3 + 机身(550 mAh 电池、水平 360° 连续与垂直 90° 两只反馈舵机、12 颗 RGB LED、红外、三区触摸、NFC)

工具

  • 3D 打印机或代打印服务(仓库举例 JLCPCB、DMM.make)
  • Chrome/Edge 浏览器与可传数据的 USB 线(网页烧录)
  • 串行舵机设 ID:Feetech URT1(Switch Science 标注已停售)或 ROBOTIS U2D2 + SMPS2Dynamixel + 5V 电源

技能

  • Blockly 积木或 JavaScript/TypeScript(Moddable)编写 MOD
  • 串行舵机 ID 与中位角设置
  • 可选:Arduino、UiFlow2、PlatformIO、ESP-IDF(M5StackChan 出厂路线)

软件

  • stack-chan 固件 v2.0.1(Moddable SDK 10.0.2)与 MOD Gallery
  • 浏览器工具:烧录、设置、Blockly 编辑器、表情编辑器、仿真器、MediaPipe BLE 追踪
  • M5Stack 出厂固件(AI Agent 由小智提供)与 StackChan World App
  • 社区 AI スタックチャン2(MIT):VOICEVOX 合成,Google Cloud STT 或 OpenAI Whisper 识别;仓库 2024 年后未更新

文档