diff options
Diffstat (limited to 'Middlewares/Third_Party/ARM/ARM.CMSIS-DSP.1.17.1/Source/TransformFunctions/arm_rfft_init_q15.c')
| -rwxr-xr-x | Middlewares/Third_Party/ARM/ARM.CMSIS-DSP.1.17.1/Source/TransformFunctions/arm_rfft_init_q15.c | 487 |
1 files changed, 487 insertions, 0 deletions
diff --git a/Middlewares/Third_Party/ARM/ARM.CMSIS-DSP.1.17.1/Source/TransformFunctions/arm_rfft_init_q15.c b/Middlewares/Third_Party/ARM/ARM.CMSIS-DSP.1.17.1/Source/TransformFunctions/arm_rfft_init_q15.c new file mode 100755 index 0000000..4b0b783 --- /dev/null +++ b/Middlewares/Third_Party/ARM/ARM.CMSIS-DSP.1.17.1/Source/TransformFunctions/arm_rfft_init_q15.c @@ -0,0 +1,487 @@ +/* ---------------------------------------------------------------------- + * Project: CMSIS DSP Library + * Title: arm_rfft_init_q15.c + * Description: RFFT & RIFFT Q15 initialisation function + * + * $Date: 23 April 2021 + * $Revision: V1.9.0 + * + * Target Processor: Cortex-M and Cortex-A cores + * -------------------------------------------------------------------- */ + +/* + * Copyright (C) 2010-2023 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. + */ +#include "arm_compiler_specific.h" + + +#include "dsp/transform_functions.h" +#include "arm_common_tables.h" +#include "arm_const_structs.h" + +/** + @ingroup RealFFT +*/ + +/** + @defgroup RealFFTQ15 Real FFT Q15 Functions +*/ + +/** + @addtogroup RealFFTQ15 + @{ + */ + + +#if defined(ARM_MATH_MVEI) && !defined(ARM_MATH_AUTOVECTORIZE) +#define RFFTINIT_Q15(LEN,CFFTLEN,TWIDMOD) \ +ARM_DSP_ATTRIBUTE arm_status arm_rfft_init_##LEN##_q15( arm_rfft_instance_q15 * S, \ + uint32_t ifftFlagR, \ + uint32_t bitReverseFlag ) \ +{ \ + \ + /* Initialise the default arm status */ \ + arm_status status = ARM_MATH_SUCCESS; \ + \ + /* Initialize the Real FFT length */ \ + S->fftLenReal = (uint16_t) LEN; \ + \ + /* Initialize the Twiddle coefficientA pointer */ \ + S->pTwiddleAReal = (q15_t *) realCoefAQ15; \ + \ + /* Initialize the Twiddle coefficientB pointer */ \ + S->pTwiddleBReal = (q15_t *) realCoefBQ15; \ + \ + /* Initialize the Flag for selection of RFFT or RIFFT */ \ + S->ifftFlagR = (uint8_t) ifftFlagR; \ + \ + /* Initialize the Flag for calculation Bit reversal or not */\ + S->bitReverseFlagR = (uint8_t) bitReverseFlag; \ + \ + S->twidCoefRModifier = TWIDMOD; \ + \ + status=arm_cfft_init_##CFFTLEN##_q15(&(S->cfftInst)); \ + \ + /* return the status of RFFT Init function */ \ + return (status); \ +} +#elif defined(ARM_MATH_NEON) +#define RFFTINIT_Q15(LEN,CFFTLEN,TWIDMOD) \ +ARM_DSP_ATTRIBUTE arm_status arm_rfft_init_##LEN##_q15( arm_rfft_instance_q15 * S )\ +{ \ + /* Initialise the default arm status */ \ + arm_status status = ARM_MATH_SUCCESS; \ + S->nfft = LEN; \ + S->ncfft = LEN >> 1; \ + \ + S->twiddles = arm_neon_rfft_twiddles_##LEN##_q15; \ + S->factors = arm_neon_rfft_factors_##LEN##_q15; \ + \ + S->super_twiddles = arm_neon_rfft_super_twiddles_neon_##LEN##_q15; \ + \ + /* return the status of RFFT Init function */ \ + return (status); \ +} +#include "arm_neon_tables.h" + + +#else +#define RFFTINIT_Q15(LEN,CFFTLEN,TWIDMOD) \ +ARM_DSP_ATTRIBUTE arm_status arm_rfft_init_##LEN##_q15( arm_rfft_instance_q15 * S, \ + uint32_t ifftFlagR, \ + uint32_t bitReverseFlag ) \ +{ \ + /* Initialize the Real FFT length */ \ + S->fftLenReal = (uint16_t) LEN; \ + \ + /* Initialize the Twiddle coefficientA pointer */ \ + S->pTwiddleAReal = (q15_t *) realCoefAQ15; \ + \ + /* Initialize the Twiddle coefficientB pointer */ \ + S->pTwiddleBReal = (q15_t *) realCoefBQ15; \ + \ + /* Initialize the Flag for selection of RFFT or RIFFT */ \ + S->ifftFlagR = (uint8_t) ifftFlagR; \ + \ + /* Initialize the Flag for calculation Bit reversal or not */\ + S->bitReverseFlagR = (uint8_t) bitReverseFlag; \ + \ + S->twidCoefRModifier = TWIDMOD; \ + \ + S->pCfft = &arm_cfft_sR_q15_len##CFFTLEN; \ + \ + /* return the status of RFFT Init function */ \ + return (ARM_MATH_SUCCESS); \ +} +#endif + + +/** + @brief Initialization function for the 8192 pt Q15 real FFT. + @param[in,out] S points to an instance of the Q15 RFFT/RIFFT structure + @param[in] ifftFlagR flag that selects transform direction + - value = 0: forward transform + - value = 1: inverse transform + @param[in] bitReverseFlag flag that enables / disables bit reversal of output + - value = 0: disables bit reversal of output + - value = 1: enables bit reversal of output + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_ARGUMENT_ERROR : <code>fftLenReal</code> is not a supported length + + @par + The parameter <code>ifftFlagR</code> controls whether a forward or inverse transform is computed. + Set(=1) ifftFlagR to calculate RIFFT, otherwise RFFT is calculated. + @par + The parameter <code>bitReverseFlag</code> controls whether output is in normal order or bit reversed order. + Set(=1) bitReverseFlag for output to be in normal order otherwise output is in bit reversed order. + @par + This function also initializes Twiddle factor table. + + */ + +RFFTINIT_Q15(8192,4096,1) + +/** + @brief Initialization function for the 4096 pt Q15 real FFT. + @param[in,out] S points to an instance of the Q15 RFFT/RIFFT structure + @param[in] ifftFlagR flag that selects transform direction + - value = 0: forward transform + - value = 1: inverse transform + @param[in] bitReverseFlag flag that enables / disables bit reversal of output + - value = 0: disables bit reversal of output + - value = 1: enables bit reversal of output + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_ARGUMENT_ERROR : <code>fftLenReal</code> is not a supported length + + @par + The parameter <code>ifftFlagR</code> controls whether a forward or inverse transform is computed. + Set(=1) ifftFlagR to calculate RIFFT, otherwise RFFT is calculated. + @par + The parameter <code>bitReverseFlag</code> controls whether output is in normal order or bit reversed order. + Set(=1) bitReverseFlag for output to be in normal order otherwise output is in bit reversed order. + @par + This function also initializes Twiddle factor table. + */ +RFFTINIT_Q15(4096,2048,2) + +/** + @brief Initialization function for the 2048 pt Q15 real FFT. + @param[in,out] S points to an instance of the Q15 RFFT/RIFFT structure + @param[in] ifftFlagR flag that selects transform direction + - value = 0: forward transform + - value = 1: inverse transform + @param[in] bitReverseFlag flag that enables / disables bit reversal of output + - value = 0: disables bit reversal of output + - value = 1: enables bit reversal of output + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_ARGUMENT_ERROR : <code>fftLenReal</code> is not a supported length + + @par + The parameter <code>ifftFlagR</code> controls whether a forward or inverse transform is computed. + Set(=1) ifftFlagR to calculate RIFFT, otherwise RFFT is calculated. + @par + The parameter <code>bitReverseFlag</code> controls whether output is in normal order or bit reversed order. + Set(=1) bitReverseFlag for output to be in normal order otherwise output is in bit reversed order. + @par + This function also initializes Twiddle factor table. + */ +RFFTINIT_Q15(2048,1024,4) + +/** + @brief Initialization function for the 1024 pt Q15 real FFT. + @param[in,out] S points to an instance of the Q15 RFFT/RIFFT structure + @param[in] ifftFlagR flag that selects transform direction + - value = 0: forward transform + - value = 1: inverse transform + @param[in] bitReverseFlag flag that enables / disables bit reversal of output + - value = 0: disables bit reversal of output + - value = 1: enables bit reversal of output + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_ARGUMENT_ERROR : <code>fftLenReal</code> is not a supported length + + @par + The parameter <code>ifftFlagR</code> controls whether a forward or inverse transform is computed. + Set(=1) ifftFlagR to calculate RIFFT, otherwise RFFT is calculated. + @par + The parameter <code>bitReverseFlag</code> controls whether output is in normal order or bit reversed order. + Set(=1) bitReverseFlag for output to be in normal order otherwise output is in bit reversed order. + @par + This function also initializes Twiddle factor table. + */ +RFFTINIT_Q15(1024,512,8) + +/** + @brief Initialization function for the 512 pt Q15 real FFT. + @param[in,out] S points to an instance of the Q15 RFFT/RIFFT structure + @param[in] ifftFlagR flag that selects transform direction + - value = 0: forward transform + - value = 1: inverse transform + @param[in] bitReverseFlag flag that enables / disables bit reversal of output + - value = 0: disables bit reversal of output + - value = 1: enables bit reversal of output + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_ARGUMENT_ERROR : <code>fftLenReal</code> is not a supported length + + @par + The parameter <code>ifftFlagR</code> controls whether a forward or inverse transform is computed. + Set(=1) ifftFlagR to calculate RIFFT, otherwise RFFT is calculated. + @par + The parameter <code>bitReverseFlag</code> controls whether output is in normal order or bit reversed order. + Set(=1) bitReverseFlag for output to be in normal order otherwise output is in bit reversed order. + @par + This function also initializes Twiddle factor table. + */ +RFFTINIT_Q15(512,256,16) + +/** + @brief Initialization function for the 256 pt Q15 real FFT. + @param[in,out] S points to an instance of the Q15 RFFT/RIFFT structure + @param[in] ifftFlagR flag that selects transform direction + - value = 0: forward transform + - value = 1: inverse transform + @param[in] bitReverseFlag flag that enables / disables bit reversal of output + - value = 0: disables bit reversal of output + - value = 1: enables bit reversal of output + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_ARGUMENT_ERROR : <code>fftLenReal</code> is not a supported length + + @par + The parameter <code>ifftFlagR</code> controls whether a forward or inverse transform is computed. + Set(=1) ifftFlagR to calculate RIFFT, otherwise RFFT is calculated. + @par + The parameter <code>bitReverseFlag</code> controls whether output is in normal order or bit reversed order. + Set(=1) bitReverseFlag for output to be in normal order otherwise output is in bit reversed order. + @par + This function also initializes Twiddle factor table. + */ +RFFTINIT_Q15(256,128,32) + +/** + @brief Initialization function for the 128 pt Q15 real FFT. + @param[in,out] S points to an instance of the Q15 RFFT/RIFFT structure + @param[in] ifftFlagR flag that selects transform direction + - value = 0: forward transform + - value = 1: inverse transform + @param[in] bitReverseFlag flag that enables / disables bit reversal of output + - value = 0: disables bit reversal of output + - value = 1: enables bit reversal of output + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_ARGUMENT_ERROR : <code>fftLenReal</code> is not a supported length + + @par + The parameter <code>ifftFlagR</code> controls whether a forward or inverse transform is computed. + Set(=1) ifftFlagR to calculate RIFFT, otherwise RFFT is calculated. + @par + The parameter <code>bitReverseFlag</code> controls whether output is in normal order or bit reversed order. + Set(=1) bitReverseFlag for output to be in normal order otherwise output is in bit reversed order. + @par + This function also initializes Twiddle factor table. + */ +RFFTINIT_Q15(128,64,64) + +/** + @brief Initialization function for the 64 pt Q15 real FFT. + @param[in,out] S points to an instance of the Q15 RFFT/RIFFT structure + @param[in] ifftFlagR flag that selects transform direction + - value = 0: forward transform + - value = 1: inverse transform + @param[in] bitReverseFlag flag that enables / disables bit reversal of output + - value = 0: disables bit reversal of output + - value = 1: enables bit reversal of output + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_ARGUMENT_ERROR : <code>fftLenReal</code> is not a supported length + + @par + The parameter <code>ifftFlagR</code> controls whether a forward or inverse transform is computed. + Set(=1) ifftFlagR to calculate RIFFT, otherwise RFFT is calculated. + @par + The parameter <code>bitReverseFlag</code> controls whether output is in normal order or bit reversed order. + Set(=1) bitReverseFlag for output to be in normal order otherwise output is in bit reversed order. + @par + This function also initializes Twiddle factor table. + */ +RFFTINIT_Q15(64,32,128) + +/** + @brief Initialization function for the 32 pt Q15 real FFT. + @param[in,out] S points to an instance of the Q15 RFFT/RIFFT structure + @param[in] ifftFlagR flag that selects transform direction + - value = 0: forward transform + - value = 1: inverse transform + @param[in] bitReverseFlag flag that enables / disables bit reversal of output + - value = 0: disables bit reversal of output + - value = 1: enables bit reversal of output + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_ARGUMENT_ERROR : <code>fftLenReal</code> is not a supported length + + @par + The parameter <code>ifftFlagR</code> controls whether a forward or inverse transform is computed. + Set(=1) ifftFlagR to calculate RIFFT, otherwise RFFT is calculated. + @par + The parameter <code>bitReverseFlag</code> controls whether output is in normal order or bit reversed order. + Set(=1) bitReverseFlag for output to be in normal order otherwise output is in bit reversed order. + @par + This function also initializes Twiddle factor table. + */ +RFFTINIT_Q15(32,16,256) + +/** + @brief Generic initialization function for the Q15 RFFT/RIFFT. + @param[in,out] S points to an instance of the Q15 RFFT/RIFFT structure + @param[in] fftLenReal length of the FFT + @param[in] ifftFlagR flag that selects transform direction + - value = 0: forward transform + - value = 1: inverse transform + @param[in] bitReverseFlag flag that enables / disables bit reversal of output + - value = 0: disables bit reversal of output + - value = 1: enables bit reversal of output + @return execution status + - \ref ARM_MATH_SUCCESS : Operation successful + - \ref ARM_MATH_ARGUMENT_ERROR : <code>fftLenReal</code> is not a supported length + + @par Details + The parameter <code>fftLenReal</code> specifies length of RFFT/RIFFT Process. + Supported FFT Lengths are 32, 64, 128, 256, 512, 1024, 2048, 4096, 8192. + @par + The parameter <code>ifftFlagR</code> controls whether a forward or inverse transform is computed. + Set(=1) ifftFlagR to calculate RIFFT, otherwise RFFT is calculated. + @par + The parameter <code>bitReverseFlag</code> controls whether output is in normal order or bit reversed order. + Set(=1) bitReverseFlag for output to be in normal order otherwise output is in bit reversed order. + @par + This function also initializes Twiddle factor table. + @par + This function should be used only if you don't know the FFT sizes that + you'll need at build time. The use of this function will prevent the + linker from removing the FFT tables that are not needed and the library + code size will be bigger than needed. + @par + If you use CMSIS-DSP as a static library, and if you know the FFT sizes + that you need at build time, then it is better to use the initialization + functions defined for each FFT size. + + */ +#if defined(ARM_MATH_NEON) +ARM_DSP_ATTRIBUTE arm_status arm_rfft_init_q15( + arm_rfft_instance_q15 * S, + uint32_t fftLenReal) +{ + /* Initialise the default arm status */ + arm_status status = ARM_MATH_ARGUMENT_ERROR; + + /* Initialization of coef modifier depending on the FFT length */ + switch (fftLenReal) + { + case 8192U: + status = arm_rfft_init_8192_q15( S ); + break; + case 4096U: + status = arm_rfft_init_4096_q15( S ); + break; + case 2048U: + status = arm_rfft_init_2048_q15( S ); + break; + case 1024U: + status = arm_rfft_init_1024_q15( S ); + break; + case 512U: + status = arm_rfft_init_512_q15( S ); + break; + case 256U: + status = arm_rfft_init_256_q15( S ); + break; + case 128U: + status = arm_rfft_init_128_q15( S ); + break; + case 64U: + status = arm_rfft_init_64_q15( S ); + break; + case 32U: + status = arm_rfft_init_32_q15( S ); + break; + default: + /* Reporting argument error if rfftSize is not valid value */ + status = ARM_MATH_ARGUMENT_ERROR; + break; + } + + /* return the status of RFFT Init function */ + return (status); +} +#else +ARM_DSP_ATTRIBUTE arm_status arm_rfft_init_q15( + arm_rfft_instance_q15 * S, + uint32_t fftLenReal, + uint32_t ifftFlagR, + uint32_t bitReverseFlag) +{ + /* Initialise the default arm status */ + arm_status status = ARM_MATH_ARGUMENT_ERROR; + + /* Initialization of coef modifier depending on the FFT length */ + switch (fftLenReal) + { + case 8192U: + status = arm_rfft_init_8192_q15( S,ifftFlagR,bitReverseFlag ); + break; + case 4096U: + status = arm_rfft_init_4096_q15( S,ifftFlagR,bitReverseFlag ); + break; + case 2048U: + status = arm_rfft_init_2048_q15( S,ifftFlagR,bitReverseFlag ); + break; + case 1024U: + status = arm_rfft_init_1024_q15( S,ifftFlagR,bitReverseFlag ); + break; + case 512U: + status = arm_rfft_init_512_q15( S,ifftFlagR,bitReverseFlag ); + break; + case 256U: + status = arm_rfft_init_256_q15( S,ifftFlagR,bitReverseFlag ); + break; + case 128U: + status = arm_rfft_init_128_q15( S,ifftFlagR,bitReverseFlag ); + break; + case 64U: + status = arm_rfft_init_64_q15( S,ifftFlagR,bitReverseFlag ); + break; + case 32U: + status = arm_rfft_init_32_q15( S,ifftFlagR,bitReverseFlag ); + break; + default: + /* Reporting argument error if rfftSize is not valid value */ + status = ARM_MATH_ARGUMENT_ERROR; + break; + } + + /* return the status of RFFT Init function */ + return (status); +} +#endif + +/** + @} end of RealFFTQ15 group + */ |