开发说明

本文档适合想要自行编译或修改小智AI程序的开发者参考。包含完整的开发环境搭建流程、核心通信协议和扩展功能实现方法。

开发环境

ESP-IDF 开发环境搭建及编译小智

详细的 ESP-IDF 开发环境搭建指南，包含 Windows 下的完整配置步骤。

BluFi 配网指南

使用 BluFi BLE 进行 Wi-Fi 配网的完整指南，包含配置步骤和工作流程说明。

代码风格指南

项目代码风格规范，基于 clang-format 工具和 Google C++ 风格指南。

通信协议文档

WebSocket 通信协议

详细说明了设备与服务器之间的 WebSocket 通信实现，包括连接建立、消息格式、音频传输等核心功能。

Emoji 心情显示

介绍了大语言模型如何使用 Emoji 来表达情绪状态，以及相关的数据格式和使用说明。

项目源码结构

小智AI项目主要由以下几个部分组成：

1. 主控程序：运行于ESP32系列芯片
2. 服务端：处理设备连接和语音转发
3. 前端界面：配网和设置页面

详细源码结构和功能说明可以参考GitHub仓库。

开发常见问题

• 编译报错解决：通常与ESP-IDF版本不匹配有关，请使用文档推荐的特定ESP-IDF版本
• 连接超时：检查WebSocket服务器配置和网络连接
• 内存不足：ESP32-S3开发板性能更高，推荐使用

文档索引