特别说明:完整45期数字信号处理教程,原创高性能示波器代码全开源地址:链接
) H& ^2 m/ N# x g/ [/ Z+ x2 G7 J$ I6 ?! `第22章 math_help中函数的使用
) t5 t# ^$ t0 k 本期教程主要讲解math_help文件中函数的使用,这个文件也是ARM官方提供的,这些函数相对都比较容易,同时使用频率也很高。希望初学的同学学习并掌握。 22.1 函数讲解 22.3 总结 ) p+ Q i* N" Z) f- r
22.1 函数讲解: o( F( R7 B4 {9 I& r
22.1.1 函数目录 在文件math_help文件中主要有以下函数: - float arm_snr_f32(float *pRef, float *pTest, uint32_t buffSize); ) f: y! c0 G/ _" ]
- void arm_float_to_q12_20(float *pIn, q31_t * pOut, uint32_t numSamples);
7 C r0 f% K8 l8 Q; u9 c3 b, U - void arm_provide_guard_bits_q15(q15_t *input_buf, uint32_t blockSize, uint32_t guard_bits);
2 z* ~: C! K0 [ L7 o: { - void arm_provide_guard_bits_q31(q31_t *input_buf, uint32_t blockSize, uint32_t guard_bits);
" g% I+ Z. f5 a% D# f) f+ B1 F - void arm_float_to_q14(float *pIn, q15_t *pOut, uint32_t numSamples);# K6 y" D) o' i! S ^4 h7 }# d7 ^
- void arm_float_to_q30(float *pIn, q31_t *pOut, uint32_t numSamples);5 N9 n( O* ]9 l6 Z7 |
- void arm_clip_f32(float *pIn, uint32_t numSamples);
$ N/ a' x8 D* a - uint32_t arm_calc_guard_bits(uint32_t num_adds);8 x+ w! o& q5 J- F2 N- w5 s
- void arm_apply_guard_bits (float32_t * pIn, uint32_t numSamples, uint32_t guard_bits);
5 D) a) R& h R& U. s: c L - uint32_t arm_compare_fixed_q15(q15_t *pIn, q15_t * pOut, uint32_t numSamples);( ?# F% w( I' N5 Q7 y
- uint32_t arm_compare_fixed_q31(q31_t *pIn, q31_t *pOut, uint32_t numSamples);
" a0 \5 F g4 O. b - uint32_t arm_calc_2pow(uint32_t guard_bits);
复制代码 ; q$ R7 ^. H; z% ~. k
22.1.2 arm_snr_f32 这个函数用于求信噪比: - /** (1): c; e% D2 M) ?, s) e$ `2 Q
- * @brief Caluclation of SNR
) l$ t* I. i& g7 @ - * @param float* Pointer to the reference buffer
6 a6 X: m7 X; {, e, h6 p5 I+ h$ a - * @param float* Pointer to the test buffer5 e$ U: ?1 Q4 w# o! D% M
- * @param uint32_t total number of samples
* @+ f U3 ^) J5 d, X' } - * @return float SNR( F; S7 m7 f4 L2 W8 H
- * The function Caluclates signal to noise ratio for the reference output
2 t* R- D, y+ F s - * and test output
) ]5 F; {( E0 e& O+ l: B( P, q& { - */+ @2 z2 i6 Q* S4 x6 n# ?
- 2 C E' L- w! r- b
- float arm_snr_f32(float *pRef, float *pTest, uint32_t buffSize)
( V. Z( }& _2 V @+ ` - {7 E/ a. j4 `* D: p
- float EnergySignal = 0.0, EnergyError = 0.0;4 d+ }% g4 n2 l1 W& l* Z
- uint32_t i;: H8 G0 s* y; D+ H
- float SNR;3 Q$ ?: q3 J. Q3 ~
- int temp;# x( M$ o( ?2 }* {& p3 w4 ]4 \
- int *test;% g# o' q1 m1 A7 v9 F
-
9 K* Y2 ] {3 U4 j: J2 w8 x: I+ R - for (i = 0; i < buffSize; i++)
- x+ { }: C5 a, N1 ^ - {3 X$ Q" p* f4 @- ~
- /* Checking for a NAN value in pRef array */9 s2 Q4 F3 o( L: r) q5 A% H8 r( }
- test = (int *)(&pRef[i]);
) l4 `, q# M; m& |! C - temp = *test;' A% y- G y( @. Z4 K) l, P& X6 C
-
* n W, g- s }$ f0 f4 b+ w4 d - if(temp == 0x7FC00000)! f. K4 c, ]; z5 F' P) O% l
- {* c n0 Z* `) K8 o
- return(0);9 x& W/ i# h! g& V
- }) C) ^5 \) y. W4 a3 p' _3 j) T
- $ x* f( B2 \! S
- /* Checking for a NAN value in pTest array */! x Q4 q) K7 ?+ a: X$ f. ?8 W
- test = (int *)(&pTest[i]);
! T! |; K8 k! K+ R - temp = *test;4 a( B9 k+ A: r8 v6 k
- 0 @8 ~, h: z2 p- e" b
- if(temp == 0x7FC00000). Z# R, ]; h& K6 O8 T; d/ G& [
- {6 j3 ]' F( ~+ \( F. h. ~' b
- return(0);6 y5 G o# S1 y4 a" T, T6 [. Q
- }
8 Y0 F. ?/ W+ k! N4 ?, J - EnergySignal += pRef[i] * pRef[i];
+ m' W2 ~9 P! _6 `. n! c3 B# C - EnergyError += (pRef[i] - pTest[i]) * (pRef[i] - pTest[i]); ( X3 T* ?; c' J- R, Y
- }7 J N* W: e2 x; x: j/ n5 B1 t
-
7 B; ]; a5 ^# x8 F, ~" b - /* Checking for a NAN value in EnergyError */( I( G& ]/ B9 A; m* D, r
- test = (int *)(&EnergyError);3 G7 S$ o2 ]: h0 P; e
- temp = *test;9 H6 \! u' z$ a+ K! B4 m- I \& e( }
-
' X8 y$ B* n- c1 _) `* W - if(temp == 0x7FC00000)3 ^" \- K0 b! M# F+ }( [; T% i
- {
4 _: b8 w0 d; I8 X8 P( ? - return(0);
8 _- u: @7 m/ z/ `" Q2 \ - }/ J$ f1 ^% }9 h% Z
-
; l; ?( F3 S9 v; V; g; k - SNR = 10 * log10 (EnergySignal / EnergyError); (2)9 f; W: G$ h' a9 d/ T
- 2 s4 w* V! T( L
- return (SNR);2 `3 F& }: {5 w p. j
- * D; K5 S% o6 ]
- }
复制代码1. 这里先补充一些信噪比方面的基础知识: 信噪比,即SNR(Signal to Noise Ratio),又称为讯噪比。反映摄像机成像的抗干扰能力,反应在画质上就是画面是否干净无噪点;狭义来讲是指 放大器的输出 信号的功率与同时输出的 噪声功率的比,常常用分贝数表示,设备的信噪比越高表明它产生的杂音越少。一般来说,信噪比越大,说明混在 信号里的噪声越小,声音回放的音质量越高,否则相反。信噪比一般不应该低于70dB,高保真 音箱的信噪比应达到110dB以上。公式如下:
- Y7 H& ?9 e6 e! m3 r$ S 关于信噪比更详细的知识,大家可以查阅相关资料进行了解。 2. 这里实现的就是上面所说的信噪比公式。 5 c6 m% L2 Y2 E* d
22.1.3 arm_float_to_q12_20- /**
1 x9 k4 v' N2 o- g% Q+ ^" X' X( d - * @brief Converts float to fixed in q12.20 format (1)
% L( Q5 r, Y/ p5 J, r! ` - * @param uint32_t number of samples in the buffer
' B, a7 F) X: ?2 O' o - * @return none' R3 f( k1 I7 o3 {- A# `* V" u
- * The function converts floating point values to fixed point(q12.20) values
6 ?! @% E, T U% r7 T' g: u - */. e! Z5 G: @, | h
-
- q& k" m( K$ f) u7 L - void arm_float_to_q12_20(float *pIn, q31_t * pOut, uint32_t numSamples)4 z" i! r& _" B3 l, v3 y0 a
- {
& p' a* w: _0 i+ G8 K) i - uint32_t i;+ V0 T7 J/ x8 ~) ^
- * A7 X8 ^. V0 S1 K3 U' c3 u6 f# ]
- for (i = 0; i < numSamples; i++) z; t. Q# z& N
- {
+ i! u# j% D, h# M6 F) j - /* 1048576.0f corresponds to pow(2, 20) */7 I7 O3 M* ~5 s r& k2 n
- pOut[i] = (q31_t) (pIn[i] * 1048576.0f); (2)& p& V( Y. l# n
- * }( F2 z/ H9 @# @- y+ |5 b/ _
- pOut[i] += pIn[i] > 0 ? 0.5 : -0.5;
_0 [; v7 |4 c# o4 [+ O ~ -
/ O/ V9 B* D5 q# p/ F: _ - if (pIn[i] == (float) 1.0)0 v& {4 N: Z. I3 W: ^( P
- {
~2 o0 ?" L9 V) R8 v - pOut[i] = 0x000FFFFF;1 D, ]! S3 b7 Y7 C( l# N, ?$ \
- }
/ G0 c, c& G0 d6 y! N4 S - }4 {& L0 D& y. t& `5 s) H
- }
复制代码1. 这个函数用于将浮点数转换成Q12.20格式的数据。 2. 浮点数转换成Q12.20格式需要乘以2^20,然后再做舍入处理,特别注意这里的浮点数末尾要加符号f,这样才能保证是单精度。
) C5 [( N9 [2 T) e; V* a& m9 D22.1.4 arm_provide_guard_bits_q15- /** ( ?9 w5 ~* p1 U7 M
- * @brief Provide guard bits for Input buffer `3 H' X" M. ]& L( r. g- F: A/ Z
- * @param q15_t* Pointer to input buffer6 y) {; t! G4 }8 y& {
- * @param uint32_t blockSize
1 z9 _. n. I$ L) h0 u - * @param uint32_t guard_bits7 B1 W- L( H6 C: Y" b9 G6 P
- * @return none! A. W3 J. w! h+ i* I
- * The function Provides the guard bits for the buffer
4 o+ e1 b# c |+ }3 W/ u/ H* K - * to avoid overflow 2 I# c# F1 ?2 ~# }/ m5 s
- */- h' E9 d) ?6 T2 U, \% l; ^; }/ q
-
4 N4 f4 [/ G5 v+ H9 M+ O; R1 A: s - void arm_provide_guard_bits_q15 (q15_t * input_buf, uint32_t blockSize,
4 T5 i2 s; }* [. {$ L. O7 T - uint32_t guard_bits)
# G1 r x: t/ x/ P1 h( s9 a - {% l+ ?* x% ^ g; _/ Y! j7 C
- uint32_t i;
" P( I# W. z* S5 |% h+ R' `- s - 4 k9 D D/ b4 o. |- y0 T9 Q
- for (i = 0; i < blockSize; i++)
" q8 Q! w5 q) |$ Q( Y# K% M! T# r - {9 n. @+ w0 Q. T$ X* A
- input_buf[i] = input_buf[i] >> guard_bits;
5 R4 B( d' }( y - }$ |1 J. |; G/ c
- }
复制代码1. 这个函数用于给q15_t类型的数据提供保护位,防止溢出。从函数的实现上看,保护位的实现是通过右移数据实现的。
7 U+ s. g; H# _& C; i! }: r( J+ z22.1.5 arm_provide_guard_bits_q31- /**
. z6 }+ k# \* C2 |4 E/ J6 z7 H# s. I - * @brief Provide guard bits for Input buffer" `: D% H9 i- N& N
- * @param q31_t* Pointer to input buffer$ I! q3 n" \: _2 U
- * @param uint32_t blockSize
+ c3 \: t; `7 |/ q+ { - * @param uint32_t guard_bits
; ]1 F) c0 C3 h% M - * @return none
4 |8 F4 _+ }" ^, v! {. q% B - * The function Provides the guard bits for the buffer 3 u8 T! s; |* Q& u t2 {1 ]# o
- * to avoid overflow
/ U+ v: x) w0 b1 p6 f8 q" ? - */9 v( O2 `: Y R" ]$ {% W' ?* h
-
0 K3 J7 i+ l* B7 _* p% V, b4 D - void arm_provide_guard_bits_q31 (q31_t * input_buf,
; M( G8 a; c/ Z - uint32_t blockSize,( @0 i! w H0 g
- uint32_t guard_bits)
; m+ F c. `9 A: h1 ^/ C" C$ a' n - {
~# r3 J8 F3 A% G- i - uint32_t i;
% n: }: }9 S9 h" F1 \ - 3 J* J4 S1 l! O
- for (i = 0; i < blockSize; i++)* d$ k: v1 S% n. e; ^, `, G7 l
- {# e2 g& W2 T* S h9 l3 M
- input_buf[i] = input_buf[i] >> guard_bits;
; o, g) q: U& f# K' ` - }0 b ?, X" @/ h8 p! @8 k
- }
复制代码1. 这个函数用于给q31_t类型的数据提供保护位,防止溢出。从函数的实现上看,保护位的实现是通过右移数据实现的。 8 z: {0 f. i9 f- f- {4 a
22.1.6 arm_float_to_q14- /** ! W8 k/ `6 B$ C& t' S6 z% g B
- * @brief Converts float to fixed q14 % Z& @" u" d! c, N, j
- * @param uint32_t number of samples in the buffer7 _ V9 W- Y9 Q3 f" L+ d' G# q0 w- Q$ J- N
- * @return none0 ]" b6 C8 R0 P4 x
- * The function converts floating point values to fixed point values 4 C& X- P* z9 p( x6 f: {- _7 [
- */- q" q8 O, M+ d/ U: H
- , l/ n6 O# s! @2 k8 m* m" P
- void arm_float_to_q14 (float *pIn, q15_t * pOut, 7 ?4 k% R" J+ V; j5 s
- uint32_t numSamples)
# F4 x& i/ }8 L, m' _( I0 K( }' P - {. i% T& K8 l, J+ D1 w/ V0 ~
- uint32_t i;; ^- b( _0 q1 o' ?+ v8 l& |
- : T$ b6 }, i8 t6 H0 {- ?# C- b
- for (i = 0; i < numSamples; i++)
% O% K* T7 M4 o+ n! F6 x# ~ - { ]& z8 Q4 P: d# I1 j& B
- /* 16384.0f corresponds to pow(2, 14) */2 c; F/ V/ x m0 O5 B
- pOut[i] = (q15_t) (pIn[i] * 16384.0f);7 p) u' f* k6 h; s: o: R5 w0 n
- & q$ w7 n+ O f' C) v
- pOut[i] += pIn[i] > 0 ? 0.5 : -0.5;
. u6 X' n: {; ? [: b6 s - 0 u1 w ]5 y3 x3 }& k# M: ~
- if (pIn[i] == (float) 2.0)+ L: F2 u+ l6 f6 h1 ]
- {
7 S" d) q6 U4 n - pOut[i] = 0x7FFF;2 b1 i0 @* C! Q7 N0 `' [+ P9 W
- }
+ t, @9 |7 Q; Z& W2 e% K! F - 2 ^* K+ g; E' Y! W" |: z1 s: n: ~
- }$ n, b6 z5 |* V3 [' u& `: J
-
2 S8 E9 s' F7 t! S5 e - }
复制代码1. 这个函数用于将浮点数转换成Q14格式的数据。 2. 浮点数转换成Q14格式需要乘以2^14,然后再做舍入处理,特别注意这里的浮点数末尾要加符号f,这样才能保证是单精度。
* D+ H+ J1 I# C. o" V- b- m |
22.1.8 arm_calc_guard_bits
22.1.9 arm_apply_guard_bits
22.1.10 arm_calc_2pow
22.1.11 arm_compare_fixed_q15
22.1.12 arm_compare_fixed_q15
22.2 总结