引言
* j" d  F, ^+ y; p$ P; o$ K1 D" v声级计库软件用户手册描述了SoundMeterR（SMR）模块配置及其接口。
; D$ h/ G& f/ c  |3 Z该用户手册描述了如何将模块集成到主程序，例如X-CUBE-AUDIO扩展软件中。它还提供了对基础算法的基本理解。
声级计库软件扩展适用于16或32位输入/输出格式。它是X-CUBE-AUDIO固件包的一部分。

/ @+ B) i* n& x+ `# v) m1 模块概述
7 h( P' U( Q7 p0 w6 @# @  E1 y1.1 算法功能
; E: e( u) l: F. KSoundMeteR（SMR）模块负责在对数尺度上测量传入信号的电平。它以尺度转换、平滑滤波和加权滤波为基础。
& r# ]# }0 R8 o5 `  E' }" z0 J1 h1 g当前实现对所有计算使用32位分辨率，可与16或32位输入/输出格式一起使用。支持的采样率为8 kHz、16 kHz和48 kHz。
3 Z0 r/ L& V4 y4 Z; q: t1.2 模块配置
- _/ O6 [. ], R3 e6 t& U; M- G/ SSMR模块支持单声道和立体声16位或32位I/O数据。其存储器受限于960个采样的最大输入帧大小，相当于10 ms的48 kHz立体声信号。
  E1 V2 c4 J8 i* s9 _9 O根据I/O格式、Cortex®内核和使用的工具链，有多个模块版本可供使用：
$ j& ]) t' I0 I9 L% c9 m• SMR_CM4_IAR.a / SMR_CM4_GCC.a / SMR_CM4_Keil.lib：适用于16位输入/输出缓冲区，在任何使用包含Cortex®-M4指令集的内核的STM32微控制器上运行。
• SMR_32b_CM4_IAR.a / SMR_32b_CM4_GCC.a / SMR_32b _CM4_Keil.lib：适用于32位输入/输出缓冲区，在任何使用包含Cortex®-M4指令集的内核的STM32微控制器上运行。
• SMR_CM7_IAR.a / SMR_CM7_GCC.a / SMR_CM7_Keil.lib：适用于16位输入/输出缓 冲区，在任何使用包含Cortex®-M7指令集的内核的STM32微控制器上运行。
• SMR_32b_CM7_IAR.a / SMR_32b_CM7_GCC.a / SMR_32b _CM7_Keil.lib：适用于32位输入/输出缓冲区，在任何使用包含Cortex®-M7指令集的内核的STM32微控制器上运行。

+ X& D6 m$ w& ?% L/ r, e1.3 资源总结
表 1包含模块对存储器和频率（MHz）的要求。
, B+ s- o% Y4 W0 b9 k使用:IAR Embedded Workbench for ARM V7.40(IAR Embedded Workbench common components v7.2)测量板上的内存占用量。
1 I" C, p8 i. {0 T3 H9 W

) n/ ?- t) {7 c; V9 t0 l

2 模块接口
! x9 D$ O* o8 L: X: f- e使用SRM模块时需要集成其两个文件：SMR_xxx_My.a/.lib库和smr_glo.h头文件。它们包含所有要导出到软件集成框架的定义和结构。


注： audio_fw_glo.h文件是通用头文件，它对于所有音频模块都通用且必须包含在音频框架中。

, c* V4 t9 s' s/ ~* X' Y% h
2.1 API
5 m6 U# ]0 {+ A8 j0 `; s. o6 W六个通用函数软件接口：
3 f7 W2 }/ f* U0 k. Q5 j6 G: N9 p• smr_reset函数
' @6 [9 _0 g  x• smr_setParam函数
• smr_getParam函数
• smr_setConfig函数
4 j  N, [& t* f& m9 g) P  T• smr_getConfig函数
. |5 T  Q* c! @% n, P• smr_process函数
; A$ s3 H6 ?( J下面几节将分别描述每一个函数。
2.1.1 smr_reset函数
该例程初始化SMR模块的persistent memory，并使用默认值初始化静态和动态参数。
int32_t smr_reset(void *persistent_mem_ptr, void *scratch_mem_ptr);
7 u3 A2 K1 y- y+ Z% ]0 Z3 T% Q
2 @3 u( E" ]4 r% a

% H& _' v' b: ~- B0 @, I
0 J: M0 o& N- x" d* T6 {当实时处理尚未开始时，在初始化阶段，必须至少调用一次该例程。

2.1.2 smr_setParam函数
该例程从主框架将模块静态参数写入模块内存。可以在复位例程后，实时处理开始前对其进行调用。它负责处理静态参数（即模块处理期间参数值不能更改的参数）。
int32_t smr_setParam(smr_static_param_t *input_static_param_ptr, void *persistent_mem_ptr);
8 h9 V2 R' B+ G7 E( Z


  h3 x. |2 C/ s+ N0 J
2.1.3 smr_getParam函数
: ?: W) ^' i! H  k* ^该例程从模块内存为主框架获取模块静态参数。可以在复位例程后，实时处理开始前对其进行调用。它负责处理静态参数（即模块处理期间参数值不能更改的参数）。
  N7 q! i; ]* b) @5 M2 O3 Bint32_t smr_getParam(smr_static_param_t *input_static_param_ptr, void *persistent_mem_ptr);


" k% J# \4 ^) k

4 f; y- Q7 p7 d; i4 g5 P2.1.4 smr_setConfig函数
该例程从主框架为模块内存设置模块动态参数。可以在处理期间的任何时间对其进行调用。
* f( S) t! `6 H  E' V1 |) A$ dint32_t smr_setConfig(smr_dynamic_param_t *input_dynamic_param_ptr, void *persistent_mem_ptr);

2 @1 M. g- t7 b  ?

; g4 S. r+ h# M
  k) K0 \& \* f* ~" }8 s2 h2.1.5 smr_getConfig函数
0 }7 D. X, ~/ c; r9 @该例程从内部persistent memory为主框架获取模块动态参数。可以在处理期间的任何时间对其进行调用。
" h: v- m9 Q: L7 ]- p+ L2 v5 @int32_t smr_getConfig(smr_dynamic_param_t *input_dynamic_param_ptr, void *static_mem_ptr);
* ~. X! A8 R& h5 E


2.1.6 smr_process函数
该例程是模块的主要处理例程。
随时可以被调用来处理每帧数据。
0 a$ |1 E+ H# a, O. Y5 Oint32_t smr_process(buffer_t *input_buffer, buffer_t *output_buffer, void *persistent_mem_ptr);

5 Y( z6 y2 ~  D/ F5 P# n* X: ?


完整版请查看：附件