2019年1月 UM2354 Rev 1 [English Rev 2] 1/30

UM2354

用户手册

用于连接Alexa Voice Service的ST框架，

STM32Cube软件扩展

引言

本用户手册将介绍STM32Cube扩展包的内容，该扩展包可从STM32应用连接到Alexa Voice

Service（AVS）。

X-CUBE-VS4A扩展包提供应用示例，将STMicroelectronics板连接到Amazon服务器，以便

在STM32器件上轻松实现面向AVS的产品。

X-CUBE-VS4A扩展包由一组库和基于STM32F7系列微控制器（充当支持Alexa的器件）的应

用示例组成。

X-CUBE-VS4A在32F769IDISCOVERY板上运行。它具有可直接运行的固件示例，用于演示简单

智能音箱的实现。

X-CUBE-VS4A提供了下列功能：

• 板配置接口

• TCP/IP连接功能

• AVS协议封装，便于轻松实现应用

• 应用特定的服务

• 用于Alexa Voice Service的STMicroelectronics框架

• 创建面向AVS的STM32应用

• 可替换的基础音频采集

• 有限音频播放器示例

注：

X-CUBE-VS4A

不包含用于音频前端增强的软件，也不包含需要与所有不同的音频服务兼容的

完整媒体播放器。

www.st.com

目录 UM2354

2/30 UM2354 Rev 1 [English Rev 2]

1 概述 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

2 关于安全的重要说明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

3 软件包说明 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3.1 概述 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

3.2 架构 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

3.3 文件夹结构 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11

4 应用中的集成 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.1 配置文件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.2 平台初始化 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

4.3 STVS4A事件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14

4.4 STVS4A持久对象 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

4.5 服务实现 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

4.5.1 简单服务实现 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

4.5.2 线程式服务实现 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

4.5.3 包含AVS指令/事件实现的服务 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

4.5.4 发送简单AVS事件 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16

4.5.5 AVS自定义事件流 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

4.5.6 管理同步事件状态 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

4.6 JSON和JANSSON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

4.7 调试JSON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

5 应用程序示例 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

5.1 应用描述 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

5.2 Alexa Voice Service帐户 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

5.3 网络设置和身份验证 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

5.4 Flash编程 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

5.5 使用应用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

5.6 可靠性测试 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

5.7 获取类似于printf的trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28