Stack-chan机器人教程用JavaScript打造M5Stack桌面伴侣【免费下载链接】stack-chanA JavaScript-driven M5Stack-embedded super-kawaii robot.项目地址: https://gitcode.com/gh_mirrors/sta/stack-chanStack-chan 是一款基于 M5Stack 开发板的开源桌面机器人固件完全用 JavaScript 编写运行在 Moddable 嵌入式运行时上。表情显示、转头动作、语音合成都可以通过几行 JS 代码驱动适合只有基础编程知识、想入门机器人开发的新手。准备清单硬件部分M5Stack 开发板一块Basic、Core2 或 CoreS3 均可舵机两只SG90PWM 信号或 RS30X / SCS0009串口总线3D 打印外壳仓库case/目录提供完整 STL 与 STEP 文件3.7V 锂聚合物电池400mAh / 640mAh 已实测可用USB Type-C 数据线软件部分Node.jsv22 已验证、git宿主机Linux / macOS / Windows 均可Ubuntu 24.04 已验证Stack-chan 打印外壳与内部结构首次体验实录第 1 步获取代码并安装依赖。git clone https://gitcode.com/gh_mirrors/sta/stack-chan cd stack-chan/firmware npm install第 2 步安装构建环境。项目内置 xs-dev 脚本自动拉取 Moddable SDK 和 ESP-IDF 两个工具链npm run setup -- --deviceesp32装完用npm run doctor自检输出里 Supported target devices 一栏出现esp32即环境可用。第 3 步编译并烧录主机固件。npm run flash产物输出在firmware/dist/bin/烧录完成后几秒屏幕上会出现 Stack-chan 的脸。此时是主机默认行为按 A 键每 5 秒随机看一个方向按 B 键依次看上下左右按 C 键反转脸部颜色。第 4 步安装第一个 MOD。MOD 是覆盖默认行为的用户应用安装后主机改跑它npm run mod -- mods/examples/look_around/manifest.json烧录成功后 Stack-chan 的表情显示与动作效果能力与玩法运动控制两个舵机分别负责水平pan与垂直tilt转向API 是robot.motion.lookAt([x, y, z])坐标单位米、角度单位弧度右手坐标系。场景配合摄像头做人脸追踪让它跟着人转头。表情系统通过context.face.setEmotion(...)和setColor(...)切换情绪与配色表情是独立渲染模块。场景对话时同步换脸模拟说话时的表情。语音合成context.audio.say(...)播放语音引擎可在配置中切换local本地预生成、voicevox、remote、elevenlabs、openai。场景接入聊天模块让机器人开口回答问题。Stack-chan 通过摄像头跟随目标转头输入与周边上下文对象暴露按键、触摸面板、IMU、灯光、摄像头等能力MOD 按需取用。场景把桌面机器做成传感器驱动的艺术装置人靠近就抬头。免代码玩法仓库提供 Web 块编辑器与模拟器浏览器里拼积木生成 MOD先在模拟器验证再安装到设备。场景教学课堂里学生不碰终端也能完成一个作品。参数调优与避坑关键配置写在firmware/host/app/manifest_local.json的config段配置项作用取值driver.type舵机驱动类型m5stackchan / scservo / rs30x / pwm / none / dynamixeldriver.panId / tiltId串口舵机 ID1~254ID1 管水平轴、ID2 管垂直轴driver.offsetPan / offsetTilt零点角度补偿-90~90tts.type语音引擎local / voicevox / remote / voicevox-web / elevenlabs / openai常见坑串口舵机共用一条信号线两只必须预设不同 ID装反方向会顶住外壳。舵机安装角度以可动范围中心为基准建议先烧固件空跑验证再拧螺丝固定。M5StackChan CoreS3 与 Stack-chan RT 两种平台分别锁定 m5stackchan、dynamixel 驱动改 driver.type 会被忽略。Wi-Fi 凭证、API Key 只写在本地 manifest_local.json不要提交进仓库。Docker 构建环境只在 Linux 上验证过WSL 与 macOS 存在容器连不上设备的问题。架构与扩展stack-chan/ ├── firmware/ │ ├── host/ │ │ ├── app/ # 主机程序、默认行为、各平台 manifest │ │ └── modules/ # audio / motion / ui / camera / connectivity 能力模块 │ ├── mods/examples/ # 官方示例 MODlook_around、face_tracker 等 │ ├── scripts/ # 构建、烧录、语音生成脚本 │ └── docs/ # 固件文档 ├── case/ # 3D 打印外壳STL / STEP ├── schematics/ # 扩展板电路设计KiCad └── web/ # Web 工具块编辑器 / 模拟器 / MOD Gallery三个扩展入口写新 MOD在firmware/mods/下建目录参考 API 文档 里的 StackchanContext 能力列表最小入口就是onContextCreated(robot)。加新舵机驱动驱动目录 已有 sg90、rs30x、dynamixel、scservo 等实现照协议层模式扩展即可。用 Web 工具链web/editor/的块编辑器与web/simulator/模拟器构成免编译调试回路。资源索引快速开始firmware/docs/getting-started.md构建与烧录firmware/docs/flashing-firmware.md固件 APIfirmware/docs/api.mdMOD 开发指南firmware/mods/README.md外壳组装case/README.md电路设计schematics/README.md语音生成脚本firmware/scripts/下的 generate-speech-google.js、generate-speech-voicevox.js先把主机烧录起来确认脸部显示再安装 look_around 示例观察转头。下一步改一下它的 lookAt 坐标做成你的第一个 MOD。【免费下载链接】stack-chanA JavaScript-driven M5Stack-embedded super-kawaii robot.项目地址: https://gitcode.com/gh_mirrors/sta/stack-chan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Stack-chan机器人教程：用JavaScript打造M5Stack桌面伴侣
Stack-chan机器人教程用JavaScript打造M5Stack桌面伴侣【免费下载链接】stack-chanA JavaScript-driven M5Stack-embedded super-kawaii robot.项目地址: https://gitcode.com/gh_mirrors/sta/stack-chanStack-chan 是一款基于 M5Stack 开发板的开源桌面机器人固件完全用 JavaScript 编写运行在 Moddable 嵌入式运行时上。表情显示、转头动作、语音合成都可以通过几行 JS 代码驱动适合只有基础编程知识、想入门机器人开发的新手。准备清单硬件部分M5Stack 开发板一块Basic、Core2 或 CoreS3 均可舵机两只SG90PWM 信号或 RS30X / SCS0009串口总线3D 打印外壳仓库case/目录提供完整 STL 与 STEP 文件3.7V 锂聚合物电池400mAh / 640mAh 已实测可用USB Type-C 数据线软件部分Node.jsv22 已验证、git宿主机Linux / macOS / Windows 均可Ubuntu 24.04 已验证Stack-chan 打印外壳与内部结构首次体验实录第 1 步获取代码并安装依赖。git clone https://gitcode.com/gh_mirrors/sta/stack-chan cd stack-chan/firmware npm install第 2 步安装构建环境。项目内置 xs-dev 脚本自动拉取 Moddable SDK 和 ESP-IDF 两个工具链npm run setup -- --deviceesp32装完用npm run doctor自检输出里 Supported target devices 一栏出现esp32即环境可用。第 3 步编译并烧录主机固件。npm run flash产物输出在firmware/dist/bin/烧录完成后几秒屏幕上会出现 Stack-chan 的脸。此时是主机默认行为按 A 键每 5 秒随机看一个方向按 B 键依次看上下左右按 C 键反转脸部颜色。第 4 步安装第一个 MOD。MOD 是覆盖默认行为的用户应用安装后主机改跑它npm run mod -- mods/examples/look_around/manifest.json烧录成功后 Stack-chan 的表情显示与动作效果能力与玩法运动控制两个舵机分别负责水平pan与垂直tilt转向API 是robot.motion.lookAt([x, y, z])坐标单位米、角度单位弧度右手坐标系。场景配合摄像头做人脸追踪让它跟着人转头。表情系统通过context.face.setEmotion(...)和setColor(...)切换情绪与配色表情是独立渲染模块。场景对话时同步换脸模拟说话时的表情。语音合成context.audio.say(...)播放语音引擎可在配置中切换local本地预生成、voicevox、remote、elevenlabs、openai。场景接入聊天模块让机器人开口回答问题。Stack-chan 通过摄像头跟随目标转头输入与周边上下文对象暴露按键、触摸面板、IMU、灯光、摄像头等能力MOD 按需取用。场景把桌面机器做成传感器驱动的艺术装置人靠近就抬头。免代码玩法仓库提供 Web 块编辑器与模拟器浏览器里拼积木生成 MOD先在模拟器验证再安装到设备。场景教学课堂里学生不碰终端也能完成一个作品。参数调优与避坑关键配置写在firmware/host/app/manifest_local.json的config段配置项作用取值driver.type舵机驱动类型m5stackchan / scservo / rs30x / pwm / none / dynamixeldriver.panId / tiltId串口舵机 ID1~254ID1 管水平轴、ID2 管垂直轴driver.offsetPan / offsetTilt零点角度补偿-90~90tts.type语音引擎local / voicevox / remote / voicevox-web / elevenlabs / openai常见坑串口舵机共用一条信号线两只必须预设不同 ID装反方向会顶住外壳。舵机安装角度以可动范围中心为基准建议先烧固件空跑验证再拧螺丝固定。M5StackChan CoreS3 与 Stack-chan RT 两种平台分别锁定 m5stackchan、dynamixel 驱动改 driver.type 会被忽略。Wi-Fi 凭证、API Key 只写在本地 manifest_local.json不要提交进仓库。Docker 构建环境只在 Linux 上验证过WSL 与 macOS 存在容器连不上设备的问题。架构与扩展stack-chan/ ├── firmware/ │ ├── host/ │ │ ├── app/ # 主机程序、默认行为、各平台 manifest │ │ └── modules/ # audio / motion / ui / camera / connectivity 能力模块 │ ├── mods/examples/ # 官方示例 MODlook_around、face_tracker 等 │ ├── scripts/ # 构建、烧录、语音生成脚本 │ └── docs/ # 固件文档 ├── case/ # 3D 打印外壳STL / STEP ├── schematics/ # 扩展板电路设计KiCad └── web/ # Web 工具块编辑器 / 模拟器 / MOD Gallery三个扩展入口写新 MOD在firmware/mods/下建目录参考 API 文档 里的 StackchanContext 能力列表最小入口就是onContextCreated(robot)。加新舵机驱动驱动目录 已有 sg90、rs30x、dynamixel、scservo 等实现照协议层模式扩展即可。用 Web 工具链web/editor/的块编辑器与web/simulator/模拟器构成免编译调试回路。资源索引快速开始firmware/docs/getting-started.md构建与烧录firmware/docs/flashing-firmware.md固件 APIfirmware/docs/api.mdMOD 开发指南firmware/mods/README.md外壳组装case/README.md电路设计schematics/README.md语音生成脚本firmware/scripts/下的 generate-speech-google.js、generate-speech-voicevox.js先把主机烧录起来确认脸部显示再安装 look_around 示例观察转头。下一步改一下它的 lookAt 坐标做成你的第一个 MOD。【免费下载链接】stack-chanA JavaScript-driven M5Stack-embedded super-kawaii robot.项目地址: https://gitcode.com/gh_mirrors/sta/stack-chan创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考