From 8d64016cd5fdbe019cad3501de961acd10767e46 Mon Sep 17 00:00:00 2001 From: Jake Carter Date: Tue, 10 Sep 2024 16:45:11 -0600 Subject: [PATCH 1/3] Update CMSIS-DSP to v1.16.2 --- .../5.9.0/DSP/Include/arm_common_tables.h | 812 ++----- .../5.9.0/DSP/Include/arm_common_tables_f16.h | 135 +- .../5.9.0/DSP/Include/arm_const_structs.h | 84 +- .../5.9.0/DSP/Include/arm_const_structs_f16.h | 56 +- .../5.9.0/DSP/Include/arm_helium_utils.h | 366 +-- Libraries/CMSIS/5.9.0/DSP/Include/arm_math.h | 166 +- .../CMSIS/5.9.0/DSP/Include/arm_math_f16.h | 13 +- .../CMSIS/5.9.0/DSP/Include/arm_math_memory.h | 130 +- .../CMSIS/5.9.0/DSP/Include/arm_math_types.h | 660 ++--- .../5.9.0/DSP/Include/arm_math_types_f16.h | 101 +- .../CMSIS/5.9.0/DSP/Include/arm_mve_tables.h | 257 +- .../5.9.0/DSP/Include/arm_mve_tables_f16.h | 95 +- .../CMSIS/5.9.0/DSP/Include/arm_vec_math.h | 159 +- .../5.9.0/DSP/Include/arm_vec_math_f16.h | 128 +- .../DSP/Include/dsp/basic_math_functions.h | 545 +++-- .../Include/dsp/basic_math_functions_f16.h | 95 +- .../5.9.0/DSP/Include/dsp/bayes_functions.h | 35 +- .../DSP/Include/dsp/bayes_functions_f16.h | 36 +- .../DSP/Include/dsp/complex_math_functions.h | 204 +- .../Include/dsp/complex_math_functions_f16.h | 61 +- .../DSP/Include/dsp/controller_functions.h | 472 ++-- .../Include/dsp/controller_functions_f16.h | 12 +- Libraries/CMSIS/5.9.0/DSP/Include/dsp/debug.h | 146 ++ .../DSP/Include/dsp/distance_functions.h | 108 +- .../DSP/Include/dsp/distance_functions_f16.h | 49 +- .../DSP/Include/dsp/fast_math_functions.h | 241 +- .../DSP/Include/dsp/fast_math_functions_f16.h | 55 +- .../DSP/Include/dsp/filtering_functions.h | 2134 +++++++++++------ .../DSP/Include/dsp/filtering_functions_f16.h | 195 +- .../DSP/Include/dsp/interpolation_functions.h | 221 +- .../Include/dsp/interpolation_functions_f16.h | 57 +- .../5.9.0/DSP/Include/dsp/matrix_functions.h | 549 +++-- .../DSP/Include/dsp/matrix_functions_f16.h | 173 +- .../5.9.0/DSP/Include/dsp/matrix_utils.h | 1085 +++++---- Libraries/CMSIS/5.9.0/DSP/Include/dsp/none.h | 581 +++-- .../Include/dsp/quaternion_math_functions.h | 68 +- .../DSP/Include/dsp/statistics_functions.h | 587 +++-- .../Include/dsp/statistics_functions_f16.h | 146 +- .../5.9.0/DSP/Include/dsp/support_functions.h | 399 ++- .../DSP/Include/dsp/support_functions_f16.h | 94 +- .../CMSIS/5.9.0/DSP/Include/dsp/svm_defines.h | 16 +- .../5.9.0/DSP/Include/dsp/svm_functions.h | 192 +- .../5.9.0/DSP/Include/dsp/svm_functions_f16.h | 186 +- .../DSP/Include/dsp/transform_functions.h | 1314 +++++++--- .../DSP/Include/dsp/transform_functions_f16.h | 324 ++- Libraries/CMSIS/5.9.0/DSP/Include/dsp/utils.h | 172 +- .../5.9.0/DSP/Include/dsp/window_functions.h | 812 +++++++ .../5.9.0/DSP/Lib/libarm_cortexM4l_math.a | Bin 2029110 -> 1240768 bytes .../5.9.0/DSP/Lib/libarm_cortexM4lf_math.a | Bin 2004602 -> 1240676 bytes .../CMSIS/Device/Maxim/GCC/mxc_version.mk | 6 +- 50 files changed, 9097 insertions(+), 5435 deletions(-) mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/arm_helium_utils.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/arm_math_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/arm_math_memory.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions_f16.h create mode 100644 Libraries/CMSIS/5.9.0/DSP/Include/dsp/debug.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_utils.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/none.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/quaternion_math_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_defines.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions_f16.h mode change 100644 => 100755 Libraries/CMSIS/5.9.0/DSP/Include/dsp/utils.h create mode 100644 Libraries/CMSIS/5.9.0/DSP/Include/dsp/window_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables.h index 44b19ca71a1..6a9270437fb 100644 --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables.h @@ -26,605 +26,293 @@ * limitations under the License. */ -#ifndef _ARM_COMMON_TABLES_H -#define _ARM_COMMON_TABLES_H +#ifndef ARM_COMMON_TABLES_H +#define ARM_COMMON_TABLES_H #include "arm_math_types.h" #include "dsp/fast_math_functions.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FFT_ALLOW_TABLES) -/* Double Precision Float CFFT twiddles */ -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || defined(ARM_TABLE_BITREV_1024) -extern const uint16_t armBitRevTable[1024]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F64_16) -extern const uint64_t twiddleCoefF64_16[32]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F64_32) -extern const uint64_t twiddleCoefF64_32[64]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F64_64) -extern const uint64_t twiddleCoefF64_64[128]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F64_128) -extern const uint64_t twiddleCoefF64_128[256]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F64_256) -extern const uint64_t twiddleCoefF64_256[512]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F64_512) -extern const uint64_t twiddleCoefF64_512[1024]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F64_1024) -extern const uint64_t twiddleCoefF64_1024[2048]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F64_2048) -extern const uint64_t twiddleCoefF64_2048[4096]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F64_4096) -extern const uint64_t twiddleCoefF64_4096[8192]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_16) -extern const float32_t twiddleCoef_16[32]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_32) -extern const float32_t twiddleCoef_32[64]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_64) -extern const float32_t twiddleCoef_64[128]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_128) -extern const float32_t twiddleCoef_128[256]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_256) -extern const float32_t twiddleCoef_256[512]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_512) -extern const float32_t twiddleCoef_512[1024]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_1024) -extern const float32_t twiddleCoef_1024[2048]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_2048) -extern const float32_t twiddleCoef_2048[4096]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_4096) -extern const float32_t twiddleCoef_4096[8192]; -#define twiddleCoef twiddleCoef_4096 -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -/* Q31 */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_16) -extern const q31_t twiddleCoef_16_q31[24]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_32) -extern const q31_t twiddleCoef_32_q31[48]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_64) -extern const q31_t twiddleCoef_64_q31[96]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_128) -extern const q31_t twiddleCoef_128_q31[192]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_256) -extern const q31_t twiddleCoef_256_q31[384]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_512) -extern const q31_t twiddleCoef_512_q31[768]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_1024) -extern const q31_t twiddleCoef_1024_q31[1536]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_2048) -extern const q31_t twiddleCoef_2048_q31[3072]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_4096) -extern const q31_t twiddleCoef_4096_q31[6144]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_16) -extern const q15_t twiddleCoef_16_q15[24]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_32) -extern const q15_t twiddleCoef_32_q15[48]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_64) -extern const q15_t twiddleCoef_64_q15[96]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_128) -extern const q15_t twiddleCoef_128_q15[192]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_256) -extern const q15_t twiddleCoef_256_q15[384]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_512) -extern const q15_t twiddleCoef_512_q15[768]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_1024) -extern const q15_t twiddleCoef_1024_q15[1536]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_2048) -extern const q15_t twiddleCoef_2048_q15[3072]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_4096) -extern const q15_t twiddleCoef_4096_q15[6144]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -/* Double Precision Float RFFT twiddles */ -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F64_32) -extern const uint64_t twiddleCoefF64_rfft_32[32]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F64_64) -extern const uint64_t twiddleCoefF64_rfft_64[64]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F64_128) -extern const uint64_t twiddleCoefF64_rfft_128[128]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F64_256) -extern const uint64_t twiddleCoefF64_rfft_256[256]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F64_512) -extern const uint64_t twiddleCoefF64_rfft_512[512]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F64_1024) -extern const uint64_t twiddleCoefF64_rfft_1024[1024]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F64_2048) -extern const uint64_t twiddleCoefF64_rfft_2048[2048]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F64_4096) -extern const uint64_t twiddleCoefF64_rfft_4096[4096]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F32_32) -extern const float32_t twiddleCoef_rfft_32[32]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F32_64) -extern const float32_t twiddleCoef_rfft_64[64]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F32_128) -extern const float32_t twiddleCoef_rfft_128[128]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F32_256) -extern const float32_t twiddleCoef_rfft_256[256]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F32_512) -extern const float32_t twiddleCoef_rfft_512[512]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F32_1024) -extern const float32_t twiddleCoef_rfft_1024[1024]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F32_2048) -extern const float32_t twiddleCoef_rfft_2048[2048]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F32_4096) -extern const float32_t twiddleCoef_rfft_4096[4096]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -/* Double precision floating-point bit reversal tables */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT64_16) -#define ARMBITREVINDEXTABLEF64_16_TABLE_LENGTH ((uint16_t)12) -extern const uint16_t armBitRevIndexTableF64_16[ARMBITREVINDEXTABLEF64_16_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT64_32) -#define ARMBITREVINDEXTABLEF64_32_TABLE_LENGTH ((uint16_t)24) -extern const uint16_t armBitRevIndexTableF64_32[ARMBITREVINDEXTABLEF64_32_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT64_64) -#define ARMBITREVINDEXTABLEF64_64_TABLE_LENGTH ((uint16_t)56) -extern const uint16_t armBitRevIndexTableF64_64[ARMBITREVINDEXTABLEF64_64_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT64_128) -#define ARMBITREVINDEXTABLEF64_128_TABLE_LENGTH ((uint16_t)112) -extern const uint16_t armBitRevIndexTableF64_128[ARMBITREVINDEXTABLEF64_128_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT64_256) -#define ARMBITREVINDEXTABLEF64_256_TABLE_LENGTH ((uint16_t)240) -extern const uint16_t armBitRevIndexTableF64_256[ARMBITREVINDEXTABLEF64_256_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT64_512) -#define ARMBITREVINDEXTABLEF64_512_TABLE_LENGTH ((uint16_t)480) -extern const uint16_t armBitRevIndexTableF64_512[ARMBITREVINDEXTABLEF64_512_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT64_1024) -#define ARMBITREVINDEXTABLEF64_1024_TABLE_LENGTH ((uint16_t)992) -extern const uint16_t armBitRevIndexTableF64_1024[ARMBITREVINDEXTABLEF64_1024_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT64_2048) -#define ARMBITREVINDEXTABLEF64_2048_TABLE_LENGTH ((uint16_t)1984) -extern const uint16_t armBitRevIndexTableF64_2048[ARMBITREVINDEXTABLEF64_2048_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT64_4096) -#define ARMBITREVINDEXTABLEF64_4096_TABLE_LENGTH ((uint16_t)4032) -extern const uint16_t armBitRevIndexTableF64_4096[ARMBITREVINDEXTABLEF64_4096_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ -/* floating-point bit reversal tables */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT_16) -#define ARMBITREVINDEXTABLE_16_TABLE_LENGTH ((uint16_t)20) -extern const uint16_t armBitRevIndexTable16[ARMBITREVINDEXTABLE_16_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT_32) -#define ARMBITREVINDEXTABLE_32_TABLE_LENGTH ((uint16_t)48) -extern const uint16_t armBitRevIndexTable32[ARMBITREVINDEXTABLE_32_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT_64) -#define ARMBITREVINDEXTABLE_64_TABLE_LENGTH ((uint16_t)56) -extern const uint16_t armBitRevIndexTable64[ARMBITREVINDEXTABLE_64_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT_128) -#define ARMBITREVINDEXTABLE_128_TABLE_LENGTH ((uint16_t)208) -extern const uint16_t armBitRevIndexTable128[ARMBITREVINDEXTABLE_128_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT_256) -#define ARMBITREVINDEXTABLE_256_TABLE_LENGTH ((uint16_t)440) -extern const uint16_t armBitRevIndexTable256[ARMBITREVINDEXTABLE_256_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT_512) -#define ARMBITREVINDEXTABLE_512_TABLE_LENGTH ((uint16_t)448) -extern const uint16_t armBitRevIndexTable512[ARMBITREVINDEXTABLE_512_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT_1024) -#define ARMBITREVINDEXTABLE_1024_TABLE_LENGTH ((uint16_t)1800) -extern const uint16_t armBitRevIndexTable1024[ARMBITREVINDEXTABLE_1024_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT_2048) -#define ARMBITREVINDEXTABLE_2048_TABLE_LENGTH ((uint16_t)3808) -extern const uint16_t armBitRevIndexTable2048[ARMBITREVINDEXTABLE_2048_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FLT_4096) -#define ARMBITREVINDEXTABLE_4096_TABLE_LENGTH ((uint16_t)4032) -extern const uint16_t armBitRevIndexTable4096[ARMBITREVINDEXTABLE_4096_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -/* fixed-point bit reversal tables */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FXT_16) -#define ARMBITREVINDEXTABLE_FIXED_16_TABLE_LENGTH ((uint16_t)12) -extern const uint16_t armBitRevIndexTable_fixed_16[ARMBITREVINDEXTABLE_FIXED_16_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FXT_32) -#define ARMBITREVINDEXTABLE_FIXED_32_TABLE_LENGTH ((uint16_t)24) -extern const uint16_t armBitRevIndexTable_fixed_32[ARMBITREVINDEXTABLE_FIXED_32_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FXT_64) -#define ARMBITREVINDEXTABLE_FIXED_64_TABLE_LENGTH ((uint16_t)56) -extern const uint16_t armBitRevIndexTable_fixed_64[ARMBITREVINDEXTABLE_FIXED_64_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FXT_128) -#define ARMBITREVINDEXTABLE_FIXED_128_TABLE_LENGTH ((uint16_t)112) -extern const uint16_t armBitRevIndexTable_fixed_128[ARMBITREVINDEXTABLE_FIXED_128_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FXT_256) -#define ARMBITREVINDEXTABLE_FIXED_256_TABLE_LENGTH ((uint16_t)240) -extern const uint16_t armBitRevIndexTable_fixed_256[ARMBITREVINDEXTABLE_FIXED_256_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FXT_512) -#define ARMBITREVINDEXTABLE_FIXED_512_TABLE_LENGTH ((uint16_t)480) -extern const uint16_t armBitRevIndexTable_fixed_512[ARMBITREVINDEXTABLE_FIXED_512_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FXT_1024) -#define ARMBITREVINDEXTABLE_FIXED_1024_TABLE_LENGTH ((uint16_t)992) -extern const uint16_t armBitRevIndexTable_fixed_1024[ARMBITREVINDEXTABLE_FIXED_1024_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FXT_2048) -#define ARMBITREVINDEXTABLE_FIXED_2048_TABLE_LENGTH ((uint16_t)1984) -extern const uint16_t armBitRevIndexTable_fixed_2048[ARMBITREVINDEXTABLE_FIXED_2048_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_BITREVIDX_FXT_4096) -#define ARMBITREVINDEXTABLE_FIXED_4096_TABLE_LENGTH ((uint16_t)4032) -extern const uint16_t armBitRevIndexTable_fixed_4096[ARMBITREVINDEXTABLE_FIXED_4096_TABLE_LENGTH]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_REALCOEF_F32) -extern const float32_t realCoefA[8192]; -extern const float32_t realCoefB[8192]; -#endif + /* Double Precision Float CFFT twiddles */ + extern const uint16_t armBitRevTable[1024]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_REALCOEF_Q31) -extern const q31_t realCoefAQ31[8192]; -extern const q31_t realCoefBQ31[8192]; -#endif + extern const uint64_t twiddleCoefF64_16[32]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_REALCOEF_Q15) -extern const q15_t realCoefAQ15[8192]; -extern const q15_t realCoefBQ15[8192]; -#endif + extern const uint64_t twiddleCoefF64_32[64]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_DCT4_F32_128) -extern const float32_t Weights_128[256]; -extern const float32_t cos_factors_128[128]; -#endif + extern const uint64_t twiddleCoefF64_64[128]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_DCT4_F32_512) -extern const float32_t Weights_512[1024]; -extern const float32_t cos_factors_512[512]; -#endif + extern const uint64_t twiddleCoefF64_128[256]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_DCT4_F32_2048) -extern const float32_t Weights_2048[4096]; -extern const float32_t cos_factors_2048[2048]; -#endif + extern const uint64_t twiddleCoefF64_256[512]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_DCT4_F32_8192) -extern const float32_t Weights_8192[16384]; -extern const float32_t cos_factors_8192[8192]; -#endif + extern const uint64_t twiddleCoefF64_512[1024]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_DCT4_Q15_128) -extern const q15_t WeightsQ15_128[256]; -extern const q15_t cos_factorsQ15_128[128]; -#endif + extern const uint64_t twiddleCoefF64_1024[2048]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_DCT4_Q15_512) -extern const q15_t WeightsQ15_512[1024]; -extern const q15_t cos_factorsQ15_512[512]; -#endif + extern const uint64_t twiddleCoefF64_2048[4096]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_DCT4_Q15_2048) -extern const q15_t WeightsQ15_2048[4096]; -extern const q15_t cos_factorsQ15_2048[2048]; -#endif + extern const uint64_t twiddleCoefF64_4096[8192]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_DCT4_Q15_8192) -extern const q15_t WeightsQ15_8192[16384]; -extern const q15_t cos_factorsQ15_8192[8192]; -#endif + extern const float32_t twiddleCoef_16[32]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_DCT4_Q31_128) -extern const q31_t WeightsQ31_128[256]; -extern const q31_t cos_factorsQ31_128[128]; -#endif + extern const float32_t twiddleCoef_32[64]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_DCT4_Q31_512) -extern const q31_t WeightsQ31_512[1024]; -extern const q31_t cos_factorsQ31_512[512]; -#endif + extern const float32_t twiddleCoef_64[128]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_DCT4_Q31_2048) -extern const q31_t WeightsQ31_2048[4096]; -extern const q31_t cos_factorsQ31_2048[2048]; -#endif + extern const float32_t twiddleCoef_128[256]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_DCT4_Q31_8192) -extern const q31_t WeightsQ31_8192[16384]; -extern const q31_t cos_factorsQ31_8192[8192]; -#endif + extern const float32_t twiddleCoef_256[512]; -#endif /* if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FFT_TABLES) */ + extern const float32_t twiddleCoef_512[1024]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FAST_ALLOW_TABLES) + extern const float32_t twiddleCoef_1024[2048]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FAST_TABLES) || defined(ARM_TABLE_RECIP_Q15) -extern const q15_t armRecipTableQ15[64]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) defined(ARM_ALL_FAST_TABLES) */ + extern const float32_t twiddleCoef_2048[4096]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FAST_TABLES) || defined(ARM_TABLE_RECIP_Q31) -extern const q31_t armRecipTableQ31[64]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) defined(ARM_ALL_FAST_TABLES) */ + extern const float32_t twiddleCoef_4096[8192]; + #define twiddleCoef twiddleCoef_4096 -/* Tables for Fast Math Sine and Cosine */ -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FAST_TABLES) || defined(ARM_TABLE_SIN_F32) -extern const float32_t sinTable_f32[FAST_MATH_TABLE_SIZE + 1]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) defined(ARM_ALL_FAST_TABLES) */ + /* Q31 */ -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FAST_TABLES) || defined(ARM_TABLE_SIN_Q31) -extern const q31_t sinTable_q31[FAST_MATH_TABLE_SIZE + 1]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) defined(ARM_ALL_FAST_TABLES) */ + extern const q31_t twiddleCoef_16_q31[24]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FAST_TABLES) || defined(ARM_TABLE_SIN_Q15) -extern const q15_t sinTable_q15[FAST_MATH_TABLE_SIZE + 1]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) defined(ARM_ALL_FAST_TABLES) */ + extern const q31_t twiddleCoef_32_q31[48]; -/* Fast vector sqrt */ -#if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE) -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FAST_TABLES) || \ - defined(ARM_TABLE_FAST_SQRT_Q31_MVE) -extern const q31_t sqrtTable_Q31[256]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) defined(ARM_ALL_FAST_TABLES) */ -#endif + extern const q31_t twiddleCoef_64_q31[96]; -/* Accurate scalar sqrt */ -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FAST_TABLES) || defined(ARM_TABLE_SQRT_Q31) -extern const q31_t sqrt_initial_lut_q31[32]; -#endif + extern const q31_t twiddleCoef_128_q31[192]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FAST_TABLES) || defined(ARM_TABLE_SQRT_Q15) -extern const q15_t sqrt_initial_lut_q15[16]; -#endif + extern const q31_t twiddleCoef_256_q31[384]; -#if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE) -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FAST_TABLES) || \ - defined(ARM_TABLE_FAST_SQRT_Q15_MVE) -extern const q15_t sqrtTable_Q15[256]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) defined(ARM_ALL_FAST_TABLES) */ -#endif + extern const q31_t twiddleCoef_512_q31[768]; -#endif /* if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FAST_TABLES) */ + extern const q31_t twiddleCoef_1024_q31[1536]; -#if (defined(ARM_MATH_MVEF) || defined(ARM_MATH_HELIUM)) && !defined(ARM_MATH_AUTOVECTORIZE) -extern const float32_t exp_tab[8]; -extern const float32_t __logf_lut_f32[8]; -#endif /* (defined(ARM_MATH_MVEF) || defined(ARM_MATH_HELIUM)) && !defined(ARM_MATH_AUTOVECTORIZE) */ + extern const q31_t twiddleCoef_2048_q31[3072]; + + extern const q31_t twiddleCoef_4096_q31[6144]; + + extern const q15_t twiddleCoef_16_q15[24]; + + extern const q15_t twiddleCoef_32_q15[48]; + + extern const q15_t twiddleCoef_64_q15[96]; + + extern const q15_t twiddleCoef_128_q15[192]; + + extern const q15_t twiddleCoef_256_q15[384]; + + extern const q15_t twiddleCoef_512_q15[768]; + + extern const q15_t twiddleCoef_1024_q15[1536]; + + extern const q15_t twiddleCoef_2048_q15[3072]; + + extern const q15_t twiddleCoef_4096_q15[6144]; + + /* Double Precision Float RFFT twiddles */ + extern const uint64_t twiddleCoefF64_rfft_32[32]; + + extern const uint64_t twiddleCoefF64_rfft_64[64]; + + extern const uint64_t twiddleCoefF64_rfft_128[128]; + + extern const uint64_t twiddleCoefF64_rfft_256[256]; + + extern const uint64_t twiddleCoefF64_rfft_512[512]; + + extern const uint64_t twiddleCoefF64_rfft_1024[1024]; + + extern const uint64_t twiddleCoefF64_rfft_2048[2048]; + + extern const uint64_t twiddleCoefF64_rfft_4096[4096]; + + extern const float32_t twiddleCoef_rfft_32[32]; + + extern const float32_t twiddleCoef_rfft_64[64]; + + extern const float32_t twiddleCoef_rfft_128[128]; + + extern const float32_t twiddleCoef_rfft_256[256]; + + extern const float32_t twiddleCoef_rfft_512[512]; + + extern const float32_t twiddleCoef_rfft_1024[1024]; + + extern const float32_t twiddleCoef_rfft_2048[2048]; + + extern const float32_t twiddleCoef_rfft_4096[4096]; + + /* Double precision floating-point bit reversal tables */ + + #define ARMBITREVINDEXTABLEF64_16_TABLE_LENGTH ((uint16_t)12) + extern const uint16_t armBitRevIndexTableF64_16[ARMBITREVINDEXTABLEF64_16_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLEF64_32_TABLE_LENGTH ((uint16_t)24) + extern const uint16_t armBitRevIndexTableF64_32[ARMBITREVINDEXTABLEF64_32_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLEF64_64_TABLE_LENGTH ((uint16_t)56) + extern const uint16_t armBitRevIndexTableF64_64[ARMBITREVINDEXTABLEF64_64_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLEF64_128_TABLE_LENGTH ((uint16_t)112) + extern const uint16_t armBitRevIndexTableF64_128[ARMBITREVINDEXTABLEF64_128_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLEF64_256_TABLE_LENGTH ((uint16_t)240) + extern const uint16_t armBitRevIndexTableF64_256[ARMBITREVINDEXTABLEF64_256_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLEF64_512_TABLE_LENGTH ((uint16_t)480) + extern const uint16_t armBitRevIndexTableF64_512[ARMBITREVINDEXTABLEF64_512_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLEF64_1024_TABLE_LENGTH ((uint16_t)992) + extern const uint16_t armBitRevIndexTableF64_1024[ARMBITREVINDEXTABLEF64_1024_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLEF64_2048_TABLE_LENGTH ((uint16_t)1984) + extern const uint16_t armBitRevIndexTableF64_2048[ARMBITREVINDEXTABLEF64_2048_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLEF64_4096_TABLE_LENGTH ((uint16_t)4032) + extern const uint16_t armBitRevIndexTableF64_4096[ARMBITREVINDEXTABLEF64_4096_TABLE_LENGTH]; + /* floating-point bit reversal tables */ + + #define ARMBITREVINDEXTABLE_16_TABLE_LENGTH ((uint16_t)20) + extern const uint16_t armBitRevIndexTable16[ARMBITREVINDEXTABLE_16_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_32_TABLE_LENGTH ((uint16_t)48) + extern const uint16_t armBitRevIndexTable32[ARMBITREVINDEXTABLE_32_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_64_TABLE_LENGTH ((uint16_t)56) + extern const uint16_t armBitRevIndexTable64[ARMBITREVINDEXTABLE_64_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_128_TABLE_LENGTH ((uint16_t)208) + extern const uint16_t armBitRevIndexTable128[ARMBITREVINDEXTABLE_128_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_256_TABLE_LENGTH ((uint16_t)440) + extern const uint16_t armBitRevIndexTable256[ARMBITREVINDEXTABLE_256_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_512_TABLE_LENGTH ((uint16_t)448) + extern const uint16_t armBitRevIndexTable512[ARMBITREVINDEXTABLE_512_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_1024_TABLE_LENGTH ((uint16_t)1800) + extern const uint16_t armBitRevIndexTable1024[ARMBITREVINDEXTABLE_1024_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_2048_TABLE_LENGTH ((uint16_t)3808) + extern const uint16_t armBitRevIndexTable2048[ARMBITREVINDEXTABLE_2048_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_4096_TABLE_LENGTH ((uint16_t)4032) + extern const uint16_t armBitRevIndexTable4096[ARMBITREVINDEXTABLE_4096_TABLE_LENGTH]; + + + /* fixed-point bit reversal tables */ + + #define ARMBITREVINDEXTABLE_FIXED_16_TABLE_LENGTH ((uint16_t)12) + extern const uint16_t armBitRevIndexTable_fixed_16[ARMBITREVINDEXTABLE_FIXED_16_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_FIXED_32_TABLE_LENGTH ((uint16_t)24) + extern const uint16_t armBitRevIndexTable_fixed_32[ARMBITREVINDEXTABLE_FIXED_32_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_FIXED_64_TABLE_LENGTH ((uint16_t)56) + extern const uint16_t armBitRevIndexTable_fixed_64[ARMBITREVINDEXTABLE_FIXED_64_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_FIXED_128_TABLE_LENGTH ((uint16_t)112) + extern const uint16_t armBitRevIndexTable_fixed_128[ARMBITREVINDEXTABLE_FIXED_128_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_FIXED_256_TABLE_LENGTH ((uint16_t)240) + extern const uint16_t armBitRevIndexTable_fixed_256[ARMBITREVINDEXTABLE_FIXED_256_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_FIXED_512_TABLE_LENGTH ((uint16_t)480) + extern const uint16_t armBitRevIndexTable_fixed_512[ARMBITREVINDEXTABLE_FIXED_512_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_FIXED_1024_TABLE_LENGTH ((uint16_t)992) + extern const uint16_t armBitRevIndexTable_fixed_1024[ARMBITREVINDEXTABLE_FIXED_1024_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_FIXED_2048_TABLE_LENGTH ((uint16_t)1984) + extern const uint16_t armBitRevIndexTable_fixed_2048[ARMBITREVINDEXTABLE_FIXED_2048_TABLE_LENGTH]; + + #define ARMBITREVINDEXTABLE_FIXED_4096_TABLE_LENGTH ((uint16_t)4032) + extern const uint16_t armBitRevIndexTable_fixed_4096[ARMBITREVINDEXTABLE_FIXED_4096_TABLE_LENGTH]; + + extern const float32_t realCoefA[8192]; + extern const float32_t realCoefB[8192]; + + extern const q31_t realCoefAQ31[8192]; + extern const q31_t realCoefBQ31[8192]; + + extern const q15_t realCoefAQ15[8192]; + extern const q15_t realCoefBQ15[8192]; + + extern const float32_t Weights_128[256]; + extern const float32_t cos_factors_128[128]; + + extern const float32_t Weights_512[1024]; + extern const float32_t cos_factors_512[512]; + + extern const float32_t Weights_2048[4096]; + extern const float32_t cos_factors_2048[2048]; + + extern const float32_t Weights_8192[16384]; + extern const float32_t cos_factors_8192[8192]; + + extern const q15_t WeightsQ15_128[256]; + extern const q15_t cos_factorsQ15_128[128]; + + extern const q15_t WeightsQ15_512[1024]; + extern const q15_t cos_factorsQ15_512[512]; + + extern const q15_t WeightsQ15_2048[4096]; + extern const q15_t cos_factorsQ15_2048[2048]; + + extern const q15_t WeightsQ15_8192[16384]; + extern const q15_t cos_factorsQ15_8192[8192]; + + extern const q31_t WeightsQ31_128[256]; + extern const q31_t cos_factorsQ31_128[128]; + + extern const q31_t WeightsQ31_512[1024]; + extern const q31_t cos_factorsQ31_512[512]; + + extern const q31_t WeightsQ31_2048[4096]; + extern const q31_t cos_factorsQ31_2048[2048]; + + extern const q31_t WeightsQ31_8192[16384]; + extern const q31_t cos_factorsQ31_8192[8192]; + + + extern const q15_t armRecipTableQ15[64]; + + extern const q31_t armRecipTableQ31[64]; + + /* Tables for Fast Math Sine and Cosine */ + extern const float32_t sinTable_f32[FAST_MATH_TABLE_SIZE + 1]; + + extern const q31_t sinTable_q31[FAST_MATH_TABLE_SIZE + 1]; + + extern const q15_t sinTable_q15[FAST_MATH_TABLE_SIZE + 1]; + + + /* Accurate scalar sqrt */ + extern const q31_t sqrt_initial_lut_q31[32]; + + extern const q15_t sqrt_initial_lut_q15[16]; #if (defined(ARM_MATH_MVEI) || defined(ARM_MATH_HELIUM)) && !defined(ARM_MATH_AUTOVECTORIZE) -extern const unsigned char hwLUT[256]; -#endif /* (defined(ARM_MATH_MVEI) || defined(ARM_MATH_HELIUM)) */ + extern const q15_t sqrtTable_Q15[256]; + extern const q31_t sqrtTable_Q31[256]; + extern const unsigned char hwLUT[256]; +#endif + +#if (defined(ARM_MATH_MVEF) || defined(ARM_MATH_HELIUM)) && !defined(ARM_MATH_AUTOVECTORIZE) + extern const float32_t exp_tab[8]; + extern const float32_t __logf_lut_f32[8]; +#endif + -#ifdef __cplusplus +#ifdef __cplusplus } #endif #endif /* ARM_COMMON_TABLES_H */ + diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables_f16.h old mode 100644 new mode 100755 index 7755fd4a3a1..c84a766adf6 --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables_f16.h @@ -26,119 +26,70 @@ * limitations under the License. */ -#ifndef _ARM_COMMON_TABLES_F16_H -#define _ARM_COMMON_TABLES_F16_H +#ifndef ARM_COMMON_TABLES_F16_H +#define ARM_COMMON_TABLES_F16_H #include "arm_math_types_f16.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FFT_ALLOW_TABLES) -/* F16 */ -#if !defined(__CC_ARM) && defined(ARM_FLOAT16_SUPPORTED) -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_16) -extern const float16_t twiddleCoefF16_16[32]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_32) -extern const float16_t twiddleCoefF16_32[64]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_64) -extern const float16_t twiddleCoefF16_64[128]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_128) -extern const float16_t twiddleCoefF16_128[256]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_256) -extern const float16_t twiddleCoefF16_256[512]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_512) -extern const float16_t twiddleCoefF16_512[1024]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_1024) -extern const float16_t twiddleCoefF16_1024[2048]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_2048) -extern const float16_t twiddleCoefF16_2048[4096]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_4096) -extern const float16_t twiddleCoefF16_4096[8192]; -#define twiddleCoefF16 twiddleCoefF16_4096 -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) */ - -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F16_32) -extern const float16_t twiddleCoefF16_rfft_32[32]; -#endif + /* F16 */ + #if !defined(__CC_ARM) && defined(ARM_FLOAT16_SUPPORTED) + extern const float16_t twiddleCoefF16_16[32]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F16_64) -extern const float16_t twiddleCoefF16_rfft_64[64]; -#endif + extern const float16_t twiddleCoefF16_32[64]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F16_128) -extern const float16_t twiddleCoefF16_rfft_128[128]; -#endif + extern const float16_t twiddleCoefF16_64[128]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F16_256) -extern const float16_t twiddleCoefF16_rfft_256[256]; -#endif + extern const float16_t twiddleCoefF16_128[256]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F16_512) -extern const float16_t twiddleCoefF16_rfft_512[512]; -#endif + extern const float16_t twiddleCoefF16_256[512]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F16_1024) -extern const float16_t twiddleCoefF16_rfft_1024[1024]; -#endif + extern const float16_t twiddleCoefF16_512[1024]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F16_2048) -extern const float16_t twiddleCoefF16_rfft_2048[2048]; -#endif + extern const float16_t twiddleCoefF16_1024[2048]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_RFFT_F16_4096) -extern const float16_t twiddleCoefF16_rfft_4096[4096]; -#endif + extern const float16_t twiddleCoefF16_2048[4096]; -#endif /* ARMAC5 */ + extern const float16_t twiddleCoefF16_4096[8192]; + #define twiddleCoefF16 twiddleCoefF16_4096 + + + extern const float16_t twiddleCoefF16_rfft_32[32]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FFT_ALLOW_TABLES) */ + extern const float16_t twiddleCoefF16_rfft_64[64]; -#if !defined(__CC_ARM) && defined(ARM_FLOAT16_SUPPORTED) + extern const float16_t twiddleCoefF16_rfft_128[128]; + + extern const float16_t twiddleCoefF16_rfft_256[256]; + + extern const float16_t twiddleCoefF16_rfft_512[512]; + + extern const float16_t twiddleCoefF16_rfft_1024[1024]; + + extern const float16_t twiddleCoefF16_rfft_2048[2048]; + extern const float16_t twiddleCoefF16_rfft_4096[4096]; + + #endif /* ARMAC5 */ + + +#if !defined(__CC_ARM) && defined(ARM_FLOAT16_SUPPORTED) #if (defined(ARM_MATH_MVEF) || defined(ARM_MATH_HELIUM)) && !defined(ARM_MATH_AUTOVECTORIZE) -extern const float16_t exp_tab_f16[8]; -extern const float16_t __logf_lut_f16[8]; -#endif /* (defined(ARM_MATH_MVEF) || defined(ARM_MATH_HELIUM)) && !defined(ARM_MATH_AUTOVECTORIZE) */ + extern const float16_t exp_tab_f16[8]; + extern const float16_t __logf_lut_f16[8]; #endif +#endif + -#ifdef __cplusplus +#ifdef __cplusplus } #endif #endif /* _ARM_COMMON_TABLES_F16_H */ + + diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs.h index 5f983f30798..32c1a436e67 100644 --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs.h @@ -27,58 +27,60 @@ * limitations under the License. */ -#ifndef _ARM_CONST_STRUCTS_H -#define _ARM_CONST_STRUCTS_H +#ifndef ARM_CONST_STRUCTS_H +#define ARM_CONST_STRUCTS_H #include "arm_math_types.h" #include "arm_common_tables.h" #include "dsp/transform_functions.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif -extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len16; -extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len32; -extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len64; -extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len128; -extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len256; -extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len512; -extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len1024; -extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len2048; -extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len4096; + extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len16; + extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len32; + extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len64; + extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len128; + extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len256; + extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len512; + extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len1024; + extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len2048; + extern const arm_cfft_instance_f64 arm_cfft_sR_f64_len4096; -extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len16; -extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len32; -extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len64; -extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len128; -extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len256; -extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len512; -extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len1024; -extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len2048; -extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len4096; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len16; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len32; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len64; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len128; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len256; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len512; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len1024; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len2048; + extern const arm_cfft_instance_f32 arm_cfft_sR_f32_len4096; -extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len16; -extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len32; -extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len64; -extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len128; -extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len256; -extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len512; -extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len1024; -extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len2048; -extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len4096; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len16; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len32; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len64; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len128; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len256; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len512; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len1024; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len2048; + extern const arm_cfft_instance_q31 arm_cfft_sR_q31_len4096; -extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len16; -extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len32; -extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len64; -extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len128; -extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len256; -extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len512; -extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len1024; -extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len2048; -extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len4096; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len16; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len32; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len64; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len128; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len256; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len512; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len1024; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len2048; + extern const arm_cfft_instance_q15 arm_cfft_sR_q15_len4096; -#ifdef __cplusplus +#ifdef __cplusplus } #endif #endif + diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs_f16.h old mode 100644 new mode 100755 index c7a7ffa740c..3a520b6b94f --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs_f16.h @@ -27,58 +27,32 @@ * limitations under the License. */ -#ifndef _ARM_CONST_STRUCTS_F16_H -#define _ARM_CONST_STRUCTS_F16_H +#ifndef ARM_CONST_STRUCTS_F16_H +#define ARM_CONST_STRUCTS_F16_H #include "arm_math_types_f16.h" #include "arm_common_tables.h" #include "arm_common_tables_f16.h" #include "dsp/transform_functions_f16.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #if !defined(__CC_ARM) && defined(ARM_FLOAT16_SUPPORTED) -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - (defined(ARM_TABLE_TWIDDLECOEF_F16_16) && defined(ARM_TABLE_BITREVIDX_FLT_16)) -extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len16; -#endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - (defined(ARM_TABLE_TWIDDLECOEF_F16_32) && defined(ARM_TABLE_BITREVIDX_FLT_32)) -extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len32; -#endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - (defined(ARM_TABLE_TWIDDLECOEF_F16_64) && defined(ARM_TABLE_BITREVIDX_FLT_64)) -extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len64; -#endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - (defined(ARM_TABLE_TWIDDLECOEF_F16_128) && defined(ARM_TABLE_BITREVIDX_FLT_128)) -extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len128; -#endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - (defined(ARM_TABLE_TWIDDLECOEF_F16_256) && defined(ARM_TABLE_BITREVIDX_FLT_256)) -extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len256; -#endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - (defined(ARM_TABLE_TWIDDLECOEF_F16_512) && defined(ARM_TABLE_BITREVIDX_FLT_512)) -extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len512; -#endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - (defined(ARM_TABLE_TWIDDLECOEF_F16_1024) && defined(ARM_TABLE_BITREVIDX_FLT_1024)) -extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len1024; -#endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - (defined(ARM_TABLE_TWIDDLECOEF_F16_2048) && defined(ARM_TABLE_BITREVIDX_FLT_2048)) -extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len2048; -#endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - (defined(ARM_TABLE_TWIDDLECOEF_F16_4096) && defined(ARM_TABLE_BITREVIDX_FLT_4096)) -extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len4096; -#endif + extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len16; + extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len32; + extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len64; + extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len128; + extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len256; + extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len512; + extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len1024; + extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len2048; + extern const arm_cfft_instance_f16 arm_cfft_sR_f16_len4096; #endif -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_helium_utils.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_helium_utils.h old mode 100644 new mode 100755 index 55afd6471be..65167678261 --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_helium_utils.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_helium_utils.h @@ -26,21 +26,23 @@ * limitations under the License. */ -#ifndef _ARM_UTILS_HELIUM_H_ -#define _ARM_UTILS_HELIUM_H_ +#ifndef ARM_UTILS_HELIUM_H_ +#define ARM_UTILS_HELIUM_H_ -#ifdef __cplusplus -extern "C" { + +#ifdef __cplusplus +extern "C" +{ #endif /*************************************** Definitions available for MVEF and MVEI ***************************************/ -#if (defined(ARM_MATH_HELIUM) || defined(ARM_MATH_MVEF) || defined(ARM_MATH_MVEI)) && \ - !defined(ARM_MATH_AUTOVECTORIZE) +#if (defined (ARM_MATH_HELIUM) || defined(ARM_MATH_MVEF) || defined(ARM_MATH_MVEI)) && !defined(ARM_MATH_AUTOVECTORIZE) + +#define INACTIVELANE 0 /* inactive lane content */ -#define INACTIVELANE 0 /* inactive lane content */ #endif /* defined (ARM_MATH_HELIUM) || defined(ARM_MATH_MVEF) || defined(ARM_MATH_MVEI) */ @@ -49,63 +51,70 @@ Definitions available for MVEF and MVEI Definitions available for MVEF only ***************************************/ -#if (defined(ARM_MATH_HELIUM) || defined(ARM_MATH_MVEF)) && !defined(ARM_MATH_AUTOVECTORIZE) +#if (defined (ARM_MATH_HELIUM) || defined(ARM_MATH_MVEF)) && !defined(ARM_MATH_AUTOVECTORIZE) __STATIC_FORCEINLINE float32_t vecAddAcrossF32Mve(float32x4_t in) { float32_t acc; - acc = vgetq_lane(in, 0) + vgetq_lane(in, 1) + vgetq_lane(in, 2) + vgetq_lane(in, 3); + acc = vgetq_lane(in, 0) + vgetq_lane(in, 1) + + vgetq_lane(in, 2) + vgetq_lane(in, 3); return acc; } + + + /* newton initial guess */ -#define INVSQRT_MAGIC_F32 0x5f3759df -#define INV_NEWTON_INIT_F32 0x7EF127EA - -#define INVSQRT_NEWTON_MVE_F32(invSqrt, xHalf, xStart) \ - { \ - float32x4_t tmp; \ - \ - /* tmp = xhalf * x * x */ \ - tmp = vmulq(xStart, xStart); \ - tmp = vmulq(tmp, xHalf); \ - /* (1.5f - xhalf * x * x) */ \ - tmp = vsubq(vdupq_n_f32(1.5f), tmp); \ - /* x = x*(1.5f-xhalf*x*x); */ \ - invSqrt = vmulq(tmp, xStart); \ - } +#define INVSQRT_MAGIC_F32 0x5f3759df +#define INV_NEWTON_INIT_F32 0x7EF127EA + + +#define INVSQRT_NEWTON_MVE_F32(invSqrt, xHalf, xStart)\ +{ \ + float32x4_t tmp; \ + \ + /* tmp = xhalf * x * x */ \ + tmp = vmulq(xStart, xStart); \ + tmp = vmulq(tmp, xHalf); \ + /* (1.5f - xhalf * x * x) */ \ + tmp = vsubq(vdupq_n_f32(1.5f), tmp); \ + /* x = x*(1.5f-xhalf*x*x); */ \ + invSqrt = vmulq(tmp, xStart); \ +} #endif /* defined (ARM_MATH_HELIUM) || defined(ARM_MATH_MVEF) */ + /*************************************** Definitions available for f16 datatype with HW acceleration only ***************************************/ #if defined(ARM_FLOAT16_SUPPORTED) -#if defined(ARM_MATH_MVE_FLOAT16) && !defined(ARM_MATH_AUTOVECTORIZE) +#if defined (ARM_MATH_MVE_FLOAT16) && !defined(ARM_MATH_AUTOVECTORIZE) __STATIC_FORCEINLINE float16_t vecAddAcrossF16Mve(float16x8_t in) { float16x8_t tmpVec; _Float16 acc; - tmpVec = (float16x8_t)vrev32q_s16((int16x8_t)in); + tmpVec = (float16x8_t) vrev32q_s16((int16x8_t) in); in = vaddq_f16(tmpVec, in); - tmpVec = (float16x8_t)vrev64q_s32((int32x4_t)in); + tmpVec = (float16x8_t) vrev64q_s32((int32x4_t) in); in = vaddq_f16(tmpVec, in); acc = (_Float16)vgetq_lane_f16(in, 0) + (_Float16)vgetq_lane_f16(in, 4); return acc; } -__STATIC_FORCEINLINE float16x8_t __mve_cmplx_sum_intra_vec_f16(float16x8_t vecIn) +__STATIC_FORCEINLINE float16x8_t __mve_cmplx_sum_intra_vec_f16( + float16x8_t vecIn) { - float16x8_t vecTmp, vecOut; - uint32_t tmp; + float16x8_t vecTmp, vecOut; + uint32_t tmp = 0; - vecTmp = (float16x8_t)vrev64q_s32((int32x4_t)vecIn); + vecTmp = (float16x8_t) vrev64q_s32((int32x4_t) vecIn); // TO TRACK : using canonical addition leads to unefficient code generation for f16 // vecTmp = vecTmp + vecAccCpx0; /* @@ -118,7 +127,7 @@ __STATIC_FORCEINLINE float16x8_t __mve_cmplx_sum_intra_vec_f16(float16x8_t vecIn /* * shift left, random tmp insertion in bottom */ - vecOut = vreinterpretq_f16_s32(vshlcq_s32(vreinterpretq_s32_f16(vecOut), &tmp, 32)); + vecOut = vreinterpretq_f16_s32(vshlcq_s32(vreinterpretq_s32_f16(vecOut) , &tmp, 32)); /* * Compute: * DONTCARE | DONTCARE | re0+re1+re0+re1 |im0+im1+im0+im1 @@ -132,51 +141,56 @@ __STATIC_FORCEINLINE float16x8_t __mve_cmplx_sum_intra_vec_f16(float16x8_t vecIn return vecOut; } -#define mve_cmplx_sum_intra_r_i_f16(vec, Re, Im) \ - { \ - float16x8_t vecOut = __mve_cmplx_sum_intra_vec_f16(vec); \ - Re = vgetq_lane(vecOut, 4); \ - Im = vgetq_lane(vecOut, 5); \ - } -__STATIC_FORCEINLINE void mve_cmplx_sum_intra_vec_f16(float16x8_t vecIn, float16_t *pOut) +#define mve_cmplx_sum_intra_r_i_f16(vec, Re, Im) \ +{ \ + float16x8_t vecOut = __mve_cmplx_sum_intra_vec_f16(vec); \ + Re = vgetq_lane(vecOut, 4); \ + Im = vgetq_lane(vecOut, 5); \ +} + +__STATIC_FORCEINLINE void mve_cmplx_sum_intra_vec_f16( + float16x8_t vecIn, + float16_t *pOut) { - float16x8_t vecOut = __mve_cmplx_sum_intra_vec_f16(vecIn); + float16x8_t vecOut = __mve_cmplx_sum_intra_vec_f16(vecIn); /* * Cmplx sum is in 4rd & 5th f16 elt * use 32-bit extraction */ - *(float32_t *)pOut = ((float32x4_t)vecOut)[2]; + *(float32_t *) pOut = ((float32x4_t) vecOut)[2]; } -#define INVSQRT_MAGIC_F16 0x59ba /* ( 0x1ba = 0x3759df >> 13) */ + +#define INVSQRT_MAGIC_F16 0x59ba /* ( 0x1ba = 0x3759df >> 13) */ /* canonical version of INVSQRT_NEWTON_MVE_F16 leads to bad performance */ -#define INVSQRT_NEWTON_MVE_F16(invSqrt, xHalf, xStart) \ - { \ - float16x8_t tmp; \ - \ - /* tmp = xhalf * x * x */ \ - tmp = vmulq(xStart, xStart); \ - tmp = vmulq(tmp, xHalf); \ - /* (1.5f - xhalf * x * x) */ \ - tmp = vsubq(vdupq_n_f16((float16_t)1.5), tmp); \ - /* x = x*(1.5f-xhalf*x*x); */ \ - invSqrt = vmulq(tmp, xStart); \ - } +#define INVSQRT_NEWTON_MVE_F16(invSqrt, xHalf, xStart) \ +{ \ + float16x8_t tmp; \ + \ + /* tmp = xhalf * x * x */ \ + tmp = vmulq(xStart, xStart); \ + tmp = vmulq(tmp, xHalf); \ + /* (1.5f - xhalf * x * x) */ \ + tmp = vsubq(vdupq_n_f16((float16_t)1.5), tmp); \ + /* x = x*(1.5f-xhalf*x*x); */ \ + invSqrt = vmulq(tmp, xStart); \ +} #endif -#endif +#endif /*************************************** Definitions available for MVEI and MVEF only ***************************************/ -#if (defined(ARM_MATH_HELIUM) || defined(ARM_MATH_MVEF) || defined(ARM_MATH_MVEI)) && \ - !defined(ARM_MATH_AUTOVECTORIZE) +#if (defined (ARM_MATH_HELIUM) || defined(ARM_MATH_MVEF) || defined(ARM_MATH_MVEI)) && !defined(ARM_MATH_AUTOVECTORIZE) /* Following functions are used to transpose matrix in f32 and q31 cases */ -__STATIC_INLINE arm_status arm_mat_trans_32bit_2x2_mve(uint32_t *pDataSrc, uint32_t *pDataDest) +__STATIC_INLINE arm_status arm_mat_trans_32bit_2x2_mve( + uint32_t * pDataSrc, + uint32_t * pDataDest) { static const uint32x4_t vecOffs = { 0, 2, 1, 3 }; /* @@ -191,10 +205,12 @@ __STATIC_INLINE arm_status arm_mat_trans_32bit_2x2_mve(uint32_t *pDataSrc, uint3 return (ARM_MATH_SUCCESS); } -__STATIC_INLINE arm_status arm_mat_trans_32bit_3x3_mve(uint32_t *pDataSrc, uint32_t *pDataDest) +__STATIC_INLINE arm_status arm_mat_trans_32bit_3x3_mve( + uint32_t * pDataSrc, + uint32_t * pDataDest) { - const uint32x4_t vecOffs1 = { 0, 3, 6, 1 }; - const uint32x4_t vecOffs2 = { 4, 7, 2, 5 }; + const uint32x4_t vecOffs1 = { 0, 3, 6, 1}; + const uint32x4_t vecOffs2 = { 4, 7, 2, 5}; /* * * | 0 1 2 | | 0 3 6 | 4 x 32 flattened version | 0 3 6 1 | @@ -202,8 +218,8 @@ __STATIC_INLINE arm_status arm_mat_trans_32bit_3x3_mve(uint32_t *pDataSrc, uint3 * | 6 7 8 | | 2 5 8 | (row major) | 8 . . . | * */ - uint32x4_t vecIn1 = vldrwq_u32((uint32_t const *)pDataSrc); - uint32x4_t vecIn2 = vldrwq_u32((uint32_t const *)&pDataSrc[4]); + uint32x4_t vecIn1 = vldrwq_u32((uint32_t const *) pDataSrc); + uint32x4_t vecIn2 = vldrwq_u32((uint32_t const *) &pDataSrc[4]); vstrwq_scatter_shifted_offset_u32(pDataDest, vecOffs1, vecIn1); vstrwq_scatter_shifted_offset_u32(pDataDest, vecOffs2, vecIn2); @@ -213,7 +229,7 @@ __STATIC_INLINE arm_status arm_mat_trans_32bit_3x3_mve(uint32_t *pDataSrc, uint3 return (ARM_MATH_SUCCESS); } -__STATIC_INLINE arm_status arm_mat_trans_32bit_4x4_mve(uint32_t *pDataSrc, uint32_t *pDataDest) +__STATIC_INLINE arm_status arm_mat_trans_32bit_4x4_mve(uint32_t * pDataSrc, uint32_t * pDataDest) { /* * 4x4 Matrix transposition @@ -227,7 +243,7 @@ __STATIC_INLINE arm_status arm_mat_trans_32bit_4x4_mve(uint32_t *pDataSrc, uint3 uint32x4x4_t vecIn; - vecIn = vld4q((uint32_t const *)pDataSrc); + vecIn = vld4q((uint32_t const *) pDataSrc); vstrwq(pDataDest, vecIn.val[0]); pDataDest += 4; vstrwq(pDataDest, vecIn.val[1]); @@ -239,12 +255,16 @@ __STATIC_INLINE arm_status arm_mat_trans_32bit_4x4_mve(uint32_t *pDataSrc, uint3 return (ARM_MATH_SUCCESS); } -__STATIC_INLINE arm_status arm_mat_trans_32bit_generic_mve(uint16_t srcRows, uint16_t srcCols, - uint32_t *pDataSrc, uint32_t *pDataDest) + +__STATIC_INLINE arm_status arm_mat_trans_32bit_generic_mve( + uint16_t srcRows, + uint16_t srcCols, + uint32_t * pDataSrc, + uint32_t * pDataDest) { uint32x4_t vecOffs; - uint32_t i; - uint32_t blkCnt; + uint32_t i; + uint32_t blkCnt; uint32_t const *pDataC; uint32_t *pDataDestR; uint32x4_t vecIn; @@ -253,14 +273,16 @@ __STATIC_INLINE arm_status arm_mat_trans_32bit_generic_mve(uint16_t srcRows, uin vecOffs = vecOffs * srcCols; i = srcCols; - do { - pDataC = (uint32_t const *)pDataSrc; + do + { + pDataC = (uint32_t const *) pDataSrc; pDataDestR = pDataDest; blkCnt = srcRows >> 2; - while (blkCnt > 0U) { + while (blkCnt > 0U) + { vecIn = vldrwq_gather_shifted_offset_u32(pDataC, vecOffs); - vstrwq(pDataDestR, vecIn); + vstrwq(pDataDestR, vecIn); pDataDestR += 4; pDataC = pDataC + srcCols * 4; /* @@ -273,7 +295,8 @@ __STATIC_INLINE arm_status arm_mat_trans_32bit_generic_mve(uint16_t srcRows, uin * tail */ blkCnt = srcRows & 3; - if (blkCnt > 0U) { + if (blkCnt > 0U) + { mve_pred16_t p0 = vctp32q(blkCnt); vecIn = vldrwq_gather_shifted_offset_u32(pDataC, vecOffs); vstrwq_p(pDataDestR, vecIn, p0); @@ -281,28 +304,34 @@ __STATIC_INLINE arm_status arm_mat_trans_32bit_generic_mve(uint16_t srcRows, uin pDataSrc += 1; pDataDest += srcRows; - } while (--i); + } + while (--i); return (ARM_MATH_SUCCESS); } -__STATIC_INLINE arm_status arm_mat_cmplx_trans_32bit(uint16_t srcRows, uint16_t srcCols, - uint32_t *pDataSrc, uint16_t dstRows, - uint16_t dstCols, uint32_t *pDataDest) +__STATIC_INLINE arm_status arm_mat_cmplx_trans_32bit( + uint16_t srcRows, + uint16_t srcCols, + uint32_t *pDataSrc, + uint16_t dstRows, + uint16_t dstCols, + uint32_t *pDataDest) { - uint32_t i; + uint32_t i; uint32_t const *pDataC; - uint32_t *pDataRow; - uint32_t *pDataDestR, *pDataDestRow; - uint32x4_t vecOffsRef, vecOffsCur; - uint32_t blkCnt; - uint32x4_t vecIn; + uint32_t *pDataRow; + uint32_t *pDataDestR, *pDataDestRow; + uint32x4_t vecOffsRef, vecOffsCur; + uint32_t blkCnt; + uint32x4_t vecIn; #ifdef ARM_MATH_MATRIX_CHECK /* * Check for matrix mismatch condition */ - if ((srcRows != dstCols) || (srcCols != dstRows)) { + if ((srcRows != dstCols) || (srcCols != dstRows)) + { /* * Set status as ARM_MATH_SIZE_MISMATCH */ @@ -323,28 +352,31 @@ __STATIC_INLINE arm_status arm_mat_cmplx_trans_32bit(uint16_t srcRows, uint16_t pDataRow = pDataSrc; pDataDestRow = pDataDest; i = srcCols; - do { - pDataC = (uint32_t const *)pDataRow; + do + { + pDataC = (uint32_t const *) pDataRow; pDataDestR = pDataDestRow; vecOffsCur = vecOffsRef; blkCnt = (srcRows * CMPLX_DIM) >> 2; - while (blkCnt > 0U) { + while (blkCnt > 0U) + { vecIn = vldrwq_gather_shifted_offset(pDataC, vecOffsCur); - vstrwq(pDataDestR, vecIn); + vstrwq(pDataDestR, vecIn); pDataDestR += 4; vecOffsCur = vaddq(vecOffsCur, (srcCols << 2)); /* * Decrement the blockSize loop counter */ - blkCnt--; + blkCnt--; } /* * tail * (will be merged thru tail predication) */ blkCnt = (srcRows * CMPLX_DIM) & 3; - if (blkCnt > 0U) { + if (blkCnt > 0U) + { mve_pred16_t p0 = vctp32q(blkCnt); vecIn = vldrwq_gather_shifted_offset(pDataC, vecOffsCur); vstrwq_p(pDataDestR, vecIn, p0); @@ -352,12 +384,13 @@ __STATIC_INLINE arm_status arm_mat_cmplx_trans_32bit(uint16_t srcRows, uint16_t pDataRow += CMPLX_DIM; pDataDestRow += (srcRows * CMPLX_DIM); - } while (--i); + } + while (--i); return (ARM_MATH_SUCCESS); } -__STATIC_INLINE arm_status arm_mat_trans_16bit_2x2(uint16_t *pDataSrc, uint16_t *pDataDest) +__STATIC_INLINE arm_status arm_mat_trans_16bit_2x2(uint16_t * pDataSrc, uint16_t * pDataDest) { pDataDest[0] = pDataSrc[0]; pDataDest[3] = pDataSrc[3]; @@ -367,11 +400,11 @@ __STATIC_INLINE arm_status arm_mat_trans_16bit_2x2(uint16_t *pDataSrc, uint16_t return (ARM_MATH_SUCCESS); } -__STATIC_INLINE arm_status arm_mat_trans_16bit_3x3_mve(uint16_t *pDataSrc, uint16_t *pDataDest) +__STATIC_INLINE arm_status arm_mat_trans_16bit_3x3_mve(uint16_t * pDataSrc, uint16_t * pDataDest) { static const uint16_t stridesTr33[8] = { 0, 3, 6, 1, 4, 7, 2, 5 }; - uint16x8_t vecOffs1; - uint16x8_t vecIn1; + uint16x8_t vecOffs1; + uint16x8_t vecIn1; /* * * | 0 1 2 | | 0 3 6 | 8 x 16 flattened version | 0 3 6 1 4 7 2 5 | @@ -379,8 +412,8 @@ __STATIC_INLINE arm_status arm_mat_trans_16bit_3x3_mve(uint16_t *pDataSrc, uint1 * | 6 7 8 | | 2 5 8 | (row major) * */ - vecOffs1 = vldrhq_u16((uint16_t const *)stridesTr33); - vecIn1 = vldrhq_u16((uint16_t const *)pDataSrc); + vecOffs1 = vldrhq_u16((uint16_t const *) stridesTr33); + vecIn1 = vldrhq_u16((uint16_t const *) pDataSrc); vstrhq_scatter_shifted_offset_u16(pDataDest, vecOffs1, vecIn1); @@ -389,13 +422,14 @@ __STATIC_INLINE arm_status arm_mat_trans_16bit_3x3_mve(uint16_t *pDataSrc, uint1 return (ARM_MATH_SUCCESS); } -__STATIC_INLINE arm_status arm_mat_trans_16bit_4x4_mve(uint16_t *pDataSrc, uint16_t *pDataDest) + +__STATIC_INLINE arm_status arm_mat_trans_16bit_4x4_mve(uint16_t * pDataSrc, uint16_t * pDataDest) { static const uint16_t stridesTr44_1[8] = { 0, 4, 8, 12, 1, 5, 9, 13 }; static const uint16_t stridesTr44_2[8] = { 2, 6, 10, 14, 3, 7, 11, 15 }; - uint16x8_t vecOffs1, vecOffs2; - uint16x8_t vecIn1, vecIn2; - uint16_t const *pDataSrcVec = (uint16_t const *)pDataSrc; + uint16x8_t vecOffs1, vecOffs2; + uint16x8_t vecIn1, vecIn2; + uint16_t const * pDataSrcVec = (uint16_t const *) pDataSrc; /* * 4x4 Matrix transposition @@ -406,8 +440,8 @@ __STATIC_INLINE arm_status arm_mat_trans_16bit_4x4_mve(uint16_t *pDataSrc, uint1 * | 12 13 14 15 | | 3 7 11 15 | */ - vecOffs1 = vldrhq_u16((uint16_t const *)stridesTr44_1); - vecOffs2 = vldrhq_u16((uint16_t const *)stridesTr44_2); + vecOffs1 = vldrhq_u16((uint16_t const *) stridesTr44_1); + vecOffs2 = vldrhq_u16((uint16_t const *) stridesTr44_2); vecIn1 = vldrhq_u16(pDataSrcVec); pDataSrcVec += 8; vecIn2 = vldrhq_u16(pDataSrcVec); @@ -415,31 +449,39 @@ __STATIC_INLINE arm_status arm_mat_trans_16bit_4x4_mve(uint16_t *pDataSrc, uint1 vstrhq_scatter_shifted_offset_u16(pDataDest, vecOffs1, vecIn1); vstrhq_scatter_shifted_offset_u16(pDataDest, vecOffs2, vecIn2); + return (ARM_MATH_SUCCESS); } -__STATIC_INLINE arm_status arm_mat_trans_16bit_generic(uint16_t srcRows, uint16_t srcCols, - uint16_t *pDataSrc, uint16_t *pDataDest) + + +__STATIC_INLINE arm_status arm_mat_trans_16bit_generic( + uint16_t srcRows, + uint16_t srcCols, + uint16_t * pDataSrc, + uint16_t * pDataDest) { - uint16x8_t vecOffs; - uint32_t i; - uint32_t blkCnt; + uint16x8_t vecOffs; + uint32_t i; + uint32_t blkCnt; uint16_t const *pDataC; - uint16_t *pDataDestR; - uint16x8_t vecIn; + uint16_t *pDataDestR; + uint16x8_t vecIn; vecOffs = vidupq_u16((uint32_t)0, 1); vecOffs = vecOffs * srcCols; i = srcCols; - while (i > 0U) { - pDataC = (uint16_t const *)pDataSrc; + while(i > 0U) + { + pDataC = (uint16_t const *) pDataSrc; pDataDestR = pDataDest; blkCnt = srcRows >> 3; - while (blkCnt > 0U) { + while (blkCnt > 0U) + { vecIn = vldrhq_gather_shifted_offset_u16(pDataC, vecOffs); - vstrhq_u16(pDataDestR, vecIn); + vstrhq_u16(pDataDestR, vecIn); pDataDestR += 8; pDataC = pDataC + srcCols * 8; /* @@ -452,7 +494,8 @@ __STATIC_INLINE arm_status arm_mat_trans_16bit_generic(uint16_t srcRows, uint16_ * tail */ blkCnt = srcRows & 7; - if (blkCnt > 0U) { + if (blkCnt > 0U) + { mve_pred16_t p0 = vctp16q(blkCnt); vecIn = vldrhq_gather_shifted_offset_u16(pDataC, vecOffs); vstrhq_p_u16(pDataDestR, vecIn, p0); @@ -465,24 +508,30 @@ __STATIC_INLINE arm_status arm_mat_trans_16bit_generic(uint16_t srcRows, uint16_ return (ARM_MATH_SUCCESS); } -__STATIC_INLINE arm_status arm_mat_cmplx_trans_16bit(uint16_t srcRows, uint16_t srcCols, - uint16_t *pDataSrc, uint16_t dstRows, - uint16_t dstCols, uint16_t *pDataDest) + +__STATIC_INLINE arm_status arm_mat_cmplx_trans_16bit( + uint16_t srcRows, + uint16_t srcCols, + uint16_t *pDataSrc, + uint16_t dstRows, + uint16_t dstCols, + uint16_t *pDataDest) { static const uint16_t loadCmplxCol[8] = { 0, 0, 1, 1, 2, 2, 3, 3 }; - int i; - uint16x8_t vecOffsRef, vecOffsCur; + int i; + uint16x8_t vecOffsRef, vecOffsCur; uint16_t const *pDataC; - uint16_t *pDataRow; - uint16_t *pDataDestR, *pDataDestRow; - uint32_t blkCnt; - uint16x8_t vecIn; + uint16_t *pDataRow; + uint16_t *pDataDestR, *pDataDestRow; + uint32_t blkCnt; + uint16x8_t vecIn; #ifdef ARM_MATH_MATRIX_CHECK /* * Check for matrix mismatch condition */ - if ((srcRows != dstCols) || (srcCols != dstRows)) { + if ((srcRows != dstCols) || (srcCols != dstRows)) + { /* * Set status as ARM_MATH_SIZE_MISMATCH */ @@ -497,26 +546,29 @@ __STATIC_INLINE arm_status arm_mat_cmplx_trans_16bit(uint16_t srcRows, uint16_t * 2x2, 3x3 and 4x4 specialization to be added */ + /* * build [0, 1, 2xcol, 2xcol+1, 4xcol, 4xcol+1, 6xcol, 6xcol+1] */ - vecOffsRef = vldrhq_u16((uint16_t const *)loadCmplxCol); - vecOffsRef = vmulq(vecOffsRef, (uint16_t)(srcCols * CMPLX_DIM)) + - viwdupq_u16((uint32_t)0, (uint16_t)2, 1); + vecOffsRef = vldrhq_u16((uint16_t const *) loadCmplxCol); + vecOffsRef = vmulq(vecOffsRef, (uint16_t) (srcCols * CMPLX_DIM)) + + viwdupq_u16((uint32_t)0, (uint16_t) 2, 1); pDataRow = pDataSrc; pDataDestRow = pDataDest; i = srcCols; - do { - pDataC = (uint16_t const *)pDataRow; + do + { + pDataC = (uint16_t const *) pDataRow; pDataDestR = pDataDestRow; vecOffsCur = vecOffsRef; blkCnt = (srcRows * CMPLX_DIM) >> 3; - while (blkCnt > 0U) { + while (blkCnt > 0U) + { vecIn = vldrhq_gather_shifted_offset(pDataC, vecOffsCur); - vstrhq(pDataDestR, vecIn); - pDataDestR += 8; // VEC_LANES_U16 + vstrhq(pDataDestR, vecIn); + pDataDestR+= 8; // VEC_LANES_U16 vecOffsCur = vaddq(vecOffsCur, (srcCols << 3)); /* * Decrement the blockSize loop counter @@ -528,7 +580,8 @@ __STATIC_INLINE arm_status arm_mat_cmplx_trans_16bit(uint16_t srcRows, uint16_t * (will be merged thru tail predication) */ blkCnt = (srcRows * CMPLX_DIM) & 0x7; - if (blkCnt > 0U) { + if (blkCnt > 0U) + { mve_pred16_t p0 = vctp16q(blkCnt); vecIn = vldrhq_gather_shifted_offset(pDataC, vecOffsCur); vstrhq_p(pDataDestR, vecIn, p0); @@ -536,7 +589,8 @@ __STATIC_INLINE arm_status arm_mat_cmplx_trans_16bit(uint16_t srcRows, uint16_t pDataRow += CMPLX_DIM; pDataDestRow += (srcRows * CMPLX_DIM); - } while (--i); + } + while (--i); return (ARM_MATH_SUCCESS); } @@ -547,22 +601,22 @@ __STATIC_INLINE arm_status arm_mat_cmplx_trans_16bit(uint16_t srcRows, uint16_t Definitions available for MVEI only ***************************************/ -#if (defined(ARM_MATH_HELIUM) || defined(ARM_MATH_MVEI)) && !defined(ARM_MATH_AUTOVECTORIZE) +#if (defined (ARM_MATH_HELIUM) || defined(ARM_MATH_MVEI)) && !defined(ARM_MATH_AUTOVECTORIZE) #include "arm_common_tables.h" -#define MVE_ASRL_SAT16(acc, shift) ((sqrshrl_sat48(acc, -(32 - shift)) >> 32) & 0xffffffff) -#define MVE_ASRL_SAT32(acc, shift) ((sqrshrl(acc, -(32 - shift)) >> 32) & 0xffffffff) +#define MVE_ASRL_SAT16(acc, shift) ((sqrshrl_sat48(acc, -(32-shift)) >> 32) & 0xffffffff) +#define MVE_ASRL_SAT32(acc, shift) ((sqrshrl(acc, -(32-shift)) >> 32) & 0xffffffff) + -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FAST_TABLES) || \ - defined(ARM_TABLE_FAST_SQRT_Q31_MVE) __STATIC_INLINE q31x4_t FAST_VSQRT_Q31(q31x4_t vecIn) { - q63x2_t vecTmpLL; - q31x4_t vecTmp0, vecTmp1; - q31_t scale; - q63_t tmp64; - q31x4_t vecNrm, vecDst, vecIdx, vecSignBits; + q63x2_t vecTmpLL; + q31x4_t vecTmp0, vecTmp1; + q31_t scale; + q63_t tmp64; + q31x4_t vecNrm, vecDst, vecIdx, vecSignBits; + vecSignBits = vclsq(vecIn); vecSignBits = vbicq_n_s32(vecSignBits, 1); @@ -595,11 +649,11 @@ __STATIC_INLINE q31x4_t FAST_VSQRT_Q31(q31x4_t vecIn) */ scale = 26 + (vecSignBits[0] >> 1); tmp64 = asrl(vecTmpLL[0], scale); - vecDst[0] = (q31_t)tmp64; + vecDst[0] = (q31_t) tmp64; scale = 26 + (vecSignBits[2] >> 1); tmp64 = asrl(vecTmpLL[1], scale); - vecDst[2] = (q31_t)tmp64; + vecDst[2] = (q31_t) tmp64; vecTmpLL = vmulltq_int(vecNrm, vecTmp0); @@ -608,11 +662,11 @@ __STATIC_INLINE q31x4_t FAST_VSQRT_Q31(q31x4_t vecIn) */ scale = 26 + (vecSignBits[1] >> 1); tmp64 = asrl(vecTmpLL[0], scale); - vecDst[1] = (q31_t)tmp64; + vecDst[1] = (q31_t) tmp64; scale = 26 + (vecSignBits[3] >> 1); tmp64 = asrl(vecTmpLL[1], scale); - vecDst[3] = (q31_t)tmp64; + vecDst[3] = (q31_t) tmp64; /* * set negative values to 0 */ @@ -620,15 +674,12 @@ __STATIC_INLINE q31x4_t FAST_VSQRT_Q31(q31x4_t vecIn) return vecDst; } -#endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FAST_TABLES) || \ - defined(ARM_TABLE_FAST_SQRT_Q15_MVE) __STATIC_INLINE q15x8_t FAST_VSQRT_Q15(q15x8_t vecIn) { - q31x4_t vecTmpLev, vecTmpLodd, vecSignL; - q15x8_t vecTmp0, vecTmp1; - q15x8_t vecNrm, vecDst, vecIdx, vecSignBits; + q31x4_t vecTmpLev, vecTmpLodd, vecSignL; + q15x8_t vecTmp0, vecTmp1; + q15x8_t vecNrm, vecDst, vecIdx, vecSignBits; vecDst = vuninitializedq_s16(); @@ -688,11 +739,10 @@ __STATIC_INLINE q15x8_t FAST_VSQRT_Q15(q15x8_t vecIn) return vecDst; } -#endif #endif /* defined (ARM_MATH_HELIUM) || defined(ARM_MATH_MVEI) */ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_math.h index a4edf0d8c45..0e9ca5997ed 100644 --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_math.h @@ -23,152 +23,10 @@ * limitations under the License. */ -/** - \mainpage CMSIS DSP Software Library - * - * \section intro Introduction - * - * This user manual describes the CMSIS DSP software library, - * a suite of common signal processing functions for use on Cortex-M and Cortex-A processor - * based devices. - * - * The library is divided into a number of functions each covering a specific category: - * - Basic math functions - * - Fast math functions - * - Complex math functions - * - Filtering functions - * - Matrix functions - * - Transform functions - * - Motor control functions - * - Statistical functions - * - Support functions - * - Interpolation functions - * - Support Vector Machine functions (SVM) - * - Bayes classifier functions - * - Distance functions - * - Quaternion functions - * - * The library has generally separate functions for operating on 8-bit integers, 16-bit integers, - * 32-bit integer and 32-bit floating-point values. - * - * The library is providing vectorized versions of most algorthms for Helium - * and of most f32 algorithms for Neon. - * - * When using a vectorized version, provide a little bit of padding after the end of - * a buffer (3 words) because the vectorized code may read a little bit after the end - * of a buffer. You don't have to modify your buffers but just ensure that the - * end of buffer + padding is not outside of a memory region. - * - * \section using Using the Library - * - * The library is released in source form. It is strongly advised to compile the library using -Ofast to - * have the best performances. - * - * The library functions are declared in the public file arm_math.h which is placed in the Include folder. - * Simply include this file. If you don't want to include everything, you can also rely - * on headers in Include/dsp folder and use only what you need. - * - * \section example Examples - * - * The library ships with a number of examples which demonstrate how to use the library functions. - * - * \section toolchain Toolchain Support - * - * The library is now tested on Fast Models building with cmake. - * Core M0, M4, M7, M33, M55, A32 are tested. - * - * - * \section preprocessor Preprocessor Macros - * - * Each library project have different preprocessor macros. - * - * - ARM_MATH_BIG_ENDIAN: - * - * Define macro ARM_MATH_BIG_ENDIAN to build the library for big endian targets. By default library builds for little endian targets. - * - * - ARM_MATH_MATRIX_CHECK: - * - * Define macro ARM_MATH_MATRIX_CHECK for checking on the input and output sizes of matrices - * - * - ARM_MATH_ROUNDING: - * - * Define macro ARM_MATH_ROUNDING for rounding on support functions - * - * - ARM_MATH_LOOPUNROLL: - * - * Define macro ARM_MATH_LOOPUNROLL to enable manual loop unrolling in DSP functions - * - * - ARM_MATH_NEON: - * - * Define macro ARM_MATH_NEON to enable Neon versions of the DSP functions. - * It is not enabled by default when Neon is available because performances are - * dependent on the compiler and target architecture. - * - * - ARM_MATH_NEON_EXPERIMENTAL: - * - * Define macro ARM_MATH_NEON_EXPERIMENTAL to enable experimental Neon versions of - * of some DSP functions. Experimental Neon versions currently do not have better - * performances than the scalar versions. - * - * - ARM_MATH_HELIUM: - * - * It implies the flags ARM_MATH_MVEF and ARM_MATH_MVEI and ARM_MATH_MVE_FLOAT16. - * - * - ARM_MATH_HELIUM_EXPERIMENTAL: - * - * Only taken into account when ARM_MATH_MVEF, ARM_MATH_MVEI or ARM_MATH_MVE_FLOAT16 are defined. - * Enable some vector versions which may have worse performance than scalar - * depending on the core / compiler configuration. - * - * - ARM_MATH_MVEF: - * - * Select Helium versions of the f32 algorithms. - * It implies ARM_MATH_FLOAT16 and ARM_MATH_MVEI. - * - * - ARM_MATH_MVEI: - * - * Select Helium versions of the int and fixed point algorithms. - * - * - ARM_MATH_MVE_FLOAT16: - * - * MVE Float16 implementations of some algorithms (Requires MVE extension). - * - * - DISABLEFLOAT16: - * - * Disable float16 algorithms when __fp16 is not supported for a - * specific compiler / core configuration. - * This is only valid for scalar. When vector architecture is - * supporting f16 then it can't be disabled. - * - * - ARM_MATH_AUTOVECTORIZE: - * - * With Helium or Neon, disable the use of vectorized code with C intrinsics - * and use pure C instead. The vectorization is then done by the compiler. - * - *
- * \section pack CMSIS-DSP in ARM::CMSIS Pack - * - * The following files relevant to CMSIS-DSP are present in the ARM::CMSIS Pack directories: - * |File/Folder |Content | - * |---------------------------------|------------------------------------------------------------------------| - * |\b CMSIS\\Documentation\\DSP | This documentation | - * |\b CMSIS\\DSP\\Examples | Example projects demonstrating the usage of the library functions | - * |\b CMSIS\\DSP\\Include | DSP_Lib include files for using and building the lib - * |\b CMSIS\\DSP\\PrivateInclude | DSP_Lib private include files for building the lib | - * |\b CMSIS\\DSP\\Lib | DSP_Lib binaries | - * |\b CMSIS\\DSP\\Source | DSP_Lib source files | - * - *
- * \section rev Revision History of CMSIS-DSP - * Please refer to \ref ChangeLog_pg. - */ -/** - * @defgroup groupExamples Examples - */ +#ifndef ARM_MATH_H +#define ARM_MATH_H -#ifndef _ARM_MATH_H -#define _ARM_MATH_H #include "arm_math_types.h" #include "arm_math_memory.h" @@ -176,7 +34,7 @@ #include "dsp/none.h" #include "dsp/utils.h" -#include "dsp/basic_math_functions.h" +#include "dsp/basic_math_functions.h" #include "dsp/interpolation_functions.h" #include "dsp/bayes_functions.h" #include "dsp/matrix_functions.h" @@ -190,18 +48,30 @@ #include "dsp/transform_functions.h" #include "dsp/filtering_functions.h" #include "dsp/quaternion_math_functions.h" +#include "dsp/window_functions.h" + -#ifdef __cplusplus -extern "C" { + +#ifdef __cplusplus +extern "C" +{ #endif + + + //#define TABLE_SPACING_Q31 0x400000 //#define TABLE_SPACING_Q15 0x80 -#ifdef __cplusplus + + + + +#ifdef __cplusplus } #endif + #endif /* _ARM_MATH_H */ /** diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_f16.h old mode 100644 new mode 100755 index 309ea68b192..34ca0e542fc --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_f16.h @@ -23,13 +23,14 @@ * limitations under the License. */ -#ifndef _ARM_MATH_F16_H -#define _ARM_MATH_F16_H +#ifndef ARM_MATH_F16_H +#define ARM_MATH_F16_H #include "arm_math.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #include "arm_math_types_f16.h" @@ -49,8 +50,10 @@ extern "C" { #include "dsp/transform_functions_f16.h" #include "dsp/filtering_functions_f16.h" -#ifdef __cplusplus +#ifdef __cplusplus } #endif #endif /* _ARM_MATH_F16_H */ + + diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_memory.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_memory.h old mode 100644 new mode 100755 index 2f4be7eae6c..d4b4c3323ad --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_memory.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_memory.h @@ -23,63 +23,68 @@ * limitations under the License. */ -#ifndef _ARM_MATH_MEMORY_H_ +#ifndef ARM_MATH_MEMORY_H_ -#define _ARM_MATH_MEMORY_H_ +#define ARM_MATH_MEMORY_H_ #include "arm_math_types.h" -#ifdef __cplusplus -extern "C" { + +#ifdef __cplusplus +extern "C" +{ #endif /** @brief definition to read/write two 16 bit values. @deprecated */ -#if defined(__CC_ARM) -#define __SIMD32_TYPE int32_t __packed -#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) -#define __SIMD32_TYPE int32_t -#elif defined(__GNUC__) -#define __SIMD32_TYPE int32_t -#elif defined(__ICCARM__) -#define __SIMD32_TYPE int32_t __packed -#elif defined(__TI_ARM__) -#define __SIMD32_TYPE int32_t -#elif defined(__CSMC__) -#define __SIMD32_TYPE int32_t -#elif defined(__TASKING__) -#define __SIMD32_TYPE __un(aligned) int32_t -#elif defined(_MSC_VER) -#define __SIMD32_TYPE int32_t +#if defined ( __CC_ARM ) + #define __SIMD32_TYPE int32_t __packed +#elif defined ( __ARMCC_VERSION ) && ( __ARMCC_VERSION >= 6010050 ) + #define __SIMD32_TYPE int32_t +#elif defined ( __GNUC__ ) + #define __SIMD32_TYPE int32_t +#elif defined ( __ICCARM__ ) + #define __SIMD32_TYPE int32_t __packed +#elif defined ( __TI_ARM__ ) + #define __SIMD32_TYPE int32_t +#elif defined ( __CSMC__ ) + #define __SIMD32_TYPE int32_t +#elif defined ( __TASKING__ ) + #define __SIMD32_TYPE __un(aligned) int32_t +#elif defined(_MSC_VER ) + #define __SIMD32_TYPE int32_t #else -#error Unknown compiler + #error Unknown compiler #endif -#define __SIMD32(addr) (*(__SIMD32_TYPE **)&(addr)) -#define __SIMD32_CONST(addr) ((__SIMD32_TYPE *)(addr)) -#define _SIMD32_OFFSET(addr) (*(__SIMD32_TYPE *)(addr)) -#define __SIMD64(addr) (*(int64_t **)&(addr)) +#define __SIMD32(addr) (*(__SIMD32_TYPE **) & (addr)) +#define __SIMD32_CONST(addr) ( (__SIMD32_TYPE * ) (addr)) +#define _SIMD32_OFFSET(addr) (*(__SIMD32_TYPE * ) (addr)) +#define __SIMD64(addr) (*( int64_t **) & (addr)) + /* SIMD replacement */ + /** @brief Read 2 Q15 from Q15 pointer. @param[in] pQ15 points to input value @return Q31 value */ -__STATIC_FORCEINLINE q31_t read_q15x2(q15_t const *pQ15) +__STATIC_FORCEINLINE q31_t read_q15x2 ( + q15_t const * pQ15) { - q31_t val; + q31_t val; #ifdef __ARM_FEATURE_UNALIGNED - memcpy(&val, pQ15, 4); + memcpy (&val, pQ15, 4); #else - val = (pQ15[1] << 16) | (pQ15[0] & 0x0FFFF); + val = (pQ15[1] << 16) | (pQ15[0] & 0x0FFFF) ; #endif - return (val); + return (val); } /** @@ -100,55 +105,58 @@ __STATIC_FORCEINLINE q31_t read_q15x2(q15_t const *pQ15) @brief Write 2 Q15 to Q15 pointer and increment pointer afterwards. @param[in] pQ15 points to input value @param[in] value Q31 value - @return none */ -__STATIC_FORCEINLINE void write_q15x2_ia(q15_t **pQ15, q31_t value) +__STATIC_FORCEINLINE void write_q15x2_ia ( + q15_t ** pQ15, + q31_t value) { - q31_t val = value; + q31_t val = value; #ifdef __ARM_FEATURE_UNALIGNED - memcpy(*pQ15, &val, 4); + memcpy (*pQ15, &val, 4); #else - (*pQ15)[0] = (q15_t)(val & 0x0FFFF); - (*pQ15)[1] = (q15_t)((val >> 16) & 0x0FFFF); + (*pQ15)[0] = (q15_t)(val & 0x0FFFF); + (*pQ15)[1] = (q15_t)((val >> 16) & 0x0FFFF); #endif - *pQ15 += 2; + *pQ15 += 2; } /** @brief Write 2 Q15 to Q15 pointer. @param[in] pQ15 points to input value @param[in] value Q31 value - @return none */ -__STATIC_FORCEINLINE void write_q15x2(q15_t *pQ15, q31_t value) +__STATIC_FORCEINLINE void write_q15x2 ( + q15_t * pQ15, + q31_t value) { - q31_t val = value; + q31_t val = value; #ifdef __ARM_FEATURE_UNALIGNED - memcpy(pQ15, &val, 4); + memcpy (pQ15, &val, 4); #else - pQ15[0] = (q15_t)(val & 0x0FFFF); - pQ15[1] = (q15_t)(val >> 16); + pQ15[0] = (q15_t)(val & 0x0FFFF); + pQ15[1] = (q15_t)(val >> 16); #endif } + /** @brief Read 4 Q7 from Q7 pointer @param[in] pQ7 points to input value @return Q31 value */ -__STATIC_FORCEINLINE q31_t read_q7x4(q7_t const *pQ7) +__STATIC_FORCEINLINE q31_t read_q7x4 ( + q7_t const * pQ7) { - q31_t val; + q31_t val; #ifdef __ARM_FEATURE_UNALIGNED - memcpy(&val, pQ7, 4); + memcpy (&val, pQ7, 4); #else - val = ((pQ7[3] & 0x0FF) << 24) | ((pQ7[2] & 0x0FF) << 16) | ((pQ7[1] & 0x0FF) << 8) | - (pQ7[0] & 0x0FF); -#endif - return (val); + val =((pQ7[3] & 0x0FF) << 24) | ((pQ7[2] & 0x0FF) << 16) | ((pQ7[1] & 0x0FF) << 8) | (pQ7[0] & 0x0FF); +#endif + return (val); } /** @@ -169,24 +177,26 @@ __STATIC_FORCEINLINE q31_t read_q7x4(q7_t const *pQ7) @brief Write 4 Q7 to Q7 pointer and increment pointer afterwards. @param[in] pQ7 points to input value @param[in] value Q31 value - @return none */ -__STATIC_FORCEINLINE void write_q7x4_ia(q7_t **pQ7, q31_t value) +__STATIC_FORCEINLINE void write_q7x4_ia ( + q7_t ** pQ7, + q31_t value) { - q31_t val = value; + q31_t val = value; #ifdef __ARM_FEATURE_UNALIGNED - memcpy(*pQ7, &val, 4); + memcpy (*pQ7, &val, 4); #else - (*pQ7)[0] = (q7_t)(val & 0x0FF); - (*pQ7)[1] = (q7_t)((val >> 8) & 0x0FF); - (*pQ7)[2] = (q7_t)((val >> 16) & 0x0FF); - (*pQ7)[3] = (q7_t)((val >> 24) & 0x0FF); + (*pQ7)[0] = (q7_t)(val & 0x0FF); + (*pQ7)[1] = (q7_t)((val >> 8) & 0x0FF); + (*pQ7)[2] = (q7_t)((val >> 16) & 0x0FF); + (*pQ7)[3] = (q7_t)((val >> 24) & 0x0FF); #endif - *pQ7 += 4; + *pQ7 += 4; } -#ifdef __cplusplus + +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types.h old mode 100644 new mode 100755 index c55a3826524..74ae8485f77 --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types.h @@ -23,231 +23,269 @@ * limitations under the License. */ -#ifndef _ARM_MATH_TYPES_H_ +#ifndef ARM_MATH_TYPES_H_ -#define _ARM_MATH_TYPES_H_ +#define ARM_MATH_TYPES_H_ -#ifdef __cplusplus -extern "C" { +#if defined(ARM_DSP_CUSTOM_CONFIG) +#include "arm_dsp_config.h" +#endif + +#ifndef ARM_DSP_ATTRIBUTE +#define ARM_DSP_ATTRIBUTE +#endif + +#ifndef ARM_DSP_TABLE_ATTRIBUTE +#define ARM_DSP_TABLE_ATTRIBUTE +#endif + +#ifdef __cplusplus +extern "C" +{ #endif /* Compiler specific diagnostic adjustment */ -#if defined(__CC_ARM) +#if defined ( __CC_ARM ) + +#elif defined ( __ARMCC_VERSION ) && ( __ARMCC_VERSION >= 6010050 ) -#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) +#elif defined ( __APPLE_CC__ ) + #pragma GCC diagnostic ignored "-Wold-style-cast" -#elif defined(__APPLE_CC__) -#pragma GCC diagnostic ignored "-Wold-style-cast" +#elif defined(__clang__) + #pragma GCC diagnostic push + #pragma GCC diagnostic ignored "-Wsign-conversion" + #pragma GCC diagnostic ignored "-Wconversion" + #pragma GCC diagnostic ignored "-Wunused-parameter" -#elif defined(__GNUC__) -#pragma GCC diagnostic push -#pragma GCC diagnostic ignored "-Wsign-conversion" -#pragma GCC diagnostic ignored "-Wconversion" -#pragma GCC diagnostic ignored "-Wunused-parameter" +#elif defined ( __GNUC__ ) + #pragma GCC diagnostic push + #pragma GCC diagnostic ignored "-Wsign-conversion" + #pragma GCC diagnostic ignored "-Wconversion" + #pragma GCC diagnostic ignored "-Wunused-parameter" + // Disable some code having issue with GCC + #define ARM_DSP_BUILT_WITH_GCC -#elif defined(__ICCARM__) +#elif defined ( __ICCARM__ ) -#elif defined(__TI_ARM__) +#elif defined ( __TI_ARM__ ) -#elif defined(__CSMC__) +#elif defined ( __CSMC__ ) -#elif defined(__TASKING__) +#elif defined ( __TASKING__ ) -#elif defined(_MSC_VER) +#elif defined ( _MSC_VER ) #else -#error Unknown compiler + #error Unknown compiler #endif + /* Included for instrinsics definitions */ -#if defined(_MSC_VER) +#if defined (_MSC_VER ) #include #define __STATIC_FORCEINLINE static __forceinline #define __STATIC_INLINE static __inline #define __ALIGNED(x) __declspec(align(x)) -#elif defined(__APPLE_CC__) +#define __WEAK +#elif defined ( __APPLE_CC__ ) #include -#define __ALIGNED(x) __attribute__((aligned(x))) -#define __STATIC_FORCEINLINE static inline __attribute__((always_inline)) +#define __ALIGNED(x) __attribute__((aligned(x))) +#define __STATIC_FORCEINLINE static inline __attribute__((always_inline)) #define __STATIC_INLINE static inline -#elif defined(__GNUC_PYTHON__) +#define __WEAK +#elif defined (__GNUC_PYTHON__) #include -#define __ALIGNED(x) __attribute__((aligned(x))) -#define __STATIC_FORCEINLINE static inline __attribute__((always_inline)) +#define __ALIGNED(x) __attribute__((aligned(x))) +#define __STATIC_FORCEINLINE static inline __attribute__((always_inline)) #define __STATIC_INLINE static inline - +#define __WEAK #else #include "cmsis_compiler.h" #endif + + #include #include #include #include /* evaluate ARM DSP feature */ -#if (defined(__ARM_FEATURE_DSP) && (__ARM_FEATURE_DSP == 1)) -#define ARM_MATH_DSP 1 +#if (defined (__ARM_FEATURE_DSP) && (__ARM_FEATURE_DSP == 1)) + #define ARM_MATH_DSP 1 #endif #if defined(ARM_MATH_NEON) -#if defined(_MSC_VER) && defined(_M_ARM64EC) -#include -#else -#include -#endif -#if defined(__ARM_FEATURE_FP16_VECTOR_ARITHMETIC) && __ARM_FEATURE_FP16_VECTOR_ARITHMETIC -#if !defined(ARM_MATH_NEON_FLOAT16) -#define ARM_MATH_NEON_FLOAT16 -#endif -#endif + #if defined(_MSC_VER) && defined(_M_ARM64EC) + #include + #else + #include + #endif + #if defined(__ARM_FEATURE_FP16_VECTOR_ARITHMETIC) && __ARM_FEATURE_FP16_VECTOR_ARITHMETIC + #if !defined(ARM_MATH_NEON_FLOAT16) + #define ARM_MATH_NEON_FLOAT16 + #endif + #endif #endif #if !defined(ARM_MATH_AUTOVECTORIZE) + #if defined(__ARM_FEATURE_MVE) #if __ARM_FEATURE_MVE -#if !defined(ARM_MATH_MVEI) -#define ARM_MATH_MVEI -#endif + #if !defined(ARM_MATH_MVEI) + #define ARM_MATH_MVEI + #endif #endif -#if (__ARM_FEATURE_MVE & 2) -#if !defined(ARM_MATH_MVEF) -#define ARM_MATH_MVEF -#endif -#if !defined(ARM_MATH_MVE_FLOAT16) -#define ARM_MATH_MVE_FLOAT16 -#endif +#if defined(__ARM_FEATURE_MVE) && (__ARM_FEATURE_MVE & 2) + #if !defined(ARM_MATH_MVEF) + #define ARM_MATH_MVEF + #endif + #if !defined(ARM_MATH_MVE_FLOAT16) + #define ARM_MATH_MVE_FLOAT16 + #endif #endif -#endif /*defined(__ARM_FEATURE_MVE)*/ -#endif /*!defined(ARM_MATH_AUTOVECTORIZE)*/ +#endif /* defined (__ARM_FEATURE_MVE) */ +#endif /* !defined (ARM_MATH_AUTOVECTORIZE) */ -#if defined(ARM_MATH_HELIUM) -#if !defined(ARM_MATH_MVEF) -#define ARM_MATH_MVEF -#endif -#if !defined(ARM_MATH_MVEI) -#define ARM_MATH_MVEI -#endif +#if defined (ARM_MATH_HELIUM) + #if !defined(ARM_MATH_MVEF) + #define ARM_MATH_MVEF + #endif -#if !defined(ARM_MATH_MVE_FLOAT16) -#define ARM_MATH_MVE_FLOAT16 -#endif -#endif + #if !defined(ARM_MATH_MVEI) + #define ARM_MATH_MVEI + #endif -#if defined(__CC_ARM) -/* Enter low optimization region - place directly above function definition */ -#if defined(__ARM_ARCH_7EM__) -#define LOW_OPTIMIZATION_ENTER _Pragma("push") _Pragma("O1") -#else -#define LOW_OPTIMIZATION_ENTER + #if !defined(ARM_MATH_MVE_FLOAT16) + #define ARM_MATH_MVE_FLOAT16 + #endif #endif -/* Exit low optimization region - place directly after end of function definition */ -#if defined(__ARM_ARCH_7EM__) -#define LOW_OPTIMIZATION_EXIT _Pragma("pop") -#else -#define LOW_OPTIMIZATION_EXIT -#endif -/* Enter low optimization region - place directly above function definition */ -#define IAR_ONLY_LOW_OPTIMIZATION_ENTER - -/* Exit low optimization region - place directly after end of function definition */ -#define IAR_ONLY_LOW_OPTIMIZATION_EXIT - -#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) -#define LOW_OPTIMIZATION_ENTER -#define LOW_OPTIMIZATION_EXIT -#define IAR_ONLY_LOW_OPTIMIZATION_ENTER -#define IAR_ONLY_LOW_OPTIMIZATION_EXIT - -#elif defined(__APPLE_CC__) -#define LOW_OPTIMIZATION_ENTER -#define LOW_OPTIMIZATION_EXIT -#define IAR_ONLY_LOW_OPTIMIZATION_ENTER -#define IAR_ONLY_LOW_OPTIMIZATION_EXIT - -#elif defined(__GNUC__) -#define LOW_OPTIMIZATION_ENTER __attribute__((optimize("-O1"))) -#define LOW_OPTIMIZATION_EXIT -#define IAR_ONLY_LOW_OPTIMIZATION_ENTER -#define IAR_ONLY_LOW_OPTIMIZATION_EXIT - -#elif defined(__ICCARM__) -/* Enter low optimization region - place directly above function definition */ -#if defined(__ARM_ARCH_7EM__) -#define LOW_OPTIMIZATION_ENTER _Pragma("optimize=low") -#else -#define LOW_OPTIMIZATION_ENTER -#endif -/* Exit low optimization region - place directly after end of function definition */ -#define LOW_OPTIMIZATION_EXIT - -/* Enter low optimization region - place directly above function definition */ -#if defined(__ARM_ARCH_7EM__) -#define IAR_ONLY_LOW_OPTIMIZATION_ENTER _Pragma("optimize=low") -#else -#define IAR_ONLY_LOW_OPTIMIZATION_ENTER +#if defined ( __CC_ARM ) + /* Enter low optimization region - place directly above function definition */ + #if defined( __ARM_ARCH_7EM__ ) + #define LOW_OPTIMIZATION_ENTER \ + _Pragma ("push") \ + _Pragma ("O1") + #else + #define LOW_OPTIMIZATION_ENTER + #endif + + /* Exit low optimization region - place directly after end of function definition */ + #if defined ( __ARM_ARCH_7EM__ ) + #define LOW_OPTIMIZATION_EXIT \ + _Pragma ("pop") + #else + #define LOW_OPTIMIZATION_EXIT + #endif + + /* Enter low optimization region - place directly above function definition */ + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + + /* Exit low optimization region - place directly after end of function definition */ + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined (__ARMCC_VERSION ) && ( __ARMCC_VERSION >= 6010050 ) + #define LOW_OPTIMIZATION_ENTER + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined ( __APPLE_CC__ ) + #define LOW_OPTIMIZATION_ENTER + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined ( __GNUC__ ) + #define LOW_OPTIMIZATION_ENTER \ + __attribute__(( optimize("-O1") )) + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined ( __ICCARM__ ) + /* Enter low optimization region - place directly above function definition */ + #if defined ( __ARM_ARCH_7EM__ ) + #define LOW_OPTIMIZATION_ENTER \ + _Pragma ("optimize=low") + #else + #define LOW_OPTIMIZATION_ENTER + #endif + + /* Exit low optimization region - place directly after end of function definition */ + #define LOW_OPTIMIZATION_EXIT + + /* Enter low optimization region - place directly above function definition */ + #if defined ( __ARM_ARCH_7EM__ ) + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER \ + _Pragma ("optimize=low") + #else + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #endif + + /* Exit low optimization region - place directly after end of function definition */ + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined ( __TI_ARM__ ) + #define LOW_OPTIMIZATION_ENTER + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined ( __CSMC__ ) + #define LOW_OPTIMIZATION_ENTER + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined ( __TASKING__ ) + #define LOW_OPTIMIZATION_ENTER + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT + +#elif defined ( _MSC_VER ) || defined(__GNUC_PYTHON__) + #define LOW_OPTIMIZATION_ENTER + #define LOW_OPTIMIZATION_EXIT + #define IAR_ONLY_LOW_OPTIMIZATION_ENTER + #define IAR_ONLY_LOW_OPTIMIZATION_EXIT #endif -/* Exit low optimization region - place directly after end of function definition */ -#define IAR_ONLY_LOW_OPTIMIZATION_EXIT - -#elif defined(__TI_ARM__) -#define LOW_OPTIMIZATION_ENTER -#define LOW_OPTIMIZATION_EXIT -#define IAR_ONLY_LOW_OPTIMIZATION_ENTER -#define IAR_ONLY_LOW_OPTIMIZATION_EXIT - -#elif defined(__CSMC__) -#define LOW_OPTIMIZATION_ENTER -#define LOW_OPTIMIZATION_EXIT -#define IAR_ONLY_LOW_OPTIMIZATION_ENTER -#define IAR_ONLY_LOW_OPTIMIZATION_EXIT - -#elif defined(__TASKING__) -#define LOW_OPTIMIZATION_ENTER -#define LOW_OPTIMIZATION_EXIT -#define IAR_ONLY_LOW_OPTIMIZATION_ENTER -#define IAR_ONLY_LOW_OPTIMIZATION_EXIT - -#elif defined(_MSC_VER) || defined(__GNUC_PYTHON__) -#define LOW_OPTIMIZATION_ENTER -#define LOW_OPTIMIZATION_EXIT -#define IAR_ONLY_LOW_OPTIMIZATION_ENTER -#define IAR_ONLY_LOW_OPTIMIZATION_EXIT -#endif + /* Compiler specific diagnostic adjustment */ -#if defined(__CC_ARM) +#if defined ( __CC_ARM ) -#elif defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050) +#elif defined ( __ARMCC_VERSION ) && ( __ARMCC_VERSION >= 6010050 ) -#elif defined(__APPLE_CC__) +#elif defined ( __APPLE_CC__ ) -#elif defined(__GNUC__) +#elif defined ( __GNUC__ ) #pragma GCC diagnostic pop -#elif defined(__ICCARM__) +#elif defined ( __ICCARM__ ) -#elif defined(__TI_ARM__) +#elif defined ( __TI_ARM__ ) -#elif defined(__CSMC__) +#elif defined ( __CSMC__ ) -#elif defined(__TASKING__) +#elif defined ( __TASKING__ ) -#elif defined(_MSC_VER) +#elif defined ( _MSC_VER ) #else -#error Unknown compiler + #error Unknown compiler #endif -#ifdef __cplusplus +#ifdef __cplusplus } #endif @@ -255,326 +293,352 @@ extern "C" { #include #endif -#ifdef __cplusplus -extern "C" { +#if defined(ARM_DSP_CONFIG_TABLES) +#error("-DARM_DSP_CONFIG_TABLES no more supported. Use the new initialization functions to let the linker optimize the code size.") +#endif + +#ifdef __cplusplus +extern "C" +{ #endif /** + * @defgroup genericTypes Generic Types + * @{ +*/ + + /** * @brief 8-bit fractional data type in 1.7 format. */ -typedef int8_t q7_t; + typedef int8_t q7_t; -/** + /** * @brief 16-bit fractional data type in 1.15 format. */ -typedef int16_t q15_t; + typedef int16_t q15_t; -/** + /** * @brief 32-bit fractional data type in 1.31 format. */ -typedef int32_t q31_t; + typedef int32_t q31_t; -/** + /** * @brief 64-bit fractional data type in 1.63 format. */ -typedef int64_t q63_t; + typedef int64_t q63_t; -/** + /** * @brief 32-bit floating-point type definition. */ #if !defined(__ICCARM__) || !(__ARM_FEATURE_MVE & 2) -typedef float float32_t; + typedef float float32_t; #endif -/** + /** * @brief 64-bit floating-point type definition. */ -typedef double float64_t; + typedef double float64_t; -/** + /** * @brief vector types */ -#if defined(ARM_MATH_NEON) || (defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE)) -/** +#if defined(ARM_MATH_NEON) || (defined (ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE)) + + /** * @brief 64-bit fractional 128-bit vector data type in 1.63 format */ -typedef int64x2_t q63x2_t; + typedef int64x2_t q63x2_t; -/** + /** * @brief 32-bit fractional 128-bit vector data type in 1.31 format. */ -typedef int32x4_t q31x4_t; + typedef int32x4_t q31x4_t; -/** + /** * @brief 16-bit fractional 128-bit vector data type with 16-bit alignment in 1.15 format. */ -typedef __ALIGNED(2) int16x8_t q15x8_t; + typedef __ALIGNED(2) int16x8_t q15x8_t; -/** + /** * @brief 8-bit fractional 128-bit vector data type with 8-bit alignment in 1.7 format. */ -typedef __ALIGNED(1) int8x16_t q7x16_t; + typedef __ALIGNED(1) int8x16_t q7x16_t; -/** + /** * @brief 32-bit fractional 128-bit vector pair data type in 1.31 format. */ -typedef int32x4x2_t q31x4x2_t; + typedef int32x4x2_t q31x4x2_t; -/** + /** * @brief 32-bit fractional 128-bit vector quadruplet data type in 1.31 format. */ -typedef int32x4x4_t q31x4x4_t; + typedef int32x4x4_t q31x4x4_t; -/** + /** * @brief 16-bit fractional 128-bit vector pair data type in 1.15 format. */ -typedef int16x8x2_t q15x8x2_t; + typedef int16x8x2_t q15x8x2_t; -/** + /** * @brief 16-bit fractional 128-bit vector quadruplet data type in 1.15 format. */ -typedef int16x8x4_t q15x8x4_t; + typedef int16x8x4_t q15x8x4_t; -/** + /** * @brief 8-bit fractional 128-bit vector pair data type in 1.7 format. */ -typedef int8x16x2_t q7x16x2_t; + typedef int8x16x2_t q7x16x2_t; -/** + /** * @brief 8-bit fractional 128-bit vector quadruplet data type in 1.7 format. */ -typedef int8x16x4_t q7x16x4_t; + typedef int8x16x4_t q7x16x4_t; -/** + /** * @brief 32-bit fractional data type in 9.23 format. */ -typedef int32_t q23_t; + typedef int32_t q23_t; -/** + /** * @brief 32-bit fractional 128-bit vector data type in 9.23 format. */ -typedef int32x4_t q23x4_t; + typedef int32x4_t q23x4_t; -/** + /** * @brief 64-bit status 128-bit vector data type. */ -typedef int64x2_t status64x2_t; + typedef int64x2_t status64x2_t; -/** + /** * @brief 32-bit status 128-bit vector data type. */ -typedef int32x4_t status32x4_t; + typedef int32x4_t status32x4_t; -/** + /** * @brief 16-bit status 128-bit vector data type. */ -typedef int16x8_t status16x8_t; + typedef int16x8_t status16x8_t; -/** + /** * @brief 8-bit status 128-bit vector data type. */ -typedef int8x16_t status8x16_t; + typedef int8x16_t status8x16_t; + #endif -#if defined(ARM_MATH_NEON) || \ - (defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE)) /* floating point vector*/ -/** +#if defined(ARM_MATH_NEON) || (defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE)) /* floating point vector*/ + + /** * @brief 32-bit floating-point 128-bit vector type */ -typedef float32x4_t f32x4_t; + typedef float32x4_t f32x4_t; -/** + /** * @brief 32-bit floating-point 128-bit vector pair data type */ -typedef float32x4x2_t f32x4x2_t; + typedef float32x4x2_t f32x4x2_t; -/** + /** * @brief 32-bit floating-point 128-bit vector quadruplet data type */ -typedef float32x4x4_t f32x4x4_t; + typedef float32x4x4_t f32x4x4_t; -/** + /** * @brief 32-bit ubiquitous 128-bit vector data type */ -typedef union _any32x4_t { - float32x4_t f; - int32x4_t i; -} any32x4_t; + typedef union _any32x4_t + { + float32x4_t f; + int32x4_t i; + } any32x4_t; #endif #if defined(ARM_MATH_NEON) -/** + /** * @brief 32-bit fractional 64-bit vector data type in 1.31 format. */ -typedef int32x2_t q31x2_t; + typedef int32x2_t q31x2_t; -/** + /** * @brief 16-bit fractional 64-bit vector data type in 1.15 format. */ -typedef __ALIGNED(2) int16x4_t q15x4_t; + typedef __ALIGNED(2) int16x4_t q15x4_t; -/** + /** * @brief 8-bit fractional 64-bit vector data type in 1.7 format. */ -typedef __ALIGNED(1) int8x8_t q7x8_t; + typedef __ALIGNED(1) int8x8_t q7x8_t; -/** + /** * @brief 32-bit float 64-bit vector data type. */ -typedef float32x2_t f32x2_t; + typedef float32x2_t f32x2_t; -/** + /** * @brief 32-bit floating-point 128-bit vector triplet data type */ -typedef float32x4x3_t f32x4x3_t; + typedef float32x4x3_t f32x4x3_t; -/** + /** * @brief 32-bit fractional 128-bit vector triplet data type in 1.31 format */ -typedef int32x4x3_t q31x4x3_t; + typedef int32x4x3_t q31x4x3_t; -/** + /** * @brief 16-bit fractional 128-bit vector triplet data type in 1.15 format */ -typedef int16x8x3_t q15x8x3_t; + typedef int16x8x3_t q15x8x3_t; -/** + /** * @brief 8-bit fractional 128-bit vector triplet data type in 1.7 format */ -typedef int8x16x3_t q7x16x3_t; + typedef int8x16x3_t q7x16x3_t; -/** + /** * @brief 32-bit floating-point 64-bit vector pair data type */ -typedef float32x2x2_t f32x2x2_t; + typedef float32x2x2_t f32x2x2_t; -/** + /** * @brief 32-bit floating-point 64-bit vector triplet data type */ -typedef float32x2x3_t f32x2x3_t; + typedef float32x2x3_t f32x2x3_t; -/** + /** * @brief 32-bit floating-point 64-bit vector quadruplet data type */ -typedef float32x2x4_t f32x2x4_t; + typedef float32x2x4_t f32x2x4_t; -/** + /** * @brief 32-bit fractional 64-bit vector pair data type in 1.31 format */ -typedef int32x2x2_t q31x2x2_t; + typedef int32x2x2_t q31x2x2_t; -/** + /** * @brief 32-bit fractional 64-bit vector triplet data type in 1.31 format */ -typedef int32x2x3_t q31x2x3_t; + typedef int32x2x3_t q31x2x3_t; -/** + /** * @brief 32-bit fractional 64-bit vector quadruplet data type in 1.31 format */ -typedef int32x4x3_t q31x2x4_t; + typedef int32x4x3_t q31x2x4_t; -/** + /** * @brief 16-bit fractional 64-bit vector pair data type in 1.15 format */ -typedef int16x4x2_t q15x4x2_t; + typedef int16x4x2_t q15x4x2_t; -/** + /** * @brief 16-bit fractional 64-bit vector triplet data type in 1.15 format */ -typedef int16x4x2_t q15x4x3_t; + typedef int16x4x2_t q15x4x3_t; -/** + /** * @brief 16-bit fractional 64-bit vector quadruplet data type in 1.15 format */ -typedef int16x4x3_t q15x4x4_t; + typedef int16x4x3_t q15x4x4_t; -/** + /** * @brief 8-bit fractional 64-bit vector pair data type in 1.7 format */ -typedef int8x8x2_t q7x8x2_t; + typedef int8x8x2_t q7x8x2_t; -/** + /** * @brief 8-bit fractional 64-bit vector triplet data type in 1.7 format */ -typedef int8x8x3_t q7x8x3_t; + typedef int8x8x3_t q7x8x3_t; -/** + /** * @brief 8-bit fractional 64-bit vector quadruplet data type in 1.7 format */ -typedef int8x8x4_t q7x8x4_t; + typedef int8x8x4_t q7x8x4_t; -/** + /** * @brief 32-bit ubiquitous 64-bit vector data type */ -typedef union _any32x2_t { - float32x2_t f; - int32x2_t i; -} any32x2_t; + typedef union _any32x2_t + { + float32x2_t f; + int32x2_t i; + } any32x2_t; -/** + /** * @brief 32-bit status 64-bit vector data type. */ -typedef int32x4_t status32x2_t; + typedef int32x4_t status32x2_t; -/** + /** * @brief 16-bit status 64-bit vector data type. */ -typedef int16x8_t status16x4_t; + typedef int16x8_t status16x4_t; -/** + /** * @brief 8-bit status 64-bit vector data type. */ -typedef int8x16_t status8x8_t; + typedef int8x16_t status8x8_t; #endif -#define F64_MAX ((float64_t)DBL_MAX) -#define F32_MAX ((float32_t)FLT_MAX) + /** + * @brief Error status returned by some functions in the library. + */ + typedef enum + { + ARM_MATH_SUCCESS = 0, /**< No error */ + ARM_MATH_ARGUMENT_ERROR = -1, /**< One or more arguments are incorrect */ + ARM_MATH_LENGTH_ERROR = -2, /**< Length of data buffer is incorrect */ + ARM_MATH_SIZE_MISMATCH = -3, /**< Size of matrices is not compatible with the operation */ + ARM_MATH_NANINF = -4, /**< Not-a-number (NaN) or infinity is generated */ + ARM_MATH_SINGULAR = -5, /**< Input matrix is singular and cannot be inverted */ + ARM_MATH_TEST_FAILURE = -6, /**< Test Failed */ + ARM_MATH_DECOMPOSITION_FAILURE = -7 /**< Decomposition Failed */ + } arm_status; -#define F64_MIN (-DBL_MAX) -#define F32_MIN (-FLT_MAX) +/** + * @} // endgroup generic +*/ -#define F64_ABSMAX ((float64_t)DBL_MAX) -#define F32_ABSMAX ((float32_t)FLT_MAX) -#define F64_ABSMIN ((float64_t)0.0) -#define F32_ABSMIN ((float32_t)0.0) +#define F64_MAX ((float64_t)DBL_MAX) +#define F32_MAX ((float32_t)FLT_MAX) -#define Q31_MAX ((q31_t)(0x7FFFFFFFL)) -#define Q15_MAX ((q15_t)(0x7FFF)) -#define Q7_MAX ((q7_t)(0x7F)) -#define Q31_MIN ((q31_t)(0x80000000L)) -#define Q15_MIN ((q15_t)(0x8000)) -#define Q7_MIN ((q7_t)(0x80)) -#define Q31_ABSMAX ((q31_t)(0x7FFFFFFFL)) -#define Q15_ABSMAX ((q15_t)(0x7FFF)) -#define Q7_ABSMAX ((q7_t)(0x7F)) -#define Q31_ABSMIN ((q31_t)0) -#define Q15_ABSMIN ((q15_t)0) -#define Q7_ABSMIN ((q7_t)0) -/* Dimension C vector space */ -#define CMPLX_DIM 2 +#define F64_MIN (-DBL_MAX) +#define F32_MIN (-FLT_MAX) -/** - * @brief Error status returned by some functions in the library. - */ -typedef enum { - ARM_MATH_SUCCESS = 0, /**< No error */ - ARM_MATH_ARGUMENT_ERROR = -1, /**< One or more arguments are incorrect */ - ARM_MATH_LENGTH_ERROR = -2, /**< Length of data buffer is incorrect */ - ARM_MATH_SIZE_MISMATCH = -3, /**< Size of matrices is not compatible with the operation */ - ARM_MATH_NANINF = -4, /**< Not-a-number (NaN) or infinity is generated */ - ARM_MATH_SINGULAR = -5, /**< Input matrix is singular and cannot be inverted */ - ARM_MATH_TEST_FAILURE = -6, /**< Test Failed */ - ARM_MATH_DECOMPOSITION_FAILURE = -7 /**< Decomposition Failed */ -} arm_status; -#ifdef __cplusplus +#define F64_ABSMAX ((float64_t)DBL_MAX) +#define F32_ABSMAX ((float32_t)FLT_MAX) + + + +#define F64_ABSMIN ((float64_t)0.0) +#define F32_ABSMIN ((float32_t)0.0) + + +#define Q31_MAX ((q31_t)(0x7FFFFFFFL)) +#define Q15_MAX ((q15_t)(0x7FFF)) +#define Q7_MAX ((q7_t)(0x7F)) +#define Q31_MIN ((q31_t)(0x80000000L)) +#define Q15_MIN ((q15_t)(0x8000)) +#define Q7_MIN ((q7_t)(0x80)) + +#define Q31_ABSMAX ((q31_t)(0x7FFFFFFFL)) +#define Q15_ABSMAX ((q15_t)(0x7FFF)) +#define Q7_ABSMAX ((q7_t)(0x7F)) +#define Q31_ABSMIN ((q31_t)0) +#define Q15_ABSMIN ((q15_t)0) +#define Q7_ABSMIN ((q7_t)0) + + /* Dimension C vector space */ + #define CMPLX_DIM 2 + +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types_f16.h old mode 100644 new mode 100755 index 882dd01c8bb..26b8feeec9c --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types_f16.h @@ -23,16 +23,17 @@ * limitations under the License. */ -#ifndef _ARM_MATH_TYPES_F16_H -#define _ARM_MATH_TYPES_F16_H +#ifndef ARM_MATH_TYPES_F16_H +#define ARM_MATH_TYPES_F16_H #include "arm_math_types.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif -#if !defined(__CC_ARM) +#if !defined( __CC_ARM ) /** * @brief 16-bit floating-point type definition. @@ -48,93 +49,97 @@ If it is not available, f16 version of the kernels won't be built. */ -#if !(__ARM_FEATURE_MVE & 2) -#if !defined(DISABLEFLOAT16) -#if defined(__ARM_FP16_FORMAT_IEEE) || defined(__ARM_FP16_FORMAT_ALTERNATIVE) -typedef __fp16 float16_t; -#define ARM_FLOAT16_SUPPORTED -#endif -#endif -#else +#if defined(__ARM_FEATURE_MVE) && (__ARM_FEATURE_MVE & 2) /* When Vector float16, this flag is always defined and can't be disabled */ -#define ARM_FLOAT16_SUPPORTED + #define ARM_FLOAT16_SUPPORTED +#else + #if !defined(DISABLEFLOAT16) + #if defined(__ARM_FP16_FORMAT_IEEE) || defined(__ARM_FP16_FORMAT_ALTERNATIVE) + typedef __fp16 float16_t; + #define ARM_FLOAT16_SUPPORTED + #endif + #endif #endif -#if defined(ARM_MATH_NEON) || \ - (defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE)) /* floating point vector*/ +#if defined(ARM_MATH_NEON) || (defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE)) /* floating point vector*/ #if defined(ARM_MATH_MVE_FLOAT16) || defined(ARM_MATH_NEON_FLOAT16) -/** + /** * @brief 16-bit floating-point 128-bit vector data type */ -typedef __ALIGNED(2) float16x8_t f16x8_t; + typedef __ALIGNED(2) float16x8_t f16x8_t; -/** + /** * @brief 16-bit floating-point 128-bit vector pair data type */ -typedef float16x8x2_t f16x8x2_t; + typedef float16x8x2_t f16x8x2_t; -/** + /** * @brief 16-bit floating-point 128-bit vector quadruplet data type */ -typedef float16x8x4_t f16x8x4_t; + typedef float16x8x4_t f16x8x4_t; -/** + /** * @brief 16-bit ubiquitous 128-bit vector data type */ -typedef union _any16x8_t { - float16x8_t f; - int16x8_t i; -} any16x8_t; + typedef union _any16x8_t + { + float16x8_t f; + int16x8_t i; + } any16x8_t; #endif #endif #if defined(ARM_MATH_NEON) + #if defined(ARM_MATH_NEON_FLOAT16) -/** + /** * @brief 16-bit float 64-bit vector data type. */ -typedef __ALIGNED(2) float16x4_t f16x4_t; + typedef __ALIGNED(2) float16x4_t f16x4_t; -/** + /** * @brief 16-bit floating-point 128-bit vector triplet data type */ -typedef float16x8x3_t f16x8x3_t; + typedef float16x8x3_t f16x8x3_t; -/** + /** * @brief 16-bit floating-point 64-bit vector pair data type */ -typedef float16x4x2_t f16x4x2_t; + typedef float16x4x2_t f16x4x2_t; -/** + /** * @brief 16-bit floating-point 64-bit vector triplet data type */ -typedef float16x4x3_t f16x4x3_t; + typedef float16x4x3_t f16x4x3_t; -/** + /** * @brief 16-bit floating-point 64-bit vector quadruplet data type */ -typedef float16x4x4_t f16x4x4_t; + typedef float16x4x4_t f16x4x4_t; -/** + /** * @brief 16-bit ubiquitous 64-bit vector data type */ -typedef union _any16x4_t { - float16x4_t f; - int16x4_t i; -} any16x4_t; + typedef union _any16x4_t + { + float16x4_t f; + int16x4_t i; + } any16x4_t; #endif #endif + + #if defined(ARM_FLOAT16_SUPPORTED) #if defined(__ICCARM__) -#define F16INFINITY ((float16_t)INFINITY) +#define F16INFINITY ((float16_t) INFINITY) #else @@ -142,16 +147,16 @@ typedef union _any16x4_t { #endif -#define F16_MAX ((float16_t)__FLT16_MAX__) -#define F16_MIN (-(_Float16)__FLT16_MAX__) +#define F16_MAX ((float16_t)__FLT16_MAX__) +#define F16_MIN (-(_Float16)__FLT16_MAX__) -#define F16_ABSMAX ((float16_t)__FLT16_MAX__) -#define F16_ABSMIN ((float16_t)0.0f16) +#define F16_ABSMAX ((float16_t)__FLT16_MAX__) +#define F16_ABSMIN ((float16_t)0.0f16) #endif /* ARM_FLOAT16_SUPPORTED*/ #endif /* !defined( __CC_ARM ) */ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables.h old mode 100644 new mode 100755 index 742674174bb..aa58d7a92c6 --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables.h @@ -27,206 +27,167 @@ * limitations under the License. */ -#ifndef _ARM_MVE_TABLES_H -#define _ARM_MVE_TABLES_H + #ifndef ARM_MVE_TABLES_H + #define ARM_MVE_TABLES_H #include "arm_math_types.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif + + + #if defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE) -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FFT_ALLOW_TABLES) -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_16) || defined(ARM_TABLE_TWIDDLECOEF_F32_32) -extern uint32_t rearranged_twiddle_tab_stride1_arr_16_f32[2]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_16_f32[2]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_16_f32[2]; -extern float32_t rearranged_twiddle_stride1_16_f32[8]; -extern float32_t rearranged_twiddle_stride2_16_f32[8]; -extern float32_t rearranged_twiddle_stride3_16_f32[8]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_16_f32[2]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_16_f32[2]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_16_f32[2]; +extern const float32_t rearranged_twiddle_stride1_16_f32[8]; +extern const float32_t rearranged_twiddle_stride2_16_f32[8]; +extern const float32_t rearranged_twiddle_stride3_16_f32[8]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_64) || defined(ARM_TABLE_TWIDDLECOEF_F32_128) -extern uint32_t rearranged_twiddle_tab_stride1_arr_64_f32[3]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_64_f32[3]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_64_f32[3]; -extern float32_t rearranged_twiddle_stride1_64_f32[40]; -extern float32_t rearranged_twiddle_stride2_64_f32[40]; -extern float32_t rearranged_twiddle_stride3_64_f32[40]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_64_f32[3]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_64_f32[3]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_64_f32[3]; +extern const float32_t rearranged_twiddle_stride1_64_f32[40]; +extern const float32_t rearranged_twiddle_stride2_64_f32[40]; +extern const float32_t rearranged_twiddle_stride3_64_f32[40]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_256) || defined(ARM_TABLE_TWIDDLECOEF_F32_512) -extern uint32_t rearranged_twiddle_tab_stride1_arr_256_f32[4]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_256_f32[4]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_256_f32[4]; -extern float32_t rearranged_twiddle_stride1_256_f32[168]; -extern float32_t rearranged_twiddle_stride2_256_f32[168]; -extern float32_t rearranged_twiddle_stride3_256_f32[168]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_256_f32[4]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_256_f32[4]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_256_f32[4]; +extern const float32_t rearranged_twiddle_stride1_256_f32[168]; +extern const float32_t rearranged_twiddle_stride2_256_f32[168]; +extern const float32_t rearranged_twiddle_stride3_256_f32[168]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_1024) || defined(ARM_TABLE_TWIDDLECOEF_F32_2048) -extern uint32_t rearranged_twiddle_tab_stride1_arr_1024_f32[5]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_1024_f32[5]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_1024_f32[5]; -extern float32_t rearranged_twiddle_stride1_1024_f32[680]; -extern float32_t rearranged_twiddle_stride2_1024_f32[680]; -extern float32_t rearranged_twiddle_stride3_1024_f32[680]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_1024_f32[5]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_1024_f32[5]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_1024_f32[5]; +extern const float32_t rearranged_twiddle_stride1_1024_f32[680]; +extern const float32_t rearranged_twiddle_stride2_1024_f32[680]; +extern const float32_t rearranged_twiddle_stride3_1024_f32[680]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F32_4096) || defined(ARM_TABLE_TWIDDLECOEF_F32_8192) -extern uint32_t rearranged_twiddle_tab_stride1_arr_4096_f32[6]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_4096_f32[6]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_4096_f32[6]; -extern float32_t rearranged_twiddle_stride1_4096_f32[2728]; -extern float32_t rearranged_twiddle_stride2_4096_f32[2728]; -extern float32_t rearranged_twiddle_stride3_4096_f32[2728]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_4096_f32[6]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_4096_f32[6]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_4096_f32[6]; +extern const float32_t rearranged_twiddle_stride1_4096_f32[2728]; +extern const float32_t rearranged_twiddle_stride2_4096_f32[2728]; +extern const float32_t rearranged_twiddle_stride3_4096_f32[2728]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FFT_ALLOW_TABLES) */ #endif /* defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE) */ -#if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE) -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FFT_ALLOW_TABLES) -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_16) || defined(ARM_TABLE_TWIDDLECOEF_Q31_32) +#if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE) -extern uint32_t rearranged_twiddle_tab_stride1_arr_16_q31[2]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_16_q31[2]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_16_q31[2]; -extern q31_t rearranged_twiddle_stride1_16_q31[8]; -extern q31_t rearranged_twiddle_stride2_16_q31[8]; -extern q31_t rearranged_twiddle_stride3_16_q31[8]; -#endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_64) || defined(ARM_TABLE_TWIDDLECOEF_Q31_128) -extern uint32_t rearranged_twiddle_tab_stride1_arr_64_q31[3]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_64_q31[3]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_64_q31[3]; -extern q31_t rearranged_twiddle_stride1_64_q31[40]; -extern q31_t rearranged_twiddle_stride2_64_q31[40]; -extern q31_t rearranged_twiddle_stride3_64_q31[40]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_16_q31[2]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_16_q31[2]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_16_q31[2]; +extern const q31_t rearranged_twiddle_stride1_16_q31[8]; +extern const q31_t rearranged_twiddle_stride2_16_q31[8]; +extern const q31_t rearranged_twiddle_stride3_16_q31[8]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_256) || defined(ARM_TABLE_TWIDDLECOEF_Q31_512) -extern uint32_t rearranged_twiddle_tab_stride1_arr_256_q31[4]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_256_q31[4]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_256_q31[4]; -extern q31_t rearranged_twiddle_stride1_256_q31[168]; -extern q31_t rearranged_twiddle_stride2_256_q31[168]; -extern q31_t rearranged_twiddle_stride3_256_q31[168]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_64_q31[3]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_64_q31[3]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_64_q31[3]; +extern const q31_t rearranged_twiddle_stride1_64_q31[40]; +extern const q31_t rearranged_twiddle_stride2_64_q31[40]; +extern const q31_t rearranged_twiddle_stride3_64_q31[40]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_1024) || defined(ARM_TABLE_TWIDDLECOEF_Q31_2048) -extern uint32_t rearranged_twiddle_tab_stride1_arr_1024_q31[5]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_1024_q31[5]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_1024_q31[5]; -extern q31_t rearranged_twiddle_stride1_1024_q31[680]; -extern q31_t rearranged_twiddle_stride2_1024_q31[680]; -extern q31_t rearranged_twiddle_stride3_1024_q31[680]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_256_q31[4]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_256_q31[4]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_256_q31[4]; +extern const q31_t rearranged_twiddle_stride1_256_q31[168]; +extern const q31_t rearranged_twiddle_stride2_256_q31[168]; +extern const q31_t rearranged_twiddle_stride3_256_q31[168]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q31_4096) || defined(ARM_TABLE_TWIDDLECOEF_Q31_8192) -extern uint32_t rearranged_twiddle_tab_stride1_arr_4096_q31[6]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_4096_q31[6]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_4096_q31[6]; -extern q31_t rearranged_twiddle_stride1_4096_q31[2728]; -extern q31_t rearranged_twiddle_stride2_4096_q31[2728]; -extern q31_t rearranged_twiddle_stride3_4096_q31[2728]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_1024_q31[5]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_1024_q31[5]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_1024_q31[5]; +extern const q31_t rearranged_twiddle_stride1_1024_q31[680]; +extern const q31_t rearranged_twiddle_stride2_1024_q31[680]; +extern const q31_t rearranged_twiddle_stride3_1024_q31[680]; + + +extern const uint32_t rearranged_twiddle_tab_stride1_arr_4096_q31[6]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_4096_q31[6]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_4096_q31[6]; +extern const q31_t rearranged_twiddle_stride1_4096_q31[2728]; +extern const q31_t rearranged_twiddle_stride2_4096_q31[2728]; +extern const q31_t rearranged_twiddle_stride3_4096_q31[2728]; + -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FFT_ALLOW_TABLES) */ #endif /* defined(ARM_MATH_MVEI) */ -#if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE) -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FFT_ALLOW_TABLES) -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_16) || defined(ARM_TABLE_TWIDDLECOEF_Q15_32) +#if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE) -extern uint32_t rearranged_twiddle_tab_stride1_arr_16_q15[2]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_16_q15[2]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_16_q15[2]; -extern q15_t rearranged_twiddle_stride1_16_q15[8]; -extern q15_t rearranged_twiddle_stride2_16_q15[8]; -extern q15_t rearranged_twiddle_stride3_16_q15[8]; -#endif -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_64) || defined(ARM_TABLE_TWIDDLECOEF_Q15_128) -extern uint32_t rearranged_twiddle_tab_stride1_arr_64_q15[3]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_64_q15[3]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_64_q15[3]; -extern q15_t rearranged_twiddle_stride1_64_q15[40]; -extern q15_t rearranged_twiddle_stride2_64_q15[40]; -extern q15_t rearranged_twiddle_stride3_64_q15[40]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_16_q15[2]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_16_q15[2]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_16_q15[2]; +extern const q15_t rearranged_twiddle_stride1_16_q15[8]; +extern const q15_t rearranged_twiddle_stride2_16_q15[8]; +extern const q15_t rearranged_twiddle_stride3_16_q15[8]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_256) || defined(ARM_TABLE_TWIDDLECOEF_Q15_512) -extern uint32_t rearranged_twiddle_tab_stride1_arr_256_q15[4]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_256_q15[4]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_256_q15[4]; -extern q15_t rearranged_twiddle_stride1_256_q15[168]; -extern q15_t rearranged_twiddle_stride2_256_q15[168]; -extern q15_t rearranged_twiddle_stride3_256_q15[168]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_64_q15[3]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_64_q15[3]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_64_q15[3]; +extern const q15_t rearranged_twiddle_stride1_64_q15[40]; +extern const q15_t rearranged_twiddle_stride2_64_q15[40]; +extern const q15_t rearranged_twiddle_stride3_64_q15[40]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_1024) || defined(ARM_TABLE_TWIDDLECOEF_Q15_2048) -extern uint32_t rearranged_twiddle_tab_stride1_arr_1024_q15[5]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_1024_q15[5]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_1024_q15[5]; -extern q15_t rearranged_twiddle_stride1_1024_q15[680]; -extern q15_t rearranged_twiddle_stride2_1024_q15[680]; -extern q15_t rearranged_twiddle_stride3_1024_q15[680]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_256_q15[4]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_256_q15[4]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_256_q15[4]; +extern const q15_t rearranged_twiddle_stride1_256_q15[168]; +extern const q15_t rearranged_twiddle_stride2_256_q15[168]; +extern const q15_t rearranged_twiddle_stride3_256_q15[168]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_Q15_4096) || defined(ARM_TABLE_TWIDDLECOEF_Q15_8192) -extern uint32_t rearranged_twiddle_tab_stride1_arr_4096_q15[6]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_4096_q15[6]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_4096_q15[6]; -extern q15_t rearranged_twiddle_stride1_4096_q15[2728]; -extern q15_t rearranged_twiddle_stride2_4096_q15[2728]; -extern q15_t rearranged_twiddle_stride3_4096_q15[2728]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_1024_q15[5]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_1024_q15[5]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_1024_q15[5]; +extern const q15_t rearranged_twiddle_stride1_1024_q15[680]; +extern const q15_t rearranged_twiddle_stride2_1024_q15[680]; +extern const q15_t rearranged_twiddle_stride3_1024_q15[680]; + + +extern const uint32_t rearranged_twiddle_tab_stride1_arr_4096_q15[6]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_4096_q15[6]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_4096_q15[6]; +extern const q15_t rearranged_twiddle_stride1_4096_q15[2728]; +extern const q15_t rearranged_twiddle_stride2_4096_q15[2728]; +extern const q15_t rearranged_twiddle_stride3_4096_q15[2728]; -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FFT_ALLOW_TABLES) */ #endif /* defined(ARM_MATH_MVEI) */ -#ifdef __cplusplus + + +#ifdef __cplusplus } #endif #endif /*_ARM_MVE_TABLES_H*/ + diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables_f16.h old mode 100644 new mode 100755 index 474fedcb950..ae2824529a3 --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables_f16.h @@ -27,80 +27,71 @@ * limitations under the License. */ -#ifndef _ARM_MVE_TABLES_F16_H -#define _ARM_MVE_TABLES_F16_H + #ifndef ARM_MVE_TABLES_F16_H + #define ARM_MVE_TABLES_F16_H #include "arm_math_types_f16.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif + + + #if defined(ARM_MATH_MVE_FLOAT16) && !defined(ARM_MATH_AUTOVECTORIZE) -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FFT_ALLOW_TABLES) -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_16) || defined(ARM_TABLE_TWIDDLECOEF_F16_32) -extern uint32_t rearranged_twiddle_tab_stride1_arr_16_f16[2]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_16_f16[2]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_16_f16[2]; -extern float16_t rearranged_twiddle_stride1_16_f16[8]; -extern float16_t rearranged_twiddle_stride2_16_f16[8]; -extern float16_t rearranged_twiddle_stride3_16_f16[8]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_16_f16[2]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_16_f16[2]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_16_f16[2]; +extern const float16_t rearranged_twiddle_stride1_16_f16[8]; +extern const float16_t rearranged_twiddle_stride2_16_f16[8]; +extern const float16_t rearranged_twiddle_stride3_16_f16[8]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_64) || defined(ARM_TABLE_TWIDDLECOEF_F16_128) -extern uint32_t rearranged_twiddle_tab_stride1_arr_64_f16[3]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_64_f16[3]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_64_f16[3]; -extern float16_t rearranged_twiddle_stride1_64_f16[40]; -extern float16_t rearranged_twiddle_stride2_64_f16[40]; -extern float16_t rearranged_twiddle_stride3_64_f16[40]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_64_f16[3]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_64_f16[3]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_64_f16[3]; +extern const float16_t rearranged_twiddle_stride1_64_f16[40]; +extern const float16_t rearranged_twiddle_stride2_64_f16[40]; +extern const float16_t rearranged_twiddle_stride3_64_f16[40]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_256) || defined(ARM_TABLE_TWIDDLECOEF_F16_512) -extern uint32_t rearranged_twiddle_tab_stride1_arr_256_f16[4]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_256_f16[4]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_256_f16[4]; -extern float16_t rearranged_twiddle_stride1_256_f16[168]; -extern float16_t rearranged_twiddle_stride2_256_f16[168]; -extern float16_t rearranged_twiddle_stride3_256_f16[168]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_256_f16[4]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_256_f16[4]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_256_f16[4]; +extern const float16_t rearranged_twiddle_stride1_256_f16[168]; +extern const float16_t rearranged_twiddle_stride2_256_f16[168]; +extern const float16_t rearranged_twiddle_stride3_256_f16[168]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_1024) || defined(ARM_TABLE_TWIDDLECOEF_F16_2048) -extern uint32_t rearranged_twiddle_tab_stride1_arr_1024_f16[5]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_1024_f16[5]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_1024_f16[5]; -extern float16_t rearranged_twiddle_stride1_1024_f16[680]; -extern float16_t rearranged_twiddle_stride2_1024_f16[680]; -extern float16_t rearranged_twiddle_stride3_1024_f16[680]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_1024_f16[5]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_1024_f16[5]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_1024_f16[5]; +extern const float16_t rearranged_twiddle_stride1_1024_f16[680]; +extern const float16_t rearranged_twiddle_stride2_1024_f16[680]; +extern const float16_t rearranged_twiddle_stride3_1024_f16[680]; -#if !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_ALL_FFT_TABLES) || \ - defined(ARM_TABLE_TWIDDLECOEF_F16_4096) || defined(ARM_TABLE_TWIDDLECOEF_F16_8192) -extern uint32_t rearranged_twiddle_tab_stride1_arr_4096_f16[6]; -extern uint32_t rearranged_twiddle_tab_stride2_arr_4096_f16[6]; -extern uint32_t rearranged_twiddle_tab_stride3_arr_4096_f16[6]; -extern float16_t rearranged_twiddle_stride1_4096_f16[2728]; -extern float16_t rearranged_twiddle_stride2_4096_f16[2728]; -extern float16_t rearranged_twiddle_stride3_4096_f16[2728]; -#endif +extern const uint32_t rearranged_twiddle_tab_stride1_arr_4096_f16[6]; +extern const uint32_t rearranged_twiddle_tab_stride2_arr_4096_f16[6]; +extern const uint32_t rearranged_twiddle_tab_stride3_arr_4096_f16[6]; +extern const float16_t rearranged_twiddle_stride1_4096_f16[2728]; +extern const float16_t rearranged_twiddle_stride2_4096_f16[2728]; +extern const float16_t rearranged_twiddle_stride3_4096_f16[2728]; + -#endif /* !defined(ARM_DSP_CONFIG_TABLES) || defined(ARM_FFT_ALLOW_TABLES) */ #endif /* defined(ARM_MATH_MVE_FLOAT16) && !defined(ARM_MATH_AUTOVECTORIZE) */ -#ifdef __cplusplus + + +#ifdef __cplusplus } #endif #endif /*_ARM_MVE_TABLES_F16_H*/ + diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math.h old mode 100644 new mode 100755 index 0616db74dbc..ec90802e09b --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math.h @@ -23,30 +23,33 @@ * limitations under the License. */ -#ifndef _ARM_VEC_MATH_H -#define _ARM_VEC_MATH_H +#ifndef ARM_VEC_MATH_H +#define ARM_VEC_MATH_H #include "arm_math_types.h" #include "arm_common_tables.h" #include "arm_helium_utils.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #if (defined(ARM_MATH_MVEF) || defined(ARM_MATH_HELIUM)) && !defined(ARM_MATH_AUTOVECTORIZE) -#define INV_NEWTON_INIT_F32 0x7EF127EA +#define INV_NEWTON_INIT_F32 0x7EF127EA + +static const float32_t __logf_rng_f32=0.693147180f; -static const float32_t __logf_rng_f32 = 0.693147180f; /* fast inverse approximation (3x newton) */ -__STATIC_INLINE f32x4_t vrecip_medprec_f32(f32x4_t x) +__STATIC_INLINE f32x4_t vrecip_medprec_f32( + f32x4_t x) { - q31x4_t m; - f32x4_t b; - any32x4_t xinv; - f32x4_t ax = vabsq(x); + q31x4_t m; + f32x4_t b; + any32x4_t xinv; + f32x4_t ax = vabsq(x); xinv.f = ax; m = 0x3F800000 - (xinv.i & 0x7F800000); @@ -63,7 +66,7 @@ __STATIC_INLINE f32x4_t vrecip_medprec_f32(f32x4_t x) b = 2.0f - xinv.f * ax; xinv.f = xinv.f * b; - xinv.f = vdupq_m(xinv.f, INFINITY, vcmpeqq(x, 0.0f)); + xinv.f = vdupq_m(xinv.f, F32_MAX, vcmpeqq(x, 0.0f)); /* * restore sign */ @@ -73,12 +76,13 @@ __STATIC_INLINE f32x4_t vrecip_medprec_f32(f32x4_t x) } /* fast inverse approximation (4x newton) */ -__STATIC_INLINE f32x4_t vrecip_hiprec_f32(f32x4_t x) +__STATIC_INLINE f32x4_t vrecip_hiprec_f32( + f32x4_t x) { - q31x4_t m; - f32x4_t b; - any32x4_t xinv; - f32x4_t ax = vabsq(x); + q31x4_t m; + f32x4_t b; + any32x4_t xinv; + f32x4_t ax = vabsq(x); xinv.f = ax; @@ -99,7 +103,7 @@ __STATIC_INLINE f32x4_t vrecip_hiprec_f32(f32x4_t x) b = 2.0f - xinv.f * ax; xinv.f = xinv.f * b; - xinv.f = vdupq_m(xinv.f, INFINITY, vcmpeqq(x, 0.0f)); + xinv.f = vdupq_m(xinv.f, F32_MAX, vcmpeqq(x, 0.0f)); /* * restore sign */ @@ -108,7 +112,8 @@ __STATIC_INLINE f32x4_t vrecip_hiprec_f32(f32x4_t x) return xinv.f; } -__STATIC_INLINE f32x4_t vdiv_f32(f32x4_t num, f32x4_t den) +__STATIC_INLINE f32x4_t vdiv_f32( + f32x4_t num, f32x4_t den) { return vmulq(num, vrecip_hiprec_f32(den)); } @@ -120,23 +125,27 @@ __STATIC_INLINE f32x4_t vdiv_f32(f32x4_t num, f32x4_t den) @return destination f32 quad vector */ -__STATIC_INLINE f32x4_t vtaylor_polyq_f32(f32x4_t x, const float32_t *coeffs) +__STATIC_INLINE f32x4_t vtaylor_polyq_f32( + f32x4_t x, + const float32_t * coeffs) { - f32x4_t A = vfmasq(vdupq_n_f32(coeffs[4]), x, coeffs[0]); - f32x4_t B = vfmasq(vdupq_n_f32(coeffs[6]), x, coeffs[2]); - f32x4_t C = vfmasq(vdupq_n_f32(coeffs[5]), x, coeffs[1]); - f32x4_t D = vfmasq(vdupq_n_f32(coeffs[7]), x, coeffs[3]); - f32x4_t x2 = vmulq(x, x); - f32x4_t x4 = vmulq(x2, x2); - f32x4_t res = vfmaq(vfmaq_f32(A, B, x2), vfmaq_f32(C, D, x2), x4); + f32x4_t A = vfmasq(vdupq_n_f32(coeffs[4]), x, coeffs[0]); + f32x4_t B = vfmasq(vdupq_n_f32(coeffs[6]), x, coeffs[2]); + f32x4_t C = vfmasq(vdupq_n_f32(coeffs[5]), x, coeffs[1]); + f32x4_t D = vfmasq(vdupq_n_f32(coeffs[7]), x, coeffs[3]); + f32x4_t x2 = vmulq(x, x); + f32x4_t x4 = vmulq(x2, x2); + f32x4_t res = vfmaq(vfmaq_f32(A, B, x2), vfmaq_f32(C, D, x2), x4); return res; } -__STATIC_INLINE f32x4_t vmant_exp_f32(f32x4_t x, int32x4_t *e) +__STATIC_INLINE f32x4_t vmant_exp_f32( + f32x4_t x, + int32x4_t * e) { - any32x4_t r; - int32x4_t n; + any32x4_t r; + int32x4_t n; r.f = x; n = r.i >> 23; @@ -147,12 +156,13 @@ __STATIC_INLINE f32x4_t vmant_exp_f32(f32x4_t x, int32x4_t *e) return r.f; } + __STATIC_INLINE f32x4_t vlogq_f32(f32x4_t vecIn) { - q31x4_t vecExpUnBiased; - f32x4_t vecTmpFlt0, vecTmpFlt1; - f32x4_t vecAcc0, vecAcc1, vecAcc2, vecAcc3; - f32x4_t vecExpUnBiasedFlt; + q31x4_t vecExpUnBiased; + f32x4_t vecTmpFlt0, vecTmpFlt1; + f32x4_t vecAcc0, vecAcc1, vecAcc2, vecAcc3; + f32x4_t vecExpUnBiasedFlt; /* * extract exponent @@ -203,21 +213,22 @@ __STATIC_INLINE f32x4_t vlogq_f32(f32x4_t vecIn) */ vecAcc0 = vfmaq(vecAcc0, vecExpUnBiasedFlt, __logf_rng_f32); // set log0 down to -inf - vecAcc0 = vdupq_m(vecAcc0, -INFINITY, vcmpeqq(vecIn, 0.0f)); + vecAcc0 = vdupq_m(vecAcc0, -F32_MAX, vcmpeqq(vecIn, 0.0f)); return vecAcc0; } -__STATIC_INLINE f32x4_t vexpq_f32(f32x4_t x) +__STATIC_INLINE f32x4_t vexpq_f32( + f32x4_t x) { // Perform range reduction [-log(2),log(2)] - int32x4_t m = vcvtq_s32_f32(vmulq_n_f32(x, 1.4426950408f)); - f32x4_t val = vfmsq_f32(x, vcvtq_f32_s32(m), vdupq_n_f32(0.6931471805f)); + int32x4_t m = vcvtq_s32_f32(vmulq_n_f32(x, 1.4426950408f)); + f32x4_t val = vfmsq_f32(x, vcvtq_f32_s32(m), vdupq_n_f32(0.6931471805f)); // Polynomial Approximation - f32x4_t poly = vtaylor_polyq_f32(val, exp_tab); + f32x4_t poly = vtaylor_polyq_f32(val, exp_tab); // Reconstruct - poly = (f32x4_t)(vqaddq_s32((q31x4_t)(poly), vqshlq_n_s32(m, 23))); + poly = (f32x4_t) (vqaddq_s32((q31x4_t) (poly), vqshlq_n_s32(m, 23))); poly = vdupq_m(poly, 0.0f, vcmpltq_n_s32(m, -126)); return poly; @@ -225,7 +236,7 @@ __STATIC_INLINE f32x4_t vexpq_f32(f32x4_t x) __STATIC_INLINE f32x4_t arm_vec_exponent_f32(f32x4_t x, int32_t nb) { - f32x4_t r = x; + f32x4_t r = x; nb--; while (nb > 0) { r = vmulq(r, x); @@ -236,8 +247,8 @@ __STATIC_INLINE f32x4_t arm_vec_exponent_f32(f32x4_t x, int32_t nb) __STATIC_INLINE f32x4_t vrecip_f32(f32x4_t vecIn) { - f32x4_t vecSx, vecW, vecTmp; - any32x4_t v; + f32x4_t vecSx, vecW, vecTmp; + any32x4_t v; vecSx = vabsq(vecIn); @@ -254,9 +265,9 @@ __STATIC_INLINE f32x4_t vrecip_f32(f32x4_t vecIn) vecTmp = vfmasq(vecW, vecTmp, 56.0f); vecTmp = vfmasq(vecW, vecTmp, -28.0f); vecTmp = vfmasq(vecW, vecTmp, 8.0f); - v.f = vmulq(v.f, vecTmp); + v.f = vmulq(v.f, vecTmp); - v.f = vdupq_m(v.f, INFINITY, vcmpeqq(vecIn, 0.0f)); + v.f = vdupq_m(v.f, F32_MAX, vcmpeqq(vecIn, 0.0f)); /* * restore sign */ @@ -264,17 +275,21 @@ __STATIC_INLINE f32x4_t vrecip_f32(f32x4_t vecIn) return v.f; } -__STATIC_INLINE f32x4_t vtanhq_f32(f32x4_t val) +__STATIC_INLINE f32x4_t vtanhq_f32( + f32x4_t val) { - f32x4_t x = vminnmq_f32(vmaxnmq_f32(val, vdupq_n_f32(-10.f)), vdupq_n_f32(10.0f)); - f32x4_t exp2x = vexpq_f32(vmulq_n_f32(x, 2.f)); - f32x4_t num = vsubq_n_f32(exp2x, 1.f); - f32x4_t den = vaddq_n_f32(exp2x, 1.f); - f32x4_t tanh = vmulq_f32(num, vrecip_f32(den)); + f32x4_t x = + vminnmq_f32(vmaxnmq_f32(val, vdupq_n_f32(-10.f)), vdupq_n_f32(10.0f)); + f32x4_t exp2x = vexpq_f32(vmulq_n_f32(x, 2.f)); + f32x4_t num = vsubq_n_f32(exp2x, 1.f); + f32x4_t den = vaddq_n_f32(exp2x, 1.f); + f32x4_t tanh = vmulq_f32(num, vrecip_f32(den)); return tanh; } -__STATIC_INLINE f32x4_t vpowq_f32(f32x4_t val, f32x4_t n) +__STATIC_INLINE f32x4_t vpowq_f32( + f32x4_t val, + f32x4_t n) { return vexpq_f32(vmulq_f32(n, vlogq_f32(val))); } @@ -284,8 +299,7 @@ __STATIC_INLINE f32x4_t vpowq_f32(f32x4_t val, f32x4_t n) #if (defined(ARM_MATH_MVEI) || defined(ARM_MATH_HELIUM)) && !defined(ARM_MATH_AUTOVECTORIZE) #endif /* (defined(ARM_MATH_MVEI) || defined(ARM_MATH_HELIUM)) */ -#if (defined(ARM_MATH_NEON) || defined(ARM_MATH_NEON_EXPERIMENTAL)) && \ - !defined(ARM_MATH_AUTOVECTORIZE) +#if (defined(ARM_MATH_NEON) || defined(ARM_MATH_NEON_EXPERIMENTAL)) && !defined(ARM_MATH_AUTOVECTORIZE) #include "NEMath.h" /** @@ -295,18 +309,20 @@ __STATIC_INLINE f32x4_t vpowq_f32(f32x4_t val, f32x4_t n) * @return x^nb * */ -__STATIC_INLINE float32x4_t arm_vec_exponent_f32(float32x4_t x, int32_t nb) +__STATIC_INLINE float32x4_t arm_vec_exponent_f32(float32x4_t x, int32_t nb) { float32x4_t r = x; - nb--; - while (nb > 0) { - r = vmulq_f32(r, x); + nb --; + while(nb > 0) + { + r = vmulq_f32(r , x); nb--; } - return (r); + return(r); } -__STATIC_INLINE float32x4_t __arm_vec_sqrt_f32_neon(float32x4_t x) + +__STATIC_INLINE float32x4_t __arm_vec_sqrt_f32_neon(float32x4_t x) { float32x4_t x1 = vmaxq_f32(x, vdupq_n_f32(FLT_MIN)); float32x4_t e = vrsqrteq_f32(x1); @@ -318,36 +334,37 @@ __STATIC_INLINE float32x4_t __arm_vec_sqrt_f32_neon(float32x4_t x) __STATIC_INLINE int16x8_t __arm_vec_sqrt_q15_neon(int16x8_t vec) { float32x4_t tempF; - int32x4_t tempHI, tempLO; + int32x4_t tempHI,tempLO; tempLO = vmovl_s16(vget_low_s16(vec)); - tempF = vcvtq_n_f32_s32(tempLO, 15); + tempF = vcvtq_n_f32_s32(tempLO,15); tempF = __arm_vec_sqrt_f32_neon(tempF); - tempLO = vcvtq_n_s32_f32(tempF, 15); + tempLO = vcvtq_n_s32_f32(tempF,15); tempHI = vmovl_s16(vget_high_s16(vec)); - tempF = vcvtq_n_f32_s32(tempHI, 15); + tempF = vcvtq_n_f32_s32(tempHI,15); tempF = __arm_vec_sqrt_f32_neon(tempF); - tempHI = vcvtq_n_s32_f32(tempF, 15); + tempHI = vcvtq_n_s32_f32(tempF,15); - return (vcombine_s16(vqmovn_s32(tempLO), vqmovn_s32(tempHI))); + return(vcombine_s16(vqmovn_s32(tempLO),vqmovn_s32(tempHI))); } __STATIC_INLINE int32x4_t __arm_vec_sqrt_q31_neon(int32x4_t vec) { - float32x4_t temp; + float32x4_t temp; - temp = vcvtq_n_f32_s32(vec, 31); - temp = __arm_vec_sqrt_f32_neon(temp); - return (vcvtq_n_s32_f32(temp, 31)); + temp = vcvtq_n_f32_s32(vec,31); + temp = __arm_vec_sqrt_f32_neon(temp); + return(vcvtq_n_s32_f32(temp,31)); } #endif /* (defined(ARM_MATH_NEON) || defined(ARM_MATH_NEON_EXPERIMENTAL)) && !defined(ARM_MATH_AUTOVECTORIZE) */ -#ifdef __cplusplus +#ifdef __cplusplus } #endif + #endif /* _ARM_VEC_MATH_H */ /** diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math_f16.h old mode 100644 new mode 100755 index 7fe91b07d70..70e503d66e2 --- a/Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math_f16.h @@ -23,30 +23,34 @@ * limitations under the License. */ -#ifndef _ARM_VEC_MATH_F16_H -#define _ARM_VEC_MATH_F16_H +#ifndef ARM_VEC_MATH_F16_H +#define ARM_VEC_MATH_F16_H #include "arm_math_types_f16.h" #include "arm_common_tables_f16.h" #include "arm_helium_utils.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #if defined(ARM_FLOAT16_SUPPORTED) + #if defined(ARM_MATH_MVE_FLOAT16) && !defined(ARM_MATH_AUTOVECTORIZE) -static const float16_t __logf_rng_f16 = 0.693147180f16; + +static const float16_t __logf_rng_f16=0.693147180f16; /* fast inverse approximation (3x newton) */ -__STATIC_INLINE f16x8_t vrecip_medprec_f16(f16x8_t x) +__STATIC_INLINE f16x8_t vrecip_medprec_f16( + f16x8_t x) { - q15x8_t m; - f16x8_t b; - any16x8_t xinv; - f16x8_t ax = vabsq(x); + q15x8_t m; + f16x8_t b; + any16x8_t xinv; + f16x8_t ax = vabsq(x); xinv.f = ax; @@ -74,12 +78,13 @@ __STATIC_INLINE f16x8_t vrecip_medprec_f16(f16x8_t x) } /* fast inverse approximation (4x newton) */ -__STATIC_INLINE f16x8_t vrecip_hiprec_f16(f16x8_t x) +__STATIC_INLINE f16x8_t vrecip_hiprec_f16( + f16x8_t x) { - q15x8_t m; - f16x8_t b; - any16x8_t xinv; - f16x8_t ax = vabsq(x); + q15x8_t m; + f16x8_t b; + any16x8_t xinv; + f16x8_t ax = vabsq(x); xinv.f = ax; @@ -109,11 +114,13 @@ __STATIC_INLINE f16x8_t vrecip_hiprec_f16(f16x8_t x) return xinv.f; } -__STATIC_INLINE f16x8_t vdiv_f16(f16x8_t num, f16x8_t den) +__STATIC_INLINE f16x8_t vdiv_f16( + f16x8_t num, f16x8_t den) { return vmulq(num, vrecip_hiprec_f16(den)); } + /** @brief Single-precision taylor dev. @param[in] x f16 vector input @@ -121,37 +128,39 @@ __STATIC_INLINE f16x8_t vdiv_f16(f16x8_t num, f16x8_t den) @return destination f16 vector */ -__STATIC_INLINE float16x8_t vtaylor_polyq_f16(float16x8_t x, const float16_t *coeffs) +__STATIC_INLINE float16x8_t vtaylor_polyq_f16( + float16x8_t x, + const float16_t * coeffs) { - float16x8_t A = vfmasq(vdupq_n_f16(coeffs[4]), x, coeffs[0]); - float16x8_t B = vfmasq(vdupq_n_f16(coeffs[6]), x, coeffs[2]); - float16x8_t C = vfmasq(vdupq_n_f16(coeffs[5]), x, coeffs[1]); - float16x8_t D = vfmasq(vdupq_n_f16(coeffs[7]), x, coeffs[3]); - float16x8_t x2 = vmulq(x, x); - float16x8_t x4 = vmulq(x2, x2); - float16x8_t res = vfmaq(vfmaq_f16(A, B, x2), vfmaq_f16(C, D, x2), x4); + float16x8_t A = vfmasq(vdupq_n_f16(coeffs[4]), x, coeffs[0]); + float16x8_t B = vfmasq(vdupq_n_f16(coeffs[6]), x, coeffs[2]); + float16x8_t C = vfmasq(vdupq_n_f16(coeffs[5]), x, coeffs[1]); + float16x8_t D = vfmasq(vdupq_n_f16(coeffs[7]), x, coeffs[3]); + float16x8_t x2 = vmulq(x, x); + float16x8_t x4 = vmulq(x2, x2); + float16x8_t res = vfmaq(vfmaq_f16(A, B, x2), vfmaq_f16(C, D, x2), x4); return res; } -#define VMANT_EXP_F16(x) \ - any16x8_t r; \ - int16x8_t n; \ - \ - r.f = x; \ - n = r.i >> 10; \ - n = n - 15; \ - r.i = r.i - (n << 10); \ - \ - vecExpUnBiased = n; \ +#define VMANT_EXP_F16(x) \ + any16x8_t r; \ + int16x8_t n; \ + \ + r.f = x; \ + n = r.i >> 10; \ + n = n - 15; \ + r.i = r.i - (n << 10);\ + \ + vecExpUnBiased = n; \ vecTmpFlt1 = r.f; __STATIC_INLINE float16x8_t vlogq_f16(float16x8_t vecIn) { - q15x8_t vecExpUnBiased; - float16x8_t vecTmpFlt0, vecTmpFlt1; - float16x8_t vecAcc0, vecAcc1, vecAcc2, vecAcc3; - float16x8_t vecExpUnBiasedFlt; + q15x8_t vecExpUnBiased; + float16x8_t vecTmpFlt0, vecTmpFlt1; + float16x8_t vecAcc0, vecAcc1, vecAcc2, vecAcc3; + float16x8_t vecExpUnBiasedFlt; /* * extract exponent @@ -206,17 +215,18 @@ __STATIC_INLINE float16x8_t vlogq_f16(float16x8_t vecIn) return vecAcc0; } -__STATIC_INLINE float16x8_t vexpq_f16(float16x8_t x) +__STATIC_INLINE float16x8_t vexpq_f16( + float16x8_t x) { // Perform range reduction [-log(2),log(2)] - int16x8_t m = vcvtq_s16_f16(vmulq_n_f16(x, 1.4426950408f16)); - float16x8_t val = vfmsq_f16(x, vcvtq_f16_s16(m), vdupq_n_f16(0.6931471805f16)); + int16x8_t m = vcvtq_s16_f16(vmulq_n_f16(x, 1.4426950408f16)); + float16x8_t val = vfmsq_f16(x, vcvtq_f16_s16(m), vdupq_n_f16(0.6931471805f16)); // Polynomial Approximation - float16x8_t poly = vtaylor_polyq_f16(val, exp_tab_f16); + float16x8_t poly = vtaylor_polyq_f16(val, exp_tab_f16); // Reconstruct - poly = (float16x8_t)(vqaddq_s16((int16x8_t)(poly), vqshlq_n_s16(m, 10))); + poly = (float16x8_t) (vqaddq_s16((int16x8_t) (poly), vqshlq_n_s16(m, 10))); poly = vdupq_m_n_f16(poly, 0.0f16, vcmpltq_n_s16(m, -14)); return poly; @@ -224,7 +234,7 @@ __STATIC_INLINE float16x8_t vexpq_f16(float16x8_t x) __STATIC_INLINE float16x8_t arm_vec_exponent_f16(float16x8_t x, int16_t nb) { - float16x8_t r = x; + float16x8_t r = x; nb--; while (nb > 0) { r = vmulq(r, x); @@ -233,17 +243,19 @@ __STATIC_INLINE float16x8_t arm_vec_exponent_f16(float16x8_t x, int16_t nb) return (r); } -__STATIC_INLINE f16x8_t vpowq_f16(f16x8_t val, f16x8_t n) +__STATIC_INLINE f16x8_t vpowq_f16( + f16x8_t val, + f16x8_t n) { return vexpq_f16(vmulq_f16(n, vlogq_f16(val))); } -#define INV_NEWTON_INIT_F16 0x7773 +#define INV_NEWTON_INIT_F16 0x7773 __STATIC_INLINE f16x8_t vrecip_f16(f16x8_t vecIn) { - f16x8_t vecSx, vecW, vecTmp; - any16x8_t v; + f16x8_t vecSx, vecW, vecTmp; + any16x8_t v; vecSx = vabsq(vecIn); @@ -260,7 +272,7 @@ __STATIC_INLINE f16x8_t vrecip_f16(f16x8_t vecIn) vecTmp = vfmasq_n_f16(vecW, vecTmp, 56.0f16); vecTmp = vfmasq_n_f16(vecW, vecTmp, -28.0f16); vecTmp = vfmasq_n_f16(vecW, vecTmp, 8.0f16); - v.f = vmulq(v.f, vecTmp); + v.f = vmulq(v.f, vecTmp); v.f = vdupq_m_n_f16(v.f, F16INFINITY, vcmpeqq_n_f16(vecIn, 0.0f)); /* @@ -270,19 +282,23 @@ __STATIC_INLINE f16x8_t vrecip_f16(f16x8_t vecIn) return v.f; } -__STATIC_INLINE f16x8_t vtanhq_f16(f16x8_t val) +__STATIC_INLINE f16x8_t vtanhq_f16( + f16x8_t val) { - f16x8_t x = vminnmq_f16(vmaxnmq_f16(val, vdupq_n_f16(-10.f16)), vdupq_n_f16(10.0f16)); - f16x8_t exp2x = vexpq_f16(vmulq_n_f16(x, 2.f16)); - f16x8_t num = vsubq_n_f16(exp2x, 1.f16); - f16x8_t den = vaddq_n_f16(exp2x, 1.f16); - f16x8_t tanh = vmulq_f16(num, vrecip_f16(den)); + f16x8_t x = + vminnmq_f16(vmaxnmq_f16(val, vdupq_n_f16(-10.f16)), vdupq_n_f16(10.0f16)); + f16x8_t exp2x = vexpq_f16(vmulq_n_f16(x, 2.f16)); + f16x8_t num = vsubq_n_f16(exp2x, 1.f16); + f16x8_t den = vaddq_n_f16(exp2x, 1.f16); + f16x8_t tanh = vmulq_f16(num, vrecip_f16(den)); return tanh; } #endif /* defined(ARM_MATH_MVE_FLOAT16) && !defined(ARM_MATH_AUTOVECTORIZE)*/ -#ifdef __cplusplus + + +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions.h old mode 100644 new mode 100755 index d6e50493c93..645afdc3b94 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _BASIC_MATH_FUNCTIONS_H_ -#define _BASIC_MATH_FUNCTIONS_H_ + +#ifndef BASIC_MATH_FUNCTIONS_H_ +#define BASIC_MATH_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -32,50 +33,72 @@ #include "dsp/none.h" #include "dsp/utils.h" -#ifdef __cplusplus -extern "C" { + +#ifdef __cplusplus +extern "C" +{ #endif /** * @defgroup groupMath Basic Math Functions */ -/** + /** * @brief Q7 vector multiplication. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_mult_q7(const q7_t *pSrcA, const q7_t *pSrcB, q7_t *pDst, uint32_t blockSize); + void arm_mult_q7( + const q7_t * pSrcA, + const q7_t * pSrcB, + q7_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Q15 vector multiplication. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_mult_q15(const q15_t *pSrcA, const q15_t *pSrcB, q15_t *pDst, uint32_t blockSize); + void arm_mult_q15( + const q15_t * pSrcA, + const q15_t * pSrcB, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Q31 vector multiplication. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_mult_q31(const q31_t *pSrcA, const q31_t *pSrcB, q31_t *pDst, uint32_t blockSize); + void arm_mult_q31( + const q31_t * pSrcA, + const q31_t * pSrcB, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Floating-point vector multiplication. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_mult_f32(const float32_t *pSrcA, const float32_t *pSrcB, float32_t *pDst, - uint32_t blockSize); + void arm_mult_f32( + const float32_t * pSrcA, + const float32_t * pSrcB, + float32_t * pDst, + uint32_t blockSize); + + /** * @brief Floating-point vector multiplication. @@ -84,18 +107,28 @@ void arm_mult_f32(const float32_t *pSrcA, const float32_t *pSrcB, float32_t *pDs * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_mult_f64(const float64_t *pSrcA, const float64_t *pSrcB, float64_t *pDst, - uint32_t blockSize); +void arm_mult_f64( +const float64_t * pSrcA, +const float64_t * pSrcB, + float64_t * pDst, + uint32_t blockSize); -/** + + + /** * @brief Floating-point vector addition. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_add_f32(const float32_t *pSrcA, const float32_t *pSrcB, float32_t *pDst, - uint32_t blockSize); + void arm_add_f32( + const float32_t * pSrcA, + const float32_t * pSrcB, + float32_t * pDst, + uint32_t blockSize); + + /** * @brief Floating-point vector addition. @@ -104,102 +137,159 @@ void arm_add_f32(const float32_t *pSrcA, const float32_t *pSrcB, float32_t *pDst * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_add_f64(const float64_t *pSrcA, const float64_t *pSrcB, float64_t *pDst, - uint32_t blockSize); + void arm_add_f64( + const float64_t * pSrcA, + const float64_t * pSrcB, + float64_t * pDst, + uint32_t blockSize); -/** + + + /** * @brief Q7 vector addition. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_add_q7(const q7_t *pSrcA, const q7_t *pSrcB, q7_t *pDst, uint32_t blockSize); + void arm_add_q7( + const q7_t * pSrcA, + const q7_t * pSrcB, + q7_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Q15 vector addition. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_add_q15(const q15_t *pSrcA, const q15_t *pSrcB, q15_t *pDst, uint32_t blockSize); + void arm_add_q15( + const q15_t * pSrcA, + const q15_t * pSrcB, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Q31 vector addition. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_add_q31(const q31_t *pSrcA, const q31_t *pSrcB, q31_t *pDst, uint32_t blockSize); + void arm_add_q31( + const q31_t * pSrcA, + const q31_t * pSrcB, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Floating-point vector subtraction. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_sub_f32(const float32_t *pSrcA, const float32_t *pSrcB, float32_t *pDst, - uint32_t blockSize); + void arm_sub_f32( + const float32_t * pSrcA, + const float32_t * pSrcB, + float32_t * pDst, + uint32_t blockSize); -/** + + + /** * @brief Floating-point vector subtraction. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_sub_f64(const float64_t *pSrcA, const float64_t *pSrcB, float64_t *pDst, - uint32_t blockSize); + void arm_sub_f64( + const float64_t * pSrcA, + const float64_t * pSrcB, + float64_t * pDst, + uint32_t blockSize); -/** + + + /** * @brief Q7 vector subtraction. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_sub_q7(const q7_t *pSrcA, const q7_t *pSrcB, q7_t *pDst, uint32_t blockSize); + void arm_sub_q7( + const q7_t * pSrcA, + const q7_t * pSrcB, + q7_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Q15 vector subtraction. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_sub_q15(const q15_t *pSrcA, const q15_t *pSrcB, q15_t *pDst, uint32_t blockSize); + void arm_sub_q15( + const q15_t * pSrcA, + const q15_t * pSrcB, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Q31 vector subtraction. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_sub_q31(const q31_t *pSrcA, const q31_t *pSrcB, q31_t *pDst, uint32_t blockSize); + void arm_sub_q31( + const q31_t * pSrcA, + const q31_t * pSrcB, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Multiplies a floating-point vector by a scalar. * @param[in] pSrc points to the input vector * @param[in] scale scale factor to be applied * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_scale_f32(const float32_t *pSrc, float32_t scale, float32_t *pDst, uint32_t blockSize); + void arm_scale_f32( + const float32_t * pSrc, + float32_t scale, + float32_t * pDst, + uint32_t blockSize); -/** + + + /** * @brief Multiplies a floating-point vector by a scalar. * @param[in] pSrc points to the input vector * @param[in] scale scale factor to be applied * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_scale_f64(const float64_t *pSrc, float64_t scale, float64_t *pDst, uint32_t blockSize); + void arm_scale_f64( + const float64_t * pSrc, + float64_t scale, + float64_t * pDst, + uint32_t blockSize); -/** + + + /** * @brief Multiplies a Q7 vector by a scalar. * @param[in] pSrc points to the input vector * @param[in] scaleFract fractional portion of the scale value @@ -207,9 +297,15 @@ void arm_scale_f64(const float64_t *pSrc, float64_t scale, float64_t *pDst, uint * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_scale_q7(const q7_t *pSrc, q7_t scaleFract, int8_t shift, q7_t *pDst, uint32_t blockSize); + void arm_scale_q7( + const q7_t * pSrc, + q7_t scaleFract, + int8_t shift, + q7_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Multiplies a Q15 vector by a scalar. * @param[in] pSrc points to the input vector * @param[in] scaleFract fractional portion of the scale value @@ -217,10 +313,15 @@ void arm_scale_q7(const q7_t *pSrc, q7_t scaleFract, int8_t shift, q7_t *pDst, u * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_scale_q15(const q15_t *pSrc, q15_t scaleFract, int8_t shift, q15_t *pDst, - uint32_t blockSize); + void arm_scale_q15( + const q15_t * pSrc, + q15_t scaleFract, + int8_t shift, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Multiplies a Q31 vector by a scalar. * @param[in] pSrc points to the input vector * @param[in] scaleFract fractional portion of the scale value @@ -228,24 +329,38 @@ void arm_scale_q15(const q15_t *pSrc, q15_t scaleFract, int8_t shift, q15_t *pDs * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_scale_q31(const q31_t *pSrc, q31_t scaleFract, int8_t shift, q31_t *pDst, - uint32_t blockSize); + void arm_scale_q31( + const q31_t * pSrc, + q31_t scaleFract, + int8_t shift, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Q7 vector absolute value. * @param[in] pSrc points to the input buffer * @param[out] pDst points to the output buffer * @param[in] blockSize number of samples in each vector */ -void arm_abs_q7(const q7_t *pSrc, q7_t *pDst, uint32_t blockSize); + void arm_abs_q7( + const q7_t * pSrc, + q7_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Floating-point vector absolute value. * @param[in] pSrc points to the input buffer * @param[out] pDst points to the output buffer * @param[in] blockSize number of samples in each vector */ -void arm_abs_f32(const float32_t *pSrc, float32_t *pDst, uint32_t blockSize); + void arm_abs_f32( + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + /** * @brief Floating-point vector absolute value. @@ -253,33 +368,51 @@ void arm_abs_f32(const float32_t *pSrc, float32_t *pDst, uint32_t blockSize); * @param[out] pDst points to the output buffer * @param[in] blockSize number of samples in each vector */ -void arm_abs_f64(const float64_t *pSrc, float64_t *pDst, uint32_t blockSize); +void arm_abs_f64( +const float64_t * pSrc, + float64_t * pDst, + uint32_t blockSize); -/** + + + /** * @brief Q15 vector absolute value. * @param[in] pSrc points to the input buffer * @param[out] pDst points to the output buffer * @param[in] blockSize number of samples in each vector */ -void arm_abs_q15(const q15_t *pSrc, q15_t *pDst, uint32_t blockSize); + void arm_abs_q15( + const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Q31 vector absolute value. * @param[in] pSrc points to the input buffer * @param[out] pDst points to the output buffer * @param[in] blockSize number of samples in each vector */ -void arm_abs_q31(const q31_t *pSrc, q31_t *pDst, uint32_t blockSize); + void arm_abs_q31( + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Dot product of floating-point vectors. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[in] blockSize number of samples in each vector * @param[out] result output result returned here */ -void arm_dot_prod_f32(const float32_t *pSrcA, const float32_t *pSrcB, uint32_t blockSize, - float32_t *result); + void arm_dot_prod_f32( + const float32_t * pSrcA, + const float32_t * pSrcB, + uint32_t blockSize, + float32_t * result); + + /** * @brief Dot product of floating-point vectors. @@ -288,62 +421,97 @@ void arm_dot_prod_f32(const float32_t *pSrcA, const float32_t *pSrcB, uint32_t b * @param[in] blockSize number of samples in each vector * @param[out] result output result returned here */ -void arm_dot_prod_f64(const float64_t *pSrcA, const float64_t *pSrcB, uint32_t blockSize, - float64_t *result); +void arm_dot_prod_f64( +const float64_t * pSrcA, +const float64_t * pSrcB, + uint32_t blockSize, + float64_t * result); -/** + + + /** * @brief Dot product of Q7 vectors. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[in] blockSize number of samples in each vector * @param[out] result output result returned here */ -void arm_dot_prod_q7(const q7_t *pSrcA, const q7_t *pSrcB, uint32_t blockSize, q31_t *result); + void arm_dot_prod_q7( + const q7_t * pSrcA, + const q7_t * pSrcB, + uint32_t blockSize, + q31_t * result); -/** + + /** * @brief Dot product of Q15 vectors. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[in] blockSize number of samples in each vector * @param[out] result output result returned here */ -void arm_dot_prod_q15(const q15_t *pSrcA, const q15_t *pSrcB, uint32_t blockSize, q63_t *result); + void arm_dot_prod_q15( + const q15_t * pSrcA, + const q15_t * pSrcB, + uint32_t blockSize, + q63_t * result); -/** + + /** * @brief Dot product of Q31 vectors. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[in] blockSize number of samples in each vector * @param[out] result output result returned here */ -void arm_dot_prod_q31(const q31_t *pSrcA, const q31_t *pSrcB, uint32_t blockSize, q63_t *result); + void arm_dot_prod_q31( + const q31_t * pSrcA, + const q31_t * pSrcB, + uint32_t blockSize, + q63_t * result); -/** + + /** * @brief Shifts the elements of a Q7 vector a specified number of bits. * @param[in] pSrc points to the input vector * @param[in] shiftBits number of bits to shift. A positive value shifts left; a negative value shifts right. * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_shift_q7(const q7_t *pSrc, int8_t shiftBits, q7_t *pDst, uint32_t blockSize); + void arm_shift_q7( + const q7_t * pSrc, + int8_t shiftBits, + q7_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Shifts the elements of a Q15 vector a specified number of bits. * @param[in] pSrc points to the input vector * @param[in] shiftBits number of bits to shift. A positive value shifts left; a negative value shifts right. * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_shift_q15(const q15_t *pSrc, int8_t shiftBits, q15_t *pDst, uint32_t blockSize); + void arm_shift_q15( + const q15_t * pSrc, + int8_t shiftBits, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Shifts the elements of a Q31 vector a specified number of bits. * @param[in] pSrc points to the input vector * @param[in] shiftBits number of bits to shift. A positive value shifts left; a negative value shifts right. * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_shift_q31(const q31_t *pSrc, int8_t shiftBits, q31_t *pDst, uint32_t blockSize); + void arm_shift_q31( + const q31_t * pSrc, + int8_t shiftBits, + q31_t * pDst, + uint32_t blockSize); + /** * @brief Adds a constant offset to a floating-point vector. @@ -352,51 +520,83 @@ void arm_shift_q31(const q31_t *pSrc, int8_t shiftBits, q31_t *pDst, uint32_t bl * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_offset_f64(const float64_t *pSrc, float64_t offset, float64_t *pDst, uint32_t blockSize); +void arm_offset_f64( +const float64_t * pSrc, + float64_t offset, + float64_t * pDst, + uint32_t blockSize); -/** + + + /** * @brief Adds a constant offset to a floating-point vector. * @param[in] pSrc points to the input vector * @param[in] offset is the offset to be added * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_offset_f32(const float32_t *pSrc, float32_t offset, float32_t *pDst, uint32_t blockSize); + void arm_offset_f32( + const float32_t * pSrc, + float32_t offset, + float32_t * pDst, + uint32_t blockSize); -/** + + + /** * @brief Adds a constant offset to a Q7 vector. * @param[in] pSrc points to the input vector * @param[in] offset is the offset to be added * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_offset_q7(const q7_t *pSrc, q7_t offset, q7_t *pDst, uint32_t blockSize); + void arm_offset_q7( + const q7_t * pSrc, + q7_t offset, + q7_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Adds a constant offset to a Q15 vector. * @param[in] pSrc points to the input vector * @param[in] offset is the offset to be added * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_offset_q15(const q15_t *pSrc, q15_t offset, q15_t *pDst, uint32_t blockSize); + void arm_offset_q15( + const q15_t * pSrc, + q15_t offset, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Adds a constant offset to a Q31 vector. * @param[in] pSrc points to the input vector * @param[in] offset is the offset to be added * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_offset_q31(const q31_t *pSrc, q31_t offset, q31_t *pDst, uint32_t blockSize); + void arm_offset_q31( + const q31_t * pSrc, + q31_t offset, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Negates the elements of a floating-point vector. * @param[in] pSrc points to the input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_negate_f32(const float32_t *pSrc, float32_t *pDst, uint32_t blockSize); + void arm_negate_f32( + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + /** * @brief Negates the elements of a floating-point vector. @@ -404,31 +604,47 @@ void arm_negate_f32(const float32_t *pSrc, float32_t *pDst, uint32_t blockSize); * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_negate_f64(const float64_t *pSrc, float64_t *pDst, uint32_t blockSize); +void arm_negate_f64( +const float64_t * pSrc, + float64_t * pDst, + uint32_t blockSize); -/** + + + /** * @brief Negates the elements of a Q7 vector. * @param[in] pSrc points to the input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_negate_q7(const q7_t *pSrc, q7_t *pDst, uint32_t blockSize); + void arm_negate_q7( + const q7_t * pSrc, + q7_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Negates the elements of a Q15 vector. * @param[in] pSrc points to the input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_negate_q15(const q15_t *pSrc, q15_t *pDst, uint32_t blockSize); + void arm_negate_q15( + const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Negates the elements of a Q31 vector. * @param[in] pSrc points to the input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_negate_q31(const q31_t *pSrc, q31_t *pDst, uint32_t blockSize); + void arm_negate_q31( + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); /** * @brief Compute the logical bitwise AND of two fixed-point vectors. @@ -436,86 +652,110 @@ void arm_negate_q31(const q31_t *pSrc, q31_t *pDst, uint32_t blockSize); * @param[in] pSrcB points to input vector B * @param[out] pDst points to output vector * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_and_u16(const uint16_t *pSrcA, const uint16_t *pSrcB, uint16_t *pDst, uint32_t blockSize); + void arm_and_u16( + const uint16_t * pSrcA, + const uint16_t * pSrcB, + uint16_t * pDst, + uint32_t blockSize); -/** + /** * @brief Compute the logical bitwise AND of two fixed-point vectors. * @param[in] pSrcA points to input vector A * @param[in] pSrcB points to input vector B * @param[out] pDst points to output vector * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_and_u32(const uint32_t *pSrcA, const uint32_t *pSrcB, uint32_t *pDst, uint32_t blockSize); + void arm_and_u32( + const uint32_t * pSrcA, + const uint32_t * pSrcB, + uint32_t * pDst, + uint32_t blockSize); -/** + /** * @brief Compute the logical bitwise AND of two fixed-point vectors. * @param[in] pSrcA points to input vector A * @param[in] pSrcB points to input vector B * @param[out] pDst points to output vector * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_and_u8(const uint8_t *pSrcA, const uint8_t *pSrcB, uint8_t *pDst, uint32_t blockSize); + void arm_and_u8( + const uint8_t * pSrcA, + const uint8_t * pSrcB, + uint8_t * pDst, + uint32_t blockSize); -/** + /** * @brief Compute the logical bitwise OR of two fixed-point vectors. * @param[in] pSrcA points to input vector A * @param[in] pSrcB points to input vector B * @param[out] pDst points to output vector * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_or_u16(const uint16_t *pSrcA, const uint16_t *pSrcB, uint16_t *pDst, uint32_t blockSize); + void arm_or_u16( + const uint16_t * pSrcA, + const uint16_t * pSrcB, + uint16_t * pDst, + uint32_t blockSize); -/** + /** * @brief Compute the logical bitwise OR of two fixed-point vectors. * @param[in] pSrcA points to input vector A * @param[in] pSrcB points to input vector B * @param[out] pDst points to output vector * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_or_u32(const uint32_t *pSrcA, const uint32_t *pSrcB, uint32_t *pDst, uint32_t blockSize); + void arm_or_u32( + const uint32_t * pSrcA, + const uint32_t * pSrcB, + uint32_t * pDst, + uint32_t blockSize); -/** + /** * @brief Compute the logical bitwise OR of two fixed-point vectors. * @param[in] pSrcA points to input vector A * @param[in] pSrcB points to input vector B * @param[out] pDst points to output vector * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_or_u8(const uint8_t *pSrcA, const uint8_t *pSrcB, uint8_t *pDst, uint32_t blockSize); + void arm_or_u8( + const uint8_t * pSrcA, + const uint8_t * pSrcB, + uint8_t * pDst, + uint32_t blockSize); -/** + /** * @brief Compute the logical bitwise NOT of a fixed-point vector. * @param[in] pSrc points to input vector * @param[out] pDst points to output vector * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_not_u16(const uint16_t *pSrc, uint16_t *pDst, uint32_t blockSize); + void arm_not_u16( + const uint16_t * pSrc, + uint16_t * pDst, + uint32_t blockSize); -/** + /** * @brief Compute the logical bitwise NOT of a fixed-point vector. * @param[in] pSrc points to input vector * @param[out] pDst points to output vector * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_not_u32(const uint32_t *pSrc, uint32_t *pDst, uint32_t blockSize); + void arm_not_u32( + const uint32_t * pSrc, + uint32_t * pDst, + uint32_t blockSize); -/** + /** * @brief Compute the logical bitwise NOT of a fixed-point vector. * @param[in] pSrc points to input vector * @param[out] pDst points to output vector * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_not_u8(const uint8_t *pSrc, uint8_t *pDst, uint32_t blockSize); + void arm_not_u8( + const uint8_t * pSrc, + uint8_t * pDst, + uint32_t blockSize); /** * @brief Compute the logical bitwise XOR of two fixed-point vectors. @@ -523,80 +763,101 @@ void arm_not_u8(const uint8_t *pSrc, uint8_t *pDst, uint32_t blockSize); * @param[in] pSrcB points to input vector B * @param[out] pDst points to output vector * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_xor_u16(const uint16_t *pSrcA, const uint16_t *pSrcB, uint16_t *pDst, uint32_t blockSize); + void arm_xor_u16( + const uint16_t * pSrcA, + const uint16_t * pSrcB, + uint16_t * pDst, + uint32_t blockSize); -/** + /** * @brief Compute the logical bitwise XOR of two fixed-point vectors. * @param[in] pSrcA points to input vector A * @param[in] pSrcB points to input vector B * @param[out] pDst points to output vector * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_xor_u32(const uint32_t *pSrcA, const uint32_t *pSrcB, uint32_t *pDst, uint32_t blockSize); + void arm_xor_u32( + const uint32_t * pSrcA, + const uint32_t * pSrcB, + uint32_t * pDst, + uint32_t blockSize); -/** + /** * @brief Compute the logical bitwise XOR of two fixed-point vectors. * @param[in] pSrcA points to input vector A * @param[in] pSrcB points to input vector B * @param[out] pDst points to output vector * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_xor_u8(const uint8_t *pSrcA, const uint8_t *pSrcB, uint8_t *pDst, uint32_t blockSize); + void arm_xor_u8( + const uint8_t * pSrcA, + const uint8_t * pSrcB, + uint8_t * pDst, + uint32_t blockSize); -/** + /** @brief Elementwise floating-point clipping @param[in] pSrc points to input values @param[out] pDst points to output clipped values @param[in] low lower bound @param[in] high higher bound @param[in] numSamples number of samples to clip - @return none */ -void arm_clip_f32(const float32_t *pSrc, float32_t *pDst, float32_t low, float32_t high, - uint32_t numSamples); +void arm_clip_f32(const float32_t * pSrc, + float32_t * pDst, + float32_t low, + float32_t high, + uint32_t numSamples); -/** + /** @brief Elementwise fixed-point clipping @param[in] pSrc points to input values @param[out] pDst points to output clipped values @param[in] low lower bound @param[in] high higher bound @param[in] numSamples number of samples to clip - @return none */ -void arm_clip_q31(const q31_t *pSrc, q31_t *pDst, q31_t low, q31_t high, uint32_t numSamples); +void arm_clip_q31(const q31_t * pSrc, + q31_t * pDst, + q31_t low, + q31_t high, + uint32_t numSamples); -/** + /** @brief Elementwise fixed-point clipping @param[in] pSrc points to input values @param[out] pDst points to output clipped values @param[in] low lower bound @param[in] high higher bound @param[in] numSamples number of samples to clip - @return none */ -void arm_clip_q15(const q15_t *pSrc, q15_t *pDst, q15_t low, q15_t high, uint32_t numSamples); +void arm_clip_q15(const q15_t * pSrc, + q15_t * pDst, + q15_t low, + q15_t high, + uint32_t numSamples); -/** + /** @brief Elementwise fixed-point clipping @param[in] pSrc points to input values @param[out] pDst points to output clipped values @param[in] low lower bound @param[in] high higher bound @param[in] numSamples number of samples to clip - @return none */ -void arm_clip_q7(const q7_t *pSrc, q7_t *pDst, q7_t low, q7_t high, uint32_t numSamples); +void arm_clip_q7(const q7_t * pSrc, + q7_t * pDst, + q7_t low, + q7_t high, + uint32_t numSamples); + -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions_f16.h old mode 100644 new mode 100755 index 6b39dd98122..b3d5ecdc95a --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions_f16.h @@ -23,12 +23,9 @@ * limitations under the License. */ -#ifndef _BASIC_MATH_FUNCTIONS_F16_H_ -#define _BASIC_MATH_FUNCTIONS_F16_H_ - -#ifdef __cplusplus -extern "C" { -#endif + +#ifndef BASIC_MATH_FUNCTIONS_F16_H_ +#define BASIC_MATH_FUNCTIONS_F16_H_ #include "arm_math_types_f16.h" #include "arm_math_memory.h" @@ -36,98 +33,132 @@ extern "C" { #include "dsp/none.h" #include "dsp/utils.h" +#ifdef __cplusplus +extern "C" +{ +#endif + #if defined(ARM_FLOAT16_SUPPORTED) -/** + + /** * @brief Floating-point vector addition. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_add_f16(const float16_t *pSrcA, const float16_t *pSrcB, float16_t *pDst, - uint32_t blockSize); + void arm_add_f16( + const float16_t * pSrcA, + const float16_t * pSrcB, + float16_t * pDst, + uint32_t blockSize); -/** + /** * @brief Floating-point vector subtraction. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_sub_f16(const float16_t *pSrcA, const float16_t *pSrcB, float16_t *pDst, - uint32_t blockSize); + void arm_sub_f16( + const float16_t * pSrcA, + const float16_t * pSrcB, + float16_t * pDst, + uint32_t blockSize); -/** + /** * @brief Multiplies a floating-point vector by a scalar. * @param[in] pSrc points to the input vector * @param[in] scale scale factor to be applied * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_scale_f16(const float16_t *pSrc, float16_t scale, float16_t *pDst, uint32_t blockSize); + void arm_scale_f16( + const float16_t * pSrc, + float16_t scale, + float16_t * pDst, + uint32_t blockSize); -/** + /** * @brief Floating-point vector absolute value. * @param[in] pSrc points to the input buffer * @param[out] pDst points to the output buffer * @param[in] blockSize number of samples in each vector */ -void arm_abs_f16(const float16_t *pSrc, float16_t *pDst, uint32_t blockSize); + void arm_abs_f16( + const float16_t * pSrc, + float16_t * pDst, + uint32_t blockSize); + -/** + /** * @brief Adds a constant offset to a floating-point vector. * @param[in] pSrc points to the input vector * @param[in] offset is the offset to be added * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_offset_f16(const float16_t *pSrc, float16_t offset, float16_t *pDst, uint32_t blockSize); + void arm_offset_f16( + const float16_t * pSrc, + float16_t offset, + float16_t * pDst, + uint32_t blockSize); -/** + /** * @brief Dot product of floating-point vectors. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[in] blockSize number of samples in each vector * @param[out] result output result returned here */ -void arm_dot_prod_f16(const float16_t *pSrcA, const float16_t *pSrcB, uint32_t blockSize, - float16_t *result); + void arm_dot_prod_f16( + const float16_t * pSrcA, + const float16_t * pSrcB, + uint32_t blockSize, + float16_t * result); -/** + /** * @brief Floating-point vector multiplication. * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in each vector */ -void arm_mult_f16(const float16_t *pSrcA, const float16_t *pSrcB, float16_t *pDst, - uint32_t blockSize); + void arm_mult_f16( + const float16_t * pSrcA, + const float16_t * pSrcB, + float16_t * pDst, + uint32_t blockSize); -/** + /** * @brief Negates the elements of a floating-point vector. * @param[in] pSrc points to the input vector * @param[out] pDst points to the output vector * @param[in] blockSize number of samples in the vector */ -void arm_negate_f16(const float16_t *pSrc, float16_t *pDst, uint32_t blockSize); + void arm_negate_f16( + const float16_t * pSrc, + float16_t * pDst, + uint32_t blockSize); -/** + /** @brief Elementwise floating-point clipping @param[in] pSrc points to input values @param[out] pDst points to output clipped values @param[in] low lower bound @param[in] high higher bound @param[in] numSamples number of samples to clip - @return none */ - -void arm_clip_f16(const float16_t *pSrc, float16_t *pDst, float16_t low, float16_t high, - uint32_t numSamples); +void arm_clip_f16(const float16_t * pSrc, + float16_t * pDst, + float16_t low, + float16_t high, + uint32_t numSamples); #endif /* defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions.h old mode 100644 new mode 100755 index 91a1d5f3dad..7b3e0efacbb --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _BAYES_FUNCTIONS_H_ -#define _BAYES_FUNCTIONS_H_ + +#ifndef BAYES_FUNCTIONS_H_ +#define BAYES_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -45,20 +46,22 @@ * DSP/Testing/PatternGeneration/Bayes.py */ -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif /** * @brief Instance structure for Naive Gaussian Bayesian estimator. */ -typedef struct { - uint32_t vectorDimension; /**< Dimension of vector space */ - uint32_t numberOfClasses; /**< Number of different classes */ - const float32_t *theta; /**< Mean values for the Gaussians */ - const float32_t *sigma; /**< Variances for the Gaussians */ - const float32_t *classPriors; /**< Class prior probabilities */ - float32_t epsilon; /**< Additive value to variances */ +typedef struct +{ + uint32_t vectorDimension; /**< Dimension of vector space */ + uint32_t numberOfClasses; /**< Number of different classes */ + const float32_t *theta; /**< Mean values for the Gaussians */ + const float32_t *sigma; /**< Variances for the Gaussians */ + const float32_t *classPriors; /**< Class prior probabilities */ + float32_t epsilon; /**< Additive value to variances */ } arm_gaussian_naive_bayes_instance_f32; /** @@ -69,14 +72,14 @@ typedef struct { * @param[out] *pOutputProbabilities points to a buffer of length numberOfClasses containing estimated probabilities * @param[out] *pBufferB points to a temporary buffer of length numberOfClasses * @return The predicted class - * */ +uint32_t arm_gaussian_naive_bayes_predict_f32(const arm_gaussian_naive_bayes_instance_f32 *S, + const float32_t * in, + float32_t *pOutputProbabilities, + float32_t *pBufferB); -uint32_t arm_gaussian_naive_bayes_predict_f32(const arm_gaussian_naive_bayes_instance_f32 *S, - const float32_t *in, float32_t *pOutputProbabilities, - float32_t *pBufferB); -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions_f16.h old mode 100644 new mode 100755 index f8131e13d5e..100162ed465 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions_f16.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _BAYES_FUNCTIONS_F16_H_ -#define _BAYES_FUNCTIONS_F16_H_ + +#ifndef BAYES_FUNCTIONS_F16_H_ +#define BAYES_FUNCTIONS_F16_H_ #include "arm_math_types_f16.h" #include "arm_math_memory.h" @@ -34,8 +35,9 @@ #include "dsp/statistics_functions_f16.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #if defined(ARM_FLOAT16_SUPPORTED) @@ -43,13 +45,14 @@ extern "C" { /** * @brief Instance structure for Naive Gaussian Bayesian estimator. */ -typedef struct { - uint32_t vectorDimension; /**< Dimension of vector space */ - uint32_t numberOfClasses; /**< Number of different classes */ - const float16_t *theta; /**< Mean values for the Gaussians */ - const float16_t *sigma; /**< Variances for the Gaussians */ - const float16_t *classPriors; /**< Class prior probabilities */ - float16_t epsilon; /**< Additive value to variances */ +typedef struct +{ + uint32_t vectorDimension; /**< Dimension of vector space */ + uint32_t numberOfClasses; /**< Number of different classes */ + const float16_t *theta; /**< Mean values for the Gaussians */ + const float16_t *sigma; /**< Variances for the Gaussians */ + const float16_t *classPriors; /**< Class prior probabilities */ + float16_t epsilon; /**< Additive value to variances */ } arm_gaussian_naive_bayes_instance_f16; /** @@ -60,15 +63,14 @@ typedef struct { * @param[out] *pOutputProbabilities points to a buffer of length numberOfClasses containing estimated probabilities * @param[out] *pBufferB points to a temporary buffer of length numberOfClasses * @return The predicted class - * */ - -uint32_t arm_gaussian_naive_bayes_predict_f16(const arm_gaussian_naive_bayes_instance_f16 *S, - const float16_t *in, float16_t *pOutputProbabilities, - float16_t *pBufferB); +uint32_t arm_gaussian_naive_bayes_predict_f16(const arm_gaussian_naive_bayes_instance_f16 *S, + const float16_t * in, + float16_t *pOutputProbabilities, + float16_t *pBufferB); #endif /*defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions.h old mode 100644 new mode 100755 index 65f09b0489f..bdbc2a4ed49 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _COMPLEX_MATH_FUNCTIONS_H_ -#define _COMPLEX_MATH_FUNCTIONS_H_ + +#ifndef COMPLEX_MATH_FUNCTIONS_H_ +#define COMPLEX_MATH_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -33,8 +34,9 @@ #include "dsp/utils.h" #include "dsp/fast_math_functions.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif /** @@ -47,61 +49,88 @@ extern "C" { * real values. */ -/** + /** * @brief Floating-point complex conjugate. * @param[in] pSrc points to the input vector * @param[out] pDst points to the output vector * @param[in] numSamples number of complex samples in each vector */ -void arm_cmplx_conj_f32(const float32_t *pSrc, float32_t *pDst, uint32_t numSamples); + void arm_cmplx_conj_f32( + const float32_t * pSrc, + float32_t * pDst, + uint32_t numSamples); -/** + /** * @brief Q31 complex conjugate. * @param[in] pSrc points to the input vector * @param[out] pDst points to the output vector * @param[in] numSamples number of complex samples in each vector */ -void arm_cmplx_conj_q31(const q31_t *pSrc, q31_t *pDst, uint32_t numSamples); + void arm_cmplx_conj_q31( + const q31_t * pSrc, + q31_t * pDst, + uint32_t numSamples); -/** + + /** * @brief Q15 complex conjugate. * @param[in] pSrc points to the input vector * @param[out] pDst points to the output vector * @param[in] numSamples number of complex samples in each vector */ -void arm_cmplx_conj_q15(const q15_t *pSrc, q15_t *pDst, uint32_t numSamples); + void arm_cmplx_conj_q15( + const q15_t * pSrc, + q15_t * pDst, + uint32_t numSamples); -/** + + /** * @brief Floating-point complex magnitude squared * @param[in] pSrc points to the complex input vector * @param[out] pDst points to the real output vector * @param[in] numSamples number of complex samples in the input vector */ -void arm_cmplx_mag_squared_f32(const float32_t *pSrc, float32_t *pDst, uint32_t numSamples); + void arm_cmplx_mag_squared_f32( + const float32_t * pSrc, + float32_t * pDst, + uint32_t numSamples); -/** + + /** * @brief Floating-point complex magnitude squared * @param[in] pSrc points to the complex input vector * @param[out] pDst points to the real output vector * @param[in] numSamples number of complex samples in the input vector */ -void arm_cmplx_mag_squared_f64(const float64_t *pSrc, float64_t *pDst, uint32_t numSamples); + void arm_cmplx_mag_squared_f64( + const float64_t * pSrc, + float64_t * pDst, + uint32_t numSamples); -/** + + /** * @brief Q31 complex magnitude squared * @param[in] pSrc points to the complex input vector * @param[out] pDst points to the real output vector * @param[in] numSamples number of complex samples in the input vector */ -void arm_cmplx_mag_squared_q31(const q31_t *pSrc, q31_t *pDst, uint32_t numSamples); + void arm_cmplx_mag_squared_q31( + const q31_t * pSrc, + q31_t * pDst, + uint32_t numSamples); -/** + + /** * @brief Q15 complex magnitude squared * @param[in] pSrc points to the complex input vector * @param[out] pDst points to the real output vector * @param[in] numSamples number of complex samples in the input vector */ -void arm_cmplx_mag_squared_q15(const q15_t *pSrc, q15_t *pDst, uint32_t numSamples); + void arm_cmplx_mag_squared_q15( + const q15_t * pSrc, + q15_t * pDst, + uint32_t numSamples); + /** * @brief Floating-point complex magnitude @@ -109,7 +138,11 @@ void arm_cmplx_mag_squared_q15(const q15_t *pSrc, q15_t *pDst, uint32_t numSampl * @param[out] pDst points to the real output vector * @param[in] numSamples number of complex samples in the input vector */ -void arm_cmplx_mag_f32(const float32_t *pSrc, float32_t *pDst, uint32_t numSamples); + void arm_cmplx_mag_f32( + const float32_t * pSrc, + float32_t * pDst, + uint32_t numSamples); + /** * @brief Floating-point complex magnitude @@ -117,33 +150,48 @@ void arm_cmplx_mag_f32(const float32_t *pSrc, float32_t *pDst, uint32_t numSampl * @param[out] pDst points to the real output vector * @param[in] numSamples number of complex samples in the input vector */ -void arm_cmplx_mag_f64(const float64_t *pSrc, float64_t *pDst, uint32_t numSamples); + void arm_cmplx_mag_f64( + const float64_t * pSrc, + float64_t * pDst, + uint32_t numSamples); -/** + + /** * @brief Q31 complex magnitude * @param[in] pSrc points to the complex input vector * @param[out] pDst points to the real output vector * @param[in] numSamples number of complex samples in the input vector */ -void arm_cmplx_mag_q31(const q31_t *pSrc, q31_t *pDst, uint32_t numSamples); + void arm_cmplx_mag_q31( + const q31_t * pSrc, + q31_t * pDst, + uint32_t numSamples); -/** + + /** * @brief Q15 complex magnitude * @param[in] pSrc points to the complex input vector * @param[out] pDst points to the real output vector * @param[in] numSamples number of complex samples in the input vector */ -void arm_cmplx_mag_q15(const q15_t *pSrc, q15_t *pDst, uint32_t numSamples); + void arm_cmplx_mag_q15( + const q15_t * pSrc, + q15_t * pDst, + uint32_t numSamples); -/** + /** * @brief Q15 complex magnitude * @param[in] pSrc points to the complex input vector * @param[out] pDst points to the real output vector * @param[in] numSamples number of complex samples in the input vector */ -void arm_cmplx_mag_fast_q15(const q15_t *pSrc, q15_t *pDst, uint32_t numSamples); + void arm_cmplx_mag_fast_q15( + const q15_t * pSrc, + q15_t * pDst, + uint32_t numSamples); -/** + + /** * @brief Q15 complex dot product * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector @@ -151,10 +199,15 @@ void arm_cmplx_mag_fast_q15(const q15_t *pSrc, q15_t *pDst, uint32_t numSamples) * @param[out] realResult real part of the result returned here * @param[out] imagResult imaginary part of the result returned here */ -void arm_cmplx_dot_prod_q15(const q15_t *pSrcA, const q15_t *pSrcB, uint32_t numSamples, - q31_t *realResult, q31_t *imagResult); + void arm_cmplx_dot_prod_q15( + const q15_t * pSrcA, + const q15_t * pSrcB, + uint32_t numSamples, + q31_t * realResult, + q31_t * imagResult); -/** + + /** * @brief Q31 complex dot product * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector @@ -162,10 +215,15 @@ void arm_cmplx_dot_prod_q15(const q15_t *pSrcA, const q15_t *pSrcB, uint32_t num * @param[out] realResult real part of the result returned here * @param[out] imagResult imaginary part of the result returned here */ -void arm_cmplx_dot_prod_q31(const q31_t *pSrcA, const q31_t *pSrcB, uint32_t numSamples, - q63_t *realResult, q63_t *imagResult); + void arm_cmplx_dot_prod_q31( + const q31_t * pSrcA, + const q31_t * pSrcB, + uint32_t numSamples, + q63_t * realResult, + q63_t * imagResult); -/** + + /** * @brief Floating-point complex dot product * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector @@ -173,68 +231,97 @@ void arm_cmplx_dot_prod_q31(const q31_t *pSrcA, const q31_t *pSrcB, uint32_t num * @param[out] realResult real part of the result returned here * @param[out] imagResult imaginary part of the result returned here */ -void arm_cmplx_dot_prod_f32(const float32_t *pSrcA, const float32_t *pSrcB, uint32_t numSamples, - float32_t *realResult, float32_t *imagResult); + void arm_cmplx_dot_prod_f32( + const float32_t * pSrcA, + const float32_t * pSrcB, + uint32_t numSamples, + float32_t * realResult, + float32_t * imagResult); -/** + + /** * @brief Q15 complex-by-real multiplication * @param[in] pSrcCmplx points to the complex input vector * @param[in] pSrcReal points to the real input vector * @param[out] pCmplxDst points to the complex output vector * @param[in] numSamples number of samples in each vector */ -void arm_cmplx_mult_real_q15(const q15_t *pSrcCmplx, const q15_t *pSrcReal, q15_t *pCmplxDst, - uint32_t numSamples); + void arm_cmplx_mult_real_q15( + const q15_t * pSrcCmplx, + const q15_t * pSrcReal, + q15_t * pCmplxDst, + uint32_t numSamples); -/** + + /** * @brief Q31 complex-by-real multiplication * @param[in] pSrcCmplx points to the complex input vector * @param[in] pSrcReal points to the real input vector * @param[out] pCmplxDst points to the complex output vector * @param[in] numSamples number of samples in each vector */ -void arm_cmplx_mult_real_q31(const q31_t *pSrcCmplx, const q31_t *pSrcReal, q31_t *pCmplxDst, - uint32_t numSamples); + void arm_cmplx_mult_real_q31( + const q31_t * pSrcCmplx, + const q31_t * pSrcReal, + q31_t * pCmplxDst, + uint32_t numSamples); -/** + + /** * @brief Floating-point complex-by-real multiplication * @param[in] pSrcCmplx points to the complex input vector * @param[in] pSrcReal points to the real input vector * @param[out] pCmplxDst points to the complex output vector * @param[in] numSamples number of samples in each vector */ -void arm_cmplx_mult_real_f32(const float32_t *pSrcCmplx, const float32_t *pSrcReal, - float32_t *pCmplxDst, uint32_t numSamples); + void arm_cmplx_mult_real_f32( + const float32_t * pSrcCmplx, + const float32_t * pSrcReal, + float32_t * pCmplxDst, + uint32_t numSamples); -/** + /** * @brief Q15 complex-by-complex multiplication * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] numSamples number of complex samples in each vector */ -void arm_cmplx_mult_cmplx_q15(const q15_t *pSrcA, const q15_t *pSrcB, q15_t *pDst, - uint32_t numSamples); + void arm_cmplx_mult_cmplx_q15( + const q15_t * pSrcA, + const q15_t * pSrcB, + q15_t * pDst, + uint32_t numSamples); -/** + + /** * @brief Q31 complex-by-complex multiplication * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] numSamples number of complex samples in each vector */ -void arm_cmplx_mult_cmplx_q31(const q31_t *pSrcA, const q31_t *pSrcB, q31_t *pDst, - uint32_t numSamples); + void arm_cmplx_mult_cmplx_q31( + const q31_t * pSrcA, + const q31_t * pSrcB, + q31_t * pDst, + uint32_t numSamples); -/** + + /** * @brief Floating-point complex-by-complex multiplication * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] numSamples number of complex samples in each vector */ -void arm_cmplx_mult_cmplx_f32(const float32_t *pSrcA, const float32_t *pSrcB, float32_t *pDst, - uint32_t numSamples); + void arm_cmplx_mult_cmplx_f32( + const float32_t * pSrcA, + const float32_t * pSrcB, + float32_t * pDst, + uint32_t numSamples); + + /** * @brief Floating-point complex-by-complex multiplication @@ -243,10 +330,15 @@ void arm_cmplx_mult_cmplx_f32(const float32_t *pSrcA, const float32_t *pSrcB, fl * @param[out] pDst points to the output vector * @param[in] numSamples number of complex samples in each vector */ -void arm_cmplx_mult_cmplx_f64(const float64_t *pSrcA, const float64_t *pSrcB, float64_t *pDst, - uint32_t numSamples); +void arm_cmplx_mult_cmplx_f64( +const float64_t * pSrcA, +const float64_t * pSrcB, + float64_t * pDst, + uint32_t numSamples); + + -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions_f16.h old mode 100644 new mode 100755 index 98f512b3a3b..bd147325f97 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions_f16.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _COMPLEX_MATH_FUNCTIONS_F16_H_ -#define _COMPLEX_MATH_FUNCTIONS_F16_H_ + +#ifndef COMPLEX_MATH_FUNCTIONS_F16_H_ +#define COMPLEX_MATH_FUNCTIONS_F16_H_ #include "arm_math_types_f16.h" #include "arm_math_memory.h" @@ -33,37 +34,47 @@ #include "dsp/utils.h" #include "dsp/fast_math_functions_f16.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #if defined(ARM_FLOAT16_SUPPORTED) -/** + /** * @brief Floating-point complex conjugate. * @param[in] pSrc points to the input vector * @param[out] pDst points to the output vector * @param[in] numSamples number of complex samples in each vector */ -void arm_cmplx_conj_f16(const float16_t *pSrc, float16_t *pDst, uint32_t numSamples); + void arm_cmplx_conj_f16( + const float16_t * pSrc, + float16_t * pDst, + uint32_t numSamples); -/** + /** * @brief Floating-point complex magnitude squared * @param[in] pSrc points to the complex input vector * @param[out] pDst points to the real output vector * @param[in] numSamples number of complex samples in the input vector */ -void arm_cmplx_mag_squared_f16(const float16_t *pSrc, float16_t *pDst, uint32_t numSamples); + void arm_cmplx_mag_squared_f16( + const float16_t * pSrc, + float16_t * pDst, + uint32_t numSamples); -/** + /** * @brief Floating-point complex magnitude * @param[in] pSrc points to the complex input vector * @param[out] pDst points to the real output vector * @param[in] numSamples number of complex samples in the input vector */ -void arm_cmplx_mag_f16(const float16_t *pSrc, float16_t *pDst, uint32_t numSamples); + void arm_cmplx_mag_f16( + const float16_t * pSrc, + float16_t * pDst, + uint32_t numSamples); -/** + /** * @brief Floating-point complex dot product * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector @@ -71,31 +82,41 @@ void arm_cmplx_mag_f16(const float16_t *pSrc, float16_t *pDst, uint32_t numSampl * @param[out] realResult real part of the result returned here * @param[out] imagResult imaginary part of the result returned here */ -void arm_cmplx_dot_prod_f16(const float16_t *pSrcA, const float16_t *pSrcB, uint32_t numSamples, - float16_t *realResult, float16_t *imagResult); + void arm_cmplx_dot_prod_f16( + const float16_t * pSrcA, + const float16_t * pSrcB, + uint32_t numSamples, + float16_t * realResult, + float16_t * imagResult); -/** + /** * @brief Floating-point complex-by-real multiplication * @param[in] pSrcCmplx points to the complex input vector * @param[in] pSrcReal points to the real input vector * @param[out] pCmplxDst points to the complex output vector * @param[in] numSamples number of samples in each vector */ -void arm_cmplx_mult_real_f16(const float16_t *pSrcCmplx, const float16_t *pSrcReal, - float16_t *pCmplxDst, uint32_t numSamples); + void arm_cmplx_mult_real_f16( + const float16_t * pSrcCmplx, + const float16_t * pSrcReal, + float16_t * pCmplxDst, + uint32_t numSamples); -/** + /** * @brief Floating-point complex-by-complex multiplication * @param[in] pSrcA points to the first input vector * @param[in] pSrcB points to the second input vector * @param[out] pDst points to the output vector * @param[in] numSamples number of complex samples in each vector */ -void arm_cmplx_mult_cmplx_f16(const float16_t *pSrcA, const float16_t *pSrcB, float16_t *pDst, - uint32_t numSamples); + void arm_cmplx_mult_cmplx_f16( + const float16_t * pSrcA, + const float16_t * pSrcB, + float16_t * pDst, + uint32_t numSamples); #endif /*defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions.h old mode 100644 new mode 100755 index a892b9ba8f4..5d5de98ea58 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _CONTROLLER_FUNCTIONS_H_ -#define _CONTROLLER_FUNCTIONS_H_ + +#ifndef CONTROLLER_FUNCTIONS_H_ +#define CONTROLLER_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -32,56 +33,82 @@ #include "dsp/none.h" #include "dsp/utils.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif -/** + /** * @brief Macros required for SINE and COSINE Controller functions */ -#define CONTROLLER_Q31_SHIFT (32 - 9) -/* 1.31(q31) Fixed value of 2/360 */ -/* -1 to +1 is divided into 360 values so total spacing is (2/360) */ -#define INPUT_SPACING 0xB60B61 - +#define CONTROLLER_Q31_SHIFT (32 - 9) + /* 1.31(q31) Fixed value of 2/360 */ + /* -1 to +1 is divided into 360 values so total spacing is (2/360) */ +#define INPUT_SPACING 0xB60B61 + /** * @defgroup groupController Controller Functions */ + /** - * @ingroup groupController - */ + @ingroup groupController + */ /** - * @addtogroup SinCos - * @{ - */ + @defgroup SinCos Sine Cosine + + Computes the trigonometric sine and cosine values using a combination of table lookup + and linear interpolation. + There are separate functions for Q31 and floating-point data types. + The input to the floating-point version is in degrees while the + fixed-point Q31 have a scaled input with the range + [-1 0.9999] mapping to [-180 +180] degrees. + + The floating point function also allows values that are out of the usual range. When this happens, the function will + take extra time to adjust the input value to the range of [-180 180]. + + The result is accurate to 5 digits after the decimal point. + The implementation is based on table lookup using 360 values together with linear interpolation. + The steps used are: + -# Calculation of the nearest integer table index. + -# Compute the fractional portion (fract) of the input. + -# Fetch the value corresponding to \c index from sine table to \c y0 and also value from \c index+1 to \c y1. + -# Sine value is computed as *psinVal = y0 + (fract * (y1 - y0)). + -# Fetch the value corresponding to \c index from cosine table to \c y0 and also value from \c index+1 to \c y1. + -# Cosine value is computed as *pcosVal = y0 + (fract * (y1 - y0)). + */ + /** * @brief Floating-point sin_cos function. * @param[in] theta input value in degrees * @param[out] pSinVal points to the processed sine output. * @param[out] pCosVal points to the processed cos output. */ -void arm_sin_cos_f32(float32_t theta, float32_t *pSinVal, float32_t *pCosVal); + void arm_sin_cos_f32( + float32_t theta, + float32_t * pSinVal, + float32_t * pCosVal); -/** + + /** * @brief Q31 sin_cos function. * @param[in] theta scaled input value in degrees * @param[out] pSinVal points to the processed sine output. * @param[out] pCosVal points to the processed cosine output. */ -void arm_sin_cos_q31(q31_t theta, q31_t *pSinVal, q31_t *pCosVal); + void arm_sin_cos_q31( + q31_t theta, + q31_t * pSinVal, + q31_t * pCosVal); -/** - * @} end of SinCos group - */ /** - * @ingroup groupController - */ - + @ingroup groupController + */ + /** * @defgroup PID PID Motor Control * @@ -140,106 +167,132 @@ void arm_sin_cos_q31(q31_t theta, q31_t *pSinVal, q31_t *pCosVal); * Refer to the function specific documentation below for usage guidelines. */ -/** + + /** + * @ingroup PID * @brief Instance structure for the Q15 PID Control. */ -typedef struct { - q15_t A0; /**< The derived gain, A0 = Kp + Ki + Kd . */ -#if !defined(ARM_MATH_DSP) - q15_t A1; /**< The derived gain A1 = -Kp - 2Kd */ - q15_t A2; /**< The derived gain A1 = Kd. */ + typedef struct + { + q15_t A0; /**< The derived gain, A0 = Kp + Ki + Kd . */ +#if !defined (ARM_MATH_DSP) + q15_t A1; /**< The derived gain A1 = -Kp - 2Kd */ + q15_t A2; /**< The derived gain A1 = Kd. */ #else - q31_t A1; /**< The derived gain A1 = -Kp - 2Kd | Kd.*/ + q31_t A1; /**< The derived gain A1 = -Kp - 2Kd | Kd.*/ #endif - q15_t state[3]; /**< The state array of length 3. */ - q15_t Kp; /**< The proportional gain. */ - q15_t Ki; /**< The integral gain. */ - q15_t Kd; /**< The derivative gain. */ -} arm_pid_instance_q15; - -/** + q15_t state[3]; /**< The state array of length 3. */ + q15_t Kp; /**< The proportional gain. */ + q15_t Ki; /**< The integral gain. */ + q15_t Kd; /**< The derivative gain. */ + } arm_pid_instance_q15; + + /** + * @ingroup PID * @brief Instance structure for the Q31 PID Control. */ -typedef struct { - q31_t A0; /**< The derived gain, A0 = Kp + Ki + Kd . */ - q31_t A1; /**< The derived gain, A1 = -Kp - 2Kd. */ - q31_t A2; /**< The derived gain, A2 = Kd . */ - q31_t state[3]; /**< The state array of length 3. */ - q31_t Kp; /**< The proportional gain. */ - q31_t Ki; /**< The integral gain. */ - q31_t Kd; /**< The derivative gain. */ -} arm_pid_instance_q31; - -/** + typedef struct + { + q31_t A0; /**< The derived gain, A0 = Kp + Ki + Kd . */ + q31_t A1; /**< The derived gain, A1 = -Kp - 2Kd. */ + q31_t A2; /**< The derived gain, A2 = Kd . */ + q31_t state[3]; /**< The state array of length 3. */ + q31_t Kp; /**< The proportional gain. */ + q31_t Ki; /**< The integral gain. */ + q31_t Kd; /**< The derivative gain. */ + } arm_pid_instance_q31; + + /** + * @ingroup PID * @brief Instance structure for the floating-point PID Control. */ -typedef struct { - float32_t A0; /**< The derived gain, A0 = Kp + Ki + Kd . */ - float32_t A1; /**< The derived gain, A1 = -Kp - 2Kd. */ - float32_t A2; /**< The derived gain, A2 = Kd . */ - float32_t state[3]; /**< The state array of length 3. */ - float32_t Kp; /**< The proportional gain. */ - float32_t Ki; /**< The integral gain. */ - float32_t Kd; /**< The derivative gain. */ -} arm_pid_instance_f32; + typedef struct + { + float32_t A0; /**< The derived gain, A0 = Kp + Ki + Kd . */ + float32_t A1; /**< The derived gain, A1 = -Kp - 2Kd. */ + float32_t A2; /**< The derived gain, A2 = Kd . */ + float32_t state[3]; /**< The state array of length 3. */ + float32_t Kp; /**< The proportional gain. */ + float32_t Ki; /**< The integral gain. */ + float32_t Kd; /**< The derivative gain. */ + } arm_pid_instance_f32; -/** + + + /** * @brief Initialization function for the floating-point PID Control. * @param[in,out] S points to an instance of the PID structure. * @param[in] resetStateFlag flag to reset the state. 0 = no change in state 1 = reset the state. */ -void arm_pid_init_f32(arm_pid_instance_f32 *S, int32_t resetStateFlag); + void arm_pid_init_f32( + arm_pid_instance_f32 * S, + int32_t resetStateFlag); -/** + + /** * @brief Reset function for the floating-point PID Control. * @param[in,out] S is an instance of the floating-point PID Control structure */ -void arm_pid_reset_f32(arm_pid_instance_f32 *S); + void arm_pid_reset_f32( + arm_pid_instance_f32 * S); -/** + + /** * @brief Initialization function for the Q31 PID Control. * @param[in,out] S points to an instance of the Q15 PID structure. * @param[in] resetStateFlag flag to reset the state. 0 = no change in state 1 = reset the state. */ -void arm_pid_init_q31(arm_pid_instance_q31 *S, int32_t resetStateFlag); + void arm_pid_init_q31( + arm_pid_instance_q31 * S, + int32_t resetStateFlag); -/** + + /** * @brief Reset function for the Q31 PID Control. * @param[in,out] S points to an instance of the Q31 PID Control structure */ -void arm_pid_reset_q31(arm_pid_instance_q31 *S); + void arm_pid_reset_q31( + arm_pid_instance_q31 * S); -/** + + /** * @brief Initialization function for the Q15 PID Control. * @param[in,out] S points to an instance of the Q15 PID structure. * @param[in] resetStateFlag flag to reset the state. 0 = no change in state 1 = reset the state. */ -void arm_pid_init_q15(arm_pid_instance_q15 *S, int32_t resetStateFlag); + void arm_pid_init_q15( + arm_pid_instance_q15 * S, + int32_t resetStateFlag); -/** + + /** * @brief Reset function for the Q15 PID Control. * @param[in,out] S points to an instance of the q15 PID Control structure */ -void arm_pid_reset_q15(arm_pid_instance_q15 *S); + void arm_pid_reset_q15( + arm_pid_instance_q15 * S); -/** - * @addtogroup PID - * @{ - */ -/** + + + + /** + * @ingroup PID * @brief Process function for the floating-point PID Control. * @param[in,out] S is an instance of the floating-point PID Control structure * @param[in] in input sample to process * @return processed output sample. */ -__STATIC_FORCEINLINE float32_t arm_pid_f32(arm_pid_instance_f32 *S, float32_t in) -{ + __STATIC_FORCEINLINE float32_t arm_pid_f32( + arm_pid_instance_f32 * S, + float32_t in) + { float32_t out; /* y[n] = y[n-1] + A0 * x[n] + A1 * x[n-1] + A2 * x[n-2] */ - out = (S->A0 * in) + (S->A1 * S->state[0]) + (S->A2 * S->state[1]) + (S->state[2]); + out = (S->A0 * in) + + (S->A1 * S->state[0]) + (S->A2 * S->state[1]) + (S->state[2]); /* Update state */ S->state[1] = S->state[0]; @@ -248,9 +301,11 @@ __STATIC_FORCEINLINE float32_t arm_pid_f32(arm_pid_instance_f32 *S, float32_t in /* return to application */ return (out); -} + + } /** + @ingroup PID @brief Process function for the Q31 PID Control. @param[in,out] S points to an instance of the Q31 PID Control structure @param[in] in input sample to process @@ -263,22 +318,24 @@ __STATIC_FORCEINLINE float32_t arm_pid_f32(arm_pid_instance_f32 *S, float32_t in In order to avoid overflows completely the input signal must be scaled down by 2 bits as there are four additions. After all multiply-accumulates are performed, the 2.62 accumulator is truncated to 1.32 format and then saturated to 1.31 format. */ -__STATIC_FORCEINLINE q31_t arm_pid_q31(arm_pid_instance_q31 *S, q31_t in) -{ +__STATIC_FORCEINLINE q31_t arm_pid_q31( + arm_pid_instance_q31 * S, + q31_t in) + { q63_t acc; q31_t out; /* acc = A0 * x[n] */ - acc = (q63_t)S->A0 * in; + acc = (q63_t) S->A0 * in; /* acc += A1 * x[n-1] */ - acc += (q63_t)S->A1 * S->state[0]; + acc += (q63_t) S->A1 * S->state[0]; /* acc += A2 * x[n-2] */ - acc += (q63_t)S->A2 * S->state[1]; + acc += (q63_t) S->A2 * S->state[1]; /* convert output to 1.31 format to add y[n-1] */ - out = (q31_t)(acc >> 31U); + out = (q31_t) (acc >> 31U); /* out += y[n-1] */ out += S->state[2]; @@ -290,9 +347,11 @@ __STATIC_FORCEINLINE q31_t arm_pid_q31(arm_pid_instance_q31 *S, q31_t in) /* return to application */ return (out); -} + } + /** + @ingroup PID @brief Process function for the Q15 PID Control. @param[in,out] S points to an instance of the Q15 PID Control structure @param[in] in input sample to process @@ -306,33 +365,35 @@ __STATIC_FORCEINLINE q31_t arm_pid_q31(arm_pid_instance_q31 *S, q31_t in) After all additions have been performed, the accumulator is truncated to 34.15 format by discarding low 15 bits. Lastly, the accumulator is saturated to yield a result in 1.15 format. */ -__STATIC_FORCEINLINE q15_t arm_pid_q15(arm_pid_instance_q15 *S, q15_t in) -{ +__STATIC_FORCEINLINE q15_t arm_pid_q15( + arm_pid_instance_q15 * S, + q15_t in) + { q63_t acc; q15_t out; -#if defined(ARM_MATH_DSP) +#if defined (ARM_MATH_DSP) /* Implementation of PID controller */ /* acc = A0 * x[n] */ - acc = (q31_t)__SMUAD((uint32_t)S->A0, (uint32_t)in); + acc = (q31_t) __SMUAD((uint32_t)S->A0, (uint32_t)in); /* acc += A1 * x[n-1] + A2 * x[n-2] */ - acc = (q63_t)__SMLALD((uint32_t)S->A1, (uint32_t)read_q15x2(S->state), (uint64_t)acc); + acc = (q63_t)__SMLALD((uint32_t)S->A1, (uint32_t)read_q15x2 (S->state), (uint64_t)acc); #else /* acc = A0 * x[n] */ - acc = ((q31_t)S->A0) * in; + acc = ((q31_t) S->A0) * in; /* acc += A1 * x[n-1] + A2 * x[n-2] */ - acc += (q31_t)S->A1 * S->state[0]; - acc += (q31_t)S->A2 * S->state[1]; + acc += (q31_t) S->A1 * S->state[0]; + acc += (q31_t) S->A2 * S->state[1]; #endif /* acc += y[n-1] */ - acc += (q31_t)S->state[2] << 15; + acc += (q31_t) S->state[2] << 15; /* saturate the output */ - out = (q15_t)(__SSAT((q31_t)(acc >> 15), 16)); + out = (q15_t) (__SSAT((q31_t)(acc >> 15), 16)); /* Update state */ S->state[1] = S->state[0]; @@ -341,17 +402,15 @@ __STATIC_FORCEINLINE q15_t arm_pid_q15(arm_pid_instance_q15 *S, q15_t in) /* return to application */ return (out); -} + } -/** - * @} end of PID group - */ -/** + + /** * @ingroup groupController */ -/** + /** * @defgroup park Vector Park Transform * * Forward Park transform converts the input two-coordinate vector to flux and torque components. @@ -375,12 +434,10 @@ __STATIC_FORCEINLINE q15_t arm_pid_q15(arm_pid_instance_q15 *S, q15_t in) * Refer to the function specific documentation below for usage guidelines. */ -/** - * @addtogroup park - * @{ - */ + -/** + /** + * @ingroup park * @brief Floating-point Park transform * @param[in] Ialpha input two-phase vector coordinate alpha * @param[in] Ibeta input two-phase vector coordinate beta @@ -388,22 +445,28 @@ __STATIC_FORCEINLINE q15_t arm_pid_q15(arm_pid_instance_q15 *S, q15_t in) * @param[out] pIq points to output rotor reference frame q * @param[in] sinVal sine value of rotation angle theta * @param[in] cosVal cosine value of rotation angle theta - * @return none * * The function implements the forward Park transform. * */ -__STATIC_FORCEINLINE void arm_park_f32(float32_t Ialpha, float32_t Ibeta, float32_t *pId, - float32_t *pIq, float32_t sinVal, float32_t cosVal) -{ + __STATIC_FORCEINLINE void arm_park_f32( + float32_t Ialpha, + float32_t Ibeta, + float32_t * pId, + float32_t * pIq, + float32_t sinVal, + float32_t cosVal) + { /* Calculate pId using the equation, pId = Ialpha * cosVal + Ibeta * sinVal */ *pId = Ialpha * cosVal + Ibeta * sinVal; /* Calculate pIq using the equation, pIq = - Ialpha * sinVal + Ibeta * cosVal */ *pIq = -Ialpha * sinVal + Ibeta * cosVal; -} + } + /** + @ingroup park @brief Park transform for Q31 version @param[in] Ialpha input two-phase vector coordinate alpha @param[in] Ibeta input two-phase vector coordinate beta @@ -411,47 +474,50 @@ __STATIC_FORCEINLINE void arm_park_f32(float32_t Ialpha, float32_t Ibeta, float3 @param[out] pIq points to output rotor reference frame q @param[in] sinVal sine value of rotation angle theta @param[in] cosVal cosine value of rotation angle theta - @return none \par Scaling and Overflow Behavior The function is implemented using an internal 32-bit accumulator. The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. There is saturation on the addition and subtraction, hence there is no risk of overflow. */ -__STATIC_FORCEINLINE void arm_park_q31(q31_t Ialpha, q31_t Ibeta, q31_t *pId, q31_t *pIq, - q31_t sinVal, q31_t cosVal) -{ - q31_t product1, product2; /* Temporary variables used to store intermediate results */ - q31_t product3, product4; /* Temporary variables used to store intermediate results */ +__STATIC_FORCEINLINE void arm_park_q31( + q31_t Ialpha, + q31_t Ibeta, + q31_t * pId, + q31_t * pIq, + q31_t sinVal, + q31_t cosVal) + { + q31_t product1, product2; /* Temporary variables used to store intermediate results */ + q31_t product3, product4; /* Temporary variables used to store intermediate results */ /* Intermediate product is calculated by (Ialpha * cosVal) */ - product1 = (q31_t)(((q63_t)(Ialpha) * (cosVal)) >> 31); + product1 = (q31_t) (((q63_t) (Ialpha) * (cosVal)) >> 31); /* Intermediate product is calculated by (Ibeta * sinVal) */ - product2 = (q31_t)(((q63_t)(Ibeta) * (sinVal)) >> 31); + product2 = (q31_t) (((q63_t) (Ibeta) * (sinVal)) >> 31); + /* Intermediate product is calculated by (Ialpha * sinVal) */ - product3 = (q31_t)(((q63_t)(Ialpha) * (sinVal)) >> 31); + product3 = (q31_t) (((q63_t) (Ialpha) * (sinVal)) >> 31); /* Intermediate product is calculated by (Ibeta * cosVal) */ - product4 = (q31_t)(((q63_t)(Ibeta) * (cosVal)) >> 31); + product4 = (q31_t) (((q63_t) (Ibeta) * (cosVal)) >> 31); /* Calculate pId by adding the two intermediate products 1 and 2 */ *pId = __QADD(product1, product2); /* Calculate pIq by subtracting the two intermediate products 3 from 4 */ *pIq = __QSUB(product4, product3); -} + } -/** - * @} end of park group - */ -/** + + /** * @ingroup groupController */ -/** + /** * @defgroup inv_park Vector Inverse Park transform * Inverse Park transform converts the input flux and torque components to two-coordinate vector. * @@ -468,12 +534,10 @@ __STATIC_FORCEINLINE void arm_park_q31(q31_t Ialpha, q31_t Ibeta, q31_t *pId, q3 * Refer to the function specific documentation below for usage guidelines. */ -/** - * @addtogroup inv_park - * @{ - */ + -/** + /** + * @ingroup inv_park * @brief Floating-point Inverse Park transform * @param[in] Id input coordinate of rotor reference frame d * @param[in] Iq input coordinate of rotor reference frame q @@ -481,19 +545,25 @@ __STATIC_FORCEINLINE void arm_park_q31(q31_t Ialpha, q31_t Ibeta, q31_t *pId, q3 * @param[out] pIbeta points to output two-phase orthogonal vector axis beta * @param[in] sinVal sine value of rotation angle theta * @param[in] cosVal cosine value of rotation angle theta - * @return none */ -__STATIC_FORCEINLINE void arm_inv_park_f32(float32_t Id, float32_t Iq, float32_t *pIalpha, - float32_t *pIbeta, float32_t sinVal, float32_t cosVal) -{ + __STATIC_FORCEINLINE void arm_inv_park_f32( + float32_t Id, + float32_t Iq, + float32_t * pIalpha, + float32_t * pIbeta, + float32_t sinVal, + float32_t cosVal) + { /* Calculate pIalpha using the equation, pIalpha = Id * cosVal - Iq * sinVal */ *pIalpha = Id * cosVal - Iq * sinVal; /* Calculate pIbeta using the equation, pIbeta = Id * sinVal + Iq * cosVal */ *pIbeta = Id * sinVal + Iq * cosVal; -} + } + /** + @ingroup inv_park @brief Inverse Park transform for Q31 version @param[in] Id input coordinate of rotor reference frame d @param[in] Iq input coordinate of rotor reference frame q @@ -501,47 +571,49 @@ __STATIC_FORCEINLINE void arm_inv_park_f32(float32_t Id, float32_t Iq, float32_t @param[out] pIbeta points to output two-phase orthogonal vector axis beta @param[in] sinVal sine value of rotation angle theta @param[in] cosVal cosine value of rotation angle theta - @return none @par Scaling and Overflow Behavior The function is implemented using an internal 32-bit accumulator. The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. There is saturation on the addition, hence there is no risk of overflow. */ -__STATIC_FORCEINLINE void arm_inv_park_q31(q31_t Id, q31_t Iq, q31_t *pIalpha, q31_t *pIbeta, - q31_t sinVal, q31_t cosVal) -{ - q31_t product1, product2; /* Temporary variables used to store intermediate results */ - q31_t product3, product4; /* Temporary variables used to store intermediate results */ +__STATIC_FORCEINLINE void arm_inv_park_q31( + q31_t Id, + q31_t Iq, + q31_t * pIalpha, + q31_t * pIbeta, + q31_t sinVal, + q31_t cosVal) + { + q31_t product1, product2; /* Temporary variables used to store intermediate results */ + q31_t product3, product4; /* Temporary variables used to store intermediate results */ /* Intermediate product is calculated by (Id * cosVal) */ - product1 = (q31_t)(((q63_t)(Id) * (cosVal)) >> 31); + product1 = (q31_t) (((q63_t) (Id) * (cosVal)) >> 31); /* Intermediate product is calculated by (Iq * sinVal) */ - product2 = (q31_t)(((q63_t)(Iq) * (sinVal)) >> 31); + product2 = (q31_t) (((q63_t) (Iq) * (sinVal)) >> 31); + /* Intermediate product is calculated by (Id * sinVal) */ - product3 = (q31_t)(((q63_t)(Id) * (sinVal)) >> 31); + product3 = (q31_t) (((q63_t) (Id) * (sinVal)) >> 31); /* Intermediate product is calculated by (Iq * cosVal) */ - product4 = (q31_t)(((q63_t)(Iq) * (cosVal)) >> 31); + product4 = (q31_t) (((q63_t) (Iq) * (cosVal)) >> 31); /* Calculate pIalpha by using the two intermediate products 1 and 2 */ *pIalpha = __QSUB(product1, product2); /* Calculate pIbeta by using the two intermediate products 3 and 4 */ *pIbeta = __QADD(product4, product3); -} + } -/** - * @} end of Inverse park group - */ /** * @ingroup groupController */ -/** + /** * @defgroup clarke Vector Clarke Transform * Forward Clarke transform converts the instantaneous stator phases into a two-coordinate time invariant vector. * Generally the Clarke transform uses three-phase currents Ia, Ib and Ic to calculate currents @@ -563,69 +635,71 @@ __STATIC_FORCEINLINE void arm_inv_park_q31(q31_t Id, q31_t Iq, q31_t *pIalpha, q * Refer to the function specific documentation below for usage guidelines. */ -/** - * @addtogroup clarke - * @{ - */ -/** + /** * + * @ingroup clarke * @brief Floating-point Clarke transform * @param[in] Ia input three-phase coordinate a * @param[in] Ib input three-phase coordinate b * @param[out] pIalpha points to output two-phase orthogonal vector axis alpha * @param[out] pIbeta points to output two-phase orthogonal vector axis beta - * @return none */ -__STATIC_FORCEINLINE void arm_clarke_f32(float32_t Ia, float32_t Ib, float32_t *pIalpha, - float32_t *pIbeta) -{ + __STATIC_FORCEINLINE void arm_clarke_f32( + float32_t Ia, + float32_t Ib, + float32_t * pIalpha, + float32_t * pIbeta) + { /* Calculate pIalpha using the equation, pIalpha = Ia */ *pIalpha = Ia; /* Calculate pIbeta using the equation, pIbeta = (1/sqrt(3)) * Ia + (2/sqrt(3)) * Ib */ *pIbeta = (0.57735026919f * Ia + 1.15470053838f * Ib); -} + } + /** + @ingroup clarke @brief Clarke transform for Q31 version @param[in] Ia input three-phase coordinate a @param[in] Ib input three-phase coordinate b @param[out] pIalpha points to output two-phase orthogonal vector axis alpha @param[out] pIbeta points to output two-phase orthogonal vector axis beta - @return none \par Scaling and Overflow Behavior The function is implemented using an internal 32-bit accumulator. The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. There is saturation on the addition, hence there is no risk of overflow. */ -__STATIC_FORCEINLINE void arm_clarke_q31(q31_t Ia, q31_t Ib, q31_t *pIalpha, q31_t *pIbeta) -{ - q31_t product1, product2; /* Temporary variables used to store intermediate results */ +__STATIC_FORCEINLINE void arm_clarke_q31( + q31_t Ia, + q31_t Ib, + q31_t * pIalpha, + q31_t * pIbeta) + { + q31_t product1, product2; /* Temporary variables used to store intermediate results */ /* Calculating pIalpha from Ia by equation pIalpha = Ia */ *pIalpha = Ia; /* Intermediate product is calculated by (1/(sqrt(3)) * Ia) */ - product1 = (q31_t)(((q63_t)Ia * 0x24F34E8B) >> 30); + product1 = (q31_t) (((q63_t) Ia * 0x24F34E8B) >> 30); /* Intermediate product is calculated by (2/sqrt(3) * Ib) */ - product2 = (q31_t)(((q63_t)Ib * 0x49E69D16) >> 30); + product2 = (q31_t) (((q63_t) Ib * 0x49E69D16) >> 30); /* pIbeta is calculated by adding the intermediate products */ *pIbeta = __QADD(product1, product2); -} + } -/** - * @} end of clarke group - */ -/** + + /** * @ingroup groupController */ -/** + /** * @defgroup inv_clarke Vector Inverse Clarke Transform * Inverse Clarke transform converts the two-coordinate time invariant vector into instantaneous stator phases. * @@ -641,64 +715,70 @@ __STATIC_FORCEINLINE void arm_clarke_q31(q31_t Ia, q31_t Ib, q31_t *pIalpha, q31 * Refer to the function specific documentation below for usage guidelines. */ -/** - * @addtogroup inv_clarke - * @{ - */ + -/** + /** + * @ingroup inv_clarke * @brief Floating-point Inverse Clarke transform * @param[in] Ialpha input two-phase orthogonal vector axis alpha * @param[in] Ibeta input two-phase orthogonal vector axis beta * @param[out] pIa points to output three-phase coordinate a * @param[out] pIb points to output three-phase coordinate b - * @return none */ -__STATIC_FORCEINLINE void arm_inv_clarke_f32(float32_t Ialpha, float32_t Ibeta, float32_t *pIa, - float32_t *pIb) -{ + __STATIC_FORCEINLINE void arm_inv_clarke_f32( + float32_t Ialpha, + float32_t Ibeta, + float32_t * pIa, + float32_t * pIb) + { /* Calculating pIa from Ialpha by equation pIa = Ialpha */ *pIa = Ialpha; /* Calculating pIb from Ialpha and Ibeta by equation pIb = -(1/2) * Ialpha + (sqrt(3)/2) * Ibeta */ *pIb = -0.5f * Ialpha + 0.8660254039f * Ibeta; -} + } + /** + @ingroup inv_clarke @brief Inverse Clarke transform for Q31 version @param[in] Ialpha input two-phase orthogonal vector axis alpha @param[in] Ibeta input two-phase orthogonal vector axis beta @param[out] pIa points to output three-phase coordinate a @param[out] pIb points to output three-phase coordinate b - @return none \par Scaling and Overflow Behavior The function is implemented using an internal 32-bit accumulator. The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format. There is saturation on the subtraction, hence there is no risk of overflow. */ -__STATIC_FORCEINLINE void arm_inv_clarke_q31(q31_t Ialpha, q31_t Ibeta, q31_t *pIa, q31_t *pIb) -{ - q31_t product1, product2; /* Temporary variables used to store intermediate results */ +__STATIC_FORCEINLINE void arm_inv_clarke_q31( + q31_t Ialpha, + q31_t Ibeta, + q31_t * pIa, + q31_t * pIb) + { + q31_t product1, product2; /* Temporary variables used to store intermediate results */ /* Calculating pIa from Ialpha by equation pIa = Ialpha */ *pIa = Ialpha; /* Intermediate product is calculated by (1/(2*sqrt(3)) * Ia) */ - product1 = (q31_t)(((q63_t)(Ialpha) * (0x40000000)) >> 31); + product1 = (q31_t) (((q63_t) (Ialpha) * (0x40000000)) >> 31); /* Intermediate product is calculated by (1/sqrt(3) * pIb) */ - product2 = (q31_t)(((q63_t)(Ibeta) * (0x6ED9EBA1)) >> 31); + product2 = (q31_t) (((q63_t) (Ibeta) * (0x6ED9EBA1)) >> 31); /* pIb is calculated by subtracting the products */ *pIb = __QSUB(product2, product1); -} + } + + + -/** - * @} end of inv_clarke group - */ -#ifdef __cplusplus + +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions_f16.h old mode 100644 new mode 100755 index d2e03156351..a4622ec3d5d --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions_f16.h @@ -23,16 +23,18 @@ * limitations under the License. */ -#ifndef _CONTROLLER_FUNCTIONS_F16_H_ -#define _CONTROLLER_FUNCTIONS_F16_H_ + +#ifndef CONTROLLER_FUNCTIONS_F16_H_ +#define CONTROLLER_FUNCTIONS_F16_H_ -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #if defined(ARM_FLOAT16_SUPPORTED) #endif /*defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/debug.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/debug.h new file mode 100644 index 00000000000..b98e038931b --- /dev/null +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/debug.h @@ -0,0 +1,146 @@ +/****************************************************************************** + * @file basic_math_functions.h + * @brief Public header file for CMSIS DSP Library + * @version V1.10.0 + * @date 08 July 2021 + * Target Processor: Cortex-M and Cortex-A cores + ******************************************************************************/ +/* + * Copyright (c) 2010-2020 Arm Limited or its affiliates. All rights reserved. + * + * SPDX-License-Identifier: Apache-2.0 + * + * Licensed under the Apache License, Version 2.0 (the License); you may + * not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an AS IS BASIS, WITHOUT + * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + + +#ifndef DEBUG_FUNCTIONS_H_ +#define DEBUG_FUNCTIONS_H_ + +#include "arm_math_types.h" +#include "arm_math_memory.h" + +#include "dsp/none.h" +#include "dsp/utils.h" + +#include "dsp/matrix_functions.h" +#include "dsp/matrix_functions_f16.h" + +#include + +#ifdef __cplusplus +extern "C" +{ +#endif + +#if defined(ARM_FLOAT16_SUPPORTED) +#define PROW_f16(S,NB) \ +{ \ + printf("{%f",(double)(S)[0]); \ + for(unsigned int i=1;i<(NB) ;i++) \ + { \ + printf(",%f",(double)(S)[i]);\ + } \ + printf("}"); \ +}; + +#define PV_f16(S,V,NB)\ +{ \ + printf("%s=",(S)); \ + PROW_f16((V),(NB)); \ + printf(";\n"); \ +}; + +#define PM_f16(S,M) \ +{ \ + printf("%s={",(S)); \ + for(unsigned int row=0;row<(M)->numRows;row++) \ + { \ + if (row != 0) \ + { \ + printf("\n,"); \ + } \ + PROW_f16((M)->pData + row * (M)->numCols, (M)->numCols);\ + } \ + printf("};\n"); \ +} + +#endif + +#define PROW_f32(S,NB) \ +{ \ + printf("{%f",(double)(S)[0]); \ + for(unsigned int i=1;i<(NB) ;i++) \ + { \ + printf(",%f",(double)(S)[i]);\ + } \ + printf("}"); \ +}; + +#define PV_f32(S,V,NB)\ +{ \ + printf("%s=",(S)); \ + PROW_f32((V),(NB)); \ + printf(";\n"); \ +}; + +#define PM_f32(S,M) \ +{ \ + printf("%s={",(S)); \ + for(unsigned int row=0;row<(M)->numRows;row++) \ + { \ + if (row != 0) \ + { \ + printf("\n,"); \ + } \ + PROW_f32((M)->pData + row * (M)->numCols, (M)->numCols);\ + } \ + printf("};\n"); \ +} + +#define PROW_f64(S,NB) \ +{ \ + printf("{%.20g",(double)(S)[0]); \ + for(unsigned int i=1;i<(NB) ;i++) \ + { \ + printf(",%.20g",(double)(S)[i]);\ + } \ + printf("}"); \ +}; + +#define PV_f64(S,V,NB) \ +{ \ + printf("%s=",(S)); \ + PROW_f64((V),(NB));\ + printf(";\n"); \ +}; + +#define PM_f64(S,M) \ +{ \ + printf("%s={",(S)); \ + for(unsigned int row=0;row<(M)->numRows;row++) \ + { \ + if (row != 0) \ + { \ + printf("\n,"); \ + } \ + PROW_f64((M)->pData + row * (M)->numCols, (M)->numCols);\ + } \ + printf("};\n"); \ +} + +#ifdef __cplusplus +} +#endif + +#endif /* ifndef _DEBUG_FUNCTIONS_H_ */ diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions.h old mode 100644 new mode 100755 index 2273b645261..995efab8b63 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _DISTANCE_FUNCTIONS_H_ -#define _DISTANCE_FUNCTIONS_H_ + +#ifndef DISTANCE_FUNCTIONS_H_ +#define DISTANCE_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -35,13 +36,16 @@ #include "dsp/statistics_functions.h" #include "dsp/basic_math_functions.h" #include "dsp/fast_math_functions.h" +#include "dsp/matrix_functions.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif + /** - * @defgroup groupDistance Distance functions + * @defgroup groupDistance Distance Functions * * Distance functions for use with clustering algorithms. * There are distance functions for float vectors and boolean vectors. @@ -49,11 +53,11 @@ extern "C" { */ /* 6.14 bug */ -#if defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6100100) && (__ARMCC_VERSION < 6150001) - +#if defined (__ARMCC_VERSION) && (__ARMCC_VERSION >= 6100100) && (__ARMCC_VERSION < 6150001) + __attribute__((weak)) float __powisf2(float a, int b); -#endif +#endif /** * @brief Euclidean distance between two vectors @@ -64,7 +68,7 @@ __attribute__((weak)) float __powisf2(float a, int b); * */ -float32_t arm_euclidean_distance_f32(const float32_t *pA, const float32_t *pB, uint32_t blockSize); +float32_t arm_euclidean_distance_f32(const float32_t *pA,const float32_t *pB, uint32_t blockSize); /** * @brief Euclidean distance between two vectors @@ -75,7 +79,7 @@ float32_t arm_euclidean_distance_f32(const float32_t *pA, const float32_t *pB, u * */ -float64_t arm_euclidean_distance_f64(const float64_t *pA, const float64_t *pB, uint32_t blockSize); +float64_t arm_euclidean_distance_f64(const float64_t *pA,const float64_t *pB, uint32_t blockSize); /** * @brief Bray-Curtis distance between two vectors @@ -85,7 +89,7 @@ float64_t arm_euclidean_distance_f64(const float64_t *pA, const float64_t *pB, u * @return distance * */ -float32_t arm_braycurtis_distance_f32(const float32_t *pA, const float32_t *pB, uint32_t blockSize); +float32_t arm_braycurtis_distance_f32(const float32_t *pA,const float32_t *pB, uint32_t blockSize); /** * @brief Canberra distance between two vectors @@ -100,7 +104,8 @@ float32_t arm_braycurtis_distance_f32(const float32_t *pA, const float32_t *pB, * @return distance * */ -float32_t arm_canberra_distance_f32(const float32_t *pA, const float32_t *pB, uint32_t blockSize); +float32_t arm_canberra_distance_f32(const float32_t *pA,const float32_t *pB, uint32_t blockSize); + /** * @brief Chebyshev distance between two vectors @@ -110,7 +115,8 @@ float32_t arm_canberra_distance_f32(const float32_t *pA, const float32_t *pB, ui * @return distance * */ -float32_t arm_chebyshev_distance_f32(const float32_t *pA, const float32_t *pB, uint32_t blockSize); +float32_t arm_chebyshev_distance_f32(const float32_t *pA,const float32_t *pB, uint32_t blockSize); + /** * @brief Chebyshev distance between two vectors @@ -120,7 +126,8 @@ float32_t arm_chebyshev_distance_f32(const float32_t *pA, const float32_t *pB, u * @return distance * */ -float64_t arm_chebyshev_distance_f64(const float64_t *pA, const float64_t *pB, uint32_t blockSize); +float64_t arm_chebyshev_distance_f64(const float64_t *pA,const float64_t *pB, uint32_t blockSize); + /** * @brief Cityblock (Manhattan) distance between two vectors @@ -130,7 +137,7 @@ float64_t arm_chebyshev_distance_f64(const float64_t *pA, const float64_t *pB, u * @return distance * */ -float32_t arm_cityblock_distance_f32(const float32_t *pA, const float32_t *pB, uint32_t blockSize); +float32_t arm_cityblock_distance_f32(const float32_t *pA,const float32_t *pB, uint32_t blockSize); /** * @brief Cityblock (Manhattan) distance between two vectors @@ -140,7 +147,7 @@ float32_t arm_cityblock_distance_f32(const float32_t *pA, const float32_t *pB, u * @return distance * */ -float64_t arm_cityblock_distance_f64(const float64_t *pA, const float64_t *pB, uint32_t blockSize); +float64_t arm_cityblock_distance_f64(const float64_t *pA,const float64_t *pB, uint32_t blockSize); /** * @brief Correlation distance between two vectors @@ -153,7 +160,7 @@ float64_t arm_cityblock_distance_f64(const float64_t *pA, const float64_t *pB, u * @return distance * */ -float32_t arm_correlation_distance_f32(float32_t *pA, float32_t *pB, uint32_t blockSize); +float32_t arm_correlation_distance_f32(float32_t *pA,float32_t *pB, uint32_t blockSize); /** * @brief Cosine distance between two vectors @@ -165,7 +172,7 @@ float32_t arm_correlation_distance_f32(float32_t *pA, float32_t *pB, uint32_t bl * */ -float32_t arm_cosine_distance_f32(const float32_t *pA, const float32_t *pB, uint32_t blockSize); +float32_t arm_cosine_distance_f32(const float32_t *pA,const float32_t *pB, uint32_t blockSize); /** * @brief Cosine distance between two vectors @@ -177,7 +184,7 @@ float32_t arm_cosine_distance_f32(const float32_t *pA, const float32_t *pB, uint * */ -float64_t arm_cosine_distance_f64(const float64_t *pA, const float64_t *pB, uint32_t blockSize); +float64_t arm_cosine_distance_f64(const float64_t *pA,const float64_t *pB, uint32_t blockSize); /** * @brief Jensen-Shannon distance between two vectors @@ -199,8 +206,7 @@ float64_t arm_cosine_distance_f64(const float64_t *pA, const float64_t *pB, uint * */ -float32_t arm_jensenshannon_distance_f32(const float32_t *pA, const float32_t *pB, - uint32_t blockSize); +float32_t arm_jensenshannon_distance_f32(const float32_t *pA,const float32_t *pB,uint32_t blockSize); /** * @brief Minkowski distance between two vectors @@ -213,8 +219,9 @@ float32_t arm_jensenshannon_distance_f32(const float32_t *pA, const float32_t *p * */ -float32_t arm_minkowski_distance_f32(const float32_t *pA, const float32_t *pB, int32_t order, - uint32_t blockSize); + + +float32_t arm_minkowski_distance_f32(const float32_t *pA,const float32_t *pB, int32_t order, uint32_t blockSize); /** * @brief Dice distance between two vectors @@ -227,6 +234,7 @@ float32_t arm_minkowski_distance_f32(const float32_t *pA, const float32_t *pB, i * */ + float32_t arm_dice_distance(const uint32_t *pA, const uint32_t *pB, uint32_t numberOfBools); /** @@ -275,8 +283,7 @@ float32_t arm_kulsinski_distance(const uint32_t *pA, const uint32_t *pB, uint32_ * */ -float32_t arm_rogerstanimoto_distance(const uint32_t *pA, const uint32_t *pB, - uint32_t numberOfBools); +float32_t arm_rogerstanimoto_distance(const uint32_t *pA, const uint32_t *pB, uint32_t numberOfBools); /** * @brief Russell-Rao distance between two vectors @@ -300,8 +307,7 @@ float32_t arm_russellrao_distance(const uint32_t *pA, const uint32_t *pB, uint32 * */ -float32_t arm_sokalmichener_distance(const uint32_t *pA, const uint32_t *pB, - uint32_t numberOfBools); +float32_t arm_sokalmichener_distance(const uint32_t *pA, const uint32_t *pB, uint32_t numberOfBools); /** * @brief Sokal-Sneath distance between two vectors @@ -327,7 +333,53 @@ float32_t arm_sokalsneath_distance(const uint32_t *pA, const uint32_t *pB, uint3 float32_t arm_yule_distance(const uint32_t *pA, const uint32_t *pB, uint32_t numberOfBools); -#ifdef __cplusplus +typedef enum + { + ARM_DTW_SAKOE_CHIBA_WINDOW = 1, + /*ARM_DTW_ITAKURA_WINDOW = 2,*/ + ARM_DTW_SLANTED_BAND_WINDOW = 3 + } arm_dtw_window; + +/** + * @brief Window for dynamic time warping computation + * @param[in] windowType Type of window + * @param[in] windowSize Window size + * @param[in,out] pWindow Window + * @return Error if window type not recognized + * + */ +arm_status arm_dtw_init_window_q7(const arm_dtw_window windowType, + const int32_t windowSize, + arm_matrix_instance_q7 *pWindow); + +/** + * @brief Dynamic Time Warping distance + * @param[in] pDistance Distance matrix (Query rows * Template columns) + * @param[in] pWindow Windowing (can be NULL if no windowing used) + * @param[out] pDTW Temporary cost buffer (same size) + * @param[out] distance Distance + * @return Error in case no path can be found with window constraint + * + */ + +arm_status arm_dtw_distance_f32(const arm_matrix_instance_f32 *pDistance, + const arm_matrix_instance_q7 *pWindow, + arm_matrix_instance_f32 *pDTW, + float32_t *distance); + + +/** + * @brief Mapping between query and template + * @param[in] pDTW Cost matrix (Query rows * Template columns) + * @param[out] pPath Warping path in cost matrix 2*(nb rows + nb columns) + * @param[out] pathLength Length of path in number of points + * + */ + +void arm_dtw_path_f32(const arm_matrix_instance_f32 *pDTW, + int16_t *pPath, + uint32_t *pathLength); +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions_f16.h old mode 100644 new mode 100755 index 089633c7e09..224d8149974 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions_f16.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _DISTANCE_FUNCTIONS_F16_H_ -#define _DISTANCE_FUNCTIONS_F16_H_ + +#ifndef DISTANCE_FUNCTIONS_F16_H_ +#define DISTANCE_FUNCTIONS_F16_H_ #include "arm_math_types_f16.h" #include "arm_math_memory.h" @@ -33,18 +34,19 @@ #include "dsp/utils.h" /* 6.14 bug */ -#if defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6100100) && (__ARMCC_VERSION < 6150001) +#if defined (__ARMCC_VERSION) && (__ARMCC_VERSION >= 6100100) && (__ARMCC_VERSION < 6150001) /* Defined in minkowski_f32 */ __attribute__((weak)) float __powisf2(float a, int b); -#endif +#endif #include "dsp/statistics_functions_f16.h" #include "dsp/basic_math_functions_f16.h" #include "dsp/fast_math_functions_f16.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #if defined(ARM_FLOAT16_SUPPORTED) @@ -55,10 +57,9 @@ extern "C" { * @param[in] pB Second vector * @param[in] blockSize vector length * @return distance - * */ +float16_t arm_euclidean_distance_f16(const float16_t *pA,const float16_t *pB, uint32_t blockSize); -float16_t arm_euclidean_distance_f16(const float16_t *pA, const float16_t *pB, uint32_t blockSize); /** * @brief Bray-Curtis distance between two vectors @@ -66,9 +67,8 @@ float16_t arm_euclidean_distance_f16(const float16_t *pA, const float16_t *pB, u * @param[in] pB Second vector * @param[in] blockSize vector length * @return distance - * */ -float16_t arm_braycurtis_distance_f16(const float16_t *pA, const float16_t *pB, uint32_t blockSize); +float16_t arm_braycurtis_distance_f16(const float16_t *pA,const float16_t *pB, uint32_t blockSize); /** * @brief Canberra distance between two vectors @@ -81,9 +81,9 @@ float16_t arm_braycurtis_distance_f16(const float16_t *pA, const float16_t *pB, * @param[in] pB Second vector * @param[in] blockSize vector length * @return distance - * */ -float16_t arm_canberra_distance_f16(const float16_t *pA, const float16_t *pB, uint32_t blockSize); +float16_t arm_canberra_distance_f16(const float16_t *pA,const float16_t *pB, uint32_t blockSize); + /** * @brief Chebyshev distance between two vectors @@ -91,9 +91,9 @@ float16_t arm_canberra_distance_f16(const float16_t *pA, const float16_t *pB, ui * @param[in] pB Second vector * @param[in] blockSize vector length * @return distance - * */ -float16_t arm_chebyshev_distance_f16(const float16_t *pA, const float16_t *pB, uint32_t blockSize); +float16_t arm_chebyshev_distance_f16(const float16_t *pA,const float16_t *pB, uint32_t blockSize); + /** * @brief Cityblock (Manhattan) distance between two vectors @@ -101,9 +101,9 @@ float16_t arm_chebyshev_distance_f16(const float16_t *pA, const float16_t *pB, u * @param[in] pB Second vector * @param[in] blockSize vector length * @return distance - * */ -float16_t arm_cityblock_distance_f16(const float16_t *pA, const float16_t *pB, uint32_t blockSize); +float16_t arm_cityblock_distance_f16(const float16_t *pA,const float16_t *pB, uint32_t blockSize); + /** * @brief Correlation distance between two vectors @@ -114,9 +114,9 @@ float16_t arm_cityblock_distance_f16(const float16_t *pA, const float16_t *pB, u * @param[in] pB Second vector * @param[in] blockSize vector length * @return distance - * */ -float16_t arm_correlation_distance_f16(float16_t *pA, float16_t *pB, uint32_t blockSize); +float16_t arm_correlation_distance_f16(float16_t *pA,float16_t *pB, uint32_t blockSize); + /** * @brief Cosine distance between two vectors @@ -125,10 +125,9 @@ float16_t arm_correlation_distance_f16(float16_t *pA, float16_t *pB, uint32_t bl * @param[in] pB Second vector * @param[in] blockSize vector length * @return distance - * */ +float16_t arm_cosine_distance_f16(const float16_t *pA,const float16_t *pB, uint32_t blockSize); -float16_t arm_cosine_distance_f16(const float16_t *pA, const float16_t *pB, uint32_t blockSize); /** * @brief Jensen-Shannon distance between two vectors @@ -147,11 +146,9 @@ float16_t arm_cosine_distance_f16(const float16_t *pA, const float16_t *pB, uint * @param[in] pB Second vector * @param[in] blockSize vector length * @return distance - * */ +float16_t arm_jensenshannon_distance_f16(const float16_t *pA,const float16_t *pB,uint32_t blockSize); -float16_t arm_jensenshannon_distance_f16(const float16_t *pA, const float16_t *pB, - uint32_t blockSize); /** * @brief Minkowski distance between two vectors @@ -161,14 +158,12 @@ float16_t arm_jensenshannon_distance_f16(const float16_t *pA, const float16_t *p * @param[in] n Norm order (>= 2) * @param[in] blockSize vector length * @return distance - * */ +float16_t arm_minkowski_distance_f16(const float16_t *pA,const float16_t *pB, int32_t order, uint32_t blockSize); -float16_t arm_minkowski_distance_f16(const float16_t *pA, const float16_t *pB, int32_t order, - uint32_t blockSize); #endif /*defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions.h old mode 100644 new mode 100755 index a0bf53c3120..8e600ccff30 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _FAST_MATH_FUNCTIONS_H_ -#define _FAST_MATH_FUNCTIONS_H_ + +#ifndef FAST_MATH_FUNCTIONS_H_ +#define FAST_MATH_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -34,22 +35,31 @@ #include "dsp/basic_math_functions.h" -#ifdef __cplusplus -extern "C" { +#include + +#ifdef __cplusplus +extern "C" +{ #endif -/** + /** * @brief Macros required for SINE and COSINE Fast math approximations */ -#define FAST_MATH_TABLE_SIZE 512 -#define FAST_MATH_Q31_SHIFT (32 - 10) -#define FAST_MATH_Q15_SHIFT (16 - 10) - +#define FAST_MATH_TABLE_SIZE 512 +#define FAST_MATH_Q31_SHIFT (32 - 10) +#define FAST_MATH_Q15_SHIFT (16 - 10) + #ifndef PI -#define PI 3.14159265358979f + #define PI 3.14159265358979f #endif +#ifndef PI_F64 + #define PI_F64 3.14159265358979323846 +#endif + + + /** * @defgroup groupFastMath Fast Math Functions * This set of functions provides a fast approximation to sine, cosine, and square root. @@ -59,125 +69,135 @@ extern "C" { * */ -/** - * @ingroup groupFastMath - */ - -/** - @addtogroup sin - @{ - */ -/** + /** * @brief Fast approximation to the trigonometric sine function for floating-point data. * @param[in] x input value in radians. * @return sin(x). */ -float32_t arm_sin_f32(float32_t x); + float32_t arm_sin_f32( + float32_t x); -/** + + /** * @brief Fast approximation to the trigonometric sine function for Q31 data. * @param[in] x Scaled input value in radians. * @return sin(x). */ -q31_t arm_sin_q31(q31_t x); + q31_t arm_sin_q31( + q31_t x); -/** + /** * @brief Fast approximation to the trigonometric sine function for Q15 data. * @param[in] x Scaled input value in radians. * @return sin(x). */ -q15_t arm_sin_q15(q15_t x); + q15_t arm_sin_q15( + q15_t x); -/** - @} end of sin group - */ - -/** - @addtogroup cos - @{ - */ -/** + /** * @brief Fast approximation to the trigonometric cosine function for floating-point data. * @param[in] x input value in radians. * @return cos(x). */ -float32_t arm_cos_f32(float32_t x); + float32_t arm_cos_f32( + float32_t x); -/** + + /** * @brief Fast approximation to the trigonometric cosine function for Q31 data. * @param[in] x Scaled input value in radians. * @return cos(x). */ -q31_t arm_cos_q31(q31_t x); + q31_t arm_cos_q31( + q31_t x); -/** + + /** * @brief Fast approximation to the trigonometric cosine function for Q15 data. * @param[in] x Scaled input value in radians. * @return cos(x). */ -q15_t arm_cos_q15(q15_t x); + q15_t arm_cos_q15( + q15_t x); -/** - @} end of cos group - */ /** @brief Floating-point vector of log values. @param[in] pSrc points to the input vector @param[out] pDst points to the output vector @param[in] blockSize number of samples in each vector - @return none */ -void arm_vlog_f32(const float32_t *pSrc, float32_t *pDst, uint32_t blockSize); + void arm_vlog_f32( + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + /** @brief Floating-point vector of log values. @param[in] pSrc points to the input vector @param[out] pDst points to the output vector @param[in] blockSize number of samples in each vector - @return none */ -void arm_vlog_f64(const float64_t *pSrc, float64_t *pDst, uint32_t blockSize); + void arm_vlog_f64( + const float64_t * pSrc, + float64_t * pDst, + uint32_t blockSize); -/** + + + /** * @brief q31 vector of log values. * @param[in] pSrc points to the input vector in q31 * @param[out] pDst points to the output vector in q5.26 * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_vlog_q31(const q31_t *pSrc, q31_t *pDst, uint32_t blockSize); + void arm_vlog_q31(const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + /** * @brief q15 vector of log values. * @param[in] pSrc points to the input vector in q15 * @param[out] pDst points to the output vector in q4.11 * @param[in] blockSize number of samples in each vector - * @return none */ -void arm_vlog_q15(const q15_t *pSrc, q15_t *pDst, uint32_t blockSize); + void arm_vlog_q15(const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + + /** @brief Floating-point vector of exp values. @param[in] pSrc points to the input vector @param[out] pDst points to the output vector @param[in] blockSize number of samples in each vector - @return none */ -void arm_vexp_f32(const float32_t *pSrc, float32_t *pDst, uint32_t blockSize); + void arm_vexp_f32( + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + /** @brief Floating-point vector of exp values. @param[in] pSrc points to the input vector @param[out] pDst points to the output vector @param[in] blockSize number of samples in each vector - @return none */ -void arm_vexp_f64(const float64_t *pSrc, float64_t *pDst, uint32_t blockSize); + void arm_vexp_f64( + const float64_t * pSrc, + float64_t * pDst, + uint32_t blockSize); -/** + + + /** * @defgroup SQRT Square Root * * Computes the square root of a number. @@ -197,7 +217,8 @@ void arm_vexp_f64(const float64_t *pSrc, float64_t *pDst, uint32_t blockSize); * */ -/** + + /** * @addtogroup SQRT * @{ */ @@ -210,33 +231,49 @@ void arm_vexp_f64(const float64_t *pSrc, float64_t *pDst, uint32_t blockSize); - \ref ARM_MATH_SUCCESS : input value is positive - \ref ARM_MATH_ARGUMENT_ERROR : input value is negative; *pOut is set to 0 */ -__STATIC_FORCEINLINE arm_status arm_sqrt_f32(const float32_t in, float32_t *pOut) -{ - if (in >= 0.0f) { -#if defined(__CC_ARM) -#if defined __TARGET_FPU_VFP - *pOut = __sqrtf(in); -#else - *pOut = sqrtf(in); -#endif - -#elif defined(__ICCARM__) -#if defined __ARMVFP__ - __ASM("VSQRT.F32 %0,%1" : "=t"(*pOut) : "t"(in)); +__STATIC_FORCEINLINE arm_status arm_sqrt_f32( + const float32_t in, + float32_t * pOut) + { + if (in >= 0.0f) + { +#if defined ( __CC_ARM ) + #if defined __TARGET_FPU_VFP + *pOut = __sqrtf(in); + #else + *pOut = sqrtf(in); + #endif + +#elif defined ( __ICCARM__ ) + #if defined __ARMVFP__ + __ASM("VSQRT.F32 %0,%1" : "=t"(*pOut) : "t"(in)); + #else + *pOut = sqrtf(in); + #endif + +#elif defined ( __ARMCC_VERSION ) && ( __ARMCC_VERSION >= 6010050 ) + *pOut = _sqrtf(in); +#elif defined(__GNUC_PYTHON__) + *pOut = sqrtf(in); +#elif defined ( __GNUC__ ) + #if defined (__VFP_FP__) && !defined(__SOFTFP__) + __ASM("VSQRT.F32 %0,%1" : "=t"(*pOut) : "t"(in)); + #else + *pOut = sqrtf(in); + #endif #else - *pOut = sqrtf(in); + *pOut = sqrtf(in); #endif -#else - *pOut = sqrtf(in); -#endif - - return (ARM_MATH_SUCCESS); - } else { - *pOut = 0.0f; - return (ARM_MATH_ARGUMENT_ERROR); + return (ARM_MATH_SUCCESS); } -} + else + { + *pOut = 0.0f; + return (ARM_MATH_ARGUMENT_ERROR); + } + } + /** @brief Q31 square root function. @@ -246,7 +283,10 @@ __STATIC_FORCEINLINE arm_status arm_sqrt_f32(const float32_t in, float32_t *pOut - \ref ARM_MATH_SUCCESS : input value is positive - \ref ARM_MATH_ARGUMENT_ERROR : input value is negative; *pOut is set to 0 */ -arm_status arm_sqrt_q31(q31_t in, q31_t *pOut); +arm_status arm_sqrt_q31( + q31_t in, + q31_t * pOut); + /** @brief Q15 square root function. @@ -256,13 +296,17 @@ arm_status arm_sqrt_q31(q31_t in, q31_t *pOut); - \ref ARM_MATH_SUCCESS : input value is positive - \ref ARM_MATH_ARGUMENT_ERROR : input value is negative; *pOut is set to 0 */ -arm_status arm_sqrt_q15(q15_t in, q15_t *pOut); +arm_status arm_sqrt_q15( + q15_t in, + q15_t * pOut); -/** + + + /** * @} end of SQRT group */ -/** + /** @brief Fixed point division @param[in] numerator Numerator @param[in] denominator Denominator @@ -274,9 +318,12 @@ arm_status arm_sqrt_q15(q15_t in, q15_t *pOut); to the saturated negative or positive value. */ -arm_status arm_divide_q15(q15_t numerator, q15_t denominator, q15_t *quotient, int16_t *shift); +arm_status arm_divide_q15(q15_t numerator, + q15_t denominator, + q15_t *quotient, + int16_t *shift); -/** + /** @brief Fixed point division @param[in] numerator Numerator @param[in] denominator Denominator @@ -288,36 +335,42 @@ arm_status arm_divide_q15(q15_t numerator, q15_t denominator, q15_t *quotient, i to the saturated negative or positive value. */ -arm_status arm_divide_q31(q31_t numerator, q31_t denominator, q31_t *quotient, int16_t *shift); +arm_status arm_divide_q31(q31_t numerator, + q31_t denominator, + q31_t *quotient, + int16_t *shift); -/** + + + /** @brief Arc tangent in radian of y/x using sign of x and y to determine right quadrant. @param[in] y y coordinate @param[in] x x coordinate @param[out] result Result @return error status. */ -arm_status arm_atan2_f32(float32_t y, float32_t x, float32_t *result); + arm_status arm_atan2_f32(float32_t y,float32_t x,float32_t *result); -/** + + /** @brief Arc tangent in radian of y/x using sign of x and y to determine right quadrant. @param[in] y y coordinate @param[in] x x coordinate @param[out] result Result in Q2.29 @return error status. */ -arm_status arm_atan2_q31(q31_t y, q31_t x, q31_t *result); + arm_status arm_atan2_q31(q31_t y,q31_t x,q31_t *result); -/** + /** @brief Arc tangent in radian of y/x using sign of x and y to determine right quadrant. @param[in] y y coordinate @param[in] x x coordinate @param[out] result Result in Q2.13 @return error status. */ -arm_status arm_atan2_q15(q15_t y, q15_t x, q15_t *result); + arm_status arm_atan2_q15(q15_t y,q15_t x,q15_t *result); -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions_f16.h old mode 100644 new mode 100755 index 7aca2c59b68..1fa45a86e1b --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions_f16.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _FAST_MATH_FUNCTIONS_F16_H_ -#define _FAST_MATH_FUNCTIONS_F16_H_ + +#ifndef FAST_MATH_FUNCTIONS_F16_H_ +#define FAST_MATH_FUNCTIONS_F16_H_ #include "arm_math_types_f16.h" #include "arm_math_memory.h" @@ -35,13 +36,14 @@ /* For sqrt_f32 */ #include "dsp/fast_math_functions.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #if defined(ARM_FLOAT16_SUPPORTED) -/** + /** * @addtogroup SQRT * @{ */ @@ -54,57 +56,66 @@ extern "C" { - \ref ARM_MATH_SUCCESS : input value is positive - \ref ARM_MATH_ARGUMENT_ERROR : input value is negative; *pOut is set to 0 */ -__STATIC_FORCEINLINE arm_status arm_sqrt_f16(float16_t in, float16_t *pOut) -{ +__STATIC_FORCEINLINE arm_status arm_sqrt_f16( + float16_t in, + float16_t * pOut) + { float32_t r; arm_status status; - status = arm_sqrt_f32((float32_t)in, &r); - *pOut = (float16_t)r; - return (status); -} + status=arm_sqrt_f32((float32_t)in,&r); + *pOut=(float16_t)r; + return(status); + } + /** @} end of SQRT group */ - + /** @brief Floating-point vector of log values. @param[in] pSrc points to the input vector @param[out] pDst points to the output vector @param[in] blockSize number of samples in each vector - @return none */ -void arm_vlog_f16(const float16_t *pSrc, float16_t *pDst, uint32_t blockSize); + void arm_vlog_f16( + const float16_t * pSrc, + float16_t * pDst, + uint32_t blockSize); /** @brief Floating-point vector of exp values. @param[in] pSrc points to the input vector @param[out] pDst points to the output vector @param[in] blockSize number of samples in each vector - @return none */ -void arm_vexp_f16(const float16_t *pSrc, float16_t *pDst, uint32_t blockSize); + void arm_vexp_f16( + const float16_t * pSrc, + float16_t * pDst, + uint32_t blockSize); -/** + /** @brief Floating-point vector of inverse values. @param[in] pSrc points to the input vector @param[out] pDst points to the output vector @param[in] blockSize number of samples in each vector - @return none */ -void arm_vinverse_f16(const float16_t *pSrc, float16_t *pDst, uint32_t blockSize); + void arm_vinverse_f16( + const float16_t * pSrc, + float16_t * pDst, + uint32_t blockSize); -/** + /** @brief Arc tangent in radian of y/x using sign of x and y to determine right quadrant. @param[in] y y coordinate @param[in] x x coordinate @param[out] result Result @return error status. */ -arm_status arm_atan2_f16(float16_t y, float16_t x, float16_t *result); + arm_status arm_atan2_f16(float16_t y,float16_t x,float16_t *result); #endif /*defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions.h old mode 100644 new mode 100755 index e290890d600..fa149595bbe --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _FILTERING_FUNCTIONS_H_ -#define _FILTERING_FUNCTIONS_H_ + +#ifndef FILTERING_FUNCTIONS_H_ +#define FILTERING_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -35,76 +36,84 @@ #include "dsp/support_functions.h" #include "dsp/fast_math_functions.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif -#define DELTA_Q31 ((q31_t)(0x100)) -#define DELTA_Q15 ((q15_t)0x5) + + +#define DELTA_Q31 ((q31_t)(0x100)) +#define DELTA_Q15 ((q15_t)0x5) /** * @defgroup groupFilters Filtering Functions */ - -/** + + /** * @brief Instance structure for the Q7 FIR filter. */ -typedef struct { - uint16_t numTaps; /**< number of filter coefficients in the filter. */ - q7_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ - const q7_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ -} arm_fir_instance_q7; + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + q7_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + const q7_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + } arm_fir_instance_q7; -/** + /** * @brief Instance structure for the Q15 FIR filter. */ -typedef struct { - uint16_t numTaps; /**< number of filter coefficients in the filter. */ - q15_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ - const q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ -} arm_fir_instance_q15; + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + q15_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + const q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + } arm_fir_instance_q15; -/** + /** * @brief Instance structure for the Q31 FIR filter. */ -typedef struct { - uint16_t numTaps; /**< number of filter coefficients in the filter. */ - q31_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ - const q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ -} arm_fir_instance_q31; + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + q31_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + const q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + } arm_fir_instance_q31; -/** + /** * @brief Instance structure for the floating-point FIR filter. */ -typedef struct { - uint16_t numTaps; /**< number of filter coefficients in the filter. */ - float32_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ - const float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ -} arm_fir_instance_f32; + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + float32_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + const float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + } arm_fir_instance_f32; -/** + /** * @brief Instance structure for the floating-point FIR filter. */ -typedef struct { - uint16_t numTaps; /**< number of filter coefficients in the filter. */ - float64_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ - const float64_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ -} arm_fir_instance_f64; + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + float64_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + const float64_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + } arm_fir_instance_f64; -/** + /** * @brief Processing function for the Q7 FIR filter. * @param[in] S points to an instance of the Q7 FIR filter structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_fir_q7(const arm_fir_instance_q7 *S, const q7_t *pSrc, q7_t *pDst, uint32_t blockSize); + void arm_fir_q7( + const arm_fir_instance_q7 * S, + const q7_t * pSrc, + q7_t * pDst, + uint32_t blockSize); -/** + /** * @brief Initialization function for the Q7 FIR filter. * @param[in,out] S points to an instance of the Q7 FIR structure. * @param[in] numTaps Number of filter coefficients in the filter. @@ -115,29 +124,40 @@ void arm_fir_q7(const arm_fir_instance_q7 *S, const q7_t *pSrc, q7_t *pDst, uint * For the MVE version, the coefficient length must be a multiple of 16. * You can pad with zeros if you have less coefficients. */ -void arm_fir_init_q7(arm_fir_instance_q7 *S, uint16_t numTaps, const q7_t *pCoeffs, q7_t *pState, - uint32_t blockSize); + void arm_fir_init_q7( + arm_fir_instance_q7 * S, + uint16_t numTaps, + const q7_t * pCoeffs, + q7_t * pState, + uint32_t blockSize); -/** + /** * @brief Processing function for the Q15 FIR filter. * @param[in] S points to an instance of the Q15 FIR structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_fir_q15(const arm_fir_instance_q15 *S, const q15_t *pSrc, q15_t *pDst, uint32_t blockSize); + void arm_fir_q15( + const arm_fir_instance_q15 * S, + const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + /** * @brief Processing function for the fast Q15 FIR filter (fast version). * @param[in] S points to an instance of the Q15 FIR filter structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_fir_fast_q15(const arm_fir_instance_q15 *S, const q15_t *pSrc, q15_t *pDst, - uint32_t blockSize); + void arm_fir_fast_q15( + const arm_fir_instance_q15 * S, + const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + /** * @brief Initialization function for the Q15 FIR filter. * @param[in,out] S points to an instance of the Q15 FIR filter structure. * @param[in] numTaps Number of filter coefficients in the filter. Must be even and greater than or equal to 4. @@ -152,29 +172,40 @@ void arm_fir_fast_q15(const arm_fir_instance_q15 *S, const q15_t *pSrc, q15_t *p * You can pad with zeros if you have less coefficients. * */ -arm_status arm_fir_init_q15(arm_fir_instance_q15 *S, uint16_t numTaps, const q15_t *pCoeffs, - q15_t *pState, uint32_t blockSize); + arm_status arm_fir_init_q15( + arm_fir_instance_q15 * S, + uint16_t numTaps, + const q15_t * pCoeffs, + q15_t * pState, + uint32_t blockSize); -/** + /** * @brief Processing function for the Q31 FIR filter. * @param[in] S points to an instance of the Q31 FIR filter structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_fir_q31(const arm_fir_instance_q31 *S, const q31_t *pSrc, q31_t *pDst, uint32_t blockSize); + void arm_fir_q31( + const arm_fir_instance_q31 * S, + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + /** * @brief Processing function for the fast Q31 FIR filter (fast version). * @param[in] S points to an instance of the Q31 FIR filter structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_fir_fast_q31(const arm_fir_instance_q31 *S, const q31_t *pSrc, q31_t *pDst, - uint32_t blockSize); + void arm_fir_fast_q31( + const arm_fir_instance_q31 * S, + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + /** * @brief Initialization function for the Q31 FIR filter. * @param[in,out] S points to an instance of the Q31 FIR structure. * @param[in] numTaps Number of filter coefficients in the filter. @@ -185,30 +216,40 @@ void arm_fir_fast_q31(const arm_fir_instance_q31 *S, const q31_t *pSrc, q31_t *p * For the MVE version, the coefficient length must be a multiple of 4. * You can pad with zeros if you have less coefficients. */ -void arm_fir_init_q31(arm_fir_instance_q31 *S, uint16_t numTaps, const q31_t *pCoeffs, - q31_t *pState, uint32_t blockSize); + void arm_fir_init_q31( + arm_fir_instance_q31 * S, + uint16_t numTaps, + const q31_t * pCoeffs, + q31_t * pState, + uint32_t blockSize); -/** + /** * @brief Processing function for the floating-point FIR filter. * @param[in] S points to an instance of the floating-point FIR structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_fir_f32(const arm_fir_instance_f32 *S, const float32_t *pSrc, float32_t *pDst, - uint32_t blockSize); + void arm_fir_f32( + const arm_fir_instance_f32 * S, + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); -/** + /** * @brief Processing function for the floating-point FIR filter. * @param[in] S points to an instance of the floating-point FIR structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_fir_f64(const arm_fir_instance_f64 *S, const float64_t *pSrc, float64_t *pDst, - uint32_t blockSize); + void arm_fir_f64( + const arm_fir_instance_f64 * S, + const float64_t * pSrc, + float64_t * pDst, + uint32_t blockSize); -/** + /** * @brief Initialization function for the floating-point FIR filter. * @param[in,out] S points to an instance of the floating-point FIR filter structure. * @param[in] numTaps Number of filter coefficients in the filter. @@ -216,10 +257,14 @@ void arm_fir_f64(const arm_fir_instance_f64 *S, const float64_t *pSrc, float64_t * @param[in] pState points to the state buffer. * @param[in] blockSize number of samples that are processed at a time. */ -void arm_fir_init_f32(arm_fir_instance_f32 *S, uint16_t numTaps, const float32_t *pCoeffs, - float32_t *pState, uint32_t blockSize); + void arm_fir_init_f32( + arm_fir_instance_f32 * S, + uint16_t numTaps, + const float32_t * pCoeffs, + float32_t * pState, + uint32_t blockSize); -/** + /** * @brief Initialization function for the floating-point FIR filter. * @param[in,out] S points to an instance of the floating-point FIR filter structure. * @param[in] numTaps Number of filter coefficients in the filter. @@ -227,68 +272,69 @@ void arm_fir_init_f32(arm_fir_instance_f32 *S, uint16_t numTaps, const float32_t * @param[in] pState points to the state buffer. * @param[in] blockSize number of samples that are processed at a time. */ -void arm_fir_init_f64(arm_fir_instance_f64 *S, uint16_t numTaps, const float64_t *pCoeffs, - float64_t *pState, uint32_t blockSize); + void arm_fir_init_f64( + arm_fir_instance_f64 * S, + uint16_t numTaps, + const float64_t * pCoeffs, + float64_t * pState, + uint32_t blockSize); -/** + /** * @brief Instance structure for the Q15 Biquad cascade filter. */ -typedef struct { - int8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ - q15_t * - pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ - const q15_t - *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ - int8_t postShift; /**< Additional shift, in bits, applied to each output sample. */ -} arm_biquad_casd_df1_inst_q15; + typedef struct + { + int8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + q15_t *pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ + const q15_t *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ + int8_t postShift; /**< Additional shift, in bits, applied to each output sample. */ + } arm_biquad_casd_df1_inst_q15; -/** + /** * @brief Instance structure for the Q31 Biquad cascade filter. */ -typedef struct { - uint32_t - numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ - q31_t * - pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ - const q31_t - *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ - uint8_t postShift; /**< Additional shift, in bits, applied to each output sample. */ -} arm_biquad_casd_df1_inst_q31; + typedef struct + { + uint32_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + q31_t *pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ + const q31_t *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ + uint8_t postShift; /**< Additional shift, in bits, applied to each output sample. */ + } arm_biquad_casd_df1_inst_q31; -/** + /** * @brief Instance structure for the floating-point Biquad cascade filter. */ -typedef struct { - uint32_t - numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ - float32_t * - pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ - const float32_t - *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ -} arm_biquad_casd_df1_inst_f32; + typedef struct + { + uint32_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float32_t *pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ + const float32_t *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_casd_df1_inst_f32; #if defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE) -/** + /** * @brief Instance structure for the modified Biquad coefs required by vectorized code. */ -typedef struct { - float32_t coeffs - [8] - [4]; /**< Points to the array of modified coefficients. The array is of length 32. There is one per stage */ -} arm_biquad_mod_coef_f32; -#endif + typedef struct + { + float32_t coeffs[8][4]; /**< Points to the array of modified coefficients. The array is of length 32. There is one per stage */ + } arm_biquad_mod_coef_f32; +#endif -/** + /** * @brief Processing function for the Q15 Biquad cascade filter. * @param[in] S points to an instance of the Q15 Biquad cascade structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_biquad_cascade_df1_q15(const arm_biquad_casd_df1_inst_q15 *S, const q15_t *pSrc, - q15_t *pDst, uint32_t blockSize); + void arm_biquad_cascade_df1_q15( + const arm_biquad_casd_df1_inst_q15 * S, + const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + /** * @brief Initialization function for the Q15 Biquad cascade filter. * @param[in,out] S points to an instance of the Q15 Biquad cascade structure. * @param[in] numStages number of 2nd order stages in the filter. @@ -296,40 +342,53 @@ void arm_biquad_cascade_df1_q15(const arm_biquad_casd_df1_inst_q15 *S, const q15 * @param[in] pState points to the state buffer. * @param[in] postShift Shift to be applied to the output. Varies according to the coefficients format */ -void arm_biquad_cascade_df1_init_q15(arm_biquad_casd_df1_inst_q15 *S, uint8_t numStages, - const q15_t *pCoeffs, q15_t *pState, int8_t postShift); + void arm_biquad_cascade_df1_init_q15( + arm_biquad_casd_df1_inst_q15 * S, + uint8_t numStages, + const q15_t * pCoeffs, + q15_t * pState, + int8_t postShift); -/** + /** * @brief Fast but less precise processing function for the Q15 Biquad cascade filter for Cortex-M3 and Cortex-M4. * @param[in] S points to an instance of the Q15 Biquad cascade structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_biquad_cascade_df1_fast_q15(const arm_biquad_casd_df1_inst_q15 *S, const q15_t *pSrc, - q15_t *pDst, uint32_t blockSize); + void arm_biquad_cascade_df1_fast_q15( + const arm_biquad_casd_df1_inst_q15 * S, + const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + /** * @brief Processing function for the Q31 Biquad cascade filter * @param[in] S points to an instance of the Q31 Biquad cascade structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_biquad_cascade_df1_q31(const arm_biquad_casd_df1_inst_q31 *S, const q31_t *pSrc, - q31_t *pDst, uint32_t blockSize); + void arm_biquad_cascade_df1_q31( + const arm_biquad_casd_df1_inst_q31 * S, + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + /** * @brief Fast but less precise processing function for the Q31 Biquad cascade filter for Cortex-M3 and Cortex-M4. * @param[in] S points to an instance of the Q31 Biquad cascade structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_biquad_cascade_df1_fast_q31(const arm_biquad_casd_df1_inst_q31 *S, const q31_t *pSrc, - q31_t *pDst, uint32_t blockSize); + void arm_biquad_cascade_df1_fast_q31( + const arm_biquad_casd_df1_inst_q31 * S, + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + /** * @brief Initialization function for the Q31 Biquad cascade filter. * @param[in,out] S points to an instance of the Q31 Biquad cascade structure. * @param[in] numStages number of 2nd order stages in the filter. @@ -337,20 +396,27 @@ void arm_biquad_cascade_df1_fast_q31(const arm_biquad_casd_df1_inst_q31 *S, cons * @param[in] pState points to the state buffer. * @param[in] postShift Shift to be applied to the output. Varies according to the coefficients format */ -void arm_biquad_cascade_df1_init_q31(arm_biquad_casd_df1_inst_q31 *S, uint8_t numStages, - const q31_t *pCoeffs, q31_t *pState, int8_t postShift); + void arm_biquad_cascade_df1_init_q31( + arm_biquad_casd_df1_inst_q31 * S, + uint8_t numStages, + const q31_t * pCoeffs, + q31_t * pState, + int8_t postShift); -/** + /** * @brief Processing function for the floating-point Biquad cascade filter. * @param[in] S points to an instance of the floating-point Biquad cascade structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_biquad_cascade_df1_f32(const arm_biquad_casd_df1_inst_f32 *S, const float32_t *pSrc, - float32_t *pDst, uint32_t blockSize); + void arm_biquad_cascade_df1_f32( + const arm_biquad_casd_df1_inst_f32 * S, + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); -/** + /** * @brief Initialization function for the floating-point Biquad cascade filter. * @param[in,out] S points to an instance of the floating-point Biquad cascade structure. * @param[in] numStages number of 2nd order stages in the filter. @@ -359,13 +425,20 @@ void arm_biquad_cascade_df1_f32(const arm_biquad_casd_df1_inst_f32 *S, const flo * @param[in] pState points to the state buffer. */ #if defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE) -void arm_biquad_cascade_df1_mve_init_f32(arm_biquad_casd_df1_inst_f32 *S, uint8_t numStages, - const float32_t *pCoeffs, - arm_biquad_mod_coef_f32 *pCoeffsMod, float32_t *pState); + void arm_biquad_cascade_df1_mve_init_f32( + arm_biquad_casd_df1_inst_f32 * S, + uint8_t numStages, + const float32_t * pCoeffs, + arm_biquad_mod_coef_f32 * pCoeffsMod, + float32_t * pState); #endif + + void arm_biquad_cascade_df1_init_f32( + arm_biquad_casd_df1_inst_f32 * S, + uint8_t numStages, + const float32_t * pCoeffs, + float32_t * pState); -void arm_biquad_cascade_df1_init_f32(arm_biquad_casd_df1_inst_f32 *S, uint8_t numStages, - const float32_t *pCoeffs, float32_t *pState); /** * @brief Convolution of floating-point sequences. @@ -375,10 +448,15 @@ void arm_biquad_cascade_df1_init_f32(arm_biquad_casd_df1_inst_f32 *S, uint8_t nu * @param[in] srcBLen length of the second input sequence. * @param[out] pDst points to the location where the output result is written. Length srcALen+srcBLen-1. */ -void arm_conv_f32(const float32_t *pSrcA, uint32_t srcALen, const float32_t *pSrcB, - uint32_t srcBLen, float32_t *pDst); + void arm_conv_f32( + const float32_t * pSrcA, + uint32_t srcALen, + const float32_t * pSrcB, + uint32_t srcBLen, + float32_t * pDst); -/** + + /** * @brief Convolution of Q15 sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -388,8 +466,15 @@ void arm_conv_f32(const float32_t *pSrcA, uint32_t srcALen, const float32_t *pSr * @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. * @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen). */ -void arm_conv_opt_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, uint32_t srcBLen, - q15_t *pDst, q15_t *pScratch1, q15_t *pScratch2); + void arm_conv_opt_q15( + const q15_t * pSrcA, + uint32_t srcALen, + const q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + q15_t * pScratch1, + q15_t * pScratch2); + /** * @brief Convolution of Q15 sequences. @@ -399,10 +484,15 @@ void arm_conv_opt_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, * @param[in] srcBLen length of the second input sequence. * @param[out] pDst points to the location where the output result is written. Length srcALen+srcBLen-1. */ -void arm_conv_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, uint32_t srcBLen, - q15_t *pDst); + void arm_conv_q15( + const q15_t * pSrcA, + uint32_t srcALen, + const q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst); -/** + + /** * @brief Convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4 * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -410,10 +500,15 @@ void arm_conv_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, uint * @param[in] srcBLen length of the second input sequence. * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. */ -void arm_conv_fast_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, uint32_t srcBLen, - q15_t *pDst); + void arm_conv_fast_q15( + const q15_t * pSrcA, + uint32_t srcALen, + const q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst); -/** + + /** * @brief Convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4 * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -423,10 +518,17 @@ void arm_conv_fast_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, * @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. * @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen). */ -void arm_conv_fast_opt_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, - uint32_t srcBLen, q15_t *pDst, q15_t *pScratch1, q15_t *pScratch2); + void arm_conv_fast_opt_q15( + const q15_t * pSrcA, + uint32_t srcALen, + const q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + q15_t * pScratch1, + q15_t * pScratch2); -/** + + /** * @brief Convolution of Q31 sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -434,10 +536,15 @@ void arm_conv_fast_opt_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pS * @param[in] srcBLen length of the second input sequence. * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. */ -void arm_conv_q31(const q31_t *pSrcA, uint32_t srcALen, const q31_t *pSrcB, uint32_t srcBLen, - q31_t *pDst); + void arm_conv_q31( + const q31_t * pSrcA, + uint32_t srcALen, + const q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst); -/** + + /** * @brief Convolution of Q31 sequences (fast version) for Cortex-M3 and Cortex-M4 * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -445,10 +552,15 @@ void arm_conv_q31(const q31_t *pSrcA, uint32_t srcALen, const q31_t *pSrcB, uint * @param[in] srcBLen length of the second input sequence. * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. */ -void arm_conv_fast_q31(const q31_t *pSrcA, uint32_t srcALen, const q31_t *pSrcB, uint32_t srcBLen, - q31_t *pDst); + void arm_conv_fast_q31( + const q31_t * pSrcA, + uint32_t srcALen, + const q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst); -/** + + /** * @brief Convolution of Q7 sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -458,10 +570,17 @@ void arm_conv_fast_q31(const q31_t *pSrcA, uint32_t srcALen, const q31_t *pSrcB, * @param[in] pScratch1 points to scratch buffer(of type q15_t) of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. * @param[in] pScratch2 points to scratch buffer (of type q15_t) of size min(srcALen, srcBLen). */ -void arm_conv_opt_q7(const q7_t *pSrcA, uint32_t srcALen, const q7_t *pSrcB, uint32_t srcBLen, - q7_t *pDst, q15_t *pScratch1, q15_t *pScratch2); + void arm_conv_opt_q7( + const q7_t * pSrcA, + uint32_t srcALen, + const q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst, + q15_t * pScratch1, + q15_t * pScratch2); -/** + + /** * @brief Convolution of Q7 sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -469,10 +588,15 @@ void arm_conv_opt_q7(const q7_t *pSrcA, uint32_t srcALen, const q7_t *pSrcB, uin * @param[in] srcBLen length of the second input sequence. * @param[out] pDst points to the block of output data Length srcALen+srcBLen-1. */ -void arm_conv_q7(const q7_t *pSrcA, uint32_t srcALen, const q7_t *pSrcB, uint32_t srcBLen, - q7_t *pDst); + void arm_conv_q7( + const q7_t * pSrcA, + uint32_t srcALen, + const q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst); -/** + + /** * @brief Partial convolution of floating-point sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -483,11 +607,17 @@ void arm_conv_q7(const q7_t *pSrcA, uint32_t srcALen, const q7_t *pSrcB, uint32_ * @param[in] numPoints is the number of output points to be computed. * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. */ -arm_status arm_conv_partial_f32(const float32_t *pSrcA, uint32_t srcALen, const float32_t *pSrcB, - uint32_t srcBLen, float32_t *pDst, uint32_t firstIndex, - uint32_t numPoints); + arm_status arm_conv_partial_f32( + const float32_t * pSrcA, + uint32_t srcALen, + const float32_t * pSrcB, + uint32_t srcBLen, + float32_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); -/** + + /** * @brief Partial convolution of Q15 sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -500,11 +630,19 @@ arm_status arm_conv_partial_f32(const float32_t *pSrcA, uint32_t srcALen, const * @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen). * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. */ -arm_status arm_conv_partial_opt_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, - uint32_t srcBLen, q15_t *pDst, uint32_t firstIndex, - uint32_t numPoints, q15_t *pScratch1, q15_t *pScratch2); + arm_status arm_conv_partial_opt_q15( + const q15_t * pSrcA, + uint32_t srcALen, + const q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + uint32_t firstIndex, + uint32_t numPoints, + q15_t * pScratch1, + q15_t * pScratch2); -/** + + /** * @brief Partial convolution of Q15 sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -515,11 +653,17 @@ arm_status arm_conv_partial_opt_q15(const q15_t *pSrcA, uint32_t srcALen, const * @param[in] numPoints is the number of output points to be computed. * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. */ -arm_status arm_conv_partial_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, - uint32_t srcBLen, q15_t *pDst, uint32_t firstIndex, - uint32_t numPoints); + arm_status arm_conv_partial_q15( + const q15_t * pSrcA, + uint32_t srcALen, + const q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); -/** + + /** * @brief Partial convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4 * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -530,11 +674,17 @@ arm_status arm_conv_partial_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_ * @param[in] numPoints is the number of output points to be computed. * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. */ -arm_status arm_conv_partial_fast_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, - uint32_t srcBLen, q15_t *pDst, uint32_t firstIndex, - uint32_t numPoints); + arm_status arm_conv_partial_fast_q15( + const q15_t * pSrcA, + uint32_t srcALen, + const q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); -/** + + /** * @brief Partial convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4 * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -547,11 +697,19 @@ arm_status arm_conv_partial_fast_q15(const q15_t *pSrcA, uint32_t srcALen, const * @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen). * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. */ -arm_status arm_conv_partial_fast_opt_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, - uint32_t srcBLen, q15_t *pDst, uint32_t firstIndex, - uint32_t numPoints, q15_t *pScratch1, q15_t *pScratch2); + arm_status arm_conv_partial_fast_opt_q15( + const q15_t * pSrcA, + uint32_t srcALen, + const q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + uint32_t firstIndex, + uint32_t numPoints, + q15_t * pScratch1, + q15_t * pScratch2); -/** + + /** * @brief Partial convolution of Q31 sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -562,11 +720,17 @@ arm_status arm_conv_partial_fast_opt_q15(const q15_t *pSrcA, uint32_t srcALen, c * @param[in] numPoints is the number of output points to be computed. * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. */ -arm_status arm_conv_partial_q31(const q31_t *pSrcA, uint32_t srcALen, const q31_t *pSrcB, - uint32_t srcBLen, q31_t *pDst, uint32_t firstIndex, - uint32_t numPoints); + arm_status arm_conv_partial_q31( + const q31_t * pSrcA, + uint32_t srcALen, + const q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); -/** + + /** * @brief Partial convolution of Q31 sequences (fast version) for Cortex-M3 and Cortex-M4 * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -577,11 +741,17 @@ arm_status arm_conv_partial_q31(const q31_t *pSrcA, uint32_t srcALen, const q31_ * @param[in] numPoints is the number of output points to be computed. * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. */ -arm_status arm_conv_partial_fast_q31(const q31_t *pSrcA, uint32_t srcALen, const q31_t *pSrcB, - uint32_t srcBLen, q31_t *pDst, uint32_t firstIndex, - uint32_t numPoints); + arm_status arm_conv_partial_fast_q31( + const q31_t * pSrcA, + uint32_t srcALen, + const q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); -/** + + /** * @brief Partial convolution of Q7 sequences * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -594,9 +764,17 @@ arm_status arm_conv_partial_fast_q31(const q31_t *pSrcA, uint32_t srcALen, const * @param[in] pScratch2 points to scratch buffer (of type q15_t) of size min(srcALen, srcBLen). * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. */ -arm_status arm_conv_partial_opt_q7(const q7_t *pSrcA, uint32_t srcALen, const q7_t *pSrcB, - uint32_t srcBLen, q7_t *pDst, uint32_t firstIndex, - uint32_t numPoints, q15_t *pScratch1, q15_t *pScratch2); + arm_status arm_conv_partial_opt_q7( + const q7_t * pSrcA, + uint32_t srcALen, + const q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst, + uint32_t firstIndex, + uint32_t numPoints, + q15_t * pScratch1, + q15_t * pScratch2); + /** * @brief Partial convolution of Q7 sequences. @@ -609,52 +787,108 @@ arm_status arm_conv_partial_opt_q7(const q7_t *pSrcA, uint32_t srcALen, const q7 * @param[in] numPoints is the number of output points to be computed. * @return Returns either ARM_MATH_SUCCESS if the function completed correctly or ARM_MATH_ARGUMENT_ERROR if the requested subset is not in the range [0 srcALen+srcBLen-2]. */ -arm_status arm_conv_partial_q7(const q7_t *pSrcA, uint32_t srcALen, const q7_t *pSrcB, - uint32_t srcBLen, q7_t *pDst, uint32_t firstIndex, - uint32_t numPoints); + arm_status arm_conv_partial_q7( + const q7_t * pSrcA, + uint32_t srcALen, + const q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst, + uint32_t firstIndex, + uint32_t numPoints); -/** + + /** * @brief Instance structure for the Q15 FIR decimator. */ -typedef struct { - uint8_t M; /**< decimation factor. */ - uint16_t numTaps; /**< number of coefficients in the filter. */ - const q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ - q15_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ -} arm_fir_decimate_instance_q15; + typedef struct + { + uint8_t M; /**< decimation factor. */ + uint16_t numTaps; /**< number of coefficients in the filter. */ + const q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + q15_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + } arm_fir_decimate_instance_q15; -/** + /** * @brief Instance structure for the Q31 FIR decimator. */ -typedef struct { - uint8_t M; /**< decimation factor. */ - uint16_t numTaps; /**< number of coefficients in the filter. */ - const q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ - q31_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ -} arm_fir_decimate_instance_q31; + typedef struct + { + uint8_t M; /**< decimation factor. */ + uint16_t numTaps; /**< number of coefficients in the filter. */ + const q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + q31_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + } arm_fir_decimate_instance_q31; /** - @brief Instance structure for floating-point FIR decimator. + @brief Instance structure for single precision floating-point FIR decimator. */ -typedef struct { - uint8_t M; /**< decimation factor. */ - uint16_t numTaps; /**< number of coefficients in the filter. */ - const float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ - float32_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ -} arm_fir_decimate_instance_f32; - -/** +typedef struct + { + uint8_t M; /**< decimation factor. */ + uint16_t numTaps; /**< number of coefficients in the filter. */ + const float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + float32_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + } arm_fir_decimate_instance_f32; + + /** + @brief Instance structure for double precision floating-point FIR decimator. + */ + typedef struct + { + uint8_t M; /**< decimation factor. */ + uint16_t numTaps; /**< number of coefficients in the filter. */ + const float64_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + float64_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + } arm_fir_decimate_instance_f64; + + /** @brief Processing function for floating-point FIR decimator. @param[in] S points to an instance of the floating-point FIR decimator structure @param[in] pSrc points to the block of input data @param[out] pDst points to the block of output data @param[in] blockSize number of samples to process */ -void arm_fir_decimate_f32(const arm_fir_decimate_instance_f32 *S, const float32_t *pSrc, - float32_t *pDst, uint32_t blockSize); + void arm_fir_decimate_f64( + const arm_fir_decimate_instance_f64 * S, + const float64_t * pSrc, + float64_t * pDst, + uint32_t blockSize); + + + /** + @brief Initialization function for the floating-point FIR decimator. + @param[in,out] S points to an instance of the floating-point FIR decimator structure + @param[in] numTaps number of coefficients in the filter + @param[in] M decimation factor + @param[in] pCoeffs points to the filter coefficients + @param[in] pState points to the state buffer + @param[in] blockSize number of input samples to process per call + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_LENGTH_ERROR : blockSize is not a multiple of M + */ + arm_status arm_fir_decimate_init_f64( + arm_fir_decimate_instance_f64 * S, + uint16_t numTaps, + uint8_t M, + const float64_t * pCoeffs, + float64_t * pState, + uint32_t blockSize); + + + /** + @brief Processing function for floating-point FIR decimator. + @param[in] S points to an instance of the floating-point FIR decimator structure + @param[in] pSrc points to the block of input data + @param[out] pDst points to the block of output data + @param[in] blockSize number of samples to process + */ +void arm_fir_decimate_f32( + const arm_fir_decimate_instance_f32 * S, + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + /** @brief Initialization function for the floating-point FIR decimator. @@ -668,31 +902,44 @@ void arm_fir_decimate_f32(const arm_fir_decimate_instance_f32 *S, const float32_ - \ref ARM_MATH_SUCCESS : Operation successful - \ref ARM_MATH_LENGTH_ERROR : blockSize is not a multiple of M */ -arm_status arm_fir_decimate_init_f32(arm_fir_decimate_instance_f32 *S, uint16_t numTaps, uint8_t M, - const float32_t *pCoeffs, float32_t *pState, - uint32_t blockSize); +arm_status arm_fir_decimate_init_f32( + arm_fir_decimate_instance_f32 * S, + uint16_t numTaps, + uint8_t M, + const float32_t * pCoeffs, + float32_t * pState, + uint32_t blockSize); -/** + + /** * @brief Processing function for the Q15 FIR decimator. * @param[in] S points to an instance of the Q15 FIR decimator structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of input samples to process per call. */ -void arm_fir_decimate_q15(const arm_fir_decimate_instance_q15 *S, const q15_t *pSrc, q15_t *pDst, - uint32_t blockSize); + void arm_fir_decimate_q15( + const arm_fir_decimate_instance_q15 * S, + const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Processing function for the Q15 FIR decimator (fast variant) for Cortex-M3 and Cortex-M4. * @param[in] S points to an instance of the Q15 FIR decimator structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of input samples to process per call. */ -void arm_fir_decimate_fast_q15(const arm_fir_decimate_instance_q15 *S, const q15_t *pSrc, - q15_t *pDst, uint32_t blockSize); + void arm_fir_decimate_fast_q15( + const arm_fir_decimate_instance_q15 * S, + const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Initialization function for the Q15 FIR decimator. * @param[in,out] S points to an instance of the Q15 FIR decimator structure. * @param[in] numTaps number of coefficients in the filter. @@ -703,30 +950,43 @@ void arm_fir_decimate_fast_q15(const arm_fir_decimate_instance_q15 *S, const q15 * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if * blockSize is not a multiple of M. */ -arm_status arm_fir_decimate_init_q15(arm_fir_decimate_instance_q15 *S, uint16_t numTaps, uint8_t M, - const q15_t *pCoeffs, q15_t *pState, uint32_t blockSize); + arm_status arm_fir_decimate_init_q15( + arm_fir_decimate_instance_q15 * S, + uint16_t numTaps, + uint8_t M, + const q15_t * pCoeffs, + q15_t * pState, + uint32_t blockSize); -/** + + /** * @brief Processing function for the Q31 FIR decimator. * @param[in] S points to an instance of the Q31 FIR decimator structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of input samples to process per call. */ -void arm_fir_decimate_q31(const arm_fir_decimate_instance_q31 *S, const q31_t *pSrc, q31_t *pDst, - uint32_t blockSize); + void arm_fir_decimate_q31( + const arm_fir_decimate_instance_q31 * S, + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + /** * @brief Processing function for the Q31 FIR decimator (fast variant) for Cortex-M3 and Cortex-M4. * @param[in] S points to an instance of the Q31 FIR decimator structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of input samples to process per call. */ -void arm_fir_decimate_fast_q31(const arm_fir_decimate_instance_q31 *S, const q31_t *pSrc, - q31_t *pDst, uint32_t blockSize); + void arm_fir_decimate_fast_q31( + const arm_fir_decimate_instance_q31 * S, + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Initialization function for the Q31 FIR decimator. * @param[in,out] S points to an instance of the Q31 FIR decimator structure. * @param[in] numTaps number of coefficients in the filter. @@ -737,56 +997,64 @@ void arm_fir_decimate_fast_q31(const arm_fir_decimate_instance_q31 *S, const q31 * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if * blockSize is not a multiple of M. */ -arm_status arm_fir_decimate_init_q31(arm_fir_decimate_instance_q31 *S, uint16_t numTaps, uint8_t M, - const q31_t *pCoeffs, q31_t *pState, uint32_t blockSize); + arm_status arm_fir_decimate_init_q31( + arm_fir_decimate_instance_q31 * S, + uint16_t numTaps, + uint8_t M, + const q31_t * pCoeffs, + q31_t * pState, + uint32_t blockSize); -/** + + /** * @brief Instance structure for the Q15 FIR interpolator. */ -typedef struct { - uint8_t L; /**< upsample factor. */ - uint16_t phaseLength; /**< length of each polyphase filter component. */ - const q15_t - *pCoeffs; /**< points to the coefficient array. The array is of length L*phaseLength. */ - q15_t * - pState; /**< points to the state variable array. The array is of length blockSize+phaseLength-1. */ -} arm_fir_interpolate_instance_q15; + typedef struct + { + uint8_t L; /**< upsample factor. */ + uint16_t phaseLength; /**< length of each polyphase filter component. */ + const q15_t *pCoeffs; /**< points to the coefficient array. The array is of length L*phaseLength. */ + q15_t *pState; /**< points to the state variable array. The array is of length blockSize+phaseLength-1. */ + } arm_fir_interpolate_instance_q15; -/** + /** * @brief Instance structure for the Q31 FIR interpolator. */ -typedef struct { - uint8_t L; /**< upsample factor. */ - uint16_t phaseLength; /**< length of each polyphase filter component. */ - const q31_t - *pCoeffs; /**< points to the coefficient array. The array is of length L*phaseLength. */ - q31_t * - pState; /**< points to the state variable array. The array is of length blockSize+phaseLength-1. */ -} arm_fir_interpolate_instance_q31; + typedef struct + { + uint8_t L; /**< upsample factor. */ + uint16_t phaseLength; /**< length of each polyphase filter component. */ + const q31_t *pCoeffs; /**< points to the coefficient array. The array is of length L*phaseLength. */ + q31_t *pState; /**< points to the state variable array. The array is of length blockSize+phaseLength-1. */ + } arm_fir_interpolate_instance_q31; -/** + /** * @brief Instance structure for the floating-point FIR interpolator. */ -typedef struct { - uint8_t L; /**< upsample factor. */ - uint16_t phaseLength; /**< length of each polyphase filter component. */ - const float32_t - *pCoeffs; /**< points to the coefficient array. The array is of length L*phaseLength. */ - float32_t * - pState; /**< points to the state variable array. The array is of length phaseLength+numTaps-1. */ -} arm_fir_interpolate_instance_f32; + typedef struct + { + uint8_t L; /**< upsample factor. */ + uint16_t phaseLength; /**< length of each polyphase filter component. */ + const float32_t *pCoeffs; /**< points to the coefficient array. The array is of length L*phaseLength. */ + float32_t *pState; /**< points to the state variable array. The array is of length phaseLength+numTaps-1. */ + } arm_fir_interpolate_instance_f32; -/** + + /** * @brief Processing function for the Q15 FIR interpolator. * @param[in] S points to an instance of the Q15 FIR interpolator structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of input samples to process per call. */ -void arm_fir_interpolate_q15(const arm_fir_interpolate_instance_q15 *S, const q15_t *pSrc, - q15_t *pDst, uint32_t blockSize); + void arm_fir_interpolate_q15( + const arm_fir_interpolate_instance_q15 * S, + const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Initialization function for the Q15 FIR interpolator. * @param[in,out] S points to an instance of the Q15 FIR interpolator structure. * @param[in] L upsample factor. @@ -797,21 +1065,30 @@ void arm_fir_interpolate_q15(const arm_fir_interpolate_instance_q15 *S, const q1 * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if * the filter length numTaps is not a multiple of the interpolation factor L. */ -arm_status arm_fir_interpolate_init_q15(arm_fir_interpolate_instance_q15 *S, uint8_t L, - uint16_t numTaps, const q15_t *pCoeffs, q15_t *pState, - uint32_t blockSize); + arm_status arm_fir_interpolate_init_q15( + arm_fir_interpolate_instance_q15 * S, + uint8_t L, + uint16_t numTaps, + const q15_t * pCoeffs, + q15_t * pState, + uint32_t blockSize); -/** + + /** * @brief Processing function for the Q31 FIR interpolator. * @param[in] S points to an instance of the Q15 FIR interpolator structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of input samples to process per call. */ -void arm_fir_interpolate_q31(const arm_fir_interpolate_instance_q31 *S, const q31_t *pSrc, - q31_t *pDst, uint32_t blockSize); + void arm_fir_interpolate_q31( + const arm_fir_interpolate_instance_q31 * S, + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Initialization function for the Q31 FIR interpolator. * @param[in,out] S points to an instance of the Q31 FIR interpolator structure. * @param[in] L upsample factor. @@ -822,21 +1099,30 @@ void arm_fir_interpolate_q31(const arm_fir_interpolate_instance_q31 *S, const q3 * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if * the filter length numTaps is not a multiple of the interpolation factor L. */ -arm_status arm_fir_interpolate_init_q31(arm_fir_interpolate_instance_q31 *S, uint8_t L, - uint16_t numTaps, const q31_t *pCoeffs, q31_t *pState, - uint32_t blockSize); + arm_status arm_fir_interpolate_init_q31( + arm_fir_interpolate_instance_q31 * S, + uint8_t L, + uint16_t numTaps, + const q31_t * pCoeffs, + q31_t * pState, + uint32_t blockSize); -/** + + /** * @brief Processing function for the floating-point FIR interpolator. * @param[in] S points to an instance of the floating-point FIR interpolator structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of input samples to process per call. */ -void arm_fir_interpolate_f32(const arm_fir_interpolate_instance_f32 *S, const float32_t *pSrc, - float32_t *pDst, uint32_t blockSize); + void arm_fir_interpolate_f32( + const arm_fir_interpolate_instance_f32 * S, + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Initialization function for the floating-point FIR interpolator. * @param[in,out] S points to an instance of the floating-point FIR interpolator structure. * @param[in] L upsample factor. @@ -847,217 +1133,268 @@ void arm_fir_interpolate_f32(const arm_fir_interpolate_instance_f32 *S, const fl * @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if * the filter length numTaps is not a multiple of the interpolation factor L. */ -arm_status arm_fir_interpolate_init_f32(arm_fir_interpolate_instance_f32 *S, uint8_t L, - uint16_t numTaps, const float32_t *pCoeffs, - float32_t *pState, uint32_t blockSize); + arm_status arm_fir_interpolate_init_f32( + arm_fir_interpolate_instance_f32 * S, + uint8_t L, + uint16_t numTaps, + const float32_t * pCoeffs, + float32_t * pState, + uint32_t blockSize); -/** + + /** * @brief Instance structure for the high precision Q31 Biquad cascade filter. */ -typedef struct { - uint8_t - numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ - q63_t * - pState; /**< points to the array of state coefficients. The array is of length 4*numStages. */ - const q31_t - *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ - uint8_t postShift; /**< additional shift, in bits, applied to each output sample. */ -} arm_biquad_cas_df1_32x64_ins_q31; + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + q63_t *pState; /**< points to the array of state coefficients. The array is of length 4*numStages. */ + const q31_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + uint8_t postShift; /**< additional shift, in bits, applied to each output sample. */ + } arm_biquad_cas_df1_32x64_ins_q31; -/** + + /** * @param[in] S points to an instance of the high precision Q31 Biquad cascade filter structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of samples to process. */ -void arm_biquad_cas_df1_32x64_q31(const arm_biquad_cas_df1_32x64_ins_q31 *S, const q31_t *pSrc, - q31_t *pDst, uint32_t blockSize); + void arm_biquad_cas_df1_32x64_q31( + const arm_biquad_cas_df1_32x64_ins_q31 * S, + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @param[in,out] S points to an instance of the high precision Q31 Biquad cascade filter structure. * @param[in] numStages number of 2nd order stages in the filter. * @param[in] pCoeffs points to the filter coefficients. * @param[in] pState points to the state buffer. * @param[in] postShift shift to be applied to the output. Varies according to the coefficients format */ -void arm_biquad_cas_df1_32x64_init_q31(arm_biquad_cas_df1_32x64_ins_q31 *S, uint8_t numStages, - const q31_t *pCoeffs, q63_t *pState, uint8_t postShift); + void arm_biquad_cas_df1_32x64_init_q31( + arm_biquad_cas_df1_32x64_ins_q31 * S, + uint8_t numStages, + const q31_t * pCoeffs, + q63_t * pState, + uint8_t postShift); -/** + + /** * @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter. */ -typedef struct { - uint8_t - numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ - float32_t * - pState; /**< points to the array of state coefficients. The array is of length 2*numStages. */ - const float32_t - *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ -} arm_biquad_cascade_df2T_instance_f32; + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float32_t *pState; /**< points to the array of state coefficients. The array is of length 2*numStages. */ + const float32_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_cascade_df2T_instance_f32; -/** + /** * @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter. */ -typedef struct { - uint8_t - numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ - float32_t * - pState; /**< points to the array of state coefficients. The array is of length 4*numStages. */ - const float32_t - *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ -} arm_biquad_cascade_stereo_df2T_instance_f32; + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float32_t *pState; /**< points to the array of state coefficients. The array is of length 4*numStages. */ + const float32_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_cascade_stereo_df2T_instance_f32; -/** + /** * @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter. */ -typedef struct { - uint8_t - numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ - float64_t * - pState; /**< points to the array of state coefficients. The array is of length 2*numStages. */ - const float64_t - *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ -} arm_biquad_cascade_df2T_instance_f64; + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float64_t *pState; /**< points to the array of state coefficients. The array is of length 2*numStages. */ + const float64_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_cascade_df2T_instance_f64; -/** + + /** * @brief Processing function for the floating-point transposed direct form II Biquad cascade filter. * @param[in] S points to an instance of the filter data structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of samples to process. */ -void arm_biquad_cascade_df2T_f32(const arm_biquad_cascade_df2T_instance_f32 *S, - const float32_t *pSrc, float32_t *pDst, uint32_t blockSize); + void arm_biquad_cascade_df2T_f32( + const arm_biquad_cascade_df2T_instance_f32 * S, + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Processing function for the floating-point transposed direct form II Biquad cascade filter. 2 channels * @param[in] S points to an instance of the filter data structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of samples to process. */ -void arm_biquad_cascade_stereo_df2T_f32(const arm_biquad_cascade_stereo_df2T_instance_f32 *S, - const float32_t *pSrc, float32_t *pDst, uint32_t blockSize); + void arm_biquad_cascade_stereo_df2T_f32( + const arm_biquad_cascade_stereo_df2T_instance_f32 * S, + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Processing function for the floating-point transposed direct form II Biquad cascade filter. * @param[in] S points to an instance of the filter data structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of samples to process. */ -void arm_biquad_cascade_df2T_f64(const arm_biquad_cascade_df2T_instance_f64 *S, - const float64_t *pSrc, float64_t *pDst, uint32_t blockSize); + void arm_biquad_cascade_df2T_f64( + const arm_biquad_cascade_df2T_instance_f64 * S, + const float64_t * pSrc, + float64_t * pDst, + uint32_t blockSize); -#if defined(ARM_MATH_NEON) + +#if defined(ARM_MATH_NEON) /** @brief Compute new coefficient arrays for use in vectorized filter (Neon only). @param[in] numStages number of 2nd order stages in the filter. @param[in] pCoeffs points to the original filter coefficients. @param[in] pComputedCoeffs points to the new computed coefficients for the vectorized version. - @return none */ -void arm_biquad_cascade_df2T_compute_coefs_f32(uint8_t numStages, const float32_t *pCoeffs, - float32_t *pComputedCoeffs); +void arm_biquad_cascade_df2T_compute_coefs_f32( + uint8_t numStages, + const float32_t * pCoeffs, + float32_t * pComputedCoeffs); #endif -/** + /** * @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter. * @param[in,out] S points to an instance of the filter data structure. * @param[in] numStages number of 2nd order stages in the filter. * @param[in] pCoeffs points to the filter coefficients. * @param[in] pState points to the state buffer. */ -void arm_biquad_cascade_df2T_init_f32(arm_biquad_cascade_df2T_instance_f32 *S, uint8_t numStages, - const float32_t *pCoeffs, float32_t *pState); + void arm_biquad_cascade_df2T_init_f32( + arm_biquad_cascade_df2T_instance_f32 * S, + uint8_t numStages, + const float32_t * pCoeffs, + float32_t * pState); -/** + + /** * @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter. * @param[in,out] S points to an instance of the filter data structure. * @param[in] numStages number of 2nd order stages in the filter. * @param[in] pCoeffs points to the filter coefficients. * @param[in] pState points to the state buffer. */ -void arm_biquad_cascade_stereo_df2T_init_f32(arm_biquad_cascade_stereo_df2T_instance_f32 *S, - uint8_t numStages, const float32_t *pCoeffs, - float32_t *pState); + void arm_biquad_cascade_stereo_df2T_init_f32( + arm_biquad_cascade_stereo_df2T_instance_f32 * S, + uint8_t numStages, + const float32_t * pCoeffs, + float32_t * pState); -/** + + /** * @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter. * @param[in,out] S points to an instance of the filter data structure. * @param[in] numStages number of 2nd order stages in the filter. * @param[in] pCoeffs points to the filter coefficients. * @param[in] pState points to the state buffer. */ -void arm_biquad_cascade_df2T_init_f64(arm_biquad_cascade_df2T_instance_f64 *S, uint8_t numStages, - const float64_t *pCoeffs, float64_t *pState); + void arm_biquad_cascade_df2T_init_f64( + arm_biquad_cascade_df2T_instance_f64 * S, + uint8_t numStages, + const float64_t * pCoeffs, + float64_t * pState); -/** + + /** * @brief Instance structure for the Q15 FIR lattice filter. */ -typedef struct { - uint16_t numStages; /**< number of filter stages. */ - q15_t *pState; /**< points to the state variable array. The array is of length numStages. */ - const q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numStages. */ -} arm_fir_lattice_instance_q15; + typedef struct + { + uint16_t numStages; /**< number of filter stages. */ + q15_t *pState; /**< points to the state variable array. The array is of length numStages. */ + const q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numStages. */ + } arm_fir_lattice_instance_q15; -/** + /** * @brief Instance structure for the Q31 FIR lattice filter. */ -typedef struct { - uint16_t numStages; /**< number of filter stages. */ - q31_t *pState; /**< points to the state variable array. The array is of length numStages. */ - const q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numStages. */ -} arm_fir_lattice_instance_q31; + typedef struct + { + uint16_t numStages; /**< number of filter stages. */ + q31_t *pState; /**< points to the state variable array. The array is of length numStages. */ + const q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numStages. */ + } arm_fir_lattice_instance_q31; -/** + /** * @brief Instance structure for the floating-point FIR lattice filter. */ -typedef struct { - uint16_t numStages; /**< number of filter stages. */ - float32_t *pState; /**< points to the state variable array. The array is of length numStages. */ - const float32_t - *pCoeffs; /**< points to the coefficient array. The array is of length numStages. */ -} arm_fir_lattice_instance_f32; + typedef struct + { + uint16_t numStages; /**< number of filter stages. */ + float32_t *pState; /**< points to the state variable array. The array is of length numStages. */ + const float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numStages. */ + } arm_fir_lattice_instance_f32; -/** + + /** * @brief Initialization function for the Q15 FIR lattice filter. * @param[in] S points to an instance of the Q15 FIR lattice structure. * @param[in] numStages number of filter stages. * @param[in] pCoeffs points to the coefficient buffer. The array is of length numStages. * @param[in] pState points to the state buffer. The array is of length numStages. */ -void arm_fir_lattice_init_q15(arm_fir_lattice_instance_q15 *S, uint16_t numStages, - const q15_t *pCoeffs, q15_t *pState); + void arm_fir_lattice_init_q15( + arm_fir_lattice_instance_q15 * S, + uint16_t numStages, + const q15_t * pCoeffs, + q15_t * pState); -/** + + /** * @brief Processing function for the Q15 FIR lattice filter. * @param[in] S points to an instance of the Q15 FIR lattice structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_fir_lattice_q15(const arm_fir_lattice_instance_q15 *S, const q15_t *pSrc, q15_t *pDst, - uint32_t blockSize); + void arm_fir_lattice_q15( + const arm_fir_lattice_instance_q15 * S, + const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Initialization function for the Q31 FIR lattice filter. * @param[in] S points to an instance of the Q31 FIR lattice structure. * @param[in] numStages number of filter stages. * @param[in] pCoeffs points to the coefficient buffer. The array is of length numStages. * @param[in] pState points to the state buffer. The array is of length numStages. */ -void arm_fir_lattice_init_q31(arm_fir_lattice_instance_q31 *S, uint16_t numStages, - const q31_t *pCoeffs, q31_t *pState); + void arm_fir_lattice_init_q31( + arm_fir_lattice_instance_q31 * S, + uint16_t numStages, + const q31_t * pCoeffs, + q31_t * pState); -/** + + /** * @brief Processing function for the Q31 FIR lattice filter. * @param[in] S points to an instance of the Q31 FIR lattice structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of samples to process. */ -void arm_fir_lattice_q31(const arm_fir_lattice_instance_q31 *S, const q31_t *pSrc, q31_t *pDst, - uint32_t blockSize); + void arm_fir_lattice_q31( + const arm_fir_lattice_instance_q31 * S, + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + /** * @brief Initialization function for the floating-point FIR lattice filter. @@ -1066,69 +1403,76 @@ void arm_fir_lattice_q31(const arm_fir_lattice_instance_q31 *S, const q31_t *pSr * @param[in] pCoeffs points to the coefficient buffer. The array is of length numStages. * @param[in] pState points to the state buffer. The array is of length numStages. */ -void arm_fir_lattice_init_f32(arm_fir_lattice_instance_f32 *S, uint16_t numStages, - const float32_t *pCoeffs, float32_t *pState); + void arm_fir_lattice_init_f32( + arm_fir_lattice_instance_f32 * S, + uint16_t numStages, + const float32_t * pCoeffs, + float32_t * pState); -/** + + /** * @brief Processing function for the floating-point FIR lattice filter. * @param[in] S points to an instance of the floating-point FIR lattice structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of samples to process. */ -void arm_fir_lattice_f32(const arm_fir_lattice_instance_f32 *S, const float32_t *pSrc, - float32_t *pDst, uint32_t blockSize); + void arm_fir_lattice_f32( + const arm_fir_lattice_instance_f32 * S, + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Instance structure for the Q15 IIR lattice filter. */ -typedef struct { - uint16_t numStages; /**< number of stages in the filter. */ - q15_t * - pState; /**< points to the state variable array. The array is of length numStages+blockSize. */ - q15_t * - pkCoeffs; /**< points to the reflection coefficient array. The array is of length numStages. */ - q15_t * - pvCoeffs; /**< points to the ladder coefficient array. The array is of length numStages+1. */ -} arm_iir_lattice_instance_q15; + typedef struct + { + uint16_t numStages; /**< number of stages in the filter. */ + q15_t *pState; /**< points to the state variable array. The array is of length numStages+blockSize. */ + q15_t *pkCoeffs; /**< points to the reflection coefficient array. The array is of length numStages. */ + q15_t *pvCoeffs; /**< points to the ladder coefficient array. The array is of length numStages+1. */ + } arm_iir_lattice_instance_q15; -/** + /** * @brief Instance structure for the Q31 IIR lattice filter. */ -typedef struct { - uint16_t numStages; /**< number of stages in the filter. */ - q31_t * - pState; /**< points to the state variable array. The array is of length numStages+blockSize. */ - q31_t * - pkCoeffs; /**< points to the reflection coefficient array. The array is of length numStages. */ - q31_t * - pvCoeffs; /**< points to the ladder coefficient array. The array is of length numStages+1. */ -} arm_iir_lattice_instance_q31; + typedef struct + { + uint16_t numStages; /**< number of stages in the filter. */ + q31_t *pState; /**< points to the state variable array. The array is of length numStages+blockSize. */ + q31_t *pkCoeffs; /**< points to the reflection coefficient array. The array is of length numStages. */ + q31_t *pvCoeffs; /**< points to the ladder coefficient array. The array is of length numStages+1. */ + } arm_iir_lattice_instance_q31; -/** + /** * @brief Instance structure for the floating-point IIR lattice filter. */ -typedef struct { - uint16_t numStages; /**< number of stages in the filter. */ - float32_t * - pState; /**< points to the state variable array. The array is of length numStages+blockSize. */ - float32_t * - pkCoeffs; /**< points to the reflection coefficient array. The array is of length numStages. */ - float32_t * - pvCoeffs; /**< points to the ladder coefficient array. The array is of length numStages+1. */ -} arm_iir_lattice_instance_f32; + typedef struct + { + uint16_t numStages; /**< number of stages in the filter. */ + float32_t *pState; /**< points to the state variable array. The array is of length numStages+blockSize. */ + float32_t *pkCoeffs; /**< points to the reflection coefficient array. The array is of length numStages. */ + float32_t *pvCoeffs; /**< points to the ladder coefficient array. The array is of length numStages+1. */ + } arm_iir_lattice_instance_f32; -/** + + /** * @brief Processing function for the floating-point IIR lattice filter. * @param[in] S points to an instance of the floating-point IIR lattice structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_iir_lattice_f32(const arm_iir_lattice_instance_f32 *S, const float32_t *pSrc, - float32_t *pDst, uint32_t blockSize); + void arm_iir_lattice_f32( + const arm_iir_lattice_instance_f32 * S, + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Initialization function for the floating-point IIR lattice filter. * @param[in] S points to an instance of the floating-point IIR lattice structure. * @param[in] numStages number of stages in the filter. @@ -1137,21 +1481,30 @@ void arm_iir_lattice_f32(const arm_iir_lattice_instance_f32 *S, const float32_t * @param[in] pState points to the state buffer. The array is of length numStages+blockSize-1. * @param[in] blockSize number of samples to process. */ -void arm_iir_lattice_init_f32(arm_iir_lattice_instance_f32 *S, uint16_t numStages, - float32_t *pkCoeffs, float32_t *pvCoeffs, float32_t *pState, - uint32_t blockSize); + void arm_iir_lattice_init_f32( + arm_iir_lattice_instance_f32 * S, + uint16_t numStages, + float32_t * pkCoeffs, + float32_t * pvCoeffs, + float32_t * pState, + uint32_t blockSize); -/** + + /** * @brief Processing function for the Q31 IIR lattice filter. * @param[in] S points to an instance of the Q31 IIR lattice structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_iir_lattice_q31(const arm_iir_lattice_instance_q31 *S, const q31_t *pSrc, q31_t *pDst, - uint32_t blockSize); + void arm_iir_lattice_q31( + const arm_iir_lattice_instance_q31 * S, + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Initialization function for the Q31 IIR lattice filter. * @param[in] S points to an instance of the Q31 IIR lattice structure. * @param[in] numStages number of stages in the filter. @@ -1160,18 +1513,28 @@ void arm_iir_lattice_q31(const arm_iir_lattice_instance_q31 *S, const q31_t *pSr * @param[in] pState points to the state buffer. The array is of length numStages+blockSize. * @param[in] blockSize number of samples to process. */ -void arm_iir_lattice_init_q31(arm_iir_lattice_instance_q31 *S, uint16_t numStages, q31_t *pkCoeffs, - q31_t *pvCoeffs, q31_t *pState, uint32_t blockSize); + void arm_iir_lattice_init_q31( + arm_iir_lattice_instance_q31 * S, + uint16_t numStages, + q31_t * pkCoeffs, + q31_t * pvCoeffs, + q31_t * pState, + uint32_t blockSize); -/** + + /** * @brief Processing function for the Q15 IIR lattice filter. * @param[in] S points to an instance of the Q15 IIR lattice structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_iir_lattice_q15(const arm_iir_lattice_instance_q15 *S, const q15_t *pSrc, q15_t *pDst, - uint32_t blockSize); + void arm_iir_lattice_q15( + const arm_iir_lattice_instance_q15 * S, + const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + /** * @brief Initialization function for the Q15 IIR lattice filter. @@ -1182,21 +1545,28 @@ void arm_iir_lattice_q15(const arm_iir_lattice_instance_q15 *S, const q15_t *pSr * @param[in] pState points to state buffer. The array is of length numStages+blockSize. * @param[in] blockSize number of samples to process per call. */ -void arm_iir_lattice_init_q15(arm_iir_lattice_instance_q15 *S, uint16_t numStages, q15_t *pkCoeffs, - q15_t *pvCoeffs, q15_t *pState, uint32_t blockSize); + void arm_iir_lattice_init_q15( + arm_iir_lattice_instance_q15 * S, + uint16_t numStages, + q15_t * pkCoeffs, + q15_t * pvCoeffs, + q15_t * pState, + uint32_t blockSize); -/** + + /** * @brief Instance structure for the floating-point LMS filter. */ -typedef struct { - uint16_t numTaps; /**< number of coefficients in the filter. */ - float32_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ - float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ - float32_t mu; /**< step size that controls filter coefficient updates. */ -} arm_lms_instance_f32; + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + float32_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + float32_t mu; /**< step size that controls filter coefficient updates. */ + } arm_lms_instance_f32; -/** + + /** * @brief Processing function for floating-point LMS filter. * @param[in] S points to an instance of the floating-point LMS filter structure. * @param[in] pSrc points to the block of input data. @@ -1205,10 +1575,16 @@ typedef struct { * @param[out] pErr points to the block of error data. * @param[in] blockSize number of samples to process. */ -void arm_lms_f32(const arm_lms_instance_f32 *S, const float32_t *pSrc, float32_t *pRef, - float32_t *pOut, float32_t *pErr, uint32_t blockSize); + void arm_lms_f32( + const arm_lms_instance_f32 * S, + const float32_t * pSrc, + float32_t * pRef, + float32_t * pOut, + float32_t * pErr, + uint32_t blockSize); -/** + + /** * @brief Initialization function for floating-point LMS filter. * @param[in] S points to an instance of the floating-point LMS filter structure. * @param[in] numTaps number of filter coefficients. @@ -1217,22 +1593,29 @@ void arm_lms_f32(const arm_lms_instance_f32 *S, const float32_t *pSrc, float32_t * @param[in] mu step size that controls filter coefficient updates. * @param[in] blockSize number of samples to process. */ -void arm_lms_init_f32(arm_lms_instance_f32 *S, uint16_t numTaps, float32_t *pCoeffs, - float32_t *pState, float32_t mu, uint32_t blockSize); + void arm_lms_init_f32( + arm_lms_instance_f32 * S, + uint16_t numTaps, + float32_t * pCoeffs, + float32_t * pState, + float32_t mu, + uint32_t blockSize); -/** + + /** * @brief Instance structure for the Q15 LMS filter. */ -typedef struct { - uint16_t numTaps; /**< number of coefficients in the filter. */ - q15_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ - q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ - q15_t mu; /**< step size that controls filter coefficient updates. */ - uint32_t postShift; /**< bit shift applied to coefficients. */ -} arm_lms_instance_q15; + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + q15_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + q15_t mu; /**< step size that controls filter coefficient updates. */ + uint32_t postShift; /**< bit shift applied to coefficients. */ + } arm_lms_instance_q15; -/** + + /** * @brief Initialization function for the Q15 LMS filter. * @param[in] S points to an instance of the Q15 LMS filter structure. * @param[in] numTaps number of filter coefficients. @@ -1242,10 +1625,17 @@ typedef struct { * @param[in] blockSize number of samples to process. * @param[in] postShift bit shift applied to coefficients. */ -void arm_lms_init_q15(arm_lms_instance_q15 *S, uint16_t numTaps, q15_t *pCoeffs, q15_t *pState, - q15_t mu, uint32_t blockSize, uint32_t postShift); + void arm_lms_init_q15( + arm_lms_instance_q15 * S, + uint16_t numTaps, + q15_t * pCoeffs, + q15_t * pState, + q15_t mu, + uint32_t blockSize, + uint32_t postShift); -/** + + /** * @brief Processing function for Q15 LMS filter. * @param[in] S points to an instance of the Q15 LMS filter structure. * @param[in] pSrc points to the block of input data. @@ -1254,22 +1644,29 @@ void arm_lms_init_q15(arm_lms_instance_q15 *S, uint16_t numTaps, q15_t *pCoeffs, * @param[out] pErr points to the block of error data. * @param[in] blockSize number of samples to process. */ -void arm_lms_q15(const arm_lms_instance_q15 *S, const q15_t *pSrc, q15_t *pRef, q15_t *pOut, - q15_t *pErr, uint32_t blockSize); + void arm_lms_q15( + const arm_lms_instance_q15 * S, + const q15_t * pSrc, + q15_t * pRef, + q15_t * pOut, + q15_t * pErr, + uint32_t blockSize); -/** + + /** * @brief Instance structure for the Q31 LMS filter. */ -typedef struct { - uint16_t numTaps; /**< number of coefficients in the filter. */ - q31_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ - q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ - q31_t mu; /**< step size that controls filter coefficient updates. */ - uint32_t postShift; /**< bit shift applied to coefficients. */ -} arm_lms_instance_q31; + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + q31_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + q31_t mu; /**< step size that controls filter coefficient updates. */ + uint32_t postShift; /**< bit shift applied to coefficients. */ + } arm_lms_instance_q31; -/** + + /** * @brief Processing function for Q31 LMS filter. * @param[in] S points to an instance of the Q15 LMS filter structure. * @param[in] pSrc points to the block of input data. @@ -1278,10 +1675,16 @@ typedef struct { * @param[out] pErr points to the block of error data. * @param[in] blockSize number of samples to process. */ -void arm_lms_q31(const arm_lms_instance_q31 *S, const q31_t *pSrc, q31_t *pRef, q31_t *pOut, - q31_t *pErr, uint32_t blockSize); + void arm_lms_q31( + const arm_lms_instance_q31 * S, + const q31_t * pSrc, + q31_t * pRef, + q31_t * pOut, + q31_t * pErr, + uint32_t blockSize); -/** + + /** * @brief Initialization function for Q31 LMS filter. * @param[in] S points to an instance of the Q31 LMS filter structure. * @param[in] numTaps number of filter coefficients. @@ -1291,23 +1694,31 @@ void arm_lms_q31(const arm_lms_instance_q31 *S, const q31_t *pSrc, q31_t *pRef, * @param[in] blockSize number of samples to process. * @param[in] postShift bit shift applied to coefficients. */ -void arm_lms_init_q31(arm_lms_instance_q31 *S, uint16_t numTaps, q31_t *pCoeffs, q31_t *pState, - q31_t mu, uint32_t blockSize, uint32_t postShift); + void arm_lms_init_q31( + arm_lms_instance_q31 * S, + uint16_t numTaps, + q31_t * pCoeffs, + q31_t * pState, + q31_t mu, + uint32_t blockSize, + uint32_t postShift); -/** + + /** * @brief Instance structure for the floating-point normalized LMS filter. */ -typedef struct { - uint16_t numTaps; /**< number of coefficients in the filter. */ - float32_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ - float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ - float32_t mu; /**< step size that control filter coefficient updates. */ - float32_t energy; /**< saves previous frame energy. */ - float32_t x0; /**< saves previous input sample. */ -} arm_lms_norm_instance_f32; + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + float32_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + float32_t mu; /**< step size that control filter coefficient updates. */ + float32_t energy; /**< saves previous frame energy. */ + float32_t x0; /**< saves previous input sample. */ + } arm_lms_norm_instance_f32; -/** + + /** * @brief Processing function for floating-point normalized LMS filter. * @param[in] S points to an instance of the floating-point normalized LMS filter structure. * @param[in] pSrc points to the block of input data. @@ -1316,10 +1727,16 @@ typedef struct { * @param[out] pErr points to the block of error data. * @param[in] blockSize number of samples to process. */ -void arm_lms_norm_f32(arm_lms_norm_instance_f32 *S, const float32_t *pSrc, float32_t *pRef, - float32_t *pOut, float32_t *pErr, uint32_t blockSize); + void arm_lms_norm_f32( + arm_lms_norm_instance_f32 * S, + const float32_t * pSrc, + float32_t * pRef, + float32_t * pOut, + float32_t * pErr, + uint32_t blockSize); -/** + + /** * @brief Initialization function for floating-point normalized LMS filter. * @param[in] S points to an instance of the floating-point LMS filter structure. * @param[in] numTaps number of filter coefficients. @@ -1328,25 +1745,32 @@ void arm_lms_norm_f32(arm_lms_norm_instance_f32 *S, const float32_t *pSrc, float * @param[in] mu step size that controls filter coefficient updates. * @param[in] blockSize number of samples to process. */ -void arm_lms_norm_init_f32(arm_lms_norm_instance_f32 *S, uint16_t numTaps, float32_t *pCoeffs, - float32_t *pState, float32_t mu, uint32_t blockSize); + void arm_lms_norm_init_f32( + arm_lms_norm_instance_f32 * S, + uint16_t numTaps, + float32_t * pCoeffs, + float32_t * pState, + float32_t mu, + uint32_t blockSize); -/** + + /** * @brief Instance structure for the Q31 normalized LMS filter. */ -typedef struct { - uint16_t numTaps; /**< number of coefficients in the filter. */ - q31_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ - q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ - q31_t mu; /**< step size that controls filter coefficient updates. */ - uint8_t postShift; /**< bit shift applied to coefficients. */ - const q31_t *recipTable; /**< points to the reciprocal initial value table. */ - q31_t energy; /**< saves previous frame energy. */ - q31_t x0; /**< saves previous input sample. */ -} arm_lms_norm_instance_q31; + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + q31_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + q31_t mu; /**< step size that controls filter coefficient updates. */ + uint8_t postShift; /**< bit shift applied to coefficients. */ + const q31_t *recipTable; /**< points to the reciprocal initial value table. */ + q31_t energy; /**< saves previous frame energy. */ + q31_t x0; /**< saves previous input sample. */ + } arm_lms_norm_instance_q31; -/** + + /** * @brief Processing function for Q31 normalized LMS filter. * @param[in] S points to an instance of the Q31 normalized LMS filter structure. * @param[in] pSrc points to the block of input data. @@ -1355,10 +1779,16 @@ typedef struct { * @param[out] pErr points to the block of error data. * @param[in] blockSize number of samples to process. */ -void arm_lms_norm_q31(arm_lms_norm_instance_q31 *S, const q31_t *pSrc, q31_t *pRef, q31_t *pOut, - q31_t *pErr, uint32_t blockSize); + void arm_lms_norm_q31( + arm_lms_norm_instance_q31 * S, + const q31_t * pSrc, + q31_t * pRef, + q31_t * pOut, + q31_t * pErr, + uint32_t blockSize); -/** + + /** * @brief Initialization function for Q31 normalized LMS filter. * @param[in] S points to an instance of the Q31 normalized LMS filter structure. * @param[in] numTaps number of filter coefficients. @@ -1368,25 +1798,33 @@ void arm_lms_norm_q31(arm_lms_norm_instance_q31 *S, const q31_t *pSrc, q31_t *pR * @param[in] blockSize number of samples to process. * @param[in] postShift bit shift applied to coefficients. */ -void arm_lms_norm_init_q31(arm_lms_norm_instance_q31 *S, uint16_t numTaps, q31_t *pCoeffs, - q31_t *pState, q31_t mu, uint32_t blockSize, uint8_t postShift); + void arm_lms_norm_init_q31( + arm_lms_norm_instance_q31 * S, + uint16_t numTaps, + q31_t * pCoeffs, + q31_t * pState, + q31_t mu, + uint32_t blockSize, + uint8_t postShift); -/** + + /** * @brief Instance structure for the Q15 normalized LMS filter. */ -typedef struct { - uint16_t numTaps; /**< Number of coefficients in the filter. */ - q15_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ - q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ - q15_t mu; /**< step size that controls filter coefficient updates. */ - uint8_t postShift; /**< bit shift applied to coefficients. */ - const q15_t *recipTable; /**< Points to the reciprocal initial value table. */ - q15_t energy; /**< saves previous frame energy. */ - q15_t x0; /**< saves previous input sample. */ -} arm_lms_norm_instance_q15; + typedef struct + { + uint16_t numTaps; /**< Number of coefficients in the filter. */ + q15_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + q15_t mu; /**< step size that controls filter coefficient updates. */ + uint8_t postShift; /**< bit shift applied to coefficients. */ + const q15_t *recipTable; /**< Points to the reciprocal initial value table. */ + q15_t energy; /**< saves previous frame energy. */ + q15_t x0; /**< saves previous input sample. */ + } arm_lms_norm_instance_q15; -/** + + /** * @brief Processing function for Q15 normalized LMS filter. * @param[in] S points to an instance of the Q15 normalized LMS filter structure. * @param[in] pSrc points to the block of input data. @@ -1395,10 +1833,16 @@ typedef struct { * @param[out] pErr points to the block of error data. * @param[in] blockSize number of samples to process. */ -void arm_lms_norm_q15(arm_lms_norm_instance_q15 *S, const q15_t *pSrc, q15_t *pRef, q15_t *pOut, - q15_t *pErr, uint32_t blockSize); + void arm_lms_norm_q15( + arm_lms_norm_instance_q15 * S, + const q15_t * pSrc, + q15_t * pRef, + q15_t * pOut, + q15_t * pErr, + uint32_t blockSize); -/** + + /** * @brief Initialization function for Q15 normalized LMS filter. * @param[in] S points to an instance of the Q15 normalized LMS filter structure. * @param[in] numTaps number of filter coefficients. @@ -1408,10 +1852,17 @@ void arm_lms_norm_q15(arm_lms_norm_instance_q15 *S, const q15_t *pSrc, q15_t *pR * @param[in] blockSize number of samples to process. * @param[in] postShift bit shift applied to coefficients. */ -void arm_lms_norm_init_q15(arm_lms_norm_instance_q15 *S, uint16_t numTaps, q15_t *pCoeffs, - q15_t *pState, q15_t mu, uint32_t blockSize, uint8_t postShift); + void arm_lms_norm_init_q15( + arm_lms_norm_instance_q15 * S, + uint16_t numTaps, + q15_t * pCoeffs, + q15_t * pState, + q15_t mu, + uint32_t blockSize, + uint8_t postShift); -/** + + /** * @brief Correlation of floating-point sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -1419,10 +1870,15 @@ void arm_lms_norm_init_q15(arm_lms_norm_instance_q15 *S, uint16_t numTaps, q15_t * @param[in] srcBLen length of the second input sequence. * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. */ -void arm_correlate_f32(const float32_t *pSrcA, uint32_t srcALen, const float32_t *pSrcB, - uint32_t srcBLen, float32_t *pDst); + void arm_correlate_f32( + const float32_t * pSrcA, + uint32_t srcALen, + const float32_t * pSrcB, + uint32_t srcBLen, + float32_t * pDst); -/** + + /** * @brief Correlation of floating-point sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -1430,8 +1886,13 @@ void arm_correlate_f32(const float32_t *pSrcA, uint32_t srcALen, const float32_t * @param[in] srcBLen length of the second input sequence. * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. */ -void arm_correlate_f64(const float64_t *pSrcA, uint32_t srcALen, const float64_t *pSrcB, - uint32_t srcBLen, float64_t *pDst); + void arm_correlate_f64( + const float64_t * pSrcA, + uint32_t srcALen, + const float64_t * pSrcB, + uint32_t srcBLen, + float64_t * pDst); + /** @brief Correlation of Q15 sequences @@ -1442,8 +1903,14 @@ void arm_correlate_f64(const float64_t *pSrcA, uint32_t srcALen, const float64_t @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. @param[in] pScratch points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. */ -void arm_correlate_opt_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, - uint32_t srcBLen, q15_t *pDst, q15_t *pScratch); +void arm_correlate_opt_q15( + const q15_t * pSrcA, + uint32_t srcALen, + const q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + q15_t * pScratch); + /** @brief Correlation of Q15 sequences. @@ -1453,8 +1920,13 @@ void arm_correlate_opt_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pS @param[in] srcBLen length of the second input sequence @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. */ -void arm_correlate_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, uint32_t srcBLen, - q15_t *pDst); + void arm_correlate_q15( + const q15_t * pSrcA, + uint32_t srcALen, + const q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst); + /** @brief Correlation of Q15 sequences (fast version). @@ -1463,10 +1935,14 @@ void arm_correlate_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, @param[in] pSrcB points to the second input sequence @param[in] srcBLen length of the second input sequence @param[out] pDst points to the location where the output result is written. Length 2 * max(srcALen, srcBLen) - 1. - @return none */ -void arm_correlate_fast_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, - uint32_t srcBLen, q15_t *pDst); +void arm_correlate_fast_q15( + const q15_t * pSrcA, + uint32_t srcALen, + const q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst); + /** @brief Correlation of Q15 sequences (fast version). @@ -1477,10 +1953,16 @@ void arm_correlate_fast_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *p @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. @param[in] pScratch points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. */ -void arm_correlate_fast_opt_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_t *pSrcB, - uint32_t srcBLen, q15_t *pDst, q15_t *pScratch); +void arm_correlate_fast_opt_q15( + const q15_t * pSrcA, + uint32_t srcALen, + const q15_t * pSrcB, + uint32_t srcBLen, + q15_t * pDst, + q15_t * pScratch); -/** + + /** * @brief Correlation of Q31 sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -1488,8 +1970,13 @@ void arm_correlate_fast_opt_q15(const q15_t *pSrcA, uint32_t srcALen, const q15_ * @param[in] srcBLen length of the second input sequence. * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. */ -void arm_correlate_q31(const q31_t *pSrcA, uint32_t srcALen, const q31_t *pSrcB, uint32_t srcBLen, - q31_t *pDst); + void arm_correlate_q31( + const q31_t * pSrcA, + uint32_t srcALen, + const q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst); + /** @brief Correlation of Q31 sequences (fast version). @@ -1499,10 +1986,15 @@ void arm_correlate_q31(const q31_t *pSrcA, uint32_t srcALen, const q31_t *pSrcB, @param[in] srcBLen length of the second input sequence @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. */ -void arm_correlate_fast_q31(const q31_t *pSrcA, uint32_t srcALen, const q31_t *pSrcB, - uint32_t srcBLen, q31_t *pDst); +void arm_correlate_fast_q31( + const q31_t * pSrcA, + uint32_t srcALen, + const q31_t * pSrcB, + uint32_t srcBLen, + q31_t * pDst); -/** + + /** * @brief Correlation of Q7 sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -1512,10 +2004,17 @@ void arm_correlate_fast_q31(const q31_t *pSrcA, uint32_t srcALen, const q31_t *p * @param[in] pScratch1 points to scratch buffer(of type q15_t) of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2. * @param[in] pScratch2 points to scratch buffer (of type q15_t) of size min(srcALen, srcBLen). */ -void arm_correlate_opt_q7(const q7_t *pSrcA, uint32_t srcALen, const q7_t *pSrcB, uint32_t srcBLen, - q7_t *pDst, q15_t *pScratch1, q15_t *pScratch2); + void arm_correlate_opt_q7( + const q7_t * pSrcA, + uint32_t srcALen, + const q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst, + q15_t * pScratch1, + q15_t * pScratch2); -/** + + /** * @brief Correlation of Q7 sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -1523,61 +2022,68 @@ void arm_correlate_opt_q7(const q7_t *pSrcA, uint32_t srcALen, const q7_t *pSrcB * @param[in] srcBLen length of the second input sequence. * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. */ -void arm_correlate_q7(const q7_t *pSrcA, uint32_t srcALen, const q7_t *pSrcB, uint32_t srcBLen, - q7_t *pDst); + void arm_correlate_q7( + const q7_t * pSrcA, + uint32_t srcALen, + const q7_t * pSrcB, + uint32_t srcBLen, + q7_t * pDst); -/** + + /** * @brief Instance structure for the floating-point sparse FIR filter. */ -typedef struct { - uint16_t numTaps; /**< number of coefficients in the filter. */ - uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ - float32_t * - pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ - const float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ - uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ - int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ -} arm_fir_sparse_instance_f32; - -/** + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ + float32_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ + const float32_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ + int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ + } arm_fir_sparse_instance_f32; + + /** * @brief Instance structure for the Q31 sparse FIR filter. */ -typedef struct { - uint16_t numTaps; /**< number of coefficients in the filter. */ - uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ - q31_t * - pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ - const q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ - uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ - int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ -} arm_fir_sparse_instance_q31; - -/** + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ + q31_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ + const q31_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ + int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ + } arm_fir_sparse_instance_q31; + + /** * @brief Instance structure for the Q15 sparse FIR filter. */ -typedef struct { - uint16_t numTaps; /**< number of coefficients in the filter. */ - uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ - q15_t * - pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ - const q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ - uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ - int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ -} arm_fir_sparse_instance_q15; - -/** + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ + q15_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ + const q15_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ + int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ + } arm_fir_sparse_instance_q15; + + /** * @brief Instance structure for the Q7 sparse FIR filter. */ -typedef struct { - uint16_t numTaps; /**< number of coefficients in the filter. */ - uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ - q7_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ - const q7_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ - uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ - int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ -} arm_fir_sparse_instance_q7; + typedef struct + { + uint16_t numTaps; /**< number of coefficients in the filter. */ + uint16_t stateIndex; /**< state buffer index. Points to the oldest sample in the state buffer. */ + q7_t *pState; /**< points to the state buffer array. The array is of length maxDelay+blockSize-1. */ + const q7_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps.*/ + uint16_t maxDelay; /**< maximum offset specified by the pTapDelay array. */ + int32_t *pTapDelay; /**< points to the array of delay values. The array is of length numTaps. */ + } arm_fir_sparse_instance_q7; -/** + + /** * @brief Processing function for the floating-point sparse FIR filter. * @param[in] S points to an instance of the floating-point sparse FIR structure. * @param[in] pSrc points to the block of input data. @@ -1585,10 +2091,15 @@ typedef struct { * @param[in] pScratchIn points to a temporary buffer of size blockSize. * @param[in] blockSize number of input samples to process per call. */ -void arm_fir_sparse_f32(arm_fir_sparse_instance_f32 *S, const float32_t *pSrc, float32_t *pDst, - float32_t *pScratchIn, uint32_t blockSize); + void arm_fir_sparse_f32( + arm_fir_sparse_instance_f32 * S, + const float32_t * pSrc, + float32_t * pDst, + float32_t * pScratchIn, + uint32_t blockSize); -/** + + /** * @brief Initialization function for the floating-point sparse FIR filter. * @param[in,out] S points to an instance of the floating-point sparse FIR structure. * @param[in] numTaps number of nonzero coefficients in the filter. @@ -1598,11 +2109,17 @@ void arm_fir_sparse_f32(arm_fir_sparse_instance_f32 *S, const float32_t *pSrc, f * @param[in] maxDelay maximum offset time supported. * @param[in] blockSize number of samples that will be processed per block. */ -void arm_fir_sparse_init_f32(arm_fir_sparse_instance_f32 *S, uint16_t numTaps, - const float32_t *pCoeffs, float32_t *pState, int32_t *pTapDelay, - uint16_t maxDelay, uint32_t blockSize); + void arm_fir_sparse_init_f32( + arm_fir_sparse_instance_f32 * S, + uint16_t numTaps, + const float32_t * pCoeffs, + float32_t * pState, + int32_t * pTapDelay, + uint16_t maxDelay, + uint32_t blockSize); -/** + + /** * @brief Processing function for the Q31 sparse FIR filter. * @param[in] S points to an instance of the Q31 sparse FIR structure. * @param[in] pSrc points to the block of input data. @@ -1610,10 +2127,15 @@ void arm_fir_sparse_init_f32(arm_fir_sparse_instance_f32 *S, uint16_t numTaps, * @param[in] pScratchIn points to a temporary buffer of size blockSize. * @param[in] blockSize number of input samples to process per call. */ -void arm_fir_sparse_q31(arm_fir_sparse_instance_q31 *S, const q31_t *pSrc, q31_t *pDst, - q31_t *pScratchIn, uint32_t blockSize); + void arm_fir_sparse_q31( + arm_fir_sparse_instance_q31 * S, + const q31_t * pSrc, + q31_t * pDst, + q31_t * pScratchIn, + uint32_t blockSize); -/** + + /** * @brief Initialization function for the Q31 sparse FIR filter. * @param[in,out] S points to an instance of the Q31 sparse FIR structure. * @param[in] numTaps number of nonzero coefficients in the filter. @@ -1623,11 +2145,17 @@ void arm_fir_sparse_q31(arm_fir_sparse_instance_q31 *S, const q31_t *pSrc, q31_t * @param[in] maxDelay maximum offset time supported. * @param[in] blockSize number of samples that will be processed per block. */ -void arm_fir_sparse_init_q31(arm_fir_sparse_instance_q31 *S, uint16_t numTaps, const q31_t *pCoeffs, - q31_t *pState, int32_t *pTapDelay, uint16_t maxDelay, - uint32_t blockSize); + void arm_fir_sparse_init_q31( + arm_fir_sparse_instance_q31 * S, + uint16_t numTaps, + const q31_t * pCoeffs, + q31_t * pState, + int32_t * pTapDelay, + uint16_t maxDelay, + uint32_t blockSize); -/** + + /** * @brief Processing function for the Q15 sparse FIR filter. * @param[in] S points to an instance of the Q15 sparse FIR structure. * @param[in] pSrc points to the block of input data. @@ -1636,10 +2164,16 @@ void arm_fir_sparse_init_q31(arm_fir_sparse_instance_q31 *S, uint16_t numTaps, c * @param[in] pScratchOut points to a temporary buffer of size blockSize. * @param[in] blockSize number of input samples to process per call. */ -void arm_fir_sparse_q15(arm_fir_sparse_instance_q15 *S, const q15_t *pSrc, q15_t *pDst, - q15_t *pScratchIn, q31_t *pScratchOut, uint32_t blockSize); + void arm_fir_sparse_q15( + arm_fir_sparse_instance_q15 * S, + const q15_t * pSrc, + q15_t * pDst, + q15_t * pScratchIn, + q31_t * pScratchOut, + uint32_t blockSize); -/** + + /** * @brief Initialization function for the Q15 sparse FIR filter. * @param[in,out] S points to an instance of the Q15 sparse FIR structure. * @param[in] numTaps number of nonzero coefficients in the filter. @@ -1649,11 +2183,17 @@ void arm_fir_sparse_q15(arm_fir_sparse_instance_q15 *S, const q15_t *pSrc, q15_t * @param[in] maxDelay maximum offset time supported. * @param[in] blockSize number of samples that will be processed per block. */ -void arm_fir_sparse_init_q15(arm_fir_sparse_instance_q15 *S, uint16_t numTaps, const q15_t *pCoeffs, - q15_t *pState, int32_t *pTapDelay, uint16_t maxDelay, - uint32_t blockSize); + void arm_fir_sparse_init_q15( + arm_fir_sparse_instance_q15 * S, + uint16_t numTaps, + const q15_t * pCoeffs, + q15_t * pState, + int32_t * pTapDelay, + uint16_t maxDelay, + uint32_t blockSize); -/** + + /** * @brief Processing function for the Q7 sparse FIR filter. * @param[in] S points to an instance of the Q7 sparse FIR structure. * @param[in] pSrc points to the block of input data. @@ -1662,10 +2202,16 @@ void arm_fir_sparse_init_q15(arm_fir_sparse_instance_q15 *S, uint16_t numTaps, c * @param[in] pScratchOut points to a temporary buffer of size blockSize. * @param[in] blockSize number of input samples to process per call. */ -void arm_fir_sparse_q7(arm_fir_sparse_instance_q7 *S, const q7_t *pSrc, q7_t *pDst, - q7_t *pScratchIn, q31_t *pScratchOut, uint32_t blockSize); + void arm_fir_sparse_q7( + arm_fir_sparse_instance_q7 * S, + const q7_t * pSrc, + q7_t * pDst, + q7_t * pScratchIn, + q31_t * pScratchOut, + uint32_t blockSize); -/** + + /** * @brief Initialization function for the Q7 sparse FIR filter. * @param[in,out] S points to an instance of the Q7 sparse FIR structure. * @param[in] numTaps number of nonzero coefficients in the filter. @@ -1675,18 +2221,32 @@ void arm_fir_sparse_q7(arm_fir_sparse_instance_q7 *S, const q7_t *pSrc, q7_t *pD * @param[in] maxDelay maximum offset time supported. * @param[in] blockSize number of samples that will be processed per block. */ -void arm_fir_sparse_init_q7(arm_fir_sparse_instance_q7 *S, uint16_t numTaps, const q7_t *pCoeffs, - q7_t *pState, int32_t *pTapDelay, uint16_t maxDelay, - uint32_t blockSize); + void arm_fir_sparse_init_q7( + arm_fir_sparse_instance_q7 * S, + uint16_t numTaps, + const q7_t * pCoeffs, + q7_t * pState, + int32_t * pTapDelay, + uint16_t maxDelay, + uint32_t blockSize); -/** + + + + + + /** * @brief floating-point Circular write function. */ -__STATIC_FORCEINLINE void arm_circularWrite_f32(int32_t *circBuffer, int32_t L, - uint16_t *writeOffset, int32_t bufferInc, - const int32_t *src, int32_t srcInc, - uint32_t blockSize) -{ + __STATIC_FORCEINLINE void arm_circularWrite_f32( + int32_t * circBuffer, + int32_t L, + uint16_t * writeOffset, + int32_t bufferInc, + const int32_t * src, + int32_t srcInc, + uint32_t blockSize) + { uint32_t i = 0U; int32_t wOffset; @@ -1697,37 +2257,46 @@ __STATIC_FORCEINLINE void arm_circularWrite_f32(int32_t *circBuffer, int32_t L, /* Loop over the blockSize */ i = blockSize; - while (i > 0U) { - /* copy the input sample to the circular buffer */ - circBuffer[wOffset] = *src; + while (i > 0U) + { + /* copy the input sample to the circular buffer */ + circBuffer[wOffset] = *src; - /* Update the input pointer */ - src += srcInc; + /* Update the input pointer */ + src += srcInc; - /* Circularly update wOffset. Watch out for positive and negative value */ - wOffset += bufferInc; - if (wOffset >= L) - wOffset -= L; + /* Circularly update wOffset. Watch out for positive and negative value */ + wOffset += bufferInc; + if (wOffset >= L) + wOffset -= L; - /* Decrement the loop counter */ - i--; + /* Decrement the loop counter */ + i--; } /* Update the index pointer */ *writeOffset = (uint16_t)wOffset; -} + } -/** + + + /** * @brief floating-point Circular Read function. */ -__STATIC_FORCEINLINE void arm_circularRead_f32(int32_t *circBuffer, int32_t L, int32_t *readOffset, - int32_t bufferInc, int32_t *dst, int32_t *dst_base, - int32_t dst_length, int32_t dstInc, - uint32_t blockSize) -{ + __STATIC_FORCEINLINE void arm_circularRead_f32( + int32_t * circBuffer, + int32_t L, + int32_t * readOffset, + int32_t bufferInc, + int32_t * dst, + int32_t * dst_base, + int32_t dst_length, + int32_t dstInc, + uint32_t blockSize) + { uint32_t i = 0U; int32_t rOffset; - int32_t *dst_end; + int32_t* dst_end; /* Copy the value of Index pointer that points * to the current location from where the input samples to be read */ @@ -1737,39 +2306,48 @@ __STATIC_FORCEINLINE void arm_circularRead_f32(int32_t *circBuffer, int32_t L, i /* Loop over the blockSize */ i = blockSize; - while (i > 0U) { - /* copy the sample from the circular buffer to the destination buffer */ - *dst = circBuffer[rOffset]; + while (i > 0U) + { + /* copy the sample from the circular buffer to the destination buffer */ + *dst = circBuffer[rOffset]; - /* Update the input pointer */ - dst += dstInc; + /* Update the input pointer */ + dst += dstInc; - if (dst == dst_end) { - dst = dst_base; - } + if (dst == dst_end) + { + dst = dst_base; + } - /* Circularly update rOffset. Watch out for positive and negative value */ - rOffset += bufferInc; + /* Circularly update rOffset. Watch out for positive and negative value */ + rOffset += bufferInc; - if (rOffset >= L) { - rOffset -= L; - } + if (rOffset >= L) + { + rOffset -= L; + } - /* Decrement the loop counter */ - i--; + /* Decrement the loop counter */ + i--; } /* Update the index pointer */ *readOffset = rOffset; -} + } -/** + + /** * @brief Q15 Circular write function. */ -__STATIC_FORCEINLINE void arm_circularWrite_q15(q15_t *circBuffer, int32_t L, uint16_t *writeOffset, - int32_t bufferInc, const q15_t *src, int32_t srcInc, - uint32_t blockSize) -{ + __STATIC_FORCEINLINE void arm_circularWrite_q15( + q15_t * circBuffer, + int32_t L, + uint16_t * writeOffset, + int32_t bufferInc, + const q15_t * src, + int32_t srcInc, + uint32_t blockSize) + { uint32_t i = 0U; int32_t wOffset; @@ -1780,37 +2358,45 @@ __STATIC_FORCEINLINE void arm_circularWrite_q15(q15_t *circBuffer, int32_t L, ui /* Loop over the blockSize */ i = blockSize; - while (i > 0U) { - /* copy the input sample to the circular buffer */ - circBuffer[wOffset] = *src; + while (i > 0U) + { + /* copy the input sample to the circular buffer */ + circBuffer[wOffset] = *src; - /* Update the input pointer */ - src += srcInc; + /* Update the input pointer */ + src += srcInc; - /* Circularly update wOffset. Watch out for positive and negative value */ - wOffset += bufferInc; - if (wOffset >= L) - wOffset -= L; + /* Circularly update wOffset. Watch out for positive and negative value */ + wOffset += bufferInc; + if (wOffset >= L) + wOffset -= L; - /* Decrement the loop counter */ - i--; + /* Decrement the loop counter */ + i--; } /* Update the index pointer */ *writeOffset = (uint16_t)wOffset; -} + } -/** + + /** * @brief Q15 Circular Read function. */ -__STATIC_FORCEINLINE void arm_circularRead_q15(q15_t *circBuffer, int32_t L, int32_t *readOffset, - int32_t bufferInc, q15_t *dst, q15_t *dst_base, - int32_t dst_length, int32_t dstInc, - uint32_t blockSize) -{ + __STATIC_FORCEINLINE void arm_circularRead_q15( + q15_t * circBuffer, + int32_t L, + int32_t * readOffset, + int32_t bufferInc, + q15_t * dst, + q15_t * dst_base, + int32_t dst_length, + int32_t dstInc, + uint32_t blockSize) + { uint32_t i = 0; int32_t rOffset; - q15_t *dst_end; + q15_t* dst_end; /* Copy the value of Index pointer that points * to the current location from where the input samples to be read */ @@ -1821,39 +2407,48 @@ __STATIC_FORCEINLINE void arm_circularRead_q15(q15_t *circBuffer, int32_t L, int /* Loop over the blockSize */ i = blockSize; - while (i > 0U) { - /* copy the sample from the circular buffer to the destination buffer */ - *dst = circBuffer[rOffset]; + while (i > 0U) + { + /* copy the sample from the circular buffer to the destination buffer */ + *dst = circBuffer[rOffset]; - /* Update the input pointer */ - dst += dstInc; + /* Update the input pointer */ + dst += dstInc; - if (dst == dst_end) { - dst = dst_base; - } + if (dst == dst_end) + { + dst = dst_base; + } - /* Circularly update wOffset. Watch out for positive and negative value */ - rOffset += bufferInc; + /* Circularly update wOffset. Watch out for positive and negative value */ + rOffset += bufferInc; - if (rOffset >= L) { - rOffset -= L; - } + if (rOffset >= L) + { + rOffset -= L; + } - /* Decrement the loop counter */ - i--; + /* Decrement the loop counter */ + i--; } /* Update the index pointer */ *readOffset = rOffset; -} + } -/** + + /** * @brief Q7 Circular write function. */ -__STATIC_FORCEINLINE void arm_circularWrite_q7(q7_t *circBuffer, int32_t L, uint16_t *writeOffset, - int32_t bufferInc, const q7_t *src, int32_t srcInc, - uint32_t blockSize) -{ + __STATIC_FORCEINLINE void arm_circularWrite_q7( + q7_t * circBuffer, + int32_t L, + uint16_t * writeOffset, + int32_t bufferInc, + const q7_t * src, + int32_t srcInc, + uint32_t blockSize) + { uint32_t i = 0U; int32_t wOffset; @@ -1864,37 +2459,45 @@ __STATIC_FORCEINLINE void arm_circularWrite_q7(q7_t *circBuffer, int32_t L, uint /* Loop over the blockSize */ i = blockSize; - while (i > 0U) { - /* copy the input sample to the circular buffer */ - circBuffer[wOffset] = *src; + while (i > 0U) + { + /* copy the input sample to the circular buffer */ + circBuffer[wOffset] = *src; - /* Update the input pointer */ - src += srcInc; + /* Update the input pointer */ + src += srcInc; - /* Circularly update wOffset. Watch out for positive and negative value */ - wOffset += bufferInc; - if (wOffset >= L) - wOffset -= L; + /* Circularly update wOffset. Watch out for positive and negative value */ + wOffset += bufferInc; + if (wOffset >= L) + wOffset -= L; - /* Decrement the loop counter */ - i--; + /* Decrement the loop counter */ + i--; } /* Update the index pointer */ *writeOffset = (uint16_t)wOffset; -} + } -/** + + /** * @brief Q7 Circular Read function. */ -__STATIC_FORCEINLINE void arm_circularRead_q7(q7_t *circBuffer, int32_t L, int32_t *readOffset, - int32_t bufferInc, q7_t *dst, q7_t *dst_base, - int32_t dst_length, int32_t dstInc, - uint32_t blockSize) -{ + __STATIC_FORCEINLINE void arm_circularRead_q7( + q7_t * circBuffer, + int32_t L, + int32_t * readOffset, + int32_t bufferInc, + q7_t * dst, + q7_t * dst_base, + int32_t dst_length, + int32_t dstInc, + uint32_t blockSize) + { uint32_t i = 0; int32_t rOffset; - q7_t *dst_end; + q7_t* dst_end; /* Copy the value of Index pointer that points * to the current location from where the input samples to be read */ @@ -1905,31 +2508,35 @@ __STATIC_FORCEINLINE void arm_circularRead_q7(q7_t *circBuffer, int32_t L, int32 /* Loop over the blockSize */ i = blockSize; - while (i > 0U) { - /* copy the sample from the circular buffer to the destination buffer */ - *dst = circBuffer[rOffset]; + while (i > 0U) + { + /* copy the sample from the circular buffer to the destination buffer */ + *dst = circBuffer[rOffset]; - /* Update the input pointer */ - dst += dstInc; + /* Update the input pointer */ + dst += dstInc; - if (dst == dst_end) { - dst = dst_base; - } + if (dst == dst_end) + { + dst = dst_base; + } - /* Circularly update rOffset. Watch out for positive and negative value */ - rOffset += bufferInc; + /* Circularly update rOffset. Watch out for positive and negative value */ + rOffset += bufferInc; - if (rOffset >= L) { - rOffset -= L; - } + if (rOffset >= L) + { + rOffset -= L; + } - /* Decrement the loop counter */ - i--; + /* Decrement the loop counter */ + i--; } /* Update the index pointer */ *readOffset = rOffset; -} + } + /** @brief Levinson Durbin @@ -1937,9 +2544,12 @@ __STATIC_FORCEINLINE void arm_circularRead_q7(q7_t *circBuffer, int32_t L, int32 @param[out] a autoregressive coefficients @param[out] err prediction error (variance) @param[in] nbCoefs number of autoregressive coefficients - @return none */ -void arm_levinson_durbin_f32(const float32_t *phi, float32_t *a, float32_t *err, int nbCoefs); +void arm_levinson_durbin_f32(const float32_t *phi, + float32_t *a, + float32_t *err, + int nbCoefs); + /** @brief Levinson Durbin @@ -1947,11 +2557,13 @@ void arm_levinson_durbin_f32(const float32_t *phi, float32_t *a, float32_t *err, @param[out] a autoregressive coefficients @param[out] err prediction error (variance) @param[in] nbCoefs number of autoregressive coefficients - @return none */ -void arm_levinson_durbin_q31(const q31_t *phi, q31_t *a, q31_t *err, int nbCoefs); +void arm_levinson_durbin_q31(const q31_t *phi, + q31_t *a, + q31_t *err, + int nbCoefs); -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions_f16.h old mode 100644 new mode 100755 index f8ad957da20..655cd7e0f56 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions_f16.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _FILTERING_FUNCTIONS_F16_H_ -#define _FILTERING_FUNCTIONS_F16_H_ + +#ifndef FILTERING_FUNCTIONS_F16_H_ +#define FILTERING_FUNCTIONS_F16_H_ #include "arm_math_types_f16.h" #include "arm_math_memory.h" @@ -32,23 +33,25 @@ #include "dsp/none.h" #include "dsp/utils.h" -#ifdef __cplusplus -extern "C" { + +#ifdef __cplusplus +extern "C" +{ #endif #if defined(ARM_FLOAT16_SUPPORTED) -/** + /** * @brief Instance structure for the floating-point FIR filter. */ -typedef struct { - uint16_t numTaps; /**< number of filter coefficients in the filter. */ - float16_t * - pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ - const float16_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ -} arm_fir_instance_f16; - -/** + typedef struct + { + uint16_t numTaps; /**< number of filter coefficients in the filter. */ + float16_t *pState; /**< points to the state variable array. The array is of length numTaps+blockSize-1. */ + const float16_t *pCoeffs; /**< points to the coefficient array. The array is of length numTaps. */ + } arm_fir_instance_f16; + + /** * @brief Initialization function for the floating-point FIR filter. * @param[in,out] S points to an instance of the floating-point FIR filter structure. * @param[in] numTaps Number of filter coefficients in the filter. @@ -56,127 +59,148 @@ typedef struct { * @param[in] pState points to the state buffer. * @param[in] blockSize number of samples that are processed at a time. */ -void arm_fir_init_f16(arm_fir_instance_f16 *S, uint16_t numTaps, const float16_t *pCoeffs, - float16_t *pState, uint32_t blockSize); - -/** + void arm_fir_init_f16( + arm_fir_instance_f16 * S, + uint16_t numTaps, + const float16_t * pCoeffs, + float16_t * pState, + uint32_t blockSize); + + /** * @brief Processing function for the floating-point FIR filter. * @param[in] S points to an instance of the floating-point FIR structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_fir_f16(const arm_fir_instance_f16 *S, const float16_t *pSrc, float16_t *pDst, - uint32_t blockSize); + void arm_fir_f16( + const arm_fir_instance_f16 * S, + const float16_t * pSrc, + float16_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Instance structure for the floating-point Biquad cascade filter. */ -typedef struct { - uint32_t - numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ - float16_t * - pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ - const float16_t - *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ -} arm_biquad_casd_df1_inst_f16; + typedef struct + { + uint32_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float16_t *pState; /**< Points to the array of state coefficients. The array is of length 4*numStages. */ + const float16_t *pCoeffs; /**< Points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_casd_df1_inst_f16; #if defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE) -/** + /** * @brief Instance structure for the modified Biquad coefs required by vectorized code. */ -typedef struct { - float16_t coeffs - [12] - [8]; /**< Points to the array of modified coefficients. The array is of length 32. There is one per stage */ -} arm_biquad_mod_coef_f16; -#endif + typedef struct + { + float16_t coeffs[12][8]; /**< Points to the array of modified coefficients. The array is of length 32. There is one per stage */ + } arm_biquad_mod_coef_f16; +#endif -/** + /** * @brief Processing function for the floating-point Biquad cascade filter. * @param[in] S points to an instance of the floating-point Biquad cascade structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_biquad_cascade_df1_f16(const arm_biquad_casd_df1_inst_f16 *S, const float16_t *pSrc, - float16_t *pDst, uint32_t blockSize); + void arm_biquad_cascade_df1_f16( + const arm_biquad_casd_df1_inst_f16 * S, + const float16_t * pSrc, + float16_t * pDst, + uint32_t blockSize); #if defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE) -void arm_biquad_cascade_df1_mve_init_f16(arm_biquad_casd_df1_inst_f16 *S, uint8_t numStages, - const float16_t *pCoeffs, - arm_biquad_mod_coef_f16 *pCoeffsMod, float16_t *pState); + void arm_biquad_cascade_df1_mve_init_f16( + arm_biquad_casd_df1_inst_f16 * S, + uint8_t numStages, + const float16_t * pCoeffs, + arm_biquad_mod_coef_f16 * pCoeffsMod, + float16_t * pState); #endif -void arm_biquad_cascade_df1_init_f16(arm_biquad_casd_df1_inst_f16 *S, uint8_t numStages, - const float16_t *pCoeffs, float16_t *pState); + void arm_biquad_cascade_df1_init_f16( + arm_biquad_casd_df1_inst_f16 * S, + uint8_t numStages, + const float16_t * pCoeffs, + float16_t * pState); -/** + /** * @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter. */ -typedef struct { - uint8_t - numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ - float16_t * - pState; /**< points to the array of state coefficients. The array is of length 2*numStages. */ - const float16_t - *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ -} arm_biquad_cascade_df2T_instance_f16; - -/** + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float16_t *pState; /**< points to the array of state coefficients. The array is of length 2*numStages. */ + const float16_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_cascade_df2T_instance_f16; + + /** * @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter. */ -typedef struct { - uint8_t - numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ - float16_t * - pState; /**< points to the array of state coefficients. The array is of length 4*numStages. */ - const float16_t - *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ -} arm_biquad_cascade_stereo_df2T_instance_f16; - -/** + typedef struct + { + uint8_t numStages; /**< number of 2nd order stages in the filter. Overall order is 2*numStages. */ + float16_t *pState; /**< points to the array of state coefficients. The array is of length 4*numStages. */ + const float16_t *pCoeffs; /**< points to the array of coefficients. The array is of length 5*numStages. */ + } arm_biquad_cascade_stereo_df2T_instance_f16; + + /** * @brief Processing function for the floating-point transposed direct form II Biquad cascade filter. * @param[in] S points to an instance of the filter data structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of samples to process. */ -void arm_biquad_cascade_df2T_f16(const arm_biquad_cascade_df2T_instance_f16 *S, - const float16_t *pSrc, float16_t *pDst, uint32_t blockSize); + void arm_biquad_cascade_df2T_f16( + const arm_biquad_cascade_df2T_instance_f16 * S, + const float16_t * pSrc, + float16_t * pDst, + uint32_t blockSize); -/** + /** * @brief Processing function for the floating-point transposed direct form II Biquad cascade filter. 2 channels * @param[in] S points to an instance of the filter data structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of samples to process. */ -void arm_biquad_cascade_stereo_df2T_f16(const arm_biquad_cascade_stereo_df2T_instance_f16 *S, - const float16_t *pSrc, float16_t *pDst, uint32_t blockSize); + void arm_biquad_cascade_stereo_df2T_f16( + const arm_biquad_cascade_stereo_df2T_instance_f16 * S, + const float16_t * pSrc, + float16_t * pDst, + uint32_t blockSize); -/** + /** * @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter. * @param[in,out] S points to an instance of the filter data structure. * @param[in] numStages number of 2nd order stages in the filter. * @param[in] pCoeffs points to the filter coefficients. * @param[in] pState points to the state buffer. */ -void arm_biquad_cascade_df2T_init_f16(arm_biquad_cascade_df2T_instance_f16 *S, uint8_t numStages, - const float16_t *pCoeffs, float16_t *pState); + void arm_biquad_cascade_df2T_init_f16( + arm_biquad_cascade_df2T_instance_f16 * S, + uint8_t numStages, + const float16_t * pCoeffs, + float16_t * pState); -/** + /** * @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter. * @param[in,out] S points to an instance of the filter data structure. * @param[in] numStages number of 2nd order stages in the filter. * @param[in] pCoeffs points to the filter coefficients. * @param[in] pState points to the state buffer. */ -void arm_biquad_cascade_stereo_df2T_init_f16(arm_biquad_cascade_stereo_df2T_instance_f16 *S, - uint8_t numStages, const float16_t *pCoeffs, - float16_t *pState); + void arm_biquad_cascade_stereo_df2T_init_f16( + arm_biquad_cascade_stereo_df2T_instance_f16 * S, + uint8_t numStages, + const float16_t * pCoeffs, + float16_t * pState); -/** + /** * @brief Correlation of floating-point sequences. * @param[in] pSrcA points to the first input sequence. * @param[in] srcALen length of the first input sequence. @@ -184,8 +208,13 @@ void arm_biquad_cascade_stereo_df2T_init_f16(arm_biquad_cascade_stereo_df2T_inst * @param[in] srcBLen length of the second input sequence. * @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1. */ -void arm_correlate_f16(const float16_t *pSrcA, uint32_t srcALen, const float16_t *pSrcB, - uint32_t srcBLen, float16_t *pDst); + void arm_correlate_f16( + const float16_t * pSrcA, + uint32_t srcALen, + const float16_t * pSrcB, + uint32_t srcBLen, + float16_t * pDst); + /** @brief Levinson Durbin @@ -193,12 +222,14 @@ void arm_correlate_f16(const float16_t *pSrcA, uint32_t srcALen, const float16_t @param[out] a autoregressive coefficients @param[out] err prediction error (variance) @param[in] nbCoefs number of autoregressive coefficients - @return none */ -void arm_levinson_durbin_f16(const float16_t *phi, float16_t *a, float16_t *err, int nbCoefs); +void arm_levinson_durbin_f16(const float16_t *phi, + float16_t *a, + float16_t *err, + int nbCoefs); #endif /*defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions.h old mode 100644 new mode 100755 index ab4061efae4..574b73738f5 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _INTERPOLATION_FUNCTIONS_H_ -#define _INTERPOLATION_FUNCTIONS_H_ + +#ifndef INTERPOLATION_FUNCTIONS_H_ +#define INTERPOLATION_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -32,10 +33,12 @@ #include "dsp/none.h" #include "dsp/utils.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif + /** * @defgroup groupInterpolation Interpolation Functions * These functions perform 1- and 2-dimensional interpolation of data. @@ -43,91 +46,95 @@ extern "C" { * bilinear interpolation is used for 2-dimensional data. */ -/** + + /** * @brief Instance structure for the floating-point Linear Interpolate function. */ -typedef struct { - uint32_t nValues; /**< nValues */ - float32_t x1; /**< x1 */ - float32_t xSpacing; /**< xSpacing */ - float32_t *pYData; /**< pointer to the table of Y values */ -} arm_linear_interp_instance_f32; + typedef struct + { + uint32_t nValues; /**< nValues */ + float32_t x1; /**< x1 */ + float32_t xSpacing; /**< xSpacing */ + const float32_t *pYData; /**< pointer to the table of Y values */ + } arm_linear_interp_instance_f32; -/** + /** * @brief Instance structure for the floating-point bilinear interpolation function. */ -typedef struct { - uint16_t numRows; /**< number of rows in the data table. */ - uint16_t numCols; /**< number of columns in the data table. */ - float32_t *pData; /**< points to the data table. */ -} arm_bilinear_interp_instance_f32; + typedef struct + { + uint16_t numRows; /**< number of rows in the data table. */ + uint16_t numCols; /**< number of columns in the data table. */ + const float32_t *pData; /**< points to the data table. */ + } arm_bilinear_interp_instance_f32; -/** + /** * @brief Instance structure for the Q31 bilinear interpolation function. */ -typedef struct { - uint16_t numRows; /**< number of rows in the data table. */ - uint16_t numCols; /**< number of columns in the data table. */ - q31_t *pData; /**< points to the data table. */ -} arm_bilinear_interp_instance_q31; + typedef struct + { + uint16_t numRows; /**< number of rows in the data table. */ + uint16_t numCols; /**< number of columns in the data table. */ + const q31_t *pData; /**< points to the data table. */ + } arm_bilinear_interp_instance_q31; -/** + /** * @brief Instance structure for the Q15 bilinear interpolation function. */ -typedef struct { - uint16_t numRows; /**< number of rows in the data table. */ - uint16_t numCols; /**< number of columns in the data table. */ - q15_t *pData; /**< points to the data table. */ -} arm_bilinear_interp_instance_q15; + typedef struct + { + uint16_t numRows; /**< number of rows in the data table. */ + uint16_t numCols; /**< number of columns in the data table. */ + const q15_t *pData; /**< points to the data table. */ + } arm_bilinear_interp_instance_q15; -/** + /** * @brief Instance structure for the Q15 bilinear interpolation function. */ -typedef struct { - uint16_t numRows; /**< number of rows in the data table. */ - uint16_t numCols; /**< number of columns in the data table. */ - q7_t *pData; /**< points to the data table. */ -} arm_bilinear_interp_instance_q7; + typedef struct + { + uint16_t numRows; /**< number of rows in the data table. */ + uint16_t numCols; /**< number of columns in the data table. */ + const q7_t *pData; /**< points to the data table. */ + } arm_bilinear_interp_instance_q7; -/** + + /** * @brief Struct for specifying cubic spline type */ -typedef enum { - ARM_SPLINE_NATURAL = 0, /**< Natural spline */ - ARM_SPLINE_PARABOLIC_RUNOUT = 1 /**< Parabolic runout spline */ -} arm_spline_type; + typedef enum + { + ARM_SPLINE_NATURAL = 0, /**< Natural spline */ + ARM_SPLINE_PARABOLIC_RUNOUT = 1 /**< Parabolic runout spline */ + } arm_spline_type; -/** + /** * @brief Instance structure for the floating-point cubic spline interpolation. */ -typedef struct { - arm_spline_type type; /**< Type (boundary conditions) */ - const float32_t *x; /**< x values */ - const float32_t *y; /**< y values */ - uint32_t n_x; /**< Number of known data points */ - float32_t *coeffs; /**< Coefficients buffer (b,c, and d) */ -} arm_spline_instance_f32; - -/** - * @ingroup groupInterpolation - */ + typedef struct + { + arm_spline_type type; /**< Type (boundary conditions) */ + const float32_t * x; /**< x values */ + const float32_t * y; /**< y values */ + uint32_t n_x; /**< Number of known data points */ + float32_t * coeffs; /**< Coefficients buffer (b,c, and d) */ + } arm_spline_instance_f32; -/** - * @addtogroup SplineInterpolate - * @{ - */ -/** + /** * @brief Processing function for the floating-point cubic spline interpolation. * @param[in] S points to an instance of the floating-point spline structure. * @param[in] xq points to the x values ot the interpolated data points. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples of output data. */ -void arm_spline_f32(arm_spline_instance_f32 *S, const float32_t *xq, float32_t *pDst, - uint32_t blockSize); + void arm_spline_f32( + arm_spline_instance_f32 * S, + const float32_t * xq, + float32_t * pDst, + uint32_t blockSize); -/** + /** * @brief Initialization function for the floating-point cubic spline interpolation. * @param[in,out] S points to an instance of the floating-point spline structure. * @param[in] type type of cubic spline interpolation (boundary conditions) @@ -137,28 +144,28 @@ void arm_spline_f32(arm_spline_instance_f32 *S, const float32_t *xq, float32_t * * @param[in] coeffs coefficients array for b, c, and d * @param[in] tempBuffer buffer array for internal computations */ -void arm_spline_init_f32(arm_spline_instance_f32 *S, arm_spline_type type, const float32_t *x, - const float32_t *y, uint32_t n, float32_t *coeffs, float32_t *tempBuffer); + void arm_spline_init_f32( + arm_spline_instance_f32 * S, + arm_spline_type type, + const float32_t * x, + const float32_t * y, + uint32_t n, + float32_t * coeffs, + float32_t * tempBuffer); -/** - * @} end of SplineInterpolate group - */ - -/** - * @addtogroup LinearInterpolate - * @{ - */ -/** + /** * @brief Process function for the floating-point Linear Interpolation Function. * @param[in,out] S is an instance of the floating-point Linear Interpolation structure * @param[in] x input sample to process * @return y processed output sample. * */ -float32_t arm_linear_interp_f32(arm_linear_interp_instance_f32 *S, float32_t x); + float32_t arm_linear_interp_f32( + const arm_linear_interp_instance_f32 * S, + float32_t x); -/** + /** * * @brief Process function for the Q31 Linear Interpolation Function. * @param[in] pYData pointer to Q31 Linear Interpolation table @@ -171,9 +178,12 @@ float32_t arm_linear_interp_f32(arm_linear_interp_instance_f32 *S, float32_t x); * This function can support maximum of table size 2^12. * */ -q31_t arm_linear_interp_q31(const q31_t *pYData, q31_t x, uint32_t nValues); + q31_t arm_linear_interp_q31( + const q31_t * pYData, + q31_t x, + uint32_t nValues); -/** + /** * * @brief Process function for the Q15 Linear Interpolation Function. * @param[in] pYData pointer to Q15 Linear Interpolation table @@ -186,9 +196,12 @@ q31_t arm_linear_interp_q31(const q31_t *pYData, q31_t x, uint32_t nValues); * This function can support maximum of table size 2^12. * */ -q15_t arm_linear_interp_q15(const q15_t *pYData, q31_t x, uint32_t nValues); + q15_t arm_linear_interp_q15( + const q15_t * pYData, + q31_t x, + uint32_t nValues); -/** + /** * * @brief Process function for the Q7 Linear Interpolation Function. * @param[in] pYData pointer to Q7 Linear Interpolation table @@ -200,62 +213,62 @@ q15_t arm_linear_interp_q15(const q15_t *pYData, q31_t x, uint32_t nValues); * Input sample x is in 12.20 format which contains 12 bits for table index and 20 bits for fractional part. * This function can support maximum of table size 2^12. */ -q7_t arm_linear_interp_q7(const q7_t *pYData, q31_t x, uint32_t nValues); +q7_t arm_linear_interp_q7( + const q7_t * pYData, + q31_t x, + uint32_t nValues); -/** - * @} end of LinearInterpolate group - */ - -/** - * @ingroup groupInterpolation - */ - -/** - * @addtogroup BilinearInterpolate - * @{ - */ - -/** + /** * @brief Floating-point bilinear interpolation. * @param[in,out] S points to an instance of the interpolation structure. * @param[in] X interpolation coordinate. * @param[in] Y interpolation coordinate. * @return out interpolated value. */ -float32_t arm_bilinear_interp_f32(const arm_bilinear_interp_instance_f32 *S, float32_t X, - float32_t Y); + float32_t arm_bilinear_interp_f32( + const arm_bilinear_interp_instance_f32 * S, + float32_t X, + float32_t Y); -/** + /** * @brief Q31 bilinear interpolation. * @param[in,out] S points to an instance of the interpolation structure. * @param[in] X interpolation coordinate in 12.20 format. * @param[in] Y interpolation coordinate in 12.20 format. * @return out interpolated value. */ -q31_t arm_bilinear_interp_q31(arm_bilinear_interp_instance_q31 *S, q31_t X, q31_t Y); + q31_t arm_bilinear_interp_q31( + arm_bilinear_interp_instance_q31 * S, + q31_t X, + q31_t Y); -/** + + /** * @brief Q15 bilinear interpolation. * @param[in,out] S points to an instance of the interpolation structure. * @param[in] X interpolation coordinate in 12.20 format. * @param[in] Y interpolation coordinate in 12.20 format. * @return out interpolated value. */ -q15_t arm_bilinear_interp_q15(arm_bilinear_interp_instance_q15 *S, q31_t X, q31_t Y); + q15_t arm_bilinear_interp_q15( + arm_bilinear_interp_instance_q15 * S, + q31_t X, + q31_t Y); -/** + /** * @brief Q7 bilinear interpolation. * @param[in,out] S points to an instance of the interpolation structure. * @param[in] X interpolation coordinate in 12.20 format. * @param[in] Y interpolation coordinate in 12.20 format. * @return out interpolated value. */ -q7_t arm_bilinear_interp_q7(arm_bilinear_interp_instance_q7 *S, q31_t X, q31_t Y); -/** - * @} end of BilinearInterpolate group - */ + q7_t arm_bilinear_interp_q7( + arm_bilinear_interp_instance_q7 * S, + q31_t X, + q31_t Y); + -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions_f16.h old mode 100644 new mode 100755 index 19f91b3c05d..e1f27c3cdaf --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions_f16.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _INTERPOLATION_FUNCTIONS_F16_H_ -#define _INTERPOLATION_FUNCTIONS_F16_H_ + +#ifndef INTERPOLATION_FUNCTIONS_F16_H_ +#define INTERPOLATION_FUNCTIONS_F16_H_ #include "arm_math_types_f16.h" #include "arm_math_memory.h" @@ -32,43 +33,50 @@ #include "dsp/none.h" #include "dsp/utils.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #if defined(ARM_FLOAT16_SUPPORTED) -typedef struct { - uint32_t nValues; /**< nValues */ - float16_t x1; /**< x1 */ - float16_t xSpacing; /**< xSpacing */ - float16_t *pYData; /**< pointer to the table of Y values */ +/** + * @brief Instance structure for the half floating-point Linear Interpolate function. + */ +typedef struct +{ + uint32_t nValues; /**< nValues */ + float16_t x1; /**< x1 */ + float16_t xSpacing; /**< xSpacing */ + const float16_t *pYData; /**< pointer to the table of Y values */ } arm_linear_interp_instance_f16; /** * @brief Instance structure for the floating-point bilinear interpolation function. */ -typedef struct { - uint16_t numRows; /**< number of rows in the data table. */ - uint16_t numCols; /**< number of columns in the data table. */ - float16_t *pData; /**< points to the data table. */ +typedef struct +{ + uint16_t numRows;/**< number of rows in the data table. */ + uint16_t numCols;/**< number of columns in the data table. */ + const float16_t *pData; /**< points to the data table. */ } arm_bilinear_interp_instance_f16; -/** + /** * @addtogroup LinearInterpolate * @{ */ -/** + /** * @brief Process function for the floating-point Linear Interpolation Function. * @param[in,out] S is an instance of the floating-point Linear Interpolation structure * @param[in] x input sample to process * @return y processed output sample. - * */ -float16_t arm_linear_interp_f16(arm_linear_interp_instance_f16 *S, float16_t x); + float16_t arm_linear_interp_f16( + const arm_linear_interp_instance_f16 * S, + float16_t x); -/** + /** * @} end of LinearInterpolate group */ @@ -77,21 +85,24 @@ float16_t arm_linear_interp_f16(arm_linear_interp_instance_f16 *S, float16_t x); * @{ */ -/** + /** * @brief Floating-point bilinear interpolation. * @param[in,out] S points to an instance of the interpolation structure. * @param[in] X interpolation coordinate. * @param[in] Y interpolation coordinate. * @return out interpolated value. */ -float16_t arm_bilinear_interp_f16(const arm_bilinear_interp_instance_f16 *S, float16_t X, - float16_t Y); + float16_t arm_bilinear_interp_f16( + const arm_bilinear_interp_instance_f16 * S, + float16_t X, + float16_t Y); -/** + + /** * @} end of BilinearInterpolate group */ #endif /*defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions.h old mode 100644 new mode 100755 index e7409115e2f..175ca2fac22 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions.h @@ -1,8 +1,8 @@ /****************************************************************************** * @file matrix_functions.h * @brief Public header file for CMSIS DSP Library - * @version V1.10.0 - * @date 08 July 2021 + * @version V1.10.1 + * @date 10 August 2022 * Target Processor: Cortex-M and Cortex-A cores ******************************************************************************/ /* @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _MATRIX_FUNCTIONS_H_ -#define _MATRIX_FUNCTIONS_H_ + +#ifndef MATRIX_FUNCTIONS_H_ +#define MATRIX_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -32,8 +33,9 @@ #include "dsp/none.h" #include "dsp/utils.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif /** @@ -107,52 +109,60 @@ extern "C" { * return ARM_MATH_SUCCESS. */ -/** + #define DEFAULT_HOUSEHOLDER_THRESHOLD_F64 (1.0e-16) + #define DEFAULT_HOUSEHOLDER_THRESHOLD_F32 (1.0e-12f) + + /** * @brief Instance structure for the floating-point matrix structure. */ -typedef struct { - uint16_t numRows; /**< number of rows of the matrix. */ - uint16_t numCols; /**< number of columns of the matrix. */ - float32_t *pData; /**< points to the data of the matrix. */ -} arm_matrix_instance_f32; - -/** + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + float32_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_f32; + + /** * @brief Instance structure for the floating-point matrix structure. */ -typedef struct { - uint16_t numRows; /**< number of rows of the matrix. */ - uint16_t numCols; /**< number of columns of the matrix. */ - float64_t *pData; /**< points to the data of the matrix. */ -} arm_matrix_instance_f64; + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + float64_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_f64; -/** + /** * @brief Instance structure for the Q7 matrix structure. */ -typedef struct { - uint16_t numRows; /**< number of rows of the matrix. */ - uint16_t numCols; /**< number of columns of the matrix. */ - q7_t *pData; /**< points to the data of the matrix. */ -} arm_matrix_instance_q7; + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + q7_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_q7; -/** + /** * @brief Instance structure for the Q15 matrix structure. */ -typedef struct { - uint16_t numRows; /**< number of rows of the matrix. */ - uint16_t numCols; /**< number of columns of the matrix. */ - q15_t *pData; /**< points to the data of the matrix. */ -} arm_matrix_instance_q15; + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + q15_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_q15; -/** + /** * @brief Instance structure for the Q31 matrix structure. */ -typedef struct { - uint16_t numRows; /**< number of rows of the matrix. */ - uint16_t numCols; /**< number of columns of the matrix. */ - q31_t *pData; /**< points to the data of the matrix. */ -} arm_matrix_instance_q31; + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + q31_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_q31; -/** + /** * @brief Floating-point matrix addition. * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -160,10 +170,12 @@ typedef struct { * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_add_f32(const arm_matrix_instance_f32 *pSrcA, - const arm_matrix_instance_f32 *pSrcB, arm_matrix_instance_f32 *pDst); +arm_status arm_mat_add_f32( + const arm_matrix_instance_f32 * pSrcA, + const arm_matrix_instance_f32 * pSrcB, + arm_matrix_instance_f32 * pDst); -/** + /** * @brief Q15 matrix addition. * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -171,10 +183,12 @@ arm_status arm_mat_add_f32(const arm_matrix_instance_f32 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_add_q15(const arm_matrix_instance_q15 *pSrcA, - const arm_matrix_instance_q15 *pSrcB, arm_matrix_instance_q15 *pDst); +arm_status arm_mat_add_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst); -/** + /** * @brief Q31 matrix addition. * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -182,10 +196,12 @@ arm_status arm_mat_add_q15(const arm_matrix_instance_q15 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_add_q31(const arm_matrix_instance_q31 *pSrcA, - const arm_matrix_instance_q31 *pSrcB, arm_matrix_instance_q31 *pDst); +arm_status arm_mat_add_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); -/** + /** * @brief Floating-point, complex, matrix multiplication. * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -193,11 +209,12 @@ arm_status arm_mat_add_q31(const arm_matrix_instance_q31 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_cmplx_mult_f32(const arm_matrix_instance_f32 *pSrcA, - const arm_matrix_instance_f32 *pSrcB, - arm_matrix_instance_f32 *pDst); +arm_status arm_mat_cmplx_mult_f32( + const arm_matrix_instance_f32 * pSrcA, + const arm_matrix_instance_f32 * pSrcB, + arm_matrix_instance_f32 * pDst); -/** + /** * @brief Q15, complex, matrix multiplication. * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -205,11 +222,13 @@ arm_status arm_mat_cmplx_mult_f32(const arm_matrix_instance_f32 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_cmplx_mult_q15(const arm_matrix_instance_q15 *pSrcA, - const arm_matrix_instance_q15 *pSrcB, - arm_matrix_instance_q15 *pDst, q15_t *pScratch); +arm_status arm_mat_cmplx_mult_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst, + q15_t * pScratch); -/** + /** * @brief Q31, complex, matrix multiplication. * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -217,18 +236,21 @@ arm_status arm_mat_cmplx_mult_q15(const arm_matrix_instance_q15 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_cmplx_mult_q31(const arm_matrix_instance_q31 *pSrcA, - const arm_matrix_instance_q31 *pSrcB, - arm_matrix_instance_q31 *pDst); +arm_status arm_mat_cmplx_mult_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); -/** + /** * @brief Floating-point matrix transpose. * @param[in] pSrc points to the input matrix * @param[out] pDst points to the output matrix * @return The function returns either ARM_MATH_SIZE_MISMATCH * or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_trans_f32(const arm_matrix_instance_f32 *pSrc, arm_matrix_instance_f32 *pDst); +arm_status arm_mat_trans_f32( + const arm_matrix_instance_f32 * pSrc, + arm_matrix_instance_f32 * pDst); /** * @brief Floating-point matrix transpose. @@ -237,66 +259,78 @@ arm_status arm_mat_trans_f32(const arm_matrix_instance_f32 *pSrc, arm_matrix_ins * @return The function returns either ARM_MATH_SIZE_MISMATCH * or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_trans_f64(const arm_matrix_instance_f64 *pSrc, arm_matrix_instance_f64 *pDst); +arm_status arm_mat_trans_f64( + const arm_matrix_instance_f64 * pSrc, + arm_matrix_instance_f64 * pDst); -/** + /** * @brief Floating-point complex matrix transpose. * @param[in] pSrc points to the input matrix * @param[out] pDst points to the output matrix * @return The function returns either ARM_MATH_SIZE_MISMATCH * or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_cmplx_trans_f32(const arm_matrix_instance_f32 *pSrc, - arm_matrix_instance_f32 *pDst); +arm_status arm_mat_cmplx_trans_f32( + const arm_matrix_instance_f32 * pSrc, + arm_matrix_instance_f32 * pDst); -/** + + /** * @brief Q15 matrix transpose. * @param[in] pSrc points to the input matrix * @param[out] pDst points to the output matrix * @return The function returns either ARM_MATH_SIZE_MISMATCH * or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_trans_q15(const arm_matrix_instance_q15 *pSrc, arm_matrix_instance_q15 *pDst); +arm_status arm_mat_trans_q15( + const arm_matrix_instance_q15 * pSrc, + arm_matrix_instance_q15 * pDst); -/** + /** * @brief Q15 complex matrix transpose. * @param[in] pSrc points to the input matrix * @param[out] pDst points to the output matrix * @return The function returns either ARM_MATH_SIZE_MISMATCH * or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_cmplx_trans_q15(const arm_matrix_instance_q15 *pSrc, - arm_matrix_instance_q15 *pDst); +arm_status arm_mat_cmplx_trans_q15( + const arm_matrix_instance_q15 * pSrc, + arm_matrix_instance_q15 * pDst); -/** + /** * @brief Q7 matrix transpose. * @param[in] pSrc points to the input matrix * @param[out] pDst points to the output matrix * @return The function returns either ARM_MATH_SIZE_MISMATCH * or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_trans_q7(const arm_matrix_instance_q7 *pSrc, arm_matrix_instance_q7 *pDst); +arm_status arm_mat_trans_q7( + const arm_matrix_instance_q7 * pSrc, + arm_matrix_instance_q7 * pDst); -/** + /** * @brief Q31 matrix transpose. * @param[in] pSrc points to the input matrix * @param[out] pDst points to the output matrix * @return The function returns either ARM_MATH_SIZE_MISMATCH * or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_trans_q31(const arm_matrix_instance_q31 *pSrc, arm_matrix_instance_q31 *pDst); +arm_status arm_mat_trans_q31( + const arm_matrix_instance_q31 * pSrc, + arm_matrix_instance_q31 * pDst); -/** + /** * @brief Q31 complex matrix transpose. * @param[in] pSrc points to the input matrix * @param[out] pDst points to the output matrix * @return The function returns either ARM_MATH_SIZE_MISMATCH * or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_cmplx_trans_q31(const arm_matrix_instance_q31 *pSrc, - arm_matrix_instance_q31 *pDst); +arm_status arm_mat_cmplx_trans_q31( + const arm_matrix_instance_q31 * pSrc, + arm_matrix_instance_q31 * pDst); -/** + /** * @brief Floating-point matrix multiplication * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -304,10 +338,12 @@ arm_status arm_mat_cmplx_trans_q31(const arm_matrix_instance_q31 *pSrc, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_mult_f32(const arm_matrix_instance_f32 *pSrcA, - const arm_matrix_instance_f32 *pSrcB, arm_matrix_instance_f32 *pDst); +arm_status arm_mat_mult_f32( + const arm_matrix_instance_f32 * pSrcA, + const arm_matrix_instance_f32 * pSrcB, + arm_matrix_instance_f32 * pDst); -/** + /** * @brief Floating-point matrix multiplication * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -315,19 +351,23 @@ arm_status arm_mat_mult_f32(const arm_matrix_instance_f32 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_mult_f64(const arm_matrix_instance_f64 *pSrcA, - const arm_matrix_instance_f64 *pSrcB, arm_matrix_instance_f64 *pDst); +arm_status arm_mat_mult_f64( + const arm_matrix_instance_f64 * pSrcA, + const arm_matrix_instance_f64 * pSrcB, + arm_matrix_instance_f64 * pDst); -/** + /** * @brief Floating-point matrix and vector multiplication * @param[in] pSrcMat points to the input matrix structure * @param[in] pVec points to vector * @param[out] pDst points to output vector */ -void arm_mat_vec_mult_f32(const arm_matrix_instance_f32 *pSrcMat, const float32_t *pVec, - float32_t *pDst); +void arm_mat_vec_mult_f32( + const arm_matrix_instance_f32 *pSrcMat, + const float32_t *pVec, + float32_t *pDst); -/** + /** * @brief Q7 matrix multiplication * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -336,18 +376,24 @@ void arm_mat_vec_mult_f32(const arm_matrix_instance_f32 *pSrcMat, const float32_ * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_mult_q7(const arm_matrix_instance_q7 *pSrcA, const arm_matrix_instance_q7 *pSrcB, - arm_matrix_instance_q7 *pDst, q7_t *pState); +arm_status arm_mat_mult_q7( + const arm_matrix_instance_q7 * pSrcA, + const arm_matrix_instance_q7 * pSrcB, + arm_matrix_instance_q7 * pDst, + q7_t * pState); -/** + /** * @brief Q7 matrix and vector multiplication * @param[in] pSrcMat points to the input matrix structure * @param[in] pVec points to vector * @param[out] pDst points to output vector */ -void arm_mat_vec_mult_q7(const arm_matrix_instance_q7 *pSrcMat, const q7_t *pVec, q7_t *pDst); +void arm_mat_vec_mult_q7( + const arm_matrix_instance_q7 *pSrcMat, + const q7_t *pVec, + q7_t *pDst); -/** + /** * @brief Q15 matrix multiplication * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -356,19 +402,24 @@ void arm_mat_vec_mult_q7(const arm_matrix_instance_q7 *pSrcMat, const q7_t *pVec * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_mult_q15(const arm_matrix_instance_q15 *pSrcA, - const arm_matrix_instance_q15 *pSrcB, arm_matrix_instance_q15 *pDst, - q15_t *pState); +arm_status arm_mat_mult_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst, + q15_t * pState); -/** + /** * @brief Q15 matrix and vector multiplication * @param[in] pSrcMat points to the input matrix structure * @param[in] pVec points to vector * @param[out] pDst points to output vector */ -void arm_mat_vec_mult_q15(const arm_matrix_instance_q15 *pSrcMat, const q15_t *pVec, q15_t *pDst); +void arm_mat_vec_mult_q15( + const arm_matrix_instance_q15 *pSrcMat, + const q15_t *pVec, + q15_t *pDst); -/** + /** * @brief Q15 matrix multiplication (fast variant) for Cortex-M3 and Cortex-M4 * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -377,11 +428,13 @@ void arm_mat_vec_mult_q15(const arm_matrix_instance_q15 *pSrcMat, const q15_t *p * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_mult_fast_q15(const arm_matrix_instance_q15 *pSrcA, - const arm_matrix_instance_q15 *pSrcB, - arm_matrix_instance_q15 *pDst, q15_t *pState); +arm_status arm_mat_mult_fast_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst, + q15_t * pState); -/** + /** * @brief Q31 matrix multiplication * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -389,10 +442,12 @@ arm_status arm_mat_mult_fast_q15(const arm_matrix_instance_q15 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_mult_q31(const arm_matrix_instance_q31 *pSrcA, - const arm_matrix_instance_q31 *pSrcB, arm_matrix_instance_q31 *pDst); +arm_status arm_mat_mult_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); -/** + /** * @brief Q31 matrix multiplication * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -401,19 +456,24 @@ arm_status arm_mat_mult_q31(const arm_matrix_instance_q31 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_mult_opt_q31(const arm_matrix_instance_q31 *pSrcA, - const arm_matrix_instance_q31 *pSrcB, arm_matrix_instance_q31 *pDst, - q31_t *pState); +arm_status arm_mat_mult_opt_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst, + q31_t *pState); -/** + /** * @brief Q31 matrix and vector multiplication * @param[in] pSrcMat points to the input matrix structure * @param[in] pVec points to vector * @param[out] pDst points to output vector */ -void arm_mat_vec_mult_q31(const arm_matrix_instance_q31 *pSrcMat, const q31_t *pVec, q31_t *pDst); +void arm_mat_vec_mult_q31( + const arm_matrix_instance_q31 *pSrcMat, + const q31_t *pVec, + q31_t *pDst); -/** + /** * @brief Q31 matrix multiplication (fast variant) for Cortex-M3 and Cortex-M4 * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -421,11 +481,12 @@ void arm_mat_vec_mult_q31(const arm_matrix_instance_q31 *pSrcMat, const q31_t *p * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_mult_fast_q31(const arm_matrix_instance_q31 *pSrcA, - const arm_matrix_instance_q31 *pSrcB, - arm_matrix_instance_q31 *pDst); +arm_status arm_mat_mult_fast_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); -/** + /** * @brief Floating-point matrix subtraction * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -433,10 +494,12 @@ arm_status arm_mat_mult_fast_q31(const arm_matrix_instance_q31 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_sub_f32(const arm_matrix_instance_f32 *pSrcA, - const arm_matrix_instance_f32 *pSrcB, arm_matrix_instance_f32 *pDst); +arm_status arm_mat_sub_f32( + const arm_matrix_instance_f32 * pSrcA, + const arm_matrix_instance_f32 * pSrcB, + arm_matrix_instance_f32 * pDst); -/** + /** * @brief Floating-point matrix subtraction * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -444,10 +507,12 @@ arm_status arm_mat_sub_f32(const arm_matrix_instance_f32 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_sub_f64(const arm_matrix_instance_f64 *pSrcA, - const arm_matrix_instance_f64 *pSrcB, arm_matrix_instance_f64 *pDst); +arm_status arm_mat_sub_f64( + const arm_matrix_instance_f64 * pSrcA, + const arm_matrix_instance_f64 * pSrcB, + arm_matrix_instance_f64 * pDst); -/** + /** * @brief Q15 matrix subtraction * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -455,10 +520,12 @@ arm_status arm_mat_sub_f64(const arm_matrix_instance_f64 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_sub_q15(const arm_matrix_instance_q15 *pSrcA, - const arm_matrix_instance_q15 *pSrcB, arm_matrix_instance_q15 *pDst); +arm_status arm_mat_sub_q15( + const arm_matrix_instance_q15 * pSrcA, + const arm_matrix_instance_q15 * pSrcB, + arm_matrix_instance_q15 * pDst); -/** + /** * @brief Q31 matrix subtraction * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -466,10 +533,12 @@ arm_status arm_mat_sub_q15(const arm_matrix_instance_q15 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_sub_q31(const arm_matrix_instance_q31 *pSrcA, - const arm_matrix_instance_q31 *pSrcB, arm_matrix_instance_q31 *pDst); +arm_status arm_mat_sub_q31( + const arm_matrix_instance_q31 * pSrcA, + const arm_matrix_instance_q31 * pSrcB, + arm_matrix_instance_q31 * pDst); -/** + /** * @brief Floating-point matrix scaling. * @param[in] pSrc points to the input matrix * @param[in] scale scale factor @@ -477,10 +546,12 @@ arm_status arm_mat_sub_q31(const arm_matrix_instance_q31 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_scale_f32(const arm_matrix_instance_f32 *pSrc, float32_t scale, - arm_matrix_instance_f32 *pDst); +arm_status arm_mat_scale_f32( + const arm_matrix_instance_f32 * pSrc, + float32_t scale, + arm_matrix_instance_f32 * pDst); -/** + /** * @brief Q15 matrix scaling. * @param[in] pSrc points to input matrix * @param[in] scaleFract fractional portion of the scale factor @@ -489,10 +560,13 @@ arm_status arm_mat_scale_f32(const arm_matrix_instance_f32 *pSrc, float32_t scal * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_scale_q15(const arm_matrix_instance_q15 *pSrc, q15_t scaleFract, int32_t shift, - arm_matrix_instance_q15 *pDst); +arm_status arm_mat_scale_q15( + const arm_matrix_instance_q15 * pSrc, + q15_t scaleFract, + int32_t shift, + arm_matrix_instance_q15 * pDst); -/** + /** * @brief Q31 matrix scaling. * @param[in] pSrc points to input matrix * @param[in] scaleFract fractional portion of the scale factor @@ -501,56 +575,91 @@ arm_status arm_mat_scale_q15(const arm_matrix_instance_q15 *pSrc, q15_t scaleFra * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_scale_q31(const arm_matrix_instance_q31 *pSrc, q31_t scaleFract, int32_t shift, - arm_matrix_instance_q31 *pDst); +arm_status arm_mat_scale_q31( + const arm_matrix_instance_q31 * pSrc, + q31_t scaleFract, + int32_t shift, + arm_matrix_instance_q31 * pDst); -/** + /** * @brief Q31 matrix initialization. * @param[in,out] S points to an instance of the floating-point matrix structure. * @param[in] nRows number of rows in the matrix. * @param[in] nColumns number of columns in the matrix. * @param[in] pData points to the matrix data array. */ -void arm_mat_init_q31(arm_matrix_instance_q31 *S, uint16_t nRows, uint16_t nColumns, q31_t *pData); +void arm_mat_init_q31( + arm_matrix_instance_q31 * S, + uint16_t nRows, + uint16_t nColumns, + q31_t * pData); -/** + /** * @brief Q15 matrix initialization. * @param[in,out] S points to an instance of the floating-point matrix structure. * @param[in] nRows number of rows in the matrix. * @param[in] nColumns number of columns in the matrix. * @param[in] pData points to the matrix data array. */ -void arm_mat_init_q15(arm_matrix_instance_q15 *S, uint16_t nRows, uint16_t nColumns, q15_t *pData); +void arm_mat_init_q15( + arm_matrix_instance_q15 * S, + uint16_t nRows, + uint16_t nColumns, + q15_t * pData); -/** + /** * @brief Floating-point matrix initialization. * @param[in,out] S points to an instance of the floating-point matrix structure. * @param[in] nRows number of rows in the matrix. * @param[in] nColumns number of columns in the matrix. * @param[in] pData points to the matrix data array. */ -void arm_mat_init_f32(arm_matrix_instance_f32 *S, uint16_t nRows, uint16_t nColumns, - float32_t *pData); +void arm_mat_init_f32( + arm_matrix_instance_f32 * S, + uint16_t nRows, + uint16_t nColumns, + float32_t * pData); /** + * @brief Floating-point matrix initialization. + * @param[in,out] S points to an instance of the floating-point matrix structure. + * @param[in] nRows number of rows in the matrix. + * @param[in] nColumns number of columns in the matrix. + * @param[in] pData points to the matrix data array. + */ +void arm_mat_init_f64( + arm_matrix_instance_f64 * S, + uint16_t nRows, + uint16_t nColumns, + float64_t * pData); + + + + + /** * @brief Floating-point matrix inverse. * @param[in] src points to the instance of the input floating-point matrix structure. * @param[out] dst points to the instance of the output floating-point matrix structure. * @return The function returns ARM_MATH_SIZE_MISMATCH, if the dimensions do not match. * If the input matrix is singular (does not have an inverse), then the algorithm terminates and returns error status ARM_MATH_SINGULAR. */ -arm_status arm_mat_inverse_f32(const arm_matrix_instance_f32 *src, arm_matrix_instance_f32 *dst); + arm_status arm_mat_inverse_f32( + const arm_matrix_instance_f32 * src, + arm_matrix_instance_f32 * dst); -/** + + /** * @brief Floating-point matrix inverse. * @param[in] src points to the instance of the input floating-point matrix structure. * @param[out] dst points to the instance of the output floating-point matrix structure. * @return The function returns ARM_MATH_SIZE_MISMATCH, if the dimensions do not match. * If the input matrix is singular (does not have an inverse), then the algorithm terminates and returns error status ARM_MATH_SINGULAR. */ -arm_status arm_mat_inverse_f64(const arm_matrix_instance_f64 *src, arm_matrix_instance_f64 *dst); + arm_status arm_mat_inverse_f64( + const arm_matrix_instance_f64 * src, + arm_matrix_instance_f64 * dst); -/** + /** * @brief Floating-point Cholesky decomposition of Symmetric Positive Definite Matrix. * @param[in] src points to the instance of the input floating-point matrix structure. * @param[out] dst points to the instance of the output floating-point matrix structure. @@ -559,9 +668,11 @@ arm_status arm_mat_inverse_f64(const arm_matrix_instance_f64 *src, arm_matrix_in * If the matrix is ill conditioned or only semi-definite, then it is better using the LDL^t decomposition. * The decomposition is returning a lower triangular matrix. */ -arm_status arm_mat_cholesky_f64(const arm_matrix_instance_f64 *src, arm_matrix_instance_f64 *dst); + arm_status arm_mat_cholesky_f64( + const arm_matrix_instance_f64 * src, + arm_matrix_instance_f64 * dst); -/** + /** * @brief Floating-point Cholesky decomposition of Symmetric Positive Definite Matrix. * @param[in] src points to the instance of the input floating-point matrix structure. * @param[out] dst points to the instance of the output floating-point matrix structure. @@ -570,53 +681,61 @@ arm_status arm_mat_cholesky_f64(const arm_matrix_instance_f64 *src, arm_matrix_i * If the matrix is ill conditioned or only semi-definite, then it is better using the LDL^t decomposition. * The decomposition is returning a lower triangular matrix. */ -arm_status arm_mat_cholesky_f32(const arm_matrix_instance_f32 *src, arm_matrix_instance_f32 *dst); + arm_status arm_mat_cholesky_f32( + const arm_matrix_instance_f32 * src, + arm_matrix_instance_f32 * dst); -/** + /** * @brief Solve UT . X = A where UT is an upper triangular matrix * @param[in] ut The upper triangular matrix * @param[in] a The matrix a * @param[out] dst The solution X of UT . X = A * @return The function returns ARM_MATH_SINGULAR, if the system can't be solved. */ -arm_status arm_mat_solve_upper_triangular_f32(const arm_matrix_instance_f32 *ut, - const arm_matrix_instance_f32 *a, - arm_matrix_instance_f32 *dst); + arm_status arm_mat_solve_upper_triangular_f32( + const arm_matrix_instance_f32 * ut, + const arm_matrix_instance_f32 * a, + arm_matrix_instance_f32 * dst); -/** + /** * @brief Solve LT . X = A where LT is a lower triangular matrix * @param[in] lt The lower triangular matrix * @param[in] a The matrix a * @param[out] dst The solution X of LT . X = A * @return The function returns ARM_MATH_SINGULAR, if the system can't be solved. */ -arm_status arm_mat_solve_lower_triangular_f32(const arm_matrix_instance_f32 *lt, - const arm_matrix_instance_f32 *a, - arm_matrix_instance_f32 *dst); + arm_status arm_mat_solve_lower_triangular_f32( + const arm_matrix_instance_f32 * lt, + const arm_matrix_instance_f32 * a, + arm_matrix_instance_f32 * dst); -/** + + /** * @brief Solve UT . X = A where UT is an upper triangular matrix * @param[in] ut The upper triangular matrix * @param[in] a The matrix a * @param[out] dst The solution X of UT . X = A * @return The function returns ARM_MATH_SINGULAR, if the system can't be solved. */ -arm_status arm_mat_solve_upper_triangular_f64(const arm_matrix_instance_f64 *ut, - const arm_matrix_instance_f64 *a, - arm_matrix_instance_f64 *dst); + arm_status arm_mat_solve_upper_triangular_f64( + const arm_matrix_instance_f64 * ut, + const arm_matrix_instance_f64 * a, + arm_matrix_instance_f64 * dst); -/** + /** * @brief Solve LT . X = A where LT is a lower triangular matrix * @param[in] lt The lower triangular matrix * @param[in] a The matrix a * @param[out] dst The solution X of LT . X = A * @return The function returns ARM_MATH_SINGULAR, if the system can't be solved. */ -arm_status arm_mat_solve_lower_triangular_f64(const arm_matrix_instance_f64 *lt, - const arm_matrix_instance_f64 *a, - arm_matrix_instance_f64 *dst); + arm_status arm_mat_solve_lower_triangular_f64( + const arm_matrix_instance_f64 * lt, + const arm_matrix_instance_f64 * a, + arm_matrix_instance_f64 * dst); -/** + + /** * @brief Floating-point LDL decomposition of Symmetric Positive Semi-Definite Matrix. * @param[in] src points to the instance of the input floating-point matrix structure. * @param[out] l points to the instance of the output floating-point triangular matrix structure. @@ -626,10 +745,13 @@ arm_status arm_mat_solve_lower_triangular_f64(const arm_matrix_instance_f64 *lt, * If the input matrix does not have a decomposition, then the algorithm terminates and returns error status ARM_MATH_DECOMPOSITION_FAILURE. * The decomposition is returning a lower triangular matrix. */ -arm_status arm_mat_ldlt_f32(const arm_matrix_instance_f32 *src, arm_matrix_instance_f32 *l, - arm_matrix_instance_f32 *d, uint16_t *pp); + arm_status arm_mat_ldlt_f32( + const arm_matrix_instance_f32 * src, + arm_matrix_instance_f32 * l, + arm_matrix_instance_f32 * d, + uint16_t * pp); -/** + /** * @brief Floating-point LDL decomposition of Symmetric Positive Semi-Definite Matrix. * @param[in] src points to the instance of the input floating-point matrix structure. * @param[out] l points to the instance of the output floating-point triangular matrix structure. @@ -639,10 +761,95 @@ arm_status arm_mat_ldlt_f32(const arm_matrix_instance_f32 *src, arm_matrix_insta * If the input matrix does not have a decomposition, then the algorithm terminates and returns error status ARM_MATH_DECOMPOSITION_FAILURE. * The decomposition is returning a lower triangular matrix. */ -arm_status arm_mat_ldlt_f64(const arm_matrix_instance_f64 *src, arm_matrix_instance_f64 *l, - arm_matrix_instance_f64 *d, uint16_t *pp); + arm_status arm_mat_ldlt_f64( + const arm_matrix_instance_f64 * src, + arm_matrix_instance_f64 * l, + arm_matrix_instance_f64 * d, + uint16_t * pp); + +/** + @brief QR decomposition of a m x n floating point matrix with m >= n. + @param[in] pSrc points to input matrix structure. The source matrix is modified by the function. + @param[in] threshold norm2 threshold. + @param[out] pOutR points to output R matrix structure of dimension m x n + @param[out] pOutQ points to output Q matrix structure of dimension m x m + @param[out] pOutTau points to Householder scaling factors of dimension n + @param[inout] pTmpA points to a temporary vector of dimension m. + @param[inout] pTmpB points to a temporary vector of dimension n. + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_SIZE_MISMATCH : Matrix size check failed + - \ref ARM_MATH_SINGULAR : Input matrix is found to be singular (non-invertible) + */ + +arm_status arm_mat_qr_f32( + const arm_matrix_instance_f32 * pSrc, + const float32_t threshold, + arm_matrix_instance_f32 * pOutR, + arm_matrix_instance_f32 * pOutQ, + float32_t * pOutTau, + float32_t *pTmpA, + float32_t *pTmpB + ); + +/** + @brief QR decomposition of a m x n floating point matrix with m >= n. + @param[in] pSrc points to input matrix structure. The source matrix is modified by the function. + @param[in] threshold norm2 threshold. + @param[out] pOutR points to output R matrix structure of dimension m x n + @param[out] pOutQ points to output Q matrix structure of dimension m x m + @param[out] pOutTau points to Householder scaling factors of dimension n + @param[inout] pTmpA points to a temporary vector of dimension m. + @param[inout] pTmpB points to a temporary vector of dimension n. + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_SIZE_MISMATCH : Matrix size check failed + - \ref ARM_MATH_SINGULAR : Input matrix is found to be singular (non-invertible) + */ + +arm_status arm_mat_qr_f64( + const arm_matrix_instance_f64 * pSrc, + const float64_t threshold, + arm_matrix_instance_f64 * pOutR, + arm_matrix_instance_f64 * pOutQ, + float64_t * pOutTau, + float64_t *pTmpA, + float64_t *pTmpB + ); + +/** + @brief Householder transform of a floating point vector. + @param[in] pSrc points to the input vector. + @param[in] threshold norm2 threshold. + @param[in] blockSize dimension of the vector space. + @param[outQ] pOut points to the output vector. + @return beta return the scaling factor beta + */ + +float32_t arm_householder_f32( + const float32_t * pSrc, + const float32_t threshold, + uint32_t blockSize, + float32_t * pOut + ); + +/** + @brief Householder transform of a double floating point vector. + @param[in] pSrc points to the input vector. + @param[in] threshold norm2 threshold. + @param[in] blockSize dimension of the vector space. + @param[outQ] pOut points to the output vector. + @return beta return the scaling factor beta + */ + +float64_t arm_householder_f64( + const float64_t * pSrc, + const float64_t threshold, + uint32_t blockSize, + float64_t * pOut + ); -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions_f16.h old mode 100644 new mode 100755 index 088ac5e2d46..39eb9a80175 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions_f16.h @@ -23,31 +23,37 @@ * limitations under the License. */ -#ifndef _MATRIX_FUNCTIONS_F16_H_ -#define _MATRIX_FUNCTIONS_F16_H_ + +#ifndef MATRIX_FUNCTIONS_F16_H_ +#define MATRIX_FUNCTIONS_F16_H_ -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif + #include "arm_math_types_f16.h" #include "arm_math_memory.h" #include "dsp/none.h" #include "dsp/utils.h" - + #if defined(ARM_FLOAT16_SUPPORTED) -/** + #define DEFAULT_HOUSEHOLDER_THRESHOLD_F16 (1.0e-3f) + + /** * @brief Instance structure for the floating-point matrix structure. */ -typedef struct { - uint16_t numRows; /**< number of rows of the matrix. */ - uint16_t numCols; /**< number of columns of the matrix. */ - float16_t *pData; /**< points to the data of the matrix. */ -} arm_matrix_instance_f16; + typedef struct + { + uint16_t numRows; /**< number of rows of the matrix. */ + uint16_t numCols; /**< number of columns of the matrix. */ + float16_t *pData; /**< points to the data of the matrix. */ + } arm_matrix_instance_f16; -/** + /** * @brief Floating-point matrix addition. * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -55,10 +61,12 @@ typedef struct { * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_add_f16(const arm_matrix_instance_f16 *pSrcA, - const arm_matrix_instance_f16 *pSrcB, arm_matrix_instance_f16 *pDst); +arm_status arm_mat_add_f16( + const arm_matrix_instance_f16 * pSrcA, + const arm_matrix_instance_f16 * pSrcB, + arm_matrix_instance_f16 * pDst); -/** + /** * @brief Floating-point, complex, matrix multiplication. * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -66,30 +74,34 @@ arm_status arm_mat_add_f16(const arm_matrix_instance_f16 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_cmplx_mult_f16(const arm_matrix_instance_f16 *pSrcA, - const arm_matrix_instance_f16 *pSrcB, - arm_matrix_instance_f16 *pDst); +arm_status arm_mat_cmplx_mult_f16( + const arm_matrix_instance_f16 * pSrcA, + const arm_matrix_instance_f16 * pSrcB, + arm_matrix_instance_f16 * pDst); -/** + /** * @brief Floating-point matrix transpose. * @param[in] pSrc points to the input matrix * @param[out] pDst points to the output matrix * @return The function returns either ARM_MATH_SIZE_MISMATCH * or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_trans_f16(const arm_matrix_instance_f16 *pSrc, arm_matrix_instance_f16 *pDst); +arm_status arm_mat_trans_f16( + const arm_matrix_instance_f16 * pSrc, + arm_matrix_instance_f16 * pDst); -/** + /** * @brief Floating-point complex matrix transpose. * @param[in] pSrc points to the input matrix * @param[out] pDst points to the output matrix * @return The function returns either ARM_MATH_SIZE_MISMATCH * or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_cmplx_trans_f16(const arm_matrix_instance_f16 *pSrc, - arm_matrix_instance_f16 *pDst); +arm_status arm_mat_cmplx_trans_f16( + const arm_matrix_instance_f16 * pSrc, + arm_matrix_instance_f16 * pDst); -/** + /** * @brief Floating-point matrix multiplication * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -97,18 +109,22 @@ arm_status arm_mat_cmplx_trans_f16(const arm_matrix_instance_f16 *pSrc, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_mult_f16(const arm_matrix_instance_f16 *pSrcA, - const arm_matrix_instance_f16 *pSrcB, arm_matrix_instance_f16 *pDst); -/** +arm_status arm_mat_mult_f16( + const arm_matrix_instance_f16 * pSrcA, + const arm_matrix_instance_f16 * pSrcB, + arm_matrix_instance_f16 * pDst); + /** * @brief Floating-point matrix and vector multiplication * @param[in] pSrcMat points to the input matrix structure * @param[in] pVec points to vector * @param[out] pDst points to output vector */ -void arm_mat_vec_mult_f16(const arm_matrix_instance_f16 *pSrcMat, const float16_t *pVec, - float16_t *pDst); +void arm_mat_vec_mult_f16( + const arm_matrix_instance_f16 *pSrcMat, + const float16_t *pVec, + float16_t *pDst); -/** + /** * @brief Floating-point matrix subtraction * @param[in] pSrcA points to the first input matrix structure * @param[in] pSrcB points to the second input matrix structure @@ -116,10 +132,12 @@ void arm_mat_vec_mult_f16(const arm_matrix_instance_f16 *pSrcMat, const float16_ * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_sub_f16(const arm_matrix_instance_f16 *pSrcA, - const arm_matrix_instance_f16 *pSrcB, arm_matrix_instance_f16 *pDst); +arm_status arm_mat_sub_f16( + const arm_matrix_instance_f16 * pSrcA, + const arm_matrix_instance_f16 * pSrcB, + arm_matrix_instance_f16 * pDst); -/** + /** * @brief Floating-point matrix scaling. * @param[in] pSrc points to the input matrix * @param[in] scale scale factor @@ -127,29 +145,38 @@ arm_status arm_mat_sub_f16(const arm_matrix_instance_f16 *pSrcA, * @return The function returns either * ARM_MATH_SIZE_MISMATCH or ARM_MATH_SUCCESS based on the outcome of size checking. */ -arm_status arm_mat_scale_f16(const arm_matrix_instance_f16 *pSrc, float16_t scale, - arm_matrix_instance_f16 *pDst); +arm_status arm_mat_scale_f16( + const arm_matrix_instance_f16 * pSrc, + float16_t scale, + arm_matrix_instance_f16 * pDst); -/** + /** * @brief Floating-point matrix initialization. * @param[in,out] S points to an instance of the floating-point matrix structure. * @param[in] nRows number of rows in the matrix. * @param[in] nColumns number of columns in the matrix. * @param[in] pData points to the matrix data array. */ -void arm_mat_init_f16(arm_matrix_instance_f16 *S, uint16_t nRows, uint16_t nColumns, - float16_t *pData); +void arm_mat_init_f16( + arm_matrix_instance_f16 * S, + uint16_t nRows, + uint16_t nColumns, + float16_t * pData); -/** + + /** * @brief Floating-point matrix inverse. * @param[in] src points to the instance of the input floating-point matrix structure. * @param[out] dst points to the instance of the output floating-point matrix structure. * @return The function returns ARM_MATH_SIZE_MISMATCH, if the dimensions do not match. * If the input matrix is singular (does not have an inverse), then the algorithm terminates and returns error status ARM_MATH_SINGULAR. */ -arm_status arm_mat_inverse_f16(const arm_matrix_instance_f16 *src, arm_matrix_instance_f16 *dst); + arm_status arm_mat_inverse_f16( + const arm_matrix_instance_f16 * src, + arm_matrix_instance_f16 * dst); -/** + + /** * @brief Floating-point Cholesky decomposition of Symmetric Positive Definite Matrix. * @param[in] src points to the instance of the input floating-point matrix structure. * @param[out] dst points to the instance of the output floating-point matrix structure. @@ -158,32 +185,76 @@ arm_status arm_mat_inverse_f16(const arm_matrix_instance_f16 *src, arm_matrix_in * If the matrix is ill conditioned or only semi-definite, then it is better using the LDL^t decomposition. * The decomposition is returning a lower triangular matrix. */ -arm_status arm_mat_cholesky_f16(const arm_matrix_instance_f16 *src, arm_matrix_instance_f16 *dst); + arm_status arm_mat_cholesky_f16( + const arm_matrix_instance_f16 * src, + arm_matrix_instance_f16 * dst); -/** + /** * @brief Solve UT . X = A where UT is an upper triangular matrix * @param[in] ut The upper triangular matrix * @param[in] a The matrix a * @param[out] dst The solution X of UT . X = A * @return The function returns ARM_MATH_SINGULAR, if the system can't be solved. */ -arm_status arm_mat_solve_upper_triangular_f16(const arm_matrix_instance_f16 *ut, - const arm_matrix_instance_f16 *a, - arm_matrix_instance_f16 *dst); + arm_status arm_mat_solve_upper_triangular_f16( + const arm_matrix_instance_f16 * ut, + const arm_matrix_instance_f16 * a, + arm_matrix_instance_f16 * dst); -/** + /** * @brief Solve LT . X = A where LT is a lower triangular matrix * @param[in] lt The lower triangular matrix * @param[in] a The matrix a * @param[out] dst The solution X of LT . X = A * @return The function returns ARM_MATH_SINGULAR, if the system can't be solved. */ -arm_status arm_mat_solve_lower_triangular_f16(const arm_matrix_instance_f16 *lt, - const arm_matrix_instance_f16 *a, - arm_matrix_instance_f16 *dst); + arm_status arm_mat_solve_lower_triangular_f16( + const arm_matrix_instance_f16 * lt, + const arm_matrix_instance_f16 * a, + arm_matrix_instance_f16 * dst); + + +/** + @brief QR decomposition of a m x n floating point matrix with m >= n. + @param[in] pSrc points to input matrix structure. The source matrix is modified by the function. + @param[in] threshold norm2 threshold. + @param[out] pOutR points to output R matrix structure of dimension m x n + @param[out] pOutQ points to output Q matrix structure of dimension m x m + @param[out] pOutTau points to Householder scaling factors of dimension n + @param[inout] pTmpA points to a temporary vector of dimension m. + @param[inout] pTmpB points to a temporary vector of dimension n. + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_SIZE_MISMATCH : Matrix size check failed + - \ref ARM_MATH_SINGULAR : Input matrix is found to be singular (non-invertible) + */ +arm_status arm_mat_qr_f16( + const arm_matrix_instance_f16 * pSrc, + const float16_t threshold, + arm_matrix_instance_f16 * pOutR, + arm_matrix_instance_f16 * pOutQ, + float16_t * pOutTau, + float16_t *pTmpA, + float16_t *pTmpB + ); + +/** + @brief Householder transform of a half floating point vector. + @param[in] pSrc points to the input vector. + @param[in] threshold norm2 threshold. + @param[in] blockSize dimension of the vector space. + @param[outQ] pOut points to the output vector. + @return beta return the scaling factor beta + */ +float16_t arm_householder_f16( + const float16_t * pSrc, + const float16_t threshold, + uint32_t blockSize, + float16_t * pOut + ); #endif /*defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_utils.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_utils.h old mode 100644 new mode 100755 index de87ab1417b..79e7f8cf103 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_utils.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_utils.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _MATRIX_UTILS_H_ -#define _MATRIX_UTILS_H_ + +#ifndef MATRIX_UTILS_H_ +#define MATRIX_UTILS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -32,537 +33,607 @@ #include "dsp/none.h" #include "dsp/utils.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif -#define ELEM(A, ROW, COL) &((A)->pData[(A)->numCols * (ROW) + (COL)]) - -#define SCALE_COL_T(T, CAST, A, ROW, v, i) \ - { \ - int32_t w; \ - T *data = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = (A)->numRows - ROW; \ - \ - data += i + numCols * (ROW); \ - \ - for (w = 0; w < nb; w++) { \ - *data *= CAST v; \ - data += numCols; \ - } \ - } +#define ELEM(A,ROW,COL) &((A)->pData[(A)->numCols* (ROW) + (COL)]) + +#define SCALE_COL_T(T,CAST,A,ROW,v,i) \ +{ \ + int32_t _w; \ + T *data = (A)->pData; \ + const int32_t _numCols = (A)->numCols; \ + const int32_t nb = (A)->numRows - ROW;\ + \ + data += i + _numCols * (ROW); \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + *data *= CAST v; \ + data += _numCols; \ + } \ +} + +#define COPY_COL_T(T,A,ROW,COL,DST) \ +{ \ + uint32_t _row; \ + T *_pb=DST; \ + T *_pa = (A)->pData + ROW * (A)->numCols + COL;\ + for(_row = ROW; _row < (A)->numRows; _row ++) \ + { \ + *_pb++ = *_pa; \ + _pa += (A)->numCols; \ + } \ +} #if defined(ARM_FLOAT16_SUPPORTED) #if defined(ARM_MATH_MVE_FLOAT16) && !defined(ARM_MATH_AUTOVECTORIZE) -#define SWAP_ROWS_F16(A, COL, i, j) \ - { \ - int cnt = ((A)->numCols) - (COL); \ - int32_t w; \ - float16_t *data = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - \ - for (w = (COL); w < numCols; w += 8) { \ - f16x8_t tmpa, tmpb; \ - mve_pred16_t p0 = vctp16q(cnt); \ - \ - tmpa = vldrhq_z_f16(&data[i * numCols + w], p0); \ - tmpb = vldrhq_z_f16(&data[j * numCols + w], p0); \ - \ - vstrhq_p(&data[i * numCols + w], tmpb, p0); \ - vstrhq_p(&data[j * numCols + w], tmpa, p0); \ - \ - cnt -= 8; \ - } \ - } - -#define SCALE_ROW_F16(A, COL, v, i) \ - { \ - int cnt = ((A)->numCols) - (COL); \ - int32_t w; \ - float16_t *data = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - \ - for (w = (COL); w < numCols; w += 8) { \ - f16x8_t tmpa; \ - mve_pred16_t p0 = vctp16q(cnt); \ - tmpa = vldrhq_z_f16(&data[i * numCols + w], p0); \ - tmpa = vmulq_n_f16(tmpa, (_Float16)v); \ - vstrhq_p(&data[i * numCols + w], tmpa, p0); \ - cnt -= 8; \ - } \ - } - -#define MAC_ROW_F16(COL, A, i, v, B, j) \ - { \ - int cnt = ((A)->numCols) - (COL); \ - int32_t w; \ - float16_t *dataA = (A)->pData; \ - float16_t *dataB = (B)->pData; \ - const int32_t numCols = (A)->numCols; \ - \ - for (w = (COL); w < numCols; w += 8) { \ - f16x8_t tmpa, tmpb; \ - mve_pred16_t p0 = vctp16q(cnt); \ - tmpa = vldrhq_z_f16(&dataA[i * numCols + w], p0); \ - tmpb = vldrhq_z_f16(&dataB[j * numCols + w], p0); \ - tmpa = vfmaq_n_f16(tmpa, tmpb, v); \ - vstrhq_p(&dataA[i * numCols + w], tmpa, p0); \ - cnt -= 8; \ - } \ - } - -#define MAS_ROW_F16(COL, A, i, v, B, j) \ - { \ - int cnt = ((A)->numCols) - (COL); \ - int32_t w; \ - float16_t *dataA = (A)->pData; \ - float16_t *dataB = (B)->pData; \ - const int32_t numCols = (A)->numCols; \ - f16x8_t vec = vdupq_n_f16(v); \ - \ - for (w = (COL); w < numCols; w += 8) { \ - f16x8_t tmpa, tmpb; \ - mve_pred16_t p0 = vctp16q(cnt); \ - tmpa = vldrhq_z_f16(&dataA[i * numCols + w], p0); \ - tmpb = vldrhq_z_f16(&dataB[j * numCols + w], p0); \ - tmpa = vfmsq_f16(tmpa, tmpb, vec); \ - vstrhq_p(&dataA[i * numCols + w], tmpa, p0); \ - cnt -= 8; \ - } \ - } +#define SWAP_ROWS_F16(A,COL,i,j) \ + { \ + int cnt = ((A)->numCols)-(COL); \ + int32_t _w; \ + float16_t *data = (A)->pData; \ + const int32_t _numCols = (A)->numCols; \ + \ + for(_w=(COL);_w < _numCols; _w+=8) \ + { \ + f16x8_t tmpa,tmpb; \ + mve_pred16_t p0 = vctp16q(cnt); \ + \ + tmpa=vldrhq_z_f16(&data[i*_numCols + _w],p0);\ + tmpb=vldrhq_z_f16(&data[j*_numCols + _w],p0);\ + \ + vstrhq_p(&data[i*_numCols + _w], tmpb, p0); \ + vstrhq_p(&data[j*_numCols + _w], tmpa, p0); \ + \ + cnt -= 8; \ + } \ + } + +#define SCALE_ROW_F16(A,COL,v,i) \ +{ \ + int cnt = ((A)->numCols)-(COL); \ + int32_t _w; \ + float16_t *data = (A)->pData; \ + const int32_t _numCols = (A)->numCols; \ + \ + for(_w=(COL);_w < _numCols; _w+=8) \ + { \ + f16x8_t tmpa; \ + mve_pred16_t p0 = vctp16q(cnt); \ + tmpa = vldrhq_z_f16(&data[i*_numCols + _w],p0);\ + tmpa = vmulq_n_f16(tmpa,(_Float16)v); \ + vstrhq_p(&data[i*_numCols + _w], tmpa, p0); \ + cnt -= 8; \ + } \ + \ +} + +#define MAC_ROW_F16(COL,A,i,v,B,j) \ +{ \ + int cnt = ((A)->numCols)-(COL); \ + int32_t _w; \ + float16_t *dataA = (A)->pData; \ + float16_t *dataB = (B)->pData; \ + const int32_t _numCols = (A)->numCols; \ + \ + for(_w=(COL);_w < _numCols; _w+=8) \ + { \ + f16x8_t tmpa,tmpb; \ + mve_pred16_t p0 = vctp16q(cnt); \ + tmpa = vldrhq_z_f16(&dataA[i*_numCols + _w],p0);\ + tmpb = vldrhq_z_f16(&dataB[j*_numCols + _w],p0);\ + tmpa = vfmaq_n_f16(tmpa,tmpb,v); \ + vstrhq_p(&dataA[i*_numCols + _w], tmpa, p0); \ + cnt -= 8; \ + } \ + \ +} + +#define MAS_ROW_F16(COL,A,i,v,B,j) \ +{ \ + int cnt = ((A)->numCols)-(COL); \ + int32_t _w; \ + float16_t *dataA = (A)->pData; \ + float16_t *dataB = (B)->pData; \ + const int32_t _numCols = (A)->numCols; \ + f16x8_t vec=vdupq_n_f16(v); \ + \ + for(_w=(COL);_w < _numCols; _w+=8) \ + { \ + f16x8_t tmpa,tmpb; \ + mve_pred16_t p0 = vctp16q(cnt); \ + tmpa = vldrhq_z_f16(&dataA[i*_numCols + _w],p0);\ + tmpb = vldrhq_z_f16(&dataB[j*_numCols + _w],p0);\ + tmpa = vfmsq_f16(tmpa,tmpb,vec); \ + vstrhq_p(&dataA[i*_numCols + _w], tmpa, p0); \ + cnt -= 8; \ + } \ + \ +} #else -#define SWAP_ROWS_F16(A, COL, i, j) \ - { \ - int32_t w; \ - float16_t *dataI = (A)->pData; \ - float16_t *dataJ = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - \ - dataI += i * numCols + (COL); \ - dataJ += j * numCols + (COL); \ - \ - for (w = 0; w < nb; w++) { \ - float16_t tmp; \ - tmp = *dataI; \ - *dataI++ = *dataJ; \ - *dataJ++ = tmp; \ - } \ - } - -#define SCALE_ROW_F16(A, COL, v, i) \ - { \ - int32_t w; \ - float16_t *data = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - \ - data += i * numCols + (COL); \ - \ - for (w = 0; w < nb; w++) { \ - *data++ *= (_Float16)v; \ - } \ - } - -#define MAC_ROW_F16(COL, A, i, v, B, j) \ - { \ - int32_t w; \ - float16_t *dataA = (A)->pData; \ - float16_t *dataB = (B)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - \ - dataA += i * numCols + (COL); \ - dataB += j * numCols + (COL); \ - \ - for (w = 0; w < nb; w++) { \ - *dataA++ += (_Float16)v * (_Float16)*dataB++; \ - } \ - } - -#define MAS_ROW_F16(COL, A, i, v, B, j) \ - { \ - int32_t w; \ - float16_t *dataA = (A)->pData; \ - float16_t *dataB = (B)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - \ - dataA += i * numCols + (COL); \ - dataB += j * numCols + (COL); \ - \ - for (w = 0; w < nb; w++) { \ - *dataA++ -= (_Float16)v * (_Float16)*dataB++; \ - } \ - } + +#define SWAP_ROWS_F16(A,COL,i,j) \ +{ \ + int32_t _w; \ + float16_t *dataI = (A)->pData; \ + float16_t *dataJ = (A)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols-(COL); \ + \ + dataI += i*_numCols + (COL); \ + dataJ += j*_numCols + (COL); \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + float16_t tmp; \ + tmp = *dataI; \ + *dataI++ = *dataJ; \ + *dataJ++ = tmp; \ + } \ +} + +#define SCALE_ROW_F16(A,COL,v,i) \ +{ \ + int32_t _w; \ + float16_t *data = (A)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols-(COL); \ + \ + data += i*_numCols + (COL); \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + *data++ *= (_Float16)v; \ + } \ +} + + +#define MAC_ROW_F16(COL,A,i,v,B,j) \ +{ \ + int32_t _w; \ + float16_t *dataA = (A)->pData; \ + float16_t *dataB = (B)->pData; \ + const int32_t _numCols = (A)->numCols; \ + const int32_t nb = _numCols-(COL); \ + \ + dataA += i*_numCols + (COL); \ + dataB += j*_numCols + (COL); \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + *dataA++ += (_Float16)v * (_Float16)*dataB++;\ + } \ +} + +#define MAS_ROW_F16(COL,A,i,v,B,j) \ +{ \ + int32_t _w; \ + float16_t *dataA = (A)->pData; \ + float16_t *dataB = (B)->pData; \ + const int32_t _numCols = (A)->numCols; \ + const int32_t nb = _numCols-(COL); \ + \ + dataA += i*_numCols + (COL); \ + dataB += j*_numCols + (COL); \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + *dataA++ -= (_Float16)v * (_Float16)*dataB++;\ + } \ +} #endif /*defined(ARM_MATH_MVE_FLOAT16) && !defined(ARM_MATH_AUTOVECTORIZE)*/ -#define SCALE_COL_F16(A, ROW, v, i) SCALE_COL_T(float16_t, (_Float16), A, ROW, v, i) +/* Functions with only a scalar version */ +#define COPY_COL_F16(A,ROW,COL,DST) \ + COPY_COL_T(float16_t,A,ROW,COL,DST) +#define SCALE_COL_F16(A,ROW,v,i) \ + SCALE_COL_T(float16_t,(_Float16),A,ROW,v,i) + #endif /* defined(ARM_FLOAT16_SUPPORTED)*/ #if defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE) -#define SWAP_ROWS_F32(A, COL, i, j) \ - { \ - int cnt = ((A)->numCols) - (COL); \ - float32_t *data = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - int32_t w; \ - \ - for (w = (COL); w < numCols; w += 4) { \ - f32x4_t tmpa, tmpb; \ - mve_pred16_t p0 = vctp32q(cnt); \ - \ - tmpa = vldrwq_z_f32(&data[i * numCols + w], p0); \ - tmpb = vldrwq_z_f32(&data[j * numCols + w], p0); \ - \ - vstrwq_p(&data[i * numCols + w], tmpb, p0); \ - vstrwq_p(&data[j * numCols + w], tmpa, p0); \ - \ - cnt -= 4; \ - } \ - } - -#define MAC_ROW_F32(COL, A, i, v, B, j) \ - { \ - int cnt = ((A)->numCols) - (COL); \ - float32_t *dataA = (A)->pData; \ - float32_t *dataB = (B)->pData; \ - const int32_t numCols = (A)->numCols; \ - int32_t w; \ - \ - for (w = (COL); w < numCols; w += 4) { \ - f32x4_t tmpa, tmpb; \ - mve_pred16_t p0 = vctp32q(cnt); \ - tmpa = vldrwq_z_f32(&dataA[i * numCols + w], p0); \ - tmpb = vldrwq_z_f32(&dataB[j * numCols + w], p0); \ - tmpa = vfmaq_n_f32(tmpa, tmpb, v); \ - vstrwq_p(&dataA[i * numCols + w], tmpa, p0); \ - cnt -= 4; \ - } \ - } - -#define MAS_ROW_F32(COL, A, i, v, B, j) \ - { \ - int cnt = ((A)->numCols) - (COL); \ - float32_t *dataA = (A)->pData; \ - float32_t *dataB = (B)->pData; \ - const int32_t numCols = (A)->numCols; \ - int32_t w; \ - f32x4_t vec = vdupq_n_f32(v); \ - \ - for (w = (COL); w < numCols; w += 4) { \ - f32x4_t tmpa, tmpb; \ - mve_pred16_t p0 = vctp32q(cnt); \ - tmpa = vldrwq_z_f32(&dataA[i * numCols + w], p0); \ - tmpb = vldrwq_z_f32(&dataB[j * numCols + w], p0); \ - tmpa = vfmsq_f32(tmpa, tmpb, vec); \ - vstrwq_p(&dataA[i * numCols + w], tmpa, p0); \ - cnt -= 4; \ - } \ - } - -#define SCALE_ROW_F32(A, COL, v, i) \ - { \ - int cnt = ((A)->numCols) - (COL); \ - float32_t *data = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - int32_t w; \ - \ - for (w = (COL); w < numCols; w += 4) { \ - f32x4_t tmpa; \ - mve_pred16_t p0 = vctp32q(cnt); \ - tmpa = vldrwq_z_f32(&data[i * numCols + w], p0); \ - tmpa = vmulq_n_f32(tmpa, v); \ - vstrwq_p(&data[i * numCols + w], tmpa, p0); \ - cnt -= 4; \ - } \ - } +#define SWAP_ROWS_F32(A,COL,i,j) \ + { \ + int cnt = ((A)->numCols)-(COL); \ + float32_t *data = (A)->pData; \ + const int32_t _numCols = (A)->numCols; \ + int32_t _w; \ + \ + for(_w=(COL);_w < _numCols; _w+=4) \ + { \ + f32x4_t tmpa,tmpb; \ + mve_pred16_t p0 = vctp32q(cnt); \ + \ + tmpa=vldrwq_z_f32(&data[i*_numCols + _w],p0);\ + tmpb=vldrwq_z_f32(&data[j*_numCols + _w],p0);\ + \ + vstrwq_p(&data[i*_numCols + _w], tmpb, p0); \ + vstrwq_p(&data[j*_numCols + _w], tmpa, p0); \ + \ + cnt -= 4; \ + } \ + } + +#define MAC_ROW_F32(COL,A,i,v,B,j) \ +{ \ + int cnt = ((A)->numCols)-(COL); \ + float32_t *dataA = (A)->pData; \ + float32_t *dataB = (B)->pData; \ + const int32_t _numCols = (A)->numCols; \ + int32_t _w; \ + \ + for(_w=(COL);_w < _numCols; _w+=4) \ + { \ + f32x4_t tmpa,tmpb; \ + mve_pred16_t p0 = vctp32q(cnt); \ + tmpa = vldrwq_z_f32(&dataA[i*_numCols + _w],p0);\ + tmpb = vldrwq_z_f32(&dataB[j*_numCols + _w],p0);\ + tmpa = vfmaq_n_f32(tmpa,tmpb,v); \ + vstrwq_p(&dataA[i*_numCols + _w], tmpa, p0); \ + cnt -= 4; \ + } \ + \ +} + +#define MAS_ROW_F32(COL,A,i,v,B,j) \ +{ \ + int cnt = ((A)->numCols)-(COL); \ + float32_t *dataA = (A)->pData; \ + float32_t *dataB = (B)->pData; \ + const int32_t _numCols = (A)->numCols; \ + int32_t _w; \ + f32x4_t vec=vdupq_n_f32(v); \ + \ + for(_w=(COL);_w < _numCols; _w+=4) \ + { \ + f32x4_t tmpa,tmpb; \ + mve_pred16_t p0 = vctp32q(cnt); \ + tmpa = vldrwq_z_f32(&dataA[i*_numCols + _w],p0);\ + tmpb = vldrwq_z_f32(&dataB[j*_numCols + _w],p0);\ + tmpa = vfmsq_f32(tmpa,tmpb,vec); \ + vstrwq_p(&dataA[i*_numCols + _w], tmpa, p0); \ + cnt -= 4; \ + } \ + \ +} + +#define SCALE_ROW_F32(A,COL,v,i) \ +{ \ + int cnt = ((A)->numCols)-(COL); \ + float32_t *data = (A)->pData; \ + const int32_t _numCols = (A)->numCols; \ + int32_t _w; \ + \ + for(_w=(COL);_w < _numCols; _w+=4) \ + { \ + f32x4_t tmpa; \ + mve_pred16_t p0 = vctp32q(cnt); \ + tmpa = vldrwq_z_f32(&data[i*_numCols + _w],p0);\ + tmpa = vmulq_n_f32(tmpa,v); \ + vstrwq_p(&data[i*_numCols + _w], tmpa, p0); \ + cnt -= 4; \ + } \ + \ +} #elif defined(ARM_MATH_NEON) && !defined(ARM_MATH_AUTOVECTORIZE) -#define SWAP_ROWS_F32(A, COL, i, j) \ - { \ - int32_t w; \ - float32_t *dataI = (A)->pData; \ - float32_t *dataJ = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - COL; \ - \ - dataI += i * numCols + (COL); \ - dataJ += j * numCols + (COL); \ - \ - float32_t tmp; \ - \ - for (w = 0; w < nb; w++) { \ - tmp = *dataI; \ - *dataI++ = *dataJ; \ - *dataJ++ = tmp; \ - } \ - } - -#define MAC_ROW_F32(COL, A, i, v, B, j) \ - { \ - float32_t *dataA = (A)->pData; \ - float32_t *dataB = (B)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - int32_t nbElems; \ - f32x4_t vec = vdupq_n_f32(v); \ - \ - nbElems = nb >> 2; \ - \ - dataA += i * numCols + (COL); \ - dataB += j * numCols + (COL); \ - \ - while (nbElems > 0) { \ - f32x4_t tmpa, tmpb; \ - tmpa = vld1q_f32(dataA, p0); \ - tmpb = vld1q_f32(dataB, p0); \ - tmpa = vmlaq_f32(tmpa, tmpb, vec); \ - vst1q_f32(dataA, tmpa, p0); \ - nbElems--; \ - dataA += 4; \ - dataB += 4; \ - } \ - \ - nbElems = nb & 3; \ - while (nbElems > 0) { \ - *dataA++ += v * *dataB++; \ - nbElems--; \ - } \ - } - -#define MAS_ROW_F32(COL, A, i, v, B, j) \ - { \ - float32_t *dataA = (A)->pData; \ - float32_t *dataB = (B)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - int32_t nbElems; \ - f32x4_t vec = vdupq_n_f32(v); \ - \ - nbElems = nb >> 2; \ - \ - dataA += i * numCols + (COL); \ - dataB += j * numCols + (COL); \ - \ - while (nbElems > 0) { \ - f32x4_t tmpa, tmpb; \ - tmpa = vld1q_f32(dataA); \ - tmpb = vld1q_f32(dataB); \ - tmpa = vmlsq_f32(tmpa, tmpb, vec); \ - vst1q_f32(dataA, tmpa); \ - nbElems--; \ - dataA += 4; \ - dataB += 4; \ - } \ - \ - nbElems = nb & 3; \ - while (nbElems > 0) { \ - *dataA++ -= v * *dataB++; \ - nbElems--; \ - } \ - } - -#define SCALE_ROW_F32(A, COL, v, i) \ - { \ - float32_t *data = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - int32_t nbElems; \ - f32x4_t vec = vdupq_n_f32(v); \ - \ - nbElems = nb >> 2; \ - \ - data += i * numCols + (COL); \ - while (nbElems > 0) { \ - f32x4_t tmpa; \ - tmpa = vld1q_f32(data); \ - tmpa = vmulq_f32(tmpa, vec); \ - vst1q_f32(data, tmpa); \ - data += 4; \ - nbElems--; \ - } \ - \ - nbElems = nb & 3; \ - while (nbElems > 0) { \ - *data++ *= v; \ - nbElems--; \ - } \ - } +#define SWAP_ROWS_F32(A,COL,i,j) \ +{ \ + int32_t _w; \ + float32_t *dataI = (A)->pData; \ + float32_t *dataJ = (A)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols - COL; \ + \ + dataI += i*_numCols + (COL); \ + dataJ += j*_numCols + (COL); \ + \ + float32_t tmp; \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + tmp = *dataI; \ + *dataI++ = *dataJ; \ + *dataJ++ = tmp; \ + } \ +} + +#define MAC_ROW_F32(COL,A,i,v,B,j) \ +{ \ + float32_t *dataA = (A)->pData; \ + float32_t *dataB = (B)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols - (COL); \ + int32_t nbElems; \ + f32x4_t vec = vdupq_n_f32(v); \ + \ + nbElems = nb >> 2; \ + \ + dataA += i*_numCols + (COL); \ + dataB += j*_numCols + (COL); \ + \ + while(nbElems>0) \ + { \ + f32x4_t tmpa,tmpb; \ + tmpa = vld1q_f32(dataA,p0); \ + tmpb = vld1q_f32(dataB,p0); \ + tmpa = vmlaq_f32(tmpa,tmpb,vec);\ + vst1q_f32(dataA, tmpa, p0); \ + nbElems--; \ + dataA += 4; \ + dataB += 4; \ + } \ + \ + nbElems = nb & 3; \ + while(nbElems > 0) \ + { \ + *dataA++ += v* *dataB++; \ + nbElems--; \ + } \ +} + +#define MAS_ROW_F32(COL,A,i,v,B,j) \ +{ \ + float32_t *dataA = (A)->pData; \ + float32_t *dataB = (B)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols - (COL); \ + int32_t nbElems; \ + f32x4_t vec = vdupq_n_f32(v); \ + \ + nbElems = nb >> 2; \ + \ + dataA += i*_numCols + (COL); \ + dataB += j*_numCols + (COL); \ + \ + while(nbElems>0) \ + { \ + f32x4_t tmpa,tmpb; \ + tmpa = vld1q_f32(dataA); \ + tmpb = vld1q_f32(dataB); \ + tmpa = vmlsq_f32(tmpa,tmpb,vec);\ + vst1q_f32(dataA, tmpa); \ + nbElems--; \ + dataA += 4; \ + dataB += 4; \ + } \ + \ + nbElems = nb & 3; \ + while(nbElems > 0) \ + { \ + *dataA++ -= v* *dataB++; \ + nbElems--; \ + } \ +} + +#define SCALE_ROW_F32(A,COL,v,i) \ +{ \ + float32_t *data = (A)->pData; \ + const int32_t _numCols = (A)->numCols; \ + const int32_t nb = _numCols - (COL); \ + int32_t nbElems; \ + f32x4_t vec = vdupq_n_f32(v); \ + \ + nbElems = nb >> 2; \ + \ + data += i*_numCols + (COL); \ + while(nbElems>0) \ + { \ + f32x4_t tmpa; \ + tmpa = vld1q_f32(data); \ + tmpa = vmulq_f32(tmpa,vec); \ + vst1q_f32(data, tmpa); \ + data += 4; \ + nbElems --; \ + } \ + \ + nbElems = nb & 3; \ + while(nbElems > 0) \ + { \ + *data++ *= v; \ + nbElems--; \ + } \ + \ +} #else -#define SWAP_ROWS_F32(A, COL, i, j) \ - { \ - int32_t w; \ - float32_t tmp; \ - float32_t *dataI = (A)->pData; \ - float32_t *dataJ = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - COL; \ - \ - dataI += i * numCols + (COL); \ - dataJ += j * numCols + (COL); \ - \ - for (w = 0; w < nb; w++) { \ - tmp = *dataI; \ - *dataI++ = *dataJ; \ - *dataJ++ = tmp; \ - } \ - } - -#define SCALE_ROW_F32(A, COL, v, i) \ - { \ - int32_t w; \ - float32_t *data = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - COL; \ - \ - data += i * numCols + (COL); \ - \ - for (w = 0; w < nb; w++) { \ - *data++ *= v; \ - } \ - } - -#define MAC_ROW_F32(COL, A, i, v, B, j) \ - { \ - int32_t w; \ - float32_t *dataA = (A)->pData; \ - float32_t *dataB = (B)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - \ - dataA = dataA + i * numCols + (COL); \ - dataB = dataB + j * numCols + (COL); \ - \ - for (w = 0; w < nb; w++) { \ - *dataA++ += v * *dataB++; \ - } \ - } - -#define MAS_ROW_F32(COL, A, i, v, B, j) \ - { \ - int32_t w; \ - float32_t *dataA = (A)->pData; \ - float32_t *dataB = (B)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - \ - dataA = dataA + i * numCols + (COL); \ - dataB = dataB + j * numCols + (COL); \ - \ - for (w = 0; w < nb; w++) { \ - *dataA++ -= v * *dataB++; \ - } \ - } +#define SWAP_ROWS_F32(A,COL,i,j) \ +{ \ + int32_t _w; \ + float32_t tmp; \ + float32_t *dataI = (A)->pData; \ + float32_t *dataJ = (A)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols - COL; \ + \ + dataI += i*_numCols + (COL); \ + dataJ += j*_numCols + (COL); \ + \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + tmp = *dataI; \ + *dataI++ = *dataJ; \ + *dataJ++ = tmp; \ + } \ +} + +#define SCALE_ROW_F32(A,COL,v,i) \ +{ \ + int32_t _w; \ + float32_t *data = (A)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols - COL; \ + \ + data += i*_numCols + (COL); \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + *data++ *= v; \ + } \ +} + + +#define MAC_ROW_F32(COL,A,i,v,B,j) \ +{ \ + int32_t _w; \ + float32_t *dataA = (A)->pData; \ + float32_t *dataB = (B)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols-(COL); \ + \ + dataA = dataA + i*_numCols + (COL); \ + dataB = dataB + j*_numCols + (COL); \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + *dataA++ += v* *dataB++; \ + } \ +} + +#define MAS_ROW_F32(COL,A,i,v,B,j) \ +{ \ + int32_t _w; \ + float32_t *dataA = (A)->pData; \ + float32_t *dataB = (B)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols-(COL); \ + \ + dataA = dataA + i*_numCols + (COL); \ + dataB = dataB + j*_numCols + (COL); \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + *dataA++ -= v* *dataB++; \ + } \ +} #endif /* defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE) */ -#define SWAP_COLS_F32(A, COL, i, j) \ - { \ - int32_t w; \ - float32_t *data = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - for (w = (COL); w < numCols; w++) { \ - float32_t tmp; \ - tmp = data[w * numCols + i]; \ - data[w * numCols + i] = data[w * numCols + j]; \ - data[w * numCols + j] = tmp; \ - } \ - } - -#define SCALE_COL_F32(A, ROW, v, i) SCALE_COL_T(float32_t, , A, ROW, v, i) - -#define SWAP_ROWS_F64(A, COL, i, j) \ - { \ - int32_t w; \ - float64_t *dataI = (A)->pData; \ - float64_t *dataJ = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - \ - dataI += i * numCols + (COL); \ - dataJ += j * numCols + (COL); \ - \ - for (w = 0; w < nb; w++) { \ - float64_t tmp; \ - tmp = *dataI; \ - *dataI++ = *dataJ; \ - *dataJ++ = tmp; \ - } \ - } - -#define SWAP_COLS_F64(A, COL, i, j) \ - { \ - int32_t w; \ - float64_t *data = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - for (w = (COL); w < numCols; w++) { \ - float64_t tmp; \ - tmp = data[w * numCols + i]; \ - data[w * numCols + i] = data[w * numCols + j]; \ - data[w * numCols + j] = tmp; \ - } \ - } - -#define SCALE_ROW_F64(A, COL, v, i) \ - { \ - int32_t w; \ - float64_t *data = (A)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - \ - data += i * numCols + (COL); \ - \ - for (w = 0; w < nb; w++) { \ - *data++ *= v; \ - } \ - } - -#define SCALE_COL_F64(A, ROW, v, i) SCALE_COL_T(float64_t, , A, ROW, v, i) - -#define MAC_ROW_F64(COL, A, i, v, B, j) \ - { \ - int32_t w; \ - float64_t *dataA = (A)->pData; \ - float64_t *dataB = (B)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - \ - dataA += i * numCols + (COL); \ - dataB += j * numCols + (COL); \ - \ - for (w = 0; w < nb; w++) { \ - *dataA++ += v * *dataB++; \ - } \ - } - -#define MAS_ROW_F64(COL, A, i, v, B, j) \ - { \ - int32_t w; \ - float64_t *dataA = (A)->pData; \ - float64_t *dataB = (B)->pData; \ - const int32_t numCols = (A)->numCols; \ - const int32_t nb = numCols - (COL); \ - \ - dataA += i * numCols + (COL); \ - dataB += j * numCols + (COL); \ - \ - for (w = 0; w < nb; w++) { \ - *dataA++ -= v * *dataB++; \ - } \ - } - -#ifdef __cplusplus + +/* Functions _with only a scalar version */ + +#define COPY_COL_F32(A,ROW,COL,DST) \ + COPY_COL_T(float32_t,A,ROW,COL,DST) + +#define COPY_COL_F64(A,ROW,COL,DST) \ + COPY_COL_T(float64_t,A,ROW,COL,DST) + +#define SWAP_COLS_F32(A,COL,i,j) \ +{ \ + int32_t _w; \ + float32_t *data = (A)->pData; \ + const int32_t _numCols = (A)->numCols; \ + for(_w=(COL);_w < _numCols; _w++) \ + { \ + float32_t tmp; \ + tmp = data[_w*_numCols + i]; \ + data[_w*_numCols + i] = data[_w*_numCols + j];\ + data[_w*_numCols + j] = tmp; \ + } \ +} + +#define SCALE_COL_F32(A,ROW,v,i) \ + SCALE_COL_T(float32_t,,A,ROW,v,i) + +#define SWAP_ROWS_F64(A,COL,i,j) \ +{ \ + int32_t _w; \ + float64_t *dataI = (A)->pData; \ + float64_t *dataJ = (A)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols-(COL); \ + \ + dataI += i*_numCols + (COL); \ + dataJ += j*_numCols + (COL); \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + float64_t tmp; \ + tmp = *dataI; \ + *dataI++ = *dataJ; \ + *dataJ++ = tmp; \ + } \ +} + +#define SWAP_COLS_F64(A,COL,i,j) \ +{ \ + int32_t _w; \ + float64_t *data = (A)->pData; \ + const int32_t _numCols = (A)->numCols; \ + for(_w=(COL);_w < _numCols; _w++) \ + { \ + float64_t tmp; \ + tmp = data[_w*_numCols + i]; \ + data[_w*_numCols + i] = data[_w*_numCols + j];\ + data[_w*_numCols + j] = tmp; \ + } \ +} + +#define SCALE_ROW_F64(A,COL,v,i) \ +{ \ + int32_t _w; \ + float64_t *data = (A)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols-(COL); \ + \ + data += i*_numCols + (COL); \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + *data++ *= v; \ + } \ +} + +#define SCALE_COL_F64(A,ROW,v,i) \ + SCALE_COL_T(float64_t,,A,ROW,v,i) + +#define MAC_ROW_F64(COL,A,i,v,B,j) \ +{ \ + int32_t _w; \ + float64_t *dataA = (A)->pData; \ + float64_t *dataB = (B)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols-(COL); \ + \ + dataA += i*_numCols + (COL); \ + dataB += j*_numCols + (COL); \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + *dataA++ += v* *dataB++; \ + } \ +} + +#define MAS_ROW_F64(COL,A,i,v,B,j) \ +{ \ + int32_t _w; \ + float64_t *dataA = (A)->pData; \ + float64_t *dataB = (B)->pData; \ + const int32_t _numCols = (A)->numCols;\ + const int32_t nb = _numCols-(COL); \ + \ + dataA += i*_numCols + (COL); \ + dataB += j*_numCols + (COL); \ + \ + for(_w=0;_w < nb; _w++) \ + { \ + *dataA++ -= v* *dataB++; \ + } \ +} + +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/none.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/none.h old mode 100644 new mode 100755 index 45042dafc9a..7551ee95ed8 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/none.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/none.h @@ -33,16 +33,19 @@ But those are not always available or use a restricted set of intrinsics. */ - -#ifndef _NONE_H_ -#define _NONE_H_ + +#ifndef NONE_H_ +#define NONE_H_ #include "arm_math_types.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif + + /* Normally those kind of definitions are in a compiler file @@ -56,51 +59,58 @@ MSVC is not going to be used to cross-compile to ARM. So, having a MSVC compiler file in Core or Core_A would not make sense. */ -#if defined(_MSC_VER) || defined(__GNUC_PYTHON__) || defined(__APPLE_CC__) -__STATIC_FORCEINLINE uint8_t __CLZ(uint32_t data) -{ - if (data == 0U) { - return 32U; - } +#if defined ( _MSC_VER ) || defined(__GNUC_PYTHON__) || defined(__APPLE_CC__) + __STATIC_FORCEINLINE uint8_t __CLZ(uint32_t data) + { + if (data == 0U) { return 32U; } - uint32_t count = 0U; - uint32_t mask = 0x80000000U; + uint32_t count = 0U; + uint32_t mask = 0x80000000U; - while ((data & mask) == 0U) { + while ((data & mask) == 0U) + { count += 1U; mask = mask >> 1U; + } + return count; } - return count; -} -__STATIC_FORCEINLINE int32_t __SSAT(int32_t val, uint32_t sat) -{ - if ((sat >= 1U) && (sat <= 32U)) { - const int32_t max = (int32_t)((1U << (sat - 1U)) - 1U); - const int32_t min = -1 - max; - if (val > max) { - return max; - } else if (val < min) { - return min; - } + __STATIC_FORCEINLINE int32_t __SSAT(int32_t val, uint32_t sat) + { + if ((sat >= 1U) && (sat <= 32U)) + { + const int32_t max = (int32_t)((1U << (sat - 1U)) - 1U); + const int32_t min = -1 - max ; + if (val > max) + { + return max; + } + else if (val < min) + { + return min; + } } return val; -} - -__STATIC_FORCEINLINE uint32_t __USAT(int32_t val, uint32_t sat) -{ - if (sat <= 31U) { - const uint32_t max = ((1U << sat) - 1U); - if (val > (int32_t)max) { - return max; - } else if (val < 0) { - return 0U; - } + } + + __STATIC_FORCEINLINE uint32_t __USAT(int32_t val, uint32_t sat) + { + if (sat <= 31U) + { + const uint32_t max = ((1U << sat) - 1U); + if (val > (int32_t)max) + { + return max; + } + else if (val < 0) + { + return 0U; + } } return (uint32_t)val; -} + } -/** + /** \brief Rotate Right in unsigned value (32 bit) \details Rotate Right (immediate) provides the value of the contents of a register rotated by a variable number of bits. \param [in] op1 Value to rotate @@ -109,362 +119,457 @@ __STATIC_FORCEINLINE uint32_t __USAT(int32_t val, uint32_t sat) */ __STATIC_FORCEINLINE uint32_t __ROR(uint32_t op1, uint32_t op2) { - op2 %= 32U; - if (op2 == 0U) { - return op1; - } - return (op1 >> op2) | (op1 << (32U - op2)); + op2 %= 32U; + if (op2 == 0U) + { + return op1; + } + return (op1 >> op2) | (op1 << (32U - op2)); } + #endif /** * @brief Clips Q63 to Q31 values. */ -__STATIC_FORCEINLINE q31_t clip_q63_to_q31(q63_t x) -{ - return ((q31_t)(x >> 32) != ((q31_t)x >> 31)) ? ((0x7FFFFFFF ^ ((q31_t)(x >> 63)))) : (q31_t)x; -} - -/** + __STATIC_FORCEINLINE q31_t clip_q63_to_q31( + q63_t x) + { + return ((q31_t) (x >> 32) != ((q31_t) x >> 31)) ? + ((0x7FFFFFFF ^ ((q31_t) (x >> 63)))) : (q31_t) x; + } + + /** * @brief Clips Q63 to Q15 values. */ -__STATIC_FORCEINLINE q15_t clip_q63_to_q15(q63_t x) -{ - return ((q31_t)(x >> 32) != ((q31_t)x >> 31)) ? ((0x7FFF ^ ((q15_t)(x >> 63)))) : - (q15_t)(x >> 15); -} - -/** + __STATIC_FORCEINLINE q15_t clip_q63_to_q15( + q63_t x) + { + return ((q31_t) (x >> 32) != ((q31_t) x >> 31)) ? + ((0x7FFF ^ ((q15_t) (x >> 63)))) : (q15_t) (x >> 15); + } + + /** * @brief Clips Q31 to Q7 values. */ -__STATIC_FORCEINLINE q7_t clip_q31_to_q7(q31_t x) -{ - return ((q31_t)(x >> 24) != ((q31_t)x >> 23)) ? ((0x7F ^ ((q7_t)(x >> 31)))) : (q7_t)x; -} - -/** + __STATIC_FORCEINLINE q7_t clip_q31_to_q7( + q31_t x) + { + return ((q31_t) (x >> 24) != ((q31_t) x >> 23)) ? + ((0x7F ^ ((q7_t) (x >> 31)))) : (q7_t) x; + } + + /** * @brief Clips Q31 to Q15 values. */ -__STATIC_FORCEINLINE q15_t clip_q31_to_q15(q31_t x) -{ - return ((q31_t)(x >> 16) != ((q31_t)x >> 15)) ? ((0x7FFF ^ ((q15_t)(x >> 31)))) : (q15_t)x; -} - -/** + __STATIC_FORCEINLINE q15_t clip_q31_to_q15( + q31_t x) + { + return ((q31_t) (x >> 16) != ((q31_t) x >> 15)) ? + ((0x7FFF ^ ((q15_t) (x >> 31)))) : (q15_t) x; + } + + /** * @brief Multiplies 32 X 64 and returns 32 bit result in 2.30 format. */ -__STATIC_FORCEINLINE q63_t mult32x64(q63_t x, q31_t y) -{ - return ((((q63_t)(x & 0x00000000FFFFFFFF) * y) >> 32) + (((q63_t)(x >> 32) * y))); -} + __STATIC_FORCEINLINE q63_t mult32x64( + q63_t x, + q31_t y) + { + return ((((q63_t) (x & 0x00000000FFFFFFFF) * y) >> 32) + + (((q63_t) (x >> 32) * y) ) ); + } /* SMMLAR */ #define multAcc_32x32_keep32_R(a, x, y) \ - a = (q31_t)(((((q63_t)a) << 32) + ((q63_t)x * y) + 0x80000000LL) >> 32) + a = (q31_t) (((((q63_t) a) << 32) + ((q63_t) x * y) + 0x80000000LL ) >> 32) /* SMMLSR */ #define multSub_32x32_keep32_R(a, x, y) \ - a = (q31_t)(((((q63_t)a) << 32) - ((q63_t)x * y) + 0x80000000LL) >> 32) + a = (q31_t) (((((q63_t) a) << 32) - ((q63_t) x * y) + 0x80000000LL ) >> 32) /* SMMULR */ -#define mult_32x32_keep32_R(a, x, y) a = (q31_t)(((q63_t)x * y + 0x80000000LL) >> 32) +#define mult_32x32_keep32_R(a, x, y) \ + a = (q31_t) (((q63_t) x * y + 0x80000000LL ) >> 32) /* SMMLA */ -#define multAcc_32x32_keep32(a, x, y) a += (q31_t)(((q63_t)x * y) >> 32) +#define multAcc_32x32_keep32(a, x, y) \ + a += (q31_t) (((q63_t) x * y) >> 32) /* SMMLS */ -#define multSub_32x32_keep32(a, x, y) a -= (q31_t)(((q63_t)x * y) >> 32) +#define multSub_32x32_keep32(a, x, y) \ + a -= (q31_t) (((q63_t) x * y) >> 32) /* SMMUL */ -#define mult_32x32_keep32(a, x, y) a = (q31_t)(((q63_t)x * y) >> 32) +#define mult_32x32_keep32(a, x, y) \ + a = (q31_t) (((q63_t) x * y ) >> 32) #ifndef ARM_MATH_DSP -/** + /** * @brief definition to pack two 16 bit values. */ -#define __PKHBT(ARG1, ARG2, ARG3) \ - ((((int32_t)(ARG1) << 0) & (int32_t)0x0000FFFF) | \ - (((int32_t)(ARG2) << ARG3) & (int32_t)0xFFFF0000)) -#define __PKHTB(ARG1, ARG2, ARG3) \ - ((((int32_t)(ARG1) << 0) & (int32_t)0xFFFF0000) | \ - (((int32_t)(ARG2) >> ARG3) & (int32_t)0x0000FFFF)) + #define __PKHBT(ARG1, ARG2, ARG3) ( (((int32_t)(ARG1) << 0) & (int32_t)0x0000FFFF) | \ + (((int32_t)(ARG2) << ARG3) & (int32_t)0xFFFF0000) ) + #define __PKHTB(ARG1, ARG2, ARG3) ( (((int32_t)(ARG1) << 0) & (int32_t)0xFFFF0000) | \ + (((int32_t)(ARG2) >> ARG3) & (int32_t)0x0000FFFF) ) #endif -/** + /** * @brief definition to pack four 8 bit values. */ #ifndef ARM_MATH_BIG_ENDIAN -#define __PACKq7(v0, v1, v2, v3) \ - ((((int32_t)(v0) << 0) & (int32_t)0x000000FF) | (((int32_t)(v1) << 8) & (int32_t)0x0000FF00) | \ - (((int32_t)(v2) << 16) & (int32_t)0x00FF0000) | \ - (((int32_t)(v3) << 24) & (int32_t)0xFF000000)) + #define __PACKq7(v0,v1,v2,v3) ( (((int32_t)(v0) << 0) & (int32_t)0x000000FF) | \ + (((int32_t)(v1) << 8) & (int32_t)0x0000FF00) | \ + (((int32_t)(v2) << 16) & (int32_t)0x00FF0000) | \ + (((int32_t)(v3) << 24) & (int32_t)0xFF000000) ) #else -#define __PACKq7(v0, v1, v2, v3) \ - ((((int32_t)(v3) << 0) & (int32_t)0x000000FF) | (((int32_t)(v2) << 8) & (int32_t)0x0000FF00) | \ - (((int32_t)(v1) << 16) & (int32_t)0x00FF0000) | \ - (((int32_t)(v0) << 24) & (int32_t)0xFF000000)) + #define __PACKq7(v0,v1,v2,v3) ( (((int32_t)(v3) << 0) & (int32_t)0x000000FF) | \ + (((int32_t)(v2) << 8) & (int32_t)0x0000FF00) | \ + (((int32_t)(v1) << 16) & (int32_t)0x00FF0000) | \ + (((int32_t)(v0) << 24) & (int32_t)0xFF000000) ) #endif + + + /* * @brief C custom defined intrinsic functions */ -#if !defined(ARM_MATH_DSP) +#if !defined (ARM_MATH_DSP) -/* + + /* * @brief C custom defined QADD8 */ -__STATIC_FORCEINLINE uint32_t __QADD8(uint32_t x, uint32_t y) -{ + __STATIC_FORCEINLINE uint32_t __QADD8( + uint32_t x, + uint32_t y) + { q31_t r, s, t, u; r = __SSAT(((((q31_t)x << 24) >> 24) + (((q31_t)y << 24) >> 24)), 8) & (int32_t)0x000000FF; s = __SSAT(((((q31_t)x << 16) >> 24) + (((q31_t)y << 16) >> 24)), 8) & (int32_t)0x000000FF; - t = __SSAT(((((q31_t)x << 8) >> 24) + (((q31_t)y << 8) >> 24)), 8) & (int32_t)0x000000FF; - u = __SSAT(((((q31_t)x) >> 24) + (((q31_t)y) >> 24)), 8) & (int32_t)0x000000FF; + t = __SSAT(((((q31_t)x << 8) >> 24) + (((q31_t)y << 8) >> 24)), 8) & (int32_t)0x000000FF; + u = __SSAT(((((q31_t)x ) >> 24) + (((q31_t)y ) >> 24)), 8) & (int32_t)0x000000FF; - return ((uint32_t)((u << 24) | (t << 16) | (s << 8) | (r))); -} + return ((uint32_t)((u << 24) | (t << 16) | (s << 8) | (r ))); + } -/* + + /* * @brief C custom defined QSUB8 */ -__STATIC_FORCEINLINE uint32_t __QSUB8(uint32_t x, uint32_t y) -{ + __STATIC_FORCEINLINE uint32_t __QSUB8( + uint32_t x, + uint32_t y) + { q31_t r, s, t, u; r = __SSAT(((((q31_t)x << 24) >> 24) - (((q31_t)y << 24) >> 24)), 8) & (int32_t)0x000000FF; s = __SSAT(((((q31_t)x << 16) >> 24) - (((q31_t)y << 16) >> 24)), 8) & (int32_t)0x000000FF; - t = __SSAT(((((q31_t)x << 8) >> 24) - (((q31_t)y << 8) >> 24)), 8) & (int32_t)0x000000FF; - u = __SSAT(((((q31_t)x) >> 24) - (((q31_t)y) >> 24)), 8) & (int32_t)0x000000FF; + t = __SSAT(((((q31_t)x << 8) >> 24) - (((q31_t)y << 8) >> 24)), 8) & (int32_t)0x000000FF; + u = __SSAT(((((q31_t)x ) >> 24) - (((q31_t)y ) >> 24)), 8) & (int32_t)0x000000FF; - return ((uint32_t)((u << 24) | (t << 16) | (s << 8) | (r))); -} + return ((uint32_t)((u << 24) | (t << 16) | (s << 8) | (r ))); + } -/* + + /* * @brief C custom defined QADD16 */ -__STATIC_FORCEINLINE uint32_t __QADD16(uint32_t x, uint32_t y) -{ - /* q31_t r, s; without initialisation 'arm_offset_q15 test' fails but 'intrinsic' tests pass! for armCC */ + __STATIC_FORCEINLINE uint32_t __QADD16( + uint32_t x, + uint32_t y) + { +/* q31_t r, s; without initialisation 'arm_offset_q15 test' fails but 'intrinsic' tests pass! for armCC */ q31_t r = 0, s = 0; r = __SSAT(((((q31_t)x << 16) >> 16) + (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; - s = __SSAT(((((q31_t)x) >> 16) + (((q31_t)y) >> 16)), 16) & (int32_t)0x0000FFFF; + s = __SSAT(((((q31_t)x ) >> 16) + (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF; - return ((uint32_t)((s << 16) | (r))); -} + return ((uint32_t)((s << 16) | (r ))); + } -/* + + /* * @brief C custom defined SHADD16 */ -__STATIC_FORCEINLINE uint32_t __SHADD16(uint32_t x, uint32_t y) -{ + __STATIC_FORCEINLINE uint32_t __SHADD16( + uint32_t x, + uint32_t y) + { q31_t r, s; r = (((((q31_t)x << 16) >> 16) + (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; - s = (((((q31_t)x) >> 16) + (((q31_t)y) >> 16)) >> 1) & (int32_t)0x0000FFFF; + s = (((((q31_t)x ) >> 16) + (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF; - return ((uint32_t)((s << 16) | (r))); -} + return ((uint32_t)((s << 16) | (r ))); + } -/* + + /* * @brief C custom defined QSUB16 */ -__STATIC_FORCEINLINE uint32_t __QSUB16(uint32_t x, uint32_t y) -{ + __STATIC_FORCEINLINE uint32_t __QSUB16( + uint32_t x, + uint32_t y) + { q31_t r, s; r = __SSAT(((((q31_t)x << 16) >> 16) - (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; - s = __SSAT(((((q31_t)x) >> 16) - (((q31_t)y) >> 16)), 16) & (int32_t)0x0000FFFF; + s = __SSAT(((((q31_t)x ) >> 16) - (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF; - return ((uint32_t)((s << 16) | (r))); -} + return ((uint32_t)((s << 16) | (r ))); + } -/* + + /* * @brief C custom defined SHSUB16 */ -__STATIC_FORCEINLINE uint32_t __SHSUB16(uint32_t x, uint32_t y) -{ + __STATIC_FORCEINLINE uint32_t __SHSUB16( + uint32_t x, + uint32_t y) + { q31_t r, s; r = (((((q31_t)x << 16) >> 16) - (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; - s = (((((q31_t)x) >> 16) - (((q31_t)y) >> 16)) >> 1) & (int32_t)0x0000FFFF; + s = (((((q31_t)x ) >> 16) - (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF; - return ((uint32_t)((s << 16) | (r))); -} + return ((uint32_t)((s << 16) | (r ))); + } -/* + + /* * @brief C custom defined QASX */ -__STATIC_FORCEINLINE uint32_t __QASX(uint32_t x, uint32_t y) -{ + __STATIC_FORCEINLINE uint32_t __QASX( + uint32_t x, + uint32_t y) + { q31_t r, s; - r = __SSAT(((((q31_t)x << 16) >> 16) - (((q31_t)y) >> 16)), 16) & (int32_t)0x0000FFFF; - s = __SSAT(((((q31_t)x) >> 16) + (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; + r = __SSAT(((((q31_t)x << 16) >> 16) - (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF; + s = __SSAT(((((q31_t)x ) >> 16) + (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; - return ((uint32_t)((s << 16) | (r))); -} + return ((uint32_t)((s << 16) | (r ))); + } -/* + + /* * @brief C custom defined SHASX */ -__STATIC_FORCEINLINE uint32_t __SHASX(uint32_t x, uint32_t y) -{ + __STATIC_FORCEINLINE uint32_t __SHASX( + uint32_t x, + uint32_t y) + { q31_t r, s; - r = (((((q31_t)x << 16) >> 16) - (((q31_t)y) >> 16)) >> 1) & (int32_t)0x0000FFFF; - s = (((((q31_t)x) >> 16) + (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; + r = (((((q31_t)x << 16) >> 16) - (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF; + s = (((((q31_t)x ) >> 16) + (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; - return ((uint32_t)((s << 16) | (r))); -} + return ((uint32_t)((s << 16) | (r ))); + } -/* + + /* * @brief C custom defined QSAX */ -__STATIC_FORCEINLINE uint32_t __QSAX(uint32_t x, uint32_t y) -{ + __STATIC_FORCEINLINE uint32_t __QSAX( + uint32_t x, + uint32_t y) + { q31_t r, s; - r = __SSAT(((((q31_t)x << 16) >> 16) + (((q31_t)y) >> 16)), 16) & (int32_t)0x0000FFFF; - s = __SSAT(((((q31_t)x) >> 16) - (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; + r = __SSAT(((((q31_t)x << 16) >> 16) + (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF; + s = __SSAT(((((q31_t)x ) >> 16) - (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF; - return ((uint32_t)((s << 16) | (r))); -} + return ((uint32_t)((s << 16) | (r ))); + } -/* + + /* * @brief C custom defined SHSAX */ -__STATIC_FORCEINLINE uint32_t __SHSAX(uint32_t x, uint32_t y) -{ + __STATIC_FORCEINLINE uint32_t __SHSAX( + uint32_t x, + uint32_t y) + { q31_t r, s; - r = (((((q31_t)x << 16) >> 16) + (((q31_t)y) >> 16)) >> 1) & (int32_t)0x0000FFFF; - s = (((((q31_t)x) >> 16) - (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; + r = (((((q31_t)x << 16) >> 16) + (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF; + s = (((((q31_t)x ) >> 16) - (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF; - return ((uint32_t)((s << 16) | (r))); -} + return ((uint32_t)((s << 16) | (r ))); + } -/* + + /* * @brief C custom defined SMUSDX */ -__STATIC_FORCEINLINE uint32_t __SMUSDX(uint32_t x, uint32_t y) -{ - return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y) >> 16)) - - ((((q31_t)x) >> 16) * (((q31_t)y << 16) >> 16)))); -} - -/* + __STATIC_FORCEINLINE uint32_t __SMUSDX( + uint32_t x, + uint32_t y) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) - + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) )); + } + + /* * @brief C custom defined SMUADX */ -__STATIC_FORCEINLINE uint32_t __SMUADX(uint32_t x, uint32_t y) -{ - return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y) >> 16)) + - ((((q31_t)x) >> 16) * (((q31_t)y << 16) >> 16)))); -} + __STATIC_FORCEINLINE uint32_t __SMUADX( + uint32_t x, + uint32_t y) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) )); + } -/* + + /* * @brief C custom defined QADD */ -__STATIC_FORCEINLINE int32_t __QADD(int32_t x, int32_t y) -{ + __STATIC_FORCEINLINE int32_t __QADD( + int32_t x, + int32_t y) + { return ((int32_t)(clip_q63_to_q31((q63_t)x + (q31_t)y))); -} + } -/* + + /* * @brief C custom defined QSUB */ -__STATIC_FORCEINLINE int32_t __QSUB(int32_t x, int32_t y) -{ + __STATIC_FORCEINLINE int32_t __QSUB( + int32_t x, + int32_t y) + { return ((int32_t)(clip_q63_to_q31((q63_t)x - (q31_t)y))); -} + } -/* + + /* * @brief C custom defined SMLAD */ -__STATIC_FORCEINLINE uint32_t __SMLAD(uint32_t x, uint32_t y, uint32_t sum) -{ + __STATIC_FORCEINLINE uint32_t __SMLAD( + uint32_t x, + uint32_t y, + uint32_t sum) + { return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) + - ((((q31_t)x) >> 16) * (((q31_t)y) >> 16)) + (((q31_t)sum)))); -} + ((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) + + ( ((q31_t)sum ) ) )); + } -/* + + /* * @brief C custom defined SMLADX */ -__STATIC_FORCEINLINE uint32_t __SMLADX(uint32_t x, uint32_t y, uint32_t sum) -{ - return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y) >> 16)) + - ((((q31_t)x) >> 16) * (((q31_t)y << 16) >> 16)) + (((q31_t)sum)))); -} - -/* + __STATIC_FORCEINLINE uint32_t __SMLADX( + uint32_t x, + uint32_t y, + uint32_t sum) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) + + ( ((q31_t)sum ) ) )); + } + + + /* * @brief C custom defined SMLSDX */ -__STATIC_FORCEINLINE uint32_t __SMLSDX(uint32_t x, uint32_t y, uint32_t sum) -{ - return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y) >> 16)) - - ((((q31_t)x) >> 16) * (((q31_t)y << 16) >> 16)) + (((q31_t)sum)))); -} - -/* + __STATIC_FORCEINLINE uint32_t __SMLSDX( + uint32_t x, + uint32_t y, + uint32_t sum) + { + return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) - + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) + + ( ((q31_t)sum ) ) )); + } + + + /* * @brief C custom defined SMLALD */ -__STATIC_FORCEINLINE uint64_t __SMLALD(uint32_t x, uint32_t y, uint64_t sum) -{ - /* return (sum + ((q15_t) (x >> 16) * (q15_t) (y >> 16)) + ((q15_t) x * (q15_t) y)); */ + __STATIC_FORCEINLINE uint64_t __SMLALD( + uint32_t x, + uint32_t y, + uint64_t sum) + { +/* return (sum + ((q15_t) (x >> 16) * (q15_t) (y >> 16)) + ((q15_t) x * (q15_t) y)); */ return ((uint64_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) + - ((((q31_t)x) >> 16) * (((q31_t)y) >> 16)) + (((q63_t)sum)))); -} + ((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) + + ( ((q63_t)sum ) ) )); + } -/* + + /* * @brief C custom defined SMLALDX */ -__STATIC_FORCEINLINE uint64_t __SMLALDX(uint32_t x, uint32_t y, uint64_t sum) -{ - /* return (sum + ((q15_t) (x >> 16) * (q15_t) y)) + ((q15_t) x * (q15_t) (y >> 16)); */ - return ((uint64_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y) >> 16)) + - ((((q31_t)x) >> 16) * (((q31_t)y << 16) >> 16)) + (((q63_t)sum)))); -} - -/* + __STATIC_FORCEINLINE uint64_t __SMLALDX( + uint32_t x, + uint32_t y, + uint64_t sum) + { +/* return (sum + ((q15_t) (x >> 16) * (q15_t) y)) + ((q15_t) x * (q15_t) (y >> 16)); */ + return ((uint64_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) + + ((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) + + ( ((q63_t)sum ) ) )); + } + + + /* * @brief C custom defined SMUAD */ -__STATIC_FORCEINLINE uint32_t __SMUAD(uint32_t x, uint32_t y) -{ + __STATIC_FORCEINLINE uint32_t __SMUAD( + uint32_t x, + uint32_t y) + { return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) + - ((((q31_t)x) >> 16) * (((q31_t)y) >> 16)))); -} + ((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) )); + } -/* + + /* * @brief C custom defined SMUSD */ -__STATIC_FORCEINLINE uint32_t __SMUSD(uint32_t x, uint32_t y) -{ + __STATIC_FORCEINLINE uint32_t __SMUSD( + uint32_t x, + uint32_t y) + { return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) - - ((((q31_t)x) >> 16) * (((q31_t)y) >> 16)))); -} + ((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) )); + } -/* + + /* * @brief C custom defined SXTB16 */ -__STATIC_FORCEINLINE uint32_t __SXTB16(uint32_t x) -{ + __STATIC_FORCEINLINE uint32_t __SXTB16( + uint32_t x) + { return ((uint32_t)(((((q31_t)x << 24) >> 24) & (q31_t)0x0000FFFF) | - ((((q31_t)x << 8) >> 8) & (q31_t)0xFFFF0000))); -} + ((((q31_t)x << 8) >> 8) & (q31_t)0xFFFF0000) )); + } -/* + /* * @brief C custom defined SMMLA */ -__STATIC_FORCEINLINE int32_t __SMMLA(int32_t x, int32_t y, int32_t sum) -{ - return (sum + (int32_t)(((int64_t)x * y) >> 32)); -} + __STATIC_FORCEINLINE int32_t __SMMLA( + int32_t x, + int32_t y, + int32_t sum) + { + return (sum + (int32_t) (((int64_t) x * y) >> 32)); + } #endif /* !defined (ARM_MATH_DSP) */ -#ifdef __cplusplus + +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/quaternion_math_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/quaternion_math_functions.h old mode 100644 new mode 100755 index 33cc3b0c7a2..6c823a368b6 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/quaternion_math_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/quaternion_math_functions.h @@ -24,8 +24,9 @@ * limitations under the License. */ -#ifndef _QUATERNION_MATH_FUNCTIONS_H_ -#define _QUATERNION_MATH_FUNCTIONS_H_ + +#ifndef QUATERNION_MATH_FUNCTIONS_H_ +#define QUATERNION_MATH_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -33,8 +34,10 @@ #include "dsp/none.h" #include "dsp/utils.h" -#ifdef __cplusplus -extern "C" { + +#ifdef __cplusplus +extern "C" +{ #endif /** @@ -43,56 +46,61 @@ extern "C" { * rotation and quaternion representation. */ + /** @brief Floating-point quaternion Norm. @param[in] pInputQuaternions points to the input vector of quaternions @param[out] pNorms points to the output vector of norms @param[in] nbQuaternions number of quaternions in each vector - @return none */ +void arm_quaternion_norm_f32(const float32_t *pInputQuaternions, + float32_t *pNorms, + uint32_t nbQuaternions); -void arm_quaternion_norm_f32(const float32_t *pInputQuaternions, float32_t *pNorms, - uint32_t nbQuaternions); /** @brief Floating-point quaternion inverse. @param[in] pInputQuaternions points to the input vector of quaternions @param[out] pInverseQuaternions points to the output vector of inverse quaternions @param[in] nbQuaternions number of quaternions in each vector - @return none */ +void arm_quaternion_inverse_f32(const float32_t *pInputQuaternions, + float32_t *pInverseQuaternions, + uint32_t nbQuaternions); -void arm_quaternion_inverse_f32(const float32_t *pInputQuaternions, float32_t *pInverseQuaternions, - uint32_t nbQuaternions); /** @brief Floating-point quaternion conjugates. @param[in] pInputQuaternions points to the input vector of quaternions @param[out] pConjugateQuaternions points to the output vector of conjugate quaternions @param[in] nbQuaternions number of quaternions in each vector - @return none */ -void arm_quaternion_conjugate_f32(const float32_t *inputQuaternions, - float32_t *pConjugateQuaternions, uint32_t nbQuaternions); +void arm_quaternion_conjugate_f32(const float32_t *inputQuaternions, + float32_t *pConjugateQuaternions, + uint32_t nbQuaternions); + /** @brief Floating-point normalization of quaternions. @param[in] pInputQuaternions points to the input vector of quaternions @param[out] pNormalizedQuaternions points to the output vector of normalized quaternions @param[in] nbQuaternions number of quaternions in each vector - @return none */ -void arm_quaternion_normalize_f32(const float32_t *inputQuaternions, - float32_t *pNormalizedQuaternions, uint32_t nbQuaternions); +void arm_quaternion_normalize_f32(const float32_t *inputQuaternions, + float32_t *pNormalizedQuaternions, + uint32_t nbQuaternions); + /** @brief Floating-point product of two quaternions. @param[in] qa First quaternion @param[in] qb Second quaternion @param[out] r Product of two quaternions - @return none */ -void arm_quaternion_product_single_f32(const float32_t *qa, const float32_t *qb, float32_t *r); +void arm_quaternion_product_single_f32(const float32_t *qa, + const float32_t *qb, + float32_t *r); + /** @brief Floating-point elementwise product two quaternions. @@ -100,17 +108,18 @@ void arm_quaternion_product_single_f32(const float32_t *qa, const float32_t *qb, @param[in] qb Second array of quaternions @param[out] r Elementwise product of quaternions @param[in] nbQuaternions Number of quaternions in the array - @return none */ -void arm_quaternion_product_f32(const float32_t *qa, const float32_t *qb, float32_t *r, - uint32_t nbQuaternions); +void arm_quaternion_product_f32(const float32_t *qa, + const float32_t *qb, + float32_t *r, + uint32_t nbQuaternions); + /** * @brief Conversion of quaternion to equivalent rotation matrix. * @param[in] pInputQuaternions points to an array of normalized quaternions * @param[out] pOutputRotations points to an array of 3x3 rotations (in row order) * @param[in] nbQuaternions in the array - * @return none. * * Format of rotation matrix * \par @@ -121,20 +130,23 @@ void arm_quaternion_product_f32(const float32_t *qa, const float32_t *qb, float3 * * Rotation matrix is saved in row order : R00 R01 R02 R10 R11 R12 R20 R21 R22 */ -void arm_quaternion2rotation_f32(const float32_t *pInputQuaternions, float32_t *pOutputRotations, - uint32_t nbQuaternions); +void arm_quaternion2rotation_f32(const float32_t *pInputQuaternions, + float32_t *pOutputRotations, + uint32_t nbQuaternions); + /** * @brief Conversion of a rotation matrix to equivalent quaternion. * @param[in] pInputRotations points to an array 3x3 rotation matrix (in row order) * @param[out] pOutputQuaternions points to an array of quaternions * @param[in] nbQuaternions in the array - * @return none. */ -void arm_rotation2quaternion_f32(const float32_t *pInputRotations, float32_t *pOutputQuaternions, - uint32_t nbQuaternions); +void arm_rotation2quaternion_f32(const float32_t *pInputRotations, + float32_t *pOutputQuaternions, + uint32_t nbQuaternions); + -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions.h old mode 100644 new mode 100755 index e6423265468..301aadd023c --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions.h @@ -1,8 +1,8 @@ /****************************************************************************** * @file statistics_functions.h * @brief Public header file for CMSIS DSP Library - * @version V1.10.0 - * @date 08 July 2021 + * @version V1.10.1 + * @date 14 July 2022 * Target Processor: Cortex-M and Cortex-A cores ******************************************************************************/ /* @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _STATISTICS_FUNCTIONS_H_ -#define _STATISTICS_FUNCTIONS_H_ + +#ifndef STATISTICS_FUNCTIONS_H_ +#define STATISTICS_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -35,10 +36,12 @@ #include "dsp/basic_math_functions.h" #include "dsp/fast_math_functions.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif + /** * @defgroup groupStats Statistics Functions */ @@ -67,6 +70,7 @@ extern "C" { * */ + float32_t arm_logsumexp_f32(const float32_t *in, uint32_t blockSize); /** @@ -82,8 +86,11 @@ float32_t arm_logsumexp_f32(const float32_t *in, uint32_t blockSize); * */ -float32_t arm_logsumexp_dot_prod_f32(const float32_t *pSrcA, const float32_t *pSrcB, - uint32_t blockSize, float32_t *pTmpBuffer); + +float32_t arm_logsumexp_dot_prod_f32(const float32_t * pSrcA, + const float32_t * pSrcB, + uint32_t blockSize, + float32_t *pTmpBuffer); /** * @brief Entropy @@ -94,7 +101,9 @@ float32_t arm_logsumexp_dot_prod_f32(const float32_t *pSrcA, const float32_t *pS * */ -float32_t arm_entropy_f32(const float32_t *pSrcA, uint32_t blockSize); + +float32_t arm_entropy_f32(const float32_t * pSrcA,uint32_t blockSize); + /** * @brief Entropy @@ -105,7 +114,9 @@ float32_t arm_entropy_f32(const float32_t *pSrcA, uint32_t blockSize); * */ -float64_t arm_entropy_f64(const float64_t *pSrcA, uint32_t blockSize); + +float64_t arm_entropy_f64(const float64_t * pSrcA, uint32_t blockSize); + /** * @brief Kullback-Leibler @@ -116,8 +127,10 @@ float64_t arm_entropy_f64(const float64_t *pSrcA, uint32_t blockSize); * @return Kullback-Leibler Divergence D(A || B) * */ -float32_t arm_kullback_leibler_f32(const float32_t *pSrcA, const float32_t *pSrcB, - uint32_t blockSize); +float32_t arm_kullback_leibler_f32(const float32_t * pSrcA + ,const float32_t * pSrcB + ,uint32_t blockSize); + /** * @brief Kullback-Leibler @@ -128,211 +141,314 @@ float32_t arm_kullback_leibler_f32(const float32_t *pSrcA, const float32_t *pSrc * @return Kullback-Leibler Divergence D(A || B) * */ -float64_t arm_kullback_leibler_f64(const float64_t *pSrcA, const float64_t *pSrcB, - uint32_t blockSize); +float64_t arm_kullback_leibler_f64(const float64_t * pSrcA, + const float64_t * pSrcB, + uint32_t blockSize); -/** + + /** * @brief Sum of the squares of the elements of a Q31 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_power_q31(const q31_t *pSrc, uint32_t blockSize, q63_t *pResult); + void arm_power_q31( + const q31_t * pSrc, + uint32_t blockSize, + q63_t * pResult); -/** + + /** * @brief Sum of the squares of the elements of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_power_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult); + void arm_power_f32( + const float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); -/** + + /** * @brief Sum of the squares of the elements of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_power_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult); + void arm_power_f64( + const float64_t * pSrc, + uint32_t blockSize, + float64_t * pResult); -/** + + /** * @brief Sum of the squares of the elements of a Q15 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_power_q15(const q15_t *pSrc, uint32_t blockSize, q63_t *pResult); + void arm_power_q15( + const q15_t * pSrc, + uint32_t blockSize, + q63_t * pResult); -/** + + /** * @brief Sum of the squares of the elements of a Q7 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_power_q7(const q7_t *pSrc, uint32_t blockSize, q31_t *pResult); + void arm_power_q7( + const q7_t * pSrc, + uint32_t blockSize, + q31_t * pResult); -/** + + /** * @brief Mean value of a Q7 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_mean_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *pResult); + void arm_mean_q7( + const q7_t * pSrc, + uint32_t blockSize, + q7_t * pResult); -/** + + /** * @brief Mean value of a Q15 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_mean_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult); + void arm_mean_q15( + const q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); -/** + + /** * @brief Mean value of a Q31 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_mean_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult); + void arm_mean_q31( + const q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); -/** + + /** * @brief Mean value of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_mean_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult); + void arm_mean_f32( + const float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); -/** + + /** * @brief Mean value of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_mean_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult); + void arm_mean_f64( + const float64_t * pSrc, + uint32_t blockSize, + float64_t * pResult); -/** + + /** * @brief Variance of the elements of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_var_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult); + void arm_var_f32( + const float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); -/** + + /** * @brief Variance of the elements of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_var_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult); + void arm_var_f64( + const float64_t * pSrc, + uint32_t blockSize, + float64_t * pResult); -/** + + /** * @brief Variance of the elements of a Q31 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_var_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult); + void arm_var_q31( + const q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); -/** + + /** * @brief Variance of the elements of a Q15 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_var_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult); + void arm_var_q15( + const q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); -/** + + /** * @brief Root Mean Square of the elements of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_rms_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult); + void arm_rms_f32( + const float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); -/** + + /** * @brief Root Mean Square of the elements of a Q31 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_rms_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult); + void arm_rms_q31( + const q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); -/** + + /** * @brief Root Mean Square of the elements of a Q15 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_rms_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult); + void arm_rms_q15( + const q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); -/** + + /** * @brief Standard deviation of the elements of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_std_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult); + void arm_std_f32( + const float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); -/** + + /** * @brief Standard deviation of the elements of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_std_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult); + void arm_std_f64( + const float64_t * pSrc, + uint32_t blockSize, + float64_t * pResult); -/** + + /** * @brief Standard deviation of the elements of a Q31 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_std_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult); + void arm_std_q31( + const q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); -/** + + /** * @brief Standard deviation of the elements of a Q15 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_std_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult); + void arm_std_q15( + const q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); -/** + + + /** * @brief Minimum value of a Q7 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process - * @param[out] result is output pointer - * @param[in] index is the array index of the minimum value in the input buffer. + * @param[out] pResult is output pointer + * @param[in] pIndex is the array index of the minimum value in the input buffer. */ -void arm_min_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *result, uint32_t *index); + void arm_min_q7( + const q7_t * pSrc, + uint32_t blockSize, + q7_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Minimum value of absolute values of a Q7 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process - * @param[out] result is output pointer - * @param[in] index is the array index of the minimum value in the input buffer. + * @param[out] pResult is output pointer + * @param[in] pIndex is the array index of the minimum value in the input buffer. */ -void arm_absmin_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *result, uint32_t *index); + void arm_absmin_q7( + const q7_t * pSrc, + uint32_t blockSize, + q7_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Minimum value of absolute values of a Q7 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process - * @param[out] result is output pointer + * @param[out] pResult is output pointer */ -void arm_absmin_no_idx_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *result); + void arm_absmin_no_idx_q7( + const q7_t * pSrc, + uint32_t blockSize, + q7_t * pResult); -/** + + /** * @brief Minimum value of a Q15 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer * @param[in] pIndex is the array index of the minimum value in the input buffer. */ -void arm_min_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult, uint32_t *pIndex); + void arm_min_q15( + const q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult, + uint32_t * pIndex); /** * @brief Minimum value of absolute values of a Q15 vector. @@ -341,95 +457,137 @@ void arm_min_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult, uint32_t * @param[out] pResult is output pointer * @param[in] pIndex is the array index of the minimum value in the input buffer. */ -void arm_absmin_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult, uint32_t *pIndex); + void arm_absmin_q15( + const q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Minimum value of absolute values of a Q15 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer */ -void arm_absmin_no_idx_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult); + void arm_absmin_no_idx_q15( + const q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); -/** + + /** * @brief Minimum value of a Q31 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer * @param[out] pIndex is the array index of the minimum value in the input buffer. */ -void arm_min_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult, uint32_t *pIndex); + void arm_min_q31( + const q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Minimum value of absolute values of a Q31 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer * @param[out] pIndex is the array index of the minimum value in the input buffer. */ -void arm_absmin_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult, uint32_t *pIndex); + void arm_absmin_q31( + const q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Minimum value of absolute values of a Q31 vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer */ -void arm_absmin_no_idx_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult); + void arm_absmin_no_idx_q31( + const q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); -/** + + /** * @brief Minimum value of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer * @param[out] pIndex is the array index of the minimum value in the input buffer. */ -void arm_min_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult, uint32_t *pIndex); + void arm_min_f32( + const float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Minimum value of absolute values of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer * @param[out] pIndex is the array index of the minimum value in the input buffer. */ -void arm_absmin_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult, - uint32_t *pIndex); + void arm_absmin_f32( + const float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Minimum value of absolute values of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer */ -void arm_absmin_no_idx_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult); + void arm_absmin_no_idx_f32( + const float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); -/** + + /** * @brief Minimum value of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer * @param[out] pIndex is the array index of the minimum value in the input buffer. */ -void arm_min_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult, uint32_t *pIndex); + void arm_min_f64( + const float64_t * pSrc, + uint32_t blockSize, + float64_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Minimum value of absolute values of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer * @param[out] pIndex is the array index of the minimum value in the input buffer. */ -void arm_absmin_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult, - uint32_t *pIndex); + void arm_absmin_f64( + const float64_t * pSrc, + uint32_t blockSize, + float64_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Minimum value of absolute values of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer */ -void arm_absmin_no_idx_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult); + void arm_absmin_no_idx_f64( + const float64_t * pSrc, + uint32_t blockSize, + float64_t * pResult); + /** * @brief Maximum value of a Q7 vector. @@ -438,7 +596,11 @@ void arm_absmin_no_idx_f64(const float64_t *pSrc, uint32_t blockSize, float64_t * @param[out] pResult maximum value returned here * @param[out] pIndex index of maximum value returned here */ -void arm_max_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *pResult, uint32_t *pIndex); + void arm_max_q7( + const q7_t * pSrc, + uint32_t blockSize, + q7_t * pResult, + uint32_t * pIndex); /** * @brief Maximum value of absolute values of a Q7 vector. @@ -447,7 +609,11 @@ void arm_max_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *pResult, uint32_t *p * @param[out] pResult maximum value returned here * @param[out] pIndex index of maximum value returned here */ -void arm_absmax_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *pResult, uint32_t *pIndex); + void arm_absmax_q7( + const q7_t * pSrc, + uint32_t blockSize, + q7_t * pResult, + uint32_t * pIndex); /** * @brief Maximum value of absolute values of a Q7 vector. @@ -455,7 +621,11 @@ void arm_absmax_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *pResult, uint32_t * @param[in] blockSize length of the input vector * @param[out] pResult maximum value returned here */ -void arm_absmax_no_idx_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *pResult); + void arm_absmax_no_idx_q7( + const q7_t * pSrc, + uint32_t blockSize, + q7_t * pResult); + /** * @brief Maximum value of a Q15 vector. @@ -464,7 +634,11 @@ void arm_absmax_no_idx_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *pResult); * @param[out] pResult maximum value returned here * @param[out] pIndex index of maximum value returned here */ -void arm_max_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult, uint32_t *pIndex); + void arm_max_q15( + const q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult, + uint32_t * pIndex); /** * @brief Maximum value of absolute values of a Q15 vector. @@ -473,15 +647,22 @@ void arm_max_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult, uint32_t * @param[out] pResult maximum value returned here * @param[out] pIndex index of maximum value returned here */ -void arm_absmax_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult, uint32_t *pIndex); + void arm_absmax_q15( + const q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Maximum value of absolute values of a Q15 vector. * @param[in] pSrc points to the input buffer * @param[in] blockSize length of the input vector * @param[out] pResult maximum value returned here */ -void arm_absmax_no_idx_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult); + void arm_absmax_no_idx_q15( + const q15_t * pSrc, + uint32_t blockSize, + q15_t * pResult); /** * @brief Maximum value of a Q31 vector. @@ -490,7 +671,11 @@ void arm_absmax_no_idx_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult * @param[out] pResult maximum value returned here * @param[out] pIndex index of maximum value returned here */ -void arm_max_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult, uint32_t *pIndex); + void arm_max_q31( + const q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult, + uint32_t * pIndex); /** * @brief Maximum value of absolute values of a Q31 vector. @@ -499,15 +684,22 @@ void arm_max_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult, uint32_t * @param[out] pResult maximum value returned here * @param[out] pIndex index of maximum value returned here */ -void arm_absmax_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult, uint32_t *pIndex); + void arm_absmax_q31( + const q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Maximum value of absolute values of a Q31 vector. * @param[in] pSrc points to the input buffer * @param[in] blockSize length of the input vector * @param[out] pResult maximum value returned here */ -void arm_absmax_no_idx_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult); + void arm_absmax_no_idx_q31( + const q31_t * pSrc, + uint32_t blockSize, + q31_t * pResult); /** * @brief Maximum value of a floating-point vector. @@ -516,7 +708,11 @@ void arm_absmax_no_idx_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult * @param[out] pResult maximum value returned here * @param[out] pIndex index of maximum value returned here */ -void arm_max_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult, uint32_t *pIndex); + void arm_max_f32( + const float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult, + uint32_t * pIndex); /** * @brief Maximum value of absolute values of a floating-point vector. @@ -525,16 +721,22 @@ void arm_max_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult, * @param[out] pResult maximum value returned here * @param[out] pIndex index of maximum value returned here */ -void arm_absmax_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult, - uint32_t *pIndex); + void arm_absmax_f32( + const float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Maximum value of absolute values of a floating-point vector. * @param[in] pSrc points to the input buffer * @param[in] blockSize length of the input vector * @param[out] pResult maximum value returned here */ -void arm_absmax_no_idx_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult); + void arm_absmax_no_idx_f32( + const float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); /** * @brief Maximum value of a floating-point vector. @@ -543,7 +745,11 @@ void arm_absmax_no_idx_f32(const float32_t *pSrc, uint32_t blockSize, float32_t * @param[out] pResult maximum value returned here * @param[out] pIndex index of maximum value returned here */ -void arm_max_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult, uint32_t *pIndex); + void arm_max_f64( + const float64_t * pSrc, + uint32_t blockSize, + float64_t * pResult, + uint32_t * pIndex); /** * @brief Maximum value of absolute values of a floating-point vector. @@ -552,8 +758,11 @@ void arm_max_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult, * @param[out] pResult maximum value returned here * @param[out] pIndex index of maximum value returned here */ -void arm_absmax_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult, - uint32_t *pIndex); + void arm_absmax_f64( + const float64_t * pSrc, + uint32_t blockSize, + float64_t * pResult, + uint32_t * pIndex); /** * @brief Maximum value of absolute values of a floating-point vector. @@ -561,97 +770,120 @@ void arm_absmax_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResul * @param[in] blockSize length of the input vector * @param[out] pResult maximum value returned here */ -void arm_absmax_no_idx_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult); + void arm_absmax_no_idx_f64( + const float64_t * pSrc, + uint32_t blockSize, + float64_t * pResult); -/** + /** @brief Maximum value of a floating-point vector. @param[in] pSrc points to the input vector @param[in] blockSize number of samples in input vector @param[out] pResult maximum value returned here - @return none */ -void arm_max_no_idx_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult); + void arm_max_no_idx_f32( + const float32_t *pSrc, + uint32_t blockSize, + float32_t *pResult); -/** + /** @brief Minimum value of a floating-point vector. @param[in] pSrc points to the input vector @param[in] blockSize number of samples in input vector @param[out] pResult minimum value returned here - @return none */ -void arm_min_no_idx_f32(const float32_t *pSrc, uint32_t blockSize, float32_t *pResult); + void arm_min_no_idx_f32( + const float32_t *pSrc, + uint32_t blockSize, + float32_t *pResult); -/** + /** @brief Maximum value of a floating-point vector. @param[in] pSrc points to the input vector @param[in] blockSize number of samples in input vector @param[out] pResult maximum value returned here - @return none */ -void arm_max_no_idx_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult); + void arm_max_no_idx_f64( + const float64_t *pSrc, + uint32_t blockSize, + float64_t *pResult); -/** + /** @brief Maximum value of a q31 vector. @param[in] pSrc points to the input vector @param[in] blockSize number of samples in input vector @param[out] pResult maximum value returned here - @return none */ -void arm_max_no_idx_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult); + void arm_max_no_idx_q31( + const q31_t *pSrc, + uint32_t blockSize, + q31_t *pResult); -/** + /** @brief Maximum value of a q15 vector. @param[in] pSrc points to the input vector @param[in] blockSize number of samples in input vector @param[out] pResult maximum value returned here - @return none */ -void arm_max_no_idx_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult); + void arm_max_no_idx_q15( + const q15_t *pSrc, + uint32_t blockSize, + q15_t *pResult); -/** + /** @brief Maximum value of a q7 vector. @param[in] pSrc points to the input vector @param[in] blockSize number of samples in input vector @param[out] pResult maximum value returned here - @return none */ -void arm_max_no_idx_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *pResult); + void arm_max_no_idx_q7( + const q7_t *pSrc, + uint32_t blockSize, + q7_t *pResult); -/** + /** @brief Minimum value of a floating-point vector. @param[in] pSrc points to the input vector @param[in] blockSize number of samples in input vector @param[out] pResult minimum value returned here - @return none */ -void arm_min_no_idx_f64(const float64_t *pSrc, uint32_t blockSize, float64_t *pResult); + void arm_min_no_idx_f64( + const float64_t *pSrc, + uint32_t blockSize, + float64_t *pResult); /** @brief Minimum value of a q31 vector. @param[in] pSrc points to the input vector @param[in] blockSize number of samples in input vector @param[out] pResult minimum value returned here - @return none */ -void arm_min_no_idx_q31(const q31_t *pSrc, uint32_t blockSize, q31_t *pResult); + void arm_min_no_idx_q31( + const q31_t *pSrc, + uint32_t blockSize, + q31_t *pResult); -/** + /** @brief Minimum value of a q15 vector. @param[in] pSrc points to the input vector @param[in] blockSize number of samples in input vector @param[out] pResult minimum value returned here - @return none */ -void arm_min_no_idx_q15(const q15_t *pSrc, uint32_t blockSize, q15_t *pResult); + void arm_min_no_idx_q15( + const q15_t *pSrc, + uint32_t blockSize, + q15_t *pResult); -/** + /** @brief Minimum value of a q7 vector. @param[in] pSrc points to the input vector @param[in] blockSize number of samples in input vector @param[out] pResult minimum value returned here - @return none */ -void arm_min_no_idx_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *pResult); +void arm_min_no_idx_q7( + const q7_t *pSrc, + uint32_t blockSize, + q7_t *pResult); /** @brief Mean square error between two Q7 vectors. @@ -659,10 +891,13 @@ void arm_min_no_idx_q7(const q7_t *pSrc, uint32_t blockSize, q7_t *pResult); @param[in] pSrcB points to the second input vector @param[in] blockSize number of samples in input vector @param[out] pResult mean square error - @return none */ - -void arm_mse_q7(const q7_t *pSrcA, const q7_t *pSrcB, uint32_t blockSize, q7_t *pResult); + +void arm_mse_q7( + const q7_t * pSrcA, + const q7_t * pSrcB, + uint32_t blockSize, + q7_t * pResult); /** @brief Mean square error between two Q15 vectors. @@ -670,10 +905,13 @@ void arm_mse_q7(const q7_t *pSrcA, const q7_t *pSrcB, uint32_t blockSize, q7_t * @param[in] pSrcB points to the second input vector @param[in] blockSize number of samples in input vector @param[out] pResult mean square error - @return none */ - -void arm_mse_q15(const q15_t *pSrcA, const q15_t *pSrcB, uint32_t blockSize, q15_t *pResult); + +void arm_mse_q15( + const q15_t * pSrcA, + const q15_t * pSrcB, + uint32_t blockSize, + q15_t * pResult); /** @brief Mean square error between two Q31 vectors. @@ -681,10 +919,13 @@ void arm_mse_q15(const q15_t *pSrcA, const q15_t *pSrcB, uint32_t blockSize, q15 @param[in] pSrcB points to the second input vector @param[in] blockSize number of samples in input vector @param[out] pResult mean square error - @return none */ - -void arm_mse_q31(const q31_t *pSrcA, const q31_t *pSrcB, uint32_t blockSize, q31_t *pResult); + +void arm_mse_q31( + const q31_t * pSrcA, + const q31_t * pSrcB, + uint32_t blockSize, + q31_t * pResult); /** @brief Mean square error between two single precision float vectors. @@ -692,11 +933,13 @@ void arm_mse_q31(const q31_t *pSrcA, const q31_t *pSrcB, uint32_t blockSize, q31 @param[in] pSrcB points to the second input vector @param[in] blockSize number of samples in input vector @param[out] pResult mean square error - @return none */ - -void arm_mse_f32(const float32_t *pSrcA, const float32_t *pSrcB, uint32_t blockSize, - float32_t *pResult); + +void arm_mse_f32( + const float32_t * pSrcA, + const float32_t * pSrcB, + uint32_t blockSize, + float32_t * pResult); /** @brief Mean square error between two double precision float vectors. @@ -704,13 +947,41 @@ void arm_mse_f32(const float32_t *pSrcA, const float32_t *pSrcB, uint32_t blockS @param[in] pSrcB points to the second input vector @param[in] blockSize number of samples in input vector @param[out] pResult mean square error - @return none */ + +void arm_mse_f64( + const float64_t * pSrcA, + const float64_t * pSrcB, + uint32_t blockSize, + float64_t * pResult); + + +/** + * @brief Accumulation value of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + +void arm_accumulate_f32( +const float32_t * pSrc, + uint32_t blockSize, + float32_t * pResult); + +/** + * @brief Accumulation value of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + +void arm_accumulate_f64( +const float64_t * pSrc, + uint32_t blockSize, + float64_t * pResult); -void arm_mse_f64(const float64_t *pSrcA, const float64_t *pSrcB, uint32_t blockSize, - float64_t *pResult); -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions_f16.h old mode 100644 new mode 100755 index 9898dd20144..746e8df39b8 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions_f16.h @@ -1,8 +1,8 @@ /****************************************************************************** * @file statistics_functions_f16.h * @brief Public header file for CMSIS DSP Library - * @version V1.10.0 - * @date 08 July 2021 + * @version V1.10.1 + * @date 14 July 2022 * Target Processor: Cortex-M and Cortex-A cores ******************************************************************************/ /* @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _STATISTICS_FUNCTIONS_F16_H_ -#define _STATISTICS_FUNCTIONS_F16_H_ + +#ifndef STATISTICS_FUNCTIONS_F16_H_ +#define STATISTICS_FUNCTIONS_F16_H_ #include "arm_math_types_f16.h" #include "arm_math_memory.h" @@ -35,70 +36,93 @@ #include "dsp/basic_math_functions_f16.h" #include "dsp/fast_math_functions_f16.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #if defined(ARM_FLOAT16_SUPPORTED) -/** + /** * @brief Sum of the squares of the elements of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_power_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult); + void arm_power_f16( + const float16_t * pSrc, + uint32_t blockSize, + float16_t * pResult); -/** + /** * @brief Mean value of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_mean_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult); + void arm_mean_f16( + const float16_t * pSrc, + uint32_t blockSize, + float16_t * pResult); -/** + /** * @brief Variance of the elements of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_var_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult); + void arm_var_f16( + const float16_t * pSrc, + uint32_t blockSize, + float16_t * pResult); -/** + /** * @brief Root Mean Square of the elements of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_rms_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult); + void arm_rms_f16( + const float16_t * pSrc, + uint32_t blockSize, + float16_t * pResult); -/** + /** * @brief Standard deviation of the elements of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output value. */ -void arm_std_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult); + void arm_std_f16( + const float16_t * pSrc, + uint32_t blockSize, + float16_t * pResult); -/** + /** * @brief Minimum value of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer * @param[out] pIndex is the array index of the minimum value in the input buffer. */ -void arm_min_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult, uint32_t *pIndex); + void arm_min_f16( + const float16_t * pSrc, + uint32_t blockSize, + float16_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Minimum value of absolute values of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer * @param[out] pIndex is the array index of the minimum value in the input buffer. */ -void arm_absmin_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult, - uint32_t *pIndex); + void arm_absmin_f16( + const float16_t * pSrc, + uint32_t blockSize, + float16_t * pResult, + uint32_t * pIndex); /** * @brief Maximum value of a floating-point vector. @@ -107,7 +131,11 @@ void arm_absmin_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResul * @param[out] pResult maximum value returned here * @param[out] pIndex index of maximum value returned here */ -void arm_max_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult, uint32_t *pIndex); + void arm_max_f16( + const float16_t * pSrc, + uint32_t blockSize, + float16_t * pResult, + uint32_t * pIndex); /** * @brief Maximum value of absolute values of a floating-point vector. @@ -116,16 +144,22 @@ void arm_max_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult, * @param[out] pResult maximum value returned here * @param[out] pIndex index of maximum value returned here */ -void arm_absmax_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult, - uint32_t *pIndex); + void arm_absmax_f16( + const float16_t * pSrc, + uint32_t blockSize, + float16_t * pResult, + uint32_t * pIndex); -/** + /** * @brief Minimum value of absolute values of a floating-point vector. * @param[in] pSrc is input pointer * @param[in] blockSize is the number of samples to process * @param[out] pResult is output pointer */ -void arm_absmin_no_idx_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult); + void arm_absmin_no_idx_f16( + const float16_t * pSrc, + uint32_t blockSize, + float16_t * pResult); /** * @brief Maximum value of a floating-point vector. @@ -133,7 +167,11 @@ void arm_absmin_no_idx_f16(const float16_t *pSrc, uint32_t blockSize, float16_t * @param[in] blockSize length of the input vector * @param[out] pResult maximum value returned here */ -void arm_absmax_no_idx_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult); + void arm_absmax_no_idx_f16( + const float16_t * pSrc, + uint32_t blockSize, + float16_t * pResult); + /** * @brief Entropy @@ -141,13 +179,13 @@ void arm_absmax_no_idx_f16(const float16_t *pSrc, uint32_t blockSize, float16_t * @param[in] pSrcA Array of input values. * @param[in] blockSize Number of samples in the input array. * @return Entropy -Sum(p ln p) - * */ +float16_t arm_entropy_f16(const float16_t * pSrcA,uint32_t blockSize); -float16_t arm_entropy_f16(const float16_t *pSrcA, uint32_t blockSize); float16_t arm_logsumexp_f16(const float16_t *in, uint32_t blockSize); + /** * @brief Dot product with log arithmetic * @@ -158,11 +196,12 @@ float16_t arm_logsumexp_f16(const float16_t *in, uint32_t blockSize); * @param[in] blockSize number of samples in each vector * @param[in] pTmpBuffer temporary buffer of length blockSize * @return The log of the dot product . - * */ +float16_t arm_logsumexp_dot_prod_f16(const float16_t * pSrcA, + const float16_t * pSrcB, + uint32_t blockSize, + float16_t *pTmpBuffer); -float16_t arm_logsumexp_dot_prod_f16(const float16_t *pSrcA, const float16_t *pSrcB, - uint32_t blockSize, float16_t *pTmpBuffer); /** * @brief Kullback-Leibler @@ -171,28 +210,35 @@ float16_t arm_logsumexp_dot_prod_f16(const float16_t *pSrcA, const float16_t *pS * @param[in] pSrcB Pointer to an array of input values for probability distribution B. * @param[in] blockSize Number of samples in the input array. * @return Kullback-Leibler Divergence D(A || B) - * */ -float16_t arm_kullback_leibler_f16(const float16_t *pSrcA, const float16_t *pSrcB, - uint32_t blockSize); +float16_t arm_kullback_leibler_f16(const float16_t * pSrcA + ,const float16_t * pSrcB + ,uint32_t blockSize); + /** @brief Maximum value of a floating-point vector. @param[in] pSrc points to the input vector @param[in] blockSize number of samples in input vector @param[out] pResult maximum value returned here - @return none */ -void arm_max_no_idx_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult); + void arm_max_no_idx_f16( + const float16_t *pSrc, + uint32_t blockSize, + float16_t *pResult); + /** @brief Minimum value of a floating-point vector. @param[in] pSrc points to the input vector @param[in] blockSize number of samples in input vector @param[out] pResult minimum value returned here - @return none */ -void arm_min_no_idx_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pResult); + void arm_min_no_idx_f16( + const float16_t *pSrc, + uint32_t blockSize, + float16_t *pResult); + /** @brief Mean square error between two half precision float vectors. @@ -200,14 +246,28 @@ void arm_min_no_idx_f16(const float16_t *pSrc, uint32_t blockSize, float16_t *pR @param[in] pSrcB points to the second input vector @param[in] blockSize number of samples in input vector @param[out] pResult mean square error - @return none */ +void arm_mse_f16( + const float16_t * pSrcA, + const float16_t * pSrcB, + uint32_t blockSize, + float16_t * pResult); + + +/** + * @brief Sum value of a floating-point vector. + * @param[in] pSrc is input pointer + * @param[in] blockSize is the number of samples to process + * @param[out] pResult is output value. + */ + void arm_accumulate_f16( + const float16_t * pSrc, + uint32_t blockSize, + float16_t * pResult); -void arm_mse_f16(const float16_t *pSrcA, const float16_t *pSrcB, uint32_t blockSize, - float16_t *pResult); #endif /*defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions.h old mode 100644 new mode 100755 index 3109e7338d2..928cf403f15 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions.h @@ -1,8 +1,8 @@ /****************************************************************************** * @file support_functions.h * @brief Public header file for CMSIS DSP Library - * @version V1.10.0 - * @date 08 July 2021 + * @version V1.10.1 + * @date 18 August 2022 * Target Processor: Cortex-M and Cortex-A cores ******************************************************************************/ /* @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _SUPPORT_FUNCTIONS_H_ -#define _SUPPORT_FUNCTIONS_H_ + +#ifndef SUPPORT_FUNCTIONS_H_ +#define SUPPORT_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -32,277 +33,485 @@ #include "dsp/none.h" #include "dsp/utils.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif /** * @defgroup groupSupport Support Functions */ + +/** + * @brief Converts the elements of the 64 bit floating-point vector to floating-point vector. + * @param[in] pSrc points to the floating-point 64 input vector + * @param[out] pDst points to the floating-point output vector + * @param[in] blockSize length of the input vector + */ + void arm_f64_to_float( + const float64_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + +/** + * @brief Converts the elements of the 64 bit floating-point vector to Q31 vector. + * @param[in] pSrc points to the floating-point 64 input vector + * @param[out] pDst points to the Q31 output vector + * @param[in] blockSize length of the input vector + */ + void arm_f64_to_q31( + const float64_t * pSrc, + q31_t * pDst, + uint32_t blockSize); + +/** + * @brief Converts the elements of the 64 bit floating-point vector to Q15 vector. + * @param[in] pSrc points to the floating-point 64 input vector + * @param[out] pDst points to the Q15 output vector + * @param[in] blockSize length of the input vector + */ + void arm_f64_to_q15( + const float64_t * pSrc, + q15_t * pDst, + uint32_t blockSize); + +/** + * @brief Converts the elements of the 64 bit floating-point vector to Q7 vector. + * @param[in] pSrc points to the floating-point 64 input vector + * @param[out] pDst points to the Q7 output vector + * @param[in] blockSize length of the input vector + */ + void arm_f64_to_q7( + const float64_t * pSrc, + q7_t * pDst, + uint32_t blockSize); + + + +/** + * @brief Converts the elements of the floating-point vector to 64 bit floating-point vector. + * @param[in] pSrc points to the floating-point input vector + * @param[out] pDst points to the 64 bit floating-point output vector + * @param[in] blockSize length of the input vector + */ + void arm_float_to_f64( + const float32_t * pSrc, + float64_t * pDst, + uint32_t blockSize); + /** * @brief Converts the elements of the floating-point vector to Q31 vector. * @param[in] pSrc points to the floating-point input vector * @param[out] pDst points to the Q31 output vector * @param[in] blockSize length of the input vector */ -void arm_float_to_q31(const float32_t *pSrc, q31_t *pDst, uint32_t blockSize); + void arm_float_to_q31( + const float32_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Converts the elements of the floating-point vector to Q15 vector. * @param[in] pSrc points to the floating-point input vector * @param[out] pDst points to the Q15 output vector * @param[in] blockSize length of the input vector */ -void arm_float_to_q15(const float32_t *pSrc, q15_t *pDst, uint32_t blockSize); + void arm_float_to_q15( + const float32_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Converts the elements of the floating-point vector to Q7 vector. * @param[in] pSrc points to the floating-point input vector * @param[out] pDst points to the Q7 output vector * @param[in] blockSize length of the input vector */ -void arm_float_to_q7(const float32_t *pSrc, q7_t *pDst, uint32_t blockSize); + void arm_float_to_q7( + const float32_t * pSrc, + q7_t * pDst, + uint32_t blockSize); /** + * @brief Converts the elements of the Q31 vector to 64 bit floating-point vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ +void arm_q31_to_f64( +const q31_t * pSrc, + float64_t * pDst, + uint32_t blockSize); + + /** * @brief Converts the elements of the Q31 vector to floating-point vector. * @param[in] pSrc is input pointer * @param[out] pDst is output pointer * @param[in] blockSize is the number of samples to process */ -void arm_q31_to_float(const q31_t *pSrc, float32_t *pDst, uint32_t blockSize); + void arm_q31_to_float( + const q31_t * pSrc, + float32_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Converts the elements of the Q31 vector to Q15 vector. * @param[in] pSrc is input pointer * @param[out] pDst is output pointer * @param[in] blockSize is the number of samples to process */ -void arm_q31_to_q15(const q31_t *pSrc, q15_t *pDst, uint32_t blockSize); + void arm_q31_to_q15( + const q31_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Converts the elements of the Q31 vector to Q7 vector. * @param[in] pSrc is input pointer * @param[out] pDst is output pointer * @param[in] blockSize is the number of samples to process */ -void arm_q31_to_q7(const q31_t *pSrc, q7_t *pDst, uint32_t blockSize); + void arm_q31_to_q7( + const q31_t * pSrc, + q7_t * pDst, + uint32_t blockSize); /** + * @brief Converts the elements of the Q15 vector to 64 bit floating-point vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ +void arm_q15_to_f64( +const q15_t * pSrc, + float64_t * pDst, + uint32_t blockSize); + + /** * @brief Converts the elements of the Q15 vector to floating-point vector. * @param[in] pSrc is input pointer * @param[out] pDst is output pointer * @param[in] blockSize is the number of samples to process */ -void arm_q15_to_float(const q15_t *pSrc, float32_t *pDst, uint32_t blockSize); + void arm_q15_to_float( + const q15_t * pSrc, + float32_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Converts the elements of the Q15 vector to Q31 vector. * @param[in] pSrc is input pointer * @param[out] pDst is output pointer * @param[in] blockSize is the number of samples to process */ -void arm_q15_to_q31(const q15_t *pSrc, q31_t *pDst, uint32_t blockSize); + void arm_q15_to_q31( + const q15_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Converts the elements of the Q15 vector to Q7 vector. * @param[in] pSrc is input pointer * @param[out] pDst is output pointer * @param[in] blockSize is the number of samples to process */ -void arm_q15_to_q7(const q15_t *pSrc, q7_t *pDst, uint32_t blockSize); + void arm_q15_to_q7( + const q15_t * pSrc, + q7_t * pDst, + uint32_t blockSize); /** + * @brief Converts the elements of the Q7 vector to 64 bit floating-point vector. + * @param[in] pSrc is input pointer + * @param[out] pDst is output pointer + * @param[in] blockSize is the number of samples to process + */ +void arm_q7_to_f64( +const q7_t * pSrc, + float64_t * pDst, + uint32_t blockSize); + + /** * @brief Converts the elements of the Q7 vector to floating-point vector. * @param[in] pSrc is input pointer * @param[out] pDst is output pointer * @param[in] blockSize is the number of samples to process */ -void arm_q7_to_float(const q7_t *pSrc, float32_t *pDst, uint32_t blockSize); + void arm_q7_to_float( + const q7_t * pSrc, + float32_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Converts the elements of the Q7 vector to Q31 vector. * @param[in] pSrc input pointer * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_q7_to_q31(const q7_t *pSrc, q31_t *pDst, uint32_t blockSize); + void arm_q7_to_q31( + const q7_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Converts the elements of the Q7 vector to Q15 vector. * @param[in] pSrc input pointer * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_q7_to_q15(const q7_t *pSrc, q15_t *pDst, uint32_t blockSize); + void arm_q7_to_q15( + const q7_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + + + + + /** * @brief Struct for specifying sorting algorithm */ -typedef enum { - ARM_SORT_BITONIC = 0, - /**< Bitonic sort */ - ARM_SORT_BUBBLE = 1, - /**< Bubble sort */ - ARM_SORT_HEAP = 2, - /**< Heap sort */ + typedef enum + { + ARM_SORT_BITONIC = 0, + /**< Bitonic sort */ + ARM_SORT_BUBBLE = 1, + /**< Bubble sort */ + ARM_SORT_HEAP = 2, + /**< Heap sort */ ARM_SORT_INSERTION = 3, - /**< Insertion sort */ - ARM_SORT_QUICK = 4, - /**< Quick sort */ + /**< Insertion sort */ + ARM_SORT_QUICK = 4, + /**< Quick sort */ ARM_SORT_SELECTION = 5 - /**< Selection sort */ -} arm_sort_alg; + /**< Selection sort */ + } arm_sort_alg; -/** + /** * @brief Struct for specifying sorting algorithm */ -typedef enum { + typedef enum + { ARM_SORT_DESCENDING = 0, - /**< Descending order (9 to 0) */ + /**< Descending order (9 to 0) */ ARM_SORT_ASCENDING = 1 - /**< Ascending order (0 to 9) */ -} arm_sort_dir; + /**< Ascending order (0 to 9) */ + } arm_sort_dir; -/** + /** * @brief Instance structure for the sorting algorithms. */ -typedef struct { - arm_sort_alg alg; /**< Sorting algorithm selected */ - arm_sort_dir dir; /**< Sorting order (direction) */ -} arm_sort_instance_f32; + typedef struct + { + arm_sort_alg alg; /**< Sorting algorithm selected */ + arm_sort_dir dir; /**< Sorting order (direction) */ + } arm_sort_instance_f32; -/** + /** * @param[in] S points to an instance of the sorting structure. * @param[in] pSrc points to the block of input data. * @param[out] pDst points to the block of output data. * @param[in] blockSize number of samples to process. */ -void arm_sort_f32(const arm_sort_instance_f32 *S, float32_t *pSrc, float32_t *pDst, - uint32_t blockSize); + void arm_sort_f32( + const arm_sort_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); -/** + /** * @param[in,out] S points to an instance of the sorting structure. * @param[in] alg Selected algorithm. * @param[in] dir Sorting order. */ -void arm_sort_init_f32(arm_sort_instance_f32 *S, arm_sort_alg alg, arm_sort_dir dir); + void arm_sort_init_f32( + arm_sort_instance_f32 * S, + arm_sort_alg alg, + arm_sort_dir dir); -/** + /** * @brief Instance structure for the sorting algorithms. */ -typedef struct { - arm_sort_dir dir; /**< Sorting order (direction) */ - float32_t *buffer; /**< Working buffer */ -} arm_merge_sort_instance_f32; + typedef struct + { + arm_sort_dir dir; /**< Sorting order (direction) */ + float32_t * buffer; /**< Working buffer */ + } arm_merge_sort_instance_f32; -/** + /** * @param[in] S points to an instance of the sorting structure. * @param[in,out] pSrc points to the block of input data. * @param[out] pDst points to the block of output data * @param[in] blockSize number of samples to process. */ -void arm_merge_sort_f32(const arm_merge_sort_instance_f32 *S, float32_t *pSrc, float32_t *pDst, - uint32_t blockSize); + void arm_merge_sort_f32( + const arm_merge_sort_instance_f32 * S, + float32_t *pSrc, + float32_t *pDst, + uint32_t blockSize); -/** + /** * @param[in,out] S points to an instance of the sorting structure. * @param[in] dir Sorting order. * @param[in] buffer Working buffer. */ -void arm_merge_sort_init_f32(arm_merge_sort_instance_f32 *S, arm_sort_dir dir, float32_t *buffer); - -/** + void arm_merge_sort_init_f32( + arm_merge_sort_instance_f32 * S, + arm_sort_dir dir, + float32_t * buffer); + + + + /** * @brief Copies the elements of a floating-point vector. * @param[in] pSrc input pointer * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_copy_f32(const float32_t *pSrc, float32_t *pDst, uint32_t blockSize); - -/** + void arm_copy_f32( + const float32_t * pSrc, + float32_t * pDst, + uint32_t blockSize); + + + + /** * @brief Copies the elements of a floating-point vector. * @param[in] pSrc input pointer * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_copy_f64(const float64_t *pSrc, float64_t *pDst, uint32_t blockSize); + void arm_copy_f64( + const float64_t * pSrc, + float64_t * pDst, + uint32_t blockSize); -/** + + + /** * @brief Copies the elements of a Q7 vector. * @param[in] pSrc input pointer * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_copy_q7(const q7_t *pSrc, q7_t *pDst, uint32_t blockSize); + void arm_copy_q7( + const q7_t * pSrc, + q7_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Copies the elements of a Q15 vector. * @param[in] pSrc input pointer * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_copy_q15(const q15_t *pSrc, q15_t *pDst, uint32_t blockSize); + void arm_copy_q15( + const q15_t * pSrc, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Copies the elements of a Q31 vector. * @param[in] pSrc input pointer * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_copy_q31(const q31_t *pSrc, q31_t *pDst, uint32_t blockSize); + void arm_copy_q31( + const q31_t * pSrc, + q31_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Fills a constant value into a floating-point vector. * @param[in] value input value to be filled * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_fill_f32(float32_t value, float32_t *pDst, uint32_t blockSize); + void arm_fill_f32( + float32_t value, + float32_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Fills a constant value into a floating-point vector. * @param[in] value input value to be filled * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_fill_f64(float64_t value, float64_t *pDst, uint32_t blockSize); + void arm_fill_f64( + float64_t value, + float64_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Fills a constant value into a Q7 vector. * @param[in] value input value to be filled * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_fill_q7(q7_t value, q7_t *pDst, uint32_t blockSize); + void arm_fill_q7( + q7_t value, + q7_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Fills a constant value into a Q15 vector. * @param[in] value input value to be filled * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_fill_q15(q15_t value, q15_t *pDst, uint32_t blockSize); + void arm_fill_q15( + q15_t value, + q15_t * pDst, + uint32_t blockSize); -/** + + /** * @brief Fills a constant value into a Q31 vector. * @param[in] value input value to be filled * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_fill_q31(q31_t value, q31_t *pDst, uint32_t blockSize); + void arm_fill_q31( + q31_t value, + q31_t * pDst, + uint32_t blockSize); + + + + + + /** - * @brief Weighted sum + * @brief Weighted average * * * @param[in] *in Array of input values. * @param[in] *weigths Weights * @param[in] blockSize Number of samples in the input array. - * @return Weighted sum + * @return Weighted average * */ -float32_t arm_weighted_sum_f32(const float32_t *in, const float32_t *weigths, uint32_t blockSize); +float32_t arm_weighted_average_f32(const float32_t *in + , const float32_t *weigths + , uint32_t blockSize); + /** * @brief Barycenter @@ -313,13 +522,17 @@ float32_t arm_weighted_sum_f32(const float32_t *in, const float32_t *weigths, ui * @param[out] out Barycenter * @param[in] nbVectors Number of vectors * @param[in] vecDim Dimension of space (vector dimension) - * @return None * */ -void arm_barycenter_f32(const float32_t *in, const float32_t *weights, float32_t *out, - uint32_t nbVectors, uint32_t vecDim); +void arm_barycenter_f32(const float32_t *in + , const float32_t *weights + , float32_t *out + , uint32_t nbVectors + , uint32_t vecDim); + + -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions_f16.h old mode 100644 new mode 100755 index 1af398b219a..ab0c1ad7a90 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions_f16.h @@ -1,8 +1,8 @@ /****************************************************************************** * @file support_functions_f16.h * @brief Public header file for CMSIS DSP Library - * @version V1.10.0 - * @date 08 July 2021 + * @version V1.10.1 + * @date 18 August 2022 * Target Processor: Cortex-M and Cortex-A cores ******************************************************************************/ /* @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _SUPPORT_FUNCTIONS_F16_H_ -#define _SUPPORT_FUNCTIONS_F16_H_ + +#ifndef SUPPORT_FUNCTIONS_F16_H_ +#define SUPPORT_FUNCTIONS_F16_H_ #include "arm_math_types_f16.h" #include "arm_math_memory.h" @@ -32,27 +33,30 @@ #include "dsp/none.h" #include "dsp/utils.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #if defined(ARM_FLOAT16_SUPPORTED) -/** + /** * @brief Copies the elements of a floating-point vector. * @param[in] pSrc input pointer * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_copy_f16(const float16_t *pSrc, float16_t *pDst, uint32_t blockSize); +void arm_copy_f16(const float16_t * pSrc, float16_t * pDst, uint32_t blockSize); -/** + + /** * @brief Fills a constant value into a floating-point vector. * @param[in] value input value to be filled * @param[out] pDst output pointer * @param[in] blockSize number of samples to process */ -void arm_fill_f16(float16_t value, float16_t *pDst, uint32_t blockSize); +void arm_fill_f16(float16_t value, float16_t * pDst, uint32_t blockSize); + /** * @brief Converts the elements of the floating-point vector to Q31 vector. @@ -60,7 +64,8 @@ void arm_fill_f16(float16_t value, float16_t *pDst, uint32_t blockSize); * @param[out] pDst points to the q15 output vector * @param[in] blockSize length of the input vector */ -void arm_f16_to_q15(const float16_t *pSrc, q15_t *pDst, uint32_t blockSize); +void arm_f16_to_q15(const float16_t * pSrc, q15_t * pDst, uint32_t blockSize); + /** * @brief Converts the elements of the floating-point vector to Q31 vector. @@ -68,7 +73,26 @@ void arm_f16_to_q15(const float16_t *pSrc, q15_t *pDst, uint32_t blockSize); * @param[out] pDst points to the f16 output vector * @param[in] blockSize length of the input vector */ -void arm_q15_to_f16(const q15_t *pSrc, float16_t *pDst, uint32_t blockSize); +void arm_q15_to_f16(const q15_t * pSrc, float16_t * pDst, uint32_t blockSize); + + +/** + * @brief Converts the elements of the 64 bit floating-point vector to 16 bit floating-point vector. + * @param[in] pSrc points to the f64 input vector + * @param[out] pDst points to the f16 output vector + * @param[in] blockSize length of the input vector + */ +void arm_f64_to_f16(const float64_t * pSrc, float16_t * pDst, uint32_t blockSize); + + +/** + * @brief Converts the elements of the 16 bit floating-point vector to 64 bit floating-point vector. + * @param[in] pSrc points to the f16 input vector + * @param[out] pDst points to the f64 output vector + * @param[in] blockSize length of the input vector + */ +void arm_f16_to_f64(const float16_t * pSrc, float64_t * pDst, uint32_t blockSize); + /** * @brief Converts the elements of the floating-point vector to Q31 vector. @@ -76,7 +100,8 @@ void arm_q15_to_f16(const q15_t *pSrc, float16_t *pDst, uint32_t blockSize); * @param[out] pDst points to the f16 output vector * @param[in] blockSize length of the input vector */ -void arm_float_to_f16(const float32_t *pSrc, float16_t *pDst, uint32_t blockSize); +void arm_float_to_f16(const float32_t * pSrc, float16_t * pDst, uint32_t blockSize); + /** * @brief Converts the elements of the floating-point vector to Q31 vector. @@ -84,34 +109,35 @@ void arm_float_to_f16(const float32_t *pSrc, float16_t *pDst, uint32_t blockSize * @param[out] pDst points to the f32 output vector * @param[in] blockSize length of the input vector */ -void arm_f16_to_float(const float16_t *pSrc, float32_t *pDst, uint32_t blockSize); +void arm_f16_to_float(const float16_t * pSrc, float32_t * pDst, uint32_t blockSize); + /** - * @brief Weighted sum - * - * + * @brief Weighted average * @param[in] *in Array of input values. * @param[in] *weigths Weights * @param[in] blockSize Number of samples in the input array. - * @return Weighted sum - * + * @return Weighted average */ -float16_t arm_weighted_sum_f16(const float16_t *in, const float16_t *weigths, uint32_t blockSize); +float16_t arm_weighted_average_f16(const float16_t *in + , const float16_t *weigths + , uint32_t blockSize); + /** * @brief Barycenter - * - * * @param[in] in List of vectors * @param[in] weights Weights of the vectors * @param[out] out Barycenter * @param[in] nbVectors Number of vectors * @param[in] vecDim Dimension of space (vector dimension) - * @return None - * */ -void arm_barycenter_f16(const float16_t *in, const float16_t *weights, float16_t *out, - uint32_t nbVectors, uint32_t vecDim); +void arm_barycenter_f16(const float16_t *in + , const float16_t *weights + , float16_t *out + , uint32_t nbVectors + , uint32_t vecDim); + /** @ingroup groupSupport @@ -140,9 +166,9 @@ void arm_barycenter_f16(const float16_t *in, const float16_t *weights, float16_t */ __STATIC_INLINE int16_t arm_typecast_s16_f16(float16_t x) { - int16_t res; - res = *(int16_t *)memcpy((char *)&res, (char *)&x, sizeof(float16_t)); - return (res); + int16_t res; + res=*(int16_t*)memcpy((char*)&res,(char*)&x,sizeof(float16_t)); + return(res); } /** @@ -159,17 +185,19 @@ __STATIC_INLINE int16_t arm_typecast_s16_f16(float16_t x) */ __STATIC_INLINE float16_t arm_typecast_f16_s16(int16_t x) { - float16_t res; - res = *(float16_t *)memcpy((char *)&res, (char *)&x, sizeof(int16_t)); - return (res); + float16_t res; + res=*(float16_t*)memcpy((char*)&res,(char*)&x,sizeof(int16_t)); + return(res); } + /** @} end of typecast group */ + #endif /*defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_defines.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_defines.h old mode 100644 new mode 100755 index 3aa2de03be5..185a8a902c9 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_defines.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_defines.h @@ -24,21 +24,23 @@ * limitations under the License. */ -#ifndef _SVM_DEFINES_H_ -#define _SVM_DEFINES_H_ + +#ifndef SVM_DEFINES_H_ +#define SVM_DEFINES_H_ /** * @brief Struct for specifying SVM Kernel */ -typedef enum { +typedef enum +{ ARM_ML_KERNEL_LINEAR = 0, - /**< Linear kernel */ + /**< Linear kernel */ ARM_ML_KERNEL_POLYNOMIAL = 1, - /**< Polynomial kernel */ + /**< Polynomial kernel */ ARM_ML_KERNEL_RBF = 2, - /**< Radial Basis Function kernel */ + /**< Radial Basis Function kernel */ ARM_ML_KERNEL_SIGMOID = 3 - /**< Sigmoid kernel */ + /**< Sigmoid kernel */ } arm_ml_kernel_type; #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions.h old mode 100644 new mode 100755 index 91149b4a46d..cb00cd4f1b3 --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _SVM_FUNCTIONS_H_ -#define _SVM_FUNCTIONS_H_ + +#ifndef SVM_FUNCTIONS_H_ +#define SVM_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -33,8 +34,9 @@ #include "dsp/utils.h" #include "dsp/svm_defines.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif #define STEP(x) (x) <= 0 ? 0 : 1 @@ -58,73 +60,82 @@ extern "C" { * @param[in] x value * @param[in] nb integer exponent >= 1 * @return x^nb - * */ __STATIC_INLINE float32_t arm_exponent_f32(float32_t x, int32_t nb) { float32_t r = x; - nb--; - while (nb > 0) { + nb --; + while(nb > 0) + { r = r * x; nb--; } - return (r); + return(r); } + /** * @brief Instance structure for linear SVM prediction function. */ -typedef struct { - uint32_t nbOfSupportVectors; /**< Number of support vectors */ - uint32_t vectorDimension; /**< Dimension of vector space */ - float32_t intercept; /**< Intercept */ - const float32_t *dualCoefficients; /**< Dual coefficients */ - const float32_t *supportVectors; /**< Support vectors */ - const int32_t *classes; /**< The two SVM classes */ +typedef struct +{ + uint32_t nbOfSupportVectors; /**< Number of support vectors */ + uint32_t vectorDimension; /**< Dimension of vector space */ + float32_t intercept; /**< Intercept */ + const float32_t *dualCoefficients; /**< Dual coefficients */ + const float32_t *supportVectors; /**< Support vectors */ + const int32_t *classes; /**< The two SVM classes */ } arm_svm_linear_instance_f32; + /** * @brief Instance structure for polynomial SVM prediction function. */ -typedef struct { - uint32_t nbOfSupportVectors; /**< Number of support vectors */ - uint32_t vectorDimension; /**< Dimension of vector space */ - float32_t intercept; /**< Intercept */ - const float32_t *dualCoefficients; /**< Dual coefficients */ - const float32_t *supportVectors; /**< Support vectors */ - const int32_t *classes; /**< The two SVM classes */ - int32_t degree; /**< Polynomial degree */ - float32_t coef0; /**< Polynomial constant */ - float32_t gamma; /**< Gamma factor */ +typedef struct +{ + uint32_t nbOfSupportVectors; /**< Number of support vectors */ + uint32_t vectorDimension; /**< Dimension of vector space */ + float32_t intercept; /**< Intercept */ + const float32_t *dualCoefficients; /**< Dual coefficients */ + const float32_t *supportVectors; /**< Support vectors */ + const int32_t *classes; /**< The two SVM classes */ + int32_t degree; /**< Polynomial degree */ + float32_t coef0; /**< Polynomial constant */ + float32_t gamma; /**< Gamma factor */ } arm_svm_polynomial_instance_f32; + /** * @brief Instance structure for rbf SVM prediction function. */ -typedef struct { - uint32_t nbOfSupportVectors; /**< Number of support vectors */ - uint32_t vectorDimension; /**< Dimension of vector space */ - float32_t intercept; /**< Intercept */ - const float32_t *dualCoefficients; /**< Dual coefficients */ - const float32_t *supportVectors; /**< Support vectors */ - const int32_t *classes; /**< The two SVM classes */ - float32_t gamma; /**< Gamma factor */ +typedef struct +{ + uint32_t nbOfSupportVectors; /**< Number of support vectors */ + uint32_t vectorDimension; /**< Dimension of vector space */ + float32_t intercept; /**< Intercept */ + const float32_t *dualCoefficients; /**< Dual coefficients */ + const float32_t *supportVectors; /**< Support vectors */ + const int32_t *classes; /**< The two SVM classes */ + float32_t gamma; /**< Gamma factor */ } arm_svm_rbf_instance_f32; + /** * @brief Instance structure for sigmoid SVM prediction function. */ -typedef struct { - uint32_t nbOfSupportVectors; /**< Number of support vectors */ - uint32_t vectorDimension; /**< Dimension of vector space */ - float32_t intercept; /**< Intercept */ - const float32_t *dualCoefficients; /**< Dual coefficients */ - const float32_t *supportVectors; /**< Support vectors */ - const int32_t *classes; /**< The two SVM classes */ - float32_t coef0; /**< Independent constant */ - float32_t gamma; /**< Gamma factor */ +typedef struct +{ + uint32_t nbOfSupportVectors; /**< Number of support vectors */ + uint32_t vectorDimension; /**< Dimension of vector space */ + float32_t intercept; /**< Intercept */ + const float32_t *dualCoefficients; /**< Dual coefficients */ + const float32_t *supportVectors; /**< Support vectors */ + const int32_t *classes; /**< The two SVM classes */ + float32_t coef0; /**< Independent constant */ + float32_t gamma; /**< Gamma factor */ } arm_svm_sigmoid_instance_f32; + /** * @brief SVM linear instance init function * @param[in] S Parameters for SVM functions @@ -134,26 +145,26 @@ typedef struct { * @param[in] dualCoefficients Array of dual coefficients * @param[in] supportVectors Array of support vectors * @param[in] classes Array of 2 classes ID - * @return none. - * */ +void arm_svm_linear_init_f32(arm_svm_linear_instance_f32 *S, + uint32_t nbOfSupportVectors, + uint32_t vectorDimension, + float32_t intercept, + const float32_t *dualCoefficients, + const float32_t *supportVectors, + const int32_t *classes); -void arm_svm_linear_init_f32(arm_svm_linear_instance_f32 *S, uint32_t nbOfSupportVectors, - uint32_t vectorDimension, float32_t intercept, - const float32_t *dualCoefficients, const float32_t *supportVectors, - const int32_t *classes); /** * @brief SVM linear prediction * @param[in] S Pointer to an instance of the linear SVM structure. * @param[in] in Pointer to input vector * @param[out] pResult Decision value - * @return none. - * */ +void arm_svm_linear_predict_f32(const arm_svm_linear_instance_f32 *S, + const float32_t * in, + int32_t * pResult); -void arm_svm_linear_predict_f32(const arm_svm_linear_instance_f32 *S, const float32_t *in, - int32_t *pResult); /** * @brief SVM polynomial instance init function @@ -167,26 +178,30 @@ void arm_svm_linear_predict_f32(const arm_svm_linear_instance_f32 *S, const floa * @param[in] degree Polynomial degree * @param[in] coef0 coeff0 (scikit-learn terminology) * @param[in] gamma gamma (scikit-learn terminology) - * @return none. - * */ +void arm_svm_polynomial_init_f32(arm_svm_polynomial_instance_f32 *S, + uint32_t nbOfSupportVectors, + uint32_t vectorDimension, + float32_t intercept, + const float32_t *dualCoefficients, + const float32_t *supportVectors, + const int32_t *classes, + int32_t degree, + float32_t coef0, + float32_t gamma + ); -void arm_svm_polynomial_init_f32(arm_svm_polynomial_instance_f32 *S, uint32_t nbOfSupportVectors, - uint32_t vectorDimension, float32_t intercept, - const float32_t *dualCoefficients, const float32_t *supportVectors, - const int32_t *classes, int32_t degree, float32_t coef0, - float32_t gamma); /** * @brief SVM polynomial prediction * @param[in] S Pointer to an instance of the polynomial SVM structure. * @param[in] in Pointer to input vector * @param[out] pResult Decision value - * @return none. - * */ -void arm_svm_polynomial_predict_f32(const arm_svm_polynomial_instance_f32 *S, const float32_t *in, - int32_t *pResult); +void arm_svm_polynomial_predict_f32(const arm_svm_polynomial_instance_f32 *S, + const float32_t * in, + int32_t * pResult); + /** * @brief SVM radial basis function instance init function @@ -198,25 +213,28 @@ void arm_svm_polynomial_predict_f32(const arm_svm_polynomial_instance_f32 *S, co * @param[in] supportVectors Array of support vectors * @param[in] classes Array of 2 classes ID * @param[in] gamma gamma (scikit-learn terminology) - * @return none. - * */ +void arm_svm_rbf_init_f32(arm_svm_rbf_instance_f32 *S, + uint32_t nbOfSupportVectors, + uint32_t vectorDimension, + float32_t intercept, + const float32_t *dualCoefficients, + const float32_t *supportVectors, + const int32_t *classes, + float32_t gamma + ); -void arm_svm_rbf_init_f32(arm_svm_rbf_instance_f32 *S, uint32_t nbOfSupportVectors, - uint32_t vectorDimension, float32_t intercept, - const float32_t *dualCoefficients, const float32_t *supportVectors, - const int32_t *classes, float32_t gamma); /** * @brief SVM rbf prediction * @param[in] S Pointer to an instance of the rbf SVM structure. * @param[in] in Pointer to input vector * @param[out] pResult decision value - * @return none. - * */ -void arm_svm_rbf_predict_f32(const arm_svm_rbf_instance_f32 *S, const float32_t *in, - int32_t *pResult); +void arm_svm_rbf_predict_f32(const arm_svm_rbf_instance_f32 *S, + const float32_t * in, + int32_t * pResult); + /** * @brief SVM sigmoid instance init function @@ -229,27 +247,33 @@ void arm_svm_rbf_predict_f32(const arm_svm_rbf_instance_f32 *S, const float32_t * @param[in] classes Array of 2 classes ID * @param[in] coef0 coeff0 (scikit-learn terminology) * @param[in] gamma gamma (scikit-learn terminology) - * @return none. - * */ +void arm_svm_sigmoid_init_f32(arm_svm_sigmoid_instance_f32 *S, + uint32_t nbOfSupportVectors, + uint32_t vectorDimension, + float32_t intercept, + const float32_t *dualCoefficients, + const float32_t *supportVectors, + const int32_t *classes, + float32_t coef0, + float32_t gamma + ); -void arm_svm_sigmoid_init_f32(arm_svm_sigmoid_instance_f32 *S, uint32_t nbOfSupportVectors, - uint32_t vectorDimension, float32_t intercept, - const float32_t *dualCoefficients, const float32_t *supportVectors, - const int32_t *classes, float32_t coef0, float32_t gamma); /** * @brief SVM sigmoid prediction * @param[in] S Pointer to an instance of the rbf SVM structure. * @param[in] in Pointer to input vector * @param[out] pResult Decision value - * @return none. - * */ -void arm_svm_sigmoid_predict_f32(const arm_svm_sigmoid_instance_f32 *S, const float32_t *in, - int32_t *pResult); +void arm_svm_sigmoid_predict_f32(const arm_svm_sigmoid_instance_f32 *S, + const float32_t * in, + int32_t * pResult); + + + -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions_f16.h old mode 100644 new mode 100755 index 6c916d86065..5f757a0a10d --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions_f16.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _SVM_FUNCTIONS_F16_H_ -#define _SVM_FUNCTIONS_F16_H_ + +#ifndef SVM_FUNCTIONS_F16_H_ +#define SVM_FUNCTIONS_F16_H_ #include "arm_math_types_f16.h" #include "arm_math_memory.h" @@ -33,8 +34,10 @@ #include "dsp/utils.h" #include "dsp/svm_defines.h" -#ifdef __cplusplus -extern "C" { + +#ifdef __cplusplus +extern "C" +{ #endif #if defined(ARM_FLOAT16_SUPPORTED) @@ -55,60 +58,70 @@ extern "C" { * */ + + /** * @brief Instance structure for linear SVM prediction function. */ -typedef struct { - uint32_t nbOfSupportVectors; /**< Number of support vectors */ - uint32_t vectorDimension; /**< Dimension of vector space */ - float16_t intercept; /**< Intercept */ - const float16_t *dualCoefficients; /**< Dual coefficients */ - const float16_t *supportVectors; /**< Support vectors */ - const int32_t *classes; /**< The two SVM classes */ +typedef struct +{ + uint32_t nbOfSupportVectors; /**< Number of support vectors */ + uint32_t vectorDimension; /**< Dimension of vector space */ + float16_t intercept; /**< Intercept */ + const float16_t *dualCoefficients; /**< Dual coefficients */ + const float16_t *supportVectors; /**< Support vectors */ + const int32_t *classes; /**< The two SVM classes */ } arm_svm_linear_instance_f16; + /** * @brief Instance structure for polynomial SVM prediction function. */ -typedef struct { - uint32_t nbOfSupportVectors; /**< Number of support vectors */ - uint32_t vectorDimension; /**< Dimension of vector space */ - float16_t intercept; /**< Intercept */ - const float16_t *dualCoefficients; /**< Dual coefficients */ - const float16_t *supportVectors; /**< Support vectors */ - const int32_t *classes; /**< The two SVM classes */ - int32_t degree; /**< Polynomial degree */ - float16_t coef0; /**< Polynomial constant */ - float16_t gamma; /**< Gamma factor */ +typedef struct +{ + uint32_t nbOfSupportVectors; /**< Number of support vectors */ + uint32_t vectorDimension; /**< Dimension of vector space */ + float16_t intercept; /**< Intercept */ + const float16_t *dualCoefficients; /**< Dual coefficients */ + const float16_t *supportVectors; /**< Support vectors */ + const int32_t *classes; /**< The two SVM classes */ + int32_t degree; /**< Polynomial degree */ + float16_t coef0; /**< Polynomial constant */ + float16_t gamma; /**< Gamma factor */ } arm_svm_polynomial_instance_f16; + /** * @brief Instance structure for rbf SVM prediction function. */ -typedef struct { - uint32_t nbOfSupportVectors; /**< Number of support vectors */ - uint32_t vectorDimension; /**< Dimension of vector space */ - float16_t intercept; /**< Intercept */ - const float16_t *dualCoefficients; /**< Dual coefficients */ - const float16_t *supportVectors; /**< Support vectors */ - const int32_t *classes; /**< The two SVM classes */ - float16_t gamma; /**< Gamma factor */ +typedef struct +{ + uint32_t nbOfSupportVectors; /**< Number of support vectors */ + uint32_t vectorDimension; /**< Dimension of vector space */ + float16_t intercept; /**< Intercept */ + const float16_t *dualCoefficients; /**< Dual coefficients */ + const float16_t *supportVectors; /**< Support vectors */ + const int32_t *classes; /**< The two SVM classes */ + float16_t gamma; /**< Gamma factor */ } arm_svm_rbf_instance_f16; + /** * @brief Instance structure for sigmoid SVM prediction function. */ -typedef struct { - uint32_t nbOfSupportVectors; /**< Number of support vectors */ - uint32_t vectorDimension; /**< Dimension of vector space */ - float16_t intercept; /**< Intercept */ - const float16_t *dualCoefficients; /**< Dual coefficients */ - const float16_t *supportVectors; /**< Support vectors */ - const int32_t *classes; /**< The two SVM classes */ - float16_t coef0; /**< Independent constant */ - float16_t gamma; /**< Gamma factor */ +typedef struct +{ + uint32_t nbOfSupportVectors; /**< Number of support vectors */ + uint32_t vectorDimension; /**< Dimension of vector space */ + float16_t intercept; /**< Intercept */ + const float16_t *dualCoefficients; /**< Dual coefficients */ + const float16_t *supportVectors; /**< Support vectors */ + const int32_t *classes; /**< The two SVM classes */ + float16_t coef0; /**< Independent constant */ + float16_t gamma; /**< Gamma factor */ } arm_svm_sigmoid_instance_f16; + /** * @brief SVM linear instance init function * @param[in] S Parameters for SVM functions @@ -118,26 +131,25 @@ typedef struct { * @param[in] dualCoefficients Array of dual coefficients * @param[in] supportVectors Array of support vectors * @param[in] classes Array of 2 classes ID - * @return none. - * */ - -void arm_svm_linear_init_f16(arm_svm_linear_instance_f16 *S, uint32_t nbOfSupportVectors, - uint32_t vectorDimension, float16_t intercept, - const float16_t *dualCoefficients, const float16_t *supportVectors, - const int32_t *classes); +void arm_svm_linear_init_f16(arm_svm_linear_instance_f16 *S, + uint32_t nbOfSupportVectors, + uint32_t vectorDimension, + float16_t intercept, + const float16_t *dualCoefficients, + const float16_t *supportVectors, + const int32_t *classes); /** * @brief SVM linear prediction * @param[in] S Pointer to an instance of the linear SVM structure. * @param[in] in Pointer to input vector * @param[out] pResult Decision value - * @return none. - * */ +void arm_svm_linear_predict_f16(const arm_svm_linear_instance_f16 *S, + const float16_t * in, + int32_t * pResult); -void arm_svm_linear_predict_f16(const arm_svm_linear_instance_f16 *S, const float16_t *in, - int32_t *pResult); /** * @brief SVM polynomial instance init function @@ -151,26 +163,30 @@ void arm_svm_linear_predict_f16(const arm_svm_linear_instance_f16 *S, const floa * @param[in] degree Polynomial degree * @param[in] coef0 coeff0 (scikit-learn terminology) * @param[in] gamma gamma (scikit-learn terminology) - * @return none. - * */ +void arm_svm_polynomial_init_f16(arm_svm_polynomial_instance_f16 *S, + uint32_t nbOfSupportVectors, + uint32_t vectorDimension, + float16_t intercept, + const float16_t *dualCoefficients, + const float16_t *supportVectors, + const int32_t *classes, + int32_t degree, + float16_t coef0, + float16_t gamma + ); -void arm_svm_polynomial_init_f16(arm_svm_polynomial_instance_f16 *S, uint32_t nbOfSupportVectors, - uint32_t vectorDimension, float16_t intercept, - const float16_t *dualCoefficients, const float16_t *supportVectors, - const int32_t *classes, int32_t degree, float16_t coef0, - float16_t gamma); /** * @brief SVM polynomial prediction * @param[in] S Pointer to an instance of the polynomial SVM structure. * @param[in] in Pointer to input vector * @param[out] pResult Decision value - * @return none. - * */ -void arm_svm_polynomial_predict_f16(const arm_svm_polynomial_instance_f16 *S, const float16_t *in, - int32_t *pResult); +void arm_svm_polynomial_predict_f16(const arm_svm_polynomial_instance_f16 *S, + const float16_t * in, + int32_t * pResult); + /** * @brief SVM radial basis function instance init function @@ -182,25 +198,28 @@ void arm_svm_polynomial_predict_f16(const arm_svm_polynomial_instance_f16 *S, co * @param[in] supportVectors Array of support vectors * @param[in] classes Array of 2 classes ID * @param[in] gamma gamma (scikit-learn terminology) - * @return none. - * */ +void arm_svm_rbf_init_f16(arm_svm_rbf_instance_f16 *S, + uint32_t nbOfSupportVectors, + uint32_t vectorDimension, + float16_t intercept, + const float16_t *dualCoefficients, + const float16_t *supportVectors, + const int32_t *classes, + float16_t gamma + ); -void arm_svm_rbf_init_f16(arm_svm_rbf_instance_f16 *S, uint32_t nbOfSupportVectors, - uint32_t vectorDimension, float16_t intercept, - const float16_t *dualCoefficients, const float16_t *supportVectors, - const int32_t *classes, float16_t gamma); /** * @brief SVM rbf prediction * @param[in] S Pointer to an instance of the rbf SVM structure. * @param[in] in Pointer to input vector * @param[out] pResult decision value - * @return none. - * */ -void arm_svm_rbf_predict_f16(const arm_svm_rbf_instance_f16 *S, const float16_t *in, - int32_t *pResult); +void arm_svm_rbf_predict_f16(const arm_svm_rbf_instance_f16 *S, + const float16_t * in, + int32_t * pResult); + /** * @brief SVM sigmoid instance init function @@ -213,28 +232,33 @@ void arm_svm_rbf_predict_f16(const arm_svm_rbf_instance_f16 *S, const float16_t * @param[in] classes Array of 2 classes ID * @param[in] coef0 coeff0 (scikit-learn terminology) * @param[in] gamma gamma (scikit-learn terminology) - * @return none. - * */ +void arm_svm_sigmoid_init_f16(arm_svm_sigmoid_instance_f16 *S, + uint32_t nbOfSupportVectors, + uint32_t vectorDimension, + float16_t intercept, + const float16_t *dualCoefficients, + const float16_t *supportVectors, + const int32_t *classes, + float16_t coef0, + float16_t gamma + ); -void arm_svm_sigmoid_init_f16(arm_svm_sigmoid_instance_f16 *S, uint32_t nbOfSupportVectors, - uint32_t vectorDimension, float16_t intercept, - const float16_t *dualCoefficients, const float16_t *supportVectors, - const int32_t *classes, float16_t coef0, float16_t gamma); /** * @brief SVM sigmoid prediction * @param[in] S Pointer to an instance of the rbf SVM structure. * @param[in] in Pointer to input vector * @param[out] pResult Decision value - * @return none. - * */ -void arm_svm_sigmoid_predict_f16(const arm_svm_sigmoid_instance_f16 *S, const float16_t *in, - int32_t *pResult); +void arm_svm_sigmoid_predict_f16(const arm_svm_sigmoid_instance_f16 *S, + const float16_t * in, + int32_t * pResult); + + #endif /*defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions.h old mode 100644 new mode 100755 index cef55bda62e..b2c13d9dfcf --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _TRANSFORM_FUNCTIONS_H_ -#define _TRANSFORM_FUNCTIONS_H_ + +#ifndef TRANSFORM_FUNCTIONS_H_ +#define TRANSFORM_FUNCTIONS_H_ #include "arm_math_types.h" #include "arm_math_memory.h" @@ -35,367 +36,579 @@ #include "dsp/basic_math_functions.h" #include "dsp/complex_math_functions.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif + /** * @defgroup groupTransforms Transform Functions */ -/** + + /** * @brief Instance structure for the Q15 CFFT/CIFFT function. */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - uint8_t - ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ - uint8_t - bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ - const q15_t *pTwiddle; /**< points to the Sin twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t - twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ - uint16_t - bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ -} arm_cfft_radix2_instance_q15; + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + const q15_t *pTwiddle; /**< points to the Sin twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + } arm_cfft_radix2_instance_q15; /* Deprecated */ -arm_status arm_cfft_radix2_init_q15(arm_cfft_radix2_instance_q15 *S, uint16_t fftLen, - uint8_t ifftFlag, uint8_t bitReverseFlag); + arm_status arm_cfft_radix2_init_q15( + arm_cfft_radix2_instance_q15 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); /* Deprecated */ -void arm_cfft_radix2_q15(const arm_cfft_radix2_instance_q15 *S, q15_t *pSrc); + void arm_cfft_radix2_q15( + const arm_cfft_radix2_instance_q15 * S, + q15_t * pSrc); -/** + + /** * @brief Instance structure for the Q15 CFFT/CIFFT function. */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - uint8_t - ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ - uint8_t - bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ - const q15_t *pTwiddle; /**< points to the twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t - twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ - uint16_t - bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ -} arm_cfft_radix4_instance_q15; + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + const q15_t *pTwiddle; /**< points to the twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + } arm_cfft_radix4_instance_q15; /* Deprecated */ -arm_status arm_cfft_radix4_init_q15(arm_cfft_radix4_instance_q15 *S, uint16_t fftLen, - uint8_t ifftFlag, uint8_t bitReverseFlag); + arm_status arm_cfft_radix4_init_q15( + arm_cfft_radix4_instance_q15 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); /* Deprecated */ -void arm_cfft_radix4_q15(const arm_cfft_radix4_instance_q15 *S, q15_t *pSrc); + void arm_cfft_radix4_q15( + const arm_cfft_radix4_instance_q15 * S, + q15_t * pSrc); -/** + /** * @brief Instance structure for the Radix-2 Q31 CFFT/CIFFT function. */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - uint8_t - ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ - uint8_t - bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ - const q31_t *pTwiddle; /**< points to the Twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t - twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ - uint16_t - bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ -} arm_cfft_radix2_instance_q31; + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + const q31_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + } arm_cfft_radix2_instance_q31; /* Deprecated */ -arm_status arm_cfft_radix2_init_q31(arm_cfft_radix2_instance_q31 *S, uint16_t fftLen, - uint8_t ifftFlag, uint8_t bitReverseFlag); + arm_status arm_cfft_radix2_init_q31( + arm_cfft_radix2_instance_q31 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); /* Deprecated */ -void arm_cfft_radix2_q31(const arm_cfft_radix2_instance_q31 *S, q31_t *pSrc); + void arm_cfft_radix2_q31( + const arm_cfft_radix2_instance_q31 * S, + q31_t * pSrc); -/** + /** * @brief Instance structure for the Q31 CFFT/CIFFT function. */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - uint8_t - ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ - uint8_t - bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ - const q31_t *pTwiddle; /**< points to the twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t - twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ - uint16_t - bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ -} arm_cfft_radix4_instance_q31; + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + const q31_t *pTwiddle; /**< points to the twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + } arm_cfft_radix4_instance_q31; /* Deprecated */ -void arm_cfft_radix4_q31(const arm_cfft_radix4_instance_q31 *S, q31_t *pSrc); + void arm_cfft_radix4_q31( + const arm_cfft_radix4_instance_q31 * S, + q31_t * pSrc); /* Deprecated */ -arm_status arm_cfft_radix4_init_q31(arm_cfft_radix4_instance_q31 *S, uint16_t fftLen, - uint8_t ifftFlag, uint8_t bitReverseFlag); + arm_status arm_cfft_radix4_init_q31( + arm_cfft_radix4_instance_q31 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); -/** + /** * @brief Instance structure for the floating-point CFFT/CIFFT function. */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - uint8_t - ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ - uint8_t - bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ - const float32_t *pTwiddle; /**< points to the Twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t - twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ - uint16_t - bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ - float32_t onebyfftLen; /**< value of 1/fftLen. */ -} arm_cfft_radix2_instance_f32; + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + const float32_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + float32_t onebyfftLen; /**< value of 1/fftLen. */ + } arm_cfft_radix2_instance_f32; + /* Deprecated */ -arm_status arm_cfft_radix2_init_f32(arm_cfft_radix2_instance_f32 *S, uint16_t fftLen, - uint8_t ifftFlag, uint8_t bitReverseFlag); + arm_status arm_cfft_radix2_init_f32( + arm_cfft_radix2_instance_f32 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); /* Deprecated */ -void arm_cfft_radix2_f32(const arm_cfft_radix2_instance_f32 *S, float32_t *pSrc); + void arm_cfft_radix2_f32( + const arm_cfft_radix2_instance_f32 * S, + float32_t * pSrc); -/** + /** * @brief Instance structure for the floating-point CFFT/CIFFT function. */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - uint8_t - ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ - uint8_t - bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ - const float32_t *pTwiddle; /**< points to the Twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t - twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ - uint16_t - bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ - float32_t onebyfftLen; /**< value of 1/fftLen. */ -} arm_cfft_radix4_instance_f32; + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + const float32_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + float32_t onebyfftLen; /**< value of 1/fftLen. */ + } arm_cfft_radix4_instance_f32; + + /* Deprecated */ -arm_status arm_cfft_radix4_init_f32(arm_cfft_radix4_instance_f32 *S, uint16_t fftLen, - uint8_t ifftFlag, uint8_t bitReverseFlag); + arm_status arm_cfft_radix4_init_f32( + arm_cfft_radix4_instance_f32 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); /* Deprecated */ -void arm_cfft_radix4_f32(const arm_cfft_radix4_instance_f32 *S, float32_t *pSrc); + void arm_cfft_radix4_f32( + const arm_cfft_radix4_instance_f32 * S, + float32_t * pSrc); -/** + /** * @brief Instance structure for the fixed-point CFFT/CIFFT function. */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - const q15_t *pTwiddle; /**< points to the Twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t bitRevLength; /**< bit reversal table length. */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + const q15_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t bitRevLength; /**< bit reversal table length. */ #if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE) - const uint32_t - *rearranged_twiddle_tab_stride1_arr; /**< Per stage reordered twiddle pointer (offset 1) */ - const uint32_t - *rearranged_twiddle_tab_stride2_arr; /**< Per stage reordered twiddle pointer (offset 2) */ - const uint32_t - *rearranged_twiddle_tab_stride3_arr; /**< Per stage reordered twiddle pointer (offset 3) */ - const q15_t *rearranged_twiddle_stride1; /**< reordered twiddle offset 1 storage */ - const q15_t *rearranged_twiddle_stride2; /**< reordered twiddle offset 2 storage */ - const q15_t *rearranged_twiddle_stride3; + const uint32_t *rearranged_twiddle_tab_stride1_arr; /**< Per stage reordered twiddle pointer (offset 1) */ \ + const uint32_t *rearranged_twiddle_tab_stride2_arr; /**< Per stage reordered twiddle pointer (offset 2) */ \ + const uint32_t *rearranged_twiddle_tab_stride3_arr; /**< Per stage reordered twiddle pointer (offset 3) */ \ + const q15_t *rearranged_twiddle_stride1; /**< reordered twiddle offset 1 storage */ \ + const q15_t *rearranged_twiddle_stride2; /**< reordered twiddle offset 2 storage */ \ + const q15_t *rearranged_twiddle_stride3; #endif -} arm_cfft_instance_q15; - -arm_status arm_cfft_init_q15(arm_cfft_instance_q15 *S, uint16_t fftLen); - -void arm_cfft_q15(const arm_cfft_instance_q15 *S, q15_t *p1, uint8_t ifftFlag, - uint8_t bitReverseFlag); - -/** + } arm_cfft_instance_q15; + +arm_status arm_cfft_init_4096_q15(arm_cfft_instance_q15 * S); +arm_status arm_cfft_init_2048_q15(arm_cfft_instance_q15 * S); +arm_status arm_cfft_init_1024_q15(arm_cfft_instance_q15 * S); +arm_status arm_cfft_init_512_q15(arm_cfft_instance_q15 * S); +arm_status arm_cfft_init_256_q15(arm_cfft_instance_q15 * S); +arm_status arm_cfft_init_128_q15(arm_cfft_instance_q15 * S); +arm_status arm_cfft_init_64_q15(arm_cfft_instance_q15 * S); +arm_status arm_cfft_init_32_q15(arm_cfft_instance_q15 * S); +arm_status arm_cfft_init_16_q15(arm_cfft_instance_q15 * S); + +arm_status arm_cfft_init_q15( + arm_cfft_instance_q15 * S, + uint16_t fftLen); + +void arm_cfft_q15( + const arm_cfft_instance_q15 * S, + q15_t * p1, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + + /** * @brief Instance structure for the fixed-point CFFT/CIFFT function. */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - const q31_t *pTwiddle; /**< points to the Twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t bitRevLength; /**< bit reversal table length. */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + const q31_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t bitRevLength; /**< bit reversal table length. */ #if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE) - const uint32_t - *rearranged_twiddle_tab_stride1_arr; /**< Per stage reordered twiddle pointer (offset 1) */ - const uint32_t - *rearranged_twiddle_tab_stride2_arr; /**< Per stage reordered twiddle pointer (offset 2) */ - const uint32_t - *rearranged_twiddle_tab_stride3_arr; /**< Per stage reordered twiddle pointer (offset 3) */ - const q31_t *rearranged_twiddle_stride1; /**< reordered twiddle offset 1 storage */ - const q31_t *rearranged_twiddle_stride2; /**< reordered twiddle offset 2 storage */ - const q31_t *rearranged_twiddle_stride3; + const uint32_t *rearranged_twiddle_tab_stride1_arr; /**< Per stage reordered twiddle pointer (offset 1) */ \ + const uint32_t *rearranged_twiddle_tab_stride2_arr; /**< Per stage reordered twiddle pointer (offset 2) */ \ + const uint32_t *rearranged_twiddle_tab_stride3_arr; /**< Per stage reordered twiddle pointer (offset 3) */ \ + const q31_t *rearranged_twiddle_stride1; /**< reordered twiddle offset 1 storage */ \ + const q31_t *rearranged_twiddle_stride2; /**< reordered twiddle offset 2 storage */ \ + const q31_t *rearranged_twiddle_stride3; #endif -} arm_cfft_instance_q31; - -arm_status arm_cfft_init_q31(arm_cfft_instance_q31 *S, uint16_t fftLen); - -void arm_cfft_q31(const arm_cfft_instance_q31 *S, q31_t *p1, uint8_t ifftFlag, - uint8_t bitReverseFlag); - -/** + } arm_cfft_instance_q31; + +arm_status arm_cfft_init_4096_q31(arm_cfft_instance_q31 * S); +arm_status arm_cfft_init_2048_q31(arm_cfft_instance_q31 * S); +arm_status arm_cfft_init_1024_q31(arm_cfft_instance_q31 * S); +arm_status arm_cfft_init_512_q31(arm_cfft_instance_q31 * S); +arm_status arm_cfft_init_256_q31(arm_cfft_instance_q31 * S); +arm_status arm_cfft_init_128_q31(arm_cfft_instance_q31 * S); +arm_status arm_cfft_init_64_q31(arm_cfft_instance_q31 * S); +arm_status arm_cfft_init_32_q31(arm_cfft_instance_q31 * S); +arm_status arm_cfft_init_16_q31(arm_cfft_instance_q31 * S); + +arm_status arm_cfft_init_q31( + arm_cfft_instance_q31 * S, + uint16_t fftLen); + +void arm_cfft_q31( + const arm_cfft_instance_q31 * S, + q31_t * p1, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + + /** * @brief Instance structure for the floating-point CFFT/CIFFT function. */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - const float32_t *pTwiddle; /**< points to the Twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t bitRevLength; /**< bit reversal table length. */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + const float32_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t bitRevLength; /**< bit reversal table length. */ #if defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE) - const uint32_t - *rearranged_twiddle_tab_stride1_arr; /**< Per stage reordered twiddle pointer (offset 1) */ - const uint32_t - *rearranged_twiddle_tab_stride2_arr; /**< Per stage reordered twiddle pointer (offset 2) */ - const uint32_t - *rearranged_twiddle_tab_stride3_arr; /**< Per stage reordered twiddle pointer (offset 3) */ - const float32_t *rearranged_twiddle_stride1; /**< reordered twiddle offset 1 storage */ - const float32_t *rearranged_twiddle_stride2; /**< reordered twiddle offset 2 storage */ - const float32_t *rearranged_twiddle_stride3; + const uint32_t *rearranged_twiddle_tab_stride1_arr; /**< Per stage reordered twiddle pointer (offset 1) */ \ + const uint32_t *rearranged_twiddle_tab_stride2_arr; /**< Per stage reordered twiddle pointer (offset 2) */ \ + const uint32_t *rearranged_twiddle_tab_stride3_arr; /**< Per stage reordered twiddle pointer (offset 3) */ \ + const float32_t *rearranged_twiddle_stride1; /**< reordered twiddle offset 1 storage */ \ + const float32_t *rearranged_twiddle_stride2; /**< reordered twiddle offset 2 storage */ \ + const float32_t *rearranged_twiddle_stride3; #endif -} arm_cfft_instance_f32; + } arm_cfft_instance_f32; -arm_status arm_cfft_init_f32(arm_cfft_instance_f32 *S, uint16_t fftLen); -void arm_cfft_f32(const arm_cfft_instance_f32 *S, float32_t *p1, uint8_t ifftFlag, - uint8_t bitReverseFlag); +arm_status arm_cfft_init_4096_f32(arm_cfft_instance_f32 * S); +arm_status arm_cfft_init_2048_f32(arm_cfft_instance_f32 * S); +arm_status arm_cfft_init_1024_f32(arm_cfft_instance_f32 * S); +arm_status arm_cfft_init_512_f32(arm_cfft_instance_f32 * S); +arm_status arm_cfft_init_256_f32(arm_cfft_instance_f32 * S); +arm_status arm_cfft_init_128_f32(arm_cfft_instance_f32 * S); +arm_status arm_cfft_init_64_f32(arm_cfft_instance_f32 * S); +arm_status arm_cfft_init_32_f32(arm_cfft_instance_f32 * S); +arm_status arm_cfft_init_16_f32(arm_cfft_instance_f32 * S); -/** - * @brief Instance structure for the Double Precision Floating-point CFFT/CIFFT function. - */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - const float64_t *pTwiddle; /**< points to the Twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t bitRevLength; /**< bit reversal table length. */ -} arm_cfft_instance_f64; + arm_status arm_cfft_init_f32( + arm_cfft_instance_f32 * S, + uint16_t fftLen); -arm_status arm_cfft_init_f64(arm_cfft_instance_f64 *S, uint16_t fftLen); + void arm_cfft_f32( + const arm_cfft_instance_f32 * S, + float32_t * p1, + uint8_t ifftFlag, + uint8_t bitReverseFlag); -void arm_cfft_f64(const arm_cfft_instance_f64 *S, float64_t *p1, uint8_t ifftFlag, - uint8_t bitReverseFlag); -/** + /** + * @brief Instance structure for the Double Precision Floating-point CFFT/CIFFT function. + */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + const float64_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t bitRevLength; /**< bit reversal table length. */ + } arm_cfft_instance_f64; + +arm_status arm_cfft_init_4096_f64(arm_cfft_instance_f64 * S); +arm_status arm_cfft_init_2048_f64(arm_cfft_instance_f64 * S); +arm_status arm_cfft_init_1024_f64(arm_cfft_instance_f64 * S); +arm_status arm_cfft_init_512_f64(arm_cfft_instance_f64 * S); +arm_status arm_cfft_init_256_f64(arm_cfft_instance_f64 * S); +arm_status arm_cfft_init_128_f64(arm_cfft_instance_f64 * S); +arm_status arm_cfft_init_64_f64(arm_cfft_instance_f64 * S); +arm_status arm_cfft_init_32_f64(arm_cfft_instance_f64 * S); +arm_status arm_cfft_init_16_f64(arm_cfft_instance_f64 * S); + + arm_status arm_cfft_init_f64( + arm_cfft_instance_f64 * S, + uint16_t fftLen); + + void arm_cfft_f64( + const arm_cfft_instance_f64 * S, + float64_t * p1, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + + /** * @brief Instance structure for the Q15 RFFT/RIFFT function. */ -typedef struct { - uint32_t fftLenReal; /**< length of the real FFT. */ - uint8_t - ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */ - uint8_t - bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */ - uint32_t - twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ - const q15_t *pTwiddleAReal; /**< points to the real twiddle factor table. */ - const q15_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */ + typedef struct + { + uint32_t fftLenReal; /**< length of the real FFT. */ + uint8_t ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */ + uint8_t bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */ + uint32_t twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + const q15_t *pTwiddleAReal; /**< points to the real twiddle factor table. */ + const q15_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */ #if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE) arm_cfft_instance_q15 cfftInst; #else - const arm_cfft_instance_q15 *pCfft; /**< points to the complex FFT instance. */ + const arm_cfft_instance_q15 *pCfft; /**< points to the complex FFT instance. */ #endif -} arm_rfft_instance_q15; - -arm_status arm_rfft_init_q15(arm_rfft_instance_q15 *S, uint32_t fftLenReal, uint32_t ifftFlagR, - uint32_t bitReverseFlag); - -void arm_rfft_q15(const arm_rfft_instance_q15 *S, q15_t *pSrc, q15_t *pDst); - -/** + } arm_rfft_instance_q15; + +arm_status arm_rfft_init_32_q15( + arm_rfft_instance_q15 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + +arm_status arm_rfft_init_64_q15( + arm_rfft_instance_q15 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + +arm_status arm_rfft_init_128_q15( + arm_rfft_instance_q15 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + +arm_status arm_rfft_init_256_q15( + arm_rfft_instance_q15 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + +arm_status arm_rfft_init_512_q15( + arm_rfft_instance_q15 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + +arm_status arm_rfft_init_1024_q15( + arm_rfft_instance_q15 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + +arm_status arm_rfft_init_2048_q15( + arm_rfft_instance_q15 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + +arm_status arm_rfft_init_4096_q15( + arm_rfft_instance_q15 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + +arm_status arm_rfft_init_8192_q15( + arm_rfft_instance_q15 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + arm_status arm_rfft_init_q15( + arm_rfft_instance_q15 * S, + uint32_t fftLenReal, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + void arm_rfft_q15( + const arm_rfft_instance_q15 * S, + q15_t * pSrc, + q15_t * pDst); + + /** * @brief Instance structure for the Q31 RFFT/RIFFT function. */ -typedef struct { - uint32_t fftLenReal; /**< length of the real FFT. */ - uint8_t - ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */ - uint8_t - bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */ - uint32_t - twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ - const q31_t *pTwiddleAReal; /**< points to the real twiddle factor table. */ - const q31_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */ + typedef struct + { + uint32_t fftLenReal; /**< length of the real FFT. */ + uint8_t ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */ + uint8_t bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */ + uint32_t twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + const q31_t *pTwiddleAReal; /**< points to the real twiddle factor table. */ + const q31_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */ #if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE) arm_cfft_instance_q31 cfftInst; #else - const arm_cfft_instance_q31 *pCfft; /**< points to the complex FFT instance. */ + const arm_cfft_instance_q31 *pCfft; /**< points to the complex FFT instance. */ #endif -} arm_rfft_instance_q31; - -arm_status arm_rfft_init_q31(arm_rfft_instance_q31 *S, uint32_t fftLenReal, uint32_t ifftFlagR, - uint32_t bitReverseFlag); - -void arm_rfft_q31(const arm_rfft_instance_q31 *S, q31_t *pSrc, q31_t *pDst); - -/** + } arm_rfft_instance_q31; + + arm_status arm_rfft_init_32_q31( + arm_rfft_instance_q31 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + arm_status arm_rfft_init_64_q31( + arm_rfft_instance_q31 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + arm_status arm_rfft_init_128_q31( + arm_rfft_instance_q31 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + arm_status arm_rfft_init_256_q31( + arm_rfft_instance_q31 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + arm_status arm_rfft_init_512_q31( + arm_rfft_instance_q31 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + arm_status arm_rfft_init_1024_q31( + arm_rfft_instance_q31 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + arm_status arm_rfft_init_2048_q31( + arm_rfft_instance_q31 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + arm_status arm_rfft_init_4096_q31( + arm_rfft_instance_q31 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + arm_status arm_rfft_init_8192_q31( + arm_rfft_instance_q31 * S, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + arm_status arm_rfft_init_q31( + arm_rfft_instance_q31 * S, + uint32_t fftLenReal, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + void arm_rfft_q31( + const arm_rfft_instance_q31 * S, + q31_t * pSrc, + q31_t * pDst); + + /** * @brief Instance structure for the floating-point RFFT/RIFFT function. */ -typedef struct { - uint32_t fftLenReal; /**< length of the real FFT. */ - uint16_t fftLenBy2; /**< length of the complex FFT. */ - uint8_t - ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */ - uint8_t - bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */ - uint32_t - twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ - const float32_t *pTwiddleAReal; /**< points to the real twiddle factor table. */ - const float32_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */ - arm_cfft_radix4_instance_f32 *pCfft; /**< points to the complex FFT instance. */ -} arm_rfft_instance_f32; - -arm_status arm_rfft_init_f32(arm_rfft_instance_f32 *S, arm_cfft_radix4_instance_f32 *S_CFFT, - uint32_t fftLenReal, uint32_t ifftFlagR, uint32_t bitReverseFlag); - -void arm_rfft_f32(const arm_rfft_instance_f32 *S, float32_t *pSrc, float32_t *pDst); - -/** + typedef struct + { + uint32_t fftLenReal; /**< length of the real FFT. */ + uint16_t fftLenBy2; /**< length of the complex FFT. */ + uint8_t ifftFlagR; /**< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. */ + uint8_t bitReverseFlagR; /**< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. */ + uint32_t twidCoefRModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + const float32_t *pTwiddleAReal; /**< points to the real twiddle factor table. */ + const float32_t *pTwiddleBReal; /**< points to the imag twiddle factor table. */ + arm_cfft_radix4_instance_f32 *pCfft; /**< points to the complex FFT instance. */ + } arm_rfft_instance_f32; + + arm_status arm_rfft_init_f32( + arm_rfft_instance_f32 * S, + arm_cfft_radix4_instance_f32 * S_CFFT, + uint32_t fftLenReal, + uint32_t ifftFlagR, + uint32_t bitReverseFlag); + + void arm_rfft_f32( + const arm_rfft_instance_f32 * S, + float32_t * pSrc, + float32_t * pDst); + + /** * @brief Instance structure for the Double Precision Floating-point RFFT/RIFFT function. */ -typedef struct { - arm_cfft_instance_f64 Sint; /**< Internal CFFT structure. */ - uint16_t fftLenRFFT; /**< length of the real sequence */ - const float64_t *pTwiddleRFFT; /**< Twiddle factors real stage */ -} arm_rfft_fast_instance_f64; - -arm_status arm_rfft_fast_init_f64(arm_rfft_fast_instance_f64 *S, uint16_t fftLen); - -void arm_rfft_fast_f64(arm_rfft_fast_instance_f64 *S, float64_t *p, float64_t *pOut, - uint8_t ifftFlag); - -/** +typedef struct + { + arm_cfft_instance_f64 Sint; /**< Internal CFFT structure. */ + uint16_t fftLenRFFT; /**< length of the real sequence */ + const float64_t * pTwiddleRFFT; /**< Twiddle factors real stage */ + } arm_rfft_fast_instance_f64 ; + +arm_status arm_rfft_fast_init_32_f64( arm_rfft_fast_instance_f64 * S ); +arm_status arm_rfft_fast_init_64_f64( arm_rfft_fast_instance_f64 * S ); +arm_status arm_rfft_fast_init_128_f64( arm_rfft_fast_instance_f64 * S ); +arm_status arm_rfft_fast_init_256_f64( arm_rfft_fast_instance_f64 * S ); +arm_status arm_rfft_fast_init_512_f64( arm_rfft_fast_instance_f64 * S ); +arm_status arm_rfft_fast_init_1024_f64( arm_rfft_fast_instance_f64 * S ); +arm_status arm_rfft_fast_init_2048_f64( arm_rfft_fast_instance_f64 * S ); +arm_status arm_rfft_fast_init_4096_f64( arm_rfft_fast_instance_f64 * S ); + +arm_status arm_rfft_fast_init_f64 ( + arm_rfft_fast_instance_f64 * S, + uint16_t fftLen); + + +void arm_rfft_fast_f64( + arm_rfft_fast_instance_f64 * S, + float64_t * p, float64_t * pOut, + uint8_t ifftFlag); + + + /** * @brief Instance structure for the floating-point RFFT/RIFFT function. */ -typedef struct { - arm_cfft_instance_f32 Sint; /**< Internal CFFT structure. */ - uint16_t fftLenRFFT; /**< length of the real sequence */ - const float32_t *pTwiddleRFFT; /**< Twiddle factors real stage */ -} arm_rfft_fast_instance_f32; - -arm_status arm_rfft_fast_init_f32(arm_rfft_fast_instance_f32 *S, uint16_t fftLen); - -void arm_rfft_fast_f32(const arm_rfft_fast_instance_f32 *S, float32_t *p, float32_t *pOut, - uint8_t ifftFlag); - -/** +typedef struct + { + arm_cfft_instance_f32 Sint; /**< Internal CFFT structure. */ + uint16_t fftLenRFFT; /**< length of the real sequence */ + const float32_t * pTwiddleRFFT; /**< Twiddle factors real stage */ + } arm_rfft_fast_instance_f32 ; + +arm_status arm_rfft_fast_init_32_f32( arm_rfft_fast_instance_f32 * S ); +arm_status arm_rfft_fast_init_64_f32( arm_rfft_fast_instance_f32 * S ); +arm_status arm_rfft_fast_init_128_f32( arm_rfft_fast_instance_f32 * S ); +arm_status arm_rfft_fast_init_256_f32( arm_rfft_fast_instance_f32 * S ); +arm_status arm_rfft_fast_init_512_f32( arm_rfft_fast_instance_f32 * S ); +arm_status arm_rfft_fast_init_1024_f32( arm_rfft_fast_instance_f32 * S ); +arm_status arm_rfft_fast_init_2048_f32( arm_rfft_fast_instance_f32 * S ); +arm_status arm_rfft_fast_init_4096_f32( arm_rfft_fast_instance_f32 * S ); + +arm_status arm_rfft_fast_init_f32 ( + arm_rfft_fast_instance_f32 * S, + uint16_t fftLen); + + + void arm_rfft_fast_f32( + const arm_rfft_fast_instance_f32 * S, + float32_t * p, float32_t * pOut, + uint8_t ifftFlag); + + /** * @brief Instance structure for the floating-point DCT4/IDCT4 function. */ -typedef struct { - uint16_t N; /**< length of the DCT4. */ - uint16_t Nby2; /**< half of the length of the DCT4. */ - float32_t normalize; /**< normalizing factor. */ - const float32_t *pTwiddle; /**< points to the twiddle factor table. */ - const float32_t *pCosFactor; /**< points to the cosFactor table. */ - arm_rfft_instance_f32 *pRfft; /**< points to the real FFT instance. */ - arm_cfft_radix4_instance_f32 *pCfft; /**< points to the complex FFT instance. */ -} arm_dct4_instance_f32; - -/** + typedef struct + { + uint16_t N; /**< length of the DCT4. */ + uint16_t Nby2; /**< half of the length of the DCT4. */ + float32_t normalize; /**< normalizing factor. */ + const float32_t *pTwiddle; /**< points to the twiddle factor table. */ + const float32_t *pCosFactor; /**< points to the cosFactor table. */ + arm_rfft_instance_f32 *pRfft; /**< points to the real FFT instance. */ + arm_cfft_radix4_instance_f32 *pCfft; /**< points to the complex FFT instance. */ + } arm_dct4_instance_f32; + + + /** * @brief Initialization function for the floating-point DCT4/IDCT4. * @param[in,out] S points to an instance of floating-point DCT4/IDCT4 structure. * @param[in] S_RFFT points to an instance of floating-point RFFT/RIFFT structure. @@ -405,32 +618,43 @@ typedef struct { * @param[in] normalize normalizing factor. * @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if fftLenReal is not a supported transform length. */ -arm_status arm_dct4_init_f32(arm_dct4_instance_f32 *S, arm_rfft_instance_f32 *S_RFFT, - arm_cfft_radix4_instance_f32 *S_CFFT, uint16_t N, uint16_t Nby2, - float32_t normalize); + arm_status arm_dct4_init_f32( + arm_dct4_instance_f32 * S, + arm_rfft_instance_f32 * S_RFFT, + arm_cfft_radix4_instance_f32 * S_CFFT, + uint16_t N, + uint16_t Nby2, + float32_t normalize); -/** + + /** * @brief Processing function for the floating-point DCT4/IDCT4. * @param[in] S points to an instance of the floating-point DCT4/IDCT4 structure. * @param[in] pState points to state buffer. * @param[in,out] pInlineBuffer points to the in-place input and output buffer. */ -void arm_dct4_f32(const arm_dct4_instance_f32 *S, float32_t *pState, float32_t *pInlineBuffer); + void arm_dct4_f32( + const arm_dct4_instance_f32 * S, + float32_t * pState, + float32_t * pInlineBuffer); -/** + + /** * @brief Instance structure for the Q31 DCT4/IDCT4 function. */ -typedef struct { - uint16_t N; /**< length of the DCT4. */ - uint16_t Nby2; /**< half of the length of the DCT4. */ - q31_t normalize; /**< normalizing factor. */ - const q31_t *pTwiddle; /**< points to the twiddle factor table. */ - const q31_t *pCosFactor; /**< points to the cosFactor table. */ - arm_rfft_instance_q31 *pRfft; /**< points to the real FFT instance. */ - arm_cfft_radix4_instance_q31 *pCfft; /**< points to the complex FFT instance. */ -} arm_dct4_instance_q31; - -/** + typedef struct + { + uint16_t N; /**< length of the DCT4. */ + uint16_t Nby2; /**< half of the length of the DCT4. */ + q31_t normalize; /**< normalizing factor. */ + const q31_t *pTwiddle; /**< points to the twiddle factor table. */ + const q31_t *pCosFactor; /**< points to the cosFactor table. */ + arm_rfft_instance_q31 *pRfft; /**< points to the real FFT instance. */ + arm_cfft_radix4_instance_q31 *pCfft; /**< points to the complex FFT instance. */ + } arm_dct4_instance_q31; + + + /** * @brief Initialization function for the Q31 DCT4/IDCT4. * @param[in,out] S points to an instance of Q31 DCT4/IDCT4 structure. * @param[in] S_RFFT points to an instance of Q31 RFFT/RIFFT structure @@ -440,32 +664,43 @@ typedef struct { * @param[in] normalize normalizing factor. * @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if N is not a supported transform length. */ -arm_status arm_dct4_init_q31(arm_dct4_instance_q31 *S, arm_rfft_instance_q31 *S_RFFT, - arm_cfft_radix4_instance_q31 *S_CFFT, uint16_t N, uint16_t Nby2, - q31_t normalize); + arm_status arm_dct4_init_q31( + arm_dct4_instance_q31 * S, + arm_rfft_instance_q31 * S_RFFT, + arm_cfft_radix4_instance_q31 * S_CFFT, + uint16_t N, + uint16_t Nby2, + q31_t normalize); -/** + + /** * @brief Processing function for the Q31 DCT4/IDCT4. * @param[in] S points to an instance of the Q31 DCT4 structure. * @param[in] pState points to state buffer. * @param[in,out] pInlineBuffer points to the in-place input and output buffer. */ -void arm_dct4_q31(const arm_dct4_instance_q31 *S, q31_t *pState, q31_t *pInlineBuffer); + void arm_dct4_q31( + const arm_dct4_instance_q31 * S, + q31_t * pState, + q31_t * pInlineBuffer); -/** + + /** * @brief Instance structure for the Q15 DCT4/IDCT4 function. */ -typedef struct { - uint16_t N; /**< length of the DCT4. */ - uint16_t Nby2; /**< half of the length of the DCT4. */ - q15_t normalize; /**< normalizing factor. */ - const q15_t *pTwiddle; /**< points to the twiddle factor table. */ - const q15_t *pCosFactor; /**< points to the cosFactor table. */ - arm_rfft_instance_q15 *pRfft; /**< points to the real FFT instance. */ - arm_cfft_radix4_instance_q15 *pCfft; /**< points to the complex FFT instance. */ -} arm_dct4_instance_q15; - -/** + typedef struct + { + uint16_t N; /**< length of the DCT4. */ + uint16_t Nby2; /**< half of the length of the DCT4. */ + q15_t normalize; /**< normalizing factor. */ + const q15_t *pTwiddle; /**< points to the twiddle factor table. */ + const q15_t *pCosFactor; /**< points to the cosFactor table. */ + arm_rfft_instance_q15 *pRfft; /**< points to the real FFT instance. */ + arm_cfft_radix4_instance_q15 *pCfft; /**< points to the complex FFT instance. */ + } arm_dct4_instance_q15; + + + /** * @brief Initialization function for the Q15 DCT4/IDCT4. * @param[in,out] S points to an instance of Q15 DCT4/IDCT4 structure. * @param[in] S_RFFT points to an instance of Q15 RFFT/RIFFT structure. @@ -475,43 +710,148 @@ typedef struct { * @param[in] normalize normalizing factor. * @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if N is not a supported transform length. */ -arm_status arm_dct4_init_q15(arm_dct4_instance_q15 *S, arm_rfft_instance_q15 *S_RFFT, - arm_cfft_radix4_instance_q15 *S_CFFT, uint16_t N, uint16_t Nby2, - q15_t normalize); + arm_status arm_dct4_init_q15( + arm_dct4_instance_q15 * S, + arm_rfft_instance_q15 * S_RFFT, + arm_cfft_radix4_instance_q15 * S_CFFT, + uint16_t N, + uint16_t Nby2, + q15_t normalize); -/** + + /** * @brief Processing function for the Q15 DCT4/IDCT4. * @param[in] S points to an instance of the Q15 DCT4 structure. * @param[in] pState points to state buffer. * @param[in,out] pInlineBuffer points to the in-place input and output buffer. */ -void arm_dct4_q15(const arm_dct4_instance_q15 *S, q15_t *pState, q15_t *pInlineBuffer); + void arm_dct4_q15( + const arm_dct4_instance_q15 * S, + q15_t * pState, + q15_t * pInlineBuffer); -/** + /** * @brief Instance structure for the Floating-point MFCC function. */ -typedef struct { - const float32_t *dctCoefs; /**< Internal DCT coefficients */ - const float32_t *filterCoefs; /**< Internal Mel filter coefficients */ - const float32_t *windowCoefs; /**< Windowing coefficients */ - const uint32_t *filterPos; /**< Internal Mel filter positions in spectrum */ - const uint32_t *filterLengths; /**< Internal Mel filter lengths */ - uint32_t fftLen; /**< FFT length */ - uint32_t nbMelFilters; /**< Number of Mel filters */ - uint32_t nbDctOutputs; /**< Number of DCT outputs */ +typedef struct + { + const float32_t *dctCoefs; /**< Internal DCT coefficients */ + const float32_t *filterCoefs; /**< Internal Mel filter coefficients */ + const float32_t *windowCoefs; /**< Windowing coefficients */ + const uint32_t *filterPos; /**< Internal Mel filter positions in spectrum */ + const uint32_t *filterLengths; /**< Internal Mel filter lengths */ + uint32_t fftLen; /**< FFT length */ + uint32_t nbMelFilters; /**< Number of Mel filters */ + uint32_t nbDctOutputs; /**< Number of DCT outputs */ #if defined(ARM_MFCC_CFFT_BASED) - /* Implementation of the MFCC is using a CFFT */ - arm_cfft_instance_f32 cfft; /**< Internal CFFT instance */ + /* Implementation of the MFCC is using a CFFT */ + arm_cfft_instance_f32 cfft; /**< Internal CFFT instance */ #else - /* Implementation of the MFCC is using a RFFT (default) */ - arm_rfft_fast_instance_f32 rfft; + /* Implementation of the MFCC is using a RFFT (default) */ + arm_rfft_fast_instance_f32 rfft; #endif -} arm_mfcc_instance_f32; + } arm_mfcc_instance_f32 ; + +arm_status arm_mfcc_init_32_f32( + arm_mfcc_instance_f32 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float32_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float32_t *filterCoefs, + const float32_t *windowCoefs + ); + +arm_status arm_mfcc_init_64_f32( + arm_mfcc_instance_f32 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float32_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float32_t *filterCoefs, + const float32_t *windowCoefs + ); + +arm_status arm_mfcc_init_128_f32( + arm_mfcc_instance_f32 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float32_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float32_t *filterCoefs, + const float32_t *windowCoefs + ); + +arm_status arm_mfcc_init_256_f32( + arm_mfcc_instance_f32 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float32_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float32_t *filterCoefs, + const float32_t *windowCoefs + ); + +arm_status arm_mfcc_init_512_f32( + arm_mfcc_instance_f32 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float32_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float32_t *filterCoefs, + const float32_t *windowCoefs + ); + +arm_status arm_mfcc_init_1024_f32( + arm_mfcc_instance_f32 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float32_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float32_t *filterCoefs, + const float32_t *windowCoefs + ); + +arm_status arm_mfcc_init_2048_f32( + arm_mfcc_instance_f32 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float32_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float32_t *filterCoefs, + const float32_t *windowCoefs + ); + +arm_status arm_mfcc_init_4096_f32( + arm_mfcc_instance_f32 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float32_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float32_t *filterCoefs, + const float32_t *windowCoefs + ); + +arm_status arm_mfcc_init_f32( + arm_mfcc_instance_f32 * S, + uint32_t fftLen, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float32_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float32_t *filterCoefs, + const float32_t *windowCoefs + ); -arm_status arm_mfcc_init_f32(arm_mfcc_instance_f32 *S, uint32_t fftLen, uint32_t nbMelFilters, - uint32_t nbDctOutputs, const float32_t *dctCoefs, - const uint32_t *filterPos, const uint32_t *filterLengths, - const float32_t *filterCoefs, const float32_t *windowCoefs); /** @brief MFCC F32 @@ -519,33 +859,136 @@ arm_status arm_mfcc_init_f32(arm_mfcc_instance_f32 *S, uint32_t fftLen, uint32_t @param[in] pSrc points to the input samples @param[out] pDst points to the output MFCC values @param[inout] pTmp points to a temporary buffer of complex - @return none */ -void arm_mfcc_f32(const arm_mfcc_instance_f32 *S, float32_t *pSrc, float32_t *pDst, - float32_t *pTmp); - -typedef struct { - const q31_t *dctCoefs; /**< Internal DCT coefficients */ - const q31_t *filterCoefs; /**< Internal Mel filter coefficients */ - const q31_t *windowCoefs; /**< Windowing coefficients */ - const uint32_t *filterPos; /**< Internal Mel filter positions in spectrum */ - const uint32_t *filterLengths; /**< Internal Mel filter lengths */ - uint32_t fftLen; /**< FFT length */ - uint32_t nbMelFilters; /**< Number of Mel filters */ - uint32_t nbDctOutputs; /**< Number of DCT outputs */ + void arm_mfcc_f32( + const arm_mfcc_instance_f32 * S, + float32_t *pSrc, + float32_t *pDst, + float32_t *pTmp + ); + + /** + * @brief Instance structure for the Q31 MFCC function. + */ +typedef struct + { + const q31_t *dctCoefs; /**< Internal DCT coefficients */ + const q31_t *filterCoefs; /**< Internal Mel filter coefficients */ + const q31_t *windowCoefs; /**< Windowing coefficients */ + const uint32_t *filterPos; /**< Internal Mel filter positions in spectrum */ + const uint32_t *filterLengths; /**< Internal Mel filter lengths */ + uint32_t fftLen; /**< FFT length */ + uint32_t nbMelFilters; /**< Number of Mel filters */ + uint32_t nbDctOutputs; /**< Number of DCT outputs */ #if defined(ARM_MFCC_CFFT_BASED) - /* Implementation of the MFCC is using a CFFT */ - arm_cfft_instance_q31 cfft; /**< Internal CFFT instance */ + /* Implementation of the MFCC is using a CFFT */ + arm_cfft_instance_q31 cfft; /**< Internal CFFT instance */ #else - /* Implementation of the MFCC is using a RFFT (default) */ - arm_rfft_instance_q31 rfft; + /* Implementation of the MFCC is using a RFFT (default) */ + arm_rfft_instance_q31 rfft; #endif -} arm_mfcc_instance_q31; + } arm_mfcc_instance_q31 ; + +arm_status arm_mfcc_init_32_q31( + arm_mfcc_instance_q31 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q31_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q31_t *filterCoefs, + const q31_t *windowCoefs + ); + +arm_status arm_mfcc_init_64_q31( + arm_mfcc_instance_q31 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q31_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q31_t *filterCoefs, + const q31_t *windowCoefs + ); + +arm_status arm_mfcc_init_128_q31( + arm_mfcc_instance_q31 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q31_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q31_t *filterCoefs, + const q31_t *windowCoefs + ); + +arm_status arm_mfcc_init_256_q31( + arm_mfcc_instance_q31 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q31_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q31_t *filterCoefs, + const q31_t *windowCoefs + ); + +arm_status arm_mfcc_init_512_q31( + arm_mfcc_instance_q31 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q31_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q31_t *filterCoefs, + const q31_t *windowCoefs + ); + +arm_status arm_mfcc_init_1024_q31( + arm_mfcc_instance_q31 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q31_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q31_t *filterCoefs, + const q31_t *windowCoefs + ); + +arm_status arm_mfcc_init_2048_q31( + arm_mfcc_instance_q31 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q31_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q31_t *filterCoefs, + const q31_t *windowCoefs + ); + +arm_status arm_mfcc_init_4096_q31( + arm_mfcc_instance_q31 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q31_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q31_t *filterCoefs, + const q31_t *windowCoefs + ); + +arm_status arm_mfcc_init_q31( + arm_mfcc_instance_q31 * S, + uint32_t fftLen, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q31_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q31_t *filterCoefs, + const q31_t *windowCoefs + ); -arm_status arm_mfcc_init_q31(arm_mfcc_instance_q31 *S, uint32_t fftLen, uint32_t nbMelFilters, - uint32_t nbDctOutputs, const q31_t *dctCoefs, - const uint32_t *filterPos, const uint32_t *filterLengths, - const q31_t *filterCoefs, const q31_t *windowCoefs); /** @brief MFCC Q31 @@ -553,32 +996,137 @@ arm_status arm_mfcc_init_q31(arm_mfcc_instance_q31 *S, uint32_t fftLen, uint32_t @param[in] pSrc points to the input samples @param[out] pDst points to the output MFCC values @param[inout] pTmp points to a temporary buffer of complex - @return none + @return error status */ -arm_status arm_mfcc_q31(const arm_mfcc_instance_q31 *S, q31_t *pSrc, q31_t *pDst, q31_t *pTmp); - -typedef struct { - const q15_t *dctCoefs; /**< Internal DCT coefficients */ - const q15_t *filterCoefs; /**< Internal Mel filter coefficients */ - const q15_t *windowCoefs; /**< Windowing coefficients */ - const uint32_t *filterPos; /**< Internal Mel filter positions in spectrum */ - const uint32_t *filterLengths; /**< Internal Mel filter lengths */ - uint32_t fftLen; /**< FFT length */ - uint32_t nbMelFilters; /**< Number of Mel filters */ - uint32_t nbDctOutputs; /**< Number of DCT outputs */ + arm_status arm_mfcc_q31( + const arm_mfcc_instance_q31 * S, + q31_t *pSrc, + q31_t *pDst, + q31_t *pTmp + ); + + /** + * @brief Instance structure for the Q15 MFCC function. + */ +typedef struct + { + const q15_t *dctCoefs; /**< Internal DCT coefficients */ + const q15_t *filterCoefs; /**< Internal Mel filter coefficients */ + const q15_t *windowCoefs; /**< Windowing coefficients */ + const uint32_t *filterPos; /**< Internal Mel filter positions in spectrum */ + const uint32_t *filterLengths; /**< Internal Mel filter lengths */ + uint32_t fftLen; /**< FFT length */ + uint32_t nbMelFilters; /**< Number of Mel filters */ + uint32_t nbDctOutputs; /**< Number of DCT outputs */ #if defined(ARM_MFCC_CFFT_BASED) - /* Implementation of the MFCC is using a CFFT */ - arm_cfft_instance_q15 cfft; /**< Internal CFFT instance */ + /* Implementation of the MFCC is using a CFFT */ + arm_cfft_instance_q15 cfft; /**< Internal CFFT instance */ #else - /* Implementation of the MFCC is using a RFFT (default) */ - arm_rfft_instance_q15 rfft; + /* Implementation of the MFCC is using a RFFT (default) */ + arm_rfft_instance_q15 rfft; #endif -} arm_mfcc_instance_q15; + } arm_mfcc_instance_q15 ; + +arm_status arm_mfcc_init_32_q15( + arm_mfcc_instance_q15 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q15_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q15_t *filterCoefs, + const q15_t *windowCoefs + ); + +arm_status arm_mfcc_init_64_q15( + arm_mfcc_instance_q15 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q15_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q15_t *filterCoefs, + const q15_t *windowCoefs + ); + +arm_status arm_mfcc_init_128_q15( + arm_mfcc_instance_q15 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q15_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q15_t *filterCoefs, + const q15_t *windowCoefs + ); + +arm_status arm_mfcc_init_256_q15( + arm_mfcc_instance_q15 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q15_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q15_t *filterCoefs, + const q15_t *windowCoefs + ); + +arm_status arm_mfcc_init_512_q15( + arm_mfcc_instance_q15 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q15_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q15_t *filterCoefs, + const q15_t *windowCoefs + ); + +arm_status arm_mfcc_init_1024_q15( + arm_mfcc_instance_q15 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q15_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q15_t *filterCoefs, + const q15_t *windowCoefs + ); + +arm_status arm_mfcc_init_2048_q15( + arm_mfcc_instance_q15 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q15_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q15_t *filterCoefs, + const q15_t *windowCoefs + ); + +arm_status arm_mfcc_init_4096_q15( + arm_mfcc_instance_q15 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q15_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q15_t *filterCoefs, + const q15_t *windowCoefs + ); + +arm_status arm_mfcc_init_q15( + arm_mfcc_instance_q15 * S, + uint32_t fftLen, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const q15_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const q15_t *filterCoefs, + const q15_t *windowCoefs + ); -arm_status arm_mfcc_init_q15(arm_mfcc_instance_q15 *S, uint32_t fftLen, uint32_t nbMelFilters, - uint32_t nbDctOutputs, const q15_t *dctCoefs, - const uint32_t *filterPos, const uint32_t *filterLengths, - const q15_t *filterCoefs, const q15_t *windowCoefs); /** @brief MFCC Q15 @@ -588,9 +1136,15 @@ arm_status arm_mfcc_init_q15(arm_mfcc_instance_q15 *S, uint32_t fftLen, uint32_t @param[inout] pTmp points to a temporary buffer of complex @return error status */ -arm_status arm_mfcc_q15(const arm_mfcc_instance_q15 *S, q15_t *pSrc, q15_t *pDst, q31_t *pTmp); + arm_status arm_mfcc_q15( + const arm_mfcc_instance_q15 * S, + q15_t *pSrc, + q15_t *pDst, + q31_t *pTmp + ); + -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions_f16.h old mode 100644 new mode 100755 index 53090bc91bb..b0ca0c0d2de --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions_f16.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions_f16.h @@ -23,8 +23,9 @@ * limitations under the License. */ -#ifndef _TRANSFORM_FUNCTIONS_F16_H_ -#define _TRANSFORM_FUNCTIONS_F16_H_ + +#ifndef TRANSFORM_FUNCTIONS_F16_H_ +#define TRANSFORM_FUNCTIONS_F16_H_ #include "arm_math_types_f16.h" #include "arm_math_memory.h" @@ -32,127 +33,264 @@ #include "dsp/none.h" #include "dsp/utils.h" -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif + + #if defined(ARM_FLOAT16_SUPPORTED) -/** + + /** * @brief Instance structure for the floating-point CFFT/CIFFT function. */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - uint8_t - ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ - uint8_t - bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ - const float16_t *pTwiddle; /**< points to the Twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t - twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ - uint16_t - bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ - float16_t onebyfftLen; /**< value of 1/fftLen. */ -} arm_cfft_radix2_instance_f16; + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + const float16_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + float16_t onebyfftLen; /**< value of 1/fftLen. */ + } arm_cfft_radix2_instance_f16; -/** + /** * @brief Instance structure for the floating-point CFFT/CIFFT function. */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - uint8_t - ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ - uint8_t - bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ - const float16_t *pTwiddle; /**< points to the Twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t - twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ - uint16_t - bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ - float16_t onebyfftLen; /**< value of 1/fftLen. */ -} arm_cfft_radix4_instance_f16; + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + uint8_t ifftFlag; /**< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. */ + uint8_t bitReverseFlag; /**< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. */ + const float16_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t twidCoefModifier; /**< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. */ + uint16_t bitRevFactor; /**< bit reversal modifier that supports different size FFTs with the same bit reversal table. */ + float16_t onebyfftLen; /**< value of 1/fftLen. */ + } arm_cfft_radix4_instance_f16; -/** + /** * @brief Instance structure for the floating-point CFFT/CIFFT function. */ -typedef struct { - uint16_t fftLen; /**< length of the FFT. */ - const float16_t *pTwiddle; /**< points to the Twiddle factor table. */ - const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ - uint16_t bitRevLength; /**< bit reversal table length. */ + typedef struct + { + uint16_t fftLen; /**< length of the FFT. */ + const float16_t *pTwiddle; /**< points to the Twiddle factor table. */ + const uint16_t *pBitRevTable; /**< points to the bit reversal table. */ + uint16_t bitRevLength; /**< bit reversal table length. */ #if defined(ARM_MATH_MVEF) && !defined(ARM_MATH_AUTOVECTORIZE) - const uint32_t - *rearranged_twiddle_tab_stride1_arr; /**< Per stage reordered twiddle pointer (offset 1) */ - const uint32_t - *rearranged_twiddle_tab_stride2_arr; /**< Per stage reordered twiddle pointer (offset 2) */ - const uint32_t - *rearranged_twiddle_tab_stride3_arr; /**< Per stage reordered twiddle pointer (offset 3) */ - const float16_t *rearranged_twiddle_stride1; /**< reordered twiddle offset 1 storage */ - const float16_t *rearranged_twiddle_stride2; /**< reordered twiddle offset 2 storage */ - const float16_t *rearranged_twiddle_stride3; + const uint32_t *rearranged_twiddle_tab_stride1_arr; /**< Per stage reordered twiddle pointer (offset 1) */ \ + const uint32_t *rearranged_twiddle_tab_stride2_arr; /**< Per stage reordered twiddle pointer (offset 2) */ \ + const uint32_t *rearranged_twiddle_tab_stride3_arr; /**< Per stage reordered twiddle pointer (offset 3) */ \ + const float16_t *rearranged_twiddle_stride1; /**< reordered twiddle offset 1 storage */ \ + const float16_t *rearranged_twiddle_stride2; /**< reordered twiddle offset 2 storage */ \ + const float16_t *rearranged_twiddle_stride3; #endif -} arm_cfft_instance_f16; + } arm_cfft_instance_f16; -arm_status arm_cfft_init_f16(arm_cfft_instance_f16 *S, uint16_t fftLen); -void arm_cfft_f16(const arm_cfft_instance_f16 *S, float16_t *p1, uint8_t ifftFlag, - uint8_t bitReverseFlag); +arm_status arm_cfft_init_4096_f16(arm_cfft_instance_f16 * S); +arm_status arm_cfft_init_2048_f16(arm_cfft_instance_f16 * S); +arm_status arm_cfft_init_1024_f16(arm_cfft_instance_f16 * S); +arm_status arm_cfft_init_512_f16(arm_cfft_instance_f16 * S); +arm_status arm_cfft_init_256_f16(arm_cfft_instance_f16 * S); +arm_status arm_cfft_init_128_f16(arm_cfft_instance_f16 * S); +arm_status arm_cfft_init_64_f16(arm_cfft_instance_f16 * S); +arm_status arm_cfft_init_32_f16(arm_cfft_instance_f16 * S); +arm_status arm_cfft_init_16_f16(arm_cfft_instance_f16 * S); -/** + + arm_status arm_cfft_init_f16( + arm_cfft_instance_f16 * S, + uint16_t fftLen); + + void arm_cfft_f16( + const arm_cfft_instance_f16 * S, + float16_t * p1, + uint8_t ifftFlag, + uint8_t bitReverseFlag); + + /** * @brief Instance structure for the floating-point RFFT/RIFFT function. */ -typedef struct { - arm_cfft_instance_f16 Sint; /**< Internal CFFT structure. */ - uint16_t fftLenRFFT; /**< length of the real sequence */ - const float16_t *pTwiddleRFFT; /**< Twiddle factors real stage */ -} arm_rfft_fast_instance_f16; +typedef struct + { + arm_cfft_instance_f16 Sint; /**< Internal CFFT structure. */ + uint16_t fftLenRFFT; /**< length of the real sequence */ + const float16_t * pTwiddleRFFT; /**< Twiddle factors real stage */ + } arm_rfft_fast_instance_f16 ; + +arm_status arm_rfft_fast_init_32_f16( arm_rfft_fast_instance_f16 * S ); +arm_status arm_rfft_fast_init_64_f16( arm_rfft_fast_instance_f16 * S ); +arm_status arm_rfft_fast_init_128_f16( arm_rfft_fast_instance_f16 * S ); +arm_status arm_rfft_fast_init_256_f16( arm_rfft_fast_instance_f16 * S ); +arm_status arm_rfft_fast_init_512_f16( arm_rfft_fast_instance_f16 * S ); +arm_status arm_rfft_fast_init_1024_f16( arm_rfft_fast_instance_f16 * S ); +arm_status arm_rfft_fast_init_2048_f16( arm_rfft_fast_instance_f16 * S ); +arm_status arm_rfft_fast_init_4096_f16( arm_rfft_fast_instance_f16 * S ); + +arm_status arm_rfft_fast_init_f16 ( + arm_rfft_fast_instance_f16 * S, + uint16_t fftLen); -arm_status arm_rfft_fast_init_f16(arm_rfft_fast_instance_f16 *S, uint16_t fftLen); -void arm_rfft_fast_f16(const arm_rfft_fast_instance_f16 *S, float16_t *p, float16_t *pOut, - uint8_t ifftFlag); + void arm_rfft_fast_f16( + const arm_rfft_fast_instance_f16 * S, + float16_t * p, float16_t * pOut, + uint8_t ifftFlag); /* Deprecated */ -arm_status arm_cfft_radix4_init_f16(arm_cfft_radix4_instance_f16 *S, uint16_t fftLen, - uint8_t ifftFlag, uint8_t bitReverseFlag); + arm_status arm_cfft_radix4_init_f16( + arm_cfft_radix4_instance_f16 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); /* Deprecated */ -void arm_cfft_radix4_f16(const arm_cfft_radix4_instance_f16 *S, float16_t *pSrc); + void arm_cfft_radix4_f16( + const arm_cfft_radix4_instance_f16 * S, + float16_t * pSrc); + /* Deprecated */ -arm_status arm_cfft_radix2_init_f16(arm_cfft_radix2_instance_f16 *S, uint16_t fftLen, - uint8_t ifftFlag, uint8_t bitReverseFlag); + arm_status arm_cfft_radix2_init_f16( + arm_cfft_radix2_instance_f16 * S, + uint16_t fftLen, + uint8_t ifftFlag, + uint8_t bitReverseFlag); /* Deprecated */ -void arm_cfft_radix2_f16(const arm_cfft_radix2_instance_f16 *S, float16_t *pSrc); + void arm_cfft_radix2_f16( + const arm_cfft_radix2_instance_f16 * S, + float16_t * pSrc); -/** + /** * @brief Instance structure for the Floating-point MFCC function. */ -typedef struct { - const float16_t *dctCoefs; /**< Internal DCT coefficients */ - const float16_t *filterCoefs; /**< Internal Mel filter coefficients */ - const float16_t *windowCoefs; /**< Windowing coefficients */ - const uint32_t *filterPos; /**< Internal Mel filter positions in spectrum */ - const uint32_t *filterLengths; /**< Internal Mel filter lengths */ - uint32_t fftLen; /**< FFT length */ - uint32_t nbMelFilters; /**< Number of Mel filters */ - uint32_t nbDctOutputs; /**< Number of DCT outputs */ +typedef struct + { + const float16_t *dctCoefs; /**< Internal DCT coefficients */ + const float16_t *filterCoefs; /**< Internal Mel filter coefficients */ + const float16_t *windowCoefs; /**< Windowing coefficients */ + const uint32_t *filterPos; /**< Internal Mel filter positions in spectrum */ + const uint32_t *filterLengths; /**< Internal Mel filter lengths */ + uint32_t fftLen; /**< FFT length */ + uint32_t nbMelFilters; /**< Number of Mel filters */ + uint32_t nbDctOutputs; /**< Number of DCT outputs */ #if defined(ARM_MFCC_CFFT_BASED) - /* Implementation of the MFCC is using a CFFT */ - arm_cfft_instance_f16 cfft; /**< Internal CFFT instance */ + /* Implementation of the MFCC is using a CFFT */ + arm_cfft_instance_f16 cfft; /**< Internal CFFT instance */ #else - /* Implementation of the MFCC is using a RFFT (default) */ - arm_rfft_fast_instance_f16 rfft; + /* Implementation of the MFCC is using a RFFT (default) */ + arm_rfft_fast_instance_f16 rfft; #endif -} arm_mfcc_instance_f16; + } arm_mfcc_instance_f16 ; + +arm_status arm_mfcc_init_32_f16( + arm_mfcc_instance_f16 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float16_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float16_t *filterCoefs, + const float16_t *windowCoefs + ); + +arm_status arm_mfcc_init_64_f16( + arm_mfcc_instance_f16 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float16_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float16_t *filterCoefs, + const float16_t *windowCoefs + ); + +arm_status arm_mfcc_init_128_f16( + arm_mfcc_instance_f16 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float16_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float16_t *filterCoefs, + const float16_t *windowCoefs + ); + +arm_status arm_mfcc_init_256_f16( + arm_mfcc_instance_f16 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float16_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float16_t *filterCoefs, + const float16_t *windowCoefs + ); + +arm_status arm_mfcc_init_512_f16( + arm_mfcc_instance_f16 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float16_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float16_t *filterCoefs, + const float16_t *windowCoefs + ); + +arm_status arm_mfcc_init_1024_f16( + arm_mfcc_instance_f16 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float16_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float16_t *filterCoefs, + const float16_t *windowCoefs + ); + +arm_status arm_mfcc_init_2048_f16( + arm_mfcc_instance_f16 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float16_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float16_t *filterCoefs, + const float16_t *windowCoefs + ); + +arm_status arm_mfcc_init_4096_f16( + arm_mfcc_instance_f16 * S, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float16_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float16_t *filterCoefs, + const float16_t *windowCoefs + ); + +arm_status arm_mfcc_init_f16( + arm_mfcc_instance_f16 * S, + uint32_t fftLen, + uint32_t nbMelFilters, + uint32_t nbDctOutputs, + const float16_t *dctCoefs, + const uint32_t *filterPos, + const uint32_t *filterLengths, + const float16_t *filterCoefs, + const float16_t *windowCoefs + ); + -arm_status arm_mfcc_init_f16(arm_mfcc_instance_f16 *S, uint32_t fftLen, uint32_t nbMelFilters, - uint32_t nbDctOutputs, const float16_t *dctCoefs, - const uint32_t *filterPos, const uint32_t *filterLengths, - const float16_t *filterCoefs, const float16_t *windowCoefs); /** @brief MFCC F16 @@ -160,14 +298,18 @@ arm_status arm_mfcc_init_f16(arm_mfcc_instance_f16 *S, uint32_t fftLen, uint32_t @param[in] pSrc points to the input samples @param[out] pDst points to the output MFCC values @param[inout] pTmp points to a temporary buffer of complex - @return none */ -void arm_mfcc_f16(const arm_mfcc_instance_f16 *S, float16_t *pSrc, float16_t *pDst, - float16_t *pTmp); + void arm_mfcc_f16( + const arm_mfcc_instance_f16 * S, + float16_t *pSrc, + float16_t *pDst, + float16_t *pTmp + ); + #endif /* defined(ARM_FLOAT16_SUPPORTED)*/ -#ifdef __cplusplus +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/utils.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/utils.h old mode 100644 new mode 100755 index d6e35356250..e0c5c90c17c --- a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/utils.h +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/utils.h @@ -22,40 +22,62 @@ * limitations under the License. */ -#ifndef _ARM_MATH_UTILS_H_ +#ifndef ARM_MATH_UTILS_H_ -#define _ARM_MATH_UTILS_H_ +#define ARM_MATH_UTILS_H_ #include "arm_math_types.h" +#include -#ifdef __cplusplus -extern "C" { +#ifdef __cplusplus +extern "C" +{ #endif -/** + /** * @brief Macros required for reciprocal calculation in Normalized LMS */ -#define INDEX_MASK 0x0000003F +#define INDEX_MASK 0x0000003F -#define SQ(x) ((x) * (x)) +#ifndef MIN + #define MIN(x,y) ((x) < (y) ? (x) : (y)) +#endif -#define ROUND_UP(N, S) ((((N) + (S)-1) / (S)) * (S)) +#ifndef MAX + #define MAX(x,y) ((x) > (y) ? (x) : (y)) +#endif -/** +#ifndef ARM_SQ +#define ARM_SQ(x) ((x) * (x)) +#endif + +#ifndef ARM_ROUND_UP + #define ARM_ROUND_UP(N, S) ((((N) + (S) - 1) / (S)) * (S)) +#endif + + + /** * @brief Function to Calculates 1/in (reciprocal) value of Q31 Data type. + It should not be used with negative values. */ -__STATIC_FORCEINLINE uint32_t arm_recip_q31(q31_t in, q31_t *dst, const q31_t *pRecipTable) -{ + __STATIC_FORCEINLINE uint32_t arm_recip_q31( + q31_t in, + q31_t * dst, + const q31_t * pRecipTable) + { q31_t out; uint32_t tempVal; uint32_t index, i; uint32_t signBits; - if (in > 0) { - signBits = ((uint32_t)(__CLZ(in) - 1)); - } else { - signBits = ((uint32_t)(__CLZ(-in) - 1)); + if (in > 0) + { + signBits = ((uint32_t) (__CLZ( (uint32_t)in) - 1)); + } + else + { + signBits = ((uint32_t) (__CLZ((uint32_t)(-in)) - 1)); } /* Convert input sample to 1.31 format */ @@ -70,12 +92,13 @@ __STATIC_FORCEINLINE uint32_t arm_recip_q31(q31_t in, q31_t *dst, const q31_t *p /* calculation of reciprocal value */ /* running approximation for two iterations */ - for (i = 0U; i < 2U; i++) { - tempVal = (uint32_t)(((q63_t)in * out) >> 31); - tempVal = 0x7FFFFFFFu - tempVal; - /* 1.31 with exp 1 */ - /* out = (q31_t) (((q63_t) out * tempVal) >> 30); */ - out = clip_q63_to_q31(((q63_t)out * tempVal) >> 30); + for (i = 0U; i < 2U; i++) + { + tempVal = (uint32_t) (((q63_t) in * out) >> 31); + tempVal = 0x7FFFFFFFu - tempVal; + /* 1.31 with exp 1 */ + /* out = (q31_t) (((q63_t) out * tempVal) >> 30); */ + out = clip_q63_to_q31(((q63_t) out * tempVal) >> 30); } /* write output */ @@ -83,29 +106,37 @@ __STATIC_FORCEINLINE uint32_t arm_recip_q31(q31_t in, q31_t *dst, const q31_t *p /* return num of signbits of out = 1/in value */ return (signBits + 1U); -} + } -/** + + /** * @brief Function to Calculates 1/in (reciprocal) value of Q15 Data type. + It should not be used with negative values. */ -__STATIC_FORCEINLINE uint32_t arm_recip_q15(q15_t in, q15_t *dst, const q15_t *pRecipTable) -{ + __STATIC_FORCEINLINE uint32_t arm_recip_q15( + q15_t in, + q15_t * dst, + const q15_t * pRecipTable) + { q15_t out = 0; - uint32_t tempVal = 0; + int32_t tempVal = 0; uint32_t index = 0, i = 0; uint32_t signBits = 0; - if (in > 0) { - signBits = ((uint32_t)(__CLZ(in) - 17)); - } else { - signBits = ((uint32_t)(__CLZ(-in) - 17)); + if (in > 0) + { + signBits = ((uint32_t)(__CLZ( (uint32_t)in) - 17)); + } + else + { + signBits = ((uint32_t)(__CLZ((uint32_t)(-in)) - 17)); } /* Convert input sample to 1.15 format */ - in = (in << signBits); + in = (q15_t)(in << signBits); /* calculation of index for initial approximated Val */ - index = (uint32_t)(in >> 8); + index = (uint32_t)(in >> 8); index = (index & INDEX_MASK); /* 1.15 with exp 1 */ @@ -113,12 +144,13 @@ __STATIC_FORCEINLINE uint32_t arm_recip_q15(q15_t in, q15_t *dst, const q15_t *p /* calculation of reciprocal value */ /* running approximation for two iterations */ - for (i = 0U; i < 2U; i++) { - tempVal = (uint32_t)(((q31_t)in * out) >> 15); - tempVal = 0x7FFFu - tempVal; - /* 1.15 with exp 1 */ - out = (q15_t)(((q31_t)out * tempVal) >> 14); - /* out = clip_q31_to_q15(((q31_t) out * tempVal) >> 14); */ + for (i = 0U; i < 2U; i++) + { + tempVal = (((q31_t) in * out) >> 15); + tempVal = 0x7FFF - tempVal; + /* 1.15 with exp 1 */ + out = (q15_t) (((q31_t) out * tempVal) >> 14); + /* out = clip_q31_to_q15(((q31_t) out * tempVal) >> 14); */ } /* write output */ @@ -126,7 +158,8 @@ __STATIC_FORCEINLINE uint32_t arm_recip_q15(q15_t in, q15_t *dst, const q15_t *p /* return num of signbits of out = 1/in value */ return (signBits + 1); -} + } + /** * @brief 64-bit to 32-bit unsigned normalization @@ -134,32 +167,37 @@ __STATIC_FORCEINLINE uint32_t arm_recip_q15(q15_t in, q15_t *dst, const q15_t *p * @param[out] normalized is the 32-bit normalized value * @param[out] norm is norm scale */ -__STATIC_INLINE void arm_norm_64_to_32u(uint64_t in, int32_t *normalized, int32_t *norm) +__STATIC_INLINE void arm_norm_64_to_32u(uint64_t in, int32_t * normalized, int32_t *norm) { - int32_t n1; - int32_t hi = (int32_t)(in >> 32); - int32_t lo = (int32_t)((in << 32) >> 32); + int32_t n1; + int32_t hi = (int32_t) (in >> 32); + int32_t lo = (int32_t) ((in << 32) >> 32); - n1 = __CLZ(hi) - 32; - if (!n1) { + n1 = __CLZ((uint32_t)hi) - 32; + if (!n1) + { /* * input fits in 32-bit */ - n1 = __CLZ(lo); - if (!n1) { + n1 = __CLZ((uint32_t)lo); + if (!n1) + { /* * MSB set, need to scale down by 1 */ *norm = -1; - *normalized = (((uint32_t)lo) >> 1); - } else { - if (n1 == 32) { + *normalized = (((uint32_t) lo) >> 1); + } else + { + if (n1 == 32) + { /* * input is zero */ *norm = 0; *normalized = 0; - } else { + } else + { /* * 32-bit normalization */ @@ -167,7 +205,8 @@ __STATIC_INLINE void arm_norm_64_to_32u(uint64_t in, int32_t *normalized, int32_ *normalized = lo << *norm; } } - } else { + } else + { /* * input fits in 64-bit */ @@ -176,38 +215,47 @@ __STATIC_INLINE void arm_norm_64_to_32u(uint64_t in, int32_t *normalized, int32_ /* * 64 bit normalization */ - *normalized = (((uint32_t)lo) >> n1) | (hi << (32 - n1)); + *normalized = (int32_t)(((uint32_t)lo) >> n1) | (hi << (32 - n1)); } } -__STATIC_INLINE q31_t arm_div_q63_to_q31(q63_t num, q31_t den) +__STATIC_INLINE int32_t arm_div_int64_to_int32(int64_t num, int32_t den) { - q31_t result; - uint64_t absNum; - int32_t normalized; - int32_t norm; + int32_t result; + uint64_t absNum; + int32_t normalized; + int32_t norm; /* * if sum fits in 32bits * avoid costly 64-bit division */ - absNum = num > 0 ? num : -num; + if (num == (int64_t)LONG_MIN) + { + absNum = LONG_MAX; + } + else + { + absNum = (uint64_t) (num > 0 ? num : -num); + } arm_norm_64_to_32u(absNum, &normalized, &norm); if (norm > 0) /* * 32-bit division */ - result = (q31_t)num / den; + result = (int32_t) num / den; else /* * 64-bit division */ - result = (q31_t)(num / den); + result = (int32_t) (num / den); return result; } -#ifdef __cplusplus +#undef INDEX_MASK + +#ifdef __cplusplus } #endif diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/window_functions.h b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/window_functions.h new file mode 100644 index 00000000000..27f05a73964 --- /dev/null +++ b/Libraries/CMSIS/5.9.0/DSP/Include/dsp/window_functions.h @@ -0,0 +1,812 @@ +/****************************************************************************** + * @file window_functions.h + * @brief Public header file for CMSIS DSP Library + * @version v1.15.0 + * @date 15 December 2022 + * Target Processor: Cortex-M and Cortex-A cores + ******************************************************************************/ +/* + * Copyright (c) 2010-2022 Arm Limited or its affiliates. All rights reserved. + * + * SPDX-License-Identifier: Apache-2.0 + * + * Licensed under the Apache License, Version 2.0 (the License); you may + * not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an AS IS BASIS, WITHOUT + * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + + +#ifndef WINDOW_FUNCTIONS_H_ +#define WINDOW_FUNCTIONS_H_ + +#include "arm_math_types.h" +#include "arm_math_memory.h" + +#include "dsp/none.h" +#include "dsp/utils.h" + + +#ifdef __cplusplus +extern "C" +{ +#endif + +/** + * @defgroup groupWindow Window Functions + */ + + /** + * @brief Welch window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 21.3 dB | + * | Normalized equivalent noise bandwidth | 1.2 bins | + * | Flatness | -2.2248 dB | + * | Recommended overlap | 29.3 % | + * + */ + void arm_welch_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Welch window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 21.3 dB | + * | Normalized equivalent noise bandwidth | 1.2 bins | + * | Flatness | -2.2248 dB | + * | Recommended overlap | 29.3 % | + * + * + */ + void arm_welch_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Bartlett window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 26.5 dB | + * | Normalized equivalent noise bandwidth | 1.3333 bins | + * | Flatness | -1.8242 dB | + * | Recommended overlap | 50.0 % | + * + */ + void arm_bartlett_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Bartlett window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 26.5 dB | + * | Normalized equivalent noise bandwidth | 1.3333 bins | + * | Flatness | -1.8242 dB | + * | Recommended overlap | 50.0 % | + * + * + */ + void arm_bartlett_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Hamming window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 42.7 dB | + * | Normalized equivalent noise bandwidth | 1.3628 bins | + * | Flatness | -1.7514 dB | + * | Recommended overlap | 50 % | + * + */ + void arm_hamming_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Hamming window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 42.7 dB | + * | Normalized equivalent noise bandwidth | 1.3628 bins | + * | Flatness | -1.7514 dB | + * | Recommended overlap | 50 % | + * + * + */ + void arm_hamming_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Hanning window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 31.5 dB | + * | Normalized equivalent noise bandwidth | 1.5 bins | + * | Flatness | -1.4236 dB | + * | Recommended overlap | 50 % | + * + */ + void arm_hanning_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Hanning window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 31.5 dB | + * | Normalized equivalent noise bandwidth | 1.5 bins | + * | Flatness | -1.4236 dB | + * | Recommended overlap | 50 % | + * + * + */ + void arm_hanning_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Nuttall3 window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 46.7 dB | + * | Normalized equivalent noise bandwidth | 1.9444 bins | + * | Flatness | -0.863 dB | + * | Recommended overlap | 64.7 % | + * + */ + void arm_nuttall3_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Nuttall3 window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 46.7 dB | + * | Normalized equivalent noise bandwidth | 1.9444 bins | + * | Flatness | -0.863 dB | + * | Recommended overlap | 64.7 % | + * + * + */ + void arm_nuttall3_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Nuttall4 window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 60.9 dB | + * | Normalized equivalent noise bandwidth | 2.31 bins | + * | Flatness | -0.6184 dB | + * | Recommended overlap | 70.5 % | + * + */ + void arm_nuttall4_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Nuttall4 window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 60.9 dB | + * | Normalized equivalent noise bandwidth | 2.31 bins | + * | Flatness | -0.6184 dB | + * | Recommended overlap | 70.5 % | + * + * + */ + void arm_nuttall4_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Nuttall3a window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 64.2 dB | + * | Normalized equivalent noise bandwidth | 1.7721 bins | + * | Flatness | -1.0453 dB | + * | Recommended overlap | 61.2 % | + * + */ + void arm_nuttall3a_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Nuttall3a window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 64.2 dB | + * | Normalized equivalent noise bandwidth | 1.7721 bins | + * | Flatness | -1.0453 dB | + * | Recommended overlap | 61.2 % | + * + * + */ + void arm_nuttall3a_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Nuttall3b window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 71.5 dB | + * | Normalized equivalent noise bandwidth | 1.7037 bins | + * | Flatness | -1.1352 dB | + * | Recommended overlap | 59.8 % | + * + */ + void arm_nuttall3b_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Nuttall3b window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 71.5 dB | + * | Normalized equivalent noise bandwidth | 1.7037 bins | + * | Flatness | -1.1352 dB | + * | Recommended overlap | 59.8 % | + * + * + */ + void arm_nuttall3b_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Nuttall4a window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 82.6 dB | + * | Normalized equivalent noise bandwidth | 2.1253 bins | + * | Flatness | -0.7321 dB | + * | Recommended overlap | 68.0 % | + * + */ + void arm_nuttall4a_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Nuttall4a window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 82.6 dB | + * | Normalized equivalent noise bandwidth | 2.1253 bins | + * | Flatness | -0.7321 dB | + * | Recommended overlap | 68.0 % | + * + * + */ + void arm_nuttall4a_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief 92 db blackman harris window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 92.0 dB | + * | Normalized equivalent noise bandwidth | 2.0044 bins | + * | Flatness | -0.8256 dB | + * | Recommended overlap | 66.1 % | + * + */ + void arm_blackman_harris_92db_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief 92 db blackman harris window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 92.0 dB | + * | Normalized equivalent noise bandwidth | 2.0044 bins | + * | Flatness | -0.8256 dB | + * | Recommended overlap | 66.1 % | + * + * + */ + void arm_blackman_harris_92db_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Nuttall4b window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 93.3 dB | + * | Normalized equivalent noise bandwidth | 2.0212 bins | + * | Flatness | -0.8118 dB | + * | Recommended overlap | 66.3 % | + * + */ + void arm_nuttall4b_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Nuttall4b window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 93.3 dB | + * | Normalized equivalent noise bandwidth | 2.0212 bins | + * | Flatness | -0.8118 dB | + * | Recommended overlap | 66.3 % | + * + * + */ + void arm_nuttall4b_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Nuttall4c window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 98.1 dB | + * | Normalized equivalent noise bandwidth | 1.9761 bins | + * | Flatness | -0.8506 dB | + * | Recommended overlap | 65.6 % | + * + */ + void arm_nuttall4c_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Nuttall4c window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 98.1 dB | + * | Normalized equivalent noise bandwidth | 1.9761 bins | + * | Flatness | -0.8506 dB | + * | Recommended overlap | 65.6 % | + * + * + */ + void arm_nuttall4c_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Hft90d window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 90.2 dB | + * | Normalized equivalent noise bandwidth | 3.8832 bins | + * | Flatness | -0.0039 dB | + * | Recommended overlap | 76.0 % | + * + */ + void arm_hft90d_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Hft90d window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 90.2 dB | + * | Normalized equivalent noise bandwidth | 3.8832 bins | + * | Flatness | -0.0039 dB | + * | Recommended overlap | 76.0 % | + * + * + */ + void arm_hft90d_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Hft95 window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 95.0 dB | + * | Normalized equivalent noise bandwidth | 3.8112 bins | + * | Flatness | 0.0044 dB | + * | Recommended overlap | 75.6 % | + * + */ + void arm_hft95_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Hft95 window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 95.0 dB | + * | Normalized equivalent noise bandwidth | 3.8112 bins | + * | Flatness | 0.0044 dB | + * | Recommended overlap | 75.6 % | + * + * + */ + void arm_hft95_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Hft116d window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 116.8 dB | + * | Normalized equivalent noise bandwidth | 4.2186 bins | + * | Flatness | -0.0028 dB | + * | Recommended overlap | 78.2 % | + * + */ + void arm_hft116d_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Hft116d window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 116.8 dB | + * | Normalized equivalent noise bandwidth | 4.2186 bins | + * | Flatness | -0.0028 dB | + * | Recommended overlap | 78.2 % | + * + * + */ + void arm_hft116d_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Hft144d window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 144.1 dB | + * | Normalized equivalent noise bandwidth | 4.5386 bins | + * | Flatness | 0.0021 dB | + * | Recommended overlap | 79.9 % | + * + */ + void arm_hft144d_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Hft144d window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 144.1 dB | + * | Normalized equivalent noise bandwidth | 4.5386 bins | + * | Flatness | 0.0021 dB | + * | Recommended overlap | 79.9 % | + * + * + */ + void arm_hft144d_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Hft169d window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 169.5 dB | + * | Normalized equivalent noise bandwidth | 4.8347 bins | + * | Flatness | 0.0017 dB | + * | Recommended overlap | 81.2 % | + * + */ + void arm_hft169d_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Hft169d window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 169.5 dB | + * | Normalized equivalent noise bandwidth | 4.8347 bins | + * | Flatness | 0.0017 dB | + * | Recommended overlap | 81.2 % | + * + * + */ + void arm_hft169d_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Hft196d window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 196.2 dB | + * | Normalized equivalent noise bandwidth | 5.1134 bins | + * | Flatness | 0.0013 dB | + * | Recommended overlap | 82.3 % | + * + */ + void arm_hft196d_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Hft196d window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 196.2 dB | + * | Normalized equivalent noise bandwidth | 5.1134 bins | + * | Flatness | 0.0013 dB | + * | Recommended overlap | 82.3 % | + * + * + */ + void arm_hft196d_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Hft223d window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 223.0 dB | + * | Normalized equivalent noise bandwidth | 5.3888 bins | + * | Flatness | 0.0011 dB | + * | Recommended overlap | 83.3 % | + * + */ + void arm_hft223d_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Hft223d window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 223.0 dB | + * | Normalized equivalent noise bandwidth | 5.3888 bins | + * | Flatness | 0.0011 dB | + * | Recommended overlap | 83.3 % | + * + * + */ + void arm_hft223d_f32( + float32_t * pDst, + uint32_t blockSize); + /** + * @brief Hft248d window (double). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 248.4 dB | + * | Normalized equivalent noise bandwidth | 5.6512 bins | + * | Flatness | 0.0009 dB | + * | Recommended overlap | 84.1 % | + * + */ + void arm_hft248d_f64( + float64_t * pDst, + uint32_t blockSize); + + /** + * @brief Hft248d window (float). + * @param[out] pDst points to the output generated window + * @param[in] blockSize number of samples in the window + * + * @par Parameters of the window + * + * | Parameter | Value | + * | ------------------------------------: | -----------------: | + * | Peak sidelobe level | 248.4 dB | + * | Normalized equivalent noise bandwidth | 5.6512 bins | + * | Flatness | 0.0009 dB | + * | Recommended overlap | 84.1 % | + * + * + */ + void arm_hft248d_f32( + float32_t * pDst, + uint32_t blockSize); + + +#ifdef __cplusplus +} +#endif + +#endif /* ifndef _BASIC_MATH_FUNCTIONS_H_ */ diff --git a/Libraries/CMSIS/5.9.0/DSP/Lib/libarm_cortexM4l_math.a b/Libraries/CMSIS/5.9.0/DSP/Lib/libarm_cortexM4l_math.a index f991257c87043f1544beada1028e5946db929b77..04ec56d0f75d4df26a231c09d7aa7973e98f2212 100644 GIT binary patch delta 254089 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

HbV#cjC(gx`v#5gYyNA}7! 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 V$%x>uOiWuplrj2AQgx_y{y#zZXYK$1 delta 720833 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

!}X_Rl9X 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%0DwXp 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

2$|F27xuQ@Qh3>CWfaTV_7TU+KoJ+ zI!YqyBC8YdWH>=_#3LM!_y#;ZQV~LcR8h^A;nV5Acx%Cp*qsBO1_@+!om{8aNr($e z?`cC8M~3mmU6=jln2F;kunw_1oH|Mc$_B;!FvZ*xiEnj6co;=Z+gc;!{0W!i2@zB2 z)i|^-8I06%^T>UvD#}f61U=@;QKik)+=QAD!bJYqx4cU@m~=3-xXdkrgmPU8B=ta2 zrbr%kNE#fHL$2Jz4oQPUa_Cz@97YX~L${GQyjg>%6i7=|Y)TL=LC2KqG;{<-EMt#| zzDT+1i*OVaBRBgSHz5)((*E8Kcst_R-|X&fc(S{<;^`6Csu>FqEb zx!^l3)_blU`W<fWWE=&CZZ9c{Bc)FpCl5Sn;9)e@qN zo3yqFBu@fKy+d+Tkvtiwt1W=TD6m{_E0P&nUpLHV22!m^eJ%J>D@r6^?v&-!yMs_7 zY3!@~!lR{k>^YNK!`ut16XNJL4}~dpt^j4RUeTx74zHQTx+UZ=JJ?pZD3j zeSUcNAMWR(GoPWvR`&~ zB`~tm_%mp--MBG*?H6wOTKWz5?n{64o;$ui&#WX`ZJ%m>Zuyd>*{ke)f+v-$sIy~# zg!AzSJ&n+9#c4aqCg#n@=*&O3MP-m!DJ5*J&Mv2 zM3X+B;1fHpBMNsb+^_IU3csrGn8Kui^(5+ZIiIL!wZfSS=PA5}Pa6HWMI(weL$$(n z`aGoZhZSyDxJ%(<3csN6afK%prt?@57R!(H-J~$uk@WSLxLIH;pGdD)xJjQ+X#5d{ zyA>9{(J1$l!s0g?@R)&pl{YxnUDSNTeM^kW+hy!H`%^OzX`cv%Xm5t^fS~5vp94m; z`#$F3g|ae%V z>({Rj>#L+1-?HQ9UL~sF^W`7C`@?~d-Naf`1^MsmOc6p zcRu-UgY40Nxa+^a%Y7K`UDu%$Ag00F@zf|f9gds)WDmAfLSlxHI1CKKa&KAB z3qBsxpAb;b#9@tq4pQ1~T3yKN$!iMz3z}7hMysfMDNf)}u3J7L#vRH;C%E*3ozLTw zH~Ylh^*ZV<*|YU=!C}vzpAZ~g>pV!Nuw&DUIJt*I#kOxF-e0N%ZS6e4qR~u=;q`vcj806Kgoj=SNuiQLp@HKu4?& z@S{!n@qOjT2>4Ni^zSP_ylL#ZPlFjn(nm(e0xBB9i%s+JA_ZNP1ldoKBjA)=pBDoG zUKliyyfBzlO~AufxP}>txgq66!WzSi7}^2KixZ9)Cj-3LsJy6EUetjX=>cA-@J>$^ zwBtiid<+^|c*=`^7aRGa1^5^goA{#3uq#h2T8$4v0j0zdN?C9!{twvXqoVJSX?V8D zFvArHm^nZM!c4!F#yChnM)?2^wNHlel@n_3M|e^coM;?`sp)@$^O=4*cn(evoMO!M zAa@{;1~YQ?3S{Cj>71r{I;Rs-)PZuHB1N5$q9Z{*DESxe(;QNCn2v(K4$KN=NdN0y9_KSiGKOBtKjRca$VtE+JrQ3c7YI39<{>8& znO-@qaa;JK^jn`@+BiE(x4;rf{ua^ zEEbpin7>Du&s*jIAMEV-H*PjS|5qWy-w1_h3;2);K2!-G(!qxe@Zo0R z!`6BDPyiw~gUA9QvLL{R;{iSxEdDqFAE@BPca&8;%TqpVa(u{BK7@fH3n;>ZA`CtZ zDIaLL!SEq1z=uL355k8U@F6w82Y)8;{HcI5LA=fc@iG&{>r4z#;%hN5Gcl&kFii)PfnoZvbWQy{UDJ-afSL*IG8aI5 zVWK0z3C}DUa40Ho>{L{n<|dpZKq)}-kRYj>2gxux=QujY>JRwhIAz3fw}>N^2pn>m z1`HNA20U3F7*yMH z@oq*1+jR^SxiPR^$G|qA*oqvmB83GR^hqaP(J_$a#y~hQ2DTaImkIN!CK2F+nG^AW z@S|=rprSrt)9)u4y;6sw*1KRIT z29a~Y>93kq!RfDZRdD*NW>s){8CM0Tmzh<;G*Ewl%0Bdpz>8iItTXCdvsVTFrePXg zae9@V2_^y2gw6xfF$d@Am|3RQCY}nj{V_KUCs6H4AQ_k59|JTFBnJdZ^*l%h&^7(& z8moEX_&YIagmIS$Bh*C}vlG0)S_E%)py9{xW+pfeXc$QE7o=75AngOvp#Fr9^!KLc z1*zz$xSltw0xyJp+usG21?|Z2cRB(pF#@VE0@{TKJld}SIVD2QZS#=R0CMWVg9Z`L zhQJ7TBQOF4ix;pd#}Qyq)#hSKLIt%t0_xldsMQg05GbmVMPj(}1(0?Gm- zpx7{fr!apfz6n=8c=8sL_FnvMb6_UuMuukPLp}J=06ugJA8NseI`Cnq@S)W4VfH4q z9YnT)$aW#JJ-~+(mJc2_Oa_gc5@kj-s9L~>R#ecUd}wuiXi+{i0YxKnGzp3(@L^o} zQ0@4@dwsh)y2HqW@PRh|yo7*2#GDCcI17C7t+-1${=fKE=u(XQQ+$p5Vj=`Z&;Yvd-Z+m34VClsVbfAD7%%50Sw29UaDpQw_MFj!YWsl1%o$yP zx`AZB$Vo+P9G;lv>P9bip%=TQ7rS%){yJ&oc8AFA4w}ZZ$nBD)186#d)XW)efZBod zE!&z1kR2%c>i|_(#`jVZ#s@KM2MT3FC(XhYd&V;KA522!mrM5@A19 zQv;}_UymFHa_laCeLXAJhY2x|8h4ny0s-t*fHNdi2s0;D$jHL8u8+b~}xx~yhoKevKc1rQ4{wGXe z_$Rl~=eXE{evjC8M|Xs;bb5CQkKPi#l*X@aYHn;?(r^_E+8?e5}!LQH`>+;8q5UlJczZcq2aF)xZ?d?1$gU3Qi|-T(7SL!LX`k7Z|I zru@`_=&#yukDJG7`#e`)pAFas}?T=Sq&A5tBU1r$6cmLk1An#W+ zdmEB3ncMO}X7dkrER|2(Q-VeZE}=01Ub`eT|5IV|<%_ZupS3Zt18}f2=Cv{KHP;!R z;4Rd*Y+r1MsR@}qM_**;Wa&*y#~J&g<~#VB{d+5F%{T1_zBjXXSwUR>?V(^_G*73e zABH`MjpetM;{W##qs&D&uh=nD9$J0)LH>XJ!O+i>aBW%pGYk~|%;jbC_fIC@8GE37 z5{kirUwkMHP-*jy+m>7*x0qR<2F$K3!ymhH9iH~buB6{Y`;)GHdR_AJ1apa*QPvFT z@~ijl-gn>bs?d&m_kCseuDz8-J9bv={_||9Nz6*XP+KYLSdeJUOZ;Cek}hj*D@cxS z{^>f{nAnoMWJ~jvB}s>xoBno5N^^fnQqt8~U?{Og-?ME)9I3Uv-=Y=`zJ|D9@4q1y z4dRlTKX=8F&wOGGMFL;XZ${<2waYhT#~gl;gP6nb{JZ?|SzW%O%69p&y|1I=FS_|Q z)8+F2^&JMPQ}Pmj z$p44P0BlqEKdY;gGlvC27$D5kVNd-Z{M;0r7@|qSKYD-s<2V1G%0K>SW%2*_KPEn# z{HvMTpF9oyorQ%POJ`~?E$prR>HG0np=&n(VXAhfzW2f2`k4oLP~DvsT2u4jPv1{L z+GVd_{B}wl{uaiqPA#Of8?2yVN-z$u=^XAEzIVRU-=0QcXPk5 zy8E0nqZtW5vbp#CH0smm^y#jyuCA`GuCCteQO2+byvo4U7{N0AA@7JIdyo9={k!f> zo4ohPh$F$x_oB#LfISpo4+Pj58tj1rc1Fs8(Ayan+!=uTTi!i@d$&NmOaCX_-$M4g zEx30hwoAbNng#Z50b9Kx*fjawrNQ1UU~`*ay9OHzab4T7vKZnAy8(A_GaJG+VZiwT zZ)c+svK@_(UFdJhZ*!IW`)^gNx4rZ8N1waiU)uk-X#e1r$hOE9w*NM?zkkbf*Nb)g z7bB-)D<|0J>Gt1-_8)E9-+nmY?a}yPwDkcpDrCYvvlgNKM+1??Kx6?BIZ7k4KoB_! z?LW%G<0#;9t9LH&*ai$nm-9CaINXY=wploA^F~+y?CsDksh_q`*d{3C3-{#c^62VY zCR|3Fw*h&P<&o8F@8I&_YG%u)v2E?&G807<1H{n)F%KZ-YY_7U#C(95Z-JN(5Z8JO z=SM@0?vjZ7a`5?DZ}%!io6*L|Dw1WM1}?fPr;5+qlOyia*Roetv6Kf)%x+!4AI{o^0W091Rnz4Om# zPyg1)w%}G*NwfjKuRM3%iwp;$H+zwx*UB)ul6^Va@Z9xMd2iwa-Y!MDQY#(4FJziM zv*w}^OHq;+7#a@@O-zwf7oWR6UQjd)kRkj zB!4StsV=fYXbHAp{!qQYb;ObASE4Ibn@s}hCOJ?y32pWrwwd3wSq6$^*GqfN-*nd> zHk9VKrFQt60`F{_#V$G=Z^@W*URJ64z2R?~{Z3Ue-wo1V_QRJ8{&4ahJ{#ihSbZ%u zH7{^Xi)2C%;YY7#H76Fv8nZ|()|KYME*!ZSx*>cyuT)n**J$Sh#QFVs$T{j#?=L#y zeE)jCo%cVG7k+10R(8lthj_|RHolJ+?y5{y2q|ve8yA<6zh-^Ss?rDGjg3NIy-P*w zRyQ=R<3pUB9h*vGs~VQqtZztTg7CG;*+W82&5f7^D4DPlr3^%IYjoJo5TGAmh`mn% zh--}B#}M&%7$W@)$ZZT;b-0}&((Px6bd!Jy#%D1^Tu!Y*`U|P9Dpv|n&>t9P267A) zLOFH{AJps4T2JhI} zzAksjT+{;~!w0jv7{45@X@L8*YroA-n@XvnQoVAOL&80Vdp<)cLIV_fm*K}ey!i2& z*k2ixHQ*lATO$wg@1gLw{~88m2T+!mXu_k+omr2J=yw69Ce_%}oNLJROGf6Mn#f~R zDFop}GH=;r%QpE2yg1{ElXq}N)F1yC`Y}r1G2}0QRac+t8uo{;41eaS;jYm1U;Td0 zJ#Tj%_|A~xw8PyUx6geeWAUj=|NE1jhhc=~!dXNE-gm)%eTQre;9a|H4B*{UvN1qC z8_`5*>G{y3DtX&l^Vx_dYUWHLEH3&ukluh&n9nw^g`Jmv&mB4EKc@p45+D4k zLz@S=<76SMP2eSF(wy<4VuZDkuPER)=0-(g)5I;t0jSHwJMY3P7uU|Za#za2E1m0* zIn=RNQNxVX$LHPCRpO=glG}ZbLS2VgGkJt`n4S4(aK2Q4SGm&bfhlQwt`1J*3hbhb*jJ0!Gm$hQczaZG4K`4z!@=P-z4jMeRq zI=bCq)$OpHcEJOKi9(n_6ml+f!E2ffesj>VUd${Ej0{8W$$*z-qCD)m;v(wkxcPTL>ByXm0izxY>Mgv$w#_=-+I+Akb$a zunh>rAwGQ9S*Q?bEeoa#K>UXI+YbC~*UYTm!jp|Zm?Csm>*pc5IVU%3vk+)rxl-d1 z*aifu&5EFS&J5q*4zk_uAX_-go}W{N{)4Xh6n0wWRG>1yn0cmKy<)jNAvTj-tt z9@D+beRgN$Zc%oxP4Zvu5LM&dJ`}spQS2t&y*8od_(r;y{cOPd-$MFtIntM-cg>LA z75dvY+=39wv#_!YI@qo0V3N?mZqUJQiw?Y?gAKk2=>UEe)WKKFgbrGT4qAN+KnEK@ z2kHoBD>I_KzGr3t#$GEhdVP{tlj8T1H)RerQ- zfuah>I^dbkW$0A^4ph+!+_Zu!oH1RCW|G=Vu|%aQAM>y751BWs;CB4Y>;kM zR`fLLUk+@}05*35o4YhN#|Soe0h_xlY>ovsmxX*yL?`?{s3Uk53py7FIu{5!ml2(f z-Ec*-213pK(7klBJ)qt_ z4(cr{8Wq>chG?Ne4Os(TQ+l<<&OVv_hW&Y} zBp=b??886E-mo{mAE!Ht>?hxtc_i|}=1BOO_}b@hIr&e?SHD7-qc|>m9$AK`H#?6! z=$JQ-#&<^@aps?a352@TJhQ-#e?lgrXF1uBOC@;S5tj@GSrgGlGZFPbLHbcAqG}m0 zZXyaz^XT>A2bXwqLTc{GB`2AR);B-YT;E_t*QuGP(oAm!_yaNd{;>`(GaQ0{oJwIO zP-dKnFX0Rm@ok)0BK;wRoKSi=VMM%Ahnz^RU~JdGcCfJ|o4 zgpl#wIy}J;>E*0jr0;WB5nluxGyOS)&Kc<-dq%o0{F9}g{P2&sq{%6%yKLvz z*X0c5B$N|MGbwGty=PGPH^0pu8Z#k1jnjWl;ay)7(hY;uB4`8B0vpzZ^rwSl5%d}w zdX1it=E#J!8W}q#q+2kTv?iqGiF~b>Ch;X*I?Zd=-41c8oM1xgcC~%_=NYG-`(F*; zdw%xk+9NZXzj)_cH@_@QKL4uWfejjfAXK!j3909UQkCHHjjMy)#a&YW z+jz{BKPos-xCsfewmFa$fz~rfuVATu{&yc+X(0=^3N}Pm5?2wtd*p8W-K6u!SK7FW zAXT(}{`?3ug+ck{bR2K(YBg00wz6tfs9LDRYmgPG54O4|V-ssDRfUn(;ek(SWceG$ zbVOGA>!;19+A$)(oDS?twla)};?Wy}t0)wW&==#s=!;hj50vYw_@N0UuKX(>gFrf) z3e(YdsWqC^Kz@LTJJ8`klHjP_fump@^!#+>l^UggEcb>LP8|86*(8pFNb$(s_PeR) zA6{YOD2P;%+ED8JU@bJf@*B}Xs%Ce%l=<^dU&_3z^5K?adgF9nz~4fo&5EgGu-4xK zjW7O-#=LLez$S;&SDJH{6O|Th_fdA46 z&BFs`=XSK#zk*1Mwn$&8jkXlW;cQSx6t-@z*+Pa*1sE4oI)Y8ZWqd3VeA*p!_<4oj z#RhR{=Yvfdl5}t!>iK41%plw5SU)GGh&5shzf*|6kbKxps=gfyq~GkYdk#a1y7Z{& zh;!8JO0`B!QQw->P(!+=ng~M1XUE0wiHkoF7jKP=KO7g|hB(Iv4r>^tLtxlg@Kr-g zVx{@2>fT(@$~az_+HZ_K+^$GaZ;o~=yQeW_M`72^JAWZCdwEF6Fk%30Sy z93ofD5U7~W5a|1ye%`2`Z()eUdl8V4pn$Ro+0v?!7zjZ7VriI z)aw^*4Dq~OKYxZH3OLOW8T^JJ3iwa`JeQIKo=?)@JRRQ85CyGbi2S$e_|puL{}F_B zd~qH(loUGn0tNknAu{x6QN+s-&jSqcyjq8w^m~dblpszrM8^M%* ziUBppYc|&SYp`aw#oz40l25ex(y;s^5&R!<P!zEhR80z%#*kW+sXeoySk1W}FFyQBHvT+BL!ba$yP9u3CQ7{n)#gxN!b{^k?g^V<;f@Q|>dyj_^~!?$@lrn@V(JMF!>SJL$1nC0qpOgB!)9Qe4Z zT{^V114~>*zkJ&@u;#7QL3s216D`4J3IurpFW4t%C`sAm+Hm#3%)w$@6khaFW=1)P z*mXO8pbJ+y{?W>)4EN^Z`#4Em%!|UKmUt!(<3h+l2$SSp4BHvr;xHsywA7QXq}|(= zdA@opOE8z-w0{|0hFjq&EP}G+$NM?>F|`*zUaf9Lm9%CcaF&}g+F^b3w6spl!JK@;bbpQQHO%T__5>}d*ZTCC; zNKm7RHhuLVD7AFCo-2{L!)j{Px@A35(~HD<70TkCSf+uXGQzX7GG~TKQ10J34nCsI zC3EkKl7=Rsq-sS;?ST9+vauI6N4lshgBe$=wQEYtRPQ}C&?%RHh^6gq^*>_(W? zx(3KBumE6X*%kdHqH|Q2Nq7uwY0`>Y8iUmGr9Xns~mO#G}WDZdBU&S(jbch7D^z{(5@sdeWhc)N{yWA4XgIvIgfQ z#?2phMO#-d|1Ybk57vU#)mKG*_L6!PdJQg%;nRe$?daoTE*OP5Q4|KDhT}$?49E4r zq9p>O!QkeF@3qwhAA{Jk8Ky_zz%(9Ae|`FsyyLny`LF-6{vGOx+n*xw$P+<)9jzG} z>hM1~{YhHj?9DL@y#H(6PXwQY$<${5lS|Y6j|K5R_*fJ(JF@P<6aLp5!6z=I>^;)` z#4Gt=`>JC{CJ%P$LFZRXMoU> zQR3}D0(xX=KpH2*ZC4}9DfGSbc!hDzl_3nb9T`uyJ13`~A~>US@~}4RvS=3LO(HW8 zUzykV72218W?|Bi`BiD^>rE9k70s@3kWh&@U=8UVll_n1^{M`F9E3bUT_1$6az{9op zXk7o-%3F@NxT`7kIC57#{0e0JD2oB}-f zE_d{nYpx=9G#zCOntLz`BeAL#gRDZ%qmbFy)R-z#d0wDQ3CD01?Rp_P==hR&^3MeM z=a1~J9?_%}MsCo3{z%Y$AivtC`>P*_?uQz>&qdp(fN)6e9(Q=hlY`5J{uhqJ1H5z1 z!Y_{g^_CbRcAKn4Sx!?g%>GqB5p{V1zE98x9=y+!lg4D>AI{18jOqZn;k$D(b9!_D z&JAZJ?f?ZKs+;KmPbBF87gPsG1ATW8PW*0_4nXODs@(xbqa4!#rX;lc2K6WG0A4e7 ze1N+Xa9K=S`DpyB7*3ZPJDS9=0VVaX}pX*{~>DWH}IVVxG5hrnZ@#EE|B|^dlRIibT`1hic2)l557(enkHHkWi zuSeVMa{Dk9;%bR37P*Y+8#yJCLR$)=K#5wwgNib@==KrCt!%@94rt9b@E`&Y0j$(jqMIO~e z?mu(aDfK3jM=7KxVr~D=bRB7dn69IruuYP59lZI!sq5TP%5_caGGbS zy^qSuoKV|Q4l=2M3T!08+yJ6CHv(0@dl=f5q29!Eg)Gb!f}4X+(9`(dBe0Ty5_4$b zbJw%IoC`!Z59ly)H9JtbUdkSEB+dVsd8J)B-iT~U!i*v$8$d?nQ051+xzRxK~+mVBaU!}6xlow zSWwU1e)UE@_cxt*g0}u?*eBr1g~n~+wLebI3vis~{00-0UhMs4UeceV0>tw>VU$n5 zu~V>&FC*qIuv3l_C5W5L8oAd!xK`}t)yR#FmU}<%DH%Y;QOY34fc?gO7_gz1(F67_ z5xdkD%5sdpH!~`n)dE%gsF0mPt!F=KrcQ-@!!t|zaXc@#hl5H)^>9#{a0eZ?RwiOM zrKJ@{-&sk`P~1rU$>GMdi2cjhZS@|WsIxiLh@rDGyR@t>?}OFlOR&0Jv5tip z{3v@f7U36juzUeNueW?*B&#g>U{RLXly9JAC7YH#C#Ew-ZWO~^ z7MI>faq5f{*dR-BhaAO?zX`me{e?DRA?ofRBhcu@S{yA#2|!vO031Ml_oKcC1b_n$ z0O-slF?QMc#EcRyx=2W}{+1%ex%wzh9SQ>jW+`r;qqs3W(W`rjVMK$#h^~5H%gn*J z!_BhSyn&pV>_~$;_`>aXzEW@0ktx@3c8RN`A5vZPV%4WwjX_ZHE?R%0<{jc}Gxe;ku zKeY}QKO+5YKUs&n04UF+Dx5+N;uJqz-jV6qxnNy-c>g1rS!pO`8AqupobRq{UZtE* zOj>=1C2J*H9H!JPGe|eQu*>3b=1xxPVXgwRl-HsysW`DOirC&;X=${lAMWy(rugg2 z<^@~1lO|dhY`w3*DFh z)QnYv(DF|0k7kH=Ec>mrfwSN0H^}64Uw}sRs*I(syubomfd%Y_w_MFi;(%ocObHxU z8tBI5x?%g3;L>l}y%1MK)*(?9Ig;CAj%gm6k!X#RZZa1_@gyPIC}fWBV`QJh_jzvN zscHX&)}ppai9P!uuOt$CW+_N4Jw=%od*T zW9f_Qi%$BQl34EXd7+{Z`U-LDBCZ$>g%R$fZDx~dblZ2{cg@~=L_OJiOArgG{R@N5 zd)=>q?1Gzz%nLSCK=*Hk9%*ux2;)py!@Ql_vbvJa)bKPO0{1!dtIq)hAYPCM2(pSn|pUk$n_PUg{s?cf`e2 zS@!#RaqmAL7w3YCxtQNt6G6y0jNxR~_9kyh*H6YJP&#z*Gi@m+{LC_Hi!paAZQhv7 zF0Q$>(SBuF!qE_}^h@R|+Qoe-CLzxaF{2%A@~kezNCp6^REOsn!nEu%!jv4xEESwOEnI2T zm+m)dkgob`D_HLaBxj#xr{ItGv+zU5v$%CZ5^mk7wEmn*SK>#JV4!IIFQmYzUYNGX z1SrPtwRNju0YX8>*=v(5zWc0`ncQ$Z6)O`!8n~Czz<;T15E2Oh!oiMzfp+BMZ2kc{9oOEq&$wMS zci~`tGgNRki8PR{sDPZssK6{LSd*6N=~v!^40=cd$;eQD z_2wl)zE36$yw|HRK-%nE7~t4#i3uNEGRTb)4YXts9tdt3G6O$tUpep>GsHtLLk#@0 z7-B$Qzz`_rVO1Q@S$hunGVtU16O3bAXD4R5V>WSi54o zc6Zvfn><;yn`%<4J(HLwedzY=S-ZpIhku;4OWbyo6H_ayoS0hiRJGlvkJfhKtP7b# zW2#pf_Ffv?_R;8bgx!ME94%OZ#P1Q{FvzT?(rjHsyLIIU_YV}Z=qd9 zZVb|0u&fk%9_#A6iXW2c^dQo3>noZ61you#C4pzuDe!%ngi1fI>OJ*e(FMy$iPmMc zU6KXM56xgETD%iC)__r0v#PdX?b@0onw_X;W;4O|etpu-Lw=S|?G5f9P8G zpxB*17?&T@DL)RrbDLd7zoUv%68JWoQl6xWzRAXgvwMx6-Ot`}IPC{r)yJ_Wgl)RD zw35dDZ~THa1Kuu#kEz_$l%2Ar3;$uXxHBiPvB~Tfk2G&=hGzfWrLJJDI+8doaBD!_ zDV2NMY_r3wJ@8HJ%I%i)O0b7fVECJ-GH)%Uhai*8SPZ6Ofp)CY&OgR|9Eq)=+h5Fl zgjNPa!);qL)BCX{ZV%7A)pN&Gio8IR>lyqw6Z;}Ub4i0yfAsK|S{p2?r0GF;!G+Ac z@ULIWzO~3Hr`AJD)g%4RPmLSC^K0X7!MV4Tw=I+NI1)wF8H4q213o%@832Rw8x0+&CA{SUoR(ynd&rba&$(a^f0!h<_86 z!e|-NUPF`$BV~rT02x1GlT-#is!_t_6ztBjFRRxiQ}R!SS+xw;?lzJXjCP)V;&6&Z zQi_y7S|F!9AtyHo3A;IC2x)qA5DvmEvPeJ;(VB>*e!Xtp*$P~1Yt_!0`x_Dyi+5;d zwY$J}>mG7$7$HqK*%#v#_?e6GIVOUT@q6Op55&b=5oaTDVnG`GO6+^LYvPhV-sQ? zK9aKnhD@I7O-P6scoWHuzR6PzA?`AS=;UoSUsJ?bVDUCjDoGLre?XE9)}CmlUwfNu zZRX{#eK^0xUawFr(eSiBws*K4r*4OefJbwY<|dg4LdJROwz(MpjENv*d~sa7265nD zc8HTEH^seIdiB*SYFbw|*EKbGRyC~c$sxxjqtr&{3le8|`L8kyL7lnel(SHl>|DpB zI)Hn!$j>qajml&kG}@w{Kg1C6%?v@a+Zo>Kpw)wyz^UzRi+dcj`X)%K66xbjKGWN@Iu{xLjZLd#@sXTb4O*QHLD9M_rkPC3j)7P)%`Y59 zmbk1LdAx1C8i;dK?Ljx#ys_z(d_{C=0ke8$FGH!NO|hy^%m?@HQ-fx9Nqs6A5fA63e2v_u+-V%FMe>+3XpX6w9ng0!TCxB#=|+%E$L?%rOjsRuVHqmIETN z4fD5N${fPRJsz$s_T;()j>eq`gcTxveB+Xk2&-w_jkvA^kX~l@3%Cf8~)QCv4 z@+P}+IY2H~BjVJl38w~0)GfZ!DY|jp6BQ#m{H&7^eNZ9mgp7@`BG&YlU`u{gEb~b! zMWsQEI-Goyh5I&pNL*A5w3v$&afgW@WSm2bxfnNc$QIm_LMZW=i|=>VOenBNIFYPU zN*nRC$S{TRNF_`G1JXR)lOFEZp)iAia4*HU(+;%y63+9m>0^t7K6azs#v*+@eQ>aL z(#J7PA4~DvNgpYy^K-?f1F!7P??J|2vFYO!qAL`A&_R=ZS)D(L`o>p^eI80;s#NsR z{;a*1#t&;JxL$$)?yo88@Hg*ubvI#%Y2w`p+>K~5E`Um|xvF~hemFU@mbCq_lJM6| zZ}vCsnf2>e?6mfhwxrGwKTr;~k$A280}V@TQFDiQy#ywVv4Ofz}DCbw1Mbo^XLXw{Y z&zyBQ#HDbVXS;j5gZ5~QlSoL4A9##8M*P5|%rV5L!!;Cd(;n?S*4wnl)m}aD$R=Wo z_$=B3K_(QEN{vy5JJ;|gr?hShNto37~SVORpj zbjO4O%F>_kA_+xg5uwoz6lX~_d*ygbmwrRzqPCevG>>3f z>H)h2sP1FU6O{dtYeN6?$ApWf!0}gpby|n`ze#~r>I;6%J?Rss4;g-Vu^`g?OS3$} zOyX|sA*uac#o@0X%p4ic&dbU!q8wx{5@)v@A>B+IiUM7jB=Vm-3F};ajwyVEb zui#cLrpH3YZF7~Rwzi@5freG<*V@Z)F^;Qfx+B|*EZ!L-)YIqH&ddo#AzHpRB4_YU zVU$A|B2vf@U8js8B>hT;V5B5#Y^QZqGsJTl)Ddsf@jW^`$PnpIG6d*n8D`_(q;(Ik zTwha*aQ)i#HDQkjya66eZppDKGzoW;);DZeKWS&ygxkVZ>oQL&0dkVfq(8X@eJhW7 z;zx4lFC9O_G5X`4S1o>T%6HR0jazoRO8j_nNBAOy%!0{H7EQQ!_UL)q+~Pqz$0utL z$hAw!7?e0EXJDG6cdx&ff>Q--K7SP-J*vAj_K?_@;q%iflJR+;kulOf8lQLa_io|) zk(eoOAN*ZAy7}zR=KH^xcs4?YJM%oU%BIT(m3e9jFV!(bx z>lJyFmnK>fo|a_w!soLrbFU!}Tru;{!_RJWXz-LQ3PmvFfq1>$#%8}o4WjxLTh89b zeY&^6xc{f8i(1qwDP1(xtb}m6JULy2pSh4p!pIJvx|rE-Jn|ZYAK6+dLo|sYl(~$9 zK-h>e1oER;0;zQnNIj5#GX(ODBm~l-2!x8X4isw>$Td89(B>c89R$K9N9(fqN0JpF zm;uJ|k2cT*wg#ASU99rXboMV9?cDe8j))I{6XFBFX!Or?ropwF{495G*zIE7GnZf! zoS;<0$Jc~cUpDXXotxiLsaD82tPHt*&rKE;0VU=lC+Kr@MH=AEwFN&?OdUdV@%x=v zB_E)7Mu$VUWseBok>knU`Q!09pO{+a;xK3tMF7c344iC&7+k9u+FGl@;jg`xIgB0$ ze&Ke`S;;U8ku;uR#LpYdoHc&l(CeJlq0`una`e2RoYJ6mS@e)>;i%M{!|EU{$E~>Hphx%y+~soYz;BunD|ud zMZe)tr&fO$+Cam|MOvUXiL}y=A8BPRLUU6w1%NQFBQ_t3D2~wj@upl<^b9~5xiBUdql3*I&pS zP7!6E;xdr1?_|@X5$5SoxD808R>y_wATFv4qH*9%x zG0t5a=3-ogVwfj3uM&z27hcG`#Xj7)C#&p|CT~K5 zAgOtbBWH39l2(&i(Z1s~=3KjDU(lPza zU{kkdjeZ?JVKK)(={%%A-PCNfg7z9@u;xaBr_q{|37$saWzpGHqS93&vIo#8?bub+ zeM%rAT_w^oE(eEIPW6wy!y6a>R9u|A&s<0!Uig=u;Y)JS z>g+0ynKuZTS$kakzsJS@J}&-zTzu!<<40=!o#{qBR$A>&)LREbpF(EE;qShZIZZ3^ zgv*1g3ztVIsyjek1t8deq(5c3WVoSa{3<@r)+#*EcpKvw4Yo5xTm%iopVsk1`u$0U z=!fSSLWX@^3Wmd&Zk?b%u;-XB-5UOvPi3WtfB$Q!TCn1xR4um>#pcp3uTP^p5ySCf z%Ds5T)Lxx_u2#rVtAkJ0=*O<7RJT2aw3YbT-Il3N+ufFXS6ZoY$t}aaCLSSbE^Amx zwkqs{6~3(cg*XJ_ic`7RV+`pUztl6G=_Q|VPOou*V*e876x*I!+tcaXK*=@NoZ`R) zdb4m$veV5ZI~%j?3z%i6%gmZKcCt8}Ts!An`12MSlp*xsHz_Vo)ip8x2!8AbwB8-j zPi91%I}Zytzmj73#kutVlV4+bO=if>HIypgjK#$_Fy&1aXByb7p->)i zHn3w2a^9j zn$?#~lWt6P+<8VEwC5MjuIluEc{3d~D^O9(HV(r1Ogg&uK;1zn_TJ?eS?V;q&pWf? zISQ)Zr{XA{R2**L%$zE=e@5pYD4pM0$m(0G)+Y&ZbYxFFj~_|ssqr!0{z`M^z@7cZ z4;xmA_oS64ba;TFlV*a30fYy+&1${DjgN6bi{8m#qO4ePHp13|RrdULs6u~vlOZ$UUK z+RWH+s3(+iRIOZ_lspp>EXm!aO@Lez2EJ?$C@}VE`D1~QMzGe_yPkSE*y5N|CSe65 zZ9#caA#i0b4$7Z25rm9$7%&&(cbN!6#y^K2S;ap5NH9BJ8kg_yO=%jhC&dX#MhF%Q z=$FQgxMLzRBmGcCLRplBP}XeJ;d+LUIVqUL(AU&oLnROCQtzkU=b$eRN?xh8y`CBm zT)py~C=DG_BQ-cruTS3Nls#g((r|cPQsfu0_4m0Ge)Y2R#I(M&@(!!R%3^_B{Ud?g z5f`5k7bigx|84jQ0sUZH!Ni*;All6TVBAPD9ttlcno5Qsngu!(W`y`!#mZ4>jkPPL?3demQ>=Z|Re%Qmg?u%;r)BS5)of*??j z;Y1oBBB&=W<4{j5P6+WxFK4SL)JOH97q?A#*@58aEd)D3P$=Cf2%|_$PHX7sb_q7=E4a&KbhKxTSgU1k0Aux!nx+z3Du@zhaa;zgF39Pdke!TJH zjXE^V`9|nokdJRdy(0fP2l5YmVC3ISbwaVN|B>sHpgMMgJ%%wlF`VxNfVrHANZ)$JP z+&+axnM(;8YGII%`|B5n5g`cXN(tZnM&_`4evkBo#9Zd{-FV>q{2-KT@<1mv>3*yq z8)@sH_Lunro;#(jca*=(LV)8%zL5P~a++elMX2#t?E&-+ME}`HTcu?^rTJ2C5@}w} zkWos!ZIBLd#YkH`6z1>W@Au#6%lU#Eu9LIi__qkol6{wM{kyKgrO)BlHW`N(zMG!< zcU>70f2|+i@68{Pa;7UCPcn+nYlqBfjFsM3a8AcvOkaFfVoO7_&UD@IF~j=`POC?F z(&hWEz1rm}ezhyD^p$+LTSe?WAH6R(`Ob8;0-PHXTZ7no#JVI_jaWTmYkaSE zE^(&>_T|yr^ZKG$Z>6S=geLJmc=1ew4^O&frpM$^3cNC>iC5+`of{wL4-Q@>t0l;4 zSrOz+IhW?ut|h+VE*Bg~Z!F2pKUrV*mOC{n&V=zz*{i5CL0g1x78fy%`OX|Q^J?ef zITHdd6kUR%-6*;kCA&i6s~K5*pFdOdTx7EV+1w-g&#&iI)GwVGL}8wiqQKpGXSyo0 z#sy}-}h6rGy{wN;5wTXd%DKo*<~1AqepzyXxhBzdZQNk1V_D>BYN zB1K#-#L`gAEU95-A8v(DqJU%g_M{YWQdeb_RONWBs>*e7%IvI47hI9w5K3Bzqo{?v zY%;kst}dw^?4Qrx_LN%)2DRFULU*IkeNyN?6xwLlDiP_S2a!0hp;$On@0@{_{}~$i zP49$2XeL_$UW{MuoQ_N$Dtoo_A&YkNa70oHy3a-5rD1z!Wk3aIzq>e$$0t38sr)Zz zyXoN=0G;#YSF>-wF)KciT6bJguLLU?^jzwS!X-#Y;JWw?q~{rw_huOp`V zyYcEi6?J;GvkX0cFKTwyJ4h2X7#FHmE{$25pfN)^RVe{+nhwP70%F@yk6nV;T|jKT zjabbUPNDeIg;uBQI_0&w!i-vS1<`}bcZMq*!#5{Yd&f6-sB=rtueQPj0n zGm5rC%_zFIpdHC43RUN-)}5;wr|&wDE$;FY^?}Y&3Gs~nzXgbHL*ZMb@GU63+JR^i zop|0C{vb~CI}4;%`3cC$Nlk~4??L2yNb)^|dyj~dkOTv35DHnSE4gP zPF-o)a6jG9)J0$X3Z@3ldhsL|A8!CJ*kFM$(Dl-=SGzhaPGG-zaTt#`1}B((NjO0V zz&Kx&gBjs~_xpWWY|eW3b-wJrOwUxVpl*W{q^>lVoW9|R^L-Np9_Rbk0hTZHO7udJ zxvHS!q9{4eBt_`qz45auo(FAr=;nF2^7EddSkEI2DT7s62<;^xafbSN87JYWfXRMVSFYfI$lphW8Y(lX;7J#<(hFhzP{7B99 zmSb8c9jvKnfi_u`$;T~s90f3~9PTjlE!3HcHd|*}5Lj}TS>hNO2)5YiD=Z-F9ES(S z2L2e5Vhl6{2Fh_OyW`CUki;qMy5$FgP0+jSn5uC_j7-+JitO;o9aJ26I!W#gjzX%Q zc1DSiBw&3k_{oaLPe`LNDS|Y926WU6nksw8E@j>YooQud;s*F27=zBK`gWmd?WP+> zWH0x_(b^-LD8%r!>xD{8VSCwO9ww(6N>0>n=5*jR|D#Nk{vRPq?f?Tg)nku+pJondxZELMxq(48e-G z==cAq!}AQ0?sXmh8^dgu>ks;U3b4a?2E#$H8O_%ZxB-a;aW>5iX6SI9e!p0U_v`0P z43U1Ve*TDl{)7&9>F4`({Chh7CPRGpjyy->{-;im4ss!6xeSq@P{+qJ1VH6FK1;v< ztbTr<4x9A*wL09SpKoP|{B|Ks$%UPge*X-^@yPfDZxEi=FV5@uYdU_FVMhEY7x{kX zEsn*3jPT2K+1l~cRm$cDq6oCVS^ z9U1SpbsJQ5*u!0UPXnb=Z;~xP72FUax(y$#GH}HVcV-uGuqk75MzO0%jTf#LWY;gP zP!caD8wXwa_mY~~{l-h)>L0tWbiXyt^$)CVSl56vz>J7Nxg+MWYh}Yqq~IqYiP$x~ zz2AoiEu4)pGb|SDqa4dJR7w%+@tB{BXLw}^8u#cmJX#bvF~3iln4H7o!}t;NYBL@+ zVm=%5#}E|@b}q}{Byb~Uz%F3wlrk?|wtAsyN+f99H0IMM_x})>zvE^xuU%4yAN^it zPFC;89;6SXnEihXz9;vz(hKM zeWUd!d#Z8HA&iUT*;+Z3^2v?s!c7l)JmKntnSS49a)%H?y~E5uQ8wn`3WREPtbA z)D0=+HS0OcFR+)1?L|@+qdzHZ2e`nx4Slic0SRCGM(Q>O z>LM#PuHa*ToqxsBS;2bsp&zGPO>h0#l@!d=qALi%eHLBBGTpg`E)oxSvY9;zZ5#pO zZ-O?=!2pIUDB8f$0EQ|2E%I?1uw-zQG^x0aOFO1YcfHfy1IoyA(poSqCc)zDo* z!U2T_ElOz3)eDrC(Av9ed%-qfl8c^-!yVf*hxBW7x_Ynt6L|}#fLJ!gXV|ADAofyA zNHQXte?SNRJ!-l0+hc~tR`TQU7hYgDWjR__{Dn&;%M(=+&l1T7AD{c>@c;j0W?qc{ z1ZSt|!^;?< zvEqnBtUEkhYs6vJIQjXacW*k@(S3LR4$B~gIV17bo6~frs~pQ6mnD7~aUA$52OXD- z34vKc8!Bf`@78Bd@AJy}p&>c2`PHu7Jaih%Hy2RYd91!&kRxg@*hkdj%|I8Pd$`Vm z^>-9F+L!w7D6HES;=V8oCv6J=uY2daa;js&k<*p|Bo~0&v7)yND|)#CPN-eOvrECF z!D-jvsFR)(9Q2Gcpb5@74Gz}tv4*d}$-{kK4{(xTE2PjRhcheq%&K9wz_(3<{D zZ5q5JCqt*g+CacNt-;F$NVyt35AHn{c%g*o;tA0jUFKMCkATyr!Pyc6PMZcN>1okj zCk3378k`J(kfFc{!SVpheHJ_hoFwQ{*pjoQi7mCzIT)awSj|IeqpR&hX^*c~6qWQ$ z>8_&y3Wqo!)lj7YkTi`X7w%m>fO1l}pT}AYj?|Il831Cs01yV)4 zkOtxgI@t}cBBUwB9cGoJP)EezTVrG?KW|ados}yE<`gADa@zY%g1gHZV zD0O_j0!j|}?g3N`W_VJt!i=1$o=(gN5J3kJ6$Ik@OG8zAu^V13@S5{{#S#P77^*-X z@%?6x0%!Q#elnt0@pDZGy?65O$(&NJ(T-z=FVq3{uw%cKW9SKNDIvIuD65*m7(x5O)p;DdwbH0v&iah zFeMVLKCxR$gy~a~BE=fZV8)!72rDEMG*K5i7WZR&6dI42;166ca25LLFPl|p%U{=D z7S7z+djEYrH;KT##pc4;QLVqMU{K8A5!RgVP{lqeFwi0O&ljj`$qmwJ=uXL`6JDJzD~!dX?|)c zux+$15?TQpET2h~`~!czzjZ`Y5PC4$ZK?F_jsn`(nF9DU%@4&0(o;zSt1i$?hHu0X zu)3n`BRuZoOc$9Qp5=yOACncOBPmaNPs8gGIyu=Ao+BRrhJ3>1yOcvKE1nRa`fjE& zt3qe~yRIvEcEiiJmvMJlzwN+%2j2e1`)a7GOI|BMLw$S!uP@;BFA=^cZ(+&=b0+on zEbhzyU@jI+DIfVN|l1Z>(dV@lH+q&s1p`BPcq6u-(K-=1E zYAX=W9~s0Oc05uY_+o3Dp~YKHXj?+gt`s_#RqlU9>Dzpw5?4x`|)JIe!CC%`xMz|s@aVvyY<^$ zxZf2+HSKuPuHSCQ{dNb{Y|~T|f^}8bHvG2e7H`9So3wZYBbjQ+ZR<9!!mf{1rp32O zi!+`-GJ-d*7f40X<)op=^62Ult4V^v<-ye?KmYP>ozD~Nx{=zy+T`=Z+UyWWhY#{c z`d2d}O1K>5l&s59?v1}!K#;+xv2L`lu|qv$U;kzS?m>p_YqP3HZ2P;eVh1-d?{?tb zkFL8=t>>;6`^W*l1s7ROj%-F;b<(j8q8>)@93JqLIp1W>oL) z3u^mmtgm@L2AyEdBOMV?kZg$2dy?~;HZ_%u3|3b(8>MOqH1PQ&yQ>qu`2b&s5@h@V zKL5yHhvI96?K}RUY*Y)q_uqctmp&4#Df);Qv2%S*XtIEMWO_Z_S$BV3Qj(OTtg;J9 zhvuRNZvuX#%Z>PFq^Kc7dTNK^^hLCoi@AhoZEX~FFI2Bm1VrNJZB#gh`1aZ{%`Tzy&EDTsE7I>+QPYdd5IY&~$r zh;dYD{BKcd*n2r(A`Py0)<;q8s_$R^6_Q2~RT>w3RB614ch2}_#9`5i_vhukw(zv# zujBojoRfx@cQ2=rD3uLr`^2lAqbTinEh*yc;?=HYK6`$Fr&($`b{eL#&W!>__{U^E zYo3SyUmBK$TrNw_dXq)h>k`v@CAt;^h|pYJ%mPFfxv|>3U{s>yDgx~Iq8nI z*td&1>7Iq6PP%`FDbCOHA!$jC&-n%gs8eD6lpU}tw$g{q7uY9IAl0i><%YVdV(M3^ z>vt6ObJ{oCg&vjq9gV4<*{`ASsP}8ggwLz1$N3jD)Vg}*sGe7<2W#d-sGrm7*e>dj z)bEhgZ#b|LTR&%efB5!q>~1veKNbj@2n6K|g2rmdC&u7stj16LJ`Ee_1A?CeG5FD& zP;~p}p_~F>fTBVuPZz^6z0g8XAztU{_TLBm>_*&dp0JDBC-~XdTl;fTuZuO?QSzjE z9@GB0G4=E4`o(W7unXNK_1hIwKeHi4wZGnwf@un77`l3tNz<+BrK377)Bf90Kj*dq zyQu9_zwLk0_7~l!g1Zaz2ySvwy3a1HJ-ZR3J?qlivv?DH8|W>9pDi)?(fe3*L%fM{ zt`>5Ng!X?^7jqSnYcA74uHp5YF4g}x0Y4jnuuWo>zsYA8wMp=^skioT*w|p&UvEm$ zy3`I;ZU}QbCx7eE^;?hrzXpY_mqOP&3SBStTOU)ui>MKIxF|g89WGt3qe|y>^*A-W zXjShb(w>*73 zz)v-Rt{0%|9YEI$e(GcJqqg9fhB$_Du(_t|G~54}E=Fd-7J^RU^)VtyHrtsNUwCCj z%EBvetxL-7MHQ^Lz1e7^RKbUJDMw=}bJ+8ADC&+;UM;-Rj3PSM*<;s1Kzqn)TeIPY z^XvUOQ%?R4TA&|9+WiDQMi1BGp&qU$6AxXLdBjz)hpVC+9C3)FyqYgv^(yOpFiu3l=h z1+{5I_FE+TEq3`pOxBft_|LnH(pUL-TyX8R9+X_W~)c-h{ybbph zbGsn8QfSA@`*1av#9h8Ml^hg)VSDDl@Q-P_%6-;jnBH7wJ~kbJz2sRT;|e{O;1+ zJx89qo`-m@2OG8!-+Sbh{BOe6Yfr((>VZe{Lv1Q~Zd~%AR`Q%GNAfmP^v4B6NTB%h z0THrM@n-=d6xSXf6bQ_^qp;$nhU)ES)T}#NQ`K?P%@q0|#PXqmdrl_rqcM4>gNFD; zki_$N`;_72Oo7`7G*cKhKpXslEewNIwOI`j#xOveS6j>E5;{c^@m2Z zaO&IXDcy2H2z?&L#?wn8juS)@dr|C<-Jk<4$EI}QulCj2&Q9r(eN$6f=U^Sh& zR|f8qEmXWe-RVLG+=v^W2{Z1INzy!mE1)>Sf{JUxUkjDck;y;2+5VVKB|BU0U)C3m zj1>FfN{$xh^5ABoi6CUWA}$_4oFf9a@MuCBn%-#6C=oyI|InCuYbp!|Y4TNuSN5rz zYw-~^J3AO+uy|U>f2_k_GIXA82aV5Ax@1-Ucin$*mt8 z!E@)3wVqm@PjKhadAzZeJnNC~1NM-WhHvClXc@Ac{@kr0D;ZT*;NTmf%Ftz{sWv+=r@58|VmF^hW_WouqZ z^~25OA-!F4WWaWlmMEzy@?$L=WrzL~-m(8&g`@1ypR;h39qJwJI4{soV{r~iZlegU zt^D|CVXl)HZju&kpd!L#EN{&{7vSkANC~4Kk*6F+*E2ljj)Yof+xcS59!Je=LZW`2 zh3-ryLv=61YKCAotvbFzhoX*#K>ECnzoiBy)6!kRHPY26jz5yLBVTkng zZtNfAi#7ViW`_9S$2$H~9bRCF4?1+5+a36w*?Tw-Xkh$vI+VSHNKekh=WRNCiXrm1 zjwcKc^kk0a!GyPl!8o(&y0nVhHolsHl;+Y(^6eOHui;r=?DKMpvUP}OpOe(6z6|U! zmVZt}#t#0u39QfNpB0Hl^(0$%;9yW6hY_OVC|nl*G2`^P)Xb}`eZ`-~p8f1yBzC~oOl5(557{fL zKHkM!_4RGk7dnf%$k$ZLXWLo-+za+6|jZ z!&^*zpN_5dS7nGE@c!nTQ5%Ur<(@OdLNHhiM6O&gY!1TQ%P=h6Y>JjxDq=EAY~2CP z(SJUfnI2yKHLS*B`}6T{tk29H!*9)Hh8(T}GhfQ;yyj|?guleSQyzaxnIxP-7W?ta zo+ehqBw@NOkncgX!5Gh#mqK4;E=wR!vSr6tY6;|vP%^HV0j2Hew=ID@NDb2RhaiHb zO^#OMzf8DBG*NR9S$<-5WcBp=Xq~^cdqqh!gCf0T4&KnKo{B=ZSb$^UMXL~604Ul8-uX&@#FYI{pIp#qknbx zD*3W86j{~d)78+6zy!!O;VUl(#TFsD{5EI(A)sWpb+c$1m-3AcscdonX8A1Z_yNJ80nkq$+ecWhG* zpVBPpmazA0IP?QLgIVF*Ao{wUJC+v#xp~MTUg%}6P99};EPnydojl61WBC+b0Um7` zasyv4ws{mKcFU`JdBV*uAcKUIP-Y3e1rVfh#ZUszM>a}>plG=t0VODvK}1_nkzpLS z&T^r8z&Jh1M{AdijKru1l76jRAARW0Mf>nkzJ}|kK0kNpa{t>8G}nR!Rnj`$98fCP z!B7z^6Ds={}i&Zd)s9^arCysD97q;6~3PS0endh ztM^SaQ_R&Bm3FC2I@STHqqMo(;W-v6&J^~;VI z;V$|4p-_~zZOu&YM@D;lc;>C1oXKcFi?>#>cKTwH_+6Y14eo8>ZQ!~ENF#oqfOn%x zF^3bZQX9BI2ZO?!i#&mzoOTJ&S%@6s+kP&d5iBo$ybPy}_kH8wwC9n`ZhNXS92>Yd zAZq!(sVKwvYAz!UCT;t2vuF^iR$^;R+qXZvGltU!>wjtS6@R_qFwwe-*78=RYApy{ zU(prkzmDf;M#RFkqE=48aF=WS8(n{>`;<^1+RQUJqs=sQpfR<{{=*b>9F9nkkNcRT zAa$PtpLZ-LXr1+`%7H2UhbgE65+DmQ{_vzmQvZ}dR0@j56_li$5L^-WhPvZ*LGf*P zOe2>Cse9B2e%(Um$pKe3W1w5!Et&>2-dUXYQ1`brmIQq3xJv+PcLzsvquB~ zIfn!QNYe$arVCmCsE)e;gNOKWNW30nyi~<^-rGVmLH6t^)CO{-pb59R5_RAn=N`q6 zBDU^SoqHO$jT@G`)+whLYCVOE*Y-!#zEXVi${HNtVfhWG&`PSolOz9pk2tg1KHRd z>mr7yFW9o-4U}VZtV9b+^l+0%Hk@2O&20YK1zh2>IF?d~UV{(#vEl=MJ$$;a$%buN zF>K39**WmTv5p7mDO%q@T>_i4QrZ*mD|KCa@Fa}gifJ*tzLXZlTS{Z&ZHTXt_iIXX zLP)U5`2g_^h;I?E)!L32DX8r1g0<%jSe1TG%r3jMJ>(5v|3H6BsoJHjF6#kuHT=id z7t{TCJptFQ+^b7>4|=t8cgd(g<&~|Kp>O8AinKZ)zYG1BgWcVzB_R*a5^M01y#+>oeFb^lE3Z#)SeyTR!Us=>Qm)0mdQ$qeFvnIR=al4aNe1F&AJg5HJ=P zFhXvaXA3f(a)6<5(I&XS?xfB_jfTD*>0d{%04QP<-2m|9%a zwWvZZDp89nsYR8k1u9V~m1uWVf>ibV^7%8P(9VvEp(tb4jm8XtuFnI23jkn&0B~Ld za3KbO^BRB|0H7QI%n$%(H~=UY0CqS4AQtZg06_py5JOGcJ{vtP#Ex|q0GtB=^8|pi z8h~>#0G!nTlmP%Q04Ngx${YZA1%T}i0Dyt~=Nm~&Q7D7+V<<@*a)&f2odO7_0m57X z;gkm9bPNcmGzb#`!dQSXQ9zjJ0AZ|v@Pq>d!9gQ%008n5P*JE??$j$8X4#W^8xr_qiY6iN-YIcgwe)BrM~v+fu&(q`yr zMK#z zpc`R7Vg~?1rGT(sgK!`Qg#8+X41kbc3`YnV0z!rZgmeL6vjYUdK|OFF2XQFI{IM`2 zZvGWpd0m6usKGwe;7+N*Ze4?YF*Vq&YmkN-xPZhosX&^e0xqdQo1+3kMRlN}Iv(_4 z4{zXq#-v`gVmkoX1psCU0PPxpT`>T(698jREyL=6tz1fLlhV-sTVjf9V{yjdT8i60sPf8JD!;3T=sRmsFMZlAhv$8zTr}DT zkp;33rV3BsAeYuswP>`jwCK07vQH0g6N;04lFLG7XMkcidS^iARMw@l%raQEWg%mI zy(z25rUxYnb>5G|9YVVYjfV)bxpG24jsLlMCu=|^HPHCt9DoBj-9|}4+N59ib!~>< zSt`YQdnrD__6J@3G8Df%6jS`uCAoPsP`n&7f#RP=@k;P8mj0U8q0jK_i%C*EPry*- z+C6LEirU9*iO|L0$KnTt;%c9NQe>YfjkR_C6#&L~U!h+c?{|(D0LJzLK!WWJ8h|AP z;0rzL52+`J;(0Oz>mN^Gzs9O$Q#R@TC$s|WI)(eE<(|9l$9|c5^=tajg~T&OaqxIH zBeSqjM1TE{2HzubkLi!=8O(b)Q-sH=A;#4O?~SL6Ine6R-g}nvbiw52GP9w(@PJtv z^~~=EDSPjG@XV^rdGmOFfg!)5T=tur<8k z2brFbG5L5^Og_r6XT}R6nFzyxvDW63GoAN1<~NIg=83Xja=(+3DWfM9_?n3aT(cnw>pqRoep7FFBi{GQO zoYRqeO4L{7)>m5m=p=A?@>M&&Dv+{_dSF8j)q;&{DDpVAq`ikCjcnKx8+yPMAm1dA4H)sR5=t%2^~8qZ?W7Q| zg^jri8$9(4Lu^lM=%H2$>R>@|rFEI*Xo<zOVMzw8?PA%F#jVMUWk1%x!&ei07=^@H(_-H?*pu|xSw2u-(PJd>fs>_p3e@qM zaRGZUzo(2m1nypJc3}3l0bU#=C5N!dCuRU%gim4_h#m)}kn!%cK<jEZUVEwipXTKi-c96#ZhF)AE-zS)2`908w^ z5%BOw906a0B43Yy!}OM?n%nc#mM4sU9?N&UxO!r0b0r%92WwYP@dMxzalqla*Re#z1QTOyVP;)H~Ifk1s@g{5r)Nwxbs;*7OgL z*rD8mE2r|e#%w`T1_npdaMBcji(j(&3t$S5tyzrOnf5t6bIxKMJJZhN6(G~*JWG)A zQhOHj9tMg=J&S<@?L-C!$+oSQS|_=UMaj4+tIMa#L2dU4XZl3n{q}*t0PUr zM;@=He>RJYHbi70*;Ra^cKXVVwI^C0Zh5r(>362%u!;QYKEDbTZ>*cXa(dmy6%{M^ zS$8cx%JunK@$~xXE4%Baw_ca8PSl;if@|Mjb>piO_1&$ zCVW+!7zP_g-b8)7Ymiw@ck}UP$qWZ?IP?0A*hefQ*XaEy>t+9e1FUgyhG)Jsg#O0~ z^l;phUKZgW#RrFNgt$aDMz9HlS;6L^s<`4v^6z6v653(! zMT{4*cCdc&&v?*lKc@{W>|-(3a5c_;9#sw_VIj&57WQ+0y*~tZhTQiA)g`RA4|-k2 z-Sv_BXzPjA@9_8xtm4Bl4&Lm;n-dK|*t>3A$v6H6|4Lc%Lx!&6jg5ZTx=vrkH&M72 zWHEH8=PI7AZC?2%(imA~%2{}2GTba4^kPm0w+0fy`XN43_v&+Xzsoy-){&Tu9`w?} z)n6Nd&pUQFhH#=MzVDa@4gdsH+R#D|huDawZV;-v%OA;5L|sWs$9=m)(1&3Xj$Z^H zY{Lg9Qm-$yDp4UIFNFJXzu#k9H^&!pK|0~l zkE0Xvz>tKU(0M$GazC#+r?&b?zr9bJ&?G$jqir*^ z96bfhx;cypPYH6db3ZgcUhZS2C7gSIbRJ7>N_9xa_uxLY`)&KX*a_`*9djZti|Nry( z-_Pg0d(W9O=gxBG%$b=pcM8Wz|Bi(F_$L!v9&2?-L39DR`#M!|w8t$8S7zsI;>~sd z^Xyh)ci)zv?@9U)i5$l!g>H$m zxN>jb7JK{=f184diFiKfI7809OOIY`cegGYbSOpxJ1(Pq369~C`xdtR$aB&updnc! z3wpJ3ypk$BOsu zMntoXW7?rG#kNFB@E*%JE{tg$$J>uH-kRZXX_g3|;kef!{M1>lS1OxZ76I%?;e9WC zfTzXZQ5D3Nnr61S1~$fG>W{DVrXC)d=o7~SM-~py_vw%d#J8L&p(p{BiKB3Bnd>W;<~L_>eL23mr3soMBBAn|f$Fkb~iZ;DShFb0bUO zf)u*p7@1bGP`_v_-cvKgQwYQLcG7sqR`j2jwj(59TNjGEOXyOp&9 zlwN~{g_8=cPDP&aNuKO6y#~jQ!*`bW-l7@WHfp}NXyYZ@(9YE3Q|xWjQLKck+ot1g zA7-BsGWRW}~^65Fanq5Mquf`0ygC07>#R~gY55*I zk>tm;_3>C;)re$1ggsVQC66O{3%gg9u4;tnlKkitsLL7w-B0&)7)f+b1bf^a#$dX+ z=^S4vI}^DNyZLh`qIZKQm(AaKF_SN0cQ4+rB`25xpay1NVBiwh`IrG$2)mjlykj zMw^yuzVTpeCSNfPClH->p6OYDTai&fNwi8L&0PMVE5}^?5dI#ezv1+E8U4NYJD1OV z@F7>Kxt&Nd2*-#YAn*wNRngyC`n!yX|NbC|r*8nbn*Kg}$Th%hebenSdu>FyU-G6q z*<7{(Pg^N8djmozY{b*AH@Nzn1L^5Rqve=C_|R9~eGfd_%s1wFPl4I+Jig#_fX;b- zk-#ytyqV^}KW2K(lARvExtyNX?8Llt#$5azn&sVPZcO%i@3;)7L!Y`m)0^CvmDZ)( zGxHMqnnO~&`AH*;5!HubiSuJU8*hN%IaCam$~!*gRS0ksP12v4!OxO2kFwEas@6xQW3Hy}Wd*iF%n zfBEv07E??PKg(|i`K?bULYE?R)K3|UdV;S5T*u)T2wqOH0Vnn~%x&-Zvdy=D>Q1NZ z9!21d2<&wSe?PyS$8UA~b~C@#cloF=o&|)DNZD7CaXZ_vP8e#@J~Y-bb}+-0XfW;3 zqKng~u;UjvhU0FOfS|cYz??oUWNgw1wrlX)jtJ?-Ct5g7TF8r-4ihkcK?eJPmKuJM zgC6;>bwqF*AqN5945l)8&_VAtp3>-F*Wgba^qEE5e`2NOYFl*j@No+x0Rfq}+FTKIQu zIK%{JsUyN5<3~0D3%^@~H#z7FjAym**ERT%gMO%yW_3a+e@f*53&G(+0rMOTH_p?- z=Vry-&k`_I5Xc0TIU04~Cu#6>0rMg)Hs)yI^^Wi}jPGmV zcR0e&G9Dn9=byju2?s%m@tVfq14sB&BO#5YmHkno`U;pQaJq4-7GB~AFEwTZmhWdd zu6Gd3Fn*vhxXTfKzOhLQ-yz@}B*usH*WcB`k2=CHHnMx!?`H`ZP4m9EID?tSxdJ8} zQ zjo?-XL9OvyEqt3Je4+7{7XD91_+q0M+0x>o1om^nA!C?8@Dw)~MGm;hnCXD8HWoPG zrN#;ee64YZ1HR69$N@JSPdnhya^r0WVuf);z?5i8aRT4{Odx~Z0_F*BF@`(f8;yVi zUTMs7z&|wVRQP;jm2rcLz`0d-I^fmD!w&d1vBsm0Iq8coRc69t?!E~V&BcFk4>XrY z+@5e|KbW?oGy8^rke3y19q2Njh`3Y2*Y@+8zW~;}FXHZR-aa(5pXoa_Gb@~#pO;iP zb~3TaHs_z3+28#27B|I9Hk%O7On%JmHJ>E>Y(xw<_UmuH^eBcZcWlP1whbJJUz)l1 zQMWgIcE99sa;_&F8k`)ye;~#z5qDbnTzW0&doTT7T~*cM>S>MDHRfj>?t(iIYVLc) z?e!K;G?c*kh2e*D`-U3^rkE4K)s0UED52pS^7@;*I*_hO1({wSKH8)N&Yw6wygN5L zapHLM_JYj5?y-~A(6BE*C;VdH{&x(?bU9Mfy2YJip8hB@*V@%BwENBD_>1I+JsARlRz|E9jl9yRt@|9JDsEr|X?URwCNzFu?JBPh3lg_*gg zJK|0^Jx>EndBmNSSUA!2Kkm*Bznq&FZp}+J|8i2Mx34qf^T&;)H3sA_FLB&h^PQ72 zv-@_-y+wf%Ad3E|ShWb|0~Ry`&23vC6)8wo*&}XOmLuU4CQ42e*uVdTLPsUc2P_G~ zyR#t_zU1)KL4A?_p=J@P)O=}!J2~6I5*}?bidpcCJ30KD?5yzFzGQRFR+P}oxw+wo za?{MGHo3h%T^=TyKOUZ$gItFX=VzO1hiCS4RNw01nR#J56>K!HFknivH&wy zSuyg%0?cjCBV|(uWtz9+E#?=yP(gx@LS~jZ^I;U{t^xhc zKBF^zVGO#>HM`us%tuFOW}6EoiioJ$<(SWm&dg*~hhBmx+Swo#eG85NqqKST_3!$vTAuifo4|J;tJ$(*Gp zeE9&MS$zsiOuCB-#r$PEbPQhED}0eJo#eIf^vuEG-}pS{ZI8H9%?ma{cYKkZ7JeL< zvX?OhlDpBJWqz@N6pSy2#3u*Bkz@X1gB$Y`54lr_hufby*qpe*?J=L&#F_L8Z}g^^ za}mwFcz9--c@YJUAud1n=CJAu|HzvaZt&)WCgVfDq{_*lPF%}ZsS|%HU{k>B1PpIk zvRM-E7Vysm{Br@f3iy`-{*{2&3-~tzZWHkRFnAcl-wMP7g5W^`ZxHZC0b_K`=pPaA zV*>uYfHw0ly&N7X`da zz`F(fih%bB_%#9V6>#Wvfp|k8_6zte0smRR2L$}Cfd5Cpe-W@u(EkcpCg`AmWrF@D zV3D9u;@<^Arsy96mI*p6V40wQ3Rorx6A-KfWr7qL$|hO)mq@50OALRM;X_8EB2+9O zDk3Pt#qj?Yctyw<{tJOugpJ`761Y$+LdWn)0)Iax9QB_F;bQ^GB0v#3hEElEMfe!L zm%uAR$nd=dUJ*uy?<4SvP-f%(MxsXqDALIy_yqn*QN$2ZhR+gsMOYcWZ-PO_T4MhM zW|<}CByjp?joA2|81Tf5@KT%zFUP^Z8VA2G4*pFG&nG;rlwx)(W`f=k_@N?anAKuA zelHIGuW|72>v+s=F-9Ng0RsPF9Q;Rd@Q32yKaPV>Ji?cfmOKkvEA$-H_Y2RthnN$d zcMmmx{=7TSocTO(_dn+zW`6n-`Yi7Yu&Nj?_&jjT;=JWK_h2$I&AJ!B1c4`+D~4pI zm{VUs{9Vr?{#!4i7hzEu`0bY*V8gTSVPyQ7Z$9fDY?k0%WYC!iX{UL+j0j^xwJ z+_)2lKz62vFCy+~FCi|o15j+k&DAd=+Q8=!?GPC||JV&;lunicqMU}BgI@qsn*?3{ zFepCN9KbDSj%4%K&o@O?Xl{Jfm=+n3BUC8iy*2 z1Ep5wuutKTu5f^X;79|d$!p%eI5YbUjl=s22hvS44d|#H999wsR(!kO^0jIP9@F+^lh!p>W7iIBd{3yeB!BWq56Q#cG&ILy;HjF%kp=V%=6Q#cGach_WQS(<{}_Ppld zn#^IRZC0ot&1LIIOiejMg}$A;+>^`xOqe zG!E-64i{@2aug0@6%N;E93HheT%~assc;ytaJWdiQ9h7xVE673x=+Iv>g-_l+@Tj5Zwa7cn?K_p9dj#wPN&^Xj897yv^ zm2{HEfwo<8#X1Bbst{bKa5zihaIVH7+u|@yaj4NatW!8lRXE(L zaTqT-n1?R%Is2&l6c*DJ78^AdwBdpm!~Sj`wv zM@vhKDhFef&4DZ;q@7tk3pEbwEe{0fIz3WpAj!yb#n z?==oH6b_du9NyJ9&?c=MGB}Ff);N?Y94=Ql^iFYBh0DC^Twnj9RG@o-tOP&0u2Z7V z1}uwlycT^RkM7r^uTi4UQKElWi$0!5ze0yk13da*pnHL=1V6e8l;|~pW#wF`Mc>Y&lk2-0eXfEe>yM9M&lu zniLMnY0mN|4aw6$tJ`WBZd5p2t#BBrak$LlFkIvCjKX25!r=mq!(xlWxf+K93WsYI z4viXzl@^CZ8i!7W!*vRWu*TsYi^GpK4&KqWBsVJ@+BFXJxdL92k7yi5Djb$89NyG8 z?6f%S)i{(W99AeC{;hF%&*E@Y<1ky{(4ue{j4D_4&1b~HyrC97A3{`lXi_-bsBoC7 zaiCM8s2sX6SfwynsW7P47@R5?WSv>AC81T}@I!^eDviT*#$n3!-IB0bVX#VJ@PNi( zu9bxQv?T0OINYLe*rjn;YH`@9ad=yqqz zy4DMK?|k54m694@*GJsldmvQywoJna0~rqcR^+AZ2iIr&nDbnop%>-gC8r^xyhups zI=v7FZQ0650->xD(q-{28vcT~B7D zwH&htu5K+NX@qK$P9jBFf<-eNx({WMpKt z?Ov9V(|-7}K3|+}UbxtmYrc54tI#~V($!=(E^__3{i8Eo2NK#>%y&JR)V`t8wJo*1 zag3|Q)BeTTuFzofwgX8c&A%qN%FNP}TvxUKF5xyS;6b^W6pQo2R&= zXSbVIqeJpPbmQ+EuqBR^aFRl_9M#^-%n~=yCFHTZU44J zZ~NNa$%$$0Z?`0Ves@}+uGBUTiVy(@46wO{im;|C8xFj{4Z%qY3+Bula}H#|Md5? z73MGho>mYppBLLb{bO=U_nNKG<8R~7@VD!E&sp3(efgCDz2uaB4?V$AeNd7I4$v3f zy_y z;cDGy9{3l$2>v6$AO7)Jb|6SN$qzQm2!f})`4&;O5OgY_{P}=dUj(BI=X;3JkW@t7 zMTo73eQwKn-ffO~$ukt;@SrEx?!O}*Zg8WQZu3(<_6?98_4%ojgiroegq@5R!NER1 zwMbxp32bVy0N`&wAT=O>-4t?$0N{QWR0XUP!6Nje*B-yyao0t?6d0jX02 zP!9T}sUU%$etzmSfxVru(~Z92n`>mkpCnW%2;st?pL(t!JWSXbz`~ z^YH-Z{`}Mn1l^@aKzAXq@b#A*Zy=m-`{1#meY&I2a(JK}v;eF8qSfyHhC$@`at6B`F4Za3k?9)kR&?-GAR!26yh{_}}{ z27?b0_j19#{8PlLKwz)6psK_}c?MEZg@;kVq*e>MCyA~G*z*XxKwu9Owiehrid~0? zgg%J95D(axKrg>Y*`JUEGb|J_>5$uNWzH(rx+JV z7zU&dCpv#u!YqE8ZGCttyqEEP8D0Pw$I%#fNJI${^frDg;TD23*g@VLl>oSp@v;a< zFkrXwj)2LW^%)*^{53}kUf(IM@1dL$71;!`=BN*@y;|u|B zBPRu)G1Rz3Ab1Lg8I=Mi>(OTnH@+ufmcWyYA4!-caD>q+VV1y?jmIR+5;)R$PQYZm z`ixP=djj^8lY-AU#rRwxnixFVps!rebpSsf%-(SlM$UaWaFXV#>DtB;IL4@xFh;{Z z<8^FWX;lTtK8Z>`QS7;>u$V>hefhc3}IOCvzd4k3pG`mYzD@(uxqaTEc zt|s7p#zf;Z0k<%Ck}+MtUYLR8^FCL=+wuu6GL~{UWVEmp6&tGs0WYF}ale3h9iCx4 zEnuFYGmZZd@Bt*kXPjjuVAMd@0hYkCjllxuB~)UZDPdMZQw$pEApeHJi)gA56a+j$ z(~P?WY%qq?jfW+Ss`44<7|%!;3Go@F#sLYlc7LwXDPb>#&oKCQM!d6t;PZ@8kR^IQ zoBQz@=Ns0(gcc&Wz_^kKaJAq^PVS8Y<_WsU_`ZZ$f-W}JNth+*65~M$vjojF{wQIV zpi7N?fZ6+bie?!fNrDo3;kOJIii%w=1Yc&j9q_k}90z>4VeMmJ^xrYY%J343KifFl z0bgNYPK&=ES{4LzjM*SIR>CaBbB(1EW;yzq8|;M@#!Hfb)p?~s(@yMSFRU^SOPD3N+He8St^#^tjgc*3mf!^j zO&PJPg~Dr%$r3IhxX!pRBoU0^LgPvavji0Fz!C1-dH1H#<0O?m2d%t zHyV#hn3X`2v0cI}L01`}eF6a(5w124N&;2_ON=f7Q%-&GFG$6ZoGuPuLpv+jmB=!1 ztuaKvEx`JW?->&XT)^P#q)WLR%l5}$mid&^=Y*!#EuB?;?PWB=HUD}_=1_CtAKaPY z1A{ZeFAUBKcMQ%l2mb-i7rp-gzva;2?C_$&-tg?fp743N2XG&admeth@#`Ao3m?R9 z-yolP=HrNU3jV^s7?c(M(V%SeA6wxZ@+SVm7sH3RXb^l*9*0Y4>sC0L-nK z`QehhRI_V~JKubZ{+`(49uyvxHz?d2zYlX^?8CL$Jbw#(aNu=2ApG&*Omoa$xWQka zn{B?a863~g%`tyV4+C-s{3Le(k$J<<4ahdn9+jCA-iin2i<=II-0<}S`jV$@Kl54q zuDecZ9AN{K6nN}=f8>s-2N&&eBOB#L}OpW-!-qI-kzqv{;%QhidWqO zX>WnK;Z;P4z6$TA5BK8lt$hGrcpZN~BkF?sF@psKra3*`1{!V`yf8Tz}U0`maKS*Z*NoKnF zIdQLl23~Q0eg+lkc?Qkr)gA5;=DE+{ZwviBv;(h&h@NbI{2J2p(>EYnr|bp4y4T=k z_2_GO%GwKlmm-v$$<5c0MM!9}`LEZ|YJdC&-Y|~xx#kVv&U^z2TlNM>UU~y%G?>6S z_~S0%Gxs24KidQU?Nxi+{gN&nS7=u3K^ivffq)&_PAS~u#>W)LnjXq!{VOP{f~Qb1 z8Bc-WW&(5fxZP>rsjgd4i|;F#?pIKb7XW28Z%5$S+ua#NmSLX!3VhryAY23Cz{z6{ zc?#*B@(S{D`F2D@Tx^bc1&r?}x}S--c^up+qGgynDeh@cK`J+HNAYbV@KG>eu4KDk zLGp8-MFKp}BE`?|ai4@!Pt3RWpxDMhI8E=XC{KJZ?MZXvo9;ddY33i^bPo-&ZUzcm zUQ(yi(1g(FT-Y_4l(PizDCxe3X9rzxAfVvoCFyPl!a)aX6HH{MYBPL5C+rUdx-@x7 zhC6_8FgzKE0!d}_dsnAB7l;x`*Ju-dt`pt_M2jS}>2mQ_$BW^a%rTr+CXf#FbkZdn zEwo76mv(!rA)8ZCu;!&%o~*uAdQch#-Clv+78}DJm(LL`okhEb!cOw0xdE|jGd-bt zul3}HEF6t+25R7n>bo+I>QqYxjr~AZ7H^$ifLlCxfC!{nwUYwF- zlu_xJYi{;B^O=*HWNc#vM{W;lq044OJ!Cg?KEKiuN&$M)VMm|e360Z#)Damo1f1yeO?vuVG%UsBoc`MXY61G=*A zbm>3~etdyp_R~p*pOwN%b`XoV3L&iM`j%)R?<0hj9Cplj?c%v_hh1#Tlwuo6Th@88 zg*8qicLEWk*f!{NF9VSgz9pDTzHsas`8H57N{oh$YKe{f6bQfhVzZ}TxMaD@s?3oi zTzt*2??@E38lwaue(dJ)WM^w3O$cdXg+=S8YMcWIIlw}Gtc7el86mtCZqkBUN4bn` ztYFN7FG7M+8rJAq3;~x6$f(b4*Mie=>gexE8J2g%#hP*U(lowvdt|=N_ zL6yrG$r3wX3z>lsUgy_qA@?DKXZ>z1B&XVCwDJt4p zrmESvuijRZjqbWT@v0cbGMm%6tupW2EJfmajfHm$ zM1qyry;?{KLRh(&GiUkiwy+UsE)Rd#BCP4K@sGm+XdK&=?;27wBXp&`P=wb-JUV zlc`eZG7!P8T=d_E{tYV0MIoe}{x%`#k|91y7bK%xsMGZYT>%)0OVZJY037@#fNo}q zB(u|Sn@)HQ2wS?-ZP4jHNfsUS^IAyLr{KU_&j0E`|Dqu3p!>RDBB=>%qR&m3m!f|T z(NNbB^lt=#le}a(pQY0!LnxIplXP=+y1t+*klgHgYvy#elr&8MVM%wwbvnaqK-bcp z?zcMKC$Z_aI_MxJP2^S-gW+xmA?QAdP4`!w?iv(dN%sUsb-KquH!=pH7u~9(NZ-K6$dv@>8 z>6UupGZxfDM(RO{Kom#@b^=Rux}iYCsDZgU-B=)6y7ODg=_Xn_v1t=9CEW?v z=nOvwf(uNW9`q>%kx~f#Q4i__B1Upw*Xh!*UJ#=MkLYw>(8Wk?2GA&JrRCE%D+;=2 zYa}PMv)=>+t0Yb4?=~*z#r=k!7y-tJ zDKBD87x@jv`efw9332>}Cg59=?E8t?t2qzLiKZ8Xhd$KV{rh@j`gtl80i^UN8{v-% zhPetSj;UlbU+k;uW8QS%m@YFs-r%R8PCzQv{H`$ADX0$sO=W=UHc~0O$pev|k@hzt zrvtRU5jk!gk}WUk8#OVGZ&cyL@qY2~X7Yl^W#y4R-n{0qu=R=b06r0(SBH=V>BKYCxp+MpTmwP3yqOMxRVS9Gp7QmPM zz4+Mv9Gtx~;JOIz9c8)K1#4#yysqs0l9xB-Hrc17{EdBuSUn^qwrWdoo0s0_8LUbc zG*${$n7HVWh*^j0$efWx*g1s`oRq?Y_^0pbOsj+$=Hc?ptjse7AE_Ca3(Z&xys80p$Mb2bNGmr{8nLSZCza)$J3=v;1;&XsM?jp{$ zi})cV=G#^gH#9EoF3oX{;4Uh}kpfJbX9)u-t~3WB%NatJb0N!D4BS%ovR1JF=qAIl zzoShDogYh%X_uQN$1+c{bUDoAm_I6Vd{%5ZzB-N^Z{>3QAzs&tpDo8^ad0_q`LWkW z`pXvM@`kG8FXOLEW2Ao*8bjtxmNbW1N%Kdgq`wi3!SobaZqUy1cqP&fF*U|m7+G97 zXB@Z2po7r{tl}pq<*o|Wu4BsiC!2CxzJzl2FpWVv)VfGHX9DV`F|3@)vK9y`?C=Fw z_u_~D+_uJZn^YXsCWwu$IL-y`xE04BTXAdxv+r1ngA|o0Xj?bOvCO|zHyEp=)2DsO zl0K1cQ07b)G>4f`^T%&msF~8zg*skQTixKSV|9a4M^i!PLZt6xI@(#lC#0i~A1fhq+;{#^oJ*6f$;L~W=TtBO%|_ZfmnHy<;@W0 z=N?Z{GJl-1#Pdo*DK|d!a&8vJhhEOxdorTqmNV%rQOvfYj<*lVvOeY<-*_cnIj2wi z(&fxmbvH9wj#wP!Eb}IdnP67RF7|{%F6Bo%ijvlcE3%~Z;YyDs9e23G)Rr#MaZcf~ zZRwfEV@vlI@+{BfeA!XHhq}peoYCMhWSE8;mJD0Dk%h|;taQUaYU*X4vjk(5Gh$0{ zQydBI;1c{k-qVVoZ9bEyyCT8A>8_WLw_Gi~{1r7t`ZuE~nDV8($x>zrt||EAH>W8u zzcc@;N!rW?4zP)3JQw;Wj1?1+^xX+u+E`GXhz!tC=2fRdhULMW0i4pvk5TG$fSR!CPgccE(!wQTy{Q9 zuUI_ZWetkv`Q#b2aT?Sy?8==e7ppNORa^m@Y3?6W4^?fIscy2BWl=Uu+ zUL9>7b|{o|Q|Fa_s{3fQi6>)p$)S#xDp4tU*WJ`P2j_p&Y!^LWp*+u4p1Hwg#^{4+OjXBhO6IB` zxeLx_k|q9VD4d072(>XBf@?RV+PWH?;t5Se5BV9 zS2;4CEe_)(n^_$h-^&l1li4sHt!VJBjYsyXIsrG)~VkU<25VV8PDb*%#GO| zFU}h1WwboX+ftCVq^#1&)sf~u9ZpSpa}%|vNCUN}8x@JWL}@J-E6*1x&ljQ7aXVew3@dMbOU>U1RjCQtegt>n0mn)3GSZ#5+(~ zq?iIxEB0TQKuj0<%Q$!1wBmx1=U)8nf+<(mha2Y2j$;`3*wo$>Ry^X5^jS8ZN%QQ- z&k~TvnwllmPK9Qnm`2;*l$J1wW=!-~W)YPbW%ZPjo?^@8%HP90#OsD^u45U=Hq*tPtT7*^@EJek*WZMRyc zLA+ASr%)|hGq_mW-l~0IQ%VV+j!}_TZEso;S+Ptaw9Z*{iRyQk+O|`xgqDlXJ z)2DYmQDzA0mO7^;*&wCOdY}-xpq_~JuBa#46Xcn#RdsZ6(6Y5`KD3H`Mqp~kQsovZw$k9Ksf_O~b+DPr|HJ33eT?V&04IeE2#@<82=PCEI1 zr9W7aHjHeUq(g(5O=FBs*bNKkKyzqeU||KUt7t`Z;ptu9XXDrC0u}{*4Pi(|Bfzxy zqm^mHNUVto-H8c={Xo~E$RgrFgBcbB1J)pqfq@U>is4RR!O_O%#=XeO(dv%sAVwn{ z^~>r*!=i~<`^m4akF=Ay=Q-eXQPnd}k=c}dxwD!9u&bd!+X3xHSq(9gK+o{D&_2(o2&Com)I zKJ;UNS6bS&a&cXgoJ~2F>=sRyE0LiYV1i52uF_4!SDIUj;q_G*6kG+rt@2R^x@v=U zS<^{xnnzO#?wXqXMhC-mEX!@`?+8t$(6@MK7edomXzuhapzl5XCr6C}%zzB2g9}u7 zb6sHJT~l|zVmx6yaU4D-$Iv+|ksnLvSj8fBjzF+l+j8{g&N6Bt4g?du$?%xHiEZyNtG4=D#pL`J+TypM zOEdPf`_Qhc2$XimVlq8Rq0iZrZ~!3%+$|=ziJK^7tm-j~tD+(JJa#Q&RxA34mE{*Kbmc|hjQC?gfq9Ytsu8m(MDjDnON#OY!4we|64f0u@*WZo@f?gGKrhwoji3~XYotL&>>Si zx}ZWaaA>@XAr}T-kp;?N8?puS2Ifp~fnxN)@aD7h0R>Cigw4{2>Y_Crje$lf->(Sy z&c)a~SX~SY1hrkC$L3Dyo|_-6CzGJLG1^dE6Ri$3bk$RwNOh#1;zVkiYl01d@<>A- zALrqY$({x_+0%&O{DNqsG5St9oL_K$F7id*3y+8i{<|>2PtQeS^?)(2*n&ySyD-I{ z4kw+c#pWF*YAY4%B#x9FqjwvxN|{xUQp^N`|e|nOrt|JTDkN%uOLu~FpxFFa_ zL4gH<#%N8Xv8&-vA0$qT)IdP2)u9NRB%mp9l4l4HnEF|rH5$S$s@7e}Gf>BWJnE;N&1IW>xAyqNBodtXdayBDQE*7bT=*Xx;e zy?n!U$1DrJD6pe*9ZE;!U!vB6(K`Ir7Els)bgsek8b8Z_MKjuT0Gb<(2Qy%FNB;R- zm{s7h^DnutmM`>63?Cqb$e8CZT!|O1WG@U=V z<9E~QoNT=I+5?{#Kv`EU!+2OU+e=$?hVSgAIUZ+pmS(I#$hNM>`72ud1IKRf$C%gI zjP_*pDogmf18Hun#Y+^m`Cb+QwfdJvP-J<@#}Xjap5;Tn7~#_=c_y0W4|z`RQw4LR z6;bR4??U5LCV8->Tbar$iZz6ezqvagqW{G6}4MvIRC6C2Dm6Ep!k!4zCjMDgmz)@Ja!Y(W>^N*ZL#e z97GEa!W^X58)Y-uK{k^OB@%K>Ww#%lC(RTC|gP(=-KG$AT_zEtune+e(NdytQNm^vn91kK}(-@0CB{pnY4 zUoAKr@{*4wK&b6&u2}5T+t+XS!U-*tv?7Y#zLugbDDCSG zfYwwwKJ;wOP}zgXcqO=Hm! z6kA?WhNb|a%FxBkDCN}2=S%kEoIGRK@yVcixnXWGNnr@IY@KV)@lnklVK{9+N&*5W=K)L9$^{< z+J=@~Ed`EoX%qplx9T{vj;bI8q8LVGWaMIuDl#^XiA=yDG89{0@kHjV*dnuvi_GS3A~V}5GRqwzGa;7902g!W>R6sT z4{PJa9i3bKFDhcgbxQ;-b_Y6-2t**lytPQPKvh7fc62_V_U&whNn*C6^FD<>5@LhQ zDCPpVMZ8h;VI$DU zZJjlc&=vjwbo4F$C>zeQu2~Fc9U7MuZb%s!v>&bU2QkdJ+8;n$bdD$@Rn5@C!SaY0 zQP3S4R*WdNvJu5rBxoxeQJlJg`@2!KsXaQ)*UJGhTSv<}V@Ky^MB6NS^hfdhsG~=B zvgSSdc0~in9wDEA=MG;~QrnfpP^(Il0CncV72+Fr-V8&J9z@vf^X zs@ieTJ!~(2I}WA|D_$5}xNPy{(Bdbf+lCcm>TWNP^a5K~N1&LwaiB7eLNRj%&KY-B zZ>ipKFdK}s5#KeexGq?Cw0?6veGlbX(rzq8t`y$T=mXPth_eV*)b zq<+s(HMqSTq{^C#WmE>F02Ekyg|4Q;5t_2w&ZCPw2qYWmZazcMY^EKoeu0t#+KUN(>KwAQ497`SnEa4 zALn{e&-!8wiqGna`QngThZ4i|g#>JUk+6oZ9O>Rt+r`S!46WYWyxyqlo%OaK7{y!a zGk~-0l>}NjqEsoK6XWA~OZ{IvT}#$?P>es1ce)HMvlFw}k`=pKOIBpf zGZ}&1jSwtZ(Jnz4-Avn)m9EFMmaHghgk~v@JE~l=qL|bT9)HXZv1COt*^-qW)m~z9 zE?LFRzgV(j`6m}dEfY4s6I-%6#$rPEB`b$?a%tew$)6SJjJ0Z|yXVMNE8RV($5kt3 zG2un@JoW-QThJI+=v0I8q!TNuqWdCuYFt|P^;2yW60IVy`dEATmQ@s2G%qY#cth8{ zA9t105H&Vk5hkdM7ae7E9Tgpz31@VnZkqy+R(4c&E!wh(7&ccnW276K;TG8C9gCMO zCc5IPV%XzR>=+?C${2mWobRY2pP5+6-csIN-ch%#ZYYahPE#j#bnaz(*)eVHgkuO$ z2Kp(h_q6KAnwzE#KH~~WfRYesK75YvT<#x3@#Mv;r~67&Nt~6aTY4J8D#CLu36HdW zCi-KT+2iB+c8#}|Jcq|vi8}4zp`=@ssWZ9#B>KGo=0JiK(GYDtX>TEqM5-CGddVNT zqb?D1!+{EVE?!7eo*i}Yk=Yfgd$a%d4;jFk|W{qaU7(^P8=s4gf|m=O}}F#?0EuBbVuiV z#*WSd-W{F${8^p=RE~`I}iBZ2mxFJaBacfgCi1pW8gXboS~(d zTl#o(>B`a!%rRw6Pb?i$dT%u0<_o6ZSt=#x{L)K4IJhLMl-Qa_{{d$2`@8+G?IsB(w$4N+fhBOK3s7g#PZz z>33TRor8q_Eq+2nc>VFEw5Nnd7IeYg6vf#;u%LOt-h+c!0td!R;E)}id%Qb3cOhe; zJbcib-r%=dLA7PVsM<6ao*yP<^4-JhY(~;_~YEc1LaM^pXAInPi%~P2u zU!aKc6cS}rz;#q=IcpPWmlz05_Sh;PAs8!2rWKCOOu+UN0FqB zNYbM$NslT?I`wNwQYccMb%C0x zs}QDI_a01Sc``cB zK=4M#Ku}T?S9a9OA>fT4D?>o`IT+&6RoM}$m4m+<9fLo~q@${%Ru21a>^AIs%o_G( zY02v-M?5y*yP*s5wDI2iY;~K)doKBffw*R+zP$YrYSpqL zhr8B)#3x9nfQf234voD$iO-e3ef@|&_kgq&F>J%}4Ah#kqFn~iTG5_3F_t96b!WvF ztN6S&`NZPVBtf6Hq7`jEiVIXn@YGRe4DF~Wu7^ADeig1Xm8P+*>ET+*xbg?};*s_>R zD%w=lRi8CIS}jf4qxI>=(NI0NW0^;kpF66p#+vFNEHaaW8d>=3{LOe#u!h!>uQamC z>_h}$6WECeFheR0omDYQL{LdY5lh4}I8rww5kV^vp=C(LGA$8uDVq|(m$G|G1oixO zA|hl&vEIL95i5yBN=Yn2NjQfeA#41>OCZX8#AYOq1N$0wPSq9lP&g8YT2EYC|?1i4! z&YnT*vNQl+Ojp~##IRoB!^U*76~tFED5kvRqrQgrnQ%;<0Yc0ZSYA)1+%c8h228&q2I!4FIB%)&IpuzopbRa`JdF3wYO)FkkM zm70VIjbzyXtD}K6$p)STHn`f-z_inXjs;zf&`t~Ft0Rr{;z8Pr|4@FxlqgyESiRR@ z%+!xF?`+)crM$Bj2gQqN1Xa{)0rlMs1}X^(>$DR#BI3saLdscw1;4UUxHIcfWYuAIgwBviC*qbbtHa@OXuC79Ou> zP~9`jeJw^psC!aEm@T5Q(He$fgSUejND%r4O9NPmx{{A<9U9=?-cvvL!PMVTJtzDy z=d7|Rf5XS8kR)s}W(Dp{(jRuChwxHaaes&V_(Y=^CB!uX%VPOF{84T1ws(Wt=2a|f z_t+Ur*5Gvhr4iyFFZnnP2=wFDq~fQd-RnLNCA{6!w{TiPZnt|c+Nk35Fd3lb^Dt>_ ztUfMOI@EQN)-l^Rzvz@>w+WA9(nui0WNcC`t>(=}qSlV-r==9Hc+Dm(m zaa~VKd(P3F&d^@k>psRip{2dEX;UDc~l;f!YKD3d(-xwB!lX`^hskpK0SMXP8UThpFu8&}v0KN)k-RT3MkFu>4 zL?6Kj5A>lPA_OY~^#M5I6)&O)QH&gWenF%HdmovLJJAO)9#!e>Vd9hnRHr(-99Wch%OUGJ49t%BSX(qO7)*)u(b|6-e5vYh6#gmupNp$yv znm8-S8~Nz*09dqwhuxFJ+RJE(87*(uXrF5yA4kk4(OMQ8J!UuYgjzjG&u0S-l6j&# zoejiJ#;{(E_BMvQ5c=PAw|un&f;^Nnv&rT0CXYrMtpkE4jgMt2$MN=_gk?C9(WNJp z(Sq0+W%G-ylx0?@n5Vz#zTvB7)n{k*G)GqH+#`8eqk^wHt3zUDRm_?>^7`ag%VwsX z%`uK_()T{(Wo0vt%jV#iwaLc1j!aH5zxo+oUb{lc zpt73i0sa~&?ady}fnN{pKE`^rRJ*_j>tvpVmAs zou9(B^X47Prp)K3+R=ds^77(=+A*oQck#0fORE;h^~pMV4p`f~8aEclyCF_`FT=Q4 z+}ZhZfNvApf*LYI7vwlBG!# ziu9xBsrXS^r9V|aVX*3-1S{hP>l)B*1UXV9jx#F(GC*vVysRgjz3jl zA#4OLdhde?E~}H^qW2@_@W}TSaW}`atdS8;Vq}LECY1&%b{ zLN?-&a7`5V^TmCh zxc{Etnfj%(1(VsAdQC{wlV-_KZ+5~SMWSc{G?qk72NPAI(u71^1Ux3rns8&+EG|(k z-6YBn#;4m7Mf-`qYf02(n8xz5I^wtzWlf^*2NPVHM0HnY6NN;@szNR=Un*p_(1{L- zunuLh97fA~lpu@VKEx%y1hJ)3H`7n%%;!BBA(Ee=_)*o660zh*jsm&~5V~U~KsEuQ zu_`ASnu=$-&lUG;#r-$pt|+LbSL47+uh%n(DXA3BkECh_*HhaSsiK`;v83u8uvMk1 zQ%wGmo>Zl3DwnFJZcA^1a{MkiHa5a9L8NpKuu@XKYN- zO3C5#GdCVGrph@QdAiAo;Y80Bz=1xy<$MY|e2}JzoGk55?gS3DQv5GyTy9XETJj=? zQ&L{&+)S~s{+Y)Ukc;fBde^M+tWNk1pT3;}CTb17!D_JE7X^m%3cL)Yt%yN=6hAlf z2r!EOMGnf|^1mn=8><3gv&S;#VB<*tiz8YE{(l>1P|8r0vq>jV(#q=~u0giW@$ep~ z0M$X2_%42yMDUTPl!tB|kPJqY<27%r9>_(JNmZ0~H)+VTB9^L{hWAh!{q#ay(xlN> zb9yvsPP0|TI=shP%_*WWuDq-cD4wK^liyTKC^H|<_GE=x9{ZtU#b6mTDFB;;v;=+I zgqp9kSLq~aI(|8+6vsN(@uz^WS-vz)=!6*Ay5nI>%VZx{GVPfE3+t#DmXq;B4lJI8 zmiQ)*wcN*htx$hnd+eV&ui+Y82$-sw{wz_nrv_q*qa~ZNZ&T^PY7BnVsZBPF>Fn6$ zSpva&IUK_*d$|_E1HMayuNN>`X2jra4qI{@UewsjELq|?hlz0?o^a6MN;J!ddi$TU z5mGi2ASpbT_|Y?MTvMf)yCe0>BwDrOQ~Z&(AqZ&@dXp^wskSszq%y1Hn;1)P#$ENY z{MPhS5J+!2MVr3Tp$yG>Nqa5g<;%AO0m8w+T)+!71#Y(nT`3zgD zBr)qr%A88gGK)}L>>^2%lC>JomSpj1m~K*4S>Lo+8P5S+z>kua^x!cRKN5-=bcfI= zrjb2%UDMatT zJ#S!(9!-$xq8DeOtI%&P#*?bUb%OTz&=~gkiQ$gR9_K9Wp78|i@iMW5S;Vp@{?v1m z9R@m^U6c|-);TR(l4%~kxIr9ZC`@vFwUV3U{WA5<(mmSb%6`{Ol)rPcbj`%^PW^Gr zO03iUUZ`)`=rEfC_*xr%3^VC)T4Gn(D+i5)2z&0J=V8lhU5C?>uP-B$DG}d}-wvEz z>iobH>LfOjDRO)>e1-95_%26XSUm)r;iLRwhA(_UeQugD9>HjImKDI}=URq%MLWA( zQSk?$iAlZdDt;<(YWIJOQ1SZw+#c@q;sWhPM6p%;qrfQhbM(CyYksb1QY>Q@CPB<$ zlV5iK^J&fxm(|YHVbcy2cN9m+k)dc;(AI^hl%xpu1{uR*SIqy~bFlGk#BS4K7f`o2 z1V3cUpl;8u4Lcg6GtqYWl&3Y9T#n_ihAJL0lPf{PwkJXgcJjQ3e z{*(2jPd;5jwKNpJZnY%mmbz7w?BHwyMDJEpaxMvNYLBCu=wmjqs!5+llGQ}rrfN<1 zSWSEysda_NN6k&nB8~MI#;PS$QLI`jvb+}NW^1j9W|1~pA2({o^mDM>r?#eHTWS*y zrx}~evT57*Iq<4H$5wD3SnX)z)*kj@>02pgpa874Bd2&|t=LmM^P$k8&L$;+#Jqlp z_fNF(DnXo{Jq0|dhGiSzr)PJY;py@4Y-NULGkD1vp0R#fgOryw?v7KqFbTv`LLHg3 zxE!kLztEd#b16)16(C(yT#inJPnO7nm*Z7SYsp|l>(;yQxe_!5F;}8?FYn<+vD$+^ zf{@*dK7#16dr{^}$fr`ym5lY%*&_0ibv71VPOJt|=(lF&*2Ji@md92(Cr-p?fi_c7db~3g zWRqKM%$|7=m2D2m@(v!PqCt*{2xhiZ_ky9LWl6C4gd2u<`Fuh`gVICML^tVMs&1F~ z(X&30aIfg0W+F^geIN23Y9MNI8-i?0f^@1fkwD8dWwymmZUdAPWw1!z0kNxE_E7)t z8hdQuC2B5=ZFSv^z3}6(wtqOpJB80&s;!Ya_gJlQD#{x{mI9Tn@hcg7b`{Z}>Nu;Y z$U0PfZidzxPo#Sq_GP=Lieou#&Ok9)ZHbL|L}jogD}i7=6^(wN6ld_wprWhNM?So( U>OS)6v9D4_KATW&Y~=HQ0Ph9gFaQ7m diff --git a/Libraries/CMSIS/5.9.0/DSP/Lib/libarm_cortexM4lf_math.a b/Libraries/CMSIS/5.9.0/DSP/Lib/libarm_cortexM4lf_math.a index c8ff8077dafbe29f861d03008ec1d9576c257a33..ef65b59511baf6fa86224478f7336f2afa0a72d5 100644 GIT binary patch delta 251455 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

Ls>U-bQ0J#m=lf9Sr%_+> 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 z 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 Ow>M+-9Zzt`(8DJ-1A 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 E0)wQ45MhP7)jYcJ!l$(CHG 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

$zjzyx9d)TEBR2MNyy6u7)@B=H}J+dA)}C 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%0DRpb)6BN1=oxIn%M$deMx1($Vb%YMwX8O01n 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

4OZnSSfC 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

b#6b$U*`zrOOAru}u#y>5s8 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 diff --git a/Libraries/CMSIS/Device/Maxim/GCC/mxc_version.mk b/Libraries/CMSIS/Device/Maxim/GCC/mxc_version.mk index 6a910da3fea..becf3c4cfa1 100644 --- a/Libraries/CMSIS/Device/Maxim/GCC/mxc_version.mk +++ b/Libraries/CMSIS/Device/Maxim/GCC/mxc_version.mk @@ -16,9 +16,9 @@ # ############################################################################## # Autogenerated version info for build system. -MSDK_VERSION_STRING := v2023_10-172-gd3f8669fd6 -MSDK_VERSION_YEAR := 2023 -MSDK_VERSION_MONTH := 10 +MSDK_VERSION_STRING := v2024_02-139-gb4652342d9 +MSDK_VERSION_YEAR := 2024 +MSDK_VERSION_MONTH := 2 # Add root MAXIM_PATH to IPATH so compiler can locate msdk_version.h IPATH += $(MAXIM_PATH) From fb2c489581a15bedb532e7ca9dacfe10e44b995b Mon Sep 17 00:00:00 2001 From: Jake Carter Date: Tue, 10 Sep 2024 17:07:23 -0600 Subject: [PATCH 2/3] Add CMSIS_DSP_VERSION (default 1.16.2) to build system --- .../{ => 1.16.2}/Include/arm_common_tables.h | 0 .../Include/arm_common_tables_f16.h | 0 .../{ => 1.16.2}/Include/arm_const_structs.h | 0 .../Include/arm_const_structs_f16.h | 0 .../{ => 1.16.2}/Include/arm_helium_utils.h | 0 .../5.9.0/DSP/{ => 1.16.2}/Include/arm_math.h | 0 .../DSP/{ => 1.16.2}/Include/arm_math_f16.h | 0 .../{ => 1.16.2}/Include/arm_math_memory.h | 0 .../DSP/{ => 1.16.2}/Include/arm_math_types.h | 0 .../{ => 1.16.2}/Include/arm_math_types_f16.h | 0 .../DSP/{ => 1.16.2}/Include/arm_mve_tables.h | 0 .../{ => 1.16.2}/Include/arm_mve_tables_f16.h | 0 .../DSP/{ => 1.16.2}/Include/arm_vec_math.h | 0 .../{ => 1.16.2}/Include/arm_vec_math_f16.h | 0 .../Include/dsp/basic_math_functions.h | 0 .../Include/dsp/basic_math_functions_f16.h | 0 .../Include/dsp/bayes_functions.h | 0 .../Include/dsp/bayes_functions_f16.h | 0 .../Include/dsp/complex_math_functions.h | 0 .../Include/dsp/complex_math_functions_f16.h | 0 .../Include/dsp/controller_functions.h | 0 .../Include/dsp/controller_functions_f16.h | 0 .../DSP/{ => 1.16.2}/Include/dsp/debug.h | 0 .../Include/dsp/distance_functions.h | 0 .../Include/dsp/distance_functions_f16.h | 0 .../Include/dsp/fast_math_functions.h | 0 .../Include/dsp/fast_math_functions_f16.h | 0 .../Include/dsp/filtering_functions.h | 0 .../Include/dsp/filtering_functions_f16.h | 0 .../Include/dsp/interpolation_functions.h | 0 .../Include/dsp/interpolation_functions_f16.h | 0 .../Include/dsp/matrix_functions.h | 0 .../Include/dsp/matrix_functions_f16.h | 0 .../{ => 1.16.2}/Include/dsp/matrix_utils.h | 0 .../5.9.0/DSP/{ => 1.16.2}/Include/dsp/none.h | 0 .../Include/dsp/quaternion_math_functions.h | 0 .../Include/dsp/statistics_functions.h | 0 .../Include/dsp/statistics_functions_f16.h | 0 .../Include/dsp/support_functions.h | 0 .../Include/dsp/support_functions_f16.h | 0 .../{ => 1.16.2}/Include/dsp/svm_defines.h | 0 .../{ => 1.16.2}/Include/dsp/svm_functions.h | 0 .../Include/dsp/svm_functions_f16.h | 0 .../Include/dsp/transform_functions.h | 0 .../Include/dsp/transform_functions_f16.h | 0 .../DSP/{ => 1.16.2}/Include/dsp/utils.h | 0 .../Include/dsp/window_functions.h | 0 .../{ => 1.16.2}/Lib/libarm_cortexM4l_math.a | Bin .../{ => 1.16.2}/Lib/libarm_cortexM4lf_math.a | Bin Libraries/CMSIS/5.9.0/DSP/CMSIS-DSP.mk | 33 ++++++++++++++++-- .../CMSIS/Device/Maxim/GCC/mxc_version.mk | 2 +- USERGUIDE.md | 10 +++++- 52 files changed, 41 insertions(+), 4 deletions(-) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_common_tables.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_common_tables_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_const_structs.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_const_structs_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_helium_utils.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_math.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_math_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_math_memory.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_math_types.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_math_types_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_mve_tables.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_mve_tables_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_vec_math.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/arm_vec_math_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/basic_math_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/basic_math_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/bayes_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/bayes_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/complex_math_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/complex_math_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/controller_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/controller_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/debug.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/distance_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/distance_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/fast_math_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/fast_math_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/filtering_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/filtering_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/interpolation_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/interpolation_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/matrix_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/matrix_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/matrix_utils.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/none.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/quaternion_math_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/statistics_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/statistics_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/support_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/support_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/svm_defines.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/svm_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/svm_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/transform_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/transform_functions_f16.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/utils.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Include/dsp/window_functions.h (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Lib/libarm_cortexM4l_math.a (100%) rename Libraries/CMSIS/5.9.0/DSP/{ => 1.16.2}/Lib/libarm_cortexM4lf_math.a (100%) diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_common_tables.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_common_tables.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_common_tables_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_common_tables_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_common_tables_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_const_structs.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_const_structs.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_const_structs_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_const_structs_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_const_structs_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_helium_utils.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_helium_utils.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_helium_utils.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_helium_utils.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_math.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_math.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_math.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_math_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_math_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_math_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_memory.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_math_memory.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_math_memory.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_math_memory.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_math_types.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_math_types.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_math_types_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_math_types_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_math_types_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_mve_tables.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_mve_tables.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_mve_tables_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_mve_tables_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_mve_tables_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_vec_math.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_vec_math.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_vec_math_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/arm_vec_math_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/arm_vec_math_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/basic_math_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/basic_math_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/basic_math_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/basic_math_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/basic_math_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/bayes_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/bayes_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/bayes_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/bayes_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/bayes_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/complex_math_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/complex_math_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/complex_math_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/complex_math_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/complex_math_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/controller_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/controller_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/controller_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/controller_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/controller_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/debug.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/debug.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/debug.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/debug.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/distance_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/distance_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/distance_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/distance_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/distance_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/fast_math_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/fast_math_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/fast_math_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/fast_math_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/fast_math_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/filtering_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/filtering_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/filtering_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/filtering_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/filtering_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/interpolation_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/interpolation_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/interpolation_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/interpolation_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/interpolation_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/matrix_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/matrix_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/matrix_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/matrix_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_utils.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/matrix_utils.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/matrix_utils.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/matrix_utils.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/none.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/none.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/none.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/none.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/quaternion_math_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/quaternion_math_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/quaternion_math_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/quaternion_math_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/statistics_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/statistics_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/statistics_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/statistics_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/statistics_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/support_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/support_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/support_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/support_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/support_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_defines.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/svm_defines.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_defines.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/svm_defines.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/svm_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/svm_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/svm_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/svm_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/svm_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/transform_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/transform_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions_f16.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/transform_functions_f16.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/transform_functions_f16.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/transform_functions_f16.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/utils.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/utils.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/utils.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/utils.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Include/dsp/window_functions.h b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/window_functions.h similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Include/dsp/window_functions.h rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Include/dsp/window_functions.h diff --git a/Libraries/CMSIS/5.9.0/DSP/Lib/libarm_cortexM4l_math.a b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Lib/libarm_cortexM4l_math.a similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Lib/libarm_cortexM4l_math.a rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Lib/libarm_cortexM4l_math.a diff --git a/Libraries/CMSIS/5.9.0/DSP/Lib/libarm_cortexM4lf_math.a b/Libraries/CMSIS/5.9.0/DSP/1.16.2/Lib/libarm_cortexM4lf_math.a similarity index 100% rename from Libraries/CMSIS/5.9.0/DSP/Lib/libarm_cortexM4lf_math.a rename to Libraries/CMSIS/5.9.0/DSP/1.16.2/Lib/libarm_cortexM4lf_math.a diff --git a/Libraries/CMSIS/5.9.0/DSP/CMSIS-DSP.mk b/Libraries/CMSIS/5.9.0/DSP/CMSIS-DSP.mk index 7121c0873de..5e039a17eb5 100644 --- a/Libraries/CMSIS/5.9.0/DSP/CMSIS-DSP.mk +++ b/Libraries/CMSIS/5.9.0/DSP/CMSIS-DSP.mk @@ -1,12 +1,41 @@ +############################################################################## + # + # Copyright 2023-2024 Analog Devices, Inc. + # + # Licensed under the Apache License, Version 2.0 (the "License"); + # you may not use this file except in compliance with the License. + # You may obtain a copy of the License at + # + # http://www.apache.org/licenses/LICENSE-2.0 + # + # Unless required by applicable law or agreed to in writing, software + # distributed under the License is distributed on an "AS IS" BASIS, + # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + # See the License for the specific language governing permissions and + # limitations under the License. + # + ############################################################################## # Makefile for linking against the CMSIS-DSP library. ifeq "$(CMSIS_ROOT)" "" CMSIS_ROOT=../../ endif +ifeq "$(CMSIS_DSP_DIR)" "" +# If PERIPH_DRIVER_DIR is not specified, this Makefile will locate itself. +CMSIS_DSP_DIR := $(dir $(abspath $(lastword $(MAKEFILE_LIST)))) +endif + +CMSIS_DSP_VERSION ?= 1.16.2 +ifeq ("$(wildcard $(CMSIS_DSP_DIR)/$(CMSIS_DSP_VERSION))","") +$(error Unsupported CMSIS-DSP version '$(CMSIS_DSP_VERSION)'. Searched $(CMSIS_DSP_DIR)) +endif + +$(info Enabled CMSIS-DSP v$(CMSIS_DSP_VERSION)) + # Include paths... # DSP files -IPATH += $(CMSIS_ROOT)/5.9.0/DSP/Include +IPATH += $(CMSIS_DSP_DIR)/$(CMSIS_DSP_VERSION)/Include # Some newer CMSIS5 core include files, such as cmsis_compiler.h, etc. IPATH += $(CMSIS_ROOT)/5.9.0/Core/Include @@ -18,7 +47,7 @@ PROJ_CFLAGS+=-DARM_MATH_CM4 PROJ_CFLAGS+=-D__FPU_PRESENT # Where to find the DSP library file -PROJ_LDFLAGS += -L$(CMSIS_ROOT)/5.9.0/DSP/Lib +PROJ_LDFLAGS += -L$(CMSIS_DSP_DIR)/$(CMSIS_DSP_VERSION)/Lib ifeq "$(MFLOAT_ABI)" "" $(warning ***The 'MFLOAT_ABI' Makefile variable is not set!*** Using softfp CMSIS-DSP instructions by default.) diff --git a/Libraries/CMSIS/Device/Maxim/GCC/mxc_version.mk b/Libraries/CMSIS/Device/Maxim/GCC/mxc_version.mk index becf3c4cfa1..a517a803062 100644 --- a/Libraries/CMSIS/Device/Maxim/GCC/mxc_version.mk +++ b/Libraries/CMSIS/Device/Maxim/GCC/mxc_version.mk @@ -16,7 +16,7 @@ # ############################################################################## # Autogenerated version info for build system. -MSDK_VERSION_STRING := v2024_02-139-gb4652342d9 +MSDK_VERSION_STRING := v2024_02-149-gb9966ca6d8 MSDK_VERSION_YEAR := 2024 MSDK_VERSION_MONTH := 2 diff --git a/USERGUIDE.md b/USERGUIDE.md index 70fd2d593fb..9c0649fb6d9 100644 --- a/USERGUIDE.md +++ b/USERGUIDE.md @@ -2129,12 +2129,20 @@ The following table matches external part numbers to internal die types. This i The CMSIS-DSP library provides a suite of common **Digital Signal Processing _(DSP)_** functions that take advantage of hardware accelerated _Floating Point Unit (FPU)_ available on microcontrollers with Arm Cortex-M cores. This library is distributed in the MSDK as a pre-compiled static library file, and the MSDK maintains a port of the official code examples in the **ARM-DSP** [Examples](https://github.com/analogdevicesinc/msdk/tree/main/Examples) folder for each microcontroller. -Please refer to the [CMSIS-DSP official documentation](https://www.keil.com/pack/doc/CMSIS/DSP/html/index.html) for more detailed documentation on the library functions and usage. +Please refer to the [CMSIS-DSP official documentation](https://arm-software.github.io/CMSIS-DSP/v1.16.2/index.html) for more detailed documentation on the library functions and usage. #### CMSIS-DSP Supported Parts - All microcontrollers with a Cortex M4 core are supported. +#### CMSIS-DSP Build Variables + +| Configuration Variable | Description | Details | +| ---------------------- | ---------------------------------------------------------- | ------------------------------------------------------------ | +| | | | +| `CMSIS_DSP_VERSION` | (Optional) Set the CMSIS-DSP version to use. | Defaults to `1.16.2`, which is currently the only supported version. | + + --- ### Cordio Bluetooth Low Energy From 647304ec23a76f7068a66a79f79a4ec093d00b8a Mon Sep 17 00:00:00 2001 From: Jake Carter Date: Tue, 10 Sep 2024 17:26:30 -0600 Subject: [PATCH 3/3] Skip clang-format and cpplint checks for CMSIS-DSP --- .github/workflows/clang-format-check.yml | 2 +- .github/workflows/linter.yml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/clang-format-check.yml b/.github/workflows/clang-format-check.yml index b0f145b2e20..89c2621e0c6 100644 --- a/.github/workflows/clang-format-check.yml +++ b/.github/workflows/clang-format-check.yml @@ -65,7 +65,7 @@ jobs: # Exclude register header files. Those don't follow clang formatting or it becomes unreadable - name: clang-format-check run: | - CHANGE_FILES=$(git diff --ignore-submodules --name-only remotes/origin/main '*.c' '*.h' ':!*_regs.h' ':!*ffconf.h' ':!*weights.h' ':!*cnn.h' ':!*cnn.c' ':!*sampledata.h' ':!*sampleoutput.h' ':!*softmax.c' ':!Examples/*/Coremark/*' ':!Libraries/FCL' ':!Libraries/FreeRTOS' ':!Libraries/lwIP' ':!Libraries/littlefs' ':!Libraries/FreeRTOS-Plus' ':!Libraries/LC3' ':!Libraries/SDHC' ':!Libraries/MAXUSB' ':!Libraries/Cordio' ':!Libraries/LVGL' ':!Libraries/Coremark' ':!Libraries/MiscDrivers/BarcodeDecoder' ':!Libraries/tinyusb') + CHANGE_FILES=$(git diff --ignore-submodules --name-only remotes/origin/main '*.c' '*.h' ':!*_regs.h' ':!*ffconf.h' ':!*weights.h' ':!*cnn.h' ':!*cnn.c' ':!*sampledata.h' ':!*sampleoutput.h' ':!*softmax.c' ':!Examples/*/Coremark/*' ':!Libraries/FCL' ':!Libraries/FreeRTOS' ':!Libraries/lwIP' ':!Libraries/littlefs' ':!Libraries/FreeRTOS-Plus' ':!Libraries/LC3' ':!Libraries/SDHC' ':!Libraries/MAXUSB' ':!Libraries/Cordio' ':!Libraries/LVGL' ':!Libraries/Coremark' ':!Libraries/MiscDrivers/BarcodeDecoder' ':!Libraries/tinyusb' ':!Libraries/CMSIS/5.9.0/DSP') if [[ "$CHANGE_FILES" != "" ]]; then bash -e .github/workflows/clang-format-run.sh $CHANGE_FILES fi diff --git a/.github/workflows/linter.yml b/.github/workflows/linter.yml index 2371926b74e..7b30fd4c748 100644 --- a/.github/workflows/linter.yml +++ b/.github/workflows/linter.yml @@ -78,7 +78,7 @@ jobs: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # Skip autogenerated register files and internal use board files - FILTER_REGEX_EXCLUDE: (.*\/Libraries\/CMSIS\/Device\/Maxim\/.*\/Include\/partition_.*\.h)|(.*\/Libraries\/((CMSIS\/Device\/Maxim\/[^\/]*\/Include)|(PeriphDrivers\/Source\/[^\/]*))\/[^\/]*_regs\.h)|(.*\/Libraries\/Boards\/[^\/]*\/(BCB|Emulator|Simulation|ROM)[^\/]*\/.*)|(.*\/Examples\/[^\/]*\/Display\/lvgl-8\.0\.2\/.*)|(.*\/Examples\/[^\/]*\/Demo\/lv_conf.h)|(.*\/Libraries\/CMSIS\/5.9.0\/.*)|(.*\/Libraries\/CMSIS\/Include\/.*)|(.*\/Libraries\/Cordio\/.*)|(.*\/Libraries\/SDHC\/.*)|(.*\/Libraries\/lwIP\/.*)|(.*\/Examples\/[^\/]*\/CNN\/.*)|(.*\/Libraries\/tinyusb\/.*) + FILTER_REGEX_EXCLUDE: (.*\/Libraries\/CMSIS\/Device\/Maxim\/.*\/Include\/partition_.*\.h)|(.*\/Libraries\/((CMSIS\/Device\/Maxim\/[^\/]*\/Include)|(PeriphDrivers\/Source\/[^\/]*))\/[^\/]*_regs\.h)|(.*\/Libraries\/Boards\/[^\/]*\/(BCB|Emulator|Simulation|ROM)[^\/]*\/.*)|(.*\/Examples\/[^\/]*\/Display\/lvgl-8\.0\.2\/.*)|(.*\/Examples\/[^\/]*\/Demo\/lv_conf.h)|(.*\/Libraries\/CMSIS\/5.9.0\/.*)|(.*\/Libraries\/CMSIS\/Include\/.*)|(.*\/Libraries\/Cordio\/.*)|(.*\/Libraries\/SDHC\/.*)|(.*\/Libraries\/lwIP\/.*)|(.*\/Examples\/[^\/]*\/CNN\/.*)|(.*\/Libraries\/tinyusb\/.*)|(.*\/Libraries\/CMSIS\/5\.9\.0\/DSP\/.*) # Explicity turn off all linters except CPP # SuperLinter Documentation says all we need to do is turn on the ones we want