Gizwits + Coze AIoT 技术文档

【免费下载链接】OpenEmbodied OpenEmbodied 项目地址: https://gitcode.com/GizwitsIoT/OpenEmbodied

1. 安装指南

1.1 硬件准备

• 支持 ESP32-S3/C3/P4/C2 芯片的开发板（如立创实战派、乐鑫 BOX3、M5Stack CoreS3 等）
• 确保设备具有 Wi-Fi 或 4G 网络连接能力
• 可选配件：OLED/LCD 显示屏、摄像头模块

1.2 开发环境配置

• 安装 VSCode 或 Cursor 编辑器
• 添加 ESP-IDF 插件（SDK 版本需 ≥5.3）
• 推荐使用 Linux 系统以获得更好的编译性能
• 配置 Google C++ 代码风格检查工具

2. 项目使用说明

2.1 设备配网

小程序配网

1. 打开机智云配套小程序
2. 点击右上角"+"按钮进入配网模式
3. 按照提示完成 Wi-Fi 或 4G 网络配置

Web 配网

1. 访问配网专用页面
2. 选择设备类型并输入网络凭证
3. 等待设备连接成功提示

2.2 基础功能操作

• 语音唤醒：通过 BOOT 键或离线唤醒词激活
• 多语言交互：支持中/英/日/韩等语言识别
• 显示控制：OLED/LCD 可显示信号强度或对话内容
• 多模态输入：支持语音+摄像头协同工作

3. 项目 API 使用文档

3.1 语音流式传输

// WebSocket 语音流示例
void start_voice_stream() {
    websocket_client.connect("wss://coze.stream.api");
    websocket_client.send(audio_config);
    while(recording) {
        websocket_client.send(audio_chunk);
    }
}

3.2 MQTT 控制接口

主题	方向	说明
/device/control	下发	接收云端控制指令
/device/status	上报	发送设备状态数据
/device/log	上报	传输运行日志

3.3 多语言配置

通过修改 config/lang_config.h 中的参数：

#define LANGUAGE_ZH_CN 1
#define VOICE_STYLE    "female_gentle"

4. 项目安装方式

4.1 固件烧录

1. 下载最新固件包
2. 使用 esptool 工具写入设备：

esptool.py write_flash 0x0 firmware.bin

4.2 开发板适配

1. 在 main/boards/ 目录创建新板型定义文件
2. 实现必要的硬件抽象层接口：

typedef struct {
    void (*display_init)(void);
    void (*button_handler)(int);
} board_ops_t;

4.3 智能体部署

1. 在 Coze 平台创建智能体工作流
2. 配置 MQTT 连接参数
3. 发布到机智云 Gokit5 平台
4. 通过小程序测试功能交互

注意事项

• 4G 模组需额外配置 APN 信息
• 语音识别精度受环境噪声影响
• 多模态功能需要足够的内存资源
• 长期运行建议启用自动固件更新功能

【免费下载链接】OpenEmbodied OpenEmbodied 项目地址: https://gitcode.com/GizwitsIoT/OpenEmbodied