桌面表情机器人

• 第一款工业风格的桌面机器人，外观时尚酷炫，是理想的桌面装饰品。
• 性价比无与伦比，以极低的价格就能实现千元级桌面机器人的性能。
• 配备两自由度云台和丰富的头部动作，是一款真正灵动的桌面机器人。
• 经过精心调校的表情动画和运动算法，带来流畅生动的交互体验，极具情感吸引力。
• 能够根据回复的情感基调做出相应的回应动作。
• 支持手势识别，实现互动式参与。
• 兼容大规模模型语音对话。

资源

• 哔哩哔哩视频
• 固件下载
• 文档

购买它！

• 淘宝店铺
• 小红书

作者

• Mark Yang
• 邮箱：mark.yang@ewen.ltd

版权声明

• 本项目的开源部分采用 GPLv3 许可证。用户可在许可条款范围内自由学习、修改，并进行非商业性的DIY活动。未经授权 的商业使用严格禁止，违者将承担法律责任。

Desk-Emoji 快速上手指南

Desk-Emoji 是一款开源的工业风桌面机器人项目，支持表情动画、手势识别及大模型语音对话。本指南将帮助你快速搭建基础环境并运行固件。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：推荐 Windows 10/11, macOS 或 Linux (Ubuntu 20.04+)。
• 硬件接口：具备 USB 端口的电脑，用于连接机器人主板进行固件烧录。
• 前置依赖：
  • Git：用于克隆项目代码。
  • Python 3.8+：用于运行上位机脚本或调试工具（如需）。
  • 串口驱动：根据主控芯片型号（如 CH340, CP210x 等）安装对应的 USB 转串口驱动程序。
  • IDE/烧录工具：推荐使用 VS Code (配合 PlatformIO 插件) 或 Arduino IDE，具体取决于固件源码结构。

安装步骤

1. 获取源代码

使用 Git 克隆项目仓库。国内用户建议使用 Gitee 镜像（如有）或通过代理加速 GitHub 访问。

git clone https://github.com/ideamark/desk-emoji.git
cd desk-emoji

2. 安装依赖库

进入项目目录后，安装所需的 Python 依赖（如果项目包含上位机工具）：

pip install -r requirements.txt

提示：国内用户可使用清华源加速安装： pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

3. 编译与烧录固件

本项目固件通常基于嵌入式框架开发。请根据 doc/en 文档中的具体硬件说明选择编译方式。若使用 PlatformIO：

# 安装 platformio 核心 (如未安装)
pip install platformio

# 编译固件
pio run

# 连接设备后烧录 (需替换 <port> 为实际串口名称，如 COM3 或 /dev/ttyUSB0)
pio run --target upload --upload-port <port>

若项目提供预编译固件，可直接前往 Releases 页面 下载最新 .bin 文件，并使用烧录工具（如 esptool 或官方刷机工具）写入设备。

基本使用

完成固件烧录后，重启设备即可体验基础功能。

1. 启动设备：通过 USB 线或电池给 Desk-Emoji 供电。
2. 观察动作：设备启动后将自动执行初始化自检，云台将进行归零操作，随后进入待机表情循环。
3. 交互测试：
   • 手势识别：在摄像头前尝试挥手或特定手势，观察机器人头部跟随或表情变化。
   • 语音对话：若已配置大模型接口，对着麦克风说话，机器人将根据语义情感做出相应的动作反馈。

简单调试示例（Python 上位机）： 如果项目包含串口调试脚本，可通过以下命令查看设备状态日志：

python tools/serial_monitor.py --port <port> --baud 115200

现在，你的 Desk-Emoji 已经准备就绪，可以作为桌面的动态装饰或与开发者进行更深入的二次开发。