引言
: [3 e; K; H5 i8 M本用户手册将介绍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提供了下列功能：
1 n* B9 V* W5 Z, {! U• 板配置接口
0 `" ^6 j- V' Z4 I6 ?$ m" }• TCP/IP连接功能
• AVS协议封装，便于轻松实现应用
$ S, m) m2 p& @2 }; u• 应用特定的服务
• 用于Alexa Voice Service的STMicroelectronics框架
• 创建面向AVS的STM32应用
0 g0 u" u/ {  P7 h! u. W) R• 可替换的基础音频采集
/ H- E+ }4 S! T/ ^6 }* i' ?• 有限音频播放器示例
# v% B% h$ I. j6 ?, [
: c6 }8 I2 S# S1 `) C
( ]3 _$ {3 A% h# l' e# ^注：X-CUBE-VS4A不包含用于音频前端增强的软件，也不包含需要与所有不同的音频服务兼容的
% c8 S$ }) M# W完整媒体播放器
1 Y& x8 ?) f4 G5 o8 u

. a8 \6 v: N: k+ ], M* ?. i1概述
本用户手册将介绍X-CUBE-VS4A扩展包和STVS4A语音服务中间件。侧重点在于说明其使用，而不是解释Alexa架构或AVS帐户创建。后者的相关说明可以在Amazon网站和开发者网站上找到：


X-CUBE-VS4A扩展包在STM32基于Arm®(a) Cortex®-M处理器的32位微控制器上运行。
9 I4 ^! K8 j: U# k  g9 w. V表 1给出了相关术语和缩略语的定义，帮助您更好地理解本文档。

7 R5 E) W5 M6 Q* i0 t' f
, j* t, F9 o' T: _4 ?, `* I$ V


2关于安全的重要说明
注意：
应用开发人员必须注意安全方面，并通过实施机制来保护用于连接AVS的令牌和密钥。
X-CUBE-VS4A扩展包中提供的应用示例未实施此类机制。它只提供了一个基本实现，以便理解栈接口。
$ T+ o7 ]5 b; B, L! l, ~
* e* \- z0 r" O: m: ]& }. ]% d$ e
3软件包说明
本章详述了X-CUBE-VS4A扩展包的内容和使用。
. ^/ j' o3 `0 V  ?. t$ n7 o7 W  w1 B

4 }0 S9 n  y# o; z* X. j3 d  i3.1概述
& y. f: n& Z, b& d, cX-CUBE-VS4A扩展包基于STVS4A，是支持基于STM32的Alexa Voice Service器件设计的软件开发套件。STVS4A具有服务API，用于连接AVS服务器和与服务器协商身份验证。STVS4A还为接收指令和向服务器发送事件提供支持。此外，STVS4A提供一组音频支持，包括麦克风采集和音频回放。通过添加外部元件， STVS4A支持可扩展至文字识别。
! _* m+ F' w9 ~2 z+ w8 `STVS4A支持Alexa Voice Service API版本v20160207。
. O5 l7 y) W& v2 [1 @可支持以下集成开发环境：
& e% K3 q+ v0 ?- h! @1 B* |% C# |! q•IAR Embedded Workbench® for Arm® (EWARM)
•Keil®微控制器开发套件（MDK-ARM）
! X7 n& q3 z! Q% m+ K•System Workbench for STM32

: [0 B7 d) d8 X+ B. h. ]! J注： 有关所支持IDE版本的信息，请参阅软件包根文件夹中的版本说明。UM2354 Rev 1 [English Rev 2] 9/30

3.2架构
' f" c$ v' d  T! g' R9 i图 1概括了X-CUBE-VS4A软件架构。
7 w) V9 r1 {7 |# h6 `- M. M; ~



! Q8 B7 M, O5 s7 N% V: z/ H
' ^& Z+ v- @* S* ^+ ?8 r3 q
X-CUBE-VS4A是STM32Cube的扩展包，它：
/ _# ^0 s, l' B: g+ I0 c•完全兼容STM32Cube架构
. C1 W& v+ a6 c. Q' e6 B- u•扩展STM32Cube用于支持AVS的应用的开发
•使用STM32微控制器的硬件抽象层STM32CubeHAL
除了第 3.1节：概述中所述的功能，X-CUBE-VS4A扩展包和STVS4A中间件还具有以下功能：
& a4 ?6 @1 W2 ]" D•STVS4A为配置提供API，该API主要用在初始化阶段。
•STVS4A还提供一个API，用于通过应用自定义某些服务，例如访问持久存储器以加载和保存AVS令牌。
$ L3 F0 Y7 E; H5 @•STVS4A使用事件驱动的架构。初始化后，STVS4A主要使用通知与用户应用通信。通知是包含一个或多个参数的代码。参数是取决于事件的不透明变量。它可以理解为整数、结构指针、句柄或任何其他含义。参数的含义记录在事件文档中。
* u" G% p  ^* K8 e* i  t6 v•移植层用于自定义应用特定的环境中的STVS4A中间件。自定义确保与可能不同的MCU、网络和音频接口的连接。
•应用和中间件组件在FreeRTOS™环境中运行。
* y1 g: c* @2 l  V8 Y, Y: l•HTTP/2是与AVS服务器交互所使用的主要通信协议。
) l& n# s- r/ {% F4 V) tX-CUBE-VS4A提供一个库，用于管理该协议。
" ?3 h0 q2 P. m, n•LwIP负责TCP/IP通信服务。由MbedTLS元件提供加密。
  m- R% \1 }6 f) m9 l! k4 b•STM32Audio为音频输入和输出以及MP3解码提供库。
•X-CUBE-VS4A扩展包是STM32Cube生态系统的一部分。它依赖其BSP和HAL驱动。


3.3文件夹结构
9 l4 x* e' f9 G" o+ n图 2给出了X-CUBE-VS4A扩展包的文件夹结构。

# b4 [6 R( K+ Z6 x" m  _3 n; i1 N
4 Q8 u5 K3 H1 }) C

9 V* V. u/ o0 f2 h# K' C( A
完整版请查看：附件
4 P$ R0 b2 d& [4 ^8 b/ V/ n
" M) i1 R( N6 `& H1 S
3 s- ~, r- N: |3 L' M
7 ?# J7 [; L- `/ Q3 q1 U