高通字库
版本 V1.01 · 更新于 2024-10-25

GTDB-X7ESP-V1 AI 开发板规格书

版本 V1.01 · 2024 年 10 月 25 日

版本修订记录

版本号修改内容日期备注
V1.0规格书制定2024-10
V1.01完善资料和教程2024-10

一、资料和教程

  1. GTDB-X7ESP-V1 AI 开发板源码地址：Gitee 仓库

  2. 在 ESP32 上移植 GT-HMI Engine 详细教程视频：Bilibili 视频

  3. Chat Bot 参数获取说明：Apifox API 文档

  4. Chat Bot v1 API 接口及示例：Apifox API 文档

  5. 智匠 AI KEY 申请流程：Apifox 文档

  6. 高通 GT-HMI 零基础详细教程：Bilibili 合集

  7. 高通智匠 AI 开发板详细教程（其余教程制作中，敬请期待）：

    1. 整体框架的环境搭建：Bilibili 视频
    2. GUI 页面设计流程：Bilibili 视频
    3. 链接 AI 云服务：Bilibili 视频
    4. GUI 界面与业务逻辑交互：Bilibili 视频

二、概述

GTDB-X7ESP-V1 AI 开发板是高通推出的一款基于高通 HMI 和 Chatbot 接口的智能语音交互平台，专为自然语言语音处理和物联网应用开发而设计。本文档主要介绍 ESP32-IDF、ADF 开发环境搭建、硬件规格、基本调试方法、注意事项等内容。

开发板适用于 AI 机器人聊天、语音控制、智能助手等应用场景，为开发者提供了完整的硬件和软件解决方案，便于快速构建人机自然语言交互系统。

三、基本配置参数

序号名称说明
1WiFi SOC 模块ESP32-S3-WROOM-1-N16R8
2核心处理器Xtensa® 32 位 LX7 双核处理器
3主控频率240MHz
4PSRAM8MB
5NOR FLASH16MB
6GUI 芯片16MB（可选）
7GUI LCD2.8 寸 GUI LCD（带 GUI 芯片）
8通讯方式USB 转 TTL
9电源DC 5V

四、开发板实物示意图

AI开发板实物示意图AI开发板实物示意图

五、底板接口和功能说明

序号名称说明
1液晶屏+GUI芯片接口适配 GT-GL240320T28-S0GC64
2WiFi SOC 模组ESP32-S3-WROOM-1-N16R8
3Norflash（或GUI芯片）推荐使用 GT5GL64/GT5GL128 ①
4摄像头暂不提供
5扩展 IO提供更多的输入输出接口
6音频功放NS4150B 放大音频信号驱动喇叭
7按键暂未适配驱动
8喇叭1W 8Ω
9AEC 回声消除消除麦克风采集到的回声，提升识别准确性
10麦克风阵列驱动芯片ES7210
11麦克风阵列LMA3729T381-OY1S
12音频解码ES8311 解码芯片
132.8V/1.5V 电源摄像头电源
143.3V 电源为各类外设芯片供电
15USBUSB 接口（USB 转串口），也可用于代码烧录、调试
16USB 转串口USB 转 TTL，用于代码烧录、调试
17SD 卡接口接 TF 卡

① 注：GT5GL64/GT5GL128 是 GUI 芯片，标配的 GUI LCD GT-GL240320T28-S0GC64 已焊接 GUI 芯片在 FPC 排线上，如额外需要则请联系高通业务购买，联系方式参见关于我们。

六、资料获取

1. 硬件资料获取

从 Gitee 开源仓库 GT-MindCraft Embedded/chatbot/Hardware 获取硬件资料，硬件资料内容及说明参考如下表格：

序号文件或文件夹名称说明
1元器件规格书主要元器件的规格书
2ProProject_高通 AI 开发板 9.7.epro嘉立创专业版的工程文件，主界面→导入专业版 打开文件
3SCH_Schematic1 高通 AI 开发板.pdf开发板原理图
4关于立创 EDA 专业版版本.txt嘉立创专业版的版本说明

2. 软件工程文件获取

