ESP32 AI聊天机器人GUI版（模型，音色，人物形象自定义）

介绍

        GT-MindCraft Embedded 开源硬件系列是一个集成了GT-HMI图形用户界面（GUI）框架和智匠MindCraft一站式AI调用平台的综合解决方案，使用WIFI SOC开源硬件，通过GT-HMI与智匠MindCraft的一站式AI调用平台的完美搭配，开发者不仅可以轻松实现聊天机器人应用，还可以探索更多创新应用场景，如智能家居、智能办公等。GT-MindCraft Embedded 开源硬件系列为开发者提供了强大的技术支持，助力实现更多可能性。

本工程gitee 链接(也可参考附件)

• https://gitee.com/genitop/gt-mindcraft-embedded/tree/master/chatbot

实物显示效果及GT-HMI工程界面

功能与硬件框图

附件chatbot文件夹架构

• chatbot文件夹结构

|-ESP32 IDF Project/	chatbot开发板示例ESP32 IDF工程文件
|-hmi-project/	chatbot开发板示例GT-HMI 工程文件
|- |-board/	资源文件及代码
|- |-out/	资源文件及代码（适合非HMI模块用户）
|- |-screen/	UI界面交互代码
|- |-sources/	图片素材文件
|- |-*.gtui尾缀文件	模块的示例工程文件，使用HMI-Designer打开
|-Hardware/	chatbot开发板原理图，PCB

快速开始

• 硬件准备：
  • 客户可参考附件文件中的Hardware文件夹下提供的硬件资料自己设计PCB板，
  • 也可以使用高通智匠 AI开发板。
• 软件安装：
  • HMI Designer 安装：从高通官网 www.hmi.gaotongfont.cn 下载并安装HMI-Designer软件。用于打开附件文件中hmi-project文件夹中的 “AI机器人.gtui”工程文件。可以仿真查看本项目的上位机交互逻辑，某些功能上位机无法实现，需要下位机代码实现，具体请查看附件文件中的下位机的ESP32 IDF Project\components\GT\screen\代码及代码注释
  • ESP32 IDF 安装：参考附件文件中ESP32 IDF Project文件夹中的 “ESP-IDF以及ESP-ADF的环境搭建”文档，需严格按照版本要求及步骤进行安装，如果已有5.14版本的ESP-IDF环境以及ESP-ADF环境，没有下载文档里面的环境，只需要打补丁即可，补丁地址 (或复制https://gitee.com/genitop/GT-HMI-Builder/tree/master/GT-MindCraft%20Embedded/chatbot/patch) ，将补丁复制到esp-adf路径下面， 然后在git bash命令框下输入git apply 0001-add-esp32-s3-gt-borad.patch 和git apply 000l-add borad-esp_s3_gt_korvo2_v3.patch就可以加入补丁
• 移植：
  • 如使用高通智匠AI开发板，已经全部移植好，并有代码注释，直接运行即可，如使用其他ESP32开发板请参考如下建议。
  • GT-HMI Engine移植：请参考视频【在ESP32上移植GT-HMI Engine详细教程】 (或复制https://www.bilibili.com/video/BV1dBsVeDEMR/?share_source=copy_web&vd_source=51817f89c7e6ffe331e366d0963376b5)
  • ESP32外设移植：ESP32部分的外设在ADF框架下移植请参考乐鑫官方文档及示例,本开发板除电源、USB转TTL、扩展IO、 GUI-LCD接口和乐鑫官方推出的korvo2_v3开发板不同外，其余均大致相同，相同部分的外设及例程可参考乐鑫官方的korvo2_v3的例程进行开发。
• API KEY修改：
  • 获取API KEY及修改API KEY：申请API KEY参考如下链接API KEY链接(或复制 https://apifox.com/apidoc/shared-0fd7ea54-919e-4c93-b673-c60219bc82e0/doc-4739665)，然后找到附件文件中ESP32 IDF Project\components\GT\GT_DRV\http_send.c 中的esp_http_client_set_header(client."Authorization","API keys");字段，将申请到的API KEY填入到API keys的位置
• 编译与下载：
  • 按照教程文档在VSCode安装好ESP32 IDF并修改好WIFI名称及密码 API KEY后，用VSCode 打开附件文件中ESP32 IDF Project文件夹进行编译下载，具体步骤请参考“ESP-IDF以及ESP-ADF的环境搭建”文档
  • 工程编译下载ESP32后需要将素材文件烧录到FLASH中，打开附件文件中"hmi-project\board\"文件夹，将board文件夹内的resource.bin文件使用esptool工具下载到 ESP32 模组中的FLASH中,esptool安装请参考如下链接：链接(或复制https://blog.csdn.net/qq_59527512/article/details/140307594)，安装好后 运行命令 esptool.py --port COM12 write_flash 0x200000 resource.bin 将resource.bin烧录到FLASH中的0x200000地址，其中参数COM12请根据实际使用情况修改
  • 自行设计的PCB，需要根据主控厂商的文档进行编译和下载MCU执行文件，工程编译后将附件文件中"hmi-project\board\文件夹内的resource.bin文件用烧录器或者自制升级程序烧录到GUI芯片当中
• 测试运行：
  • 下载后，点击界面下面的按钮控件，看是否能够正常切换界面及语音交互

视频教程，陆续发布，敬请期待

• 高通智匠AI开发板：整体框架的环境搭建
• 高通智匠AI开发板：GUI界面的设计流程
• 高通智匠AI开发板：链接AI云服务
• 高通智匠AI开发板：GUI界面与业务逻辑交互

智匠chatbot API接口文档

• chat bot 参数获取
• chat_bot_v1 API接口及示例

智匠AI KEY申请流程

• 如何获取API KEY