¶ 示例工程快速上手
¶ 写在前面
为了让开发者快速体验语音AI开发套件，我们提供了 大模型语音对话的应用示例工程。熟悉后您还可以基于此工程进一步构建其他 AI 应用。
如未明确说明，本文档所描述的开发环境以及工具都是基于linux进行的。
¶ 示例工程介绍
¶ 功能介绍
本示例功能包含：
- 语音识别：支持离线识别指定唤醒词并进行录音
- 网络：通过 WIFI 芯片接入网络，对接聆思大模型平台，支持与大模型进行对话
¶ 快速体验
如果您初次拿到开发套件，且希望快速大模型语音对话能力，可以通过下载体验固件，并在已经安装了cskburn命令行工具后执行烧录指令进行固件烧录并体验。(套件出厂时也已默认烧录本固件)
完成上述固件镜像下载后，使用 Type-C 数据线连接开发套件的 DAP_USB接口，执行以下命令进行烧录：
cskburn -C 6 -s /dev/ttyACM0 -b 1500000 0x0 ./fw.hex
¶ 上手指南
¶ 环境准备
¶ 安装编译链
检查编译链是否正常安装,运行以下命令有正常输出即安装正常
arm-none-eabi-gcc -v
¶ 安装烧录工具
cskburn
检查cskburn是否正常安装，运行以下命令有正常输出即安装正常
cskburn --version
¶ 拉取 SDK 代码
执行以下指令，拉取示例工程 SDK 代码至本地：
git clone -b v1.1 git@cloud.listenai.com:CSKG406789/aiui.git
¶ 工程项目结构
├── arch 存放链接脚本
├── build.sh 构建脚本
├── doc 文档
├── include 头文件
├── lib 静态库
├── Makefile 顶级Makefile
├── modules 存放的一些模块
├── out 构建输出目录
├── res 资源文件
├── rules.mk 通用makefile规则
├── src 存放应用代码
├── tools 存放一些工具以及脚本
└── version 版本号
¶ 固件打包与编译
运行根目录下的build.sh脚本对工程进行编译
./build.sh
成功编译可以看到控制台输出以下信息
linking: ../out/venus_ap in CSK6001 ...
text data bss dec hex filename
772628 3452 1955304 2731384 29ad78 ../out/venus_ap
Build Info: 2023-12-22 14:41:05_05dc6ad_dirty_BASE
version: 1.1.4
version string: 1.1.4
Make CSK6 AP Binary success!!!
编译成功后，还需要对资源文件进行打包
./tools/pack_tool/CSKPackOneHex res/lsboot.bin 0x000000 out/venus_ap.bin 0x20000 res/respak.bin 0x200000 res/tone.bin 0x680000
成功打包将会生成fw.hex
parse res/lsboot.bin file addr = 0x18000000,file size = 82196
parse out/venus_ap.bin file addr = 0x18020000,file size = 776576
parse res/respak.bin file addr = 0x18200000,file size = 3519176
parse res/tone.bin file addr = 0x18680000,file size = 876396
create fw.hex file success
¶ 烧录固件
如图连接开发板后，对开发板进行重新上电，运行cskburn对开发版进行烧录，执行以下命令进行烧录，其中*/dev/ttyACM0*要改成自己的串口：
cskburn -C 6 -s /dev/ttyACM0 -b 1500000 0x0 ./fw.hex
烧录完成后，拔掉短接的杜邦线，重新上电即可。
¶ 配网说明
将语音AI开发套件的TXD、RXD、GND分别连接串口小板的RXD、TXD、GND。
语音AI开发套件的TXD、RXD、GND位置如下图所示：
使用串口工具，勾选CRLF（又称加回车换行），逐行发送以下命令：
listen flash set string vir_ssid {wifi名称}
listen flash set string vir_pwd {wifi密码}
重启设备后设备将自动连接写入的Wi-Fi。
¶ 体验大模型语音对话功能
配网成功后，您就可以通过唤醒词小聆小聆唤醒设备，接下来尽情体验大模型语音对话的魅力吧！
每次对话前都需要使用唤醒词