从 Gitee 链接 GT-MindCraft Embedded/chatbot/ESP32 IDF Project 下载工程源码，使用搭建好环境的 VS Code 打开文件夹。

资料及内容说明：

序号文件或文件夹名称说明
1CJSONC 语言 JSON 解析库
2ESPTIMESP32-S3 定时器文件
3FLASH_SPIGUI 芯片 SPI 驱动
4GT_DRV音频、WiFi 驱动，HTTP 协议
5GT_TOUCH触摸驱动
6GUIHMI Engine GUI 框架文件
7LCD屏幕显示相关代码
8SPI屏幕 SPI 驱动
9SCREENGUI 应用层，资源调用及交互逻辑实现

七、ESP-IDF 和 ADF 开发环境搭建

参考高通 GT-HMI Builder 开源项目中的 chatbot 文件夹中的"ESP-IDF 以及 ESP-ADF 的环境搭建"文档，文档链接地址：GT-MindCraft Embedded/chatbot。

需严格按照版本要求及步骤进行安装。如果已有 5.14 版本的 ESP-IDF 环境以及 ESP-ADF 环境，没有下载文档里面的环境，只需要打补丁即可。

补丁地址：GT-MindCraft Embedded/chatbot/patch

将补丁复制到 esp-adf 路径下面，然后在 Git Bash 命令框下输入：

git apply 0001-add-esp32-s3-gt-borad.patch
git apply 0001-add-borad-esp_s3_gt_korvo2_v3.patch

八、WiFi 参数及 API KEY 修改

修改 WiFi 名称及密码：找到 components\GT\GT_DRV\wifi_config.c 文件，在文件中找到 #define DEFAULT_SSID 和 #define DEFAULT_PWD 字段，分别是 WiFi 名称和密码，修改成您使用的 WiFi 名称及密码。

获取 API KEY 及修改 API KEY：申请 API KEY 参考如下链接：Apifox 文档。

然后找到 components\GT\GT_DRV\http_send.c 中的 esp_http_client_set_header(client, "Authorization", "API keys"); 字段，将申请到的 API KEY 填入到 API keys 的位置。

九、编译与下载

按照教程文档在 VS Code 安装好 ESP32 IDF 并修改好 WiFi 名称及密码、API KEY 后，用 VS Code 打开 ESP32 IDF Project 文件夹进行编译下载，具体步骤请参考"ESP-IDF 以及 ESP-ADF 的环境搭建"文档。

驱动安装：开发板示意图的 16 部分是 USB 转 TTL 串口，采用的芯片是 CH340C，需要安装 CH340 驱动。CH340 驱动网上较多，找到适合自己系统的驱动安装好后，将开发板示意图 16 部分的 Type-C 接口连接电脑，打开"计算机管理"→"设备管理器"查看是否安装成功。

编译和下载选项编译和下载选项

首次编译时间较长，请耐心等待。

工程编译下载 ESP32 后需要将素材文件烧录到 FLASH 中，将 hmi-project\board 文件夹内的 resource.bin 文件使用 esptool 工具下载到 ESP32 模组中的 FLASH 中。

esptool 安装请参考：CSDN 教程，安装好后运行命令：

esptool.py --port COM12 write_flash 0x200000 resource.bin

将 resource.bin 烧录到 FLASH 中的 0x200000 地址，其中参数 COM12 请根据实际使用情况修改。

十、开发板其他例程获取

开发板除电源、USB 转 TTL、扩展 IO、GUI-LCD 接口和乐鑫官方推出的 korvo2_v3 开发板不同外，其余均大致相同，其余例程可参考乐鑫官方的 korvo2_v3 的例程进行开发。

十一、开发板使用注意事项

用户在操作开发板时，建议戴上防静电手套或静电手环等工具，以防止在使用过程中开发板被静电击穿损坏。

十二、联系信息

  • 公司：深圳高通半导体有限公司
  • 地址：深圳市福田区车公庙泰然九路金润大厦12C
  • 电话：0755-83453881 / 83453855
  • 技术支持：www.hmi.gaotongfont.cn