mbed - The official Mbed 2 C/C++ SDK provides the softwa…

Users » mbed_official » Code » mbed

mbed official / mbed

The official Mbed 2 C/C++ SDK provides the software platform and libraries to build your applications.

Dependents: hello SerialTestv11 SerialTestv12 Sierpinski ... more

mbed 2

This is the mbed 2 library. If you'd like to learn about Mbed OS please see the mbed-os docs.

TARGET_DISCO_F413ZH/arm_math.h@160:5571c4ff569f, 2018-01-17 (annotated)

Committer:: Anna Bridge
Date:: Wed Jan 17 16:13:02 2018 +0000
Revision:: 160:5571c4ff569f
Parent:: 146:22da6e220af6

mbed library. Release version 158

Who changed what in which revision?

User	Revision	Line number	New contents of line
AnnaBridge	146:22da6e220af6	1	/* ----------------------------------------------------------------------
AnnaBridge	146:22da6e220af6	2	* Project: CMSIS DSP Library
AnnaBridge	146:22da6e220af6	3	* Title: arm_math.h
AnnaBridge	146:22da6e220af6	4	* Description: Public header file for CMSIS DSP Library
AnnaBridge	146:22da6e220af6	5	*
AnnaBridge	146:22da6e220af6	6	* $Date: 27. January 2017
AnnaBridge	146:22da6e220af6	7	* $Revision: V.1.5.1
AnnaBridge	146:22da6e220af6	8	*
AnnaBridge	146:22da6e220af6	9	* Target Processor: Cortex-M cores
AnnaBridge	146:22da6e220af6	10	* -------------------------------------------------------------------- */
AnnaBridge	146:22da6e220af6	11	/*
AnnaBridge	146:22da6e220af6	12	* Copyright (C) 2010-2017 ARM Limited or its affiliates. All rights reserved.
AnnaBridge	146:22da6e220af6	13	*
AnnaBridge	146:22da6e220af6	14	* SPDX-License-Identifier: Apache-2.0
AnnaBridge	146:22da6e220af6	15	*
AnnaBridge	146:22da6e220af6	16	* Licensed under the Apache License, Version 2.0 (the License); you may
AnnaBridge	146:22da6e220af6	17	* not use this file except in compliance with the License.
AnnaBridge	146:22da6e220af6	18	* You may obtain a copy of the License at
AnnaBridge	146:22da6e220af6	19	*
AnnaBridge	146:22da6e220af6	20	* www.apache.org/licenses/LICENSE-2.0
AnnaBridge	146:22da6e220af6	21	*
AnnaBridge	146:22da6e220af6	22	* Unless required by applicable law or agreed to in writing, software
AnnaBridge	146:22da6e220af6	23	* distributed under the License is distributed on an AS IS BASIS, WITHOUT
AnnaBridge	146:22da6e220af6	24	* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
AnnaBridge	146:22da6e220af6	25	* See the License for the specific language governing permissions and
AnnaBridge	146:22da6e220af6	26	* limitations under the License.
AnnaBridge	146:22da6e220af6	27	*/
AnnaBridge	146:22da6e220af6	28
AnnaBridge	146:22da6e220af6	29	/**
AnnaBridge	146:22da6e220af6	30	\mainpage CMSIS DSP Software Library
AnnaBridge	146:22da6e220af6	31	*
AnnaBridge	146:22da6e220af6	32	* Introduction
AnnaBridge	146:22da6e220af6	33	* ------------
AnnaBridge	146:22da6e220af6	34	*
AnnaBridge	146:22da6e220af6	35	* This user manual describes the CMSIS DSP software library,
AnnaBridge	146:22da6e220af6	36	* a suite of common signal processing functions for use on Cortex-M processor based devices.
AnnaBridge	146:22da6e220af6	37	*
AnnaBridge	146:22da6e220af6	38	* The library is divided into a number of functions each covering a specific category:
AnnaBridge	146:22da6e220af6	39	* - Basic math functions
AnnaBridge	146:22da6e220af6	40	* - Fast math functions
AnnaBridge	146:22da6e220af6	41	* - Complex math functions
AnnaBridge	146:22da6e220af6	42	* - Filters
AnnaBridge	146:22da6e220af6	43	* - Matrix functions
AnnaBridge	146:22da6e220af6	44	* - Transforms
AnnaBridge	146:22da6e220af6	45	* - Motor control functions
AnnaBridge	146:22da6e220af6	46	* - Statistical functions
AnnaBridge	146:22da6e220af6	47	* - Support functions
AnnaBridge	146:22da6e220af6	48	* - Interpolation functions
AnnaBridge	146:22da6e220af6	49	*
AnnaBridge	146:22da6e220af6	50	* The library has separate functions for operating on 8-bit integers, 16-bit integers,
AnnaBridge	146:22da6e220af6	51	* 32-bit integer and 32-bit floating-point values.
AnnaBridge	146:22da6e220af6	52	*
AnnaBridge	146:22da6e220af6	53	* Using the Library
AnnaBridge	146:22da6e220af6	54	* ------------
AnnaBridge	146:22da6e220af6	55	*
AnnaBridge	146:22da6e220af6	56	* The library installer contains prebuilt versions of the libraries in the <code>Lib</code> folder.
AnnaBridge	146:22da6e220af6	57	* - arm_cortexM7lfdp_math.lib (Cortex-M7, Little endian, Double Precision Floating Point Unit)
AnnaBridge	146:22da6e220af6	58	* - arm_cortexM7bfdp_math.lib (Cortex-M7, Big endian, Double Precision Floating Point Unit)
AnnaBridge	146:22da6e220af6	59	* - arm_cortexM7lfsp_math.lib (Cortex-M7, Little endian, Single Precision Floating Point Unit)
AnnaBridge	146:22da6e220af6	60	* - arm_cortexM7bfsp_math.lib (Cortex-M7, Big endian and Single Precision Floating Point Unit on)
AnnaBridge	146:22da6e220af6	61	* - arm_cortexM7l_math.lib (Cortex-M7, Little endian)
AnnaBridge	146:22da6e220af6	62	* - arm_cortexM7b_math.lib (Cortex-M7, Big endian)
AnnaBridge	146:22da6e220af6	63	* - arm_cortexM4lf_math.lib (Cortex-M4, Little endian, Floating Point Unit)
AnnaBridge	146:22da6e220af6	64	* - arm_cortexM4bf_math.lib (Cortex-M4, Big endian, Floating Point Unit)
AnnaBridge	146:22da6e220af6	65	* - arm_cortexM4l_math.lib (Cortex-M4, Little endian)
AnnaBridge	146:22da6e220af6	66	* - arm_cortexM4b_math.lib (Cortex-M4, Big endian)
AnnaBridge	146:22da6e220af6	67	* - arm_cortexM3l_math.lib (Cortex-M3, Little endian)
AnnaBridge	146:22da6e220af6	68	* - arm_cortexM3b_math.lib (Cortex-M3, Big endian)
AnnaBridge	146:22da6e220af6	69	* - arm_cortexM0l_math.lib (Cortex-M0 / Cortex-M0+, Little endian)
AnnaBridge	146:22da6e220af6	70	* - arm_cortexM0b_math.lib (Cortex-M0 / Cortex-M0+, Big endian)
AnnaBridge	146:22da6e220af6	71	* - arm_ARMv8MBLl_math.lib (ARMv8M Baseline, Little endian)
AnnaBridge	146:22da6e220af6	72	* - arm_ARMv8MMLl_math.lib (ARMv8M Mainline, Little endian)
AnnaBridge	146:22da6e220af6	73	* - arm_ARMv8MMLlfsp_math.lib (ARMv8M Mainline, Little endian, Single Precision Floating Point Unit)
AnnaBridge	146:22da6e220af6	74	* - arm_ARMv8MMLld_math.lib (ARMv8M Mainline, Little endian, DSP instructions)
AnnaBridge	146:22da6e220af6	75	* - arm_ARMv8MMLldfsp_math.lib (ARMv8M Mainline, Little endian, DSP instructions, Single Precision Floating Point Unit)
AnnaBridge	146:22da6e220af6	76	*
AnnaBridge	146:22da6e220af6	77	* The library functions are declared in the public file <code>arm_math.h</code> which is placed in the <code>Include</code> folder.
AnnaBridge	146:22da6e220af6	78	* Simply include this file and link the appropriate library in the application and begin calling the library functions. The Library supports single
AnnaBridge	146:22da6e220af6	79	* public header file <code> arm_math.h</code> for Cortex-M cores with little endian and big endian. Same header file will be used for floating point unit(FPU) variants.
AnnaBridge	146:22da6e220af6	80	* Define the appropriate pre processor MACRO ARM_MATH_CM7 or ARM_MATH_CM4 or ARM_MATH_CM3 or
AnnaBridge	146:22da6e220af6	81	* ARM_MATH_CM0 or ARM_MATH_CM0PLUS depending on the target processor in the application.
AnnaBridge	146:22da6e220af6	82	* For ARMv8M cores define pre processor MACRO ARM_MATH_ARMV8MBL or ARM_MATH_ARMV8MML.
AnnaBridge	146:22da6e220af6	83	* Set Pre processor MACRO __DSP_PRESENT if ARMv8M Mainline core supports DSP instructions.
AnnaBridge	146:22da6e220af6	84	*
AnnaBridge	146:22da6e220af6	85	*
AnnaBridge	146:22da6e220af6	86	* Examples
AnnaBridge	146:22da6e220af6	87	* --------
AnnaBridge	146:22da6e220af6	88	*
AnnaBridge	146:22da6e220af6	89	* The library ships with a number of examples which demonstrate how to use the library functions.
AnnaBridge	146:22da6e220af6	90	*
AnnaBridge	146:22da6e220af6	91	* Toolchain Support
AnnaBridge	146:22da6e220af6	92	* ------------
AnnaBridge	146:22da6e220af6	93	*
AnnaBridge	146:22da6e220af6	94	* The library has been developed and tested with MDK-ARM version 5.14.0.0
AnnaBridge	146:22da6e220af6	95	* The library is being tested in GCC and IAR toolchains and updates on this activity will be made available shortly.
AnnaBridge	146:22da6e220af6	96	*
AnnaBridge	146:22da6e220af6	97	* Building the Library
AnnaBridge	146:22da6e220af6	98	* ------------
AnnaBridge	146:22da6e220af6	99	*
AnnaBridge	146:22da6e220af6	100	* The library installer contains a project file to re build libraries on MDK-ARM Tool chain in the <code>CMSIS\\DSP_Lib\\Source\\ARM</code> folder.
AnnaBridge	146:22da6e220af6	101	* - arm_cortexM_math.uvprojx
AnnaBridge	146:22da6e220af6	102	*
AnnaBridge	146:22da6e220af6	103	*
AnnaBridge	146:22da6e220af6	104	* The libraries can be built by opening the arm_cortexM_math.uvprojx project in MDK-ARM, selecting a specific target, and defining the optional pre processor MACROs detailed above.
AnnaBridge	146:22da6e220af6	105	*
AnnaBridge	146:22da6e220af6	106	* Pre-processor Macros
AnnaBridge	146:22da6e220af6	107	* ------------
AnnaBridge	146:22da6e220af6	108	*
AnnaBridge	146:22da6e220af6	109	* Each library project have differant pre-processor macros.
AnnaBridge	146:22da6e220af6	110	*
AnnaBridge	146:22da6e220af6	111	* - UNALIGNED_SUPPORT_DISABLE:
AnnaBridge	146:22da6e220af6	112	*
AnnaBridge	146:22da6e220af6	113	* Define macro UNALIGNED_SUPPORT_DISABLE, If the silicon does not support unaligned memory access
AnnaBridge	146:22da6e220af6	114	*
AnnaBridge	146:22da6e220af6	115	* - ARM_MATH_BIG_ENDIAN:
AnnaBridge	146:22da6e220af6	116	*
AnnaBridge	146:22da6e220af6	117	* Define macro ARM_MATH_BIG_ENDIAN to build the library for big endian targets. By default library builds for little endian targets.
AnnaBridge	146:22da6e220af6	118	*
AnnaBridge	146:22da6e220af6	119	* - ARM_MATH_MATRIX_CHECK:
AnnaBridge	146:22da6e220af6	120	*
AnnaBridge	146:22da6e220af6	121	* Define macro ARM_MATH_MATRIX_CHECK for checking on the input and output sizes of matrices
AnnaBridge	146:22da6e220af6	122	*
AnnaBridge	146:22da6e220af6	123	* - ARM_MATH_ROUNDING:
AnnaBridge	146:22da6e220af6	124	*
AnnaBridge	146:22da6e220af6	125	* Define macro ARM_MATH_ROUNDING for rounding on support functions
AnnaBridge	146:22da6e220af6	126	*
AnnaBridge	146:22da6e220af6	127	* - ARM_MATH_CMx:
AnnaBridge	146:22da6e220af6	128	*
AnnaBridge	146:22da6e220af6	129	* Define macro ARM_MATH_CM4 for building the library on Cortex-M4 target, ARM_MATH_CM3 for building library on Cortex-M3 target
AnnaBridge	146:22da6e220af6	130	* and ARM_MATH_CM0 for building library on Cortex-M0 target, ARM_MATH_CM0PLUS for building library on Cortex-M0+ target, and
AnnaBridge	146:22da6e220af6	131	* ARM_MATH_CM7 for building the library on cortex-M7.
AnnaBridge	146:22da6e220af6	132	*
AnnaBridge	146:22da6e220af6	133	* - ARM_MATH_ARMV8MxL:
AnnaBridge	146:22da6e220af6	134	*
AnnaBridge	146:22da6e220af6	135	* Define macro ARM_MATH_ARMV8MBL for building the library on ARMv8M Baseline target, ARM_MATH_ARMV8MBL for building library
AnnaBridge	146:22da6e220af6	136	* on ARMv8M Mainline target.
AnnaBridge	146:22da6e220af6	137	*
AnnaBridge	146:22da6e220af6	138	* - __FPU_PRESENT:
AnnaBridge	146:22da6e220af6	139	*
AnnaBridge	146:22da6e220af6	140	* Initialize macro __FPU_PRESENT = 1 when building on FPU supported Targets. Enable this macro for floating point libraries.
AnnaBridge	146:22da6e220af6	141	*
AnnaBridge	146:22da6e220af6	142	* - __DSP_PRESENT:
AnnaBridge	146:22da6e220af6	143	*
AnnaBridge	146:22da6e220af6	144	* Initialize macro __DSP_PRESENT = 1 when ARMv8M Mainline core supports DSP instructions.
AnnaBridge	146:22da6e220af6	145	*
AnnaBridge	146:22da6e220af6	146	* <hr>
AnnaBridge	146:22da6e220af6	147	* CMSIS-DSP in ARM::CMSIS Pack
AnnaBridge	146:22da6e220af6	148	* -----------------------------
AnnaBridge	146:22da6e220af6	149	*
AnnaBridge	146:22da6e220af6	150	* The following files relevant to CMSIS-DSP are present in the <b>ARM::CMSIS</b> Pack directories:
AnnaBridge	146:22da6e220af6	151	* \|File/Folder \|Content \|
AnnaBridge	146:22da6e220af6	152	* \|------------------------------\|------------------------------------------------------------------------\|
AnnaBridge	146:22da6e220af6	153	* \|\b CMSIS\\Documentation\\DSP \| This documentation \|
AnnaBridge	146:22da6e220af6	154	* \|\b CMSIS\\DSP_Lib \| Software license agreement (license.txt) \|
AnnaBridge	146:22da6e220af6	155	* \|\b CMSIS\\DSP_Lib\\Examples \| Example projects demonstrating the usage of the library functions \|
AnnaBridge	146:22da6e220af6	156	* \|\b CMSIS\\DSP_Lib\\Source \| Source files for rebuilding the library \|
AnnaBridge	146:22da6e220af6	157	*
AnnaBridge	146:22da6e220af6	158	* <hr>
AnnaBridge	146:22da6e220af6	159	* Revision History of CMSIS-DSP
AnnaBridge	146:22da6e220af6	160	* ------------
AnnaBridge	146:22da6e220af6	161	* Please refer to \ref ChangeLog_pg.
AnnaBridge	146:22da6e220af6	162	*
AnnaBridge	146:22da6e220af6	163	* Copyright Notice
AnnaBridge	146:22da6e220af6	164	* ------------
AnnaBridge	146:22da6e220af6	165	*
AnnaBridge	146:22da6e220af6	166	* Copyright (C) 2010-2015 ARM Limited. All rights reserved.
AnnaBridge	146:22da6e220af6	167	*/
AnnaBridge	146:22da6e220af6	168
AnnaBridge	146:22da6e220af6	169
AnnaBridge	146:22da6e220af6	170	/**
AnnaBridge	146:22da6e220af6	171	* @defgroup groupMath Basic Math Functions
AnnaBridge	146:22da6e220af6	172	*/
AnnaBridge	146:22da6e220af6	173
AnnaBridge	146:22da6e220af6	174	/**
AnnaBridge	146:22da6e220af6	175	* @defgroup groupFastMath Fast Math Functions
AnnaBridge	146:22da6e220af6	176	* This set of functions provides a fast approximation to sine, cosine, and square root.
AnnaBridge	146:22da6e220af6	177	* As compared to most of the other functions in the CMSIS math library, the fast math functions
AnnaBridge	146:22da6e220af6	178	* operate on individual values and not arrays.
AnnaBridge	146:22da6e220af6	179	* There are separate functions for Q15, Q31, and floating-point data.
AnnaBridge	146:22da6e220af6	180	*
AnnaBridge	146:22da6e220af6	181	*/
AnnaBridge	146:22da6e220af6	182
AnnaBridge	146:22da6e220af6	183	/**
AnnaBridge	146:22da6e220af6	184	* @defgroup groupCmplxMath Complex Math Functions
AnnaBridge	146:22da6e220af6	185	* This set of functions operates on complex data vectors.
AnnaBridge	146:22da6e220af6	186	* The data in the complex arrays is stored in an interleaved fashion
AnnaBridge	146:22da6e220af6	187	* (real, imag, real, imag, ...).
AnnaBridge	146:22da6e220af6	188	* In the API functions, the number of samples in a complex array refers
AnnaBridge	146:22da6e220af6	189	* to the number of complex values; the array contains twice this number of
AnnaBridge	146:22da6e220af6	190	* real values.
AnnaBridge	146:22da6e220af6	191	*/
AnnaBridge	146:22da6e220af6	192
AnnaBridge	146:22da6e220af6	193	/**
AnnaBridge	146:22da6e220af6	194	* @defgroup groupFilters Filtering Functions
AnnaBridge	146:22da6e220af6	195	*/
AnnaBridge	146:22da6e220af6	196
AnnaBridge	146:22da6e220af6	197	/**
AnnaBridge	146:22da6e220af6	198	* @defgroup groupMatrix Matrix Functions
AnnaBridge	146:22da6e220af6	199	*
AnnaBridge	146:22da6e220af6	200	* This set of functions provides basic matrix math operations.
AnnaBridge	146:22da6e220af6	201	* The functions operate on matrix data structures. For example,
AnnaBridge	146:22da6e220af6	202	* the type
AnnaBridge	146:22da6e220af6	203	* definition for the floating-point matrix structure is shown
AnnaBridge	146:22da6e220af6	204	* below:
AnnaBridge	146:22da6e220af6	205	* <pre>
AnnaBridge	146:22da6e220af6	206	* typedef struct
AnnaBridge	146:22da6e220af6	207	* {
AnnaBridge	146:22da6e220af6	208	* uint16_t numRows; // number of rows of the matrix.
AnnaBridge	146:22da6e220af6	209	* uint16_t numCols; // number of columns of the matrix.
AnnaBridge	146:22da6e220af6	210	* float32_t *pData; // points to the data of the matrix.
AnnaBridge	146:22da6e220af6	211	* } arm_matrix_instance_f32;
AnnaBridge	146:22da6e220af6	212	* </pre>
AnnaBridge	146:22da6e220af6	213	* There are similar definitions for Q15 and Q31 data types.
AnnaBridge	146:22da6e220af6	214	*
AnnaBridge	146:22da6e220af6	215	* The structure specifies the size of the matrix and then points to
AnnaBridge	146:22da6e220af6	216	* an array of data. The array is of size <code>numRows X numCols</code>
AnnaBridge	146:22da6e220af6	217	* and the values are arranged in row order. That is, the
AnnaBridge	146:22da6e220af6	218	* matrix element (i, j) is stored at:
AnnaBridge	146:22da6e220af6	219	* <pre>
AnnaBridge	146:22da6e220af6	220	* pData[i*numCols + j]
AnnaBridge	146:22da6e220af6	221	* </pre>
AnnaBridge	146:22da6e220af6	222	*
AnnaBridge	146:22da6e220af6	223	* \par Init Functions
AnnaBridge	146:22da6e220af6	224	* There is an associated initialization function for each type of matrix
AnnaBridge	146:22da6e220af6	225	* data structure.
AnnaBridge	146:22da6e220af6	226	* The initialization function sets the values of the internal structure fields.
AnnaBridge	146:22da6e220af6	227	* Refer to the function <code>arm_mat_init_f32()</code>, <code>arm_mat_init_q31()</code>
AnnaBridge	146:22da6e220af6	228	* and <code>arm_mat_init_q15()</code> for floating-point, Q31 and Q15 types, respectively.
AnnaBridge	146:22da6e220af6	229	*
AnnaBridge	146:22da6e220af6	230	* \par
AnnaBridge	146:22da6e220af6	231	* Use of the initialization function is optional. However, if initialization function is used
AnnaBridge	146:22da6e220af6	232	* then the instance structure cannot be placed into a const data section.
AnnaBridge	146:22da6e220af6	233	* To place the instance structure in a const data
AnnaBridge	146:22da6e220af6	234	* section, manually initialize the data structure. For example:
AnnaBridge	146:22da6e220af6	235	* <pre>
AnnaBridge	146:22da6e220af6	236	* <code>arm_matrix_instance_f32 S = {nRows, nColumns, pData};</code>
AnnaBridge	146:22da6e220af6	237	* <code>arm_matrix_instance_q31 S = {nRows, nColumns, pData};</code>
AnnaBridge	146:22da6e220af6	238	* <code>arm_matrix_instance_q15 S = {nRows, nColumns, pData};</code>
AnnaBridge	146:22da6e220af6	239	* </pre>
AnnaBridge	146:22da6e220af6	240	* where <code>nRows</code> specifies the number of rows, <code>nColumns</code>
AnnaBridge	146:22da6e220af6	241	* specifies the number of columns, and <code>pData</code> points to the
AnnaBridge	146:22da6e220af6	242	* data array.
AnnaBridge	146:22da6e220af6	243	*
AnnaBridge	146:22da6e220af6	244	* \par Size Checking
AnnaBridge	146:22da6e220af6	245	* By default all of the matrix functions perform size checking on the input and
AnnaBridge	146:22da6e220af6	246	* output matrices. For example, the matrix addition function verifies that the
AnnaBridge	146:22da6e220af6	247	* two input matrices and the output matrix all have the same number of rows and
AnnaBridge	146:22da6e220af6	248	* columns. If the size check fails the functions return:
AnnaBridge	146:22da6e220af6	249	* <pre>
AnnaBridge	146:22da6e220af6	250	* ARM_MATH_SIZE_MISMATCH
AnnaBridge	146:22da6e220af6	251	* </pre>
AnnaBridge	146:22da6e220af6	252	* Otherwise the functions return
AnnaBridge	146:22da6e220af6	253	* <pre>
AnnaBridge	146:22da6e220af6	254	* ARM_MATH_SUCCESS
AnnaBridge	146:22da6e220af6	255	* </pre>
AnnaBridge	146:22da6e220af6	256	* There is some overhead associated with this matrix size checking.
AnnaBridge	146:22da6e220af6	257	* The matrix size checking is enabled via the \#define
AnnaBridge	146:22da6e220af6	258	* <pre>
AnnaBridge	146:22da6e220af6	259	* ARM_MATH_MATRIX_CHECK
AnnaBridge	146:22da6e220af6	260	* </pre>
AnnaBridge	146:22da6e220af6	261	* within the library project settings. By default this macro is defined
AnnaBridge	146:22da6e220af6	262	* and size checking is enabled. By changing the project settings and
AnnaBridge	146:22da6e220af6	263	* undefining this macro size checking is eliminated and the functions
AnnaBridge	146:22da6e220af6	264	* run a bit faster. With size checking disabled the functions always
AnnaBridge	146:22da6e220af6	265	* return <code>ARM_MATH_SUCCESS</code>.
AnnaBridge	146:22da6e220af6	266	*/
AnnaBridge	146:22da6e220af6	267
AnnaBridge	146:22da6e220af6	268	/**
AnnaBridge	146:22da6e220af6	269	* @defgroup groupTransforms Transform Functions
AnnaBridge	146:22da6e220af6	270	*/
AnnaBridge	146:22da6e220af6	271
AnnaBridge	146:22da6e220af6	272	/**
AnnaBridge	146:22da6e220af6	273	* @defgroup groupController Controller Functions
AnnaBridge	146:22da6e220af6	274	*/
AnnaBridge	146:22da6e220af6	275
AnnaBridge	146:22da6e220af6	276	/**
AnnaBridge	146:22da6e220af6	277	* @defgroup groupStats Statistics Functions
AnnaBridge	146:22da6e220af6	278	*/
AnnaBridge	146:22da6e220af6	279	/**
AnnaBridge	146:22da6e220af6	280	* @defgroup groupSupport Support Functions
AnnaBridge	146:22da6e220af6	281	*/
AnnaBridge	146:22da6e220af6	282
AnnaBridge	146:22da6e220af6	283	/**
AnnaBridge	146:22da6e220af6	284	* @defgroup groupInterpolation Interpolation Functions
AnnaBridge	146:22da6e220af6	285	* These functions perform 1- and 2-dimensional interpolation of data.
AnnaBridge	146:22da6e220af6	286	* Linear interpolation is used for 1-dimensional data and
AnnaBridge	146:22da6e220af6	287	* bilinear interpolation is used for 2-dimensional data.
AnnaBridge	146:22da6e220af6	288	*/
AnnaBridge	146:22da6e220af6	289
AnnaBridge	146:22da6e220af6	290	/**
AnnaBridge	146:22da6e220af6	291	* @defgroup groupExamples Examples
AnnaBridge	146:22da6e220af6	292	*/
AnnaBridge	146:22da6e220af6	293	#ifndef _ARM_MATH_H
AnnaBridge	146:22da6e220af6	294	#define _ARM_MATH_H
AnnaBridge	146:22da6e220af6	295
AnnaBridge	146:22da6e220af6	296	/* Compiler specific diagnostic adjustment */
AnnaBridge	146:22da6e220af6	297	#if defined ( __CC_ARM )
AnnaBridge	146:22da6e220af6	298
AnnaBridge	146:22da6e220af6	299	#elif defined ( __ARMCC_VERSION ) && ( __ARMCC_VERSION >= 6010050 )
AnnaBridge	146:22da6e220af6	300
AnnaBridge	146:22da6e220af6	301	#elif defined ( __GNUC__ )
AnnaBridge	146:22da6e220af6	302	#pragma GCC diagnostic push
AnnaBridge	146:22da6e220af6	303	#pragma GCC diagnostic ignored "-Wsign-conversion"
AnnaBridge	146:22da6e220af6	304	#pragma GCC diagnostic ignored "-Wconversion"
AnnaBridge	146:22da6e220af6	305	#pragma GCC diagnostic ignored "-Wunused-parameter"
AnnaBridge	146:22da6e220af6	306
AnnaBridge	146:22da6e220af6	307	#elif defined ( __ICCARM__ )
AnnaBridge	146:22da6e220af6	308
AnnaBridge	146:22da6e220af6	309	#elif defined ( __TI_ARM__ )
AnnaBridge	146:22da6e220af6	310
AnnaBridge	146:22da6e220af6	311	#elif defined ( __CSMC__ )
AnnaBridge	146:22da6e220af6	312
AnnaBridge	146:22da6e220af6	313	#elif defined ( __TASKING__ )
AnnaBridge	146:22da6e220af6	314
AnnaBridge	146:22da6e220af6	315	#else
AnnaBridge	146:22da6e220af6	316	#error Unknown compiler
AnnaBridge	146:22da6e220af6	317	#endif
AnnaBridge	146:22da6e220af6	318
AnnaBridge	146:22da6e220af6	319
AnnaBridge	146:22da6e220af6	320	#define __CMSIS_GENERIC /* disable NVIC and Systick functions */
AnnaBridge	146:22da6e220af6	321
AnnaBridge	146:22da6e220af6	322	#if defined(ARM_MATH_CM7)
AnnaBridge	146:22da6e220af6	323	#include "core_cm7.h"
AnnaBridge	146:22da6e220af6	324	#define ARM_MATH_DSP
AnnaBridge	146:22da6e220af6	325	#elif defined (ARM_MATH_CM4)
AnnaBridge	146:22da6e220af6	326	#include "core_cm4.h"
AnnaBridge	146:22da6e220af6	327	#define ARM_MATH_DSP
AnnaBridge	146:22da6e220af6	328	#elif defined (ARM_MATH_CM3)
AnnaBridge	146:22da6e220af6	329	#include "core_cm3.h"
AnnaBridge	146:22da6e220af6	330	#elif defined (ARM_MATH_CM0)
AnnaBridge	146:22da6e220af6	331	#include "core_cm0.h"
AnnaBridge	146:22da6e220af6	332	#define ARM_MATH_CM0_FAMILY
AnnaBridge	146:22da6e220af6	333	#elif defined (ARM_MATH_CM0PLUS)
AnnaBridge	146:22da6e220af6	334	#include "core_cm0plus.h"
AnnaBridge	146:22da6e220af6	335	#define ARM_MATH_CM0_FAMILY
AnnaBridge	146:22da6e220af6	336	#elif defined (ARM_MATH_ARMV8MBL)
AnnaBridge	146:22da6e220af6	337	#include "core_armv8mbl.h"
AnnaBridge	146:22da6e220af6	338	#define ARM_MATH_CM0_FAMILY
AnnaBridge	146:22da6e220af6	339	#elif defined (ARM_MATH_ARMV8MML)
AnnaBridge	146:22da6e220af6	340	#include "core_armv8mml.h"
AnnaBridge	146:22da6e220af6	341	#if (defined (__DSP_PRESENT) && (__DSP_PRESENT == 1))
AnnaBridge	146:22da6e220af6	342	#define ARM_MATH_DSP
AnnaBridge	146:22da6e220af6	343	#endif
AnnaBridge	146:22da6e220af6	344	#else
AnnaBridge	146:22da6e220af6	345	#error "Define according the used Cortex core ARM_MATH_CM7, ARM_MATH_CM4, ARM_MATH_CM3, ARM_MATH_CM0PLUS, ARM_MATH_CM0, ARM_MATH_ARMV8MBL, ARM_MATH_ARMV8MML"
AnnaBridge	146:22da6e220af6	346	#endif
AnnaBridge	146:22da6e220af6	347
AnnaBridge	146:22da6e220af6	348	#undef __CMSIS_GENERIC /* enable NVIC and Systick functions */
AnnaBridge	146:22da6e220af6	349	#include "string.h"
AnnaBridge	146:22da6e220af6	350	#include "math.h"
AnnaBridge	146:22da6e220af6	351	#ifdef __cplusplus
AnnaBridge	146:22da6e220af6	352	extern "C"
AnnaBridge	146:22da6e220af6	353	{
AnnaBridge	146:22da6e220af6	354	#endif
AnnaBridge	146:22da6e220af6	355
AnnaBridge	146:22da6e220af6	356
AnnaBridge	146:22da6e220af6	357	/**
AnnaBridge	146:22da6e220af6	358	* @brief Macros required for reciprocal calculation in Normalized LMS
AnnaBridge	146:22da6e220af6	359	*/
AnnaBridge	146:22da6e220af6	360
AnnaBridge	146:22da6e220af6	361	#define DELTA_Q31 (0x100)
AnnaBridge	146:22da6e220af6	362	#define DELTA_Q15 0x5
AnnaBridge	146:22da6e220af6	363	#define INDEX_MASK 0x0000003F
AnnaBridge	146:22da6e220af6	364	#ifndef PI
AnnaBridge	146:22da6e220af6	365	#define PI 3.14159265358979f
AnnaBridge	146:22da6e220af6	366	#endif
AnnaBridge	146:22da6e220af6	367
AnnaBridge	146:22da6e220af6	368	/**
AnnaBridge	146:22da6e220af6	369	* @brief Macros required for SINE and COSINE Fast math approximations
AnnaBridge	146:22da6e220af6	370	*/
AnnaBridge	146:22da6e220af6	371
AnnaBridge	146:22da6e220af6	372	#define FAST_MATH_TABLE_SIZE 512
AnnaBridge	146:22da6e220af6	373	#define FAST_MATH_Q31_SHIFT (32 - 10)
AnnaBridge	146:22da6e220af6	374	#define FAST_MATH_Q15_SHIFT (16 - 10)
AnnaBridge	146:22da6e220af6	375	#define CONTROLLER_Q31_SHIFT (32 - 9)
AnnaBridge	146:22da6e220af6	376	#define TABLE_SPACING_Q31 0x400000
AnnaBridge	146:22da6e220af6	377	#define TABLE_SPACING_Q15 0x80
AnnaBridge	146:22da6e220af6	378
AnnaBridge	146:22da6e220af6	379	/**
AnnaBridge	146:22da6e220af6	380	* @brief Macros required for SINE and COSINE Controller functions
AnnaBridge	146:22da6e220af6	381	*/
AnnaBridge	146:22da6e220af6	382	/* 1.31(q31) Fixed value of 2/360 */
AnnaBridge	146:22da6e220af6	383	/* -1 to +1 is divided into 360 values so total spacing is (2/360) */
AnnaBridge	146:22da6e220af6	384	#define INPUT_SPACING 0xB60B61
AnnaBridge	146:22da6e220af6	385
AnnaBridge	146:22da6e220af6	386	/**
AnnaBridge	146:22da6e220af6	387	* @brief Macro for Unaligned Support
AnnaBridge	146:22da6e220af6	388	*/
AnnaBridge	146:22da6e220af6	389	#ifndef UNALIGNED_SUPPORT_DISABLE
AnnaBridge	146:22da6e220af6	390	#define ALIGN4
AnnaBridge	146:22da6e220af6	391	#else
AnnaBridge	146:22da6e220af6	392	#if defined (__GNUC__)
AnnaBridge	146:22da6e220af6	393	#define ALIGN4 __attribute__((aligned(4)))
AnnaBridge	146:22da6e220af6	394	#else
AnnaBridge	146:22da6e220af6	395	#define ALIGN4 __align(4)
AnnaBridge	146:22da6e220af6	396	#endif
AnnaBridge	146:22da6e220af6	397	#endif /* #ifndef UNALIGNED_SUPPORT_DISABLE */
AnnaBridge	146:22da6e220af6	398
AnnaBridge	146:22da6e220af6	399	/**
AnnaBridge	146:22da6e220af6	400	* @brief Error status returned by some functions in the library.
AnnaBridge	146:22da6e220af6	401	*/
AnnaBridge	146:22da6e220af6	402
AnnaBridge	146:22da6e220af6	403	typedef enum
AnnaBridge	146:22da6e220af6	404	{
AnnaBridge	146:22da6e220af6	405	ARM_MATH_SUCCESS = 0, /*< No error /
AnnaBridge	146:22da6e220af6	406	ARM_MATH_ARGUMENT_ERROR = -1, /*< One or more arguments are incorrect /
AnnaBridge	146:22da6e220af6	407	ARM_MATH_LENGTH_ERROR = -2, /*< Length of data buffer is incorrect /
AnnaBridge	146:22da6e220af6	408	ARM_MATH_SIZE_MISMATCH = -3, /*< Size of matrices is not compatible with the operation. /
AnnaBridge	146:22da6e220af6	409	ARM_MATH_NANINF = -4, /*< Not-a-number (NaN) or infinity is generated /
AnnaBridge	146:22da6e220af6	410	ARM_MATH_SINGULAR = -5, /*< Generated by matrix inversion if the input matrix is singular and cannot be inverted. /
AnnaBridge	146:22da6e220af6	411	ARM_MATH_TEST_FAILURE = -6 /*< Test Failed /
AnnaBridge	146:22da6e220af6	412	} arm_status;
AnnaBridge	146:22da6e220af6	413
AnnaBridge	146:22da6e220af6	414	/**
AnnaBridge	146:22da6e220af6	415	* @brief 8-bit fractional data type in 1.7 format.
AnnaBridge	146:22da6e220af6	416	*/
AnnaBridge	146:22da6e220af6	417	typedef int8_t q7_t;
AnnaBridge	146:22da6e220af6	418
AnnaBridge	146:22da6e220af6	419	/**
AnnaBridge	146:22da6e220af6	420	* @brief 16-bit fractional data type in 1.15 format.
AnnaBridge	146:22da6e220af6	421	*/
AnnaBridge	146:22da6e220af6	422	typedef int16_t q15_t;
AnnaBridge	146:22da6e220af6	423
AnnaBridge	146:22da6e220af6	424	/**
AnnaBridge	146:22da6e220af6	425	* @brief 32-bit fractional data type in 1.31 format.
AnnaBridge	146:22da6e220af6	426	*/
AnnaBridge	146:22da6e220af6	427	typedef int32_t q31_t;
AnnaBridge	146:22da6e220af6	428
AnnaBridge	146:22da6e220af6	429	/**
AnnaBridge	146:22da6e220af6	430	* @brief 64-bit fractional data type in 1.63 format.
AnnaBridge	146:22da6e220af6	431	*/
AnnaBridge	146:22da6e220af6	432	typedef int64_t q63_t;
AnnaBridge	146:22da6e220af6	433
AnnaBridge	146:22da6e220af6	434	/**
AnnaBridge	146:22da6e220af6	435	* @brief 32-bit floating-point type definition.
AnnaBridge	146:22da6e220af6	436	*/
AnnaBridge	146:22da6e220af6	437	typedef float float32_t;
AnnaBridge	146:22da6e220af6	438
AnnaBridge	146:22da6e220af6	439	/**
AnnaBridge	146:22da6e220af6	440	* @brief 64-bit floating-point type definition.
AnnaBridge	146:22da6e220af6	441	*/
AnnaBridge	146:22da6e220af6	442	typedef double float64_t;
AnnaBridge	146:22da6e220af6	443
AnnaBridge	146:22da6e220af6	444	/**
AnnaBridge	146:22da6e220af6	445	* @brief definition to read/write two 16 bit values.
AnnaBridge	146:22da6e220af6	446	*/
AnnaBridge	146:22da6e220af6	447	#if defined ( __CC_ARM )
AnnaBridge	146:22da6e220af6	448	#define __SIMD32_TYPE int32_t __packed
AnnaBridge	146:22da6e220af6	449	#define CMSIS_UNUSED __attribute__((unused))
AnnaBridge	146:22da6e220af6	450	#define CMSIS_INLINE __attribute__((always_inline))
AnnaBridge	146:22da6e220af6	451
AnnaBridge	146:22da6e220af6	452	#elif defined ( __ARMCC_VERSION ) && ( __ARMCC_VERSION >= 6010050 )
AnnaBridge	146:22da6e220af6	453	#define __SIMD32_TYPE int32_t
AnnaBridge	146:22da6e220af6	454	#define CMSIS_UNUSED __attribute__((unused))
AnnaBridge	146:22da6e220af6	455	#define CMSIS_INLINE __attribute__((always_inline))
AnnaBridge	146:22da6e220af6	456
AnnaBridge	146:22da6e220af6	457	#elif defined ( __GNUC__ )
AnnaBridge	146:22da6e220af6	458	#define __SIMD32_TYPE int32_t
AnnaBridge	146:22da6e220af6	459	#define CMSIS_UNUSED __attribute__((unused))
AnnaBridge	146:22da6e220af6	460	#define CMSIS_INLINE __attribute__((always_inline))
AnnaBridge	146:22da6e220af6	461
AnnaBridge	146:22da6e220af6	462	#elif defined ( __ICCARM__ )
AnnaBridge	146:22da6e220af6	463	#define __SIMD32_TYPE int32_t __packed
AnnaBridge	146:22da6e220af6	464	#define CMSIS_UNUSED
AnnaBridge	146:22da6e220af6	465	#define CMSIS_INLINE
AnnaBridge	146:22da6e220af6	466
AnnaBridge	146:22da6e220af6	467	#elif defined ( __TI_ARM__ )
AnnaBridge	146:22da6e220af6	468	#define __SIMD32_TYPE int32_t
AnnaBridge	146:22da6e220af6	469	#define CMSIS_UNUSED __attribute__((unused))
AnnaBridge	146:22da6e220af6	470	#define CMSIS_INLINE
AnnaBridge	146:22da6e220af6	471
AnnaBridge	146:22da6e220af6	472	#elif defined ( __CSMC__ )
AnnaBridge	146:22da6e220af6	473	#define __SIMD32_TYPE int32_t
AnnaBridge	146:22da6e220af6	474	#define CMSIS_UNUSED
AnnaBridge	146:22da6e220af6	475	#define CMSIS_INLINE
AnnaBridge	146:22da6e220af6	476
AnnaBridge	146:22da6e220af6	477	#elif defined ( __TASKING__ )
AnnaBridge	146:22da6e220af6	478	#define __SIMD32_TYPE __unaligned int32_t
AnnaBridge	146:22da6e220af6	479	#define CMSIS_UNUSED
AnnaBridge	146:22da6e220af6	480	#define CMSIS_INLINE
AnnaBridge	146:22da6e220af6	481
AnnaBridge	146:22da6e220af6	482	#else
AnnaBridge	146:22da6e220af6	483	#error Unknown compiler
AnnaBridge	146:22da6e220af6	484	#endif
AnnaBridge	146:22da6e220af6	485
AnnaBridge	146:22da6e220af6	486	#define __SIMD32(addr) ((__SIMD32_TYPE *) & (addr))
AnnaBridge	146:22da6e220af6	487	#define __SIMD32_CONST(addr) ((__SIMD32_TYPE *)(addr))
AnnaBridge	146:22da6e220af6	488	#define _SIMD32_OFFSET(addr) ((__SIMD32_TYPE ) (addr))
AnnaBridge	146:22da6e220af6	489	#define __SIMD64(addr) ((int64_t *) & (addr))
AnnaBridge	146:22da6e220af6	490
AnnaBridge	146:22da6e220af6	491	/* #if defined (ARM_MATH_CM3) \|\| defined (ARM_MATH_CM0_FAMILY) */
AnnaBridge	146:22da6e220af6	492	#if !defined (ARM_MATH_DSP)
AnnaBridge	146:22da6e220af6	493	/**
AnnaBridge	146:22da6e220af6	494	* @brief definition to pack two 16 bit values.
AnnaBridge	146:22da6e220af6	495	*/
AnnaBridge	146:22da6e220af6	496	#define __PKHBT(ARG1, ARG2, ARG3) ( (((int32_t)(ARG1) << 0) & (int32_t)0x0000FFFF) \| \
AnnaBridge	146:22da6e220af6	497	(((int32_t)(ARG2) << ARG3) & (int32_t)0xFFFF0000) )
AnnaBridge	146:22da6e220af6	498	#define __PKHTB(ARG1, ARG2, ARG3) ( (((int32_t)(ARG1) << 0) & (int32_t)0xFFFF0000) \| \
AnnaBridge	146:22da6e220af6	499	(((int32_t)(ARG2) >> ARG3) & (int32_t)0x0000FFFF) )
AnnaBridge	146:22da6e220af6	500
AnnaBridge	146:22da6e220af6	501	/* #endif // defined (ARM_MATH_CM3) \|\| defined (ARM_MATH_CM0_FAMILY) */
AnnaBridge	146:22da6e220af6	502	#endif /* !defined (ARM_MATH_DSP) */
AnnaBridge	146:22da6e220af6	503
AnnaBridge	146:22da6e220af6	504	/**
AnnaBridge	146:22da6e220af6	505	* @brief definition to pack four 8 bit values.
AnnaBridge	146:22da6e220af6	506	*/
AnnaBridge	146:22da6e220af6	507	#ifndef ARM_MATH_BIG_ENDIAN
AnnaBridge	146:22da6e220af6	508
AnnaBridge	146:22da6e220af6	509	#define __PACKq7(v0,v1,v2,v3) ( (((int32_t)(v0) << 0) & (int32_t)0x000000FF) \| \
AnnaBridge	146:22da6e220af6	510	(((int32_t)(v1) << 8) & (int32_t)0x0000FF00) \| \
AnnaBridge	146:22da6e220af6	511	(((int32_t)(v2) << 16) & (int32_t)0x00FF0000) \| \
AnnaBridge	146:22da6e220af6	512	(((int32_t)(v3) << 24) & (int32_t)0xFF000000) )
AnnaBridge	146:22da6e220af6	513	#else
AnnaBridge	146:22da6e220af6	514
AnnaBridge	146:22da6e220af6	515	#define __PACKq7(v0,v1,v2,v3) ( (((int32_t)(v3) << 0) & (int32_t)0x000000FF) \| \
AnnaBridge	146:22da6e220af6	516	(((int32_t)(v2) << 8) & (int32_t)0x0000FF00) \| \
AnnaBridge	146:22da6e220af6	517	(((int32_t)(v1) << 16) & (int32_t)0x00FF0000) \| \
AnnaBridge	146:22da6e220af6	518	(((int32_t)(v0) << 24) & (int32_t)0xFF000000) )
AnnaBridge	146:22da6e220af6	519
AnnaBridge	146:22da6e220af6	520	#endif
AnnaBridge	146:22da6e220af6	521
AnnaBridge	146:22da6e220af6	522
AnnaBridge	146:22da6e220af6	523	/**
AnnaBridge	146:22da6e220af6	524	* @brief Clips Q63 to Q31 values.
AnnaBridge	146:22da6e220af6	525	*/
AnnaBridge	146:22da6e220af6	526	CMSIS_INLINE __STATIC_INLINE q31_t clip_q63_to_q31(
AnnaBridge	146:22da6e220af6	527	q63_t x)
AnnaBridge	146:22da6e220af6	528	{
AnnaBridge	146:22da6e220af6	529	return ((q31_t) (x >> 32) != ((q31_t) x >> 31)) ?
AnnaBridge	146:22da6e220af6	530	((0x7FFFFFFF ^ ((q31_t) (x >> 63)))) : (q31_t) x;
AnnaBridge	146:22da6e220af6	531	}
AnnaBridge	146:22da6e220af6	532
AnnaBridge	146:22da6e220af6	533	/**
AnnaBridge	146:22da6e220af6	534	* @brief Clips Q63 to Q15 values.
AnnaBridge	146:22da6e220af6	535	*/
AnnaBridge	146:22da6e220af6	536	CMSIS_INLINE __STATIC_INLINE q15_t clip_q63_to_q15(
AnnaBridge	146:22da6e220af6	537	q63_t x)
AnnaBridge	146:22da6e220af6	538	{
AnnaBridge	146:22da6e220af6	539	return ((q31_t) (x >> 32) != ((q31_t) x >> 31)) ?
AnnaBridge	146:22da6e220af6	540	((0x7FFF ^ ((q15_t) (x >> 63)))) : (q15_t) (x >> 15);
AnnaBridge	146:22da6e220af6	541	}
AnnaBridge	146:22da6e220af6	542
AnnaBridge	146:22da6e220af6	543	/**
AnnaBridge	146:22da6e220af6	544	* @brief Clips Q31 to Q7 values.
AnnaBridge	146:22da6e220af6	545	*/
AnnaBridge	146:22da6e220af6	546	CMSIS_INLINE __STATIC_INLINE q7_t clip_q31_to_q7(
AnnaBridge	146:22da6e220af6	547	q31_t x)
AnnaBridge	146:22da6e220af6	548	{
AnnaBridge	146:22da6e220af6	549	return ((q31_t) (x >> 24) != ((q31_t) x >> 23)) ?
AnnaBridge	146:22da6e220af6	550	((0x7F ^ ((q7_t) (x >> 31)))) : (q7_t) x;
AnnaBridge	146:22da6e220af6	551	}
AnnaBridge	146:22da6e220af6	552
AnnaBridge	146:22da6e220af6	553	/**
AnnaBridge	146:22da6e220af6	554	* @brief Clips Q31 to Q15 values.
AnnaBridge	146:22da6e220af6	555	*/
AnnaBridge	146:22da6e220af6	556	CMSIS_INLINE __STATIC_INLINE q15_t clip_q31_to_q15(
AnnaBridge	146:22da6e220af6	557	q31_t x)
AnnaBridge	146:22da6e220af6	558	{
AnnaBridge	146:22da6e220af6	559	return ((q31_t) (x >> 16) != ((q31_t) x >> 15)) ?
AnnaBridge	146:22da6e220af6	560	((0x7FFF ^ ((q15_t) (x >> 31)))) : (q15_t) x;
AnnaBridge	146:22da6e220af6	561	}
AnnaBridge	146:22da6e220af6	562
AnnaBridge	146:22da6e220af6	563	/**
AnnaBridge	146:22da6e220af6	564	* @brief Multiplies 32 X 64 and returns 32 bit result in 2.30 format.
AnnaBridge	146:22da6e220af6	565	*/
AnnaBridge	146:22da6e220af6	566
AnnaBridge	146:22da6e220af6	567	CMSIS_INLINE __STATIC_INLINE q63_t mult32x64(
AnnaBridge	146:22da6e220af6	568	q63_t x,
AnnaBridge	146:22da6e220af6	569	q31_t y)
AnnaBridge	146:22da6e220af6	570	{
AnnaBridge	146:22da6e220af6	571	return ((((q63_t) (x & 0x00000000FFFFFFFF) * y) >> 32) +
AnnaBridge	146:22da6e220af6	572	(((q63_t) (x >> 32) * y)));
AnnaBridge	146:22da6e220af6	573	}
AnnaBridge	146:22da6e220af6	574
AnnaBridge	146:22da6e220af6	575	/**
AnnaBridge	146:22da6e220af6	576	* @brief Function to Calculates 1/in (reciprocal) value of Q31 Data type.
AnnaBridge	146:22da6e220af6	577	*/
AnnaBridge	146:22da6e220af6	578
AnnaBridge	146:22da6e220af6	579	CMSIS_INLINE __STATIC_INLINE uint32_t arm_recip_q31(
AnnaBridge	146:22da6e220af6	580	q31_t in,
AnnaBridge	146:22da6e220af6	581	q31_t * dst,
AnnaBridge	146:22da6e220af6	582	q31_t * pRecipTable)
AnnaBridge	146:22da6e220af6	583	{
AnnaBridge	146:22da6e220af6	584	q31_t out;
AnnaBridge	146:22da6e220af6	585	uint32_t tempVal;
AnnaBridge	146:22da6e220af6	586	uint32_t index, i;
AnnaBridge	146:22da6e220af6	587	uint32_t signBits;
AnnaBridge	146:22da6e220af6	588
AnnaBridge	146:22da6e220af6	589	if (in > 0)
AnnaBridge	146:22da6e220af6	590	{
AnnaBridge	146:22da6e220af6	591	signBits = ((uint32_t) (__CLZ( in) - 1));
AnnaBridge	146:22da6e220af6	592	}
AnnaBridge	146:22da6e220af6	593	else
AnnaBridge	146:22da6e220af6	594	{
AnnaBridge	146:22da6e220af6	595	signBits = ((uint32_t) (__CLZ(-in) - 1));
AnnaBridge	146:22da6e220af6	596	}
AnnaBridge	146:22da6e220af6	597
AnnaBridge	146:22da6e220af6	598	/* Convert input sample to 1.31 format */
AnnaBridge	146:22da6e220af6	599	in = (in << signBits);
AnnaBridge	146:22da6e220af6	600
AnnaBridge	146:22da6e220af6	601	/* calculation of index for initial approximated Val */
AnnaBridge	146:22da6e220af6	602	index = (uint32_t)(in >> 24);
AnnaBridge	146:22da6e220af6	603	index = (index & INDEX_MASK);
AnnaBridge	146:22da6e220af6	604
AnnaBridge	146:22da6e220af6	605	/* 1.31 with exp 1 */
AnnaBridge	146:22da6e220af6	606	out = pRecipTable[index];
AnnaBridge	146:22da6e220af6	607
AnnaBridge	146:22da6e220af6	608	/* calculation of reciprocal value */
AnnaBridge	146:22da6e220af6	609	/* running approximation for two iterations */
AnnaBridge	146:22da6e220af6	610	for (i = 0u; i < 2u; i++)
AnnaBridge	146:22da6e220af6	611	{
AnnaBridge	146:22da6e220af6	612	tempVal = (uint32_t) (((q63_t) in * out) >> 31);
AnnaBridge	146:22da6e220af6	613	tempVal = 0x7FFFFFFFu - tempVal;
AnnaBridge	146:22da6e220af6	614	/* 1.31 with exp 1 */
AnnaBridge	146:22da6e220af6	615	/* out = (q31_t) (((q63_t) out * tempVal) >> 30); */
AnnaBridge	146:22da6e220af6	616	out = clip_q63_to_q31(((q63_t) out * tempVal) >> 30);
AnnaBridge	146:22da6e220af6	617	}
AnnaBridge	146:22da6e220af6	618
AnnaBridge	146:22da6e220af6	619	/* write output */
AnnaBridge	146:22da6e220af6	620	*dst = out;
AnnaBridge	146:22da6e220af6	621
AnnaBridge	146:22da6e220af6	622	/* return num of signbits of out = 1/in value */
AnnaBridge	146:22da6e220af6	623	return (signBits + 1u);
AnnaBridge	146:22da6e220af6	624	}
AnnaBridge	146:22da6e220af6	625
AnnaBridge	146:22da6e220af6	626
AnnaBridge	146:22da6e220af6	627	/**
AnnaBridge	146:22da6e220af6	628	* @brief Function to Calculates 1/in (reciprocal) value of Q15 Data type.
AnnaBridge	146:22da6e220af6	629	*/
AnnaBridge	146:22da6e220af6	630	CMSIS_INLINE __STATIC_INLINE uint32_t arm_recip_q15(
AnnaBridge	146:22da6e220af6	631	q15_t in,
AnnaBridge	146:22da6e220af6	632	q15_t * dst,
AnnaBridge	146:22da6e220af6	633	q15_t * pRecipTable)
AnnaBridge	146:22da6e220af6	634	{
AnnaBridge	146:22da6e220af6	635	q15_t out = 0;
AnnaBridge	146:22da6e220af6	636	uint32_t tempVal = 0;
AnnaBridge	146:22da6e220af6	637	uint32_t index = 0, i = 0;
AnnaBridge	146:22da6e220af6	638	uint32_t signBits = 0;
AnnaBridge	146:22da6e220af6	639
AnnaBridge	146:22da6e220af6	640	if (in > 0)
AnnaBridge	146:22da6e220af6	641	{
AnnaBridge	146:22da6e220af6	642	signBits = ((uint32_t)(__CLZ( in) - 17));
AnnaBridge	146:22da6e220af6	643	}
AnnaBridge	146:22da6e220af6	644	else
AnnaBridge	146:22da6e220af6	645	{
AnnaBridge	146:22da6e220af6	646	signBits = ((uint32_t)(__CLZ(-in) - 17));
AnnaBridge	146:22da6e220af6	647	}
AnnaBridge	146:22da6e220af6	648
AnnaBridge	146:22da6e220af6	649	/* Convert input sample to 1.15 format */
AnnaBridge	146:22da6e220af6	650	in = (in << signBits);
AnnaBridge	146:22da6e220af6	651
AnnaBridge	146:22da6e220af6	652	/* calculation of index for initial approximated Val */
AnnaBridge	146:22da6e220af6	653	index = (uint32_t)(in >> 8);
AnnaBridge	146:22da6e220af6	654	index = (index & INDEX_MASK);
AnnaBridge	146:22da6e220af6	655
AnnaBridge	146:22da6e220af6	656	/* 1.15 with exp 1 */
AnnaBridge	146:22da6e220af6	657	out = pRecipTable[index];
AnnaBridge	146:22da6e220af6	658
AnnaBridge	146:22da6e220af6	659	/* calculation of reciprocal value */
AnnaBridge	146:22da6e220af6	660	/* running approximation for two iterations */
AnnaBridge	146:22da6e220af6	661	for (i = 0u; i < 2u; i++)
AnnaBridge	146:22da6e220af6	662	{
AnnaBridge	146:22da6e220af6	663	tempVal = (uint32_t) (((q31_t) in * out) >> 15);
AnnaBridge	146:22da6e220af6	664	tempVal = 0x7FFFu - tempVal;
AnnaBridge	146:22da6e220af6	665	/* 1.15 with exp 1 */
AnnaBridge	146:22da6e220af6	666	out = (q15_t) (((q31_t) out * tempVal) >> 14);
AnnaBridge	146:22da6e220af6	667	/* out = clip_q31_to_q15(((q31_t) out * tempVal) >> 14); */
AnnaBridge	146:22da6e220af6	668	}
AnnaBridge	146:22da6e220af6	669
AnnaBridge	146:22da6e220af6	670	/* write output */
AnnaBridge	146:22da6e220af6	671	*dst = out;
AnnaBridge	146:22da6e220af6	672
AnnaBridge	146:22da6e220af6	673	/* return num of signbits of out = 1/in value */
AnnaBridge	146:22da6e220af6	674	return (signBits + 1);
AnnaBridge	146:22da6e220af6	675	}
AnnaBridge	146:22da6e220af6	676
AnnaBridge	146:22da6e220af6	677	/*
AnnaBridge	146:22da6e220af6	678	* @brief C custom defined intrinsic function for M3 and M0 processors
AnnaBridge	146:22da6e220af6	679	*/
AnnaBridge	146:22da6e220af6	680	/* #if defined (ARM_MATH_CM3) \|\| defined (ARM_MATH_CM0_FAMILY) */
AnnaBridge	146:22da6e220af6	681	#if !defined (ARM_MATH_DSP)
AnnaBridge	146:22da6e220af6	682
AnnaBridge	146:22da6e220af6	683	/*
AnnaBridge	146:22da6e220af6	684	* @brief C custom defined QADD8 for M3 and M0 processors
AnnaBridge	146:22da6e220af6	685	*/
AnnaBridge	146:22da6e220af6	686	CMSIS_INLINE __STATIC_INLINE uint32_t __QADD8(
AnnaBridge	146:22da6e220af6	687	uint32_t x,
AnnaBridge	146:22da6e220af6	688	uint32_t y)
AnnaBridge	146:22da6e220af6	689	{
AnnaBridge	146:22da6e220af6	690	q31_t r, s, t, u;
AnnaBridge	146:22da6e220af6	691
AnnaBridge	146:22da6e220af6	692	r = __SSAT(((((q31_t)x << 24) >> 24) + (((q31_t)y << 24) >> 24)), 8) & (int32_t)0x000000FF;
AnnaBridge	146:22da6e220af6	693	s = __SSAT(((((q31_t)x << 16) >> 24) + (((q31_t)y << 16) >> 24)), 8) & (int32_t)0x000000FF;
AnnaBridge	146:22da6e220af6	694	t = __SSAT(((((q31_t)x << 8) >> 24) + (((q31_t)y << 8) >> 24)), 8) & (int32_t)0x000000FF;
AnnaBridge	146:22da6e220af6	695	u = __SSAT(((((q31_t)x ) >> 24) + (((q31_t)y ) >> 24)), 8) & (int32_t)0x000000FF;
AnnaBridge	146:22da6e220af6	696
AnnaBridge	146:22da6e220af6	697	return ((uint32_t)((u << 24) \| (t << 16) \| (s << 8) \| (r )));
AnnaBridge	146:22da6e220af6	698	}
AnnaBridge	146:22da6e220af6	699
AnnaBridge	146:22da6e220af6	700
AnnaBridge	146:22da6e220af6	701	/*
AnnaBridge	146:22da6e220af6	702	* @brief C custom defined QSUB8 for M3 and M0 processors
AnnaBridge	146:22da6e220af6	703	*/
AnnaBridge	146:22da6e220af6	704	CMSIS_INLINE __STATIC_INLINE uint32_t __QSUB8(
AnnaBridge	146:22da6e220af6	705	uint32_t x,
AnnaBridge	146:22da6e220af6	706	uint32_t y)
AnnaBridge	146:22da6e220af6	707	{
AnnaBridge	146:22da6e220af6	708	q31_t r, s, t, u;
AnnaBridge	146:22da6e220af6	709
AnnaBridge	146:22da6e220af6	710	r = __SSAT(((((q31_t)x << 24) >> 24) - (((q31_t)y << 24) >> 24)), 8) & (int32_t)0x000000FF;
AnnaBridge	146:22da6e220af6	711	s = __SSAT(((((q31_t)x << 16) >> 24) - (((q31_t)y << 16) >> 24)), 8) & (int32_t)0x000000FF;
AnnaBridge	146:22da6e220af6	712	t = __SSAT(((((q31_t)x << 8) >> 24) - (((q31_t)y << 8) >> 24)), 8) & (int32_t)0x000000FF;
AnnaBridge	146:22da6e220af6	713	u = __SSAT(((((q31_t)x ) >> 24) - (((q31_t)y ) >> 24)), 8) & (int32_t)0x000000FF;
AnnaBridge	146:22da6e220af6	714
AnnaBridge	146:22da6e220af6	715	return ((uint32_t)((u << 24) \| (t << 16) \| (s << 8) \| (r )));
AnnaBridge	146:22da6e220af6	716	}
AnnaBridge	146:22da6e220af6	717
AnnaBridge	146:22da6e220af6	718
AnnaBridge	146:22da6e220af6	719	/*
AnnaBridge	146:22da6e220af6	720	* @brief C custom defined QADD16 for M3 and M0 processors
AnnaBridge	146:22da6e220af6	721	*/
AnnaBridge	146:22da6e220af6	722	CMSIS_INLINE __STATIC_INLINE uint32_t __QADD16(
AnnaBridge	146:22da6e220af6	723	uint32_t x,
AnnaBridge	146:22da6e220af6	724	uint32_t y)
AnnaBridge	146:22da6e220af6	725	{
AnnaBridge	146:22da6e220af6	726	/* q31_t r, s; without initialisation 'arm_offset_q15 test' fails but 'intrinsic' tests pass! for armCC */
AnnaBridge	146:22da6e220af6	727	q31_t r = 0, s = 0;
AnnaBridge	146:22da6e220af6	728
AnnaBridge	146:22da6e220af6	729	r = __SSAT(((((q31_t)x << 16) >> 16) + (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	730	s = __SSAT(((((q31_t)x ) >> 16) + (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	731
AnnaBridge	146:22da6e220af6	732	return ((uint32_t)((s << 16) \| (r )));
AnnaBridge	146:22da6e220af6	733	}
AnnaBridge	146:22da6e220af6	734
AnnaBridge	146:22da6e220af6	735
AnnaBridge	146:22da6e220af6	736	/*
AnnaBridge	146:22da6e220af6	737	* @brief C custom defined SHADD16 for M3 and M0 processors
AnnaBridge	146:22da6e220af6	738	*/
AnnaBridge	146:22da6e220af6	739	CMSIS_INLINE __STATIC_INLINE uint32_t __SHADD16(
AnnaBridge	146:22da6e220af6	740	uint32_t x,
AnnaBridge	146:22da6e220af6	741	uint32_t y)
AnnaBridge	146:22da6e220af6	742	{
AnnaBridge	146:22da6e220af6	743	q31_t r, s;
AnnaBridge	146:22da6e220af6	744
AnnaBridge	146:22da6e220af6	745	r = (((((q31_t)x << 16) >> 16) + (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	746	s = (((((q31_t)x ) >> 16) + (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	747
AnnaBridge	146:22da6e220af6	748	return ((uint32_t)((s << 16) \| (r )));
AnnaBridge	146:22da6e220af6	749	}
AnnaBridge	146:22da6e220af6	750
AnnaBridge	146:22da6e220af6	751
AnnaBridge	146:22da6e220af6	752	/*
AnnaBridge	146:22da6e220af6	753	* @brief C custom defined QSUB16 for M3 and M0 processors
AnnaBridge	146:22da6e220af6	754	*/
AnnaBridge	146:22da6e220af6	755	CMSIS_INLINE __STATIC_INLINE uint32_t __QSUB16(
AnnaBridge	146:22da6e220af6	756	uint32_t x,
AnnaBridge	146:22da6e220af6	757	uint32_t y)
AnnaBridge	146:22da6e220af6	758	{
AnnaBridge	146:22da6e220af6	759	q31_t r, s;
AnnaBridge	146:22da6e220af6	760
AnnaBridge	146:22da6e220af6	761	r = __SSAT(((((q31_t)x << 16) >> 16) - (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	762	s = __SSAT(((((q31_t)x ) >> 16) - (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	763
AnnaBridge	146:22da6e220af6	764	return ((uint32_t)((s << 16) \| (r )));
AnnaBridge	146:22da6e220af6	765	}
AnnaBridge	146:22da6e220af6	766
AnnaBridge	146:22da6e220af6	767
AnnaBridge	146:22da6e220af6	768	/*
AnnaBridge	146:22da6e220af6	769	* @brief C custom defined SHSUB16 for M3 and M0 processors
AnnaBridge	146:22da6e220af6	770	*/
AnnaBridge	146:22da6e220af6	771	CMSIS_INLINE __STATIC_INLINE uint32_t __SHSUB16(
AnnaBridge	146:22da6e220af6	772	uint32_t x,
AnnaBridge	146:22da6e220af6	773	uint32_t y)
AnnaBridge	146:22da6e220af6	774	{
AnnaBridge	146:22da6e220af6	775	q31_t r, s;
AnnaBridge	146:22da6e220af6	776
AnnaBridge	146:22da6e220af6	777	r = (((((q31_t)x << 16) >> 16) - (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	778	s = (((((q31_t)x ) >> 16) - (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	779
AnnaBridge	146:22da6e220af6	780	return ((uint32_t)((s << 16) \| (r )));
AnnaBridge	146:22da6e220af6	781	}
AnnaBridge	146:22da6e220af6	782
AnnaBridge	146:22da6e220af6	783
AnnaBridge	146:22da6e220af6	784	/*
AnnaBridge	146:22da6e220af6	785	* @brief C custom defined QASX for M3 and M0 processors
AnnaBridge	146:22da6e220af6	786	*/
AnnaBridge	146:22da6e220af6	787	CMSIS_INLINE __STATIC_INLINE uint32_t __QASX(
AnnaBridge	146:22da6e220af6	788	uint32_t x,
AnnaBridge	146:22da6e220af6	789	uint32_t y)
AnnaBridge	146:22da6e220af6	790	{
AnnaBridge	146:22da6e220af6	791	q31_t r, s;
AnnaBridge	146:22da6e220af6	792
AnnaBridge	146:22da6e220af6	793	r = __SSAT(((((q31_t)x << 16) >> 16) - (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	794	s = __SSAT(((((q31_t)x ) >> 16) + (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	795
AnnaBridge	146:22da6e220af6	796	return ((uint32_t)((s << 16) \| (r )));
AnnaBridge	146:22da6e220af6	797	}
AnnaBridge	146:22da6e220af6	798
AnnaBridge	146:22da6e220af6	799
AnnaBridge	146:22da6e220af6	800	/*
AnnaBridge	146:22da6e220af6	801	* @brief C custom defined SHASX for M3 and M0 processors
AnnaBridge	146:22da6e220af6	802	*/
AnnaBridge	146:22da6e220af6	803	CMSIS_INLINE __STATIC_INLINE uint32_t __SHASX(
AnnaBridge	146:22da6e220af6	804	uint32_t x,
AnnaBridge	146:22da6e220af6	805	uint32_t y)
AnnaBridge	146:22da6e220af6	806	{
AnnaBridge	146:22da6e220af6	807	q31_t r, s;
AnnaBridge	146:22da6e220af6	808
AnnaBridge	146:22da6e220af6	809	r = (((((q31_t)x << 16) >> 16) - (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	810	s = (((((q31_t)x ) >> 16) + (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	811
AnnaBridge	146:22da6e220af6	812	return ((uint32_t)((s << 16) \| (r )));
AnnaBridge	146:22da6e220af6	813	}
AnnaBridge	146:22da6e220af6	814
AnnaBridge	146:22da6e220af6	815
AnnaBridge	146:22da6e220af6	816	/*
AnnaBridge	146:22da6e220af6	817	* @brief C custom defined QSAX for M3 and M0 processors
AnnaBridge	146:22da6e220af6	818	*/
AnnaBridge	146:22da6e220af6	819	CMSIS_INLINE __STATIC_INLINE uint32_t __QSAX(
AnnaBridge	146:22da6e220af6	820	uint32_t x,
AnnaBridge	146:22da6e220af6	821	uint32_t y)
AnnaBridge	146:22da6e220af6	822	{
AnnaBridge	146:22da6e220af6	823	q31_t r, s;
AnnaBridge	146:22da6e220af6	824
AnnaBridge	146:22da6e220af6	825	r = __SSAT(((((q31_t)x << 16) >> 16) + (((q31_t)y ) >> 16)), 16) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	826	s = __SSAT(((((q31_t)x ) >> 16) - (((q31_t)y << 16) >> 16)), 16) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	827
AnnaBridge	146:22da6e220af6	828	return ((uint32_t)((s << 16) \| (r )));
AnnaBridge	146:22da6e220af6	829	}
AnnaBridge	146:22da6e220af6	830
AnnaBridge	146:22da6e220af6	831
AnnaBridge	146:22da6e220af6	832	/*
AnnaBridge	146:22da6e220af6	833	* @brief C custom defined SHSAX for M3 and M0 processors
AnnaBridge	146:22da6e220af6	834	*/
AnnaBridge	146:22da6e220af6	835	CMSIS_INLINE __STATIC_INLINE uint32_t __SHSAX(
AnnaBridge	146:22da6e220af6	836	uint32_t x,
AnnaBridge	146:22da6e220af6	837	uint32_t y)
AnnaBridge	146:22da6e220af6	838	{
AnnaBridge	146:22da6e220af6	839	q31_t r, s;
AnnaBridge	146:22da6e220af6	840
AnnaBridge	146:22da6e220af6	841	r = (((((q31_t)x << 16) >> 16) + (((q31_t)y ) >> 16)) >> 1) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	842	s = (((((q31_t)x ) >> 16) - (((q31_t)y << 16) >> 16)) >> 1) & (int32_t)0x0000FFFF;
AnnaBridge	146:22da6e220af6	843
AnnaBridge	146:22da6e220af6	844	return ((uint32_t)((s << 16) \| (r )));
AnnaBridge	146:22da6e220af6	845	}
AnnaBridge	146:22da6e220af6	846
AnnaBridge	146:22da6e220af6	847
AnnaBridge	146:22da6e220af6	848	/*
AnnaBridge	146:22da6e220af6	849	* @brief C custom defined SMUSDX for M3 and M0 processors
AnnaBridge	146:22da6e220af6	850	*/
AnnaBridge	146:22da6e220af6	851	CMSIS_INLINE __STATIC_INLINE uint32_t __SMUSDX(
AnnaBridge	146:22da6e220af6	852	uint32_t x,
AnnaBridge	146:22da6e220af6	853	uint32_t y)
AnnaBridge	146:22da6e220af6	854	{
AnnaBridge	146:22da6e220af6	855	return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) -
AnnaBridge	146:22da6e220af6	856	((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) ));
AnnaBridge	146:22da6e220af6	857	}
AnnaBridge	146:22da6e220af6	858
AnnaBridge	146:22da6e220af6	859	/*
AnnaBridge	146:22da6e220af6	860	* @brief C custom defined SMUADX for M3 and M0 processors
AnnaBridge	146:22da6e220af6	861	*/
AnnaBridge	146:22da6e220af6	862	CMSIS_INLINE __STATIC_INLINE uint32_t __SMUADX(
AnnaBridge	146:22da6e220af6	863	uint32_t x,
AnnaBridge	146:22da6e220af6	864	uint32_t y)
AnnaBridge	146:22da6e220af6	865	{
AnnaBridge	146:22da6e220af6	866	return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) +
AnnaBridge	146:22da6e220af6	867	((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) ));
AnnaBridge	146:22da6e220af6	868	}
AnnaBridge	146:22da6e220af6	869
AnnaBridge	146:22da6e220af6	870
AnnaBridge	146:22da6e220af6	871	/*
AnnaBridge	146:22da6e220af6	872	* @brief C custom defined QADD for M3 and M0 processors
AnnaBridge	146:22da6e220af6	873	*/
AnnaBridge	146:22da6e220af6	874	CMSIS_INLINE __STATIC_INLINE int32_t __QADD(
AnnaBridge	146:22da6e220af6	875	int32_t x,
AnnaBridge	146:22da6e220af6	876	int32_t y)
AnnaBridge	146:22da6e220af6	877	{
AnnaBridge	146:22da6e220af6	878	return ((int32_t)(clip_q63_to_q31((q63_t)x + (q31_t)y)));
AnnaBridge	146:22da6e220af6	879	}
AnnaBridge	146:22da6e220af6	880
AnnaBridge	146:22da6e220af6	881
AnnaBridge	146:22da6e220af6	882	/*
AnnaBridge	146:22da6e220af6	883	* @brief C custom defined QSUB for M3 and M0 processors
AnnaBridge	146:22da6e220af6	884	*/
AnnaBridge	146:22da6e220af6	885	CMSIS_INLINE __STATIC_INLINE int32_t __QSUB(
AnnaBridge	146:22da6e220af6	886	int32_t x,
AnnaBridge	146:22da6e220af6	887	int32_t y)
AnnaBridge	146:22da6e220af6	888	{
AnnaBridge	146:22da6e220af6	889	return ((int32_t)(clip_q63_to_q31((q63_t)x - (q31_t)y)));
AnnaBridge	146:22da6e220af6	890	}
AnnaBridge	146:22da6e220af6	891
AnnaBridge	146:22da6e220af6	892
AnnaBridge	146:22da6e220af6	893	/*
AnnaBridge	146:22da6e220af6	894	* @brief C custom defined SMLAD for M3 and M0 processors
AnnaBridge	146:22da6e220af6	895	*/
AnnaBridge	146:22da6e220af6	896	CMSIS_INLINE __STATIC_INLINE uint32_t __SMLAD(
AnnaBridge	146:22da6e220af6	897	uint32_t x,
AnnaBridge	146:22da6e220af6	898	uint32_t y,
AnnaBridge	146:22da6e220af6	899	uint32_t sum)
AnnaBridge	146:22da6e220af6	900	{
AnnaBridge	146:22da6e220af6	901	return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) +
AnnaBridge	146:22da6e220af6	902	((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) +
AnnaBridge	146:22da6e220af6	903	( ((q31_t)sum ) ) ));
AnnaBridge	146:22da6e220af6	904	}
AnnaBridge	146:22da6e220af6	905
AnnaBridge	146:22da6e220af6	906
AnnaBridge	146:22da6e220af6	907	/*
AnnaBridge	146:22da6e220af6	908	* @brief C custom defined SMLADX for M3 and M0 processors
AnnaBridge	146:22da6e220af6	909	*/
AnnaBridge	146:22da6e220af6	910	CMSIS_INLINE __STATIC_INLINE uint32_t __SMLADX(
AnnaBridge	146:22da6e220af6	911	uint32_t x,
AnnaBridge	146:22da6e220af6	912	uint32_t y,
AnnaBridge	146:22da6e220af6	913	uint32_t sum)
AnnaBridge	146:22da6e220af6	914	{
AnnaBridge	146:22da6e220af6	915	return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) +
AnnaBridge	146:22da6e220af6	916	((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) +
AnnaBridge	146:22da6e220af6	917	( ((q31_t)sum ) ) ));
AnnaBridge	146:22da6e220af6	918	}
AnnaBridge	146:22da6e220af6	919
AnnaBridge	146:22da6e220af6	920
AnnaBridge	146:22da6e220af6	921	/*
AnnaBridge	146:22da6e220af6	922	* @brief C custom defined SMLSDX for M3 and M0 processors
AnnaBridge	146:22da6e220af6	923	*/
AnnaBridge	146:22da6e220af6	924	CMSIS_INLINE __STATIC_INLINE uint32_t __SMLSDX(
AnnaBridge	146:22da6e220af6	925	uint32_t x,
AnnaBridge	146:22da6e220af6	926	uint32_t y,
AnnaBridge	146:22da6e220af6	927	uint32_t sum)
AnnaBridge	146:22da6e220af6	928	{
AnnaBridge	146:22da6e220af6	929	return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) -
AnnaBridge	146:22da6e220af6	930	((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) +
AnnaBridge	146:22da6e220af6	931	( ((q31_t)sum ) ) ));
AnnaBridge	146:22da6e220af6	932	}
AnnaBridge	146:22da6e220af6	933
AnnaBridge	146:22da6e220af6	934
AnnaBridge	146:22da6e220af6	935	/*
AnnaBridge	146:22da6e220af6	936	* @brief C custom defined SMLALD for M3 and M0 processors
AnnaBridge	146:22da6e220af6	937	*/
AnnaBridge	146:22da6e220af6	938	CMSIS_INLINE __STATIC_INLINE uint64_t __SMLALD(
AnnaBridge	146:22da6e220af6	939	uint32_t x,
AnnaBridge	146:22da6e220af6	940	uint32_t y,
AnnaBridge	146:22da6e220af6	941	uint64_t sum)
AnnaBridge	146:22da6e220af6	942	{
AnnaBridge	146:22da6e220af6	943	/* return (sum + ((q15_t) (x >> 16) * (q15_t) (y >> 16)) + ((q15_t) x * (q15_t) y)); */
AnnaBridge	146:22da6e220af6	944	return ((uint64_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) +
AnnaBridge	146:22da6e220af6	945	((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) +
AnnaBridge	146:22da6e220af6	946	( ((q63_t)sum ) ) ));
AnnaBridge	146:22da6e220af6	947	}
AnnaBridge	146:22da6e220af6	948
AnnaBridge	146:22da6e220af6	949
AnnaBridge	146:22da6e220af6	950	/*
AnnaBridge	146:22da6e220af6	951	* @brief C custom defined SMLALDX for M3 and M0 processors
AnnaBridge	146:22da6e220af6	952	*/
AnnaBridge	146:22da6e220af6	953	CMSIS_INLINE __STATIC_INLINE uint64_t __SMLALDX(
AnnaBridge	146:22da6e220af6	954	uint32_t x,
AnnaBridge	146:22da6e220af6	955	uint32_t y,
AnnaBridge	146:22da6e220af6	956	uint64_t sum)
AnnaBridge	146:22da6e220af6	957	{
AnnaBridge	146:22da6e220af6	958	/* return (sum + ((q15_t) (x >> 16) * (q15_t) y)) + ((q15_t) x * (q15_t) (y >> 16)); */
AnnaBridge	146:22da6e220af6	959	return ((uint64_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y ) >> 16)) +
AnnaBridge	146:22da6e220af6	960	((((q31_t)x ) >> 16) * (((q31_t)y << 16) >> 16)) +
AnnaBridge	146:22da6e220af6	961	( ((q63_t)sum ) ) ));
AnnaBridge	146:22da6e220af6	962	}
AnnaBridge	146:22da6e220af6	963
AnnaBridge	146:22da6e220af6	964
AnnaBridge	146:22da6e220af6	965	/*
AnnaBridge	146:22da6e220af6	966	* @brief C custom defined SMUAD for M3 and M0 processors
AnnaBridge	146:22da6e220af6	967	*/
AnnaBridge	146:22da6e220af6	968	CMSIS_INLINE __STATIC_INLINE uint32_t __SMUAD(
AnnaBridge	146:22da6e220af6	969	uint32_t x,
AnnaBridge	146:22da6e220af6	970	uint32_t y)
AnnaBridge	146:22da6e220af6	971	{
AnnaBridge	146:22da6e220af6	972	return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) +
AnnaBridge	146:22da6e220af6	973	((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) ));
AnnaBridge	146:22da6e220af6	974	}
AnnaBridge	146:22da6e220af6	975
AnnaBridge	146:22da6e220af6	976
AnnaBridge	146:22da6e220af6	977	/*
AnnaBridge	146:22da6e220af6	978	* @brief C custom defined SMUSD for M3 and M0 processors
AnnaBridge	146:22da6e220af6	979	*/
AnnaBridge	146:22da6e220af6	980	CMSIS_INLINE __STATIC_INLINE uint32_t __SMUSD(
AnnaBridge	146:22da6e220af6	981	uint32_t x,
AnnaBridge	146:22da6e220af6	982	uint32_t y)
AnnaBridge	146:22da6e220af6	983	{
AnnaBridge	146:22da6e220af6	984	return ((uint32_t)(((((q31_t)x << 16) >> 16) * (((q31_t)y << 16) >> 16)) -
AnnaBridge	146:22da6e220af6	985	((((q31_t)x ) >> 16) * (((q31_t)y ) >> 16)) ));
AnnaBridge	146:22da6e220af6	986	}
AnnaBridge	146:22da6e220af6	987
AnnaBridge	146:22da6e220af6	988
AnnaBridge	146:22da6e220af6	989	/*
AnnaBridge	146:22da6e220af6	990	* @brief C custom defined SXTB16 for M3 and M0 processors
AnnaBridge	146:22da6e220af6	991	*/
AnnaBridge	146:22da6e220af6	992	CMSIS_INLINE __STATIC_INLINE uint32_t __SXTB16(
AnnaBridge	146:22da6e220af6	993	uint32_t x)
AnnaBridge	146:22da6e220af6	994	{
AnnaBridge	146:22da6e220af6	995	return ((uint32_t)(((((q31_t)x << 24) >> 24) & (q31_t)0x0000FFFF) \|
AnnaBridge	146:22da6e220af6	996	((((q31_t)x << 8) >> 8) & (q31_t)0xFFFF0000) ));
AnnaBridge	146:22da6e220af6	997	}
AnnaBridge	146:22da6e220af6	998
AnnaBridge	146:22da6e220af6	999	/*
AnnaBridge	146:22da6e220af6	1000	* @brief C custom defined SMMLA for M3 and M0 processors
AnnaBridge	146:22da6e220af6	1001	*/
AnnaBridge	146:22da6e220af6	1002	CMSIS_INLINE __STATIC_INLINE int32_t __SMMLA(
AnnaBridge	146:22da6e220af6	1003	int32_t x,
AnnaBridge	146:22da6e220af6	1004	int32_t y,
AnnaBridge	146:22da6e220af6	1005	int32_t sum)
AnnaBridge	146:22da6e220af6	1006	{
AnnaBridge	146:22da6e220af6	1007	return (sum + (int32_t) (((int64_t) x * y) >> 32));
AnnaBridge	146:22da6e220af6	1008	}
AnnaBridge	146:22da6e220af6	1009
AnnaBridge	146:22da6e220af6	1010	#if 0
AnnaBridge	146:22da6e220af6	1011	/*
AnnaBridge	146:22da6e220af6	1012	* @brief C custom defined PKHBT for unavailable DSP extension
AnnaBridge	146:22da6e220af6	1013	*/
AnnaBridge	146:22da6e220af6	1014	CMSIS_INLINE __STATIC_INLINE uint32_t __PKHBT(
AnnaBridge	146:22da6e220af6	1015	uint32_t x,
AnnaBridge	146:22da6e220af6	1016	uint32_t y,
AnnaBridge	146:22da6e220af6	1017	uint32_t leftshift)
AnnaBridge	146:22da6e220af6	1018	{
AnnaBridge	146:22da6e220af6	1019	return ( ((x ) & 0x0000FFFFUL) \|
AnnaBridge	146:22da6e220af6	1020	((y << leftshift) & 0xFFFF0000UL) );
AnnaBridge	146:22da6e220af6	1021	}
AnnaBridge	146:22da6e220af6	1022
AnnaBridge	146:22da6e220af6	1023	/*
AnnaBridge	146:22da6e220af6	1024	* @brief C custom defined PKHTB for unavailable DSP extension
AnnaBridge	146:22da6e220af6	1025	*/
AnnaBridge	146:22da6e220af6	1026	CMSIS_INLINE __STATIC_INLINE uint32_t __PKHTB(
AnnaBridge	146:22da6e220af6	1027	uint32_t x,
AnnaBridge	146:22da6e220af6	1028	uint32_t y,
AnnaBridge	146:22da6e220af6	1029	uint32_t rightshift)
AnnaBridge	146:22da6e220af6	1030	{
AnnaBridge	146:22da6e220af6	1031	return ( ((x ) & 0xFFFF0000UL) \|
AnnaBridge	146:22da6e220af6	1032	((y >> rightshift) & 0x0000FFFFUL) );
AnnaBridge	146:22da6e220af6	1033	}
AnnaBridge	146:22da6e220af6	1034	#endif
AnnaBridge	146:22da6e220af6	1035
AnnaBridge	146:22da6e220af6	1036	/* #endif // defined (ARM_MATH_CM3) \|\| defined (ARM_MATH_CM0_FAMILY) */
AnnaBridge	146:22da6e220af6	1037	#endif /* !defined (ARM_MATH_DSP) */
AnnaBridge	146:22da6e220af6	1038
AnnaBridge	146:22da6e220af6	1039
AnnaBridge	146:22da6e220af6	1040	/**
AnnaBridge	146:22da6e220af6	1041	* @brief Instance structure for the Q7 FIR filter.
AnnaBridge	146:22da6e220af6	1042	*/
AnnaBridge	146:22da6e220af6	1043	typedef struct
AnnaBridge	146:22da6e220af6	1044	{
AnnaBridge	146:22da6e220af6	1045	uint16_t numTaps; /*< number of filter coefficients in the filter. /
AnnaBridge	146:22da6e220af6	1046	q7_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	1047	q7_t pCoeffs; /< points to the coefficient array. The array is of length numTaps./
AnnaBridge	146:22da6e220af6	1048	} arm_fir_instance_q7;
AnnaBridge	146:22da6e220af6	1049
AnnaBridge	146:22da6e220af6	1050	/**
AnnaBridge	146:22da6e220af6	1051	* @brief Instance structure for the Q15 FIR filter.
AnnaBridge	146:22da6e220af6	1052	*/
AnnaBridge	146:22da6e220af6	1053	typedef struct
AnnaBridge	146:22da6e220af6	1054	{
AnnaBridge	146:22da6e220af6	1055	uint16_t numTaps; /*< number of filter coefficients in the filter. /
AnnaBridge	146:22da6e220af6	1056	q15_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	1057	q15_t pCoeffs; /< points to the coefficient array. The array is of length numTaps./
AnnaBridge	146:22da6e220af6	1058	} arm_fir_instance_q15;
AnnaBridge	146:22da6e220af6	1059
AnnaBridge	146:22da6e220af6	1060	/**
AnnaBridge	146:22da6e220af6	1061	* @brief Instance structure for the Q31 FIR filter.
AnnaBridge	146:22da6e220af6	1062	*/
AnnaBridge	146:22da6e220af6	1063	typedef struct
AnnaBridge	146:22da6e220af6	1064	{
AnnaBridge	146:22da6e220af6	1065	uint16_t numTaps; /*< number of filter coefficients in the filter. /
AnnaBridge	146:22da6e220af6	1066	q31_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	1067	q31_t pCoeffs; /< points to the coefficient array. The array is of length numTaps. /
AnnaBridge	146:22da6e220af6	1068	} arm_fir_instance_q31;
AnnaBridge	146:22da6e220af6	1069
AnnaBridge	146:22da6e220af6	1070	/**
AnnaBridge	146:22da6e220af6	1071	* @brief Instance structure for the floating-point FIR filter.
AnnaBridge	146:22da6e220af6	1072	*/
AnnaBridge	146:22da6e220af6	1073	typedef struct
AnnaBridge	146:22da6e220af6	1074	{
AnnaBridge	146:22da6e220af6	1075	uint16_t numTaps; /*< number of filter coefficients in the filter. /
AnnaBridge	146:22da6e220af6	1076	float32_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	1077	float32_t pCoeffs; /< points to the coefficient array. The array is of length numTaps. /
AnnaBridge	146:22da6e220af6	1078	} arm_fir_instance_f32;
AnnaBridge	146:22da6e220af6	1079
AnnaBridge	146:22da6e220af6	1080
AnnaBridge	146:22da6e220af6	1081	/**
AnnaBridge	146:22da6e220af6	1082	* @brief Processing function for the Q7 FIR filter.
AnnaBridge	146:22da6e220af6	1083	* @param[in] S points to an instance of the Q7 FIR filter structure.
AnnaBridge	146:22da6e220af6	1084	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	1085	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	1086	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	1087	*/
AnnaBridge	146:22da6e220af6	1088	void arm_fir_q7(
AnnaBridge	146:22da6e220af6	1089	const arm_fir_instance_q7 * S,
AnnaBridge	146:22da6e220af6	1090	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	1091	q7_t * pDst,
AnnaBridge	146:22da6e220af6	1092	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1093
AnnaBridge	146:22da6e220af6	1094
AnnaBridge	146:22da6e220af6	1095	/**
AnnaBridge	146:22da6e220af6	1096	* @brief Initialization function for the Q7 FIR filter.
AnnaBridge	146:22da6e220af6	1097	* @param[in,out] S points to an instance of the Q7 FIR structure.
AnnaBridge	146:22da6e220af6	1098	* @param[in] numTaps Number of filter coefficients in the filter.
AnnaBridge	146:22da6e220af6	1099	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	1100	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	1101	* @param[in] blockSize number of samples that are processed.
AnnaBridge	146:22da6e220af6	1102	*/
AnnaBridge	146:22da6e220af6	1103	void arm_fir_init_q7(
AnnaBridge	146:22da6e220af6	1104	arm_fir_instance_q7 * S,
AnnaBridge	146:22da6e220af6	1105	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	1106	q7_t * pCoeffs,
AnnaBridge	146:22da6e220af6	1107	q7_t * pState,
AnnaBridge	146:22da6e220af6	1108	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1109
AnnaBridge	146:22da6e220af6	1110
AnnaBridge	146:22da6e220af6	1111	/**
AnnaBridge	146:22da6e220af6	1112	* @brief Processing function for the Q15 FIR filter.
AnnaBridge	146:22da6e220af6	1113	* @param[in] S points to an instance of the Q15 FIR structure.
AnnaBridge	146:22da6e220af6	1114	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	1115	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	1116	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	1117	*/
AnnaBridge	146:22da6e220af6	1118	void arm_fir_q15(
AnnaBridge	146:22da6e220af6	1119	const arm_fir_instance_q15 * S,
AnnaBridge	146:22da6e220af6	1120	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	1121	q15_t * pDst,
AnnaBridge	146:22da6e220af6	1122	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1123
AnnaBridge	146:22da6e220af6	1124
AnnaBridge	146:22da6e220af6	1125	/**
AnnaBridge	146:22da6e220af6	1126	* @brief Processing function for the fast Q15 FIR filter for Cortex-M3 and Cortex-M4.
AnnaBridge	146:22da6e220af6	1127	* @param[in] S points to an instance of the Q15 FIR filter structure.
AnnaBridge	146:22da6e220af6	1128	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	1129	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	1130	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	1131	*/
AnnaBridge	146:22da6e220af6	1132	void arm_fir_fast_q15(
AnnaBridge	146:22da6e220af6	1133	const arm_fir_instance_q15 * S,
AnnaBridge	146:22da6e220af6	1134	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	1135	q15_t * pDst,
AnnaBridge	146:22da6e220af6	1136	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1137
AnnaBridge	146:22da6e220af6	1138
AnnaBridge	146:22da6e220af6	1139	/**
AnnaBridge	146:22da6e220af6	1140	* @brief Initialization function for the Q15 FIR filter.
AnnaBridge	146:22da6e220af6	1141	* @param[in,out] S points to an instance of the Q15 FIR filter structure.
AnnaBridge	146:22da6e220af6	1142	* @param[in] numTaps Number of filter coefficients in the filter. Must be even and greater than or equal to 4.
AnnaBridge	146:22da6e220af6	1143	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	1144	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	1145	* @param[in] blockSize number of samples that are processed at a time.
AnnaBridge	146:22da6e220af6	1146	* @return The function returns ARM_MATH_SUCCESS if initialization was successful or ARM_MATH_ARGUMENT_ERROR if
AnnaBridge	146:22da6e220af6	1147	* <code>numTaps</code> is not a supported value.
AnnaBridge	146:22da6e220af6	1148	*/
AnnaBridge	146:22da6e220af6	1149	arm_status arm_fir_init_q15(
AnnaBridge	146:22da6e220af6	1150	arm_fir_instance_q15 * S,
AnnaBridge	146:22da6e220af6	1151	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	1152	q15_t * pCoeffs,
AnnaBridge	146:22da6e220af6	1153	q15_t * pState,
AnnaBridge	146:22da6e220af6	1154	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1155
AnnaBridge	146:22da6e220af6	1156
AnnaBridge	146:22da6e220af6	1157	/**
AnnaBridge	146:22da6e220af6	1158	* @brief Processing function for the Q31 FIR filter.
AnnaBridge	146:22da6e220af6	1159	* @param[in] S points to an instance of the Q31 FIR filter structure.
AnnaBridge	146:22da6e220af6	1160	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	1161	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	1162	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	1163	*/
AnnaBridge	146:22da6e220af6	1164	void arm_fir_q31(
AnnaBridge	146:22da6e220af6	1165	const arm_fir_instance_q31 * S,
AnnaBridge	146:22da6e220af6	1166	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	1167	q31_t * pDst,
AnnaBridge	146:22da6e220af6	1168	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1169
AnnaBridge	146:22da6e220af6	1170
AnnaBridge	146:22da6e220af6	1171	/**
AnnaBridge	146:22da6e220af6	1172	* @brief Processing function for the fast Q31 FIR filter for Cortex-M3 and Cortex-M4.
AnnaBridge	146:22da6e220af6	1173	* @param[in] S points to an instance of the Q31 FIR structure.
AnnaBridge	146:22da6e220af6	1174	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	1175	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	1176	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	1177	*/
AnnaBridge	146:22da6e220af6	1178	void arm_fir_fast_q31(
AnnaBridge	146:22da6e220af6	1179	const arm_fir_instance_q31 * S,
AnnaBridge	146:22da6e220af6	1180	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	1181	q31_t * pDst,
AnnaBridge	146:22da6e220af6	1182	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1183
AnnaBridge	146:22da6e220af6	1184
AnnaBridge	146:22da6e220af6	1185	/**
AnnaBridge	146:22da6e220af6	1186	* @brief Initialization function for the Q31 FIR filter.
AnnaBridge	146:22da6e220af6	1187	* @param[in,out] S points to an instance of the Q31 FIR structure.
AnnaBridge	146:22da6e220af6	1188	* @param[in] numTaps Number of filter coefficients in the filter.
AnnaBridge	146:22da6e220af6	1189	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	1190	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	1191	* @param[in] blockSize number of samples that are processed at a time.
AnnaBridge	146:22da6e220af6	1192	*/
AnnaBridge	146:22da6e220af6	1193	void arm_fir_init_q31(
AnnaBridge	146:22da6e220af6	1194	arm_fir_instance_q31 * S,
AnnaBridge	146:22da6e220af6	1195	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	1196	q31_t * pCoeffs,
AnnaBridge	146:22da6e220af6	1197	q31_t * pState,
AnnaBridge	146:22da6e220af6	1198	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1199
AnnaBridge	146:22da6e220af6	1200
AnnaBridge	146:22da6e220af6	1201	/**
AnnaBridge	146:22da6e220af6	1202	* @brief Processing function for the floating-point FIR filter.
AnnaBridge	146:22da6e220af6	1203	* @param[in] S points to an instance of the floating-point FIR structure.
AnnaBridge	146:22da6e220af6	1204	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	1205	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	1206	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	1207	*/
AnnaBridge	146:22da6e220af6	1208	void arm_fir_f32(
AnnaBridge	146:22da6e220af6	1209	const arm_fir_instance_f32 * S,
AnnaBridge	146:22da6e220af6	1210	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	1211	float32_t * pDst,
AnnaBridge	146:22da6e220af6	1212	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1213
AnnaBridge	146:22da6e220af6	1214
AnnaBridge	146:22da6e220af6	1215	/**
AnnaBridge	146:22da6e220af6	1216	* @brief Initialization function for the floating-point FIR filter.
AnnaBridge	146:22da6e220af6	1217	* @param[in,out] S points to an instance of the floating-point FIR filter structure.
AnnaBridge	146:22da6e220af6	1218	* @param[in] numTaps Number of filter coefficients in the filter.
AnnaBridge	146:22da6e220af6	1219	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	1220	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	1221	* @param[in] blockSize number of samples that are processed at a time.
AnnaBridge	146:22da6e220af6	1222	*/
AnnaBridge	146:22da6e220af6	1223	void arm_fir_init_f32(
AnnaBridge	146:22da6e220af6	1224	arm_fir_instance_f32 * S,
AnnaBridge	146:22da6e220af6	1225	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	1226	float32_t * pCoeffs,
AnnaBridge	146:22da6e220af6	1227	float32_t * pState,
AnnaBridge	146:22da6e220af6	1228	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1229
AnnaBridge	146:22da6e220af6	1230
AnnaBridge	146:22da6e220af6	1231	/**
AnnaBridge	146:22da6e220af6	1232	* @brief Instance structure for the Q15 Biquad cascade filter.
AnnaBridge	146:22da6e220af6	1233	*/
AnnaBridge	146:22da6e220af6	1234	typedef struct
AnnaBridge	146:22da6e220af6	1235	{
AnnaBridge	146:22da6e220af6	1236	int8_t numStages; /*< number of 2nd order stages in the filter. Overall order is 2numStages. */
AnnaBridge	146:22da6e220af6	1237	q15_t pState; /< Points to the array of state coefficients. The array is of length 4numStages. */
AnnaBridge	146:22da6e220af6	1238	q15_t pCoeffs; /< Points to the array of coefficients. The array is of length 5numStages. */
AnnaBridge	146:22da6e220af6	1239	int8_t postShift; /*< Additional shift, in bits, applied to each output sample. /
AnnaBridge	146:22da6e220af6	1240	} arm_biquad_casd_df1_inst_q15;
AnnaBridge	146:22da6e220af6	1241
AnnaBridge	146:22da6e220af6	1242	/**
AnnaBridge	146:22da6e220af6	1243	* @brief Instance structure for the Q31 Biquad cascade filter.
AnnaBridge	146:22da6e220af6	1244	*/
AnnaBridge	146:22da6e220af6	1245	typedef struct
AnnaBridge	146:22da6e220af6	1246	{
AnnaBridge	146:22da6e220af6	1247	uint32_t numStages; /*< number of 2nd order stages in the filter. Overall order is 2numStages. */
AnnaBridge	146:22da6e220af6	1248	q31_t pState; /< Points to the array of state coefficients. The array is of length 4numStages. */
AnnaBridge	146:22da6e220af6	1249	q31_t pCoeffs; /< Points to the array of coefficients. The array is of length 5numStages. */
AnnaBridge	146:22da6e220af6	1250	uint8_t postShift; /*< Additional shift, in bits, applied to each output sample. /
AnnaBridge	146:22da6e220af6	1251	} arm_biquad_casd_df1_inst_q31;
AnnaBridge	146:22da6e220af6	1252
AnnaBridge	146:22da6e220af6	1253	/**
AnnaBridge	146:22da6e220af6	1254	* @brief Instance structure for the floating-point Biquad cascade filter.
AnnaBridge	146:22da6e220af6	1255	*/
AnnaBridge	146:22da6e220af6	1256	typedef struct
AnnaBridge	146:22da6e220af6	1257	{
AnnaBridge	146:22da6e220af6	1258	uint32_t numStages; /*< number of 2nd order stages in the filter. Overall order is 2numStages. */
AnnaBridge	146:22da6e220af6	1259	float32_t pState; /< Points to the array of state coefficients. The array is of length 4numStages. */
AnnaBridge	146:22da6e220af6	1260	float32_t pCoeffs; /< Points to the array of coefficients. The array is of length 5numStages. */
AnnaBridge	146:22da6e220af6	1261	} arm_biquad_casd_df1_inst_f32;
AnnaBridge	146:22da6e220af6	1262
AnnaBridge	146:22da6e220af6	1263
AnnaBridge	146:22da6e220af6	1264	/**
AnnaBridge	146:22da6e220af6	1265	* @brief Processing function for the Q15 Biquad cascade filter.
AnnaBridge	146:22da6e220af6	1266	* @param[in] S points to an instance of the Q15 Biquad cascade structure.
AnnaBridge	146:22da6e220af6	1267	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	1268	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	1269	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	1270	*/
AnnaBridge	146:22da6e220af6	1271	void arm_biquad_cascade_df1_q15(
AnnaBridge	146:22da6e220af6	1272	const arm_biquad_casd_df1_inst_q15 * S,
AnnaBridge	146:22da6e220af6	1273	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	1274	q15_t * pDst,
AnnaBridge	146:22da6e220af6	1275	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1276
AnnaBridge	146:22da6e220af6	1277
AnnaBridge	146:22da6e220af6	1278	/**
AnnaBridge	146:22da6e220af6	1279	* @brief Initialization function for the Q15 Biquad cascade filter.
AnnaBridge	146:22da6e220af6	1280	* @param[in,out] S points to an instance of the Q15 Biquad cascade structure.
AnnaBridge	146:22da6e220af6	1281	* @param[in] numStages number of 2nd order stages in the filter.
AnnaBridge	146:22da6e220af6	1282	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	1283	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	1284	* @param[in] postShift Shift to be applied to the output. Varies according to the coefficients format
AnnaBridge	146:22da6e220af6	1285	*/
AnnaBridge	146:22da6e220af6	1286	void arm_biquad_cascade_df1_init_q15(
AnnaBridge	146:22da6e220af6	1287	arm_biquad_casd_df1_inst_q15 * S,
AnnaBridge	146:22da6e220af6	1288	uint8_t numStages,
AnnaBridge	146:22da6e220af6	1289	q15_t * pCoeffs,
AnnaBridge	146:22da6e220af6	1290	q15_t * pState,
AnnaBridge	146:22da6e220af6	1291	int8_t postShift);
AnnaBridge	146:22da6e220af6	1292
AnnaBridge	146:22da6e220af6	1293
AnnaBridge	146:22da6e220af6	1294	/**
AnnaBridge	146:22da6e220af6	1295	* @brief Fast but less precise processing function for the Q15 Biquad cascade filter for Cortex-M3 and Cortex-M4.
AnnaBridge	146:22da6e220af6	1296	* @param[in] S points to an instance of the Q15 Biquad cascade structure.
AnnaBridge	146:22da6e220af6	1297	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	1298	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	1299	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	1300	*/
AnnaBridge	146:22da6e220af6	1301	void arm_biquad_cascade_df1_fast_q15(
AnnaBridge	146:22da6e220af6	1302	const arm_biquad_casd_df1_inst_q15 * S,
AnnaBridge	146:22da6e220af6	1303	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	1304	q15_t * pDst,
AnnaBridge	146:22da6e220af6	1305	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1306
AnnaBridge	146:22da6e220af6	1307
AnnaBridge	146:22da6e220af6	1308	/**
AnnaBridge	146:22da6e220af6	1309	* @brief Processing function for the Q31 Biquad cascade filter
AnnaBridge	146:22da6e220af6	1310	* @param[in] S points to an instance of the Q31 Biquad cascade structure.
AnnaBridge	146:22da6e220af6	1311	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	1312	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	1313	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	1314	*/
AnnaBridge	146:22da6e220af6	1315	void arm_biquad_cascade_df1_q31(
AnnaBridge	146:22da6e220af6	1316	const arm_biquad_casd_df1_inst_q31 * S,
AnnaBridge	146:22da6e220af6	1317	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	1318	q31_t * pDst,
AnnaBridge	146:22da6e220af6	1319	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1320
AnnaBridge	146:22da6e220af6	1321
AnnaBridge	146:22da6e220af6	1322	/**
AnnaBridge	146:22da6e220af6	1323	* @brief Fast but less precise processing function for the Q31 Biquad cascade filter for Cortex-M3 and Cortex-M4.
AnnaBridge	146:22da6e220af6	1324	* @param[in] S points to an instance of the Q31 Biquad cascade structure.
AnnaBridge	146:22da6e220af6	1325	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	1326	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	1327	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	1328	*/
AnnaBridge	146:22da6e220af6	1329	void arm_biquad_cascade_df1_fast_q31(
AnnaBridge	146:22da6e220af6	1330	const arm_biquad_casd_df1_inst_q31 * S,
AnnaBridge	146:22da6e220af6	1331	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	1332	q31_t * pDst,
AnnaBridge	146:22da6e220af6	1333	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1334
AnnaBridge	146:22da6e220af6	1335
AnnaBridge	146:22da6e220af6	1336	/**
AnnaBridge	146:22da6e220af6	1337	* @brief Initialization function for the Q31 Biquad cascade filter.
AnnaBridge	146:22da6e220af6	1338	* @param[in,out] S points to an instance of the Q31 Biquad cascade structure.
AnnaBridge	146:22da6e220af6	1339	* @param[in] numStages number of 2nd order stages in the filter.
AnnaBridge	146:22da6e220af6	1340	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	1341	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	1342	* @param[in] postShift Shift to be applied to the output. Varies according to the coefficients format
AnnaBridge	146:22da6e220af6	1343	*/
AnnaBridge	146:22da6e220af6	1344	void arm_biquad_cascade_df1_init_q31(
AnnaBridge	146:22da6e220af6	1345	arm_biquad_casd_df1_inst_q31 * S,
AnnaBridge	146:22da6e220af6	1346	uint8_t numStages,
AnnaBridge	146:22da6e220af6	1347	q31_t * pCoeffs,
AnnaBridge	146:22da6e220af6	1348	q31_t * pState,
AnnaBridge	146:22da6e220af6	1349	int8_t postShift);
AnnaBridge	146:22da6e220af6	1350
AnnaBridge	146:22da6e220af6	1351
AnnaBridge	146:22da6e220af6	1352	/**
AnnaBridge	146:22da6e220af6	1353	* @brief Processing function for the floating-point Biquad cascade filter.
AnnaBridge	146:22da6e220af6	1354	* @param[in] S points to an instance of the floating-point Biquad cascade structure.
AnnaBridge	146:22da6e220af6	1355	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	1356	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	1357	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	1358	*/
AnnaBridge	146:22da6e220af6	1359	void arm_biquad_cascade_df1_f32(
AnnaBridge	146:22da6e220af6	1360	const arm_biquad_casd_df1_inst_f32 * S,
AnnaBridge	146:22da6e220af6	1361	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	1362	float32_t * pDst,
AnnaBridge	146:22da6e220af6	1363	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1364
AnnaBridge	146:22da6e220af6	1365
AnnaBridge	146:22da6e220af6	1366	/**
AnnaBridge	146:22da6e220af6	1367	* @brief Initialization function for the floating-point Biquad cascade filter.
AnnaBridge	146:22da6e220af6	1368	* @param[in,out] S points to an instance of the floating-point Biquad cascade structure.
AnnaBridge	146:22da6e220af6	1369	* @param[in] numStages number of 2nd order stages in the filter.
AnnaBridge	146:22da6e220af6	1370	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	1371	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	1372	*/
AnnaBridge	146:22da6e220af6	1373	void arm_biquad_cascade_df1_init_f32(
AnnaBridge	146:22da6e220af6	1374	arm_biquad_casd_df1_inst_f32 * S,
AnnaBridge	146:22da6e220af6	1375	uint8_t numStages,
AnnaBridge	146:22da6e220af6	1376	float32_t * pCoeffs,
AnnaBridge	146:22da6e220af6	1377	float32_t * pState);
AnnaBridge	146:22da6e220af6	1378
AnnaBridge	146:22da6e220af6	1379
AnnaBridge	146:22da6e220af6	1380	/**
AnnaBridge	146:22da6e220af6	1381	* @brief Instance structure for the floating-point matrix structure.
AnnaBridge	146:22da6e220af6	1382	*/
AnnaBridge	146:22da6e220af6	1383	typedef struct
AnnaBridge	146:22da6e220af6	1384	{
AnnaBridge	146:22da6e220af6	1385	uint16_t numRows; /*< number of rows of the matrix. /
AnnaBridge	146:22da6e220af6	1386	uint16_t numCols; /*< number of columns of the matrix. /
AnnaBridge	146:22da6e220af6	1387	float32_t pData; /< points to the data of the matrix. /
AnnaBridge	146:22da6e220af6	1388	} arm_matrix_instance_f32;
AnnaBridge	146:22da6e220af6	1389
AnnaBridge	146:22da6e220af6	1390
AnnaBridge	146:22da6e220af6	1391	/**
AnnaBridge	146:22da6e220af6	1392	* @brief Instance structure for the floating-point matrix structure.
AnnaBridge	146:22da6e220af6	1393	*/
AnnaBridge	146:22da6e220af6	1394	typedef struct
AnnaBridge	146:22da6e220af6	1395	{
AnnaBridge	146:22da6e220af6	1396	uint16_t numRows; /*< number of rows of the matrix. /
AnnaBridge	146:22da6e220af6	1397	uint16_t numCols; /*< number of columns of the matrix. /
AnnaBridge	146:22da6e220af6	1398	float64_t pData; /< points to the data of the matrix. /
AnnaBridge	146:22da6e220af6	1399	} arm_matrix_instance_f64;
AnnaBridge	146:22da6e220af6	1400
AnnaBridge	146:22da6e220af6	1401	/**
AnnaBridge	146:22da6e220af6	1402	* @brief Instance structure for the Q15 matrix structure.
AnnaBridge	146:22da6e220af6	1403	*/
AnnaBridge	146:22da6e220af6	1404	typedef struct
AnnaBridge	146:22da6e220af6	1405	{
AnnaBridge	146:22da6e220af6	1406	uint16_t numRows; /*< number of rows of the matrix. /
AnnaBridge	146:22da6e220af6	1407	uint16_t numCols; /*< number of columns of the matrix. /
AnnaBridge	146:22da6e220af6	1408	q15_t pData; /< points to the data of the matrix. /
AnnaBridge	146:22da6e220af6	1409	} arm_matrix_instance_q15;
AnnaBridge	146:22da6e220af6	1410
AnnaBridge	146:22da6e220af6	1411	/**
AnnaBridge	146:22da6e220af6	1412	* @brief Instance structure for the Q31 matrix structure.
AnnaBridge	146:22da6e220af6	1413	*/
AnnaBridge	146:22da6e220af6	1414	typedef struct
AnnaBridge	146:22da6e220af6	1415	{
AnnaBridge	146:22da6e220af6	1416	uint16_t numRows; /*< number of rows of the matrix. /
AnnaBridge	146:22da6e220af6	1417	uint16_t numCols; /*< number of columns of the matrix. /
AnnaBridge	146:22da6e220af6	1418	q31_t pData; /< points to the data of the matrix. /
AnnaBridge	146:22da6e220af6	1419	} arm_matrix_instance_q31;
AnnaBridge	146:22da6e220af6	1420
AnnaBridge	146:22da6e220af6	1421
AnnaBridge	146:22da6e220af6	1422	/**
AnnaBridge	146:22da6e220af6	1423	* @brief Floating-point matrix addition.
AnnaBridge	146:22da6e220af6	1424	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1425	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1426	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1427	* @return The function returns either
AnnaBridge	146:22da6e220af6	1428	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1429	*/
AnnaBridge	146:22da6e220af6	1430	arm_status arm_mat_add_f32(
AnnaBridge	146:22da6e220af6	1431	const arm_matrix_instance_f32 * pSrcA,
AnnaBridge	146:22da6e220af6	1432	const arm_matrix_instance_f32 * pSrcB,
AnnaBridge	146:22da6e220af6	1433	arm_matrix_instance_f32 * pDst);
AnnaBridge	146:22da6e220af6	1434
AnnaBridge	146:22da6e220af6	1435
AnnaBridge	146:22da6e220af6	1436	/**
AnnaBridge	146:22da6e220af6	1437	* @brief Q15 matrix addition.
AnnaBridge	146:22da6e220af6	1438	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1439	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1440	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1441	* @return The function returns either
AnnaBridge	146:22da6e220af6	1442	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1443	*/
AnnaBridge	146:22da6e220af6	1444	arm_status arm_mat_add_q15(
AnnaBridge	146:22da6e220af6	1445	const arm_matrix_instance_q15 * pSrcA,
AnnaBridge	146:22da6e220af6	1446	const arm_matrix_instance_q15 * pSrcB,
AnnaBridge	146:22da6e220af6	1447	arm_matrix_instance_q15 * pDst);
AnnaBridge	146:22da6e220af6	1448
AnnaBridge	146:22da6e220af6	1449
AnnaBridge	146:22da6e220af6	1450	/**
AnnaBridge	146:22da6e220af6	1451	* @brief Q31 matrix addition.
AnnaBridge	146:22da6e220af6	1452	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1453	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1454	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1455	* @return The function returns either
AnnaBridge	146:22da6e220af6	1456	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1457	*/
AnnaBridge	146:22da6e220af6	1458	arm_status arm_mat_add_q31(
AnnaBridge	146:22da6e220af6	1459	const arm_matrix_instance_q31 * pSrcA,
AnnaBridge	146:22da6e220af6	1460	const arm_matrix_instance_q31 * pSrcB,
AnnaBridge	146:22da6e220af6	1461	arm_matrix_instance_q31 * pDst);
AnnaBridge	146:22da6e220af6	1462
AnnaBridge	146:22da6e220af6	1463
AnnaBridge	146:22da6e220af6	1464	/**
AnnaBridge	146:22da6e220af6	1465	* @brief Floating-point, complex, matrix multiplication.
AnnaBridge	146:22da6e220af6	1466	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1467	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1468	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1469	* @return The function returns either
AnnaBridge	146:22da6e220af6	1470	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1471	*/
AnnaBridge	146:22da6e220af6	1472	arm_status arm_mat_cmplx_mult_f32(
AnnaBridge	146:22da6e220af6	1473	const arm_matrix_instance_f32 * pSrcA,
AnnaBridge	146:22da6e220af6	1474	const arm_matrix_instance_f32 * pSrcB,
AnnaBridge	146:22da6e220af6	1475	arm_matrix_instance_f32 * pDst);
AnnaBridge	146:22da6e220af6	1476
AnnaBridge	146:22da6e220af6	1477
AnnaBridge	146:22da6e220af6	1478	/**
AnnaBridge	146:22da6e220af6	1479	* @brief Q15, complex, matrix multiplication.
AnnaBridge	146:22da6e220af6	1480	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1481	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1482	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1483	* @return The function returns either
AnnaBridge	146:22da6e220af6	1484	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1485	*/
AnnaBridge	146:22da6e220af6	1486	arm_status arm_mat_cmplx_mult_q15(
AnnaBridge	146:22da6e220af6	1487	const arm_matrix_instance_q15 * pSrcA,
AnnaBridge	146:22da6e220af6	1488	const arm_matrix_instance_q15 * pSrcB,
AnnaBridge	146:22da6e220af6	1489	arm_matrix_instance_q15 * pDst,
AnnaBridge	146:22da6e220af6	1490	q15_t * pScratch);
AnnaBridge	146:22da6e220af6	1491
AnnaBridge	146:22da6e220af6	1492
AnnaBridge	146:22da6e220af6	1493	/**
AnnaBridge	146:22da6e220af6	1494	* @brief Q31, complex, matrix multiplication.
AnnaBridge	146:22da6e220af6	1495	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1496	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1497	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1498	* @return The function returns either
AnnaBridge	146:22da6e220af6	1499	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1500	*/
AnnaBridge	146:22da6e220af6	1501	arm_status arm_mat_cmplx_mult_q31(
AnnaBridge	146:22da6e220af6	1502	const arm_matrix_instance_q31 * pSrcA,
AnnaBridge	146:22da6e220af6	1503	const arm_matrix_instance_q31 * pSrcB,
AnnaBridge	146:22da6e220af6	1504	arm_matrix_instance_q31 * pDst);
AnnaBridge	146:22da6e220af6	1505
AnnaBridge	146:22da6e220af6	1506
AnnaBridge	146:22da6e220af6	1507	/**
AnnaBridge	146:22da6e220af6	1508	* @brief Floating-point matrix transpose.
AnnaBridge	146:22da6e220af6	1509	* @param[in] pSrc points to the input matrix
AnnaBridge	146:22da6e220af6	1510	* @param[out] pDst points to the output matrix
AnnaBridge	146:22da6e220af6	1511	* @return The function returns either <code>ARM_MATH_SIZE_MISMATCH</code>
AnnaBridge	146:22da6e220af6	1512	* or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1513	*/
AnnaBridge	146:22da6e220af6	1514	arm_status arm_mat_trans_f32(
AnnaBridge	146:22da6e220af6	1515	const arm_matrix_instance_f32 * pSrc,
AnnaBridge	146:22da6e220af6	1516	arm_matrix_instance_f32 * pDst);
AnnaBridge	146:22da6e220af6	1517
AnnaBridge	146:22da6e220af6	1518
AnnaBridge	146:22da6e220af6	1519	/**
AnnaBridge	146:22da6e220af6	1520	* @brief Q15 matrix transpose.
AnnaBridge	146:22da6e220af6	1521	* @param[in] pSrc points to the input matrix
AnnaBridge	146:22da6e220af6	1522	* @param[out] pDst points to the output matrix
AnnaBridge	146:22da6e220af6	1523	* @return The function returns either <code>ARM_MATH_SIZE_MISMATCH</code>
AnnaBridge	146:22da6e220af6	1524	* or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1525	*/
AnnaBridge	146:22da6e220af6	1526	arm_status arm_mat_trans_q15(
AnnaBridge	146:22da6e220af6	1527	const arm_matrix_instance_q15 * pSrc,
AnnaBridge	146:22da6e220af6	1528	arm_matrix_instance_q15 * pDst);
AnnaBridge	146:22da6e220af6	1529
AnnaBridge	146:22da6e220af6	1530
AnnaBridge	146:22da6e220af6	1531	/**
AnnaBridge	146:22da6e220af6	1532	* @brief Q31 matrix transpose.
AnnaBridge	146:22da6e220af6	1533	* @param[in] pSrc points to the input matrix
AnnaBridge	146:22da6e220af6	1534	* @param[out] pDst points to the output matrix
AnnaBridge	146:22da6e220af6	1535	* @return The function returns either <code>ARM_MATH_SIZE_MISMATCH</code>
AnnaBridge	146:22da6e220af6	1536	* or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1537	*/
AnnaBridge	146:22da6e220af6	1538	arm_status arm_mat_trans_q31(
AnnaBridge	146:22da6e220af6	1539	const arm_matrix_instance_q31 * pSrc,
AnnaBridge	146:22da6e220af6	1540	arm_matrix_instance_q31 * pDst);
AnnaBridge	146:22da6e220af6	1541
AnnaBridge	146:22da6e220af6	1542
AnnaBridge	146:22da6e220af6	1543	/**
AnnaBridge	146:22da6e220af6	1544	* @brief Floating-point matrix multiplication
AnnaBridge	146:22da6e220af6	1545	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1546	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1547	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1548	* @return The function returns either
AnnaBridge	146:22da6e220af6	1549	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1550	*/
AnnaBridge	146:22da6e220af6	1551	arm_status arm_mat_mult_f32(
AnnaBridge	146:22da6e220af6	1552	const arm_matrix_instance_f32 * pSrcA,
AnnaBridge	146:22da6e220af6	1553	const arm_matrix_instance_f32 * pSrcB,
AnnaBridge	146:22da6e220af6	1554	arm_matrix_instance_f32 * pDst);
AnnaBridge	146:22da6e220af6	1555
AnnaBridge	146:22da6e220af6	1556
AnnaBridge	146:22da6e220af6	1557	/**
AnnaBridge	146:22da6e220af6	1558	* @brief Q15 matrix multiplication
AnnaBridge	146:22da6e220af6	1559	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1560	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1561	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1562	* @param[in] pState points to the array for storing intermediate results
AnnaBridge	146:22da6e220af6	1563	* @return The function returns either
AnnaBridge	146:22da6e220af6	1564	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1565	*/
AnnaBridge	146:22da6e220af6	1566	arm_status arm_mat_mult_q15(
AnnaBridge	146:22da6e220af6	1567	const arm_matrix_instance_q15 * pSrcA,
AnnaBridge	146:22da6e220af6	1568	const arm_matrix_instance_q15 * pSrcB,
AnnaBridge	146:22da6e220af6	1569	arm_matrix_instance_q15 * pDst,
AnnaBridge	146:22da6e220af6	1570	q15_t * pState);
AnnaBridge	146:22da6e220af6	1571
AnnaBridge	146:22da6e220af6	1572
AnnaBridge	146:22da6e220af6	1573	/**
AnnaBridge	146:22da6e220af6	1574	* @brief Q15 matrix multiplication (fast variant) for Cortex-M3 and Cortex-M4
AnnaBridge	146:22da6e220af6	1575	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1576	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1577	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1578	* @param[in] pState points to the array for storing intermediate results
AnnaBridge	146:22da6e220af6	1579	* @return The function returns either
AnnaBridge	146:22da6e220af6	1580	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1581	*/
AnnaBridge	146:22da6e220af6	1582	arm_status arm_mat_mult_fast_q15(
AnnaBridge	146:22da6e220af6	1583	const arm_matrix_instance_q15 * pSrcA,
AnnaBridge	146:22da6e220af6	1584	const arm_matrix_instance_q15 * pSrcB,
AnnaBridge	146:22da6e220af6	1585	arm_matrix_instance_q15 * pDst,
AnnaBridge	146:22da6e220af6	1586	q15_t * pState);
AnnaBridge	146:22da6e220af6	1587
AnnaBridge	146:22da6e220af6	1588
AnnaBridge	146:22da6e220af6	1589	/**
AnnaBridge	146:22da6e220af6	1590	* @brief Q31 matrix multiplication
AnnaBridge	146:22da6e220af6	1591	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1592	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1593	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1594	* @return The function returns either
AnnaBridge	146:22da6e220af6	1595	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1596	*/
AnnaBridge	146:22da6e220af6	1597	arm_status arm_mat_mult_q31(
AnnaBridge	146:22da6e220af6	1598	const arm_matrix_instance_q31 * pSrcA,
AnnaBridge	146:22da6e220af6	1599	const arm_matrix_instance_q31 * pSrcB,
AnnaBridge	146:22da6e220af6	1600	arm_matrix_instance_q31 * pDst);
AnnaBridge	146:22da6e220af6	1601
AnnaBridge	146:22da6e220af6	1602
AnnaBridge	146:22da6e220af6	1603	/**
AnnaBridge	146:22da6e220af6	1604	* @brief Q31 matrix multiplication (fast variant) for Cortex-M3 and Cortex-M4
AnnaBridge	146:22da6e220af6	1605	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1606	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1607	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1608	* @return The function returns either
AnnaBridge	146:22da6e220af6	1609	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1610	*/
AnnaBridge	146:22da6e220af6	1611	arm_status arm_mat_mult_fast_q31(
AnnaBridge	146:22da6e220af6	1612	const arm_matrix_instance_q31 * pSrcA,
AnnaBridge	146:22da6e220af6	1613	const arm_matrix_instance_q31 * pSrcB,
AnnaBridge	146:22da6e220af6	1614	arm_matrix_instance_q31 * pDst);
AnnaBridge	146:22da6e220af6	1615
AnnaBridge	146:22da6e220af6	1616
AnnaBridge	146:22da6e220af6	1617	/**
AnnaBridge	146:22da6e220af6	1618	* @brief Floating-point matrix subtraction
AnnaBridge	146:22da6e220af6	1619	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1620	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1621	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1622	* @return The function returns either
AnnaBridge	146:22da6e220af6	1623	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1624	*/
AnnaBridge	146:22da6e220af6	1625	arm_status arm_mat_sub_f32(
AnnaBridge	146:22da6e220af6	1626	const arm_matrix_instance_f32 * pSrcA,
AnnaBridge	146:22da6e220af6	1627	const arm_matrix_instance_f32 * pSrcB,
AnnaBridge	146:22da6e220af6	1628	arm_matrix_instance_f32 * pDst);
AnnaBridge	146:22da6e220af6	1629
AnnaBridge	146:22da6e220af6	1630
AnnaBridge	146:22da6e220af6	1631	/**
AnnaBridge	146:22da6e220af6	1632	* @brief Q15 matrix subtraction
AnnaBridge	146:22da6e220af6	1633	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1634	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1635	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1636	* @return The function returns either
AnnaBridge	146:22da6e220af6	1637	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1638	*/
AnnaBridge	146:22da6e220af6	1639	arm_status arm_mat_sub_q15(
AnnaBridge	146:22da6e220af6	1640	const arm_matrix_instance_q15 * pSrcA,
AnnaBridge	146:22da6e220af6	1641	const arm_matrix_instance_q15 * pSrcB,
AnnaBridge	146:22da6e220af6	1642	arm_matrix_instance_q15 * pDst);
AnnaBridge	146:22da6e220af6	1643
AnnaBridge	146:22da6e220af6	1644
AnnaBridge	146:22da6e220af6	1645	/**
AnnaBridge	146:22da6e220af6	1646	* @brief Q31 matrix subtraction
AnnaBridge	146:22da6e220af6	1647	* @param[in] pSrcA points to the first input matrix structure
AnnaBridge	146:22da6e220af6	1648	* @param[in] pSrcB points to the second input matrix structure
AnnaBridge	146:22da6e220af6	1649	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1650	* @return The function returns either
AnnaBridge	146:22da6e220af6	1651	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1652	*/
AnnaBridge	146:22da6e220af6	1653	arm_status arm_mat_sub_q31(
AnnaBridge	146:22da6e220af6	1654	const arm_matrix_instance_q31 * pSrcA,
AnnaBridge	146:22da6e220af6	1655	const arm_matrix_instance_q31 * pSrcB,
AnnaBridge	146:22da6e220af6	1656	arm_matrix_instance_q31 * pDst);
AnnaBridge	146:22da6e220af6	1657
AnnaBridge	146:22da6e220af6	1658
AnnaBridge	146:22da6e220af6	1659	/**
AnnaBridge	146:22da6e220af6	1660	* @brief Floating-point matrix scaling.
AnnaBridge	146:22da6e220af6	1661	* @param[in] pSrc points to the input matrix
AnnaBridge	146:22da6e220af6	1662	* @param[in] scale scale factor
AnnaBridge	146:22da6e220af6	1663	* @param[out] pDst points to the output matrix
AnnaBridge	146:22da6e220af6	1664	* @return The function returns either
AnnaBridge	146:22da6e220af6	1665	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1666	*/
AnnaBridge	146:22da6e220af6	1667	arm_status arm_mat_scale_f32(
AnnaBridge	146:22da6e220af6	1668	const arm_matrix_instance_f32 * pSrc,
AnnaBridge	146:22da6e220af6	1669	float32_t scale,
AnnaBridge	146:22da6e220af6	1670	arm_matrix_instance_f32 * pDst);
AnnaBridge	146:22da6e220af6	1671
AnnaBridge	146:22da6e220af6	1672
AnnaBridge	146:22da6e220af6	1673	/**
AnnaBridge	146:22da6e220af6	1674	* @brief Q15 matrix scaling.
AnnaBridge	146:22da6e220af6	1675	* @param[in] pSrc points to input matrix
AnnaBridge	146:22da6e220af6	1676	* @param[in] scaleFract fractional portion of the scale factor
AnnaBridge	146:22da6e220af6	1677	* @param[in] shift number of bits to shift the result by
AnnaBridge	146:22da6e220af6	1678	* @param[out] pDst points to output matrix
AnnaBridge	146:22da6e220af6	1679	* @return The function returns either
AnnaBridge	146:22da6e220af6	1680	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1681	*/
AnnaBridge	146:22da6e220af6	1682	arm_status arm_mat_scale_q15(
AnnaBridge	146:22da6e220af6	1683	const arm_matrix_instance_q15 * pSrc,
AnnaBridge	146:22da6e220af6	1684	q15_t scaleFract,
AnnaBridge	146:22da6e220af6	1685	int32_t shift,
AnnaBridge	146:22da6e220af6	1686	arm_matrix_instance_q15 * pDst);
AnnaBridge	146:22da6e220af6	1687
AnnaBridge	146:22da6e220af6	1688
AnnaBridge	146:22da6e220af6	1689	/**
AnnaBridge	146:22da6e220af6	1690	* @brief Q31 matrix scaling.
AnnaBridge	146:22da6e220af6	1691	* @param[in] pSrc points to input matrix
AnnaBridge	146:22da6e220af6	1692	* @param[in] scaleFract fractional portion of the scale factor
AnnaBridge	146:22da6e220af6	1693	* @param[in] shift number of bits to shift the result by
AnnaBridge	146:22da6e220af6	1694	* @param[out] pDst points to output matrix structure
AnnaBridge	146:22da6e220af6	1695	* @return The function returns either
AnnaBridge	146:22da6e220af6	1696	* <code>ARM_MATH_SIZE_MISMATCH</code> or <code>ARM_MATH_SUCCESS</code> based on the outcome of size checking.
AnnaBridge	146:22da6e220af6	1697	*/
AnnaBridge	146:22da6e220af6	1698	arm_status arm_mat_scale_q31(
AnnaBridge	146:22da6e220af6	1699	const arm_matrix_instance_q31 * pSrc,
AnnaBridge	146:22da6e220af6	1700	q31_t scaleFract,
AnnaBridge	146:22da6e220af6	1701	int32_t shift,
AnnaBridge	146:22da6e220af6	1702	arm_matrix_instance_q31 * pDst);
AnnaBridge	146:22da6e220af6	1703
AnnaBridge	146:22da6e220af6	1704
AnnaBridge	146:22da6e220af6	1705	/**
AnnaBridge	146:22da6e220af6	1706	* @brief Q31 matrix initialization.
AnnaBridge	146:22da6e220af6	1707	* @param[in,out] S points to an instance of the floating-point matrix structure.
AnnaBridge	146:22da6e220af6	1708	* @param[in] nRows number of rows in the matrix.
AnnaBridge	146:22da6e220af6	1709	* @param[in] nColumns number of columns in the matrix.
AnnaBridge	146:22da6e220af6	1710	* @param[in] pData points to the matrix data array.
AnnaBridge	146:22da6e220af6	1711	*/
AnnaBridge	146:22da6e220af6	1712	void arm_mat_init_q31(
AnnaBridge	146:22da6e220af6	1713	arm_matrix_instance_q31 * S,
AnnaBridge	146:22da6e220af6	1714	uint16_t nRows,
AnnaBridge	146:22da6e220af6	1715	uint16_t nColumns,
AnnaBridge	146:22da6e220af6	1716	q31_t * pData);
AnnaBridge	146:22da6e220af6	1717
AnnaBridge	146:22da6e220af6	1718
AnnaBridge	146:22da6e220af6	1719	/**
AnnaBridge	146:22da6e220af6	1720	* @brief Q15 matrix initialization.
AnnaBridge	146:22da6e220af6	1721	* @param[in,out] S points to an instance of the floating-point matrix structure.
AnnaBridge	146:22da6e220af6	1722	* @param[in] nRows number of rows in the matrix.
AnnaBridge	146:22da6e220af6	1723	* @param[in] nColumns number of columns in the matrix.
AnnaBridge	146:22da6e220af6	1724	* @param[in] pData points to the matrix data array.
AnnaBridge	146:22da6e220af6	1725	*/
AnnaBridge	146:22da6e220af6	1726	void arm_mat_init_q15(
AnnaBridge	146:22da6e220af6	1727	arm_matrix_instance_q15 * S,
AnnaBridge	146:22da6e220af6	1728	uint16_t nRows,
AnnaBridge	146:22da6e220af6	1729	uint16_t nColumns,
AnnaBridge	146:22da6e220af6	1730	q15_t * pData);
AnnaBridge	146:22da6e220af6	1731
AnnaBridge	146:22da6e220af6	1732
AnnaBridge	146:22da6e220af6	1733	/**
AnnaBridge	146:22da6e220af6	1734	* @brief Floating-point matrix initialization.
AnnaBridge	146:22da6e220af6	1735	* @param[in,out] S points to an instance of the floating-point matrix structure.
AnnaBridge	146:22da6e220af6	1736	* @param[in] nRows number of rows in the matrix.
AnnaBridge	146:22da6e220af6	1737	* @param[in] nColumns number of columns in the matrix.
AnnaBridge	146:22da6e220af6	1738	* @param[in] pData points to the matrix data array.
AnnaBridge	146:22da6e220af6	1739	*/
AnnaBridge	146:22da6e220af6	1740	void arm_mat_init_f32(
AnnaBridge	146:22da6e220af6	1741	arm_matrix_instance_f32 * S,
AnnaBridge	146:22da6e220af6	1742	uint16_t nRows,
AnnaBridge	146:22da6e220af6	1743	uint16_t nColumns,
AnnaBridge	146:22da6e220af6	1744	float32_t * pData);
AnnaBridge	146:22da6e220af6	1745
AnnaBridge	146:22da6e220af6	1746
AnnaBridge	146:22da6e220af6	1747
AnnaBridge	146:22da6e220af6	1748	/**
AnnaBridge	146:22da6e220af6	1749	* @brief Instance structure for the Q15 PID Control.
AnnaBridge	146:22da6e220af6	1750	*/
AnnaBridge	146:22da6e220af6	1751	typedef struct
AnnaBridge	146:22da6e220af6	1752	{
AnnaBridge	146:22da6e220af6	1753	q15_t A0; /*< The derived gain, A0 = Kp + Ki + Kd . /
AnnaBridge	146:22da6e220af6	1754	#if !defined (ARM_MATH_DSP)
AnnaBridge	146:22da6e220af6	1755	q15_t A1;
AnnaBridge	146:22da6e220af6	1756	q15_t A2;
AnnaBridge	146:22da6e220af6	1757	#else
AnnaBridge	146:22da6e220af6	1758	q31_t A1; /*< The derived gain A1 = -Kp - 2Kd \| Kd./
AnnaBridge	146:22da6e220af6	1759	#endif
AnnaBridge	146:22da6e220af6	1760	q15_t state[3]; /*< The state array of length 3. /
AnnaBridge	146:22da6e220af6	1761	q15_t Kp; /*< The proportional gain. /
AnnaBridge	146:22da6e220af6	1762	q15_t Ki; /*< The integral gain. /
AnnaBridge	146:22da6e220af6	1763	q15_t Kd; /*< The derivative gain. /
AnnaBridge	146:22da6e220af6	1764	} arm_pid_instance_q15;
AnnaBridge	146:22da6e220af6	1765
AnnaBridge	146:22da6e220af6	1766	/**
AnnaBridge	146:22da6e220af6	1767	* @brief Instance structure for the Q31 PID Control.
AnnaBridge	146:22da6e220af6	1768	*/
AnnaBridge	146:22da6e220af6	1769	typedef struct
AnnaBridge	146:22da6e220af6	1770	{
AnnaBridge	146:22da6e220af6	1771	q31_t A0; /*< The derived gain, A0 = Kp + Ki + Kd . /
AnnaBridge	146:22da6e220af6	1772	q31_t A1; /*< The derived gain, A1 = -Kp - 2Kd. /
AnnaBridge	146:22da6e220af6	1773	q31_t A2; /*< The derived gain, A2 = Kd . /
AnnaBridge	146:22da6e220af6	1774	q31_t state[3]; /*< The state array of length 3. /
AnnaBridge	146:22da6e220af6	1775	q31_t Kp; /*< The proportional gain. /
AnnaBridge	146:22da6e220af6	1776	q31_t Ki; /*< The integral gain. /
AnnaBridge	146:22da6e220af6	1777	q31_t Kd; /*< The derivative gain. /
AnnaBridge	146:22da6e220af6	1778	} arm_pid_instance_q31;
AnnaBridge	146:22da6e220af6	1779
AnnaBridge	146:22da6e220af6	1780	/**
AnnaBridge	146:22da6e220af6	1781	* @brief Instance structure for the floating-point PID Control.
AnnaBridge	146:22da6e220af6	1782	*/
AnnaBridge	146:22da6e220af6	1783	typedef struct
AnnaBridge	146:22da6e220af6	1784	{
AnnaBridge	146:22da6e220af6	1785	float32_t A0; /*< The derived gain, A0 = Kp + Ki + Kd . /
AnnaBridge	146:22da6e220af6	1786	float32_t A1; /*< The derived gain, A1 = -Kp - 2Kd. /
AnnaBridge	146:22da6e220af6	1787	float32_t A2; /*< The derived gain, A2 = Kd . /
AnnaBridge	146:22da6e220af6	1788	float32_t state[3]; /*< The state array of length 3. /
AnnaBridge	146:22da6e220af6	1789	float32_t Kp; /*< The proportional gain. /
AnnaBridge	146:22da6e220af6	1790	float32_t Ki; /*< The integral gain. /
AnnaBridge	146:22da6e220af6	1791	float32_t Kd; /*< The derivative gain. /
AnnaBridge	146:22da6e220af6	1792	} arm_pid_instance_f32;
AnnaBridge	146:22da6e220af6	1793
AnnaBridge	146:22da6e220af6	1794
AnnaBridge	146:22da6e220af6	1795
AnnaBridge	146:22da6e220af6	1796	/**
AnnaBridge	146:22da6e220af6	1797	* @brief Initialization function for the floating-point PID Control.
AnnaBridge	146:22da6e220af6	1798	* @param[in,out] S points to an instance of the PID structure.
AnnaBridge	146:22da6e220af6	1799	* @param[in] resetStateFlag flag to reset the state. 0 = no change in state 1 = reset the state.
AnnaBridge	146:22da6e220af6	1800	*/
AnnaBridge	146:22da6e220af6	1801	void arm_pid_init_f32(
AnnaBridge	146:22da6e220af6	1802	arm_pid_instance_f32 * S,
AnnaBridge	146:22da6e220af6	1803	int32_t resetStateFlag);
AnnaBridge	146:22da6e220af6	1804
AnnaBridge	146:22da6e220af6	1805
AnnaBridge	146:22da6e220af6	1806	/**
AnnaBridge	146:22da6e220af6	1807	* @brief Reset function for the floating-point PID Control.
AnnaBridge	146:22da6e220af6	1808	* @param[in,out] S is an instance of the floating-point PID Control structure
AnnaBridge	146:22da6e220af6	1809	*/
AnnaBridge	146:22da6e220af6	1810	void arm_pid_reset_f32(
AnnaBridge	146:22da6e220af6	1811	arm_pid_instance_f32 * S);
AnnaBridge	146:22da6e220af6	1812
AnnaBridge	146:22da6e220af6	1813
AnnaBridge	146:22da6e220af6	1814	/**
AnnaBridge	146:22da6e220af6	1815	* @brief Initialization function for the Q31 PID Control.
AnnaBridge	146:22da6e220af6	1816	* @param[in,out] S points to an instance of the Q15 PID structure.
AnnaBridge	146:22da6e220af6	1817	* @param[in] resetStateFlag flag to reset the state. 0 = no change in state 1 = reset the state.
AnnaBridge	146:22da6e220af6	1818	*/
AnnaBridge	146:22da6e220af6	1819	void arm_pid_init_q31(
AnnaBridge	146:22da6e220af6	1820	arm_pid_instance_q31 * S,
AnnaBridge	146:22da6e220af6	1821	int32_t resetStateFlag);
AnnaBridge	146:22da6e220af6	1822
AnnaBridge	146:22da6e220af6	1823
AnnaBridge	146:22da6e220af6	1824	/**
AnnaBridge	146:22da6e220af6	1825	* @brief Reset function for the Q31 PID Control.
AnnaBridge	146:22da6e220af6	1826	* @param[in,out] S points to an instance of the Q31 PID Control structure
AnnaBridge	146:22da6e220af6	1827	*/
AnnaBridge	146:22da6e220af6	1828
AnnaBridge	146:22da6e220af6	1829	void arm_pid_reset_q31(
AnnaBridge	146:22da6e220af6	1830	arm_pid_instance_q31 * S);
AnnaBridge	146:22da6e220af6	1831
AnnaBridge	146:22da6e220af6	1832
AnnaBridge	146:22da6e220af6	1833	/**
AnnaBridge	146:22da6e220af6	1834	* @brief Initialization function for the Q15 PID Control.
AnnaBridge	146:22da6e220af6	1835	* @param[in,out] S points to an instance of the Q15 PID structure.
AnnaBridge	146:22da6e220af6	1836	* @param[in] resetStateFlag flag to reset the state. 0 = no change in state 1 = reset the state.
AnnaBridge	146:22da6e220af6	1837	*/
AnnaBridge	146:22da6e220af6	1838	void arm_pid_init_q15(
AnnaBridge	146:22da6e220af6	1839	arm_pid_instance_q15 * S,
AnnaBridge	146:22da6e220af6	1840	int32_t resetStateFlag);
AnnaBridge	146:22da6e220af6	1841
AnnaBridge	146:22da6e220af6	1842
AnnaBridge	146:22da6e220af6	1843	/**
AnnaBridge	146:22da6e220af6	1844	* @brief Reset function for the Q15 PID Control.
AnnaBridge	146:22da6e220af6	1845	* @param[in,out] S points to an instance of the q15 PID Control structure
AnnaBridge	146:22da6e220af6	1846	*/
AnnaBridge	146:22da6e220af6	1847	void arm_pid_reset_q15(
AnnaBridge	146:22da6e220af6	1848	arm_pid_instance_q15 * S);
AnnaBridge	146:22da6e220af6	1849
AnnaBridge	146:22da6e220af6	1850
AnnaBridge	146:22da6e220af6	1851	/**
AnnaBridge	146:22da6e220af6	1852	* @brief Instance structure for the floating-point Linear Interpolate function.
AnnaBridge	146:22da6e220af6	1853	*/
AnnaBridge	146:22da6e220af6	1854	typedef struct
AnnaBridge	146:22da6e220af6	1855	{
AnnaBridge	146:22da6e220af6	1856	uint32_t nValues; /*< nValues /
AnnaBridge	146:22da6e220af6	1857	float32_t x1; /*< x1 /
AnnaBridge	146:22da6e220af6	1858	float32_t xSpacing; /*< xSpacing /
AnnaBridge	146:22da6e220af6	1859	float32_t pYData; /< pointer to the table of Y values /
AnnaBridge	146:22da6e220af6	1860	} arm_linear_interp_instance_f32;
AnnaBridge	146:22da6e220af6	1861
AnnaBridge	146:22da6e220af6	1862	/**
AnnaBridge	146:22da6e220af6	1863	* @brief Instance structure for the floating-point bilinear interpolation function.
AnnaBridge	146:22da6e220af6	1864	*/
AnnaBridge	146:22da6e220af6	1865	typedef struct
AnnaBridge	146:22da6e220af6	1866	{
AnnaBridge	146:22da6e220af6	1867	uint16_t numRows; /*< number of rows in the data table. /
AnnaBridge	146:22da6e220af6	1868	uint16_t numCols; /*< number of columns in the data table. /
AnnaBridge	146:22da6e220af6	1869	float32_t pData; /< points to the data table. /
AnnaBridge	146:22da6e220af6	1870	} arm_bilinear_interp_instance_f32;
AnnaBridge	146:22da6e220af6	1871
AnnaBridge	146:22da6e220af6	1872	/**
AnnaBridge	146:22da6e220af6	1873	* @brief Instance structure for the Q31 bilinear interpolation function.
AnnaBridge	146:22da6e220af6	1874	*/
AnnaBridge	146:22da6e220af6	1875	typedef struct
AnnaBridge	146:22da6e220af6	1876	{
AnnaBridge	146:22da6e220af6	1877	uint16_t numRows; /*< number of rows in the data table. /
AnnaBridge	146:22da6e220af6	1878	uint16_t numCols; /*< number of columns in the data table. /
AnnaBridge	146:22da6e220af6	1879	q31_t pData; /< points to the data table. /
AnnaBridge	146:22da6e220af6	1880	} arm_bilinear_interp_instance_q31;
AnnaBridge	146:22da6e220af6	1881
AnnaBridge	146:22da6e220af6	1882	/**
AnnaBridge	146:22da6e220af6	1883	* @brief Instance structure for the Q15 bilinear interpolation function.
AnnaBridge	146:22da6e220af6	1884	*/
AnnaBridge	146:22da6e220af6	1885	typedef struct
AnnaBridge	146:22da6e220af6	1886	{
AnnaBridge	146:22da6e220af6	1887	uint16_t numRows; /*< number of rows in the data table. /
AnnaBridge	146:22da6e220af6	1888	uint16_t numCols; /*< number of columns in the data table. /
AnnaBridge	146:22da6e220af6	1889	q15_t pData; /< points to the data table. /
AnnaBridge	146:22da6e220af6	1890	} arm_bilinear_interp_instance_q15;
AnnaBridge	146:22da6e220af6	1891
AnnaBridge	146:22da6e220af6	1892	/**
AnnaBridge	146:22da6e220af6	1893	* @brief Instance structure for the Q15 bilinear interpolation function.
AnnaBridge	146:22da6e220af6	1894	*/
AnnaBridge	146:22da6e220af6	1895	typedef struct
AnnaBridge	146:22da6e220af6	1896	{
AnnaBridge	146:22da6e220af6	1897	uint16_t numRows; /*< number of rows in the data table. /
AnnaBridge	146:22da6e220af6	1898	uint16_t numCols; /*< number of columns in the data table. /
AnnaBridge	146:22da6e220af6	1899	q7_t pData; /< points to the data table. /
AnnaBridge	146:22da6e220af6	1900	} arm_bilinear_interp_instance_q7;
AnnaBridge	146:22da6e220af6	1901
AnnaBridge	146:22da6e220af6	1902
AnnaBridge	146:22da6e220af6	1903	/**
AnnaBridge	146:22da6e220af6	1904	* @brief Q7 vector multiplication.
AnnaBridge	146:22da6e220af6	1905	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	1906	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	1907	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	1908	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	1909	*/
AnnaBridge	146:22da6e220af6	1910	void arm_mult_q7(
AnnaBridge	146:22da6e220af6	1911	q7_t * pSrcA,
AnnaBridge	146:22da6e220af6	1912	q7_t * pSrcB,
AnnaBridge	146:22da6e220af6	1913	q7_t * pDst,
AnnaBridge	146:22da6e220af6	1914	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1915
AnnaBridge	146:22da6e220af6	1916
AnnaBridge	146:22da6e220af6	1917	/**
AnnaBridge	146:22da6e220af6	1918	* @brief Q15 vector multiplication.
AnnaBridge	146:22da6e220af6	1919	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	1920	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	1921	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	1922	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	1923	*/
AnnaBridge	146:22da6e220af6	1924	void arm_mult_q15(
AnnaBridge	146:22da6e220af6	1925	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	1926	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	1927	q15_t * pDst,
AnnaBridge	146:22da6e220af6	1928	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1929
AnnaBridge	146:22da6e220af6	1930
AnnaBridge	146:22da6e220af6	1931	/**
AnnaBridge	146:22da6e220af6	1932	* @brief Q31 vector multiplication.
AnnaBridge	146:22da6e220af6	1933	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	1934	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	1935	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	1936	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	1937	*/
AnnaBridge	146:22da6e220af6	1938	void arm_mult_q31(
AnnaBridge	146:22da6e220af6	1939	q31_t * pSrcA,
AnnaBridge	146:22da6e220af6	1940	q31_t * pSrcB,
AnnaBridge	146:22da6e220af6	1941	q31_t * pDst,
AnnaBridge	146:22da6e220af6	1942	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1943
AnnaBridge	146:22da6e220af6	1944
AnnaBridge	146:22da6e220af6	1945	/**
AnnaBridge	146:22da6e220af6	1946	* @brief Floating-point vector multiplication.
AnnaBridge	146:22da6e220af6	1947	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	1948	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	1949	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	1950	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	1951	*/
AnnaBridge	146:22da6e220af6	1952	void arm_mult_f32(
AnnaBridge	146:22da6e220af6	1953	float32_t * pSrcA,
AnnaBridge	146:22da6e220af6	1954	float32_t * pSrcB,
AnnaBridge	146:22da6e220af6	1955	float32_t * pDst,
AnnaBridge	146:22da6e220af6	1956	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	1957
AnnaBridge	146:22da6e220af6	1958
AnnaBridge	146:22da6e220af6	1959	/**
AnnaBridge	146:22da6e220af6	1960	* @brief Instance structure for the Q15 CFFT/CIFFT function.
AnnaBridge	146:22da6e220af6	1961	*/
AnnaBridge	146:22da6e220af6	1962	typedef struct
AnnaBridge	146:22da6e220af6	1963	{
AnnaBridge	146:22da6e220af6	1964	uint16_t fftLen; /*< length of the FFT. /
AnnaBridge	146:22da6e220af6	1965	uint8_t ifftFlag; /*< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. /
AnnaBridge	146:22da6e220af6	1966	uint8_t bitReverseFlag; /*< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. /
AnnaBridge	146:22da6e220af6	1967	q15_t pTwiddle; /< points to the Sin twiddle factor table. /
AnnaBridge	146:22da6e220af6	1968	uint16_t pBitRevTable; /< points to the bit reversal table. /
AnnaBridge	146:22da6e220af6	1969	uint16_t twidCoefModifier; /*< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. /
AnnaBridge	146:22da6e220af6	1970	uint16_t bitRevFactor; /*< bit reversal modifier that supports different size FFTs with the same bit reversal table. /
AnnaBridge	146:22da6e220af6	1971	} arm_cfft_radix2_instance_q15;
AnnaBridge	146:22da6e220af6	1972
AnnaBridge	146:22da6e220af6	1973	/* Deprecated */
AnnaBridge	146:22da6e220af6	1974	arm_status arm_cfft_radix2_init_q15(
AnnaBridge	146:22da6e220af6	1975	arm_cfft_radix2_instance_q15 * S,
AnnaBridge	146:22da6e220af6	1976	uint16_t fftLen,
AnnaBridge	146:22da6e220af6	1977	uint8_t ifftFlag,
AnnaBridge	146:22da6e220af6	1978	uint8_t bitReverseFlag);
AnnaBridge	146:22da6e220af6	1979
AnnaBridge	146:22da6e220af6	1980	/* Deprecated */
AnnaBridge	146:22da6e220af6	1981	void arm_cfft_radix2_q15(
AnnaBridge	146:22da6e220af6	1982	const arm_cfft_radix2_instance_q15 * S,
AnnaBridge	146:22da6e220af6	1983	q15_t * pSrc);
AnnaBridge	146:22da6e220af6	1984
AnnaBridge	146:22da6e220af6	1985
AnnaBridge	146:22da6e220af6	1986	/**
AnnaBridge	146:22da6e220af6	1987	* @brief Instance structure for the Q15 CFFT/CIFFT function.
AnnaBridge	146:22da6e220af6	1988	*/
AnnaBridge	146:22da6e220af6	1989	typedef struct
AnnaBridge	146:22da6e220af6	1990	{
AnnaBridge	146:22da6e220af6	1991	uint16_t fftLen; /*< length of the FFT. /
AnnaBridge	146:22da6e220af6	1992	uint8_t ifftFlag; /*< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. /
AnnaBridge	146:22da6e220af6	1993	uint8_t bitReverseFlag; /*< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. /
AnnaBridge	146:22da6e220af6	1994	q15_t pTwiddle; /< points to the twiddle factor table. /
AnnaBridge	146:22da6e220af6	1995	uint16_t pBitRevTable; /< points to the bit reversal table. /
AnnaBridge	146:22da6e220af6	1996	uint16_t twidCoefModifier; /*< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. /
AnnaBridge	146:22da6e220af6	1997	uint16_t bitRevFactor; /*< bit reversal modifier that supports different size FFTs with the same bit reversal table. /
AnnaBridge	146:22da6e220af6	1998	} arm_cfft_radix4_instance_q15;
AnnaBridge	146:22da6e220af6	1999
AnnaBridge	146:22da6e220af6	2000	/* Deprecated */
AnnaBridge	146:22da6e220af6	2001	arm_status arm_cfft_radix4_init_q15(
AnnaBridge	146:22da6e220af6	2002	arm_cfft_radix4_instance_q15 * S,
AnnaBridge	146:22da6e220af6	2003	uint16_t fftLen,
AnnaBridge	146:22da6e220af6	2004	uint8_t ifftFlag,
AnnaBridge	146:22da6e220af6	2005	uint8_t bitReverseFlag);
AnnaBridge	146:22da6e220af6	2006
AnnaBridge	146:22da6e220af6	2007	/* Deprecated */
AnnaBridge	146:22da6e220af6	2008	void arm_cfft_radix4_q15(
AnnaBridge	146:22da6e220af6	2009	const arm_cfft_radix4_instance_q15 * S,
AnnaBridge	146:22da6e220af6	2010	q15_t * pSrc);
AnnaBridge	146:22da6e220af6	2011
AnnaBridge	146:22da6e220af6	2012	/**
AnnaBridge	146:22da6e220af6	2013	* @brief Instance structure for the Radix-2 Q31 CFFT/CIFFT function.
AnnaBridge	146:22da6e220af6	2014	*/
AnnaBridge	146:22da6e220af6	2015	typedef struct
AnnaBridge	146:22da6e220af6	2016	{
AnnaBridge	146:22da6e220af6	2017	uint16_t fftLen; /*< length of the FFT. /
AnnaBridge	146:22da6e220af6	2018	uint8_t ifftFlag; /*< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. /
AnnaBridge	146:22da6e220af6	2019	uint8_t bitReverseFlag; /*< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. /
AnnaBridge	146:22da6e220af6	2020	q31_t pTwiddle; /< points to the Twiddle factor table. /
AnnaBridge	146:22da6e220af6	2021	uint16_t pBitRevTable; /< points to the bit reversal table. /
AnnaBridge	146:22da6e220af6	2022	uint16_t twidCoefModifier; /*< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. /
AnnaBridge	146:22da6e220af6	2023	uint16_t bitRevFactor; /*< bit reversal modifier that supports different size FFTs with the same bit reversal table. /
AnnaBridge	146:22da6e220af6	2024	} arm_cfft_radix2_instance_q31;
AnnaBridge	146:22da6e220af6	2025
AnnaBridge	146:22da6e220af6	2026	/* Deprecated */
AnnaBridge	146:22da6e220af6	2027	arm_status arm_cfft_radix2_init_q31(
AnnaBridge	146:22da6e220af6	2028	arm_cfft_radix2_instance_q31 * S,
AnnaBridge	146:22da6e220af6	2029	uint16_t fftLen,
AnnaBridge	146:22da6e220af6	2030	uint8_t ifftFlag,
AnnaBridge	146:22da6e220af6	2031	uint8_t bitReverseFlag);
AnnaBridge	146:22da6e220af6	2032
AnnaBridge	146:22da6e220af6	2033	/* Deprecated */
AnnaBridge	146:22da6e220af6	2034	void arm_cfft_radix2_q31(
AnnaBridge	146:22da6e220af6	2035	const arm_cfft_radix2_instance_q31 * S,
AnnaBridge	146:22da6e220af6	2036	q31_t * pSrc);
AnnaBridge	146:22da6e220af6	2037
AnnaBridge	146:22da6e220af6	2038	/**
AnnaBridge	146:22da6e220af6	2039	* @brief Instance structure for the Q31 CFFT/CIFFT function.
AnnaBridge	146:22da6e220af6	2040	*/
AnnaBridge	146:22da6e220af6	2041	typedef struct
AnnaBridge	146:22da6e220af6	2042	{
AnnaBridge	146:22da6e220af6	2043	uint16_t fftLen; /*< length of the FFT. /
AnnaBridge	146:22da6e220af6	2044	uint8_t ifftFlag; /*< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. /
AnnaBridge	146:22da6e220af6	2045	uint8_t bitReverseFlag; /*< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. /
AnnaBridge	146:22da6e220af6	2046	q31_t pTwiddle; /< points to the twiddle factor table. /
AnnaBridge	146:22da6e220af6	2047	uint16_t pBitRevTable; /< points to the bit reversal table. /
AnnaBridge	146:22da6e220af6	2048	uint16_t twidCoefModifier; /*< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. /
AnnaBridge	146:22da6e220af6	2049	uint16_t bitRevFactor; /*< bit reversal modifier that supports different size FFTs with the same bit reversal table. /
AnnaBridge	146:22da6e220af6	2050	} arm_cfft_radix4_instance_q31;
AnnaBridge	146:22da6e220af6	2051
AnnaBridge	146:22da6e220af6	2052	/* Deprecated */
AnnaBridge	146:22da6e220af6	2053	void arm_cfft_radix4_q31(
AnnaBridge	146:22da6e220af6	2054	const arm_cfft_radix4_instance_q31 * S,
AnnaBridge	146:22da6e220af6	2055	q31_t * pSrc);
AnnaBridge	146:22da6e220af6	2056
AnnaBridge	146:22da6e220af6	2057	/* Deprecated */
AnnaBridge	146:22da6e220af6	2058	arm_status arm_cfft_radix4_init_q31(
AnnaBridge	146:22da6e220af6	2059	arm_cfft_radix4_instance_q31 * S,
AnnaBridge	146:22da6e220af6	2060	uint16_t fftLen,
AnnaBridge	146:22da6e220af6	2061	uint8_t ifftFlag,
AnnaBridge	146:22da6e220af6	2062	uint8_t bitReverseFlag);
AnnaBridge	146:22da6e220af6	2063
AnnaBridge	146:22da6e220af6	2064	/**
AnnaBridge	146:22da6e220af6	2065	* @brief Instance structure for the floating-point CFFT/CIFFT function.
AnnaBridge	146:22da6e220af6	2066	*/
AnnaBridge	146:22da6e220af6	2067	typedef struct
AnnaBridge	146:22da6e220af6	2068	{
AnnaBridge	146:22da6e220af6	2069	uint16_t fftLen; /*< length of the FFT. /
AnnaBridge	146:22da6e220af6	2070	uint8_t ifftFlag; /*< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. /
AnnaBridge	146:22da6e220af6	2071	uint8_t bitReverseFlag; /*< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. /
AnnaBridge	146:22da6e220af6	2072	float32_t pTwiddle; /< points to the Twiddle factor table. /
AnnaBridge	146:22da6e220af6	2073	uint16_t pBitRevTable; /< points to the bit reversal table. /
AnnaBridge	146:22da6e220af6	2074	uint16_t twidCoefModifier; /*< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. /
AnnaBridge	146:22da6e220af6	2075	uint16_t bitRevFactor; /*< bit reversal modifier that supports different size FFTs with the same bit reversal table. /
AnnaBridge	146:22da6e220af6	2076	float32_t onebyfftLen; /*< value of 1/fftLen. /
AnnaBridge	146:22da6e220af6	2077	} arm_cfft_radix2_instance_f32;
AnnaBridge	146:22da6e220af6	2078
AnnaBridge	146:22da6e220af6	2079	/* Deprecated */
AnnaBridge	146:22da6e220af6	2080	arm_status arm_cfft_radix2_init_f32(
AnnaBridge	146:22da6e220af6	2081	arm_cfft_radix2_instance_f32 * S,
AnnaBridge	146:22da6e220af6	2082	uint16_t fftLen,
AnnaBridge	146:22da6e220af6	2083	uint8_t ifftFlag,
AnnaBridge	146:22da6e220af6	2084	uint8_t bitReverseFlag);
AnnaBridge	146:22da6e220af6	2085
AnnaBridge	146:22da6e220af6	2086	/* Deprecated */
AnnaBridge	146:22da6e220af6	2087	void arm_cfft_radix2_f32(
AnnaBridge	146:22da6e220af6	2088	const arm_cfft_radix2_instance_f32 * S,
AnnaBridge	146:22da6e220af6	2089	float32_t * pSrc);
AnnaBridge	146:22da6e220af6	2090
AnnaBridge	146:22da6e220af6	2091	/**
AnnaBridge	146:22da6e220af6	2092	* @brief Instance structure for the floating-point CFFT/CIFFT function.
AnnaBridge	146:22da6e220af6	2093	*/
AnnaBridge	146:22da6e220af6	2094	typedef struct
AnnaBridge	146:22da6e220af6	2095	{
AnnaBridge	146:22da6e220af6	2096	uint16_t fftLen; /*< length of the FFT. /
AnnaBridge	146:22da6e220af6	2097	uint8_t ifftFlag; /*< flag that selects forward (ifftFlag=0) or inverse (ifftFlag=1) transform. /
AnnaBridge	146:22da6e220af6	2098	uint8_t bitReverseFlag; /*< flag that enables (bitReverseFlag=1) or disables (bitReverseFlag=0) bit reversal of output. /
AnnaBridge	146:22da6e220af6	2099	float32_t pTwiddle; /< points to the Twiddle factor table. /
AnnaBridge	146:22da6e220af6	2100	uint16_t pBitRevTable; /< points to the bit reversal table. /
AnnaBridge	146:22da6e220af6	2101	uint16_t twidCoefModifier; /*< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. /
AnnaBridge	146:22da6e220af6	2102	uint16_t bitRevFactor; /*< bit reversal modifier that supports different size FFTs with the same bit reversal table. /
AnnaBridge	146:22da6e220af6	2103	float32_t onebyfftLen; /*< value of 1/fftLen. /
AnnaBridge	146:22da6e220af6	2104	} arm_cfft_radix4_instance_f32;
AnnaBridge	146:22da6e220af6	2105
AnnaBridge	146:22da6e220af6	2106	/* Deprecated */
AnnaBridge	146:22da6e220af6	2107	arm_status arm_cfft_radix4_init_f32(
AnnaBridge	146:22da6e220af6	2108	arm_cfft_radix4_instance_f32 * S,
AnnaBridge	146:22da6e220af6	2109	uint16_t fftLen,
AnnaBridge	146:22da6e220af6	2110	uint8_t ifftFlag,
AnnaBridge	146:22da6e220af6	2111	uint8_t bitReverseFlag);
AnnaBridge	146:22da6e220af6	2112
AnnaBridge	146:22da6e220af6	2113	/* Deprecated */
AnnaBridge	146:22da6e220af6	2114	void arm_cfft_radix4_f32(
AnnaBridge	146:22da6e220af6	2115	const arm_cfft_radix4_instance_f32 * S,
AnnaBridge	146:22da6e220af6	2116	float32_t * pSrc);
AnnaBridge	146:22da6e220af6	2117
AnnaBridge	146:22da6e220af6	2118	/**
AnnaBridge	146:22da6e220af6	2119	* @brief Instance structure for the fixed-point CFFT/CIFFT function.
AnnaBridge	146:22da6e220af6	2120	*/
AnnaBridge	146:22da6e220af6	2121	typedef struct
AnnaBridge	146:22da6e220af6	2122	{
AnnaBridge	146:22da6e220af6	2123	uint16_t fftLen; /*< length of the FFT. /
AnnaBridge	146:22da6e220af6	2124	const q15_t pTwiddle; /< points to the Twiddle factor table. /
AnnaBridge	146:22da6e220af6	2125	const uint16_t pBitRevTable; /< points to the bit reversal table. /
AnnaBridge	146:22da6e220af6	2126	uint16_t bitRevLength; /*< bit reversal table length. /
AnnaBridge	146:22da6e220af6	2127	} arm_cfft_instance_q15;
AnnaBridge	146:22da6e220af6	2128
AnnaBridge	146:22da6e220af6	2129	void arm_cfft_q15(
AnnaBridge	146:22da6e220af6	2130	const arm_cfft_instance_q15 * S,
AnnaBridge	146:22da6e220af6	2131	q15_t * p1,
AnnaBridge	146:22da6e220af6	2132	uint8_t ifftFlag,
AnnaBridge	146:22da6e220af6	2133	uint8_t bitReverseFlag);
AnnaBridge	146:22da6e220af6	2134
AnnaBridge	146:22da6e220af6	2135	/**
AnnaBridge	146:22da6e220af6	2136	* @brief Instance structure for the fixed-point CFFT/CIFFT function.
AnnaBridge	146:22da6e220af6	2137	*/
AnnaBridge	146:22da6e220af6	2138	typedef struct
AnnaBridge	146:22da6e220af6	2139	{
AnnaBridge	146:22da6e220af6	2140	uint16_t fftLen; /*< length of the FFT. /
AnnaBridge	146:22da6e220af6	2141	const q31_t pTwiddle; /< points to the Twiddle factor table. /
AnnaBridge	146:22da6e220af6	2142	const uint16_t pBitRevTable; /< points to the bit reversal table. /
AnnaBridge	146:22da6e220af6	2143	uint16_t bitRevLength; /*< bit reversal table length. /
AnnaBridge	146:22da6e220af6	2144	} arm_cfft_instance_q31;
AnnaBridge	146:22da6e220af6	2145
AnnaBridge	146:22da6e220af6	2146	void arm_cfft_q31(
AnnaBridge	146:22da6e220af6	2147	const arm_cfft_instance_q31 * S,
AnnaBridge	146:22da6e220af6	2148	q31_t * p1,
AnnaBridge	146:22da6e220af6	2149	uint8_t ifftFlag,
AnnaBridge	146:22da6e220af6	2150	uint8_t bitReverseFlag);
AnnaBridge	146:22da6e220af6	2151
AnnaBridge	146:22da6e220af6	2152	/**
AnnaBridge	146:22da6e220af6	2153	* @brief Instance structure for the floating-point CFFT/CIFFT function.
AnnaBridge	146:22da6e220af6	2154	*/
AnnaBridge	146:22da6e220af6	2155	typedef struct
AnnaBridge	146:22da6e220af6	2156	{
AnnaBridge	146:22da6e220af6	2157	uint16_t fftLen; /*< length of the FFT. /
AnnaBridge	146:22da6e220af6	2158	const float32_t pTwiddle; /< points to the Twiddle factor table. /
AnnaBridge	146:22da6e220af6	2159	const uint16_t pBitRevTable; /< points to the bit reversal table. /
AnnaBridge	146:22da6e220af6	2160	uint16_t bitRevLength; /*< bit reversal table length. /
AnnaBridge	146:22da6e220af6	2161	} arm_cfft_instance_f32;
AnnaBridge	146:22da6e220af6	2162
AnnaBridge	146:22da6e220af6	2163	void arm_cfft_f32(
AnnaBridge	146:22da6e220af6	2164	const arm_cfft_instance_f32 * S,
AnnaBridge	146:22da6e220af6	2165	float32_t * p1,
AnnaBridge	146:22da6e220af6	2166	uint8_t ifftFlag,
AnnaBridge	146:22da6e220af6	2167	uint8_t bitReverseFlag);
AnnaBridge	146:22da6e220af6	2168
AnnaBridge	146:22da6e220af6	2169	/**
AnnaBridge	146:22da6e220af6	2170	* @brief Instance structure for the Q15 RFFT/RIFFT function.
AnnaBridge	146:22da6e220af6	2171	*/
AnnaBridge	146:22da6e220af6	2172	typedef struct
AnnaBridge	146:22da6e220af6	2173	{
AnnaBridge	146:22da6e220af6	2174	uint32_t fftLenReal; /*< length of the real FFT. /
AnnaBridge	146:22da6e220af6	2175	uint8_t ifftFlagR; /*< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. /
AnnaBridge	146:22da6e220af6	2176	uint8_t bitReverseFlagR; /*< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. /
AnnaBridge	146:22da6e220af6	2177	uint32_t twidCoefRModifier; /*< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. /
AnnaBridge	146:22da6e220af6	2178	q15_t pTwiddleAReal; /< points to the real twiddle factor table. /
AnnaBridge	146:22da6e220af6	2179	q15_t pTwiddleBReal; /< points to the imag twiddle factor table. /
AnnaBridge	146:22da6e220af6	2180	const arm_cfft_instance_q15 pCfft; /< points to the complex FFT instance. /
AnnaBridge	146:22da6e220af6	2181	} arm_rfft_instance_q15;
AnnaBridge	146:22da6e220af6	2182
AnnaBridge	146:22da6e220af6	2183	arm_status arm_rfft_init_q15(
AnnaBridge	146:22da6e220af6	2184	arm_rfft_instance_q15 * S,
AnnaBridge	146:22da6e220af6	2185	uint32_t fftLenReal,
AnnaBridge	146:22da6e220af6	2186	uint32_t ifftFlagR,
AnnaBridge	146:22da6e220af6	2187	uint32_t bitReverseFlag);
AnnaBridge	146:22da6e220af6	2188
AnnaBridge	146:22da6e220af6	2189	void arm_rfft_q15(
AnnaBridge	146:22da6e220af6	2190	const arm_rfft_instance_q15 * S,
AnnaBridge	146:22da6e220af6	2191	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	2192	q15_t * pDst);
AnnaBridge	146:22da6e220af6	2193
AnnaBridge	146:22da6e220af6	2194	/**
AnnaBridge	146:22da6e220af6	2195	* @brief Instance structure for the Q31 RFFT/RIFFT function.
AnnaBridge	146:22da6e220af6	2196	*/
AnnaBridge	146:22da6e220af6	2197	typedef struct
AnnaBridge	146:22da6e220af6	2198	{
AnnaBridge	146:22da6e220af6	2199	uint32_t fftLenReal; /*< length of the real FFT. /
AnnaBridge	146:22da6e220af6	2200	uint8_t ifftFlagR; /*< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. /
AnnaBridge	146:22da6e220af6	2201	uint8_t bitReverseFlagR; /*< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. /
AnnaBridge	146:22da6e220af6	2202	uint32_t twidCoefRModifier; /*< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. /
AnnaBridge	146:22da6e220af6	2203	q31_t pTwiddleAReal; /< points to the real twiddle factor table. /
AnnaBridge	146:22da6e220af6	2204	q31_t pTwiddleBReal; /< points to the imag twiddle factor table. /
AnnaBridge	146:22da6e220af6	2205	const arm_cfft_instance_q31 pCfft; /< points to the complex FFT instance. /
AnnaBridge	146:22da6e220af6	2206	} arm_rfft_instance_q31;
AnnaBridge	146:22da6e220af6	2207
AnnaBridge	146:22da6e220af6	2208	arm_status arm_rfft_init_q31(
AnnaBridge	146:22da6e220af6	2209	arm_rfft_instance_q31 * S,
AnnaBridge	146:22da6e220af6	2210	uint32_t fftLenReal,
AnnaBridge	146:22da6e220af6	2211	uint32_t ifftFlagR,
AnnaBridge	146:22da6e220af6	2212	uint32_t bitReverseFlag);
AnnaBridge	146:22da6e220af6	2213
AnnaBridge	146:22da6e220af6	2214	void arm_rfft_q31(
AnnaBridge	146:22da6e220af6	2215	const arm_rfft_instance_q31 * S,
AnnaBridge	146:22da6e220af6	2216	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	2217	q31_t * pDst);
AnnaBridge	146:22da6e220af6	2218
AnnaBridge	146:22da6e220af6	2219	/**
AnnaBridge	146:22da6e220af6	2220	* @brief Instance structure for the floating-point RFFT/RIFFT function.
AnnaBridge	146:22da6e220af6	2221	*/
AnnaBridge	146:22da6e220af6	2222	typedef struct
AnnaBridge	146:22da6e220af6	2223	{
AnnaBridge	146:22da6e220af6	2224	uint32_t fftLenReal; /*< length of the real FFT. /
AnnaBridge	146:22da6e220af6	2225	uint16_t fftLenBy2; /*< length of the complex FFT. /
AnnaBridge	146:22da6e220af6	2226	uint8_t ifftFlagR; /*< flag that selects forward (ifftFlagR=0) or inverse (ifftFlagR=1) transform. /
AnnaBridge	146:22da6e220af6	2227	uint8_t bitReverseFlagR; /*< flag that enables (bitReverseFlagR=1) or disables (bitReverseFlagR=0) bit reversal of output. /
AnnaBridge	146:22da6e220af6	2228	uint32_t twidCoefRModifier; /*< twiddle coefficient modifier that supports different size FFTs with the same twiddle factor table. /
AnnaBridge	146:22da6e220af6	2229	float32_t pTwiddleAReal; /< points to the real twiddle factor table. /
AnnaBridge	146:22da6e220af6	2230	float32_t pTwiddleBReal; /< points to the imag twiddle factor table. /
AnnaBridge	146:22da6e220af6	2231	arm_cfft_radix4_instance_f32 pCfft; /< points to the complex FFT instance. /
AnnaBridge	146:22da6e220af6	2232	} arm_rfft_instance_f32;
AnnaBridge	146:22da6e220af6	2233
AnnaBridge	146:22da6e220af6	2234	arm_status arm_rfft_init_f32(
AnnaBridge	146:22da6e220af6	2235	arm_rfft_instance_f32 * S,
AnnaBridge	146:22da6e220af6	2236	arm_cfft_radix4_instance_f32 * S_CFFT,
AnnaBridge	146:22da6e220af6	2237	uint32_t fftLenReal,
AnnaBridge	146:22da6e220af6	2238	uint32_t ifftFlagR,
AnnaBridge	146:22da6e220af6	2239	uint32_t bitReverseFlag);
AnnaBridge	146:22da6e220af6	2240
AnnaBridge	146:22da6e220af6	2241	void arm_rfft_f32(
AnnaBridge	146:22da6e220af6	2242	const arm_rfft_instance_f32 * S,
AnnaBridge	146:22da6e220af6	2243	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	2244	float32_t * pDst);
AnnaBridge	146:22da6e220af6	2245
AnnaBridge	146:22da6e220af6	2246	/**
AnnaBridge	146:22da6e220af6	2247	* @brief Instance structure for the floating-point RFFT/RIFFT function.
AnnaBridge	146:22da6e220af6	2248	*/
AnnaBridge	146:22da6e220af6	2249	typedef struct
AnnaBridge	146:22da6e220af6	2250	{
AnnaBridge	146:22da6e220af6	2251	arm_cfft_instance_f32 Sint; /*< Internal CFFT structure. /
AnnaBridge	146:22da6e220af6	2252	uint16_t fftLenRFFT; /*< length of the real sequence /
AnnaBridge	146:22da6e220af6	2253	float32_t * pTwiddleRFFT; /*< Twiddle factors real stage /
AnnaBridge	146:22da6e220af6	2254	} arm_rfft_fast_instance_f32 ;
AnnaBridge	146:22da6e220af6	2255
AnnaBridge	146:22da6e220af6	2256	arm_status arm_rfft_fast_init_f32 (
AnnaBridge	146:22da6e220af6	2257	arm_rfft_fast_instance_f32 * S,
AnnaBridge	146:22da6e220af6	2258	uint16_t fftLen);
AnnaBridge	146:22da6e220af6	2259
AnnaBridge	146:22da6e220af6	2260	void arm_rfft_fast_f32(
AnnaBridge	146:22da6e220af6	2261	arm_rfft_fast_instance_f32 * S,
AnnaBridge	146:22da6e220af6	2262	float32_t * p, float32_t * pOut,
AnnaBridge	146:22da6e220af6	2263	uint8_t ifftFlag);
AnnaBridge	146:22da6e220af6	2264
AnnaBridge	146:22da6e220af6	2265	/**
AnnaBridge	146:22da6e220af6	2266	* @brief Instance structure for the floating-point DCT4/IDCT4 function.
AnnaBridge	146:22da6e220af6	2267	*/
AnnaBridge	146:22da6e220af6	2268	typedef struct
AnnaBridge	146:22da6e220af6	2269	{
AnnaBridge	146:22da6e220af6	2270	uint16_t N; /*< length of the DCT4. /
AnnaBridge	146:22da6e220af6	2271	uint16_t Nby2; /*< half of the length of the DCT4. /
AnnaBridge	146:22da6e220af6	2272	float32_t normalize; /*< normalizing factor. /
AnnaBridge	146:22da6e220af6	2273	float32_t pTwiddle; /< points to the twiddle factor table. /
AnnaBridge	146:22da6e220af6	2274	float32_t pCosFactor; /< points to the cosFactor table. /
AnnaBridge	146:22da6e220af6	2275	arm_rfft_instance_f32 pRfft; /< points to the real FFT instance. /
AnnaBridge	146:22da6e220af6	2276	arm_cfft_radix4_instance_f32 pCfft; /< points to the complex FFT instance. /
AnnaBridge	146:22da6e220af6	2277	} arm_dct4_instance_f32;
AnnaBridge	146:22da6e220af6	2278
AnnaBridge	146:22da6e220af6	2279
AnnaBridge	146:22da6e220af6	2280	/**
AnnaBridge	146:22da6e220af6	2281	* @brief Initialization function for the floating-point DCT4/IDCT4.
AnnaBridge	146:22da6e220af6	2282	* @param[in,out] S points to an instance of floating-point DCT4/IDCT4 structure.
AnnaBridge	146:22da6e220af6	2283	* @param[in] S_RFFT points to an instance of floating-point RFFT/RIFFT structure.
AnnaBridge	146:22da6e220af6	2284	* @param[in] S_CFFT points to an instance of floating-point CFFT/CIFFT structure.
AnnaBridge	146:22da6e220af6	2285	* @param[in] N length of the DCT4.
AnnaBridge	146:22da6e220af6	2286	* @param[in] Nby2 half of the length of the DCT4.
AnnaBridge	146:22da6e220af6	2287	* @param[in] normalize normalizing factor.
AnnaBridge	146:22da6e220af6	2288	* @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if <code>fftLenReal</code> is not a supported transform length.
AnnaBridge	146:22da6e220af6	2289	*/
AnnaBridge	146:22da6e220af6	2290	arm_status arm_dct4_init_f32(
AnnaBridge	146:22da6e220af6	2291	arm_dct4_instance_f32 * S,
AnnaBridge	146:22da6e220af6	2292	arm_rfft_instance_f32 * S_RFFT,
AnnaBridge	146:22da6e220af6	2293	arm_cfft_radix4_instance_f32 * S_CFFT,
AnnaBridge	146:22da6e220af6	2294	uint16_t N,
AnnaBridge	146:22da6e220af6	2295	uint16_t Nby2,
AnnaBridge	146:22da6e220af6	2296	float32_t normalize);
AnnaBridge	146:22da6e220af6	2297
AnnaBridge	146:22da6e220af6	2298
AnnaBridge	146:22da6e220af6	2299	/**
AnnaBridge	146:22da6e220af6	2300	* @brief Processing function for the floating-point DCT4/IDCT4.
AnnaBridge	146:22da6e220af6	2301	* @param[in] S points to an instance of the floating-point DCT4/IDCT4 structure.
AnnaBridge	146:22da6e220af6	2302	* @param[in] pState points to state buffer.
AnnaBridge	146:22da6e220af6	2303	* @param[in,out] pInlineBuffer points to the in-place input and output buffer.
AnnaBridge	146:22da6e220af6	2304	*/
AnnaBridge	146:22da6e220af6	2305	void arm_dct4_f32(
AnnaBridge	146:22da6e220af6	2306	const arm_dct4_instance_f32 * S,
AnnaBridge	146:22da6e220af6	2307	float32_t * pState,
AnnaBridge	146:22da6e220af6	2308	float32_t * pInlineBuffer);
AnnaBridge	146:22da6e220af6	2309
AnnaBridge	146:22da6e220af6	2310
AnnaBridge	146:22da6e220af6	2311	/**
AnnaBridge	146:22da6e220af6	2312	* @brief Instance structure for the Q31 DCT4/IDCT4 function.
AnnaBridge	146:22da6e220af6	2313	*/
AnnaBridge	146:22da6e220af6	2314	typedef struct
AnnaBridge	146:22da6e220af6	2315	{
AnnaBridge	146:22da6e220af6	2316	uint16_t N; /*< length of the DCT4. /
AnnaBridge	146:22da6e220af6	2317	uint16_t Nby2; /*< half of the length of the DCT4. /
AnnaBridge	146:22da6e220af6	2318	q31_t normalize; /*< normalizing factor. /
AnnaBridge	146:22da6e220af6	2319	q31_t pTwiddle; /< points to the twiddle factor table. /
AnnaBridge	146:22da6e220af6	2320	q31_t pCosFactor; /< points to the cosFactor table. /
AnnaBridge	146:22da6e220af6	2321	arm_rfft_instance_q31 pRfft; /< points to the real FFT instance. /
AnnaBridge	146:22da6e220af6	2322	arm_cfft_radix4_instance_q31 pCfft; /< points to the complex FFT instance. /
AnnaBridge	146:22da6e220af6	2323	} arm_dct4_instance_q31;
AnnaBridge	146:22da6e220af6	2324
AnnaBridge	146:22da6e220af6	2325
AnnaBridge	146:22da6e220af6	2326	/**
AnnaBridge	146:22da6e220af6	2327	* @brief Initialization function for the Q31 DCT4/IDCT4.
AnnaBridge	146:22da6e220af6	2328	* @param[in,out] S points to an instance of Q31 DCT4/IDCT4 structure.
AnnaBridge	146:22da6e220af6	2329	* @param[in] S_RFFT points to an instance of Q31 RFFT/RIFFT structure
AnnaBridge	146:22da6e220af6	2330	* @param[in] S_CFFT points to an instance of Q31 CFFT/CIFFT structure
AnnaBridge	146:22da6e220af6	2331	* @param[in] N length of the DCT4.
AnnaBridge	146:22da6e220af6	2332	* @param[in] Nby2 half of the length of the DCT4.
AnnaBridge	146:22da6e220af6	2333	* @param[in] normalize normalizing factor.
AnnaBridge	146:22da6e220af6	2334	* @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if <code>N</code> is not a supported transform length.
AnnaBridge	146:22da6e220af6	2335	*/
AnnaBridge	146:22da6e220af6	2336	arm_status arm_dct4_init_q31(
AnnaBridge	146:22da6e220af6	2337	arm_dct4_instance_q31 * S,
AnnaBridge	146:22da6e220af6	2338	arm_rfft_instance_q31 * S_RFFT,
AnnaBridge	146:22da6e220af6	2339	arm_cfft_radix4_instance_q31 * S_CFFT,
AnnaBridge	146:22da6e220af6	2340	uint16_t N,
AnnaBridge	146:22da6e220af6	2341	uint16_t Nby2,
AnnaBridge	146:22da6e220af6	2342	q31_t normalize);
AnnaBridge	146:22da6e220af6	2343
AnnaBridge	146:22da6e220af6	2344
AnnaBridge	146:22da6e220af6	2345	/**
AnnaBridge	146:22da6e220af6	2346	* @brief Processing function for the Q31 DCT4/IDCT4.
AnnaBridge	146:22da6e220af6	2347	* @param[in] S points to an instance of the Q31 DCT4 structure.
AnnaBridge	146:22da6e220af6	2348	* @param[in] pState points to state buffer.
AnnaBridge	146:22da6e220af6	2349	* @param[in,out] pInlineBuffer points to the in-place input and output buffer.
AnnaBridge	146:22da6e220af6	2350	*/
AnnaBridge	146:22da6e220af6	2351	void arm_dct4_q31(
AnnaBridge	146:22da6e220af6	2352	const arm_dct4_instance_q31 * S,
AnnaBridge	146:22da6e220af6	2353	q31_t * pState,
AnnaBridge	146:22da6e220af6	2354	q31_t * pInlineBuffer);
AnnaBridge	146:22da6e220af6	2355
AnnaBridge	146:22da6e220af6	2356
AnnaBridge	146:22da6e220af6	2357	/**
AnnaBridge	146:22da6e220af6	2358	* @brief Instance structure for the Q15 DCT4/IDCT4 function.
AnnaBridge	146:22da6e220af6	2359	*/
AnnaBridge	146:22da6e220af6	2360	typedef struct
AnnaBridge	146:22da6e220af6	2361	{
AnnaBridge	146:22da6e220af6	2362	uint16_t N; /*< length of the DCT4. /
AnnaBridge	146:22da6e220af6	2363	uint16_t Nby2; /*< half of the length of the DCT4. /
AnnaBridge	146:22da6e220af6	2364	q15_t normalize; /*< normalizing factor. /
AnnaBridge	146:22da6e220af6	2365	q15_t pTwiddle; /< points to the twiddle factor table. /
AnnaBridge	146:22da6e220af6	2366	q15_t pCosFactor; /< points to the cosFactor table. /
AnnaBridge	146:22da6e220af6	2367	arm_rfft_instance_q15 pRfft; /< points to the real FFT instance. /
AnnaBridge	146:22da6e220af6	2368	arm_cfft_radix4_instance_q15 pCfft; /< points to the complex FFT instance. /
AnnaBridge	146:22da6e220af6	2369	} arm_dct4_instance_q15;
AnnaBridge	146:22da6e220af6	2370
AnnaBridge	146:22da6e220af6	2371
AnnaBridge	146:22da6e220af6	2372	/**
AnnaBridge	146:22da6e220af6	2373	* @brief Initialization function for the Q15 DCT4/IDCT4.
AnnaBridge	146:22da6e220af6	2374	* @param[in,out] S points to an instance of Q15 DCT4/IDCT4 structure.
AnnaBridge	146:22da6e220af6	2375	* @param[in] S_RFFT points to an instance of Q15 RFFT/RIFFT structure.
AnnaBridge	146:22da6e220af6	2376	* @param[in] S_CFFT points to an instance of Q15 CFFT/CIFFT structure.
AnnaBridge	146:22da6e220af6	2377	* @param[in] N length of the DCT4.
AnnaBridge	146:22da6e220af6	2378	* @param[in] Nby2 half of the length of the DCT4.
AnnaBridge	146:22da6e220af6	2379	* @param[in] normalize normalizing factor.
AnnaBridge	146:22da6e220af6	2380	* @return arm_status function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_ARGUMENT_ERROR if <code>N</code> is not a supported transform length.
AnnaBridge	146:22da6e220af6	2381	*/
AnnaBridge	146:22da6e220af6	2382	arm_status arm_dct4_init_q15(
AnnaBridge	146:22da6e220af6	2383	arm_dct4_instance_q15 * S,
AnnaBridge	146:22da6e220af6	2384	arm_rfft_instance_q15 * S_RFFT,
AnnaBridge	146:22da6e220af6	2385	arm_cfft_radix4_instance_q15 * S_CFFT,
AnnaBridge	146:22da6e220af6	2386	uint16_t N,
AnnaBridge	146:22da6e220af6	2387	uint16_t Nby2,
AnnaBridge	146:22da6e220af6	2388	q15_t normalize);
AnnaBridge	146:22da6e220af6	2389
AnnaBridge	146:22da6e220af6	2390
AnnaBridge	146:22da6e220af6	2391	/**
AnnaBridge	146:22da6e220af6	2392	* @brief Processing function for the Q15 DCT4/IDCT4.
AnnaBridge	146:22da6e220af6	2393	* @param[in] S points to an instance of the Q15 DCT4 structure.
AnnaBridge	146:22da6e220af6	2394	* @param[in] pState points to state buffer.
AnnaBridge	146:22da6e220af6	2395	* @param[in,out] pInlineBuffer points to the in-place input and output buffer.
AnnaBridge	146:22da6e220af6	2396	*/
AnnaBridge	146:22da6e220af6	2397	void arm_dct4_q15(
AnnaBridge	146:22da6e220af6	2398	const arm_dct4_instance_q15 * S,
AnnaBridge	146:22da6e220af6	2399	q15_t * pState,
AnnaBridge	146:22da6e220af6	2400	q15_t * pInlineBuffer);
AnnaBridge	146:22da6e220af6	2401
AnnaBridge	146:22da6e220af6	2402
AnnaBridge	146:22da6e220af6	2403	/**
AnnaBridge	146:22da6e220af6	2404	* @brief Floating-point vector addition.
AnnaBridge	146:22da6e220af6	2405	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	2406	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	2407	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2408	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2409	*/
AnnaBridge	146:22da6e220af6	2410	void arm_add_f32(
AnnaBridge	146:22da6e220af6	2411	float32_t * pSrcA,
AnnaBridge	146:22da6e220af6	2412	float32_t * pSrcB,
AnnaBridge	146:22da6e220af6	2413	float32_t * pDst,
AnnaBridge	146:22da6e220af6	2414	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2415
AnnaBridge	146:22da6e220af6	2416
AnnaBridge	146:22da6e220af6	2417	/**
AnnaBridge	146:22da6e220af6	2418	* @brief Q7 vector addition.
AnnaBridge	146:22da6e220af6	2419	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	2420	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	2421	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2422	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2423	*/
AnnaBridge	146:22da6e220af6	2424	void arm_add_q7(
AnnaBridge	146:22da6e220af6	2425	q7_t * pSrcA,
AnnaBridge	146:22da6e220af6	2426	q7_t * pSrcB,
AnnaBridge	146:22da6e220af6	2427	q7_t * pDst,
AnnaBridge	146:22da6e220af6	2428	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2429
AnnaBridge	146:22da6e220af6	2430
AnnaBridge	146:22da6e220af6	2431	/**
AnnaBridge	146:22da6e220af6	2432	* @brief Q15 vector addition.
AnnaBridge	146:22da6e220af6	2433	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	2434	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	2435	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2436	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2437	*/
AnnaBridge	146:22da6e220af6	2438	void arm_add_q15(
AnnaBridge	146:22da6e220af6	2439	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	2440	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	2441	q15_t * pDst,
AnnaBridge	146:22da6e220af6	2442	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2443
AnnaBridge	146:22da6e220af6	2444
AnnaBridge	146:22da6e220af6	2445	/**
AnnaBridge	146:22da6e220af6	2446	* @brief Q31 vector addition.
AnnaBridge	146:22da6e220af6	2447	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	2448	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	2449	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2450	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2451	*/
AnnaBridge	146:22da6e220af6	2452	void arm_add_q31(
AnnaBridge	146:22da6e220af6	2453	q31_t * pSrcA,
AnnaBridge	146:22da6e220af6	2454	q31_t * pSrcB,
AnnaBridge	146:22da6e220af6	2455	q31_t * pDst,
AnnaBridge	146:22da6e220af6	2456	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2457
AnnaBridge	146:22da6e220af6	2458
AnnaBridge	146:22da6e220af6	2459	/**
AnnaBridge	146:22da6e220af6	2460	* @brief Floating-point vector subtraction.
AnnaBridge	146:22da6e220af6	2461	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	2462	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	2463	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2464	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2465	*/
AnnaBridge	146:22da6e220af6	2466	void arm_sub_f32(
AnnaBridge	146:22da6e220af6	2467	float32_t * pSrcA,
AnnaBridge	146:22da6e220af6	2468	float32_t * pSrcB,
AnnaBridge	146:22da6e220af6	2469	float32_t * pDst,
AnnaBridge	146:22da6e220af6	2470	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2471
AnnaBridge	146:22da6e220af6	2472
AnnaBridge	146:22da6e220af6	2473	/**
AnnaBridge	146:22da6e220af6	2474	* @brief Q7 vector subtraction.
AnnaBridge	146:22da6e220af6	2475	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	2476	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	2477	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2478	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2479	*/
AnnaBridge	146:22da6e220af6	2480	void arm_sub_q7(
AnnaBridge	146:22da6e220af6	2481	q7_t * pSrcA,
AnnaBridge	146:22da6e220af6	2482	q7_t * pSrcB,
AnnaBridge	146:22da6e220af6	2483	q7_t * pDst,
AnnaBridge	146:22da6e220af6	2484	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2485
AnnaBridge	146:22da6e220af6	2486
AnnaBridge	146:22da6e220af6	2487	/**
AnnaBridge	146:22da6e220af6	2488	* @brief Q15 vector subtraction.
AnnaBridge	146:22da6e220af6	2489	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	2490	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	2491	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2492	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2493	*/
AnnaBridge	146:22da6e220af6	2494	void arm_sub_q15(
AnnaBridge	146:22da6e220af6	2495	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	2496	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	2497	q15_t * pDst,
AnnaBridge	146:22da6e220af6	2498	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2499
AnnaBridge	146:22da6e220af6	2500
AnnaBridge	146:22da6e220af6	2501	/**
AnnaBridge	146:22da6e220af6	2502	* @brief Q31 vector subtraction.
AnnaBridge	146:22da6e220af6	2503	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	2504	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	2505	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2506	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2507	*/
AnnaBridge	146:22da6e220af6	2508	void arm_sub_q31(
AnnaBridge	146:22da6e220af6	2509	q31_t * pSrcA,
AnnaBridge	146:22da6e220af6	2510	q31_t * pSrcB,
AnnaBridge	146:22da6e220af6	2511	q31_t * pDst,
AnnaBridge	146:22da6e220af6	2512	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2513
AnnaBridge	146:22da6e220af6	2514
AnnaBridge	146:22da6e220af6	2515	/**
AnnaBridge	146:22da6e220af6	2516	* @brief Multiplies a floating-point vector by a scalar.
AnnaBridge	146:22da6e220af6	2517	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2518	* @param[in] scale scale factor to be applied
AnnaBridge	146:22da6e220af6	2519	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2520	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2521	*/
AnnaBridge	146:22da6e220af6	2522	void arm_scale_f32(
AnnaBridge	146:22da6e220af6	2523	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	2524	float32_t scale,
AnnaBridge	146:22da6e220af6	2525	float32_t * pDst,
AnnaBridge	146:22da6e220af6	2526	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2527
AnnaBridge	146:22da6e220af6	2528
AnnaBridge	146:22da6e220af6	2529	/**
AnnaBridge	146:22da6e220af6	2530	* @brief Multiplies a Q7 vector by a scalar.
AnnaBridge	146:22da6e220af6	2531	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2532	* @param[in] scaleFract fractional portion of the scale value
AnnaBridge	146:22da6e220af6	2533	* @param[in] shift number of bits to shift the result by
AnnaBridge	146:22da6e220af6	2534	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2535	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2536	*/
AnnaBridge	146:22da6e220af6	2537	void arm_scale_q7(
AnnaBridge	146:22da6e220af6	2538	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	2539	q7_t scaleFract,
AnnaBridge	146:22da6e220af6	2540	int8_t shift,
AnnaBridge	146:22da6e220af6	2541	q7_t * pDst,
AnnaBridge	146:22da6e220af6	2542	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2543
AnnaBridge	146:22da6e220af6	2544
AnnaBridge	146:22da6e220af6	2545	/**
AnnaBridge	146:22da6e220af6	2546	* @brief Multiplies a Q15 vector by a scalar.
AnnaBridge	146:22da6e220af6	2547	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2548	* @param[in] scaleFract fractional portion of the scale value
AnnaBridge	146:22da6e220af6	2549	* @param[in] shift number of bits to shift the result by
AnnaBridge	146:22da6e220af6	2550	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2551	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2552	*/
AnnaBridge	146:22da6e220af6	2553	void arm_scale_q15(
AnnaBridge	146:22da6e220af6	2554	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	2555	q15_t scaleFract,
AnnaBridge	146:22da6e220af6	2556	int8_t shift,
AnnaBridge	146:22da6e220af6	2557	q15_t * pDst,
AnnaBridge	146:22da6e220af6	2558	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2559
AnnaBridge	146:22da6e220af6	2560
AnnaBridge	146:22da6e220af6	2561	/**
AnnaBridge	146:22da6e220af6	2562	* @brief Multiplies a Q31 vector by a scalar.
AnnaBridge	146:22da6e220af6	2563	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2564	* @param[in] scaleFract fractional portion of the scale value
AnnaBridge	146:22da6e220af6	2565	* @param[in] shift number of bits to shift the result by
AnnaBridge	146:22da6e220af6	2566	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2567	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2568	*/
AnnaBridge	146:22da6e220af6	2569	void arm_scale_q31(
AnnaBridge	146:22da6e220af6	2570	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	2571	q31_t scaleFract,
AnnaBridge	146:22da6e220af6	2572	int8_t shift,
AnnaBridge	146:22da6e220af6	2573	q31_t * pDst,
AnnaBridge	146:22da6e220af6	2574	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2575
AnnaBridge	146:22da6e220af6	2576
AnnaBridge	146:22da6e220af6	2577	/**
AnnaBridge	146:22da6e220af6	2578	* @brief Q7 vector absolute value.
AnnaBridge	146:22da6e220af6	2579	* @param[in] pSrc points to the input buffer
AnnaBridge	146:22da6e220af6	2580	* @param[out] pDst points to the output buffer
AnnaBridge	146:22da6e220af6	2581	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2582	*/
AnnaBridge	146:22da6e220af6	2583	void arm_abs_q7(
AnnaBridge	146:22da6e220af6	2584	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	2585	q7_t * pDst,
AnnaBridge	146:22da6e220af6	2586	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2587
AnnaBridge	146:22da6e220af6	2588
AnnaBridge	146:22da6e220af6	2589	/**
AnnaBridge	146:22da6e220af6	2590	* @brief Floating-point vector absolute value.
AnnaBridge	146:22da6e220af6	2591	* @param[in] pSrc points to the input buffer
AnnaBridge	146:22da6e220af6	2592	* @param[out] pDst points to the output buffer
AnnaBridge	146:22da6e220af6	2593	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2594	*/
AnnaBridge	146:22da6e220af6	2595	void arm_abs_f32(
AnnaBridge	146:22da6e220af6	2596	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	2597	float32_t * pDst,
AnnaBridge	146:22da6e220af6	2598	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2599
AnnaBridge	146:22da6e220af6	2600
AnnaBridge	146:22da6e220af6	2601	/**
AnnaBridge	146:22da6e220af6	2602	* @brief Q15 vector absolute value.
AnnaBridge	146:22da6e220af6	2603	* @param[in] pSrc points to the input buffer
AnnaBridge	146:22da6e220af6	2604	* @param[out] pDst points to the output buffer
AnnaBridge	146:22da6e220af6	2605	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2606	*/
AnnaBridge	146:22da6e220af6	2607	void arm_abs_q15(
AnnaBridge	146:22da6e220af6	2608	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	2609	q15_t * pDst,
AnnaBridge	146:22da6e220af6	2610	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2611
AnnaBridge	146:22da6e220af6	2612
AnnaBridge	146:22da6e220af6	2613	/**
AnnaBridge	146:22da6e220af6	2614	* @brief Q31 vector absolute value.
AnnaBridge	146:22da6e220af6	2615	* @param[in] pSrc points to the input buffer
AnnaBridge	146:22da6e220af6	2616	* @param[out] pDst points to the output buffer
AnnaBridge	146:22da6e220af6	2617	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2618	*/
AnnaBridge	146:22da6e220af6	2619	void arm_abs_q31(
AnnaBridge	146:22da6e220af6	2620	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	2621	q31_t * pDst,
AnnaBridge	146:22da6e220af6	2622	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2623
AnnaBridge	146:22da6e220af6	2624
AnnaBridge	146:22da6e220af6	2625	/**
AnnaBridge	146:22da6e220af6	2626	* @brief Dot product of floating-point vectors.
AnnaBridge	146:22da6e220af6	2627	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	2628	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	2629	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2630	* @param[out] result output result returned here
AnnaBridge	146:22da6e220af6	2631	*/
AnnaBridge	146:22da6e220af6	2632	void arm_dot_prod_f32(
AnnaBridge	146:22da6e220af6	2633	float32_t * pSrcA,
AnnaBridge	146:22da6e220af6	2634	float32_t * pSrcB,
AnnaBridge	146:22da6e220af6	2635	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	2636	float32_t * result);
AnnaBridge	146:22da6e220af6	2637
AnnaBridge	146:22da6e220af6	2638
AnnaBridge	146:22da6e220af6	2639	/**
AnnaBridge	146:22da6e220af6	2640	* @brief Dot product of Q7 vectors.
AnnaBridge	146:22da6e220af6	2641	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	2642	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	2643	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2644	* @param[out] result output result returned here
AnnaBridge	146:22da6e220af6	2645	*/
AnnaBridge	146:22da6e220af6	2646	void arm_dot_prod_q7(
AnnaBridge	146:22da6e220af6	2647	q7_t * pSrcA,
AnnaBridge	146:22da6e220af6	2648	q7_t * pSrcB,
AnnaBridge	146:22da6e220af6	2649	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	2650	q31_t * result);
AnnaBridge	146:22da6e220af6	2651
AnnaBridge	146:22da6e220af6	2652
AnnaBridge	146:22da6e220af6	2653	/**
AnnaBridge	146:22da6e220af6	2654	* @brief Dot product of Q15 vectors.
AnnaBridge	146:22da6e220af6	2655	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	2656	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	2657	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2658	* @param[out] result output result returned here
AnnaBridge	146:22da6e220af6	2659	*/
AnnaBridge	146:22da6e220af6	2660	void arm_dot_prod_q15(
AnnaBridge	146:22da6e220af6	2661	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	2662	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	2663	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	2664	q63_t * result);
AnnaBridge	146:22da6e220af6	2665
AnnaBridge	146:22da6e220af6	2666
AnnaBridge	146:22da6e220af6	2667	/**
AnnaBridge	146:22da6e220af6	2668	* @brief Dot product of Q31 vectors.
AnnaBridge	146:22da6e220af6	2669	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	2670	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	2671	* @param[in] blockSize number of samples in each vector
AnnaBridge	146:22da6e220af6	2672	* @param[out] result output result returned here
AnnaBridge	146:22da6e220af6	2673	*/
AnnaBridge	146:22da6e220af6	2674	void arm_dot_prod_q31(
AnnaBridge	146:22da6e220af6	2675	q31_t * pSrcA,
AnnaBridge	146:22da6e220af6	2676	q31_t * pSrcB,
AnnaBridge	146:22da6e220af6	2677	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	2678	q63_t * result);
AnnaBridge	146:22da6e220af6	2679
AnnaBridge	146:22da6e220af6	2680
AnnaBridge	146:22da6e220af6	2681	/**
AnnaBridge	146:22da6e220af6	2682	* @brief Shifts the elements of a Q7 vector a specified number of bits.
AnnaBridge	146:22da6e220af6	2683	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2684	* @param[in] shiftBits number of bits to shift. A positive value shifts left; a negative value shifts right.
AnnaBridge	146:22da6e220af6	2685	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2686	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2687	*/
AnnaBridge	146:22da6e220af6	2688	void arm_shift_q7(
AnnaBridge	146:22da6e220af6	2689	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	2690	int8_t shiftBits,
AnnaBridge	146:22da6e220af6	2691	q7_t * pDst,
AnnaBridge	146:22da6e220af6	2692	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2693
AnnaBridge	146:22da6e220af6	2694
AnnaBridge	146:22da6e220af6	2695	/**
AnnaBridge	146:22da6e220af6	2696	* @brief Shifts the elements of a Q15 vector a specified number of bits.
AnnaBridge	146:22da6e220af6	2697	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2698	* @param[in] shiftBits number of bits to shift. A positive value shifts left; a negative value shifts right.
AnnaBridge	146:22da6e220af6	2699	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2700	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2701	*/
AnnaBridge	146:22da6e220af6	2702	void arm_shift_q15(
AnnaBridge	146:22da6e220af6	2703	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	2704	int8_t shiftBits,
AnnaBridge	146:22da6e220af6	2705	q15_t * pDst,
AnnaBridge	146:22da6e220af6	2706	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2707
AnnaBridge	146:22da6e220af6	2708
AnnaBridge	146:22da6e220af6	2709	/**
AnnaBridge	146:22da6e220af6	2710	* @brief Shifts the elements of a Q31 vector a specified number of bits.
AnnaBridge	146:22da6e220af6	2711	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2712	* @param[in] shiftBits number of bits to shift. A positive value shifts left; a negative value shifts right.
AnnaBridge	146:22da6e220af6	2713	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2714	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2715	*/
AnnaBridge	146:22da6e220af6	2716	void arm_shift_q31(
AnnaBridge	146:22da6e220af6	2717	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	2718	int8_t shiftBits,
AnnaBridge	146:22da6e220af6	2719	q31_t * pDst,
AnnaBridge	146:22da6e220af6	2720	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2721
AnnaBridge	146:22da6e220af6	2722
AnnaBridge	146:22da6e220af6	2723	/**
AnnaBridge	146:22da6e220af6	2724	* @brief Adds a constant offset to a floating-point vector.
AnnaBridge	146:22da6e220af6	2725	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2726	* @param[in] offset is the offset to be added
AnnaBridge	146:22da6e220af6	2727	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2728	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2729	*/
AnnaBridge	146:22da6e220af6	2730	void arm_offset_f32(
AnnaBridge	146:22da6e220af6	2731	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	2732	float32_t offset,
AnnaBridge	146:22da6e220af6	2733	float32_t * pDst,
AnnaBridge	146:22da6e220af6	2734	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2735
AnnaBridge	146:22da6e220af6	2736
AnnaBridge	146:22da6e220af6	2737	/**
AnnaBridge	146:22da6e220af6	2738	* @brief Adds a constant offset to a Q7 vector.
AnnaBridge	146:22da6e220af6	2739	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2740	* @param[in] offset is the offset to be added
AnnaBridge	146:22da6e220af6	2741	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2742	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2743	*/
AnnaBridge	146:22da6e220af6	2744	void arm_offset_q7(
AnnaBridge	146:22da6e220af6	2745	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	2746	q7_t offset,
AnnaBridge	146:22da6e220af6	2747	q7_t * pDst,
AnnaBridge	146:22da6e220af6	2748	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2749
AnnaBridge	146:22da6e220af6	2750
AnnaBridge	146:22da6e220af6	2751	/**
AnnaBridge	146:22da6e220af6	2752	* @brief Adds a constant offset to a Q15 vector.
AnnaBridge	146:22da6e220af6	2753	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2754	* @param[in] offset is the offset to be added
AnnaBridge	146:22da6e220af6	2755	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2756	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2757	*/
AnnaBridge	146:22da6e220af6	2758	void arm_offset_q15(
AnnaBridge	146:22da6e220af6	2759	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	2760	q15_t offset,
AnnaBridge	146:22da6e220af6	2761	q15_t * pDst,
AnnaBridge	146:22da6e220af6	2762	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2763
AnnaBridge	146:22da6e220af6	2764
AnnaBridge	146:22da6e220af6	2765	/**
AnnaBridge	146:22da6e220af6	2766	* @brief Adds a constant offset to a Q31 vector.
AnnaBridge	146:22da6e220af6	2767	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2768	* @param[in] offset is the offset to be added
AnnaBridge	146:22da6e220af6	2769	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2770	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2771	*/
AnnaBridge	146:22da6e220af6	2772	void arm_offset_q31(
AnnaBridge	146:22da6e220af6	2773	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	2774	q31_t offset,
AnnaBridge	146:22da6e220af6	2775	q31_t * pDst,
AnnaBridge	146:22da6e220af6	2776	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2777
AnnaBridge	146:22da6e220af6	2778
AnnaBridge	146:22da6e220af6	2779	/**
AnnaBridge	146:22da6e220af6	2780	* @brief Negates the elements of a floating-point vector.
AnnaBridge	146:22da6e220af6	2781	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2782	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2783	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2784	*/
AnnaBridge	146:22da6e220af6	2785	void arm_negate_f32(
AnnaBridge	146:22da6e220af6	2786	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	2787	float32_t * pDst,
AnnaBridge	146:22da6e220af6	2788	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2789
AnnaBridge	146:22da6e220af6	2790
AnnaBridge	146:22da6e220af6	2791	/**
AnnaBridge	146:22da6e220af6	2792	* @brief Negates the elements of a Q7 vector.
AnnaBridge	146:22da6e220af6	2793	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2794	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2795	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2796	*/
AnnaBridge	146:22da6e220af6	2797	void arm_negate_q7(
AnnaBridge	146:22da6e220af6	2798	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	2799	q7_t * pDst,
AnnaBridge	146:22da6e220af6	2800	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2801
AnnaBridge	146:22da6e220af6	2802
AnnaBridge	146:22da6e220af6	2803	/**
AnnaBridge	146:22da6e220af6	2804	* @brief Negates the elements of a Q15 vector.
AnnaBridge	146:22da6e220af6	2805	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2806	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2807	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2808	*/
AnnaBridge	146:22da6e220af6	2809	void arm_negate_q15(
AnnaBridge	146:22da6e220af6	2810	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	2811	q15_t * pDst,
AnnaBridge	146:22da6e220af6	2812	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2813
AnnaBridge	146:22da6e220af6	2814
AnnaBridge	146:22da6e220af6	2815	/**
AnnaBridge	146:22da6e220af6	2816	* @brief Negates the elements of a Q31 vector.
AnnaBridge	146:22da6e220af6	2817	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	2818	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	2819	* @param[in] blockSize number of samples in the vector
AnnaBridge	146:22da6e220af6	2820	*/
AnnaBridge	146:22da6e220af6	2821	void arm_negate_q31(
AnnaBridge	146:22da6e220af6	2822	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	2823	q31_t * pDst,
AnnaBridge	146:22da6e220af6	2824	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2825
AnnaBridge	146:22da6e220af6	2826
AnnaBridge	146:22da6e220af6	2827	/**
AnnaBridge	146:22da6e220af6	2828	* @brief Copies the elements of a floating-point vector.
AnnaBridge	146:22da6e220af6	2829	* @param[in] pSrc input pointer
AnnaBridge	146:22da6e220af6	2830	* @param[out] pDst output pointer
AnnaBridge	146:22da6e220af6	2831	* @param[in] blockSize number of samples to process
AnnaBridge	146:22da6e220af6	2832	*/
AnnaBridge	146:22da6e220af6	2833	void arm_copy_f32(
AnnaBridge	146:22da6e220af6	2834	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	2835	float32_t * pDst,
AnnaBridge	146:22da6e220af6	2836	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2837
AnnaBridge	146:22da6e220af6	2838
AnnaBridge	146:22da6e220af6	2839	/**
AnnaBridge	146:22da6e220af6	2840	* @brief Copies the elements of a Q7 vector.
AnnaBridge	146:22da6e220af6	2841	* @param[in] pSrc input pointer
AnnaBridge	146:22da6e220af6	2842	* @param[out] pDst output pointer
AnnaBridge	146:22da6e220af6	2843	* @param[in] blockSize number of samples to process
AnnaBridge	146:22da6e220af6	2844	*/
AnnaBridge	146:22da6e220af6	2845	void arm_copy_q7(
AnnaBridge	146:22da6e220af6	2846	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	2847	q7_t * pDst,
AnnaBridge	146:22da6e220af6	2848	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2849
AnnaBridge	146:22da6e220af6	2850
AnnaBridge	146:22da6e220af6	2851	/**
AnnaBridge	146:22da6e220af6	2852	* @brief Copies the elements of a Q15 vector.
AnnaBridge	146:22da6e220af6	2853	* @param[in] pSrc input pointer
AnnaBridge	146:22da6e220af6	2854	* @param[out] pDst output pointer
AnnaBridge	146:22da6e220af6	2855	* @param[in] blockSize number of samples to process
AnnaBridge	146:22da6e220af6	2856	*/
AnnaBridge	146:22da6e220af6	2857	void arm_copy_q15(
AnnaBridge	146:22da6e220af6	2858	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	2859	q15_t * pDst,
AnnaBridge	146:22da6e220af6	2860	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2861
AnnaBridge	146:22da6e220af6	2862
AnnaBridge	146:22da6e220af6	2863	/**
AnnaBridge	146:22da6e220af6	2864	* @brief Copies the elements of a Q31 vector.
AnnaBridge	146:22da6e220af6	2865	* @param[in] pSrc input pointer
AnnaBridge	146:22da6e220af6	2866	* @param[out] pDst output pointer
AnnaBridge	146:22da6e220af6	2867	* @param[in] blockSize number of samples to process
AnnaBridge	146:22da6e220af6	2868	*/
AnnaBridge	146:22da6e220af6	2869	void arm_copy_q31(
AnnaBridge	146:22da6e220af6	2870	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	2871	q31_t * pDst,
AnnaBridge	146:22da6e220af6	2872	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2873
AnnaBridge	146:22da6e220af6	2874
AnnaBridge	146:22da6e220af6	2875	/**
AnnaBridge	146:22da6e220af6	2876	* @brief Fills a constant value into a floating-point vector.
AnnaBridge	146:22da6e220af6	2877	* @param[in] value input value to be filled
AnnaBridge	146:22da6e220af6	2878	* @param[out] pDst output pointer
AnnaBridge	146:22da6e220af6	2879	* @param[in] blockSize number of samples to process
AnnaBridge	146:22da6e220af6	2880	*/
AnnaBridge	146:22da6e220af6	2881	void arm_fill_f32(
AnnaBridge	146:22da6e220af6	2882	float32_t value,
AnnaBridge	146:22da6e220af6	2883	float32_t * pDst,
AnnaBridge	146:22da6e220af6	2884	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2885
AnnaBridge	146:22da6e220af6	2886
AnnaBridge	146:22da6e220af6	2887	/**
AnnaBridge	146:22da6e220af6	2888	* @brief Fills a constant value into a Q7 vector.
AnnaBridge	146:22da6e220af6	2889	* @param[in] value input value to be filled
AnnaBridge	146:22da6e220af6	2890	* @param[out] pDst output pointer
AnnaBridge	146:22da6e220af6	2891	* @param[in] blockSize number of samples to process
AnnaBridge	146:22da6e220af6	2892	*/
AnnaBridge	146:22da6e220af6	2893	void arm_fill_q7(
AnnaBridge	146:22da6e220af6	2894	q7_t value,
AnnaBridge	146:22da6e220af6	2895	q7_t * pDst,
AnnaBridge	146:22da6e220af6	2896	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2897
AnnaBridge	146:22da6e220af6	2898
AnnaBridge	146:22da6e220af6	2899	/**
AnnaBridge	146:22da6e220af6	2900	* @brief Fills a constant value into a Q15 vector.
AnnaBridge	146:22da6e220af6	2901	* @param[in] value input value to be filled
AnnaBridge	146:22da6e220af6	2902	* @param[out] pDst output pointer
AnnaBridge	146:22da6e220af6	2903	* @param[in] blockSize number of samples to process
AnnaBridge	146:22da6e220af6	2904	*/
AnnaBridge	146:22da6e220af6	2905	void arm_fill_q15(
AnnaBridge	146:22da6e220af6	2906	q15_t value,
AnnaBridge	146:22da6e220af6	2907	q15_t * pDst,
AnnaBridge	146:22da6e220af6	2908	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2909
AnnaBridge	146:22da6e220af6	2910
AnnaBridge	146:22da6e220af6	2911	/**
AnnaBridge	146:22da6e220af6	2912	* @brief Fills a constant value into a Q31 vector.
AnnaBridge	146:22da6e220af6	2913	* @param[in] value input value to be filled
AnnaBridge	146:22da6e220af6	2914	* @param[out] pDst output pointer
AnnaBridge	146:22da6e220af6	2915	* @param[in] blockSize number of samples to process
AnnaBridge	146:22da6e220af6	2916	*/
AnnaBridge	146:22da6e220af6	2917	void arm_fill_q31(
AnnaBridge	146:22da6e220af6	2918	q31_t value,
AnnaBridge	146:22da6e220af6	2919	q31_t * pDst,
AnnaBridge	146:22da6e220af6	2920	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	2921
AnnaBridge	146:22da6e220af6	2922
AnnaBridge	146:22da6e220af6	2923	/**
AnnaBridge	146:22da6e220af6	2924	* @brief Convolution of floating-point sequences.
AnnaBridge	146:22da6e220af6	2925	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	2926	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	2927	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	2928	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	2929	* @param[out] pDst points to the location where the output result is written. Length srcALen+srcBLen-1.
AnnaBridge	146:22da6e220af6	2930	*/
AnnaBridge	146:22da6e220af6	2931	void arm_conv_f32(
AnnaBridge	146:22da6e220af6	2932	float32_t * pSrcA,
AnnaBridge	146:22da6e220af6	2933	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	2934	float32_t * pSrcB,
AnnaBridge	146:22da6e220af6	2935	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	2936	float32_t * pDst);
AnnaBridge	146:22da6e220af6	2937
AnnaBridge	146:22da6e220af6	2938
AnnaBridge	146:22da6e220af6	2939	/**
AnnaBridge	146:22da6e220af6	2940	* @brief Convolution of Q15 sequences.
AnnaBridge	146:22da6e220af6	2941	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	2942	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	2943	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	2944	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	2945	* @param[out] pDst points to the block of output data Length srcALen+srcBLen-1.
AnnaBridge	146:22da6e220af6	2946	* @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2.
AnnaBridge	146:22da6e220af6	2947	* @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen).
AnnaBridge	146:22da6e220af6	2948	*/
AnnaBridge	146:22da6e220af6	2949	void arm_conv_opt_q15(
AnnaBridge	146:22da6e220af6	2950	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	2951	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	2952	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	2953	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	2954	q15_t * pDst,
AnnaBridge	146:22da6e220af6	2955	q15_t * pScratch1,
AnnaBridge	146:22da6e220af6	2956	q15_t * pScratch2);
AnnaBridge	146:22da6e220af6	2957
AnnaBridge	146:22da6e220af6	2958
AnnaBridge	146:22da6e220af6	2959	/**
AnnaBridge	146:22da6e220af6	2960	* @brief Convolution of Q15 sequences.
AnnaBridge	146:22da6e220af6	2961	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	2962	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	2963	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	2964	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	2965	* @param[out] pDst points to the location where the output result is written. Length srcALen+srcBLen-1.
AnnaBridge	146:22da6e220af6	2966	*/
AnnaBridge	146:22da6e220af6	2967	void arm_conv_q15(
AnnaBridge	146:22da6e220af6	2968	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	2969	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	2970	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	2971	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	2972	q15_t * pDst);
AnnaBridge	146:22da6e220af6	2973
AnnaBridge	146:22da6e220af6	2974
AnnaBridge	146:22da6e220af6	2975	/**
AnnaBridge	146:22da6e220af6	2976	* @brief Convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4
AnnaBridge	146:22da6e220af6	2977	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	2978	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	2979	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	2980	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	2981	* @param[out] pDst points to the block of output data Length srcALen+srcBLen-1.
AnnaBridge	146:22da6e220af6	2982	*/
AnnaBridge	146:22da6e220af6	2983	void arm_conv_fast_q15(
AnnaBridge	146:22da6e220af6	2984	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	2985	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	2986	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	2987	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	2988	q15_t * pDst);
AnnaBridge	146:22da6e220af6	2989
AnnaBridge	146:22da6e220af6	2990
AnnaBridge	146:22da6e220af6	2991	/**
AnnaBridge	146:22da6e220af6	2992	* @brief Convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4
AnnaBridge	146:22da6e220af6	2993	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	2994	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	2995	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	2996	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	2997	* @param[out] pDst points to the block of output data Length srcALen+srcBLen-1.
AnnaBridge	146:22da6e220af6	2998	* @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2.
AnnaBridge	146:22da6e220af6	2999	* @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen).
AnnaBridge	146:22da6e220af6	3000	*/
AnnaBridge	146:22da6e220af6	3001	void arm_conv_fast_opt_q15(
AnnaBridge	146:22da6e220af6	3002	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	3003	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3004	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	3005	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3006	q15_t * pDst,
AnnaBridge	146:22da6e220af6	3007	q15_t * pScratch1,
AnnaBridge	146:22da6e220af6	3008	q15_t * pScratch2);
AnnaBridge	146:22da6e220af6	3009
AnnaBridge	146:22da6e220af6	3010
AnnaBridge	146:22da6e220af6	3011	/**
AnnaBridge	146:22da6e220af6	3012	* @brief Convolution of Q31 sequences.
AnnaBridge	146:22da6e220af6	3013	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3014	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3015	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3016	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3017	* @param[out] pDst points to the block of output data Length srcALen+srcBLen-1.
AnnaBridge	146:22da6e220af6	3018	*/
AnnaBridge	146:22da6e220af6	3019	void arm_conv_q31(
AnnaBridge	146:22da6e220af6	3020	q31_t * pSrcA,
AnnaBridge	146:22da6e220af6	3021	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3022	q31_t * pSrcB,
AnnaBridge	146:22da6e220af6	3023	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3024	q31_t * pDst);
AnnaBridge	146:22da6e220af6	3025
AnnaBridge	146:22da6e220af6	3026
AnnaBridge	146:22da6e220af6	3027	/**
AnnaBridge	146:22da6e220af6	3028	* @brief Convolution of Q31 sequences (fast version) for Cortex-M3 and Cortex-M4
AnnaBridge	146:22da6e220af6	3029	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3030	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3031	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3032	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3033	* @param[out] pDst points to the block of output data Length srcALen+srcBLen-1.
AnnaBridge	146:22da6e220af6	3034	*/
AnnaBridge	146:22da6e220af6	3035	void arm_conv_fast_q31(
AnnaBridge	146:22da6e220af6	3036	q31_t * pSrcA,
AnnaBridge	146:22da6e220af6	3037	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3038	q31_t * pSrcB,
AnnaBridge	146:22da6e220af6	3039	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3040	q31_t * pDst);
AnnaBridge	146:22da6e220af6	3041
AnnaBridge	146:22da6e220af6	3042
AnnaBridge	146:22da6e220af6	3043	/**
AnnaBridge	146:22da6e220af6	3044	* @brief Convolution of Q7 sequences.
AnnaBridge	146:22da6e220af6	3045	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3046	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3047	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3048	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3049	* @param[out] pDst points to the block of output data Length srcALen+srcBLen-1.
AnnaBridge	146:22da6e220af6	3050	* @param[in] pScratch1 points to scratch buffer(of type q15_t) of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2.
AnnaBridge	146:22da6e220af6	3051	* @param[in] pScratch2 points to scratch buffer (of type q15_t) of size min(srcALen, srcBLen).
AnnaBridge	146:22da6e220af6	3052	*/
AnnaBridge	146:22da6e220af6	3053	void arm_conv_opt_q7(
AnnaBridge	146:22da6e220af6	3054	q7_t * pSrcA,
AnnaBridge	146:22da6e220af6	3055	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3056	q7_t * pSrcB,
AnnaBridge	146:22da6e220af6	3057	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3058	q7_t * pDst,
AnnaBridge	146:22da6e220af6	3059	q15_t * pScratch1,
AnnaBridge	146:22da6e220af6	3060	q15_t * pScratch2);
AnnaBridge	146:22da6e220af6	3061
AnnaBridge	146:22da6e220af6	3062
AnnaBridge	146:22da6e220af6	3063	/**
AnnaBridge	146:22da6e220af6	3064	* @brief Convolution of Q7 sequences.
AnnaBridge	146:22da6e220af6	3065	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3066	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3067	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3068	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3069	* @param[out] pDst points to the block of output data Length srcALen+srcBLen-1.
AnnaBridge	146:22da6e220af6	3070	*/
AnnaBridge	146:22da6e220af6	3071	void arm_conv_q7(
AnnaBridge	146:22da6e220af6	3072	q7_t * pSrcA,
AnnaBridge	146:22da6e220af6	3073	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3074	q7_t * pSrcB,
AnnaBridge	146:22da6e220af6	3075	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3076	q7_t * pDst);
AnnaBridge	146:22da6e220af6	3077
AnnaBridge	146:22da6e220af6	3078
AnnaBridge	146:22da6e220af6	3079	/**
AnnaBridge	146:22da6e220af6	3080	* @brief Partial convolution of floating-point sequences.
AnnaBridge	146:22da6e220af6	3081	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3082	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3083	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3084	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3085	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3086	* @param[in] firstIndex is the first output sample to start with.
AnnaBridge	146:22da6e220af6	3087	* @param[in] numPoints is the number of output points to be computed.
AnnaBridge	146:22da6e220af6	3088	* @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].
AnnaBridge	146:22da6e220af6	3089	*/
AnnaBridge	146:22da6e220af6	3090	arm_status arm_conv_partial_f32(
AnnaBridge	146:22da6e220af6	3091	float32_t * pSrcA,
AnnaBridge	146:22da6e220af6	3092	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3093	float32_t * pSrcB,
AnnaBridge	146:22da6e220af6	3094	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3095	float32_t * pDst,
AnnaBridge	146:22da6e220af6	3096	uint32_t firstIndex,
AnnaBridge	146:22da6e220af6	3097	uint32_t numPoints);
AnnaBridge	146:22da6e220af6	3098
AnnaBridge	146:22da6e220af6	3099
AnnaBridge	146:22da6e220af6	3100	/**
AnnaBridge	146:22da6e220af6	3101	* @brief Partial convolution of Q15 sequences.
AnnaBridge	146:22da6e220af6	3102	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3103	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3104	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3105	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3106	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3107	* @param[in] firstIndex is the first output sample to start with.
AnnaBridge	146:22da6e220af6	3108	* @param[in] numPoints is the number of output points to be computed.
AnnaBridge	146:22da6e220af6	3109	* @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2.
AnnaBridge	146:22da6e220af6	3110	* @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen).
AnnaBridge	146:22da6e220af6	3111	* @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].
AnnaBridge	146:22da6e220af6	3112	*/
AnnaBridge	146:22da6e220af6	3113	arm_status arm_conv_partial_opt_q15(
AnnaBridge	146:22da6e220af6	3114	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	3115	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3116	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	3117	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3118	q15_t * pDst,
AnnaBridge	146:22da6e220af6	3119	uint32_t firstIndex,
AnnaBridge	146:22da6e220af6	3120	uint32_t numPoints,
AnnaBridge	146:22da6e220af6	3121	q15_t * pScratch1,
AnnaBridge	146:22da6e220af6	3122	q15_t * pScratch2);
AnnaBridge	146:22da6e220af6	3123
AnnaBridge	146:22da6e220af6	3124
AnnaBridge	146:22da6e220af6	3125	/**
AnnaBridge	146:22da6e220af6	3126	* @brief Partial convolution of Q15 sequences.
AnnaBridge	146:22da6e220af6	3127	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3128	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3129	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3130	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3131	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3132	* @param[in] firstIndex is the first output sample to start with.
AnnaBridge	146:22da6e220af6	3133	* @param[in] numPoints is the number of output points to be computed.
AnnaBridge	146:22da6e220af6	3134	* @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].
AnnaBridge	146:22da6e220af6	3135	*/
AnnaBridge	146:22da6e220af6	3136	arm_status arm_conv_partial_q15(
AnnaBridge	146:22da6e220af6	3137	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	3138	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3139	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	3140	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3141	q15_t * pDst,
AnnaBridge	146:22da6e220af6	3142	uint32_t firstIndex,
AnnaBridge	146:22da6e220af6	3143	uint32_t numPoints);
AnnaBridge	146:22da6e220af6	3144
AnnaBridge	146:22da6e220af6	3145
AnnaBridge	146:22da6e220af6	3146	/**
AnnaBridge	146:22da6e220af6	3147	* @brief Partial convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4
AnnaBridge	146:22da6e220af6	3148	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3149	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3150	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3151	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3152	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3153	* @param[in] firstIndex is the first output sample to start with.
AnnaBridge	146:22da6e220af6	3154	* @param[in] numPoints is the number of output points to be computed.
AnnaBridge	146:22da6e220af6	3155	* @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].
AnnaBridge	146:22da6e220af6	3156	*/
AnnaBridge	146:22da6e220af6	3157	arm_status arm_conv_partial_fast_q15(
AnnaBridge	146:22da6e220af6	3158	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	3159	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3160	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	3161	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3162	q15_t * pDst,
AnnaBridge	146:22da6e220af6	3163	uint32_t firstIndex,
AnnaBridge	146:22da6e220af6	3164	uint32_t numPoints);
AnnaBridge	146:22da6e220af6	3165
AnnaBridge	146:22da6e220af6	3166
AnnaBridge	146:22da6e220af6	3167	/**
AnnaBridge	146:22da6e220af6	3168	* @brief Partial convolution of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4
AnnaBridge	146:22da6e220af6	3169	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3170	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3171	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3172	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3173	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3174	* @param[in] firstIndex is the first output sample to start with.
AnnaBridge	146:22da6e220af6	3175	* @param[in] numPoints is the number of output points to be computed.
AnnaBridge	146:22da6e220af6	3176	* @param[in] pScratch1 points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2.
AnnaBridge	146:22da6e220af6	3177	* @param[in] pScratch2 points to scratch buffer of size min(srcALen, srcBLen).
AnnaBridge	146:22da6e220af6	3178	* @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].
AnnaBridge	146:22da6e220af6	3179	*/
AnnaBridge	146:22da6e220af6	3180	arm_status arm_conv_partial_fast_opt_q15(
AnnaBridge	146:22da6e220af6	3181	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	3182	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3183	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	3184	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3185	q15_t * pDst,
AnnaBridge	146:22da6e220af6	3186	uint32_t firstIndex,
AnnaBridge	146:22da6e220af6	3187	uint32_t numPoints,
AnnaBridge	146:22da6e220af6	3188	q15_t * pScratch1,
AnnaBridge	146:22da6e220af6	3189	q15_t * pScratch2);
AnnaBridge	146:22da6e220af6	3190
AnnaBridge	146:22da6e220af6	3191
AnnaBridge	146:22da6e220af6	3192	/**
AnnaBridge	146:22da6e220af6	3193	* @brief Partial convolution of Q31 sequences.
AnnaBridge	146:22da6e220af6	3194	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3195	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3196	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3197	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3198	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3199	* @param[in] firstIndex is the first output sample to start with.
AnnaBridge	146:22da6e220af6	3200	* @param[in] numPoints is the number of output points to be computed.
AnnaBridge	146:22da6e220af6	3201	* @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].
AnnaBridge	146:22da6e220af6	3202	*/
AnnaBridge	146:22da6e220af6	3203	arm_status arm_conv_partial_q31(
AnnaBridge	146:22da6e220af6	3204	q31_t * pSrcA,
AnnaBridge	146:22da6e220af6	3205	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3206	q31_t * pSrcB,
AnnaBridge	146:22da6e220af6	3207	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3208	q31_t * pDst,
AnnaBridge	146:22da6e220af6	3209	uint32_t firstIndex,
AnnaBridge	146:22da6e220af6	3210	uint32_t numPoints);
AnnaBridge	146:22da6e220af6	3211
AnnaBridge	146:22da6e220af6	3212
AnnaBridge	146:22da6e220af6	3213	/**
AnnaBridge	146:22da6e220af6	3214	* @brief Partial convolution of Q31 sequences (fast version) for Cortex-M3 and Cortex-M4
AnnaBridge	146:22da6e220af6	3215	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3216	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3217	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3218	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3219	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3220	* @param[in] firstIndex is the first output sample to start with.
AnnaBridge	146:22da6e220af6	3221	* @param[in] numPoints is the number of output points to be computed.
AnnaBridge	146:22da6e220af6	3222	* @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].
AnnaBridge	146:22da6e220af6	3223	*/
AnnaBridge	146:22da6e220af6	3224	arm_status arm_conv_partial_fast_q31(
AnnaBridge	146:22da6e220af6	3225	q31_t * pSrcA,
AnnaBridge	146:22da6e220af6	3226	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3227	q31_t * pSrcB,
AnnaBridge	146:22da6e220af6	3228	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3229	q31_t * pDst,
AnnaBridge	146:22da6e220af6	3230	uint32_t firstIndex,
AnnaBridge	146:22da6e220af6	3231	uint32_t numPoints);
AnnaBridge	146:22da6e220af6	3232
AnnaBridge	146:22da6e220af6	3233
AnnaBridge	146:22da6e220af6	3234	/**
AnnaBridge	146:22da6e220af6	3235	* @brief Partial convolution of Q7 sequences
AnnaBridge	146:22da6e220af6	3236	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3237	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3238	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3239	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3240	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3241	* @param[in] firstIndex is the first output sample to start with.
AnnaBridge	146:22da6e220af6	3242	* @param[in] numPoints is the number of output points to be computed.
AnnaBridge	146:22da6e220af6	3243	* @param[in] pScratch1 points to scratch buffer(of type q15_t) of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2.
AnnaBridge	146:22da6e220af6	3244	* @param[in] pScratch2 points to scratch buffer (of type q15_t) of size min(srcALen, srcBLen).
AnnaBridge	146:22da6e220af6	3245	* @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].
AnnaBridge	146:22da6e220af6	3246	*/
AnnaBridge	146:22da6e220af6	3247	arm_status arm_conv_partial_opt_q7(
AnnaBridge	146:22da6e220af6	3248	q7_t * pSrcA,
AnnaBridge	146:22da6e220af6	3249	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3250	q7_t * pSrcB,
AnnaBridge	146:22da6e220af6	3251	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3252	q7_t * pDst,
AnnaBridge	146:22da6e220af6	3253	uint32_t firstIndex,
AnnaBridge	146:22da6e220af6	3254	uint32_t numPoints,
AnnaBridge	146:22da6e220af6	3255	q15_t * pScratch1,
AnnaBridge	146:22da6e220af6	3256	q15_t * pScratch2);
AnnaBridge	146:22da6e220af6	3257
AnnaBridge	146:22da6e220af6	3258
AnnaBridge	146:22da6e220af6	3259	/**
AnnaBridge	146:22da6e220af6	3260	* @brief Partial convolution of Q7 sequences.
AnnaBridge	146:22da6e220af6	3261	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	3262	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	3263	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	3264	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	3265	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3266	* @param[in] firstIndex is the first output sample to start with.
AnnaBridge	146:22da6e220af6	3267	* @param[in] numPoints is the number of output points to be computed.
AnnaBridge	146:22da6e220af6	3268	* @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].
AnnaBridge	146:22da6e220af6	3269	*/
AnnaBridge	146:22da6e220af6	3270	arm_status arm_conv_partial_q7(
AnnaBridge	146:22da6e220af6	3271	q7_t * pSrcA,
AnnaBridge	146:22da6e220af6	3272	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	3273	q7_t * pSrcB,
AnnaBridge	146:22da6e220af6	3274	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	3275	q7_t * pDst,
AnnaBridge	146:22da6e220af6	3276	uint32_t firstIndex,
AnnaBridge	146:22da6e220af6	3277	uint32_t numPoints);
AnnaBridge	146:22da6e220af6	3278
AnnaBridge	146:22da6e220af6	3279
AnnaBridge	146:22da6e220af6	3280	/**
AnnaBridge	146:22da6e220af6	3281	* @brief Instance structure for the Q15 FIR decimator.
AnnaBridge	146:22da6e220af6	3282	*/
AnnaBridge	146:22da6e220af6	3283	typedef struct
AnnaBridge	146:22da6e220af6	3284	{
AnnaBridge	146:22da6e220af6	3285	uint8_t M; /*< decimation factor. /
AnnaBridge	146:22da6e220af6	3286	uint16_t numTaps; /*< number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	3287	q15_t pCoeffs; /< points to the coefficient array. The array is of length numTaps./
AnnaBridge	146:22da6e220af6	3288	q15_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	3289	} arm_fir_decimate_instance_q15;
AnnaBridge	146:22da6e220af6	3290
AnnaBridge	146:22da6e220af6	3291	/**
AnnaBridge	146:22da6e220af6	3292	* @brief Instance structure for the Q31 FIR decimator.
AnnaBridge	146:22da6e220af6	3293	*/
AnnaBridge	146:22da6e220af6	3294	typedef struct
AnnaBridge	146:22da6e220af6	3295	{
AnnaBridge	146:22da6e220af6	3296	uint8_t M; /*< decimation factor. /
AnnaBridge	146:22da6e220af6	3297	uint16_t numTaps; /*< number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	3298	q31_t pCoeffs; /< points to the coefficient array. The array is of length numTaps./
AnnaBridge	146:22da6e220af6	3299	q31_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	3300	} arm_fir_decimate_instance_q31;
AnnaBridge	146:22da6e220af6	3301
AnnaBridge	146:22da6e220af6	3302	/**
AnnaBridge	146:22da6e220af6	3303	* @brief Instance structure for the floating-point FIR decimator.
AnnaBridge	146:22da6e220af6	3304	*/
AnnaBridge	146:22da6e220af6	3305	typedef struct
AnnaBridge	146:22da6e220af6	3306	{
AnnaBridge	146:22da6e220af6	3307	uint8_t M; /*< decimation factor. /
AnnaBridge	146:22da6e220af6	3308	uint16_t numTaps; /*< number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	3309	float32_t pCoeffs; /< points to the coefficient array. The array is of length numTaps./
AnnaBridge	146:22da6e220af6	3310	float32_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	3311	} arm_fir_decimate_instance_f32;
AnnaBridge	146:22da6e220af6	3312
AnnaBridge	146:22da6e220af6	3313
AnnaBridge	146:22da6e220af6	3314	/**
AnnaBridge	146:22da6e220af6	3315	* @brief Processing function for the floating-point FIR decimator.
AnnaBridge	146:22da6e220af6	3316	* @param[in] S points to an instance of the floating-point FIR decimator structure.
AnnaBridge	146:22da6e220af6	3317	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3318	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3319	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3320	*/
AnnaBridge	146:22da6e220af6	3321	void arm_fir_decimate_f32(
AnnaBridge	146:22da6e220af6	3322	const arm_fir_decimate_instance_f32 * S,
AnnaBridge	146:22da6e220af6	3323	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	3324	float32_t * pDst,
AnnaBridge	146:22da6e220af6	3325	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3326
AnnaBridge	146:22da6e220af6	3327
AnnaBridge	146:22da6e220af6	3328	/**
AnnaBridge	146:22da6e220af6	3329	* @brief Initialization function for the floating-point FIR decimator.
AnnaBridge	146:22da6e220af6	3330	* @param[in,out] S points to an instance of the floating-point FIR decimator structure.
AnnaBridge	146:22da6e220af6	3331	* @param[in] numTaps number of coefficients in the filter.
AnnaBridge	146:22da6e220af6	3332	* @param[in] M decimation factor.
AnnaBridge	146:22da6e220af6	3333	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	3334	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	3335	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3336	* @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if
AnnaBridge	146:22da6e220af6	3337	* <code>blockSize</code> is not a multiple of <code>M</code>.
AnnaBridge	146:22da6e220af6	3338	*/
AnnaBridge	146:22da6e220af6	3339	arm_status arm_fir_decimate_init_f32(
AnnaBridge	146:22da6e220af6	3340	arm_fir_decimate_instance_f32 * S,
AnnaBridge	146:22da6e220af6	3341	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	3342	uint8_t M,
AnnaBridge	146:22da6e220af6	3343	float32_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3344	float32_t * pState,
AnnaBridge	146:22da6e220af6	3345	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3346
AnnaBridge	146:22da6e220af6	3347
AnnaBridge	146:22da6e220af6	3348	/**
AnnaBridge	146:22da6e220af6	3349	* @brief Processing function for the Q15 FIR decimator.
AnnaBridge	146:22da6e220af6	3350	* @param[in] S points to an instance of the Q15 FIR decimator structure.
AnnaBridge	146:22da6e220af6	3351	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3352	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3353	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3354	*/
AnnaBridge	146:22da6e220af6	3355	void arm_fir_decimate_q15(
AnnaBridge	146:22da6e220af6	3356	const arm_fir_decimate_instance_q15 * S,
AnnaBridge	146:22da6e220af6	3357	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	3358	q15_t * pDst,
AnnaBridge	146:22da6e220af6	3359	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3360
AnnaBridge	146:22da6e220af6	3361
AnnaBridge	146:22da6e220af6	3362	/**
AnnaBridge	146:22da6e220af6	3363	* @brief Processing function for the Q15 FIR decimator (fast variant) for Cortex-M3 and Cortex-M4.
AnnaBridge	146:22da6e220af6	3364	* @param[in] S points to an instance of the Q15 FIR decimator structure.
AnnaBridge	146:22da6e220af6	3365	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3366	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3367	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3368	*/
AnnaBridge	146:22da6e220af6	3369	void arm_fir_decimate_fast_q15(
AnnaBridge	146:22da6e220af6	3370	const arm_fir_decimate_instance_q15 * S,
AnnaBridge	146:22da6e220af6	3371	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	3372	q15_t * pDst,
AnnaBridge	146:22da6e220af6	3373	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3374
AnnaBridge	146:22da6e220af6	3375
AnnaBridge	146:22da6e220af6	3376	/**
AnnaBridge	146:22da6e220af6	3377	* @brief Initialization function for the Q15 FIR decimator.
AnnaBridge	146:22da6e220af6	3378	* @param[in,out] S points to an instance of the Q15 FIR decimator structure.
AnnaBridge	146:22da6e220af6	3379	* @param[in] numTaps number of coefficients in the filter.
AnnaBridge	146:22da6e220af6	3380	* @param[in] M decimation factor.
AnnaBridge	146:22da6e220af6	3381	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	3382	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	3383	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3384	* @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if
AnnaBridge	146:22da6e220af6	3385	* <code>blockSize</code> is not a multiple of <code>M</code>.
AnnaBridge	146:22da6e220af6	3386	*/
AnnaBridge	146:22da6e220af6	3387	arm_status arm_fir_decimate_init_q15(
AnnaBridge	146:22da6e220af6	3388	arm_fir_decimate_instance_q15 * S,
AnnaBridge	146:22da6e220af6	3389	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	3390	uint8_t M,
AnnaBridge	146:22da6e220af6	3391	q15_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3392	q15_t * pState,
AnnaBridge	146:22da6e220af6	3393	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3394
AnnaBridge	146:22da6e220af6	3395
AnnaBridge	146:22da6e220af6	3396	/**
AnnaBridge	146:22da6e220af6	3397	* @brief Processing function for the Q31 FIR decimator.
AnnaBridge	146:22da6e220af6	3398	* @param[in] S points to an instance of the Q31 FIR decimator structure.
AnnaBridge	146:22da6e220af6	3399	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3400	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3401	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3402	*/
AnnaBridge	146:22da6e220af6	3403	void arm_fir_decimate_q31(
AnnaBridge	146:22da6e220af6	3404	const arm_fir_decimate_instance_q31 * S,
AnnaBridge	146:22da6e220af6	3405	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	3406	q31_t * pDst,
AnnaBridge	146:22da6e220af6	3407	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3408
AnnaBridge	146:22da6e220af6	3409	/**
AnnaBridge	146:22da6e220af6	3410	* @brief Processing function for the Q31 FIR decimator (fast variant) for Cortex-M3 and Cortex-M4.
AnnaBridge	146:22da6e220af6	3411	* @param[in] S points to an instance of the Q31 FIR decimator structure.
AnnaBridge	146:22da6e220af6	3412	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3413	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3414	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3415	*/
AnnaBridge	146:22da6e220af6	3416	void arm_fir_decimate_fast_q31(
AnnaBridge	146:22da6e220af6	3417	arm_fir_decimate_instance_q31 * S,
AnnaBridge	146:22da6e220af6	3418	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	3419	q31_t * pDst,
AnnaBridge	146:22da6e220af6	3420	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3421
AnnaBridge	146:22da6e220af6	3422
AnnaBridge	146:22da6e220af6	3423	/**
AnnaBridge	146:22da6e220af6	3424	* @brief Initialization function for the Q31 FIR decimator.
AnnaBridge	146:22da6e220af6	3425	* @param[in,out] S points to an instance of the Q31 FIR decimator structure.
AnnaBridge	146:22da6e220af6	3426	* @param[in] numTaps number of coefficients in the filter.
AnnaBridge	146:22da6e220af6	3427	* @param[in] M decimation factor.
AnnaBridge	146:22da6e220af6	3428	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	3429	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	3430	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3431	* @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if
AnnaBridge	146:22da6e220af6	3432	* <code>blockSize</code> is not a multiple of <code>M</code>.
AnnaBridge	146:22da6e220af6	3433	*/
AnnaBridge	146:22da6e220af6	3434	arm_status arm_fir_decimate_init_q31(
AnnaBridge	146:22da6e220af6	3435	arm_fir_decimate_instance_q31 * S,
AnnaBridge	146:22da6e220af6	3436	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	3437	uint8_t M,
AnnaBridge	146:22da6e220af6	3438	q31_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3439	q31_t * pState,
AnnaBridge	146:22da6e220af6	3440	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3441
AnnaBridge	146:22da6e220af6	3442
AnnaBridge	146:22da6e220af6	3443	/**
AnnaBridge	146:22da6e220af6	3444	* @brief Instance structure for the Q15 FIR interpolator.
AnnaBridge	146:22da6e220af6	3445	*/
AnnaBridge	146:22da6e220af6	3446	typedef struct
AnnaBridge	146:22da6e220af6	3447	{
AnnaBridge	146:22da6e220af6	3448	uint8_t L; /*< upsample factor. /
AnnaBridge	146:22da6e220af6	3449	uint16_t phaseLength; /*< length of each polyphase filter component. /
AnnaBridge	146:22da6e220af6	3450	q15_t pCoeffs; /< points to the coefficient array. The array is of length LphaseLength. */
AnnaBridge	146:22da6e220af6	3451	q15_t pState; /< points to the state variable array. The array is of length blockSize+phaseLength-1. /
AnnaBridge	146:22da6e220af6	3452	} arm_fir_interpolate_instance_q15;
AnnaBridge	146:22da6e220af6	3453
AnnaBridge	146:22da6e220af6	3454	/**
AnnaBridge	146:22da6e220af6	3455	* @brief Instance structure for the Q31 FIR interpolator.
AnnaBridge	146:22da6e220af6	3456	*/
AnnaBridge	146:22da6e220af6	3457	typedef struct
AnnaBridge	146:22da6e220af6	3458	{
AnnaBridge	146:22da6e220af6	3459	uint8_t L; /*< upsample factor. /
AnnaBridge	146:22da6e220af6	3460	uint16_t phaseLength; /*< length of each polyphase filter component. /
AnnaBridge	146:22da6e220af6	3461	q31_t pCoeffs; /< points to the coefficient array. The array is of length LphaseLength. */
AnnaBridge	146:22da6e220af6	3462	q31_t pState; /< points to the state variable array. The array is of length blockSize+phaseLength-1. /
AnnaBridge	146:22da6e220af6	3463	} arm_fir_interpolate_instance_q31;
AnnaBridge	146:22da6e220af6	3464
AnnaBridge	146:22da6e220af6	3465	/**
AnnaBridge	146:22da6e220af6	3466	* @brief Instance structure for the floating-point FIR interpolator.
AnnaBridge	146:22da6e220af6	3467	*/
AnnaBridge	146:22da6e220af6	3468	typedef struct
AnnaBridge	146:22da6e220af6	3469	{
AnnaBridge	146:22da6e220af6	3470	uint8_t L; /*< upsample factor. /
AnnaBridge	146:22da6e220af6	3471	uint16_t phaseLength; /*< length of each polyphase filter component. /
AnnaBridge	146:22da6e220af6	3472	float32_t pCoeffs; /< points to the coefficient array. The array is of length LphaseLength. */
AnnaBridge	146:22da6e220af6	3473	float32_t pState; /< points to the state variable array. The array is of length phaseLength+numTaps-1. /
AnnaBridge	146:22da6e220af6	3474	} arm_fir_interpolate_instance_f32;
AnnaBridge	146:22da6e220af6	3475
AnnaBridge	146:22da6e220af6	3476
AnnaBridge	146:22da6e220af6	3477	/**
AnnaBridge	146:22da6e220af6	3478	* @brief Processing function for the Q15 FIR interpolator.
AnnaBridge	146:22da6e220af6	3479	* @param[in] S points to an instance of the Q15 FIR interpolator structure.
AnnaBridge	146:22da6e220af6	3480	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3481	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	3482	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3483	*/
AnnaBridge	146:22da6e220af6	3484	void arm_fir_interpolate_q15(
AnnaBridge	146:22da6e220af6	3485	const arm_fir_interpolate_instance_q15 * S,
AnnaBridge	146:22da6e220af6	3486	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	3487	q15_t * pDst,
AnnaBridge	146:22da6e220af6	3488	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3489
AnnaBridge	146:22da6e220af6	3490
AnnaBridge	146:22da6e220af6	3491	/**
AnnaBridge	146:22da6e220af6	3492	* @brief Initialization function for the Q15 FIR interpolator.
AnnaBridge	146:22da6e220af6	3493	* @param[in,out] S points to an instance of the Q15 FIR interpolator structure.
AnnaBridge	146:22da6e220af6	3494	* @param[in] L upsample factor.
AnnaBridge	146:22da6e220af6	3495	* @param[in] numTaps number of filter coefficients in the filter.
AnnaBridge	146:22da6e220af6	3496	* @param[in] pCoeffs points to the filter coefficient buffer.
AnnaBridge	146:22da6e220af6	3497	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	3498	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3499	* @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if
AnnaBridge	146:22da6e220af6	3500	* the filter length <code>numTaps</code> is not a multiple of the interpolation factor <code>L</code>.
AnnaBridge	146:22da6e220af6	3501	*/
AnnaBridge	146:22da6e220af6	3502	arm_status arm_fir_interpolate_init_q15(
AnnaBridge	146:22da6e220af6	3503	arm_fir_interpolate_instance_q15 * S,
AnnaBridge	146:22da6e220af6	3504	uint8_t L,
AnnaBridge	146:22da6e220af6	3505	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	3506	q15_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3507	q15_t * pState,
AnnaBridge	146:22da6e220af6	3508	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3509
AnnaBridge	146:22da6e220af6	3510
AnnaBridge	146:22da6e220af6	3511	/**
AnnaBridge	146:22da6e220af6	3512	* @brief Processing function for the Q31 FIR interpolator.
AnnaBridge	146:22da6e220af6	3513	* @param[in] S points to an instance of the Q15 FIR interpolator structure.
AnnaBridge	146:22da6e220af6	3514	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3515	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	3516	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3517	*/
AnnaBridge	146:22da6e220af6	3518	void arm_fir_interpolate_q31(
AnnaBridge	146:22da6e220af6	3519	const arm_fir_interpolate_instance_q31 * S,
AnnaBridge	146:22da6e220af6	3520	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	3521	q31_t * pDst,
AnnaBridge	146:22da6e220af6	3522	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3523
AnnaBridge	146:22da6e220af6	3524
AnnaBridge	146:22da6e220af6	3525	/**
AnnaBridge	146:22da6e220af6	3526	* @brief Initialization function for the Q31 FIR interpolator.
AnnaBridge	146:22da6e220af6	3527	* @param[in,out] S points to an instance of the Q31 FIR interpolator structure.
AnnaBridge	146:22da6e220af6	3528	* @param[in] L upsample factor.
AnnaBridge	146:22da6e220af6	3529	* @param[in] numTaps number of filter coefficients in the filter.
AnnaBridge	146:22da6e220af6	3530	* @param[in] pCoeffs points to the filter coefficient buffer.
AnnaBridge	146:22da6e220af6	3531	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	3532	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3533	* @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if
AnnaBridge	146:22da6e220af6	3534	* the filter length <code>numTaps</code> is not a multiple of the interpolation factor <code>L</code>.
AnnaBridge	146:22da6e220af6	3535	*/
AnnaBridge	146:22da6e220af6	3536	arm_status arm_fir_interpolate_init_q31(
AnnaBridge	146:22da6e220af6	3537	arm_fir_interpolate_instance_q31 * S,
AnnaBridge	146:22da6e220af6	3538	uint8_t L,
AnnaBridge	146:22da6e220af6	3539	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	3540	q31_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3541	q31_t * pState,
AnnaBridge	146:22da6e220af6	3542	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3543
AnnaBridge	146:22da6e220af6	3544
AnnaBridge	146:22da6e220af6	3545	/**
AnnaBridge	146:22da6e220af6	3546	* @brief Processing function for the floating-point FIR interpolator.
AnnaBridge	146:22da6e220af6	3547	* @param[in] S points to an instance of the floating-point FIR interpolator structure.
AnnaBridge	146:22da6e220af6	3548	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3549	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	3550	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3551	*/
AnnaBridge	146:22da6e220af6	3552	void arm_fir_interpolate_f32(
AnnaBridge	146:22da6e220af6	3553	const arm_fir_interpolate_instance_f32 * S,
AnnaBridge	146:22da6e220af6	3554	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	3555	float32_t * pDst,
AnnaBridge	146:22da6e220af6	3556	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3557
AnnaBridge	146:22da6e220af6	3558
AnnaBridge	146:22da6e220af6	3559	/**
AnnaBridge	146:22da6e220af6	3560	* @brief Initialization function for the floating-point FIR interpolator.
AnnaBridge	146:22da6e220af6	3561	* @param[in,out] S points to an instance of the floating-point FIR interpolator structure.
AnnaBridge	146:22da6e220af6	3562	* @param[in] L upsample factor.
AnnaBridge	146:22da6e220af6	3563	* @param[in] numTaps number of filter coefficients in the filter.
AnnaBridge	146:22da6e220af6	3564	* @param[in] pCoeffs points to the filter coefficient buffer.
AnnaBridge	146:22da6e220af6	3565	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	3566	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	3567	* @return The function returns ARM_MATH_SUCCESS if initialization is successful or ARM_MATH_LENGTH_ERROR if
AnnaBridge	146:22da6e220af6	3568	* the filter length <code>numTaps</code> is not a multiple of the interpolation factor <code>L</code>.
AnnaBridge	146:22da6e220af6	3569	*/
AnnaBridge	146:22da6e220af6	3570	arm_status arm_fir_interpolate_init_f32(
AnnaBridge	146:22da6e220af6	3571	arm_fir_interpolate_instance_f32 * S,
AnnaBridge	146:22da6e220af6	3572	uint8_t L,
AnnaBridge	146:22da6e220af6	3573	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	3574	float32_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3575	float32_t * pState,
AnnaBridge	146:22da6e220af6	3576	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3577
AnnaBridge	146:22da6e220af6	3578
AnnaBridge	146:22da6e220af6	3579	/**
AnnaBridge	146:22da6e220af6	3580	* @brief Instance structure for the high precision Q31 Biquad cascade filter.
AnnaBridge	146:22da6e220af6	3581	*/
AnnaBridge	146:22da6e220af6	3582	typedef struct
AnnaBridge	146:22da6e220af6	3583	{
AnnaBridge	146:22da6e220af6	3584	uint8_t numStages; /*< number of 2nd order stages in the filter. Overall order is 2numStages. */
AnnaBridge	146:22da6e220af6	3585	q63_t pState; /< points to the array of state coefficients. The array is of length 4numStages. */
AnnaBridge	146:22da6e220af6	3586	q31_t pCoeffs; /< points to the array of coefficients. The array is of length 5numStages. */
AnnaBridge	146:22da6e220af6	3587	uint8_t postShift; /*< additional shift, in bits, applied to each output sample. /
AnnaBridge	146:22da6e220af6	3588	} arm_biquad_cas_df1_32x64_ins_q31;
AnnaBridge	146:22da6e220af6	3589
AnnaBridge	146:22da6e220af6	3590
AnnaBridge	146:22da6e220af6	3591	/**
AnnaBridge	146:22da6e220af6	3592	* @param[in] S points to an instance of the high precision Q31 Biquad cascade filter structure.
AnnaBridge	146:22da6e220af6	3593	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3594	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3595	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3596	*/
AnnaBridge	146:22da6e220af6	3597	void arm_biquad_cas_df1_32x64_q31(
AnnaBridge	146:22da6e220af6	3598	const arm_biquad_cas_df1_32x64_ins_q31 * S,
AnnaBridge	146:22da6e220af6	3599	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	3600	q31_t * pDst,
AnnaBridge	146:22da6e220af6	3601	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3602
AnnaBridge	146:22da6e220af6	3603
AnnaBridge	146:22da6e220af6	3604	/**
AnnaBridge	146:22da6e220af6	3605	* @param[in,out] S points to an instance of the high precision Q31 Biquad cascade filter structure.
AnnaBridge	146:22da6e220af6	3606	* @param[in] numStages number of 2nd order stages in the filter.
AnnaBridge	146:22da6e220af6	3607	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	3608	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	3609	* @param[in] postShift shift to be applied to the output. Varies according to the coefficients format
AnnaBridge	146:22da6e220af6	3610	*/
AnnaBridge	146:22da6e220af6	3611	void arm_biquad_cas_df1_32x64_init_q31(
AnnaBridge	146:22da6e220af6	3612	arm_biquad_cas_df1_32x64_ins_q31 * S,
AnnaBridge	146:22da6e220af6	3613	uint8_t numStages,
AnnaBridge	146:22da6e220af6	3614	q31_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3615	q63_t * pState,
AnnaBridge	146:22da6e220af6	3616	uint8_t postShift);
AnnaBridge	146:22da6e220af6	3617
AnnaBridge	146:22da6e220af6	3618
AnnaBridge	146:22da6e220af6	3619	/**
AnnaBridge	146:22da6e220af6	3620	* @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter.
AnnaBridge	146:22da6e220af6	3621	*/
AnnaBridge	146:22da6e220af6	3622	typedef struct
AnnaBridge	146:22da6e220af6	3623	{
AnnaBridge	146:22da6e220af6	3624	uint8_t numStages; /*< number of 2nd order stages in the filter. Overall order is 2numStages. */
AnnaBridge	146:22da6e220af6	3625	float32_t pState; /< points to the array of state coefficients. The array is of length 2numStages. */
AnnaBridge	146:22da6e220af6	3626	float32_t pCoeffs; /< points to the array of coefficients. The array is of length 5numStages. */
AnnaBridge	146:22da6e220af6	3627	} arm_biquad_cascade_df2T_instance_f32;
AnnaBridge	146:22da6e220af6	3628
AnnaBridge	146:22da6e220af6	3629	/**
AnnaBridge	146:22da6e220af6	3630	* @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter.
AnnaBridge	146:22da6e220af6	3631	*/
AnnaBridge	146:22da6e220af6	3632	typedef struct
AnnaBridge	146:22da6e220af6	3633	{
AnnaBridge	146:22da6e220af6	3634	uint8_t numStages; /*< number of 2nd order stages in the filter. Overall order is 2numStages. */
AnnaBridge	146:22da6e220af6	3635	float32_t pState; /< points to the array of state coefficients. The array is of length 4numStages. */
AnnaBridge	146:22da6e220af6	3636	float32_t pCoeffs; /< points to the array of coefficients. The array is of length 5numStages. */
AnnaBridge	146:22da6e220af6	3637	} arm_biquad_cascade_stereo_df2T_instance_f32;
AnnaBridge	146:22da6e220af6	3638
AnnaBridge	146:22da6e220af6	3639	/**
AnnaBridge	146:22da6e220af6	3640	* @brief Instance structure for the floating-point transposed direct form II Biquad cascade filter.
AnnaBridge	146:22da6e220af6	3641	*/
AnnaBridge	146:22da6e220af6	3642	typedef struct
AnnaBridge	146:22da6e220af6	3643	{
AnnaBridge	146:22da6e220af6	3644	uint8_t numStages; /*< number of 2nd order stages in the filter. Overall order is 2numStages. */
AnnaBridge	146:22da6e220af6	3645	float64_t pState; /< points to the array of state coefficients. The array is of length 2numStages. */
AnnaBridge	146:22da6e220af6	3646	float64_t pCoeffs; /< points to the array of coefficients. The array is of length 5numStages. */
AnnaBridge	146:22da6e220af6	3647	} arm_biquad_cascade_df2T_instance_f64;
AnnaBridge	146:22da6e220af6	3648
AnnaBridge	146:22da6e220af6	3649
AnnaBridge	146:22da6e220af6	3650	/**
AnnaBridge	146:22da6e220af6	3651	* @brief Processing function for the floating-point transposed direct form II Biquad cascade filter.
AnnaBridge	146:22da6e220af6	3652	* @param[in] S points to an instance of the filter data structure.
AnnaBridge	146:22da6e220af6	3653	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3654	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3655	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3656	*/
AnnaBridge	146:22da6e220af6	3657	void arm_biquad_cascade_df2T_f32(
AnnaBridge	146:22da6e220af6	3658	const arm_biquad_cascade_df2T_instance_f32 * S,
AnnaBridge	146:22da6e220af6	3659	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	3660	float32_t * pDst,
AnnaBridge	146:22da6e220af6	3661	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3662
AnnaBridge	146:22da6e220af6	3663
AnnaBridge	146:22da6e220af6	3664	/**
AnnaBridge	146:22da6e220af6	3665	* @brief Processing function for the floating-point transposed direct form II Biquad cascade filter. 2 channels
AnnaBridge	146:22da6e220af6	3666	* @param[in] S points to an instance of the filter data structure.
AnnaBridge	146:22da6e220af6	3667	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3668	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3669	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3670	*/
AnnaBridge	146:22da6e220af6	3671	void arm_biquad_cascade_stereo_df2T_f32(
AnnaBridge	146:22da6e220af6	3672	const arm_biquad_cascade_stereo_df2T_instance_f32 * S,
AnnaBridge	146:22da6e220af6	3673	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	3674	float32_t * pDst,
AnnaBridge	146:22da6e220af6	3675	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3676
AnnaBridge	146:22da6e220af6	3677
AnnaBridge	146:22da6e220af6	3678	/**
AnnaBridge	146:22da6e220af6	3679	* @brief Processing function for the floating-point transposed direct form II Biquad cascade filter.
AnnaBridge	146:22da6e220af6	3680	* @param[in] S points to an instance of the filter data structure.
AnnaBridge	146:22da6e220af6	3681	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3682	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3683	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3684	*/
AnnaBridge	146:22da6e220af6	3685	void arm_biquad_cascade_df2T_f64(
AnnaBridge	146:22da6e220af6	3686	const arm_biquad_cascade_df2T_instance_f64 * S,
AnnaBridge	146:22da6e220af6	3687	float64_t * pSrc,
AnnaBridge	146:22da6e220af6	3688	float64_t * pDst,
AnnaBridge	146:22da6e220af6	3689	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3690
AnnaBridge	146:22da6e220af6	3691
AnnaBridge	146:22da6e220af6	3692	/**
AnnaBridge	146:22da6e220af6	3693	* @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter.
AnnaBridge	146:22da6e220af6	3694	* @param[in,out] S points to an instance of the filter data structure.
AnnaBridge	146:22da6e220af6	3695	* @param[in] numStages number of 2nd order stages in the filter.
AnnaBridge	146:22da6e220af6	3696	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	3697	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	3698	*/
AnnaBridge	146:22da6e220af6	3699	void arm_biquad_cascade_df2T_init_f32(
AnnaBridge	146:22da6e220af6	3700	arm_biquad_cascade_df2T_instance_f32 * S,
AnnaBridge	146:22da6e220af6	3701	uint8_t numStages,
AnnaBridge	146:22da6e220af6	3702	float32_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3703	float32_t * pState);
AnnaBridge	146:22da6e220af6	3704
AnnaBridge	146:22da6e220af6	3705
AnnaBridge	146:22da6e220af6	3706	/**
AnnaBridge	146:22da6e220af6	3707	* @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter.
AnnaBridge	146:22da6e220af6	3708	* @param[in,out] S points to an instance of the filter data structure.
AnnaBridge	146:22da6e220af6	3709	* @param[in] numStages number of 2nd order stages in the filter.
AnnaBridge	146:22da6e220af6	3710	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	3711	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	3712	*/
AnnaBridge	146:22da6e220af6	3713	void arm_biquad_cascade_stereo_df2T_init_f32(
AnnaBridge	146:22da6e220af6	3714	arm_biquad_cascade_stereo_df2T_instance_f32 * S,
AnnaBridge	146:22da6e220af6	3715	uint8_t numStages,
AnnaBridge	146:22da6e220af6	3716	float32_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3717	float32_t * pState);
AnnaBridge	146:22da6e220af6	3718
AnnaBridge	146:22da6e220af6	3719
AnnaBridge	146:22da6e220af6	3720	/**
AnnaBridge	146:22da6e220af6	3721	* @brief Initialization function for the floating-point transposed direct form II Biquad cascade filter.
AnnaBridge	146:22da6e220af6	3722	* @param[in,out] S points to an instance of the filter data structure.
AnnaBridge	146:22da6e220af6	3723	* @param[in] numStages number of 2nd order stages in the filter.
AnnaBridge	146:22da6e220af6	3724	* @param[in] pCoeffs points to the filter coefficients.
AnnaBridge	146:22da6e220af6	3725	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	3726	*/
AnnaBridge	146:22da6e220af6	3727	void arm_biquad_cascade_df2T_init_f64(
AnnaBridge	146:22da6e220af6	3728	arm_biquad_cascade_df2T_instance_f64 * S,
AnnaBridge	146:22da6e220af6	3729	uint8_t numStages,
AnnaBridge	146:22da6e220af6	3730	float64_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3731	float64_t * pState);
AnnaBridge	146:22da6e220af6	3732
AnnaBridge	146:22da6e220af6	3733
AnnaBridge	146:22da6e220af6	3734	/**
AnnaBridge	146:22da6e220af6	3735	* @brief Instance structure for the Q15 FIR lattice filter.
AnnaBridge	146:22da6e220af6	3736	*/
AnnaBridge	146:22da6e220af6	3737	typedef struct
AnnaBridge	146:22da6e220af6	3738	{
AnnaBridge	146:22da6e220af6	3739	uint16_t numStages; /*< number of filter stages. /
AnnaBridge	146:22da6e220af6	3740	q15_t pState; /< points to the state variable array. The array is of length numStages. /
AnnaBridge	146:22da6e220af6	3741	q15_t pCoeffs; /< points to the coefficient array. The array is of length numStages. /
AnnaBridge	146:22da6e220af6	3742	} arm_fir_lattice_instance_q15;
AnnaBridge	146:22da6e220af6	3743
AnnaBridge	146:22da6e220af6	3744	/**
AnnaBridge	146:22da6e220af6	3745	* @brief Instance structure for the Q31 FIR lattice filter.
AnnaBridge	146:22da6e220af6	3746	*/
AnnaBridge	146:22da6e220af6	3747	typedef struct
AnnaBridge	146:22da6e220af6	3748	{
AnnaBridge	146:22da6e220af6	3749	uint16_t numStages; /*< number of filter stages. /
AnnaBridge	146:22da6e220af6	3750	q31_t pState; /< points to the state variable array. The array is of length numStages. /
AnnaBridge	146:22da6e220af6	3751	q31_t pCoeffs; /< points to the coefficient array. The array is of length numStages. /
AnnaBridge	146:22da6e220af6	3752	} arm_fir_lattice_instance_q31;
AnnaBridge	146:22da6e220af6	3753
AnnaBridge	146:22da6e220af6	3754	/**
AnnaBridge	146:22da6e220af6	3755	* @brief Instance structure for the floating-point FIR lattice filter.
AnnaBridge	146:22da6e220af6	3756	*/
AnnaBridge	146:22da6e220af6	3757	typedef struct
AnnaBridge	146:22da6e220af6	3758	{
AnnaBridge	146:22da6e220af6	3759	uint16_t numStages; /*< number of filter stages. /
AnnaBridge	146:22da6e220af6	3760	float32_t pState; /< points to the state variable array. The array is of length numStages. /
AnnaBridge	146:22da6e220af6	3761	float32_t pCoeffs; /< points to the coefficient array. The array is of length numStages. /
AnnaBridge	146:22da6e220af6	3762	} arm_fir_lattice_instance_f32;
AnnaBridge	146:22da6e220af6	3763
AnnaBridge	146:22da6e220af6	3764
AnnaBridge	146:22da6e220af6	3765	/**
AnnaBridge	146:22da6e220af6	3766	* @brief Initialization function for the Q15 FIR lattice filter.
AnnaBridge	146:22da6e220af6	3767	* @param[in] S points to an instance of the Q15 FIR lattice structure.
AnnaBridge	146:22da6e220af6	3768	* @param[in] numStages number of filter stages.
AnnaBridge	146:22da6e220af6	3769	* @param[in] pCoeffs points to the coefficient buffer. The array is of length numStages.
AnnaBridge	146:22da6e220af6	3770	* @param[in] pState points to the state buffer. The array is of length numStages.
AnnaBridge	146:22da6e220af6	3771	*/
AnnaBridge	146:22da6e220af6	3772	void arm_fir_lattice_init_q15(
AnnaBridge	146:22da6e220af6	3773	arm_fir_lattice_instance_q15 * S,
AnnaBridge	146:22da6e220af6	3774	uint16_t numStages,
AnnaBridge	146:22da6e220af6	3775	q15_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3776	q15_t * pState);
AnnaBridge	146:22da6e220af6	3777
AnnaBridge	146:22da6e220af6	3778
AnnaBridge	146:22da6e220af6	3779	/**
AnnaBridge	146:22da6e220af6	3780	* @brief Processing function for the Q15 FIR lattice filter.
AnnaBridge	146:22da6e220af6	3781	* @param[in] S points to an instance of the Q15 FIR lattice structure.
AnnaBridge	146:22da6e220af6	3782	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3783	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	3784	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3785	*/
AnnaBridge	146:22da6e220af6	3786	void arm_fir_lattice_q15(
AnnaBridge	146:22da6e220af6	3787	const arm_fir_lattice_instance_q15 * S,
AnnaBridge	146:22da6e220af6	3788	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	3789	q15_t * pDst,
AnnaBridge	146:22da6e220af6	3790	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3791
AnnaBridge	146:22da6e220af6	3792
AnnaBridge	146:22da6e220af6	3793	/**
AnnaBridge	146:22da6e220af6	3794	* @brief Initialization function for the Q31 FIR lattice filter.
AnnaBridge	146:22da6e220af6	3795	* @param[in] S points to an instance of the Q31 FIR lattice structure.
AnnaBridge	146:22da6e220af6	3796	* @param[in] numStages number of filter stages.
AnnaBridge	146:22da6e220af6	3797	* @param[in] pCoeffs points to the coefficient buffer. The array is of length numStages.
AnnaBridge	146:22da6e220af6	3798	* @param[in] pState points to the state buffer. The array is of length numStages.
AnnaBridge	146:22da6e220af6	3799	*/
AnnaBridge	146:22da6e220af6	3800	void arm_fir_lattice_init_q31(
AnnaBridge	146:22da6e220af6	3801	arm_fir_lattice_instance_q31 * S,
AnnaBridge	146:22da6e220af6	3802	uint16_t numStages,
AnnaBridge	146:22da6e220af6	3803	q31_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3804	q31_t * pState);
AnnaBridge	146:22da6e220af6	3805
AnnaBridge	146:22da6e220af6	3806
AnnaBridge	146:22da6e220af6	3807	/**
AnnaBridge	146:22da6e220af6	3808	* @brief Processing function for the Q31 FIR lattice filter.
AnnaBridge	146:22da6e220af6	3809	* @param[in] S points to an instance of the Q31 FIR lattice structure.
AnnaBridge	146:22da6e220af6	3810	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3811	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3812	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3813	*/
AnnaBridge	146:22da6e220af6	3814	void arm_fir_lattice_q31(
AnnaBridge	146:22da6e220af6	3815	const arm_fir_lattice_instance_q31 * S,
AnnaBridge	146:22da6e220af6	3816	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	3817	q31_t * pDst,
AnnaBridge	146:22da6e220af6	3818	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3819
AnnaBridge	146:22da6e220af6	3820
AnnaBridge	146:22da6e220af6	3821	/**
AnnaBridge	146:22da6e220af6	3822	* @brief Initialization function for the floating-point FIR lattice filter.
AnnaBridge	146:22da6e220af6	3823	* @param[in] S points to an instance of the floating-point FIR lattice structure.
AnnaBridge	146:22da6e220af6	3824	* @param[in] numStages number of filter stages.
AnnaBridge	146:22da6e220af6	3825	* @param[in] pCoeffs points to the coefficient buffer. The array is of length numStages.
AnnaBridge	146:22da6e220af6	3826	* @param[in] pState points to the state buffer. The array is of length numStages.
AnnaBridge	146:22da6e220af6	3827	*/
AnnaBridge	146:22da6e220af6	3828	void arm_fir_lattice_init_f32(
AnnaBridge	146:22da6e220af6	3829	arm_fir_lattice_instance_f32 * S,
AnnaBridge	146:22da6e220af6	3830	uint16_t numStages,
AnnaBridge	146:22da6e220af6	3831	float32_t * pCoeffs,
AnnaBridge	146:22da6e220af6	3832	float32_t * pState);
AnnaBridge	146:22da6e220af6	3833
AnnaBridge	146:22da6e220af6	3834
AnnaBridge	146:22da6e220af6	3835	/**
AnnaBridge	146:22da6e220af6	3836	* @brief Processing function for the floating-point FIR lattice filter.
AnnaBridge	146:22da6e220af6	3837	* @param[in] S points to an instance of the floating-point FIR lattice structure.
AnnaBridge	146:22da6e220af6	3838	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3839	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	3840	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3841	*/
AnnaBridge	146:22da6e220af6	3842	void arm_fir_lattice_f32(
AnnaBridge	146:22da6e220af6	3843	const arm_fir_lattice_instance_f32 * S,
AnnaBridge	146:22da6e220af6	3844	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	3845	float32_t * pDst,
AnnaBridge	146:22da6e220af6	3846	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3847
AnnaBridge	146:22da6e220af6	3848
AnnaBridge	146:22da6e220af6	3849	/**
AnnaBridge	146:22da6e220af6	3850	* @brief Instance structure for the Q15 IIR lattice filter.
AnnaBridge	146:22da6e220af6	3851	*/
AnnaBridge	146:22da6e220af6	3852	typedef struct
AnnaBridge	146:22da6e220af6	3853	{
AnnaBridge	146:22da6e220af6	3854	uint16_t numStages; /*< number of stages in the filter. /
AnnaBridge	146:22da6e220af6	3855	q15_t pState; /< points to the state variable array. The array is of length numStages+blockSize. /
AnnaBridge	146:22da6e220af6	3856	q15_t pkCoeffs; /< points to the reflection coefficient array. The array is of length numStages. /
AnnaBridge	146:22da6e220af6	3857	q15_t pvCoeffs; /< points to the ladder coefficient array. The array is of length numStages+1. /
AnnaBridge	146:22da6e220af6	3858	} arm_iir_lattice_instance_q15;
AnnaBridge	146:22da6e220af6	3859
AnnaBridge	146:22da6e220af6	3860	/**
AnnaBridge	146:22da6e220af6	3861	* @brief Instance structure for the Q31 IIR lattice filter.
AnnaBridge	146:22da6e220af6	3862	*/
AnnaBridge	146:22da6e220af6	3863	typedef struct
AnnaBridge	146:22da6e220af6	3864	{
AnnaBridge	146:22da6e220af6	3865	uint16_t numStages; /*< number of stages in the filter. /
AnnaBridge	146:22da6e220af6	3866	q31_t pState; /< points to the state variable array. The array is of length numStages+blockSize. /
AnnaBridge	146:22da6e220af6	3867	q31_t pkCoeffs; /< points to the reflection coefficient array. The array is of length numStages. /
AnnaBridge	146:22da6e220af6	3868	q31_t pvCoeffs; /< points to the ladder coefficient array. The array is of length numStages+1. /
AnnaBridge	146:22da6e220af6	3869	} arm_iir_lattice_instance_q31;
AnnaBridge	146:22da6e220af6	3870
AnnaBridge	146:22da6e220af6	3871	/**
AnnaBridge	146:22da6e220af6	3872	* @brief Instance structure for the floating-point IIR lattice filter.
AnnaBridge	146:22da6e220af6	3873	*/
AnnaBridge	146:22da6e220af6	3874	typedef struct
AnnaBridge	146:22da6e220af6	3875	{
AnnaBridge	146:22da6e220af6	3876	uint16_t numStages; /*< number of stages in the filter. /
AnnaBridge	146:22da6e220af6	3877	float32_t pState; /< points to the state variable array. The array is of length numStages+blockSize. /
AnnaBridge	146:22da6e220af6	3878	float32_t pkCoeffs; /< points to the reflection coefficient array. The array is of length numStages. /
AnnaBridge	146:22da6e220af6	3879	float32_t pvCoeffs; /< points to the ladder coefficient array. The array is of length numStages+1. /
AnnaBridge	146:22da6e220af6	3880	} arm_iir_lattice_instance_f32;
AnnaBridge	146:22da6e220af6	3881
AnnaBridge	146:22da6e220af6	3882
AnnaBridge	146:22da6e220af6	3883	/**
AnnaBridge	146:22da6e220af6	3884	* @brief Processing function for the floating-point IIR lattice filter.
AnnaBridge	146:22da6e220af6	3885	* @param[in] S points to an instance of the floating-point IIR lattice structure.
AnnaBridge	146:22da6e220af6	3886	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3887	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	3888	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3889	*/
AnnaBridge	146:22da6e220af6	3890	void arm_iir_lattice_f32(
AnnaBridge	146:22da6e220af6	3891	const arm_iir_lattice_instance_f32 * S,
AnnaBridge	146:22da6e220af6	3892	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	3893	float32_t * pDst,
AnnaBridge	146:22da6e220af6	3894	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3895
AnnaBridge	146:22da6e220af6	3896
AnnaBridge	146:22da6e220af6	3897	/**
AnnaBridge	146:22da6e220af6	3898	* @brief Initialization function for the floating-point IIR lattice filter.
AnnaBridge	146:22da6e220af6	3899	* @param[in] S points to an instance of the floating-point IIR lattice structure.
AnnaBridge	146:22da6e220af6	3900	* @param[in] numStages number of stages in the filter.
AnnaBridge	146:22da6e220af6	3901	* @param[in] pkCoeffs points to the reflection coefficient buffer. The array is of length numStages.
AnnaBridge	146:22da6e220af6	3902	* @param[in] pvCoeffs points to the ladder coefficient buffer. The array is of length numStages+1.
AnnaBridge	146:22da6e220af6	3903	* @param[in] pState points to the state buffer. The array is of length numStages+blockSize-1.
AnnaBridge	146:22da6e220af6	3904	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3905	*/
AnnaBridge	146:22da6e220af6	3906	void arm_iir_lattice_init_f32(
AnnaBridge	146:22da6e220af6	3907	arm_iir_lattice_instance_f32 * S,
AnnaBridge	146:22da6e220af6	3908	uint16_t numStages,
AnnaBridge	146:22da6e220af6	3909	float32_t * pkCoeffs,
AnnaBridge	146:22da6e220af6	3910	float32_t * pvCoeffs,
AnnaBridge	146:22da6e220af6	3911	float32_t * pState,
AnnaBridge	146:22da6e220af6	3912	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3913
AnnaBridge	146:22da6e220af6	3914
AnnaBridge	146:22da6e220af6	3915	/**
AnnaBridge	146:22da6e220af6	3916	* @brief Processing function for the Q31 IIR lattice filter.
AnnaBridge	146:22da6e220af6	3917	* @param[in] S points to an instance of the Q31 IIR lattice structure.
AnnaBridge	146:22da6e220af6	3918	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3919	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	3920	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3921	*/
AnnaBridge	146:22da6e220af6	3922	void arm_iir_lattice_q31(
AnnaBridge	146:22da6e220af6	3923	const arm_iir_lattice_instance_q31 * S,
AnnaBridge	146:22da6e220af6	3924	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	3925	q31_t * pDst,
AnnaBridge	146:22da6e220af6	3926	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3927
AnnaBridge	146:22da6e220af6	3928
AnnaBridge	146:22da6e220af6	3929	/**
AnnaBridge	146:22da6e220af6	3930	* @brief Initialization function for the Q31 IIR lattice filter.
AnnaBridge	146:22da6e220af6	3931	* @param[in] S points to an instance of the Q31 IIR lattice structure.
AnnaBridge	146:22da6e220af6	3932	* @param[in] numStages number of stages in the filter.
AnnaBridge	146:22da6e220af6	3933	* @param[in] pkCoeffs points to the reflection coefficient buffer. The array is of length numStages.
AnnaBridge	146:22da6e220af6	3934	* @param[in] pvCoeffs points to the ladder coefficient buffer. The array is of length numStages+1.
AnnaBridge	146:22da6e220af6	3935	* @param[in] pState points to the state buffer. The array is of length numStages+blockSize.
AnnaBridge	146:22da6e220af6	3936	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3937	*/
AnnaBridge	146:22da6e220af6	3938	void arm_iir_lattice_init_q31(
AnnaBridge	146:22da6e220af6	3939	arm_iir_lattice_instance_q31 * S,
AnnaBridge	146:22da6e220af6	3940	uint16_t numStages,
AnnaBridge	146:22da6e220af6	3941	q31_t * pkCoeffs,
AnnaBridge	146:22da6e220af6	3942	q31_t * pvCoeffs,
AnnaBridge	146:22da6e220af6	3943	q31_t * pState,
AnnaBridge	146:22da6e220af6	3944	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3945
AnnaBridge	146:22da6e220af6	3946
AnnaBridge	146:22da6e220af6	3947	/**
AnnaBridge	146:22da6e220af6	3948	* @brief Processing function for the Q15 IIR lattice filter.
AnnaBridge	146:22da6e220af6	3949	* @param[in] S points to an instance of the Q15 IIR lattice structure.
AnnaBridge	146:22da6e220af6	3950	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3951	* @param[out] pDst points to the block of output data.
AnnaBridge	146:22da6e220af6	3952	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3953	*/
AnnaBridge	146:22da6e220af6	3954	void arm_iir_lattice_q15(
AnnaBridge	146:22da6e220af6	3955	const arm_iir_lattice_instance_q15 * S,
AnnaBridge	146:22da6e220af6	3956	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	3957	q15_t * pDst,
AnnaBridge	146:22da6e220af6	3958	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3959
AnnaBridge	146:22da6e220af6	3960
AnnaBridge	146:22da6e220af6	3961	/**
AnnaBridge	146:22da6e220af6	3962	* @brief Initialization function for the Q15 IIR lattice filter.
AnnaBridge	146:22da6e220af6	3963	* @param[in] S points to an instance of the fixed-point Q15 IIR lattice structure.
AnnaBridge	146:22da6e220af6	3964	* @param[in] numStages number of stages in the filter.
AnnaBridge	146:22da6e220af6	3965	* @param[in] pkCoeffs points to reflection coefficient buffer. The array is of length numStages.
AnnaBridge	146:22da6e220af6	3966	* @param[in] pvCoeffs points to ladder coefficient buffer. The array is of length numStages+1.
AnnaBridge	146:22da6e220af6	3967	* @param[in] pState points to state buffer. The array is of length numStages+blockSize.
AnnaBridge	146:22da6e220af6	3968	* @param[in] blockSize number of samples to process per call.
AnnaBridge	146:22da6e220af6	3969	*/
AnnaBridge	146:22da6e220af6	3970	void arm_iir_lattice_init_q15(
AnnaBridge	146:22da6e220af6	3971	arm_iir_lattice_instance_q15 * S,
AnnaBridge	146:22da6e220af6	3972	uint16_t numStages,
AnnaBridge	146:22da6e220af6	3973	q15_t * pkCoeffs,
AnnaBridge	146:22da6e220af6	3974	q15_t * pvCoeffs,
AnnaBridge	146:22da6e220af6	3975	q15_t * pState,
AnnaBridge	146:22da6e220af6	3976	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	3977
AnnaBridge	146:22da6e220af6	3978
AnnaBridge	146:22da6e220af6	3979	/**
AnnaBridge	146:22da6e220af6	3980	* @brief Instance structure for the floating-point LMS filter.
AnnaBridge	146:22da6e220af6	3981	*/
AnnaBridge	146:22da6e220af6	3982	typedef struct
AnnaBridge	146:22da6e220af6	3983	{
AnnaBridge	146:22da6e220af6	3984	uint16_t numTaps; /*< number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	3985	float32_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	3986	float32_t pCoeffs; /< points to the coefficient array. The array is of length numTaps. /
AnnaBridge	146:22da6e220af6	3987	float32_t mu; /*< step size that controls filter coefficient updates. /
AnnaBridge	146:22da6e220af6	3988	} arm_lms_instance_f32;
AnnaBridge	146:22da6e220af6	3989
AnnaBridge	146:22da6e220af6	3990
AnnaBridge	146:22da6e220af6	3991	/**
AnnaBridge	146:22da6e220af6	3992	* @brief Processing function for floating-point LMS filter.
AnnaBridge	146:22da6e220af6	3993	* @param[in] S points to an instance of the floating-point LMS filter structure.
AnnaBridge	146:22da6e220af6	3994	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	3995	* @param[in] pRef points to the block of reference data.
AnnaBridge	146:22da6e220af6	3996	* @param[out] pOut points to the block of output data.
AnnaBridge	146:22da6e220af6	3997	* @param[out] pErr points to the block of error data.
AnnaBridge	146:22da6e220af6	3998	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	3999	*/
AnnaBridge	146:22da6e220af6	4000	void arm_lms_f32(
AnnaBridge	146:22da6e220af6	4001	const arm_lms_instance_f32 * S,
AnnaBridge	146:22da6e220af6	4002	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	4003	float32_t * pRef,
AnnaBridge	146:22da6e220af6	4004	float32_t * pOut,
AnnaBridge	146:22da6e220af6	4005	float32_t * pErr,
AnnaBridge	146:22da6e220af6	4006	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4007
AnnaBridge	146:22da6e220af6	4008
AnnaBridge	146:22da6e220af6	4009	/**
AnnaBridge	146:22da6e220af6	4010	* @brief Initialization function for floating-point LMS filter.
AnnaBridge	146:22da6e220af6	4011	* @param[in] S points to an instance of the floating-point LMS filter structure.
AnnaBridge	146:22da6e220af6	4012	* @param[in] numTaps number of filter coefficients.
AnnaBridge	146:22da6e220af6	4013	* @param[in] pCoeffs points to the coefficient buffer.
AnnaBridge	146:22da6e220af6	4014	* @param[in] pState points to state buffer.
AnnaBridge	146:22da6e220af6	4015	* @param[in] mu step size that controls filter coefficient updates.
AnnaBridge	146:22da6e220af6	4016	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	4017	*/
AnnaBridge	146:22da6e220af6	4018	void arm_lms_init_f32(
AnnaBridge	146:22da6e220af6	4019	arm_lms_instance_f32 * S,
AnnaBridge	146:22da6e220af6	4020	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	4021	float32_t * pCoeffs,
AnnaBridge	146:22da6e220af6	4022	float32_t * pState,
AnnaBridge	146:22da6e220af6	4023	float32_t mu,
AnnaBridge	146:22da6e220af6	4024	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4025
AnnaBridge	146:22da6e220af6	4026
AnnaBridge	146:22da6e220af6	4027	/**
AnnaBridge	146:22da6e220af6	4028	* @brief Instance structure for the Q15 LMS filter.
AnnaBridge	146:22da6e220af6	4029	*/
AnnaBridge	146:22da6e220af6	4030	typedef struct
AnnaBridge	146:22da6e220af6	4031	{
AnnaBridge	146:22da6e220af6	4032	uint16_t numTaps; /*< number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	4033	q15_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	4034	q15_t pCoeffs; /< points to the coefficient array. The array is of length numTaps. /
AnnaBridge	146:22da6e220af6	4035	q15_t mu; /*< step size that controls filter coefficient updates. /
AnnaBridge	146:22da6e220af6	4036	uint32_t postShift; /*< bit shift applied to coefficients. /
AnnaBridge	146:22da6e220af6	4037	} arm_lms_instance_q15;
AnnaBridge	146:22da6e220af6	4038
AnnaBridge	146:22da6e220af6	4039
AnnaBridge	146:22da6e220af6	4040	/**
AnnaBridge	146:22da6e220af6	4041	* @brief Initialization function for the Q15 LMS filter.
AnnaBridge	146:22da6e220af6	4042	* @param[in] S points to an instance of the Q15 LMS filter structure.
AnnaBridge	146:22da6e220af6	4043	* @param[in] numTaps number of filter coefficients.
AnnaBridge	146:22da6e220af6	4044	* @param[in] pCoeffs points to the coefficient buffer.
AnnaBridge	146:22da6e220af6	4045	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	4046	* @param[in] mu step size that controls filter coefficient updates.
AnnaBridge	146:22da6e220af6	4047	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	4048	* @param[in] postShift bit shift applied to coefficients.
AnnaBridge	146:22da6e220af6	4049	*/
AnnaBridge	146:22da6e220af6	4050	void arm_lms_init_q15(
AnnaBridge	146:22da6e220af6	4051	arm_lms_instance_q15 * S,
AnnaBridge	146:22da6e220af6	4052	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	4053	q15_t * pCoeffs,
AnnaBridge	146:22da6e220af6	4054	q15_t * pState,
AnnaBridge	146:22da6e220af6	4055	q15_t mu,
AnnaBridge	146:22da6e220af6	4056	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	4057	uint32_t postShift);
AnnaBridge	146:22da6e220af6	4058
AnnaBridge	146:22da6e220af6	4059
AnnaBridge	146:22da6e220af6	4060	/**
AnnaBridge	146:22da6e220af6	4061	* @brief Processing function for Q15 LMS filter.
AnnaBridge	146:22da6e220af6	4062	* @param[in] S points to an instance of the Q15 LMS filter structure.
AnnaBridge	146:22da6e220af6	4063	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	4064	* @param[in] pRef points to the block of reference data.
AnnaBridge	146:22da6e220af6	4065	* @param[out] pOut points to the block of output data.
AnnaBridge	146:22da6e220af6	4066	* @param[out] pErr points to the block of error data.
AnnaBridge	146:22da6e220af6	4067	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	4068	*/
AnnaBridge	146:22da6e220af6	4069	void arm_lms_q15(
AnnaBridge	146:22da6e220af6	4070	const arm_lms_instance_q15 * S,
AnnaBridge	146:22da6e220af6	4071	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	4072	q15_t * pRef,
AnnaBridge	146:22da6e220af6	4073	q15_t * pOut,
AnnaBridge	146:22da6e220af6	4074	q15_t * pErr,
AnnaBridge	146:22da6e220af6	4075	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4076
AnnaBridge	146:22da6e220af6	4077
AnnaBridge	146:22da6e220af6	4078	/**
AnnaBridge	146:22da6e220af6	4079	* @brief Instance structure for the Q31 LMS filter.
AnnaBridge	146:22da6e220af6	4080	*/
AnnaBridge	146:22da6e220af6	4081	typedef struct
AnnaBridge	146:22da6e220af6	4082	{
AnnaBridge	146:22da6e220af6	4083	uint16_t numTaps; /*< number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	4084	q31_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	4085	q31_t pCoeffs; /< points to the coefficient array. The array is of length numTaps. /
AnnaBridge	146:22da6e220af6	4086	q31_t mu; /*< step size that controls filter coefficient updates. /
AnnaBridge	146:22da6e220af6	4087	uint32_t postShift; /*< bit shift applied to coefficients. /
AnnaBridge	146:22da6e220af6	4088	} arm_lms_instance_q31;
AnnaBridge	146:22da6e220af6	4089
AnnaBridge	146:22da6e220af6	4090
AnnaBridge	146:22da6e220af6	4091	/**
AnnaBridge	146:22da6e220af6	4092	* @brief Processing function for Q31 LMS filter.
AnnaBridge	146:22da6e220af6	4093	* @param[in] S points to an instance of the Q15 LMS filter structure.
AnnaBridge	146:22da6e220af6	4094	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	4095	* @param[in] pRef points to the block of reference data.
AnnaBridge	146:22da6e220af6	4096	* @param[out] pOut points to the block of output data.
AnnaBridge	146:22da6e220af6	4097	* @param[out] pErr points to the block of error data.
AnnaBridge	146:22da6e220af6	4098	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	4099	*/
AnnaBridge	146:22da6e220af6	4100	void arm_lms_q31(
AnnaBridge	146:22da6e220af6	4101	const arm_lms_instance_q31 * S,
AnnaBridge	146:22da6e220af6	4102	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	4103	q31_t * pRef,
AnnaBridge	146:22da6e220af6	4104	q31_t * pOut,
AnnaBridge	146:22da6e220af6	4105	q31_t * pErr,
AnnaBridge	146:22da6e220af6	4106	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4107
AnnaBridge	146:22da6e220af6	4108
AnnaBridge	146:22da6e220af6	4109	/**
AnnaBridge	146:22da6e220af6	4110	* @brief Initialization function for Q31 LMS filter.
AnnaBridge	146:22da6e220af6	4111	* @param[in] S points to an instance of the Q31 LMS filter structure.
AnnaBridge	146:22da6e220af6	4112	* @param[in] numTaps number of filter coefficients.
AnnaBridge	146:22da6e220af6	4113	* @param[in] pCoeffs points to coefficient buffer.
AnnaBridge	146:22da6e220af6	4114	* @param[in] pState points to state buffer.
AnnaBridge	146:22da6e220af6	4115	* @param[in] mu step size that controls filter coefficient updates.
AnnaBridge	146:22da6e220af6	4116	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	4117	* @param[in] postShift bit shift applied to coefficients.
AnnaBridge	146:22da6e220af6	4118	*/
AnnaBridge	146:22da6e220af6	4119	void arm_lms_init_q31(
AnnaBridge	146:22da6e220af6	4120	arm_lms_instance_q31 * S,
AnnaBridge	146:22da6e220af6	4121	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	4122	q31_t * pCoeffs,
AnnaBridge	146:22da6e220af6	4123	q31_t * pState,
AnnaBridge	146:22da6e220af6	4124	q31_t mu,
AnnaBridge	146:22da6e220af6	4125	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	4126	uint32_t postShift);
AnnaBridge	146:22da6e220af6	4127
AnnaBridge	146:22da6e220af6	4128
AnnaBridge	146:22da6e220af6	4129	/**
AnnaBridge	146:22da6e220af6	4130	* @brief Instance structure for the floating-point normalized LMS filter.
AnnaBridge	146:22da6e220af6	4131	*/
AnnaBridge	146:22da6e220af6	4132	typedef struct
AnnaBridge	146:22da6e220af6	4133	{
AnnaBridge	146:22da6e220af6	4134	uint16_t numTaps; /*< number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	4135	float32_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	4136	float32_t pCoeffs; /< points to the coefficient array. The array is of length numTaps. /
AnnaBridge	146:22da6e220af6	4137	float32_t mu; /*< step size that control filter coefficient updates. /
AnnaBridge	146:22da6e220af6	4138	float32_t energy; /*< saves previous frame energy. /
AnnaBridge	146:22da6e220af6	4139	float32_t x0; /*< saves previous input sample. /
AnnaBridge	146:22da6e220af6	4140	} arm_lms_norm_instance_f32;
AnnaBridge	146:22da6e220af6	4141
AnnaBridge	146:22da6e220af6	4142
AnnaBridge	146:22da6e220af6	4143	/**
AnnaBridge	146:22da6e220af6	4144	* @brief Processing function for floating-point normalized LMS filter.
AnnaBridge	146:22da6e220af6	4145	* @param[in] S points to an instance of the floating-point normalized LMS filter structure.
AnnaBridge	146:22da6e220af6	4146	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	4147	* @param[in] pRef points to the block of reference data.
AnnaBridge	146:22da6e220af6	4148	* @param[out] pOut points to the block of output data.
AnnaBridge	146:22da6e220af6	4149	* @param[out] pErr points to the block of error data.
AnnaBridge	146:22da6e220af6	4150	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	4151	*/
AnnaBridge	146:22da6e220af6	4152	void arm_lms_norm_f32(
AnnaBridge	146:22da6e220af6	4153	arm_lms_norm_instance_f32 * S,
AnnaBridge	146:22da6e220af6	4154	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	4155	float32_t * pRef,
AnnaBridge	146:22da6e220af6	4156	float32_t * pOut,
AnnaBridge	146:22da6e220af6	4157	float32_t * pErr,
AnnaBridge	146:22da6e220af6	4158	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4159
AnnaBridge	146:22da6e220af6	4160
AnnaBridge	146:22da6e220af6	4161	/**
AnnaBridge	146:22da6e220af6	4162	* @brief Initialization function for floating-point normalized LMS filter.
AnnaBridge	146:22da6e220af6	4163	* @param[in] S points to an instance of the floating-point LMS filter structure.
AnnaBridge	146:22da6e220af6	4164	* @param[in] numTaps number of filter coefficients.
AnnaBridge	146:22da6e220af6	4165	* @param[in] pCoeffs points to coefficient buffer.
AnnaBridge	146:22da6e220af6	4166	* @param[in] pState points to state buffer.
AnnaBridge	146:22da6e220af6	4167	* @param[in] mu step size that controls filter coefficient updates.
AnnaBridge	146:22da6e220af6	4168	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	4169	*/
AnnaBridge	146:22da6e220af6	4170	void arm_lms_norm_init_f32(
AnnaBridge	146:22da6e220af6	4171	arm_lms_norm_instance_f32 * S,
AnnaBridge	146:22da6e220af6	4172	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	4173	float32_t * pCoeffs,
AnnaBridge	146:22da6e220af6	4174	float32_t * pState,
AnnaBridge	146:22da6e220af6	4175	float32_t mu,
AnnaBridge	146:22da6e220af6	4176	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4177
AnnaBridge	146:22da6e220af6	4178
AnnaBridge	146:22da6e220af6	4179	/**
AnnaBridge	146:22da6e220af6	4180	* @brief Instance structure for the Q31 normalized LMS filter.
AnnaBridge	146:22da6e220af6	4181	*/
AnnaBridge	146:22da6e220af6	4182	typedef struct
AnnaBridge	146:22da6e220af6	4183	{
AnnaBridge	146:22da6e220af6	4184	uint16_t numTaps; /*< number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	4185	q31_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	4186	q31_t pCoeffs; /< points to the coefficient array. The array is of length numTaps. /
AnnaBridge	146:22da6e220af6	4187	q31_t mu; /*< step size that controls filter coefficient updates. /
AnnaBridge	146:22da6e220af6	4188	uint8_t postShift; /*< bit shift applied to coefficients. /
AnnaBridge	146:22da6e220af6	4189	q31_t recipTable; /< points to the reciprocal initial value table. /
AnnaBridge	146:22da6e220af6	4190	q31_t energy; /*< saves previous frame energy. /
AnnaBridge	146:22da6e220af6	4191	q31_t x0; /*< saves previous input sample. /
AnnaBridge	146:22da6e220af6	4192	} arm_lms_norm_instance_q31;
AnnaBridge	146:22da6e220af6	4193
AnnaBridge	146:22da6e220af6	4194
AnnaBridge	146:22da6e220af6	4195	/**
AnnaBridge	146:22da6e220af6	4196	* @brief Processing function for Q31 normalized LMS filter.
AnnaBridge	146:22da6e220af6	4197	* @param[in] S points to an instance of the Q31 normalized LMS filter structure.
AnnaBridge	146:22da6e220af6	4198	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	4199	* @param[in] pRef points to the block of reference data.
AnnaBridge	146:22da6e220af6	4200	* @param[out] pOut points to the block of output data.
AnnaBridge	146:22da6e220af6	4201	* @param[out] pErr points to the block of error data.
AnnaBridge	146:22da6e220af6	4202	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	4203	*/
AnnaBridge	146:22da6e220af6	4204	void arm_lms_norm_q31(
AnnaBridge	146:22da6e220af6	4205	arm_lms_norm_instance_q31 * S,
AnnaBridge	146:22da6e220af6	4206	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	4207	q31_t * pRef,
AnnaBridge	146:22da6e220af6	4208	q31_t * pOut,
AnnaBridge	146:22da6e220af6	4209	q31_t * pErr,
AnnaBridge	146:22da6e220af6	4210	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4211
AnnaBridge	146:22da6e220af6	4212
AnnaBridge	146:22da6e220af6	4213	/**
AnnaBridge	146:22da6e220af6	4214	* @brief Initialization function for Q31 normalized LMS filter.
AnnaBridge	146:22da6e220af6	4215	* @param[in] S points to an instance of the Q31 normalized LMS filter structure.
AnnaBridge	146:22da6e220af6	4216	* @param[in] numTaps number of filter coefficients.
AnnaBridge	146:22da6e220af6	4217	* @param[in] pCoeffs points to coefficient buffer.
AnnaBridge	146:22da6e220af6	4218	* @param[in] pState points to state buffer.
AnnaBridge	146:22da6e220af6	4219	* @param[in] mu step size that controls filter coefficient updates.
AnnaBridge	146:22da6e220af6	4220	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	4221	* @param[in] postShift bit shift applied to coefficients.
AnnaBridge	146:22da6e220af6	4222	*/
AnnaBridge	146:22da6e220af6	4223	void arm_lms_norm_init_q31(
AnnaBridge	146:22da6e220af6	4224	arm_lms_norm_instance_q31 * S,
AnnaBridge	146:22da6e220af6	4225	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	4226	q31_t * pCoeffs,
AnnaBridge	146:22da6e220af6	4227	q31_t * pState,
AnnaBridge	146:22da6e220af6	4228	q31_t mu,
AnnaBridge	146:22da6e220af6	4229	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	4230	uint8_t postShift);
AnnaBridge	146:22da6e220af6	4231
AnnaBridge	146:22da6e220af6	4232
AnnaBridge	146:22da6e220af6	4233	/**
AnnaBridge	146:22da6e220af6	4234	* @brief Instance structure for the Q15 normalized LMS filter.
AnnaBridge	146:22da6e220af6	4235	*/
AnnaBridge	146:22da6e220af6	4236	typedef struct
AnnaBridge	146:22da6e220af6	4237	{
AnnaBridge	146:22da6e220af6	4238	uint16_t numTaps; /*< Number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	4239	q15_t pState; /< points to the state variable array. The array is of length numTaps+blockSize-1. /
AnnaBridge	146:22da6e220af6	4240	q15_t pCoeffs; /< points to the coefficient array. The array is of length numTaps. /
AnnaBridge	146:22da6e220af6	4241	q15_t mu; /*< step size that controls filter coefficient updates. /
AnnaBridge	146:22da6e220af6	4242	uint8_t postShift; /*< bit shift applied to coefficients. /
AnnaBridge	146:22da6e220af6	4243	q15_t recipTable; /< Points to the reciprocal initial value table. /
AnnaBridge	146:22da6e220af6	4244	q15_t energy; /*< saves previous frame energy. /
AnnaBridge	146:22da6e220af6	4245	q15_t x0; /*< saves previous input sample. /
AnnaBridge	146:22da6e220af6	4246	} arm_lms_norm_instance_q15;
AnnaBridge	146:22da6e220af6	4247
AnnaBridge	146:22da6e220af6	4248
AnnaBridge	146:22da6e220af6	4249	/**
AnnaBridge	146:22da6e220af6	4250	* @brief Processing function for Q15 normalized LMS filter.
AnnaBridge	146:22da6e220af6	4251	* @param[in] S points to an instance of the Q15 normalized LMS filter structure.
AnnaBridge	146:22da6e220af6	4252	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	4253	* @param[in] pRef points to the block of reference data.
AnnaBridge	146:22da6e220af6	4254	* @param[out] pOut points to the block of output data.
AnnaBridge	146:22da6e220af6	4255	* @param[out] pErr points to the block of error data.
AnnaBridge	146:22da6e220af6	4256	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	4257	*/
AnnaBridge	146:22da6e220af6	4258	void arm_lms_norm_q15(
AnnaBridge	146:22da6e220af6	4259	arm_lms_norm_instance_q15 * S,
AnnaBridge	146:22da6e220af6	4260	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	4261	q15_t * pRef,
AnnaBridge	146:22da6e220af6	4262	q15_t * pOut,
AnnaBridge	146:22da6e220af6	4263	q15_t * pErr,
AnnaBridge	146:22da6e220af6	4264	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4265
AnnaBridge	146:22da6e220af6	4266
AnnaBridge	146:22da6e220af6	4267	/**
AnnaBridge	146:22da6e220af6	4268	* @brief Initialization function for Q15 normalized LMS filter.
AnnaBridge	146:22da6e220af6	4269	* @param[in] S points to an instance of the Q15 normalized LMS filter structure.
AnnaBridge	146:22da6e220af6	4270	* @param[in] numTaps number of filter coefficients.
AnnaBridge	146:22da6e220af6	4271	* @param[in] pCoeffs points to coefficient buffer.
AnnaBridge	146:22da6e220af6	4272	* @param[in] pState points to state buffer.
AnnaBridge	146:22da6e220af6	4273	* @param[in] mu step size that controls filter coefficient updates.
AnnaBridge	146:22da6e220af6	4274	* @param[in] blockSize number of samples to process.
AnnaBridge	146:22da6e220af6	4275	* @param[in] postShift bit shift applied to coefficients.
AnnaBridge	146:22da6e220af6	4276	*/
AnnaBridge	146:22da6e220af6	4277	void arm_lms_norm_init_q15(
AnnaBridge	146:22da6e220af6	4278	arm_lms_norm_instance_q15 * S,
AnnaBridge	146:22da6e220af6	4279	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	4280	q15_t * pCoeffs,
AnnaBridge	146:22da6e220af6	4281	q15_t * pState,
AnnaBridge	146:22da6e220af6	4282	q15_t mu,
AnnaBridge	146:22da6e220af6	4283	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	4284	uint8_t postShift);
AnnaBridge	146:22da6e220af6	4285
AnnaBridge	146:22da6e220af6	4286
AnnaBridge	146:22da6e220af6	4287	/**
AnnaBridge	146:22da6e220af6	4288	* @brief Correlation of floating-point sequences.
AnnaBridge	146:22da6e220af6	4289	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	4290	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	4291	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	4292	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	4293	* @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1.
AnnaBridge	146:22da6e220af6	4294	*/
AnnaBridge	146:22da6e220af6	4295	void arm_correlate_f32(
AnnaBridge	146:22da6e220af6	4296	float32_t * pSrcA,
AnnaBridge	146:22da6e220af6	4297	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	4298	float32_t * pSrcB,
AnnaBridge	146:22da6e220af6	4299	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	4300	float32_t * pDst);
AnnaBridge	146:22da6e220af6	4301
AnnaBridge	146:22da6e220af6	4302
AnnaBridge	146:22da6e220af6	4303	/**
AnnaBridge	146:22da6e220af6	4304	* @brief Correlation of Q15 sequences
AnnaBridge	146:22da6e220af6	4305	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	4306	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	4307	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	4308	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	4309	* @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1.
AnnaBridge	146:22da6e220af6	4310	* @param[in] pScratch points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2.
AnnaBridge	146:22da6e220af6	4311	*/
AnnaBridge	146:22da6e220af6	4312	void arm_correlate_opt_q15(
AnnaBridge	146:22da6e220af6	4313	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	4314	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	4315	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	4316	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	4317	q15_t * pDst,
AnnaBridge	146:22da6e220af6	4318	q15_t * pScratch);
AnnaBridge	146:22da6e220af6	4319
AnnaBridge	146:22da6e220af6	4320
AnnaBridge	146:22da6e220af6	4321	/**
AnnaBridge	146:22da6e220af6	4322	* @brief Correlation of Q15 sequences.
AnnaBridge	146:22da6e220af6	4323	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	4324	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	4325	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	4326	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	4327	* @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1.
AnnaBridge	146:22da6e220af6	4328	*/
AnnaBridge	146:22da6e220af6	4329
AnnaBridge	146:22da6e220af6	4330	void arm_correlate_q15(
AnnaBridge	146:22da6e220af6	4331	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	4332	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	4333	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	4334	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	4335	q15_t * pDst);
AnnaBridge	146:22da6e220af6	4336
AnnaBridge	146:22da6e220af6	4337
AnnaBridge	146:22da6e220af6	4338	/**
AnnaBridge	146:22da6e220af6	4339	* @brief Correlation of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4.
AnnaBridge	146:22da6e220af6	4340	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	4341	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	4342	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	4343	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	4344	* @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1.
AnnaBridge	146:22da6e220af6	4345	*/
AnnaBridge	146:22da6e220af6	4346
AnnaBridge	146:22da6e220af6	4347	void arm_correlate_fast_q15(
AnnaBridge	146:22da6e220af6	4348	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	4349	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	4350	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	4351	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	4352	q15_t * pDst);
AnnaBridge	146:22da6e220af6	4353
AnnaBridge	146:22da6e220af6	4354
AnnaBridge	146:22da6e220af6	4355	/**
AnnaBridge	146:22da6e220af6	4356	* @brief Correlation of Q15 sequences (fast version) for Cortex-M3 and Cortex-M4.
AnnaBridge	146:22da6e220af6	4357	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	4358	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	4359	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	4360	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	4361	* @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1.
AnnaBridge	146:22da6e220af6	4362	* @param[in] pScratch points to scratch buffer of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2.
AnnaBridge	146:22da6e220af6	4363	*/
AnnaBridge	146:22da6e220af6	4364	void arm_correlate_fast_opt_q15(
AnnaBridge	146:22da6e220af6	4365	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	4366	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	4367	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	4368	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	4369	q15_t * pDst,
AnnaBridge	146:22da6e220af6	4370	q15_t * pScratch);
AnnaBridge	146:22da6e220af6	4371
AnnaBridge	146:22da6e220af6	4372
AnnaBridge	146:22da6e220af6	4373	/**
AnnaBridge	146:22da6e220af6	4374	* @brief Correlation of Q31 sequences.
AnnaBridge	146:22da6e220af6	4375	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	4376	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	4377	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	4378	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	4379	* @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1.
AnnaBridge	146:22da6e220af6	4380	*/
AnnaBridge	146:22da6e220af6	4381	void arm_correlate_q31(
AnnaBridge	146:22da6e220af6	4382	q31_t * pSrcA,
AnnaBridge	146:22da6e220af6	4383	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	4384	q31_t * pSrcB,
AnnaBridge	146:22da6e220af6	4385	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	4386	q31_t * pDst);
AnnaBridge	146:22da6e220af6	4387
AnnaBridge	146:22da6e220af6	4388
AnnaBridge	146:22da6e220af6	4389	/**
AnnaBridge	146:22da6e220af6	4390	* @brief Correlation of Q31 sequences (fast version) for Cortex-M3 and Cortex-M4
AnnaBridge	146:22da6e220af6	4391	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	4392	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	4393	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	4394	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	4395	* @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1.
AnnaBridge	146:22da6e220af6	4396	*/
AnnaBridge	146:22da6e220af6	4397	void arm_correlate_fast_q31(
AnnaBridge	146:22da6e220af6	4398	q31_t * pSrcA,
AnnaBridge	146:22da6e220af6	4399	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	4400	q31_t * pSrcB,
AnnaBridge	146:22da6e220af6	4401	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	4402	q31_t * pDst);
AnnaBridge	146:22da6e220af6	4403
AnnaBridge	146:22da6e220af6	4404
AnnaBridge	146:22da6e220af6	4405	/**
AnnaBridge	146:22da6e220af6	4406	* @brief Correlation of Q7 sequences.
AnnaBridge	146:22da6e220af6	4407	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	4408	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	4409	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	4410	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	4411	* @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1.
AnnaBridge	146:22da6e220af6	4412	* @param[in] pScratch1 points to scratch buffer(of type q15_t) of size max(srcALen, srcBLen) + 2*min(srcALen, srcBLen) - 2.
AnnaBridge	146:22da6e220af6	4413	* @param[in] pScratch2 points to scratch buffer (of type q15_t) of size min(srcALen, srcBLen).
AnnaBridge	146:22da6e220af6	4414	*/
AnnaBridge	146:22da6e220af6	4415	void arm_correlate_opt_q7(
AnnaBridge	146:22da6e220af6	4416	q7_t * pSrcA,
AnnaBridge	146:22da6e220af6	4417	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	4418	q7_t * pSrcB,
AnnaBridge	146:22da6e220af6	4419	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	4420	q7_t * pDst,
AnnaBridge	146:22da6e220af6	4421	q15_t * pScratch1,
AnnaBridge	146:22da6e220af6	4422	q15_t * pScratch2);
AnnaBridge	146:22da6e220af6	4423
AnnaBridge	146:22da6e220af6	4424
AnnaBridge	146:22da6e220af6	4425	/**
AnnaBridge	146:22da6e220af6	4426	* @brief Correlation of Q7 sequences.
AnnaBridge	146:22da6e220af6	4427	* @param[in] pSrcA points to the first input sequence.
AnnaBridge	146:22da6e220af6	4428	* @param[in] srcALen length of the first input sequence.
AnnaBridge	146:22da6e220af6	4429	* @param[in] pSrcB points to the second input sequence.
AnnaBridge	146:22da6e220af6	4430	* @param[in] srcBLen length of the second input sequence.
AnnaBridge	146:22da6e220af6	4431	* @param[out] pDst points to the block of output data Length 2 * max(srcALen, srcBLen) - 1.
AnnaBridge	146:22da6e220af6	4432	*/
AnnaBridge	146:22da6e220af6	4433	void arm_correlate_q7(
AnnaBridge	146:22da6e220af6	4434	q7_t * pSrcA,
AnnaBridge	146:22da6e220af6	4435	uint32_t srcALen,
AnnaBridge	146:22da6e220af6	4436	q7_t * pSrcB,
AnnaBridge	146:22da6e220af6	4437	uint32_t srcBLen,
AnnaBridge	146:22da6e220af6	4438	q7_t * pDst);
AnnaBridge	146:22da6e220af6	4439
AnnaBridge	146:22da6e220af6	4440
AnnaBridge	146:22da6e220af6	4441	/**
AnnaBridge	146:22da6e220af6	4442	* @brief Instance structure for the floating-point sparse FIR filter.
AnnaBridge	146:22da6e220af6	4443	*/
AnnaBridge	146:22da6e220af6	4444	typedef struct
AnnaBridge	146:22da6e220af6	4445	{
AnnaBridge	146:22da6e220af6	4446	uint16_t numTaps; /*< number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	4447	uint16_t stateIndex; /*< state buffer index. Points to the oldest sample in the state buffer. /
AnnaBridge	146:22da6e220af6	4448	float32_t pState; /< points to the state buffer array. The array is of length maxDelay+blockSize-1. /
AnnaBridge	146:22da6e220af6	4449	float32_t pCoeffs; /< points to the coefficient array. The array is of length numTaps./
AnnaBridge	146:22da6e220af6	4450	uint16_t maxDelay; /*< maximum offset specified by the pTapDelay array. /
AnnaBridge	146:22da6e220af6	4451	int32_t pTapDelay; /< points to the array of delay values. The array is of length numTaps. /
AnnaBridge	146:22da6e220af6	4452	} arm_fir_sparse_instance_f32;
AnnaBridge	146:22da6e220af6	4453
AnnaBridge	146:22da6e220af6	4454	/**
AnnaBridge	146:22da6e220af6	4455	* @brief Instance structure for the Q31 sparse FIR filter.
AnnaBridge	146:22da6e220af6	4456	*/
AnnaBridge	146:22da6e220af6	4457	typedef struct
AnnaBridge	146:22da6e220af6	4458	{
AnnaBridge	146:22da6e220af6	4459	uint16_t numTaps; /*< number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	4460	uint16_t stateIndex; /*< state buffer index. Points to the oldest sample in the state buffer. /
AnnaBridge	146:22da6e220af6	4461	q31_t pState; /< points to the state buffer array. The array is of length maxDelay+blockSize-1. /
AnnaBridge	146:22da6e220af6	4462	q31_t pCoeffs; /< points to the coefficient array. The array is of length numTaps./
AnnaBridge	146:22da6e220af6	4463	uint16_t maxDelay; /*< maximum offset specified by the pTapDelay array. /
AnnaBridge	146:22da6e220af6	4464	int32_t pTapDelay; /< points to the array of delay values. The array is of length numTaps. /
AnnaBridge	146:22da6e220af6	4465	} arm_fir_sparse_instance_q31;
AnnaBridge	146:22da6e220af6	4466
AnnaBridge	146:22da6e220af6	4467	/**
AnnaBridge	146:22da6e220af6	4468	* @brief Instance structure for the Q15 sparse FIR filter.
AnnaBridge	146:22da6e220af6	4469	*/
AnnaBridge	146:22da6e220af6	4470	typedef struct
AnnaBridge	146:22da6e220af6	4471	{
AnnaBridge	146:22da6e220af6	4472	uint16_t numTaps; /*< number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	4473	uint16_t stateIndex; /*< state buffer index. Points to the oldest sample in the state buffer. /
AnnaBridge	146:22da6e220af6	4474	q15_t pState; /< points to the state buffer array. The array is of length maxDelay+blockSize-1. /
AnnaBridge	146:22da6e220af6	4475	q15_t pCoeffs; /< points to the coefficient array. The array is of length numTaps./
AnnaBridge	146:22da6e220af6	4476	uint16_t maxDelay; /*< maximum offset specified by the pTapDelay array. /
AnnaBridge	146:22da6e220af6	4477	int32_t pTapDelay; /< points to the array of delay values. The array is of length numTaps. /
AnnaBridge	146:22da6e220af6	4478	} arm_fir_sparse_instance_q15;
AnnaBridge	146:22da6e220af6	4479
AnnaBridge	146:22da6e220af6	4480	/**
AnnaBridge	146:22da6e220af6	4481	* @brief Instance structure for the Q7 sparse FIR filter.
AnnaBridge	146:22da6e220af6	4482	*/
AnnaBridge	146:22da6e220af6	4483	typedef struct
AnnaBridge	146:22da6e220af6	4484	{
AnnaBridge	146:22da6e220af6	4485	uint16_t numTaps; /*< number of coefficients in the filter. /
AnnaBridge	146:22da6e220af6	4486	uint16_t stateIndex; /*< state buffer index. Points to the oldest sample in the state buffer. /
AnnaBridge	146:22da6e220af6	4487	q7_t pState; /< points to the state buffer array. The array is of length maxDelay+blockSize-1. /
AnnaBridge	146:22da6e220af6	4488	q7_t pCoeffs; /< points to the coefficient array. The array is of length numTaps./
AnnaBridge	146:22da6e220af6	4489	uint16_t maxDelay; /*< maximum offset specified by the pTapDelay array. /
AnnaBridge	146:22da6e220af6	4490	int32_t pTapDelay; /< points to the array of delay values. The array is of length numTaps. /
AnnaBridge	146:22da6e220af6	4491	} arm_fir_sparse_instance_q7;
AnnaBridge	146:22da6e220af6	4492
AnnaBridge	146:22da6e220af6	4493
AnnaBridge	146:22da6e220af6	4494	/**
AnnaBridge	146:22da6e220af6	4495	* @brief Processing function for the floating-point sparse FIR filter.
AnnaBridge	146:22da6e220af6	4496	* @param[in] S points to an instance of the floating-point sparse FIR structure.
AnnaBridge	146:22da6e220af6	4497	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	4498	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	4499	* @param[in] pScratchIn points to a temporary buffer of size blockSize.
AnnaBridge	146:22da6e220af6	4500	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	4501	*/
AnnaBridge	146:22da6e220af6	4502	void arm_fir_sparse_f32(
AnnaBridge	146:22da6e220af6	4503	arm_fir_sparse_instance_f32 * S,
AnnaBridge	146:22da6e220af6	4504	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	4505	float32_t * pDst,
AnnaBridge	146:22da6e220af6	4506	float32_t * pScratchIn,
AnnaBridge	146:22da6e220af6	4507	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4508
AnnaBridge	146:22da6e220af6	4509
AnnaBridge	146:22da6e220af6	4510	/**
AnnaBridge	146:22da6e220af6	4511	* @brief Initialization function for the floating-point sparse FIR filter.
AnnaBridge	146:22da6e220af6	4512	* @param[in,out] S points to an instance of the floating-point sparse FIR structure.
AnnaBridge	146:22da6e220af6	4513	* @param[in] numTaps number of nonzero coefficients in the filter.
AnnaBridge	146:22da6e220af6	4514	* @param[in] pCoeffs points to the array of filter coefficients.
AnnaBridge	146:22da6e220af6	4515	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	4516	* @param[in] pTapDelay points to the array of offset times.
AnnaBridge	146:22da6e220af6	4517	* @param[in] maxDelay maximum offset time supported.
AnnaBridge	146:22da6e220af6	4518	* @param[in] blockSize number of samples that will be processed per block.
AnnaBridge	146:22da6e220af6	4519	*/
AnnaBridge	146:22da6e220af6	4520	void arm_fir_sparse_init_f32(
AnnaBridge	146:22da6e220af6	4521	arm_fir_sparse_instance_f32 * S,
AnnaBridge	146:22da6e220af6	4522	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	4523	float32_t * pCoeffs,
AnnaBridge	146:22da6e220af6	4524	float32_t * pState,
AnnaBridge	146:22da6e220af6	4525	int32_t * pTapDelay,
AnnaBridge	146:22da6e220af6	4526	uint16_t maxDelay,
AnnaBridge	146:22da6e220af6	4527	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4528
AnnaBridge	146:22da6e220af6	4529
AnnaBridge	146:22da6e220af6	4530	/**
AnnaBridge	146:22da6e220af6	4531	* @brief Processing function for the Q31 sparse FIR filter.
AnnaBridge	146:22da6e220af6	4532	* @param[in] S points to an instance of the Q31 sparse FIR structure.
AnnaBridge	146:22da6e220af6	4533	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	4534	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	4535	* @param[in] pScratchIn points to a temporary buffer of size blockSize.
AnnaBridge	146:22da6e220af6	4536	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	4537	*/
AnnaBridge	146:22da6e220af6	4538	void arm_fir_sparse_q31(
AnnaBridge	146:22da6e220af6	4539	arm_fir_sparse_instance_q31 * S,
AnnaBridge	146:22da6e220af6	4540	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	4541	q31_t * pDst,
AnnaBridge	146:22da6e220af6	4542	q31_t * pScratchIn,
AnnaBridge	146:22da6e220af6	4543	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4544
AnnaBridge	146:22da6e220af6	4545
AnnaBridge	146:22da6e220af6	4546	/**
AnnaBridge	146:22da6e220af6	4547	* @brief Initialization function for the Q31 sparse FIR filter.
AnnaBridge	146:22da6e220af6	4548	* @param[in,out] S points to an instance of the Q31 sparse FIR structure.
AnnaBridge	146:22da6e220af6	4549	* @param[in] numTaps number of nonzero coefficients in the filter.
AnnaBridge	146:22da6e220af6	4550	* @param[in] pCoeffs points to the array of filter coefficients.
AnnaBridge	146:22da6e220af6	4551	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	4552	* @param[in] pTapDelay points to the array of offset times.
AnnaBridge	146:22da6e220af6	4553	* @param[in] maxDelay maximum offset time supported.
AnnaBridge	146:22da6e220af6	4554	* @param[in] blockSize number of samples that will be processed per block.
AnnaBridge	146:22da6e220af6	4555	*/
AnnaBridge	146:22da6e220af6	4556	void arm_fir_sparse_init_q31(
AnnaBridge	146:22da6e220af6	4557	arm_fir_sparse_instance_q31 * S,
AnnaBridge	146:22da6e220af6	4558	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	4559	q31_t * pCoeffs,
AnnaBridge	146:22da6e220af6	4560	q31_t * pState,
AnnaBridge	146:22da6e220af6	4561	int32_t * pTapDelay,
AnnaBridge	146:22da6e220af6	4562	uint16_t maxDelay,
AnnaBridge	146:22da6e220af6	4563	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4564
AnnaBridge	146:22da6e220af6	4565
AnnaBridge	146:22da6e220af6	4566	/**
AnnaBridge	146:22da6e220af6	4567	* @brief Processing function for the Q15 sparse FIR filter.
AnnaBridge	146:22da6e220af6	4568	* @param[in] S points to an instance of the Q15 sparse FIR structure.
AnnaBridge	146:22da6e220af6	4569	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	4570	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	4571	* @param[in] pScratchIn points to a temporary buffer of size blockSize.
AnnaBridge	146:22da6e220af6	4572	* @param[in] pScratchOut points to a temporary buffer of size blockSize.
AnnaBridge	146:22da6e220af6	4573	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	4574	*/
AnnaBridge	146:22da6e220af6	4575	void arm_fir_sparse_q15(
AnnaBridge	146:22da6e220af6	4576	arm_fir_sparse_instance_q15 * S,
AnnaBridge	146:22da6e220af6	4577	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	4578	q15_t * pDst,
AnnaBridge	146:22da6e220af6	4579	q15_t * pScratchIn,
AnnaBridge	146:22da6e220af6	4580	q31_t * pScratchOut,
AnnaBridge	146:22da6e220af6	4581	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4582
AnnaBridge	146:22da6e220af6	4583
AnnaBridge	146:22da6e220af6	4584	/**
AnnaBridge	146:22da6e220af6	4585	* @brief Initialization function for the Q15 sparse FIR filter.
AnnaBridge	146:22da6e220af6	4586	* @param[in,out] S points to an instance of the Q15 sparse FIR structure.
AnnaBridge	146:22da6e220af6	4587	* @param[in] numTaps number of nonzero coefficients in the filter.
AnnaBridge	146:22da6e220af6	4588	* @param[in] pCoeffs points to the array of filter coefficients.
AnnaBridge	146:22da6e220af6	4589	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	4590	* @param[in] pTapDelay points to the array of offset times.
AnnaBridge	146:22da6e220af6	4591	* @param[in] maxDelay maximum offset time supported.
AnnaBridge	146:22da6e220af6	4592	* @param[in] blockSize number of samples that will be processed per block.
AnnaBridge	146:22da6e220af6	4593	*/
AnnaBridge	146:22da6e220af6	4594	void arm_fir_sparse_init_q15(
AnnaBridge	146:22da6e220af6	4595	arm_fir_sparse_instance_q15 * S,
AnnaBridge	146:22da6e220af6	4596	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	4597	q15_t * pCoeffs,
AnnaBridge	146:22da6e220af6	4598	q15_t * pState,
AnnaBridge	146:22da6e220af6	4599	int32_t * pTapDelay,
AnnaBridge	146:22da6e220af6	4600	uint16_t maxDelay,
AnnaBridge	146:22da6e220af6	4601	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4602
AnnaBridge	146:22da6e220af6	4603
AnnaBridge	146:22da6e220af6	4604	/**
AnnaBridge	146:22da6e220af6	4605	* @brief Processing function for the Q7 sparse FIR filter.
AnnaBridge	146:22da6e220af6	4606	* @param[in] S points to an instance of the Q7 sparse FIR structure.
AnnaBridge	146:22da6e220af6	4607	* @param[in] pSrc points to the block of input data.
AnnaBridge	146:22da6e220af6	4608	* @param[out] pDst points to the block of output data
AnnaBridge	146:22da6e220af6	4609	* @param[in] pScratchIn points to a temporary buffer of size blockSize.
AnnaBridge	146:22da6e220af6	4610	* @param[in] pScratchOut points to a temporary buffer of size blockSize.
AnnaBridge	146:22da6e220af6	4611	* @param[in] blockSize number of input samples to process per call.
AnnaBridge	146:22da6e220af6	4612	*/
AnnaBridge	146:22da6e220af6	4613	void arm_fir_sparse_q7(
AnnaBridge	146:22da6e220af6	4614	arm_fir_sparse_instance_q7 * S,
AnnaBridge	146:22da6e220af6	4615	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	4616	q7_t * pDst,
AnnaBridge	146:22da6e220af6	4617	q7_t * pScratchIn,
AnnaBridge	146:22da6e220af6	4618	q31_t * pScratchOut,
AnnaBridge	146:22da6e220af6	4619	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4620
AnnaBridge	146:22da6e220af6	4621
AnnaBridge	146:22da6e220af6	4622	/**
AnnaBridge	146:22da6e220af6	4623	* @brief Initialization function for the Q7 sparse FIR filter.
AnnaBridge	146:22da6e220af6	4624	* @param[in,out] S points to an instance of the Q7 sparse FIR structure.
AnnaBridge	146:22da6e220af6	4625	* @param[in] numTaps number of nonzero coefficients in the filter.
AnnaBridge	146:22da6e220af6	4626	* @param[in] pCoeffs points to the array of filter coefficients.
AnnaBridge	146:22da6e220af6	4627	* @param[in] pState points to the state buffer.
AnnaBridge	146:22da6e220af6	4628	* @param[in] pTapDelay points to the array of offset times.
AnnaBridge	146:22da6e220af6	4629	* @param[in] maxDelay maximum offset time supported.
AnnaBridge	146:22da6e220af6	4630	* @param[in] blockSize number of samples that will be processed per block.
AnnaBridge	146:22da6e220af6	4631	*/
AnnaBridge	146:22da6e220af6	4632	void arm_fir_sparse_init_q7(
AnnaBridge	146:22da6e220af6	4633	arm_fir_sparse_instance_q7 * S,
AnnaBridge	146:22da6e220af6	4634	uint16_t numTaps,
AnnaBridge	146:22da6e220af6	4635	q7_t * pCoeffs,
AnnaBridge	146:22da6e220af6	4636	q7_t * pState,
AnnaBridge	146:22da6e220af6	4637	int32_t * pTapDelay,
AnnaBridge	146:22da6e220af6	4638	uint16_t maxDelay,
AnnaBridge	146:22da6e220af6	4639	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	4640
AnnaBridge	146:22da6e220af6	4641
AnnaBridge	146:22da6e220af6	4642	/**
AnnaBridge	146:22da6e220af6	4643	* @brief Floating-point sin_cos function.
AnnaBridge	146:22da6e220af6	4644	* @param[in] theta input value in degrees
AnnaBridge	146:22da6e220af6	4645	* @param[out] pSinVal points to the processed sine output.
AnnaBridge	146:22da6e220af6	4646	* @param[out] pCosVal points to the processed cos output.
AnnaBridge	146:22da6e220af6	4647	*/
AnnaBridge	146:22da6e220af6	4648	void arm_sin_cos_f32(
AnnaBridge	146:22da6e220af6	4649	float32_t theta,
AnnaBridge	146:22da6e220af6	4650	float32_t * pSinVal,
AnnaBridge	146:22da6e220af6	4651	float32_t * pCosVal);
AnnaBridge	146:22da6e220af6	4652
AnnaBridge	146:22da6e220af6	4653
AnnaBridge	146:22da6e220af6	4654	/**
AnnaBridge	146:22da6e220af6	4655	* @brief Q31 sin_cos function.
AnnaBridge	146:22da6e220af6	4656	* @param[in] theta scaled input value in degrees
AnnaBridge	146:22da6e220af6	4657	* @param[out] pSinVal points to the processed sine output.
AnnaBridge	146:22da6e220af6	4658	* @param[out] pCosVal points to the processed cosine output.
AnnaBridge	146:22da6e220af6	4659	*/
AnnaBridge	146:22da6e220af6	4660	void arm_sin_cos_q31(
AnnaBridge	146:22da6e220af6	4661	q31_t theta,
AnnaBridge	146:22da6e220af6	4662	q31_t * pSinVal,
AnnaBridge	146:22da6e220af6	4663	q31_t * pCosVal);
AnnaBridge	146:22da6e220af6	4664
AnnaBridge	146:22da6e220af6	4665
AnnaBridge	146:22da6e220af6	4666	/**
AnnaBridge	146:22da6e220af6	4667	* @brief Floating-point complex conjugate.
AnnaBridge	146:22da6e220af6	4668	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	4669	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	4670	* @param[in] numSamples number of complex samples in each vector
AnnaBridge	146:22da6e220af6	4671	*/
AnnaBridge	146:22da6e220af6	4672	void arm_cmplx_conj_f32(
AnnaBridge	146:22da6e220af6	4673	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	4674	float32_t * pDst,
AnnaBridge	146:22da6e220af6	4675	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	4676
AnnaBridge	146:22da6e220af6	4677	/**
AnnaBridge	146:22da6e220af6	4678	* @brief Q31 complex conjugate.
AnnaBridge	146:22da6e220af6	4679	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	4680	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	4681	* @param[in] numSamples number of complex samples in each vector
AnnaBridge	146:22da6e220af6	4682	*/
AnnaBridge	146:22da6e220af6	4683	void arm_cmplx_conj_q31(
AnnaBridge	146:22da6e220af6	4684	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	4685	q31_t * pDst,
AnnaBridge	146:22da6e220af6	4686	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	4687
AnnaBridge	146:22da6e220af6	4688
AnnaBridge	146:22da6e220af6	4689	/**
AnnaBridge	146:22da6e220af6	4690	* @brief Q15 complex conjugate.
AnnaBridge	146:22da6e220af6	4691	* @param[in] pSrc points to the input vector
AnnaBridge	146:22da6e220af6	4692	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	4693	* @param[in] numSamples number of complex samples in each vector
AnnaBridge	146:22da6e220af6	4694	*/
AnnaBridge	146:22da6e220af6	4695	void arm_cmplx_conj_q15(
AnnaBridge	146:22da6e220af6	4696	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	4697	q15_t * pDst,
AnnaBridge	146:22da6e220af6	4698	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	4699
AnnaBridge	146:22da6e220af6	4700
AnnaBridge	146:22da6e220af6	4701	/**
AnnaBridge	146:22da6e220af6	4702	* @brief Floating-point complex magnitude squared
AnnaBridge	146:22da6e220af6	4703	* @param[in] pSrc points to the complex input vector
AnnaBridge	146:22da6e220af6	4704	* @param[out] pDst points to the real output vector
AnnaBridge	146:22da6e220af6	4705	* @param[in] numSamples number of complex samples in the input vector
AnnaBridge	146:22da6e220af6	4706	*/
AnnaBridge	146:22da6e220af6	4707	void arm_cmplx_mag_squared_f32(
AnnaBridge	146:22da6e220af6	4708	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	4709	float32_t * pDst,
AnnaBridge	146:22da6e220af6	4710	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	4711
AnnaBridge	146:22da6e220af6	4712
AnnaBridge	146:22da6e220af6	4713	/**
AnnaBridge	146:22da6e220af6	4714	* @brief Q31 complex magnitude squared
AnnaBridge	146:22da6e220af6	4715	* @param[in] pSrc points to the complex input vector
AnnaBridge	146:22da6e220af6	4716	* @param[out] pDst points to the real output vector
AnnaBridge	146:22da6e220af6	4717	* @param[in] numSamples number of complex samples in the input vector
AnnaBridge	146:22da6e220af6	4718	*/
AnnaBridge	146:22da6e220af6	4719	void arm_cmplx_mag_squared_q31(
AnnaBridge	146:22da6e220af6	4720	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	4721	q31_t * pDst,
AnnaBridge	146:22da6e220af6	4722	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	4723
AnnaBridge	146:22da6e220af6	4724
AnnaBridge	146:22da6e220af6	4725	/**
AnnaBridge	146:22da6e220af6	4726	* @brief Q15 complex magnitude squared
AnnaBridge	146:22da6e220af6	4727	* @param[in] pSrc points to the complex input vector
AnnaBridge	146:22da6e220af6	4728	* @param[out] pDst points to the real output vector
AnnaBridge	146:22da6e220af6	4729	* @param[in] numSamples number of complex samples in the input vector
AnnaBridge	146:22da6e220af6	4730	*/
AnnaBridge	146:22da6e220af6	4731	void arm_cmplx_mag_squared_q15(
AnnaBridge	146:22da6e220af6	4732	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	4733	q15_t * pDst,
AnnaBridge	146:22da6e220af6	4734	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	4735
AnnaBridge	146:22da6e220af6	4736
AnnaBridge	146:22da6e220af6	4737	/**
AnnaBridge	146:22da6e220af6	4738	* @ingroup groupController
AnnaBridge	146:22da6e220af6	4739	*/
AnnaBridge	146:22da6e220af6	4740
AnnaBridge	146:22da6e220af6	4741	/**
AnnaBridge	146:22da6e220af6	4742	* @defgroup PID PID Motor Control
AnnaBridge	146:22da6e220af6	4743	*
AnnaBridge	146:22da6e220af6	4744	* A Proportional Integral Derivative (PID) controller is a generic feedback control
AnnaBridge	146:22da6e220af6	4745	* loop mechanism widely used in industrial control systems.
AnnaBridge	146:22da6e220af6	4746	* A PID controller is the most commonly used type of feedback controller.
AnnaBridge	146:22da6e220af6	4747	*
AnnaBridge	146:22da6e220af6	4748	* This set of functions implements (PID) controllers
AnnaBridge	146:22da6e220af6	4749	* for Q15, Q31, and floating-point data types. The functions operate on a single sample
AnnaBridge	146:22da6e220af6	4750	* of data and each call to the function returns a single processed value.
AnnaBridge	146:22da6e220af6	4751	* <code>S</code> points to an instance of the PID control data structure. <code>in</code>
AnnaBridge	146:22da6e220af6	4752	* is the input sample value. The functions return the output value.
AnnaBridge	146:22da6e220af6	4753	*
AnnaBridge	146:22da6e220af6	4754	* \par Algorithm:
AnnaBridge	146:22da6e220af6	4755	* <pre>
AnnaBridge	146:22da6e220af6	4756	* y[n] = y[n-1] + A0 * x[n] + A1 * x[n-1] + A2 * x[n-2]
AnnaBridge	146:22da6e220af6	4757	* A0 = Kp + Ki + Kd
AnnaBridge	146:22da6e220af6	4758	* A1 = (-Kp ) - (2 * Kd )
AnnaBridge	146:22da6e220af6	4759	* A2 = Kd </pre>
AnnaBridge	146:22da6e220af6	4760	*
AnnaBridge	146:22da6e220af6	4761	* \par
AnnaBridge	146:22da6e220af6	4762	* where \c Kp is proportional constant, \c Ki is Integral constant and \c Kd is Derivative constant
AnnaBridge	146:22da6e220af6	4763	*
AnnaBridge	146:22da6e220af6	4764	* \par
AnnaBridge	146:22da6e220af6	4765	* \image html PID.gif "Proportional Integral Derivative Controller"
AnnaBridge	146:22da6e220af6	4766	*
AnnaBridge	146:22da6e220af6	4767	* \par
AnnaBridge	146:22da6e220af6	4768	* The PID controller calculates an "error" value as the difference between
AnnaBridge	146:22da6e220af6	4769	* the measured output and the reference input.
AnnaBridge	146:22da6e220af6	4770	* The controller attempts to minimize the error by adjusting the process control inputs.
AnnaBridge	146:22da6e220af6	4771	* The proportional value determines the reaction to the current error,
AnnaBridge	146:22da6e220af6	4772	* the integral value determines the reaction based on the sum of recent errors,
AnnaBridge	146:22da6e220af6	4773	* and the derivative value determines the reaction based on the rate at which the error has been changing.
AnnaBridge	146:22da6e220af6	4774	*
AnnaBridge	146:22da6e220af6	4775	* \par Instance Structure
AnnaBridge	146:22da6e220af6	4776	* The Gains A0, A1, A2 and state variables for a PID controller are stored together in an instance data structure.
AnnaBridge	146:22da6e220af6	4777	* A separate instance structure must be defined for each PID Controller.
AnnaBridge	146:22da6e220af6	4778	* There are separate instance structure declarations for each of the 3 supported data types.
AnnaBridge	146:22da6e220af6	4779	*
AnnaBridge	146:22da6e220af6	4780	* \par Reset Functions
AnnaBridge	146:22da6e220af6	4781	* There is also an associated reset function for each data type which clears the state array.
AnnaBridge	146:22da6e220af6	4782	*
AnnaBridge	146:22da6e220af6	4783	* \par Initialization Functions
AnnaBridge	146:22da6e220af6	4784	* There is also an associated initialization function for each data type.
AnnaBridge	146:22da6e220af6	4785	* The initialization function performs the following operations:
AnnaBridge	146:22da6e220af6	4786	* - Initializes the Gains A0, A1, A2 from Kp,Ki, Kd gains.
AnnaBridge	146:22da6e220af6	4787	* - Zeros out the values in the state buffer.
AnnaBridge	146:22da6e220af6	4788	*
AnnaBridge	146:22da6e220af6	4789	* \par
AnnaBridge	146:22da6e220af6	4790	* Instance structure cannot be placed into a const data section and it is recommended to use the initialization function.
AnnaBridge	146:22da6e220af6	4791	*
AnnaBridge	146:22da6e220af6	4792	* \par Fixed-Point Behavior
AnnaBridge	146:22da6e220af6	4793	* Care must be taken when using the fixed-point versions of the PID Controller functions.
AnnaBridge	146:22da6e220af6	4794	* In particular, the overflow and saturation behavior of the accumulator used in each function must be considered.
AnnaBridge	146:22da6e220af6	4795	* Refer to the function specific documentation below for usage guidelines.
AnnaBridge	146:22da6e220af6	4796	*/
AnnaBridge	146:22da6e220af6	4797
AnnaBridge	146:22da6e220af6	4798	/**
AnnaBridge	146:22da6e220af6	4799	* @addtogroup PID
AnnaBridge	146:22da6e220af6	4800	* @{
AnnaBridge	146:22da6e220af6	4801	*/
AnnaBridge	146:22da6e220af6	4802
AnnaBridge	146:22da6e220af6	4803	/**
AnnaBridge	146:22da6e220af6	4804	* @brief Process function for the floating-point PID Control.
AnnaBridge	146:22da6e220af6	4805	* @param[in,out] S is an instance of the floating-point PID Control structure
AnnaBridge	146:22da6e220af6	4806	* @param[in] in input sample to process
AnnaBridge	146:22da6e220af6	4807	* @return out processed output sample.
AnnaBridge	146:22da6e220af6	4808	*/
AnnaBridge	146:22da6e220af6	4809	CMSIS_INLINE __STATIC_INLINE float32_t arm_pid_f32(
AnnaBridge	146:22da6e220af6	4810	arm_pid_instance_f32 * S,
AnnaBridge	146:22da6e220af6	4811	float32_t in)
AnnaBridge	146:22da6e220af6	4812	{
AnnaBridge	146:22da6e220af6	4813	float32_t out;
AnnaBridge	146:22da6e220af6	4814
AnnaBridge	146:22da6e220af6	4815	/* y[n] = y[n-1] + A0 * x[n] + A1 * x[n-1] + A2 * x[n-2] */
AnnaBridge	146:22da6e220af6	4816	out = (S->A0 * in) +
AnnaBridge	146:22da6e220af6	4817	(S->A1 * S->state[0]) + (S->A2 * S->state[1]) + (S->state[2]);
AnnaBridge	146:22da6e220af6	4818
AnnaBridge	146:22da6e220af6	4819	/* Update state */
AnnaBridge	146:22da6e220af6	4820	S->state[1] = S->state[0];
AnnaBridge	146:22da6e220af6	4821	S->state[0] = in;
AnnaBridge	146:22da6e220af6	4822	S->state[2] = out;
AnnaBridge	146:22da6e220af6	4823
AnnaBridge	146:22da6e220af6	4824	/* return to application */
AnnaBridge	146:22da6e220af6	4825	return (out);
AnnaBridge	146:22da6e220af6	4826
AnnaBridge	146:22da6e220af6	4827	}
AnnaBridge	146:22da6e220af6	4828
AnnaBridge	146:22da6e220af6	4829	/**
AnnaBridge	146:22da6e220af6	4830	* @brief Process function for the Q31 PID Control.
AnnaBridge	146:22da6e220af6	4831	* @param[in,out] S points to an instance of the Q31 PID Control structure
AnnaBridge	146:22da6e220af6	4832	* @param[in] in input sample to process
AnnaBridge	146:22da6e220af6	4833	* @return out processed output sample.
AnnaBridge	146:22da6e220af6	4834	*
AnnaBridge	146:22da6e220af6	4835	* <b>Scaling and Overflow Behavior:</b>
AnnaBridge	146:22da6e220af6	4836	* \par
AnnaBridge	146:22da6e220af6	4837	* The function is implemented using an internal 64-bit accumulator.
AnnaBridge	146:22da6e220af6	4838	* The accumulator has a 2.62 format and maintains full precision of the intermediate multiplication results but provides only a single guard bit.
AnnaBridge	146:22da6e220af6	4839	* Thus, if the accumulator result overflows it wraps around rather than clip.
AnnaBridge	146:22da6e220af6	4840	* In order to avoid overflows completely the input signal must be scaled down by 2 bits as there are four additions.
AnnaBridge	146:22da6e220af6	4841	* After all multiply-accumulates are performed, the 2.62 accumulator is truncated to 1.32 format and then saturated to 1.31 format.
AnnaBridge	146:22da6e220af6	4842	*/
AnnaBridge	146:22da6e220af6	4843	CMSIS_INLINE __STATIC_INLINE q31_t arm_pid_q31(
AnnaBridge	146:22da6e220af6	4844	arm_pid_instance_q31 * S,
AnnaBridge	146:22da6e220af6	4845	q31_t in)
AnnaBridge	146:22da6e220af6	4846	{
AnnaBridge	146:22da6e220af6	4847	q63_t acc;
AnnaBridge	146:22da6e220af6	4848	q31_t out;
AnnaBridge	146:22da6e220af6	4849
AnnaBridge	146:22da6e220af6	4850	/* acc = A0 * x[n] */
AnnaBridge	146:22da6e220af6	4851	acc = (q63_t) S->A0 * in;
AnnaBridge	146:22da6e220af6	4852
AnnaBridge	146:22da6e220af6	4853	/* acc += A1 * x[n-1] */
AnnaBridge	146:22da6e220af6	4854	acc += (q63_t) S->A1 * S->state[0];
AnnaBridge	146:22da6e220af6	4855
AnnaBridge	146:22da6e220af6	4856	/* acc += A2 * x[n-2] */
AnnaBridge	146:22da6e220af6	4857	acc += (q63_t) S->A2 * S->state[1];
AnnaBridge	146:22da6e220af6	4858
AnnaBridge	146:22da6e220af6	4859	/* convert output to 1.31 format to add y[n-1] */
AnnaBridge	146:22da6e220af6	4860	out = (q31_t) (acc >> 31u);
AnnaBridge	146:22da6e220af6	4861
AnnaBridge	146:22da6e220af6	4862	/* out += y[n-1] */
AnnaBridge	146:22da6e220af6	4863	out += S->state[2];
AnnaBridge	146:22da6e220af6	4864
AnnaBridge	146:22da6e220af6	4865	/* Update state */
AnnaBridge	146:22da6e220af6	4866	S->state[1] = S->state[0];
AnnaBridge	146:22da6e220af6	4867	S->state[0] = in;
AnnaBridge	146:22da6e220af6	4868	S->state[2] = out;
AnnaBridge	146:22da6e220af6	4869
AnnaBridge	146:22da6e220af6	4870	/* return to application */
AnnaBridge	146:22da6e220af6	4871	return (out);
AnnaBridge	146:22da6e220af6	4872	}
AnnaBridge	146:22da6e220af6	4873
AnnaBridge	146:22da6e220af6	4874
AnnaBridge	146:22da6e220af6	4875	/**
AnnaBridge	146:22da6e220af6	4876	* @brief Process function for the Q15 PID Control.
AnnaBridge	146:22da6e220af6	4877	* @param[in,out] S points to an instance of the Q15 PID Control structure
AnnaBridge	146:22da6e220af6	4878	* @param[in] in input sample to process
AnnaBridge	146:22da6e220af6	4879	* @return out processed output sample.
AnnaBridge	146:22da6e220af6	4880	*
AnnaBridge	146:22da6e220af6	4881	* <b>Scaling and Overflow Behavior:</b>
AnnaBridge	146:22da6e220af6	4882	* \par
AnnaBridge	146:22da6e220af6	4883	* The function is implemented using a 64-bit internal accumulator.
AnnaBridge	146:22da6e220af6	4884	* Both Gains and state variables are represented in 1.15 format and multiplications yield a 2.30 result.
AnnaBridge	146:22da6e220af6	4885	* The 2.30 intermediate results are accumulated in a 64-bit accumulator in 34.30 format.
AnnaBridge	146:22da6e220af6	4886	* There is no risk of internal overflow with this approach and the full precision of intermediate multiplications is preserved.
AnnaBridge	146:22da6e220af6	4887	* After all additions have been performed, the accumulator is truncated to 34.15 format by discarding low 15 bits.
AnnaBridge	146:22da6e220af6	4888	* Lastly, the accumulator is saturated to yield a result in 1.15 format.
AnnaBridge	146:22da6e220af6	4889	*/
AnnaBridge	146:22da6e220af6	4890	CMSIS_INLINE __STATIC_INLINE q15_t arm_pid_q15(
AnnaBridge	146:22da6e220af6	4891	arm_pid_instance_q15 * S,
AnnaBridge	146:22da6e220af6	4892	q15_t in)
AnnaBridge	146:22da6e220af6	4893	{
AnnaBridge	146:22da6e220af6	4894	q63_t acc;
AnnaBridge	146:22da6e220af6	4895	q15_t out;
AnnaBridge	146:22da6e220af6	4896
AnnaBridge	146:22da6e220af6	4897	#if defined (ARM_MATH_DSP)
AnnaBridge	146:22da6e220af6	4898	__SIMD32_TYPE *vstate;
AnnaBridge	146:22da6e220af6	4899
AnnaBridge	146:22da6e220af6	4900	/* Implementation of PID controller */
AnnaBridge	146:22da6e220af6	4901
AnnaBridge	146:22da6e220af6	4902	/* acc = A0 * x[n] */
AnnaBridge	146:22da6e220af6	4903	acc = (q31_t) __SMUAD((uint32_t)S->A0, (uint32_t)in);
AnnaBridge	146:22da6e220af6	4904
AnnaBridge	146:22da6e220af6	4905	/* acc += A1 * x[n-1] + A2 * x[n-2] */
AnnaBridge	146:22da6e220af6	4906	vstate = __SIMD32_CONST(S->state);
AnnaBridge	146:22da6e220af6	4907	acc = (q63_t)__SMLALD((uint32_t)S->A1, (uint32_t)*vstate, (uint64_t)acc);
AnnaBridge	146:22da6e220af6	4908	#else
AnnaBridge	146:22da6e220af6	4909	/* acc = A0 * x[n] */
AnnaBridge	146:22da6e220af6	4910	acc = ((q31_t) S->A0) * in;
AnnaBridge	146:22da6e220af6	4911
AnnaBridge	146:22da6e220af6	4912	/* acc += A1 * x[n-1] + A2 * x[n-2] */
AnnaBridge	146:22da6e220af6	4913	acc += (q31_t) S->A1 * S->state[0];
AnnaBridge	146:22da6e220af6	4914	acc += (q31_t) S->A2 * S->state[1];
AnnaBridge	146:22da6e220af6	4915	#endif
AnnaBridge	146:22da6e220af6	4916
AnnaBridge	146:22da6e220af6	4917	/* acc += y[n-1] */
AnnaBridge	146:22da6e220af6	4918	acc += (q31_t) S->state[2] << 15;
AnnaBridge	146:22da6e220af6	4919
AnnaBridge	146:22da6e220af6	4920	/* saturate the output */
AnnaBridge	146:22da6e220af6	4921	out = (q15_t) (__SSAT((acc >> 15), 16));
AnnaBridge	146:22da6e220af6	4922
AnnaBridge	146:22da6e220af6	4923	/* Update state */
AnnaBridge	146:22da6e220af6	4924	S->state[1] = S->state[0];
AnnaBridge	146:22da6e220af6	4925	S->state[0] = in;
AnnaBridge	146:22da6e220af6	4926	S->state[2] = out;
AnnaBridge	146:22da6e220af6	4927
AnnaBridge	146:22da6e220af6	4928	/* return to application */
AnnaBridge	146:22da6e220af6	4929	return (out);
AnnaBridge	146:22da6e220af6	4930	}
AnnaBridge	146:22da6e220af6	4931
AnnaBridge	146:22da6e220af6	4932	/**
AnnaBridge	146:22da6e220af6	4933	* @} end of PID group
AnnaBridge	146:22da6e220af6	4934	*/
AnnaBridge	146:22da6e220af6	4935
AnnaBridge	146:22da6e220af6	4936
AnnaBridge	146:22da6e220af6	4937	/**
AnnaBridge	146:22da6e220af6	4938	* @brief Floating-point matrix inverse.
AnnaBridge	146:22da6e220af6	4939	* @param[in] src points to the instance of the input floating-point matrix structure.
AnnaBridge	146:22da6e220af6	4940	* @param[out] dst points to the instance of the output floating-point matrix structure.
AnnaBridge	146:22da6e220af6	4941	* @return The function returns ARM_MATH_SIZE_MISMATCH, if the dimensions do not match.
AnnaBridge	146:22da6e220af6	4942	* If the input matrix is singular (does not have an inverse), then the algorithm terminates and returns error status ARM_MATH_SINGULAR.
AnnaBridge	146:22da6e220af6	4943	*/
AnnaBridge	146:22da6e220af6	4944	arm_status arm_mat_inverse_f32(
AnnaBridge	146:22da6e220af6	4945	const arm_matrix_instance_f32 * src,
AnnaBridge	146:22da6e220af6	4946	arm_matrix_instance_f32 * dst);
AnnaBridge	146:22da6e220af6	4947
AnnaBridge	146:22da6e220af6	4948
AnnaBridge	146:22da6e220af6	4949	/**
AnnaBridge	146:22da6e220af6	4950	* @brief Floating-point matrix inverse.
AnnaBridge	146:22da6e220af6	4951	* @param[in] src points to the instance of the input floating-point matrix structure.
AnnaBridge	146:22da6e220af6	4952	* @param[out] dst points to the instance of the output floating-point matrix structure.
AnnaBridge	146:22da6e220af6	4953	* @return The function returns ARM_MATH_SIZE_MISMATCH, if the dimensions do not match.
AnnaBridge	146:22da6e220af6	4954	* If the input matrix is singular (does not have an inverse), then the algorithm terminates and returns error status ARM_MATH_SINGULAR.
AnnaBridge	146:22da6e220af6	4955	*/
AnnaBridge	146:22da6e220af6	4956	arm_status arm_mat_inverse_f64(
AnnaBridge	146:22da6e220af6	4957	const arm_matrix_instance_f64 * src,
AnnaBridge	146:22da6e220af6	4958	arm_matrix_instance_f64 * dst);
AnnaBridge	146:22da6e220af6	4959
AnnaBridge	146:22da6e220af6	4960
AnnaBridge	146:22da6e220af6	4961
AnnaBridge	146:22da6e220af6	4962	/**
AnnaBridge	146:22da6e220af6	4963	* @ingroup groupController
AnnaBridge	146:22da6e220af6	4964	*/
AnnaBridge	146:22da6e220af6	4965
AnnaBridge	146:22da6e220af6	4966	/**
AnnaBridge	146:22da6e220af6	4967	* @defgroup clarke Vector Clarke Transform
AnnaBridge	146:22da6e220af6	4968	* Forward Clarke transform converts the instantaneous stator phases into a two-coordinate time invariant vector.
AnnaBridge	146:22da6e220af6	4969	* Generally the Clarke transform uses three-phase currents <code>Ia, Ib and Ic</code> to calculate currents
AnnaBridge	146:22da6e220af6	4970	* in the two-phase orthogonal stator axis <code>Ialpha</code> and <code>Ibeta</code>.
AnnaBridge	146:22da6e220af6	4971	* When <code>Ialpha</code> is superposed with <code>Ia</code> as shown in the figure below
AnnaBridge	146:22da6e220af6	4972	* \image html clarke.gif Stator current space vector and its components in (a,b).
AnnaBridge	146:22da6e220af6	4973	* and <code>Ia + Ib + Ic = 0</code>, in this condition <code>Ialpha</code> and <code>Ibeta</code>
AnnaBridge	146:22da6e220af6	4974	* can be calculated using only <code>Ia</code> and <code>Ib</code>.
AnnaBridge	146:22da6e220af6	4975	*
AnnaBridge	146:22da6e220af6	4976	* The function operates on a single sample of data and each call to the function returns the processed output.
AnnaBridge	146:22da6e220af6	4977	* The library provides separate functions for Q31 and floating-point data types.
AnnaBridge	146:22da6e220af6	4978	* \par Algorithm
AnnaBridge	146:22da6e220af6	4979	* \image html clarkeFormula.gif
AnnaBridge	146:22da6e220af6	4980	* where <code>Ia</code> and <code>Ib</code> are the instantaneous stator phases and
AnnaBridge	146:22da6e220af6	4981	* <code>pIalpha</code> and <code>pIbeta</code> are the two coordinates of time invariant vector.
AnnaBridge	146:22da6e220af6	4982	* \par Fixed-Point Behavior
AnnaBridge	146:22da6e220af6	4983	* Care must be taken when using the Q31 version of the Clarke transform.
AnnaBridge	146:22da6e220af6	4984	* In particular, the overflow and saturation behavior of the accumulator used must be considered.
AnnaBridge	146:22da6e220af6	4985	* Refer to the function specific documentation below for usage guidelines.
AnnaBridge	146:22da6e220af6	4986	*/
AnnaBridge	146:22da6e220af6	4987
AnnaBridge	146:22da6e220af6	4988	/**
AnnaBridge	146:22da6e220af6	4989	* @addtogroup clarke
AnnaBridge	146:22da6e220af6	4990	* @{
AnnaBridge	146:22da6e220af6	4991	*/
AnnaBridge	146:22da6e220af6	4992
AnnaBridge	146:22da6e220af6	4993	/**
AnnaBridge	146:22da6e220af6	4994	*
AnnaBridge	146:22da6e220af6	4995	* @brief Floating-point Clarke transform
AnnaBridge	146:22da6e220af6	4996	* @param[in] Ia input three-phase coordinate <code>a</code>
AnnaBridge	146:22da6e220af6	4997	* @param[in] Ib input three-phase coordinate <code>b</code>
AnnaBridge	146:22da6e220af6	4998	* @param[out] pIalpha points to output two-phase orthogonal vector axis alpha
AnnaBridge	146:22da6e220af6	4999	* @param[out] pIbeta points to output two-phase orthogonal vector axis beta
AnnaBridge	146:22da6e220af6	5000	*/
AnnaBridge	146:22da6e220af6	5001	CMSIS_INLINE __STATIC_INLINE void arm_clarke_f32(
AnnaBridge	146:22da6e220af6	5002	float32_t Ia,
AnnaBridge	146:22da6e220af6	5003	float32_t Ib,
AnnaBridge	146:22da6e220af6	5004	float32_t * pIalpha,
AnnaBridge	146:22da6e220af6	5005	float32_t * pIbeta)
AnnaBridge	146:22da6e220af6	5006	{
AnnaBridge	146:22da6e220af6	5007	/* Calculate pIalpha using the equation, pIalpha = Ia */
AnnaBridge	146:22da6e220af6	5008	*pIalpha = Ia;
AnnaBridge	146:22da6e220af6	5009
AnnaBridge	146:22da6e220af6	5010	/* Calculate pIbeta using the equation, pIbeta = (1/sqrt(3)) * Ia + (2/sqrt(3)) * Ib */
AnnaBridge	146:22da6e220af6	5011	pIbeta = ((float32_t) 0.57735026919 Ia + (float32_t) 1.15470053838 * Ib);
AnnaBridge	146:22da6e220af6	5012	}
AnnaBridge	146:22da6e220af6	5013
AnnaBridge	146:22da6e220af6	5014
AnnaBridge	146:22da6e220af6	5015	/**
AnnaBridge	146:22da6e220af6	5016	* @brief Clarke transform for Q31 version
AnnaBridge	146:22da6e220af6	5017	* @param[in] Ia input three-phase coordinate <code>a</code>
AnnaBridge	146:22da6e220af6	5018	* @param[in] Ib input three-phase coordinate <code>b</code>
AnnaBridge	146:22da6e220af6	5019	* @param[out] pIalpha points to output two-phase orthogonal vector axis alpha
AnnaBridge	146:22da6e220af6	5020	* @param[out] pIbeta points to output two-phase orthogonal vector axis beta
AnnaBridge	146:22da6e220af6	5021	*
AnnaBridge	146:22da6e220af6	5022	* <b>Scaling and Overflow Behavior:</b>
AnnaBridge	146:22da6e220af6	5023	* \par
AnnaBridge	146:22da6e220af6	5024	* The function is implemented using an internal 32-bit accumulator.
AnnaBridge	146:22da6e220af6	5025	* The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format.
AnnaBridge	146:22da6e220af6	5026	* There is saturation on the addition, hence there is no risk of overflow.
AnnaBridge	146:22da6e220af6	5027	*/
AnnaBridge	146:22da6e220af6	5028	CMSIS_INLINE __STATIC_INLINE void arm_clarke_q31(
AnnaBridge	146:22da6e220af6	5029	q31_t Ia,
AnnaBridge	146:22da6e220af6	5030	q31_t Ib,
AnnaBridge	146:22da6e220af6	5031	q31_t * pIalpha,
AnnaBridge	146:22da6e220af6	5032	q31_t * pIbeta)
AnnaBridge	146:22da6e220af6	5033	{
AnnaBridge	146:22da6e220af6	5034	q31_t product1, product2; /* Temporary variables used to store intermediate results */
AnnaBridge	146:22da6e220af6	5035
AnnaBridge	146:22da6e220af6	5036	/* Calculating pIalpha from Ia by equation pIalpha = Ia */
AnnaBridge	146:22da6e220af6	5037	*pIalpha = Ia;
AnnaBridge	146:22da6e220af6	5038
AnnaBridge	146:22da6e220af6	5039	/* Intermediate product is calculated by (1/(sqrt(3)) * Ia) */
AnnaBridge	146:22da6e220af6	5040	product1 = (q31_t) (((q63_t) Ia * 0x24F34E8B) >> 30);
AnnaBridge	146:22da6e220af6	5041
AnnaBridge	146:22da6e220af6	5042	/* Intermediate product is calculated by (2/sqrt(3) * Ib) */
AnnaBridge	146:22da6e220af6	5043	product2 = (q31_t) (((q63_t) Ib * 0x49E69D16) >> 30);
AnnaBridge	146:22da6e220af6	5044
AnnaBridge	146:22da6e220af6	5045	/* pIbeta is calculated by adding the intermediate products */
AnnaBridge	146:22da6e220af6	5046	*pIbeta = __QADD(product1, product2);
AnnaBridge	146:22da6e220af6	5047	}
AnnaBridge	146:22da6e220af6	5048
AnnaBridge	146:22da6e220af6	5049	/**
AnnaBridge	146:22da6e220af6	5050	* @} end of clarke group
AnnaBridge	146:22da6e220af6	5051	*/
AnnaBridge	146:22da6e220af6	5052
AnnaBridge	146:22da6e220af6	5053	/**
AnnaBridge	146:22da6e220af6	5054	* @brief Converts the elements of the Q7 vector to Q31 vector.
AnnaBridge	146:22da6e220af6	5055	* @param[in] pSrc input pointer
AnnaBridge	146:22da6e220af6	5056	* @param[out] pDst output pointer
AnnaBridge	146:22da6e220af6	5057	* @param[in] blockSize number of samples to process
AnnaBridge	146:22da6e220af6	5058	*/
AnnaBridge	146:22da6e220af6	5059	void arm_q7_to_q31(
AnnaBridge	146:22da6e220af6	5060	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	5061	q31_t * pDst,
AnnaBridge	146:22da6e220af6	5062	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	5063
AnnaBridge	146:22da6e220af6	5064
AnnaBridge	146:22da6e220af6	5065
AnnaBridge	146:22da6e220af6	5066	/**
AnnaBridge	146:22da6e220af6	5067	* @ingroup groupController
AnnaBridge	146:22da6e220af6	5068	*/
AnnaBridge	146:22da6e220af6	5069
AnnaBridge	146:22da6e220af6	5070	/**
AnnaBridge	146:22da6e220af6	5071	* @defgroup inv_clarke Vector Inverse Clarke Transform
AnnaBridge	146:22da6e220af6	5072	* Inverse Clarke transform converts the two-coordinate time invariant vector into instantaneous stator phases.
AnnaBridge	146:22da6e220af6	5073	*
AnnaBridge	146:22da6e220af6	5074	* The function operates on a single sample of data and each call to the function returns the processed output.
AnnaBridge	146:22da6e220af6	5075	* The library provides separate functions for Q31 and floating-point data types.
AnnaBridge	146:22da6e220af6	5076	* \par Algorithm
AnnaBridge	146:22da6e220af6	5077	* \image html clarkeInvFormula.gif
AnnaBridge	146:22da6e220af6	5078	* where <code>pIa</code> and <code>pIb</code> are the instantaneous stator phases and
AnnaBridge	146:22da6e220af6	5079	* <code>Ialpha</code> and <code>Ibeta</code> are the two coordinates of time invariant vector.
AnnaBridge	146:22da6e220af6	5080	* \par Fixed-Point Behavior
AnnaBridge	146:22da6e220af6	5081	* Care must be taken when using the Q31 version of the Clarke transform.
AnnaBridge	146:22da6e220af6	5082	* In particular, the overflow and saturation behavior of the accumulator used must be considered.
AnnaBridge	146:22da6e220af6	5083	* Refer to the function specific documentation below for usage guidelines.
AnnaBridge	146:22da6e220af6	5084	*/
AnnaBridge	146:22da6e220af6	5085
AnnaBridge	146:22da6e220af6	5086	/**
AnnaBridge	146:22da6e220af6	5087	* @addtogroup inv_clarke
AnnaBridge	146:22da6e220af6	5088	* @{
AnnaBridge	146:22da6e220af6	5089	*/
AnnaBridge	146:22da6e220af6	5090
AnnaBridge	146:22da6e220af6	5091	/**
AnnaBridge	146:22da6e220af6	5092	* @brief Floating-point Inverse Clarke transform
AnnaBridge	146:22da6e220af6	5093	* @param[in] Ialpha input two-phase orthogonal vector axis alpha
AnnaBridge	146:22da6e220af6	5094	* @param[in] Ibeta input two-phase orthogonal vector axis beta
AnnaBridge	146:22da6e220af6	5095	* @param[out] pIa points to output three-phase coordinate <code>a</code>
AnnaBridge	146:22da6e220af6	5096	* @param[out] pIb points to output three-phase coordinate <code>b</code>
AnnaBridge	146:22da6e220af6	5097	*/
AnnaBridge	146:22da6e220af6	5098	CMSIS_INLINE __STATIC_INLINE void arm_inv_clarke_f32(
AnnaBridge	146:22da6e220af6	5099	float32_t Ialpha,
AnnaBridge	146:22da6e220af6	5100	float32_t Ibeta,
AnnaBridge	146:22da6e220af6	5101	float32_t * pIa,
AnnaBridge	146:22da6e220af6	5102	float32_t * pIb)
AnnaBridge	146:22da6e220af6	5103	{
AnnaBridge	146:22da6e220af6	5104	/* Calculating pIa from Ialpha by equation pIa = Ialpha */
AnnaBridge	146:22da6e220af6	5105	*pIa = Ialpha;
AnnaBridge	146:22da6e220af6	5106
AnnaBridge	146:22da6e220af6	5107	/* Calculating pIb from Ialpha and Ibeta by equation pIb = -(1/2) * Ialpha + (sqrt(3)/2) * Ibeta */
AnnaBridge	146:22da6e220af6	5108	pIb = -0.5f Ialpha + 0.8660254039f * Ibeta;
AnnaBridge	146:22da6e220af6	5109	}
AnnaBridge	146:22da6e220af6	5110
AnnaBridge	146:22da6e220af6	5111
AnnaBridge	146:22da6e220af6	5112	/**
AnnaBridge	146:22da6e220af6	5113	* @brief Inverse Clarke transform for Q31 version
AnnaBridge	146:22da6e220af6	5114	* @param[in] Ialpha input two-phase orthogonal vector axis alpha
AnnaBridge	146:22da6e220af6	5115	* @param[in] Ibeta input two-phase orthogonal vector axis beta
AnnaBridge	146:22da6e220af6	5116	* @param[out] pIa points to output three-phase coordinate <code>a</code>
AnnaBridge	146:22da6e220af6	5117	* @param[out] pIb points to output three-phase coordinate <code>b</code>
AnnaBridge	146:22da6e220af6	5118	*
AnnaBridge	146:22da6e220af6	5119	* <b>Scaling and Overflow Behavior:</b>
AnnaBridge	146:22da6e220af6	5120	* \par
AnnaBridge	146:22da6e220af6	5121	* The function is implemented using an internal 32-bit accumulator.
AnnaBridge	146:22da6e220af6	5122	* The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format.
AnnaBridge	146:22da6e220af6	5123	* There is saturation on the subtraction, hence there is no risk of overflow.
AnnaBridge	146:22da6e220af6	5124	*/
AnnaBridge	146:22da6e220af6	5125	CMSIS_INLINE __STATIC_INLINE void arm_inv_clarke_q31(
AnnaBridge	146:22da6e220af6	5126	q31_t Ialpha,
AnnaBridge	146:22da6e220af6	5127	q31_t Ibeta,
AnnaBridge	146:22da6e220af6	5128	q31_t * pIa,
AnnaBridge	146:22da6e220af6	5129	q31_t * pIb)
AnnaBridge	146:22da6e220af6	5130	{
AnnaBridge	146:22da6e220af6	5131	q31_t product1, product2; /* Temporary variables used to store intermediate results */
AnnaBridge	146:22da6e220af6	5132
AnnaBridge	146:22da6e220af6	5133	/* Calculating pIa from Ialpha by equation pIa = Ialpha */
AnnaBridge	146:22da6e220af6	5134	*pIa = Ialpha;
AnnaBridge	146:22da6e220af6	5135
AnnaBridge	146:22da6e220af6	5136	/* Intermediate product is calculated by (1/(2sqrt(3)) Ia) */
AnnaBridge	146:22da6e220af6	5137	product1 = (q31_t) (((q63_t) (Ialpha) * (0x40000000)) >> 31);
AnnaBridge	146:22da6e220af6	5138
AnnaBridge	146:22da6e220af6	5139	/* Intermediate product is calculated by (1/sqrt(3) * pIb) */
AnnaBridge	146:22da6e220af6	5140	product2 = (q31_t) (((q63_t) (Ibeta) * (0x6ED9EBA1)) >> 31);
AnnaBridge	146:22da6e220af6	5141
AnnaBridge	146:22da6e220af6	5142	/* pIb is calculated by subtracting the products */
AnnaBridge	146:22da6e220af6	5143	*pIb = __QSUB(product2, product1);
AnnaBridge	146:22da6e220af6	5144	}
AnnaBridge	146:22da6e220af6	5145
AnnaBridge	146:22da6e220af6	5146	/**
AnnaBridge	146:22da6e220af6	5147	* @} end of inv_clarke group
AnnaBridge	146:22da6e220af6	5148	*/
AnnaBridge	146:22da6e220af6	5149
AnnaBridge	146:22da6e220af6	5150	/**
AnnaBridge	146:22da6e220af6	5151	* @brief Converts the elements of the Q7 vector to Q15 vector.
AnnaBridge	146:22da6e220af6	5152	* @param[in] pSrc input pointer
AnnaBridge	146:22da6e220af6	5153	* @param[out] pDst output pointer
AnnaBridge	146:22da6e220af6	5154	* @param[in] blockSize number of samples to process
AnnaBridge	146:22da6e220af6	5155	*/
AnnaBridge	146:22da6e220af6	5156	void arm_q7_to_q15(
AnnaBridge	146:22da6e220af6	5157	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	5158	q15_t * pDst,
AnnaBridge	146:22da6e220af6	5159	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	5160
AnnaBridge	146:22da6e220af6	5161
AnnaBridge	146:22da6e220af6	5162
AnnaBridge	146:22da6e220af6	5163	/**
AnnaBridge	146:22da6e220af6	5164	* @ingroup groupController
AnnaBridge	146:22da6e220af6	5165	*/
AnnaBridge	146:22da6e220af6	5166
AnnaBridge	146:22da6e220af6	5167	/**
AnnaBridge	146:22da6e220af6	5168	* @defgroup park Vector Park Transform
AnnaBridge	146:22da6e220af6	5169	*
AnnaBridge	146:22da6e220af6	5170	* Forward Park transform converts the input two-coordinate vector to flux and torque components.
AnnaBridge	146:22da6e220af6	5171	* The Park transform can be used to realize the transformation of the <code>Ialpha</code> and the <code>Ibeta</code> currents
AnnaBridge	146:22da6e220af6	5172	* from the stationary to the moving reference frame and control the spatial relationship between
AnnaBridge	146:22da6e220af6	5173	* the stator vector current and rotor flux vector.
AnnaBridge	146:22da6e220af6	5174	* If we consider the d axis aligned with the rotor flux, the diagram below shows the
AnnaBridge	146:22da6e220af6	5175	* current vector and the relationship from the two reference frames:
AnnaBridge	146:22da6e220af6	5176	* \image html park.gif "Stator current space vector and its component in (a,b) and in the d,q rotating reference frame"
AnnaBridge	146:22da6e220af6	5177	*
AnnaBridge	146:22da6e220af6	5178	* The function operates on a single sample of data and each call to the function returns the processed output.
AnnaBridge	146:22da6e220af6	5179	* The library provides separate functions for Q31 and floating-point data types.
AnnaBridge	146:22da6e220af6	5180	* \par Algorithm
AnnaBridge	146:22da6e220af6	5181	* \image html parkFormula.gif
AnnaBridge	146:22da6e220af6	5182	* where <code>Ialpha</code> and <code>Ibeta</code> are the stator vector components,
AnnaBridge	146:22da6e220af6	5183	* <code>pId</code> and <code>pIq</code> are rotor vector components and <code>cosVal</code> and <code>sinVal</code> are the
AnnaBridge	146:22da6e220af6	5184	* cosine and sine values of theta (rotor flux position).
AnnaBridge	146:22da6e220af6	5185	* \par Fixed-Point Behavior
AnnaBridge	146:22da6e220af6	5186	* Care must be taken when using the Q31 version of the Park transform.
AnnaBridge	146:22da6e220af6	5187	* In particular, the overflow and saturation behavior of the accumulator used must be considered.
AnnaBridge	146:22da6e220af6	5188	* Refer to the function specific documentation below for usage guidelines.
AnnaBridge	146:22da6e220af6	5189	*/
AnnaBridge	146:22da6e220af6	5190
AnnaBridge	146:22da6e220af6	5191	/**
AnnaBridge	146:22da6e220af6	5192	* @addtogroup park
AnnaBridge	146:22da6e220af6	5193	* @{
AnnaBridge	146:22da6e220af6	5194	*/
AnnaBridge	146:22da6e220af6	5195
AnnaBridge	146:22da6e220af6	5196	/**
AnnaBridge	146:22da6e220af6	5197	* @brief Floating-point Park transform
AnnaBridge	146:22da6e220af6	5198	* @param[in] Ialpha input two-phase vector coordinate alpha
AnnaBridge	146:22da6e220af6	5199	* @param[in] Ibeta input two-phase vector coordinate beta
AnnaBridge	146:22da6e220af6	5200	* @param[out] pId points to output rotor reference frame d
AnnaBridge	146:22da6e220af6	5201	* @param[out] pIq points to output rotor reference frame q
AnnaBridge	146:22da6e220af6	5202	* @param[in] sinVal sine value of rotation angle theta
AnnaBridge	146:22da6e220af6	5203	* @param[in] cosVal cosine value of rotation angle theta
AnnaBridge	146:22da6e220af6	5204	*
AnnaBridge	146:22da6e220af6	5205	* The function implements the forward Park transform.
AnnaBridge	146:22da6e220af6	5206	*
AnnaBridge	146:22da6e220af6	5207	*/
AnnaBridge	146:22da6e220af6	5208	CMSIS_INLINE __STATIC_INLINE void arm_park_f32(
AnnaBridge	146:22da6e220af6	5209	float32_t Ialpha,
AnnaBridge	146:22da6e220af6	5210	float32_t Ibeta,
AnnaBridge	146:22da6e220af6	5211	float32_t * pId,
AnnaBridge	146:22da6e220af6	5212	float32_t * pIq,
AnnaBridge	146:22da6e220af6	5213	float32_t sinVal,
AnnaBridge	146:22da6e220af6	5214	float32_t cosVal)
AnnaBridge	146:22da6e220af6	5215	{
AnnaBridge	146:22da6e220af6	5216	/* Calculate pId using the equation, pId = Ialpha * cosVal + Ibeta * sinVal */
AnnaBridge	146:22da6e220af6	5217	pId = Ialpha cosVal + Ibeta * sinVal;
AnnaBridge	146:22da6e220af6	5218
AnnaBridge	146:22da6e220af6	5219	/* Calculate pIq using the equation, pIq = - Ialpha * sinVal + Ibeta * cosVal */
AnnaBridge	146:22da6e220af6	5220	pIq = -Ialpha sinVal + Ibeta * cosVal;
AnnaBridge	146:22da6e220af6	5221	}
AnnaBridge	146:22da6e220af6	5222
AnnaBridge	146:22da6e220af6	5223
AnnaBridge	146:22da6e220af6	5224	/**
AnnaBridge	146:22da6e220af6	5225	* @brief Park transform for Q31 version
AnnaBridge	146:22da6e220af6	5226	* @param[in] Ialpha input two-phase vector coordinate alpha
AnnaBridge	146:22da6e220af6	5227	* @param[in] Ibeta input two-phase vector coordinate beta
AnnaBridge	146:22da6e220af6	5228	* @param[out] pId points to output rotor reference frame d
AnnaBridge	146:22da6e220af6	5229	* @param[out] pIq points to output rotor reference frame q
AnnaBridge	146:22da6e220af6	5230	* @param[in] sinVal sine value of rotation angle theta
AnnaBridge	146:22da6e220af6	5231	* @param[in] cosVal cosine value of rotation angle theta
AnnaBridge	146:22da6e220af6	5232	*
AnnaBridge	146:22da6e220af6	5233	* <b>Scaling and Overflow Behavior:</b>
AnnaBridge	146:22da6e220af6	5234	* \par
AnnaBridge	146:22da6e220af6	5235	* The function is implemented using an internal 32-bit accumulator.
AnnaBridge	146:22da6e220af6	5236	* The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format.
AnnaBridge	146:22da6e220af6	5237	* There is saturation on the addition and subtraction, hence there is no risk of overflow.
AnnaBridge	146:22da6e220af6	5238	*/
AnnaBridge	146:22da6e220af6	5239	CMSIS_INLINE __STATIC_INLINE void arm_park_q31(
AnnaBridge	146:22da6e220af6	5240	q31_t Ialpha,
AnnaBridge	146:22da6e220af6	5241	q31_t Ibeta,
AnnaBridge	146:22da6e220af6	5242	q31_t * pId,
AnnaBridge	146:22da6e220af6	5243	q31_t * pIq,
AnnaBridge	146:22da6e220af6	5244	q31_t sinVal,
AnnaBridge	146:22da6e220af6	5245	q31_t cosVal)
AnnaBridge	146:22da6e220af6	5246	{
AnnaBridge	146:22da6e220af6	5247	q31_t product1, product2; /* Temporary variables used to store intermediate results */
AnnaBridge	146:22da6e220af6	5248	q31_t product3, product4; /* Temporary variables used to store intermediate results */
AnnaBridge	146:22da6e220af6	5249
AnnaBridge	146:22da6e220af6	5250	/* Intermediate product is calculated by (Ialpha * cosVal) */
AnnaBridge	146:22da6e220af6	5251	product1 = (q31_t) (((q63_t) (Ialpha) * (cosVal)) >> 31);
AnnaBridge	146:22da6e220af6	5252
AnnaBridge	146:22da6e220af6	5253	/* Intermediate product is calculated by (Ibeta * sinVal) */
AnnaBridge	146:22da6e220af6	5254	product2 = (q31_t) (((q63_t) (Ibeta) * (sinVal)) >> 31);
AnnaBridge	146:22da6e220af6	5255
AnnaBridge	146:22da6e220af6	5256
AnnaBridge	146:22da6e220af6	5257	/* Intermediate product is calculated by (Ialpha * sinVal) */
AnnaBridge	146:22da6e220af6	5258	product3 = (q31_t) (((q63_t) (Ialpha) * (sinVal)) >> 31);
AnnaBridge	146:22da6e220af6	5259
AnnaBridge	146:22da6e220af6	5260	/* Intermediate product is calculated by (Ibeta * cosVal) */
AnnaBridge	146:22da6e220af6	5261	product4 = (q31_t) (((q63_t) (Ibeta) * (cosVal)) >> 31);
AnnaBridge	146:22da6e220af6	5262
AnnaBridge	146:22da6e220af6	5263	/* Calculate pId by adding the two intermediate products 1 and 2 */
AnnaBridge	146:22da6e220af6	5264	*pId = __QADD(product1, product2);
AnnaBridge	146:22da6e220af6	5265
AnnaBridge	146:22da6e220af6	5266	/* Calculate pIq by subtracting the two intermediate products 3 from 4 */
AnnaBridge	146:22da6e220af6	5267	*pIq = __QSUB(product4, product3);
AnnaBridge	146:22da6e220af6	5268	}
AnnaBridge	146:22da6e220af6	5269
AnnaBridge	146:22da6e220af6	5270	/**
AnnaBridge	146:22da6e220af6	5271	* @} end of park group
AnnaBridge	146:22da6e220af6	5272	*/
AnnaBridge	146:22da6e220af6	5273
AnnaBridge	146:22da6e220af6	5274	/**
AnnaBridge	146:22da6e220af6	5275	* @brief Converts the elements of the Q7 vector to floating-point vector.
AnnaBridge	146:22da6e220af6	5276	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	5277	* @param[out] pDst is output pointer
AnnaBridge	146:22da6e220af6	5278	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	5279	*/
AnnaBridge	146:22da6e220af6	5280	void arm_q7_to_float(
AnnaBridge	146:22da6e220af6	5281	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	5282	float32_t * pDst,
AnnaBridge	146:22da6e220af6	5283	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	5284
AnnaBridge	146:22da6e220af6	5285
AnnaBridge	146:22da6e220af6	5286	/**
AnnaBridge	146:22da6e220af6	5287	* @ingroup groupController
AnnaBridge	146:22da6e220af6	5288	*/
AnnaBridge	146:22da6e220af6	5289
AnnaBridge	146:22da6e220af6	5290	/**
AnnaBridge	146:22da6e220af6	5291	* @defgroup inv_park Vector Inverse Park transform
AnnaBridge	146:22da6e220af6	5292	* Inverse Park transform converts the input flux and torque components to two-coordinate vector.
AnnaBridge	146:22da6e220af6	5293	*
AnnaBridge	146:22da6e220af6	5294	* The function operates on a single sample of data and each call to the function returns the processed output.
AnnaBridge	146:22da6e220af6	5295	* The library provides separate functions for Q31 and floating-point data types.
AnnaBridge	146:22da6e220af6	5296	* \par Algorithm
AnnaBridge	146:22da6e220af6	5297	* \image html parkInvFormula.gif
AnnaBridge	146:22da6e220af6	5298	* where <code>pIalpha</code> and <code>pIbeta</code> are the stator vector components,
AnnaBridge	146:22da6e220af6	5299	* <code>Id</code> and <code>Iq</code> are rotor vector components and <code>cosVal</code> and <code>sinVal</code> are the
AnnaBridge	146:22da6e220af6	5300	* cosine and sine values of theta (rotor flux position).
AnnaBridge	146:22da6e220af6	5301	* \par Fixed-Point Behavior
AnnaBridge	146:22da6e220af6	5302	* Care must be taken when using the Q31 version of the Park transform.
AnnaBridge	146:22da6e220af6	5303	* In particular, the overflow and saturation behavior of the accumulator used must be considered.
AnnaBridge	146:22da6e220af6	5304	* Refer to the function specific documentation below for usage guidelines.
AnnaBridge	146:22da6e220af6	5305	*/
AnnaBridge	146:22da6e220af6	5306
AnnaBridge	146:22da6e220af6	5307	/**
AnnaBridge	146:22da6e220af6	5308	* @addtogroup inv_park
AnnaBridge	146:22da6e220af6	5309	* @{
AnnaBridge	146:22da6e220af6	5310	*/
AnnaBridge	146:22da6e220af6	5311
AnnaBridge	146:22da6e220af6	5312	/**
AnnaBridge	146:22da6e220af6	5313	* @brief Floating-point Inverse Park transform
AnnaBridge	146:22da6e220af6	5314	* @param[in] Id input coordinate of rotor reference frame d
AnnaBridge	146:22da6e220af6	5315	* @param[in] Iq input coordinate of rotor reference frame q
AnnaBridge	146:22da6e220af6	5316	* @param[out] pIalpha points to output two-phase orthogonal vector axis alpha
AnnaBridge	146:22da6e220af6	5317	* @param[out] pIbeta points to output two-phase orthogonal vector axis beta
AnnaBridge	146:22da6e220af6	5318	* @param[in] sinVal sine value of rotation angle theta
AnnaBridge	146:22da6e220af6	5319	* @param[in] cosVal cosine value of rotation angle theta
AnnaBridge	146:22da6e220af6	5320	*/
AnnaBridge	146:22da6e220af6	5321	CMSIS_INLINE __STATIC_INLINE void arm_inv_park_f32(
AnnaBridge	146:22da6e220af6	5322	float32_t Id,
AnnaBridge	146:22da6e220af6	5323	float32_t Iq,
AnnaBridge	146:22da6e220af6	5324	float32_t * pIalpha,
AnnaBridge	146:22da6e220af6	5325	float32_t * pIbeta,
AnnaBridge	146:22da6e220af6	5326	float32_t sinVal,
AnnaBridge	146:22da6e220af6	5327	float32_t cosVal)
AnnaBridge	146:22da6e220af6	5328	{
AnnaBridge	146:22da6e220af6	5329	/* Calculate pIalpha using the equation, pIalpha = Id * cosVal - Iq * sinVal */
AnnaBridge	146:22da6e220af6	5330	pIalpha = Id cosVal - Iq * sinVal;
AnnaBridge	146:22da6e220af6	5331
AnnaBridge	146:22da6e220af6	5332	/* Calculate pIbeta using the equation, pIbeta = Id * sinVal + Iq * cosVal */
AnnaBridge	146:22da6e220af6	5333	pIbeta = Id sinVal + Iq * cosVal;
AnnaBridge	146:22da6e220af6	5334	}
AnnaBridge	146:22da6e220af6	5335
AnnaBridge	146:22da6e220af6	5336
AnnaBridge	146:22da6e220af6	5337	/**
AnnaBridge	146:22da6e220af6	5338	* @brief Inverse Park transform for Q31 version
AnnaBridge	146:22da6e220af6	5339	* @param[in] Id input coordinate of rotor reference frame d
AnnaBridge	146:22da6e220af6	5340	* @param[in] Iq input coordinate of rotor reference frame q
AnnaBridge	146:22da6e220af6	5341	* @param[out] pIalpha points to output two-phase orthogonal vector axis alpha
AnnaBridge	146:22da6e220af6	5342	* @param[out] pIbeta points to output two-phase orthogonal vector axis beta
AnnaBridge	146:22da6e220af6	5343	* @param[in] sinVal sine value of rotation angle theta
AnnaBridge	146:22da6e220af6	5344	* @param[in] cosVal cosine value of rotation angle theta
AnnaBridge	146:22da6e220af6	5345	*
AnnaBridge	146:22da6e220af6	5346	* <b>Scaling and Overflow Behavior:</b>
AnnaBridge	146:22da6e220af6	5347	* \par
AnnaBridge	146:22da6e220af6	5348	* The function is implemented using an internal 32-bit accumulator.
AnnaBridge	146:22da6e220af6	5349	* The accumulator maintains 1.31 format by truncating lower 31 bits of the intermediate multiplication in 2.62 format.
AnnaBridge	146:22da6e220af6	5350	* There is saturation on the addition, hence there is no risk of overflow.
AnnaBridge	146:22da6e220af6	5351	*/
AnnaBridge	146:22da6e220af6	5352	CMSIS_INLINE __STATIC_INLINE void arm_inv_park_q31(
AnnaBridge	146:22da6e220af6	5353	q31_t Id,
AnnaBridge	146:22da6e220af6	5354	q31_t Iq,
AnnaBridge	146:22da6e220af6	5355	q31_t * pIalpha,
AnnaBridge	146:22da6e220af6	5356	q31_t * pIbeta,
AnnaBridge	146:22da6e220af6	5357	q31_t sinVal,
AnnaBridge	146:22da6e220af6	5358	q31_t cosVal)
AnnaBridge	146:22da6e220af6	5359	{
AnnaBridge	146:22da6e220af6	5360	q31_t product1, product2; /* Temporary variables used to store intermediate results */
AnnaBridge	146:22da6e220af6	5361	q31_t product3, product4; /* Temporary variables used to store intermediate results */
AnnaBridge	146:22da6e220af6	5362
AnnaBridge	146:22da6e220af6	5363	/* Intermediate product is calculated by (Id * cosVal) */
AnnaBridge	146:22da6e220af6	5364	product1 = (q31_t) (((q63_t) (Id) * (cosVal)) >> 31);
AnnaBridge	146:22da6e220af6	5365
AnnaBridge	146:22da6e220af6	5366	/* Intermediate product is calculated by (Iq * sinVal) */
AnnaBridge	146:22da6e220af6	5367	product2 = (q31_t) (((q63_t) (Iq) * (sinVal)) >> 31);
AnnaBridge	146:22da6e220af6	5368
AnnaBridge	146:22da6e220af6	5369
AnnaBridge	146:22da6e220af6	5370	/* Intermediate product is calculated by (Id * sinVal) */
AnnaBridge	146:22da6e220af6	5371	product3 = (q31_t) (((q63_t) (Id) * (sinVal)) >> 31);
AnnaBridge	146:22da6e220af6	5372
AnnaBridge	146:22da6e220af6	5373	/* Intermediate product is calculated by (Iq * cosVal) */
AnnaBridge	146:22da6e220af6	5374	product4 = (q31_t) (((q63_t) (Iq) * (cosVal)) >> 31);
AnnaBridge	146:22da6e220af6	5375
AnnaBridge	146:22da6e220af6	5376	/* Calculate pIalpha by using the two intermediate products 1 and 2 */
AnnaBridge	146:22da6e220af6	5377	*pIalpha = __QSUB(product1, product2);
AnnaBridge	146:22da6e220af6	5378
AnnaBridge	146:22da6e220af6	5379	/* Calculate pIbeta by using the two intermediate products 3 and 4 */
AnnaBridge	146:22da6e220af6	5380	*pIbeta = __QADD(product4, product3);
AnnaBridge	146:22da6e220af6	5381	}
AnnaBridge	146:22da6e220af6	5382
AnnaBridge	146:22da6e220af6	5383	/**
AnnaBridge	146:22da6e220af6	5384	* @} end of Inverse park group
AnnaBridge	146:22da6e220af6	5385	*/
AnnaBridge	146:22da6e220af6	5386
AnnaBridge	146:22da6e220af6	5387
AnnaBridge	146:22da6e220af6	5388	/**
AnnaBridge	146:22da6e220af6	5389	* @brief Converts the elements of the Q31 vector to floating-point vector.
AnnaBridge	146:22da6e220af6	5390	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	5391	* @param[out] pDst is output pointer
AnnaBridge	146:22da6e220af6	5392	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	5393	*/
AnnaBridge	146:22da6e220af6	5394	void arm_q31_to_float(
AnnaBridge	146:22da6e220af6	5395	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	5396	float32_t * pDst,
AnnaBridge	146:22da6e220af6	5397	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	5398
AnnaBridge	146:22da6e220af6	5399	/**
AnnaBridge	146:22da6e220af6	5400	* @ingroup groupInterpolation
AnnaBridge	146:22da6e220af6	5401	*/
AnnaBridge	146:22da6e220af6	5402
AnnaBridge	146:22da6e220af6	5403	/**
AnnaBridge	146:22da6e220af6	5404	* @defgroup LinearInterpolate Linear Interpolation
AnnaBridge	146:22da6e220af6	5405	*
AnnaBridge	146:22da6e220af6	5406	* Linear interpolation is a method of curve fitting using linear polynomials.
AnnaBridge	146:22da6e220af6	5407	* Linear interpolation works by effectively drawing a straight line between two neighboring samples and returning the appropriate point along that line
AnnaBridge	146:22da6e220af6	5408	*
AnnaBridge	146:22da6e220af6	5409	* \par
AnnaBridge	146:22da6e220af6	5410	* \image html LinearInterp.gif "Linear interpolation"
AnnaBridge	146:22da6e220af6	5411	*
AnnaBridge	146:22da6e220af6	5412	* \par
AnnaBridge	146:22da6e220af6	5413	* A Linear Interpolate function calculates an output value(y), for the input(x)
AnnaBridge	146:22da6e220af6	5414	* using linear interpolation of the input values x0, x1( nearest input values) and the output values y0 and y1(nearest output values)
AnnaBridge	146:22da6e220af6	5415	*
AnnaBridge	146:22da6e220af6	5416	* \par Algorithm:
AnnaBridge	146:22da6e220af6	5417	* <pre>
AnnaBridge	146:22da6e220af6	5418	* y = y0 + (x - x0) * ((y1 - y0)/(x1-x0))
AnnaBridge	146:22da6e220af6	5419	* where x0, x1 are nearest values of input x
AnnaBridge	146:22da6e220af6	5420	* y0, y1 are nearest values to output y
AnnaBridge	146:22da6e220af6	5421	* </pre>
AnnaBridge	146:22da6e220af6	5422	*
AnnaBridge	146:22da6e220af6	5423	* \par
AnnaBridge	146:22da6e220af6	5424	* This set of functions implements Linear interpolation process
AnnaBridge	146:22da6e220af6	5425	* for Q7, Q15, Q31, and floating-point data types. The functions operate on a single
AnnaBridge	146:22da6e220af6	5426	* sample of data and each call to the function returns a single processed value.
AnnaBridge	146:22da6e220af6	5427	* <code>S</code> points to an instance of the Linear Interpolate function data structure.
AnnaBridge	146:22da6e220af6	5428	* <code>x</code> is the input sample value. The functions returns the output value.
AnnaBridge	146:22da6e220af6	5429	*
AnnaBridge	146:22da6e220af6	5430	* \par
AnnaBridge	146:22da6e220af6	5431	* if x is outside of the table boundary, Linear interpolation returns first value of the table
AnnaBridge	146:22da6e220af6	5432	* if x is below input range and returns last value of table if x is above range.
AnnaBridge	146:22da6e220af6	5433	*/
AnnaBridge	146:22da6e220af6	5434
AnnaBridge	146:22da6e220af6	5435	/**
AnnaBridge	146:22da6e220af6	5436	* @addtogroup LinearInterpolate
AnnaBridge	146:22da6e220af6	5437	* @{
AnnaBridge	146:22da6e220af6	5438	*/
AnnaBridge	146:22da6e220af6	5439
AnnaBridge	146:22da6e220af6	5440	/**
AnnaBridge	146:22da6e220af6	5441	* @brief Process function for the floating-point Linear Interpolation Function.
AnnaBridge	146:22da6e220af6	5442	* @param[in,out] S is an instance of the floating-point Linear Interpolation structure
AnnaBridge	146:22da6e220af6	5443	* @param[in] x input sample to process
AnnaBridge	146:22da6e220af6	5444	* @return y processed output sample.
AnnaBridge	146:22da6e220af6	5445	*
AnnaBridge	146:22da6e220af6	5446	*/
AnnaBridge	146:22da6e220af6	5447	CMSIS_INLINE __STATIC_INLINE float32_t arm_linear_interp_f32(
AnnaBridge	146:22da6e220af6	5448	arm_linear_interp_instance_f32 * S,
AnnaBridge	146:22da6e220af6	5449	float32_t x)
AnnaBridge	146:22da6e220af6	5450	{
AnnaBridge	146:22da6e220af6	5451	float32_t y;
AnnaBridge	146:22da6e220af6	5452	float32_t x0, x1; /* Nearest input values */
AnnaBridge	146:22da6e220af6	5453	float32_t y0, y1; /* Nearest output values */
AnnaBridge	146:22da6e220af6	5454	float32_t xSpacing = S->xSpacing; /* spacing between input values */
AnnaBridge	146:22da6e220af6	5455	int32_t i; /* Index variable */
AnnaBridge	146:22da6e220af6	5456	float32_t pYData = S->pYData; / pointer to output table */
AnnaBridge	146:22da6e220af6	5457
AnnaBridge	146:22da6e220af6	5458	/* Calculation of index */
AnnaBridge	146:22da6e220af6	5459	i = (int32_t) ((x - S->x1) / xSpacing);
AnnaBridge	146:22da6e220af6	5460
AnnaBridge	146:22da6e220af6	5461	if (i < 0)
AnnaBridge	146:22da6e220af6	5462	{
AnnaBridge	146:22da6e220af6	5463	/* Iniatilize output for below specified range as least output value of table */
AnnaBridge	146:22da6e220af6	5464	y = pYData[0];
AnnaBridge	146:22da6e220af6	5465	}
AnnaBridge	146:22da6e220af6	5466	else if ((uint32_t)i >= S->nValues)
AnnaBridge	146:22da6e220af6	5467	{
AnnaBridge	146:22da6e220af6	5468	/* Iniatilize output for above specified range as last output value of table */
AnnaBridge	146:22da6e220af6	5469	y = pYData[S->nValues - 1];
AnnaBridge	146:22da6e220af6	5470	}
AnnaBridge	146:22da6e220af6	5471	else
AnnaBridge	146:22da6e220af6	5472	{
AnnaBridge	146:22da6e220af6	5473	/* Calculation of nearest input values */
AnnaBridge	146:22da6e220af6	5474	x0 = S->x1 + i * xSpacing;
AnnaBridge	146:22da6e220af6	5475	x1 = S->x1 + (i + 1) * xSpacing;
AnnaBridge	146:22da6e220af6	5476
AnnaBridge	146:22da6e220af6	5477	/* Read of nearest output values */
AnnaBridge	146:22da6e220af6	5478	y0 = pYData[i];
AnnaBridge	146:22da6e220af6	5479	y1 = pYData[i + 1];
AnnaBridge	146:22da6e220af6	5480
AnnaBridge	146:22da6e220af6	5481	/* Calculation of output */
AnnaBridge	146:22da6e220af6	5482	y = y0 + (x - x0) * ((y1 - y0) / (x1 - x0));
AnnaBridge	146:22da6e220af6	5483
AnnaBridge	146:22da6e220af6	5484	}
AnnaBridge	146:22da6e220af6	5485
AnnaBridge	146:22da6e220af6	5486	/* returns output value */
AnnaBridge	146:22da6e220af6	5487	return (y);
AnnaBridge	146:22da6e220af6	5488	}
AnnaBridge	146:22da6e220af6	5489
AnnaBridge	146:22da6e220af6	5490
AnnaBridge	146:22da6e220af6	5491	/**
AnnaBridge	146:22da6e220af6	5492	*
AnnaBridge	146:22da6e220af6	5493	* @brief Process function for the Q31 Linear Interpolation Function.
AnnaBridge	146:22da6e220af6	5494	* @param[in] pYData pointer to Q31 Linear Interpolation table
AnnaBridge	146:22da6e220af6	5495	* @param[in] x input sample to process
AnnaBridge	146:22da6e220af6	5496	* @param[in] nValues number of table values
AnnaBridge	146:22da6e220af6	5497	* @return y processed output sample.
AnnaBridge	146:22da6e220af6	5498	*
AnnaBridge	146:22da6e220af6	5499	* \par
AnnaBridge	146:22da6e220af6	5500	* Input sample <code>x</code> is in 12.20 format which contains 12 bits for table index and 20 bits for fractional part.
AnnaBridge	146:22da6e220af6	5501	* This function can support maximum of table size 2^12.
AnnaBridge	146:22da6e220af6	5502	*
AnnaBridge	146:22da6e220af6	5503	*/
AnnaBridge	146:22da6e220af6	5504	CMSIS_INLINE __STATIC_INLINE q31_t arm_linear_interp_q31(
AnnaBridge	146:22da6e220af6	5505	q31_t * pYData,
AnnaBridge	146:22da6e220af6	5506	q31_t x,
AnnaBridge	146:22da6e220af6	5507	uint32_t nValues)
AnnaBridge	146:22da6e220af6	5508	{
AnnaBridge	146:22da6e220af6	5509	q31_t y; /* output */
AnnaBridge	146:22da6e220af6	5510	q31_t y0, y1; /* Nearest output values */
AnnaBridge	146:22da6e220af6	5511	q31_t fract; /* fractional part */
AnnaBridge	146:22da6e220af6	5512	int32_t index; /* Index to read nearest output values */
AnnaBridge	146:22da6e220af6	5513
AnnaBridge	146:22da6e220af6	5514	/* Input is in 12.20 format */
AnnaBridge	146:22da6e220af6	5515	/* 12 bits for the table index */
AnnaBridge	146:22da6e220af6	5516	/* Index value calculation */
AnnaBridge	146:22da6e220af6	5517	index = ((x & (q31_t)0xFFF00000) >> 20);
AnnaBridge	146:22da6e220af6	5518
AnnaBridge	146:22da6e220af6	5519	if (index >= (int32_t)(nValues - 1))
AnnaBridge	146:22da6e220af6	5520	{
AnnaBridge	146:22da6e220af6	5521	return (pYData[nValues - 1]);
AnnaBridge	146:22da6e220af6	5522	}
AnnaBridge	146:22da6e220af6	5523	else if (index < 0)
AnnaBridge	146:22da6e220af6	5524	{
AnnaBridge	146:22da6e220af6	5525	return (pYData[0]);
AnnaBridge	146:22da6e220af6	5526	}
AnnaBridge	146:22da6e220af6	5527	else
AnnaBridge	146:22da6e220af6	5528	{
AnnaBridge	146:22da6e220af6	5529	/* 20 bits for the fractional part */
AnnaBridge	146:22da6e220af6	5530	/* shift left by 11 to keep fract in 1.31 format */
AnnaBridge	146:22da6e220af6	5531	fract = (x & 0x000FFFFF) << 11;
AnnaBridge	146:22da6e220af6	5532
AnnaBridge	146:22da6e220af6	5533	/* Read two nearest output values from the index in 1.31(q31) format */
AnnaBridge	146:22da6e220af6	5534	y0 = pYData[index];
AnnaBridge	146:22da6e220af6	5535	y1 = pYData[index + 1];
AnnaBridge	146:22da6e220af6	5536
AnnaBridge	146:22da6e220af6	5537	/* Calculation of y0 * (1-fract) and y is in 2.30 format */
AnnaBridge	146:22da6e220af6	5538	y = ((q31_t) ((q63_t) y0 * (0x7FFFFFFF - fract) >> 32));
AnnaBridge	146:22da6e220af6	5539
AnnaBridge	146:22da6e220af6	5540	/* Calculation of y0 * (1-fract) + y1 fract and y is in 2.30 format /
AnnaBridge	146:22da6e220af6	5541	y += ((q31_t) (((q63_t) y1 * fract) >> 32));
AnnaBridge	146:22da6e220af6	5542
AnnaBridge	146:22da6e220af6	5543	/* Convert y to 1.31 format */
AnnaBridge	146:22da6e220af6	5544	return (y << 1u);
AnnaBridge	146:22da6e220af6	5545	}
AnnaBridge	146:22da6e220af6	5546	}
AnnaBridge	146:22da6e220af6	5547
AnnaBridge	146:22da6e220af6	5548
AnnaBridge	146:22da6e220af6	5549	/**
AnnaBridge	146:22da6e220af6	5550	*
AnnaBridge	146:22da6e220af6	5551	* @brief Process function for the Q15 Linear Interpolation Function.
AnnaBridge	146:22da6e220af6	5552	* @param[in] pYData pointer to Q15 Linear Interpolation table
AnnaBridge	146:22da6e220af6	5553	* @param[in] x input sample to process
AnnaBridge	146:22da6e220af6	5554	* @param[in] nValues number of table values
AnnaBridge	146:22da6e220af6	5555	* @return y processed output sample.
AnnaBridge	146:22da6e220af6	5556	*
AnnaBridge	146:22da6e220af6	5557	* \par
AnnaBridge	146:22da6e220af6	5558	* Input sample <code>x</code> is in 12.20 format which contains 12 bits for table index and 20 bits for fractional part.
AnnaBridge	146:22da6e220af6	5559	* This function can support maximum of table size 2^12.
AnnaBridge	146:22da6e220af6	5560	*
AnnaBridge	146:22da6e220af6	5561	*/
AnnaBridge	146:22da6e220af6	5562	CMSIS_INLINE __STATIC_INLINE q15_t arm_linear_interp_q15(
AnnaBridge	146:22da6e220af6	5563	q15_t * pYData,
AnnaBridge	146:22da6e220af6	5564	q31_t x,
AnnaBridge	146:22da6e220af6	5565	uint32_t nValues)
AnnaBridge	146:22da6e220af6	5566	{
AnnaBridge	146:22da6e220af6	5567	q63_t y; /* output */
AnnaBridge	146:22da6e220af6	5568	q15_t y0, y1; /* Nearest output values */
AnnaBridge	146:22da6e220af6	5569	q31_t fract; /* fractional part */
AnnaBridge	146:22da6e220af6	5570	int32_t index; /* Index to read nearest output values */
AnnaBridge	146:22da6e220af6	5571
AnnaBridge	146:22da6e220af6	5572	/* Input is in 12.20 format */
AnnaBridge	146:22da6e220af6	5573	/* 12 bits for the table index */
AnnaBridge	146:22da6e220af6	5574	/* Index value calculation */
AnnaBridge	146:22da6e220af6	5575	index = ((x & (int32_t)0xFFF00000) >> 20);
AnnaBridge	146:22da6e220af6	5576
AnnaBridge	146:22da6e220af6	5577	if (index >= (int32_t)(nValues - 1))
AnnaBridge	146:22da6e220af6	5578	{
AnnaBridge	146:22da6e220af6	5579	return (pYData[nValues - 1]);
AnnaBridge	146:22da6e220af6	5580	}
AnnaBridge	146:22da6e220af6	5581	else if (index < 0)
AnnaBridge	146:22da6e220af6	5582	{
AnnaBridge	146:22da6e220af6	5583	return (pYData[0]);
AnnaBridge	146:22da6e220af6	5584	}
AnnaBridge	146:22da6e220af6	5585	else
AnnaBridge	146:22da6e220af6	5586	{
AnnaBridge	146:22da6e220af6	5587	/* 20 bits for the fractional part */
AnnaBridge	146:22da6e220af6	5588	/* fract is in 12.20 format */
AnnaBridge	146:22da6e220af6	5589	fract = (x & 0x000FFFFF);
AnnaBridge	146:22da6e220af6	5590
AnnaBridge	146:22da6e220af6	5591	/* Read two nearest output values from the index */
AnnaBridge	146:22da6e220af6	5592	y0 = pYData[index];
AnnaBridge	146:22da6e220af6	5593	y1 = pYData[index + 1];
AnnaBridge	146:22da6e220af6	5594
AnnaBridge	146:22da6e220af6	5595	/* Calculation of y0 * (1-fract) and y is in 13.35 format */
AnnaBridge	146:22da6e220af6	5596	y = ((q63_t) y0 * (0xFFFFF - fract));
AnnaBridge	146:22da6e220af6	5597
AnnaBridge	146:22da6e220af6	5598	/* Calculation of (y0 * (1-fract) + y1 * fract) and y is in 13.35 format */
AnnaBridge	146:22da6e220af6	5599	y += ((q63_t) y1 * (fract));
AnnaBridge	146:22da6e220af6	5600
AnnaBridge	146:22da6e220af6	5601	/* convert y to 1.15 format */
AnnaBridge	146:22da6e220af6	5602	return (q15_t) (y >> 20);
AnnaBridge	146:22da6e220af6	5603	}
AnnaBridge	146:22da6e220af6	5604	}
AnnaBridge	146:22da6e220af6	5605
AnnaBridge	146:22da6e220af6	5606
AnnaBridge	146:22da6e220af6	5607	/**
AnnaBridge	146:22da6e220af6	5608	*
AnnaBridge	146:22da6e220af6	5609	* @brief Process function for the Q7 Linear Interpolation Function.
AnnaBridge	146:22da6e220af6	5610	* @param[in] pYData pointer to Q7 Linear Interpolation table
AnnaBridge	146:22da6e220af6	5611	* @param[in] x input sample to process
AnnaBridge	146:22da6e220af6	5612	* @param[in] nValues number of table values
AnnaBridge	146:22da6e220af6	5613	* @return y processed output sample.
AnnaBridge	146:22da6e220af6	5614	*
AnnaBridge	146:22da6e220af6	5615	* \par
AnnaBridge	146:22da6e220af6	5616	* Input sample <code>x</code> is in 12.20 format which contains 12 bits for table index and 20 bits for fractional part.
AnnaBridge	146:22da6e220af6	5617	* This function can support maximum of table size 2^12.
AnnaBridge	146:22da6e220af6	5618	*/
AnnaBridge	146:22da6e220af6	5619	CMSIS_INLINE __STATIC_INLINE q7_t arm_linear_interp_q7(
AnnaBridge	146:22da6e220af6	5620	q7_t * pYData,
AnnaBridge	146:22da6e220af6	5621	q31_t x,
AnnaBridge	146:22da6e220af6	5622	uint32_t nValues)
AnnaBridge	146:22da6e220af6	5623	{
AnnaBridge	146:22da6e220af6	5624	q31_t y; /* output */
AnnaBridge	146:22da6e220af6	5625	q7_t y0, y1; /* Nearest output values */
AnnaBridge	146:22da6e220af6	5626	q31_t fract; /* fractional part */
AnnaBridge	146:22da6e220af6	5627	uint32_t index; /* Index to read nearest output values */
AnnaBridge	146:22da6e220af6	5628
AnnaBridge	146:22da6e220af6	5629	/* Input is in 12.20 format */
AnnaBridge	146:22da6e220af6	5630	/* 12 bits for the table index */
AnnaBridge	146:22da6e220af6	5631	/* Index value calculation */
AnnaBridge	146:22da6e220af6	5632	if (x < 0)
AnnaBridge	146:22da6e220af6	5633	{
AnnaBridge	146:22da6e220af6	5634	return (pYData[0]);
AnnaBridge	146:22da6e220af6	5635	}
AnnaBridge	146:22da6e220af6	5636	index = (x >> 20) & 0xfff;
AnnaBridge	146:22da6e220af6	5637
AnnaBridge	146:22da6e220af6	5638	if (index >= (nValues - 1))
AnnaBridge	146:22da6e220af6	5639	{
AnnaBridge	146:22da6e220af6	5640	return (pYData[nValues - 1]);
AnnaBridge	146:22da6e220af6	5641	}
AnnaBridge	146:22da6e220af6	5642	else
AnnaBridge	146:22da6e220af6	5643	{
AnnaBridge	146:22da6e220af6	5644	/* 20 bits for the fractional part */
AnnaBridge	146:22da6e220af6	5645	/* fract is in 12.20 format */
AnnaBridge	146:22da6e220af6	5646	fract = (x & 0x000FFFFF);
AnnaBridge	146:22da6e220af6	5647
AnnaBridge	146:22da6e220af6	5648	/* Read two nearest output values from the index and are in 1.7(q7) format */
AnnaBridge	146:22da6e220af6	5649	y0 = pYData[index];
AnnaBridge	146:22da6e220af6	5650	y1 = pYData[index + 1];
AnnaBridge	146:22da6e220af6	5651
AnnaBridge	146:22da6e220af6	5652	/* Calculation of y0 * (1-fract ) and y is in 13.27(q27) format */
AnnaBridge	146:22da6e220af6	5653	y = ((y0 * (0xFFFFF - fract)));
AnnaBridge	146:22da6e220af6	5654
AnnaBridge	146:22da6e220af6	5655	/* Calculation of y1 * fract + y0 * (1-fract) and y is in 13.27(q27) format */
AnnaBridge	146:22da6e220af6	5656	y += (y1 * fract);
AnnaBridge	146:22da6e220af6	5657
AnnaBridge	146:22da6e220af6	5658	/* convert y to 1.7(q7) format */
AnnaBridge	146:22da6e220af6	5659	return (q7_t) (y >> 20);
AnnaBridge	146:22da6e220af6	5660	}
AnnaBridge	146:22da6e220af6	5661	}
AnnaBridge	146:22da6e220af6	5662
AnnaBridge	146:22da6e220af6	5663	/**
AnnaBridge	146:22da6e220af6	5664	* @} end of LinearInterpolate group
AnnaBridge	146:22da6e220af6	5665	*/
AnnaBridge	146:22da6e220af6	5666
AnnaBridge	146:22da6e220af6	5667	/**
AnnaBridge	146:22da6e220af6	5668	* @brief Fast approximation to the trigonometric sine function for floating-point data.
AnnaBridge	146:22da6e220af6	5669	* @param[in] x input value in radians.
AnnaBridge	146:22da6e220af6	5670	* @return sin(x).
AnnaBridge	146:22da6e220af6	5671	*/
AnnaBridge	146:22da6e220af6	5672	float32_t arm_sin_f32(
AnnaBridge	146:22da6e220af6	5673	float32_t x);
AnnaBridge	146:22da6e220af6	5674
AnnaBridge	146:22da6e220af6	5675
AnnaBridge	146:22da6e220af6	5676	/**
AnnaBridge	146:22da6e220af6	5677	* @brief Fast approximation to the trigonometric sine function for Q31 data.
AnnaBridge	146:22da6e220af6	5678	* @param[in] x Scaled input value in radians.
AnnaBridge	146:22da6e220af6	5679	* @return sin(x).
AnnaBridge	146:22da6e220af6	5680	*/
AnnaBridge	146:22da6e220af6	5681	q31_t arm_sin_q31(
AnnaBridge	146:22da6e220af6	5682	q31_t x);
AnnaBridge	146:22da6e220af6	5683
AnnaBridge	146:22da6e220af6	5684
AnnaBridge	146:22da6e220af6	5685	/**
AnnaBridge	146:22da6e220af6	5686	* @brief Fast approximation to the trigonometric sine function for Q15 data.
AnnaBridge	146:22da6e220af6	5687	* @param[in] x Scaled input value in radians.
AnnaBridge	146:22da6e220af6	5688	* @return sin(x).
AnnaBridge	146:22da6e220af6	5689	*/
AnnaBridge	146:22da6e220af6	5690	q15_t arm_sin_q15(
AnnaBridge	146:22da6e220af6	5691	q15_t x);
AnnaBridge	146:22da6e220af6	5692
AnnaBridge	146:22da6e220af6	5693
AnnaBridge	146:22da6e220af6	5694	/**
AnnaBridge	146:22da6e220af6	5695	* @brief Fast approximation to the trigonometric cosine function for floating-point data.
AnnaBridge	146:22da6e220af6	5696	* @param[in] x input value in radians.
AnnaBridge	146:22da6e220af6	5697	* @return cos(x).
AnnaBridge	146:22da6e220af6	5698	*/
AnnaBridge	146:22da6e220af6	5699	float32_t arm_cos_f32(
AnnaBridge	146:22da6e220af6	5700	float32_t x);
AnnaBridge	146:22da6e220af6	5701
AnnaBridge	146:22da6e220af6	5702
AnnaBridge	146:22da6e220af6	5703	/**
AnnaBridge	146:22da6e220af6	5704	* @brief Fast approximation to the trigonometric cosine function for Q31 data.
AnnaBridge	146:22da6e220af6	5705	* @param[in] x Scaled input value in radians.
AnnaBridge	146:22da6e220af6	5706	* @return cos(x).
AnnaBridge	146:22da6e220af6	5707	*/
AnnaBridge	146:22da6e220af6	5708	q31_t arm_cos_q31(
AnnaBridge	146:22da6e220af6	5709	q31_t x);
AnnaBridge	146:22da6e220af6	5710
AnnaBridge	146:22da6e220af6	5711
AnnaBridge	146:22da6e220af6	5712	/**
AnnaBridge	146:22da6e220af6	5713	* @brief Fast approximation to the trigonometric cosine function for Q15 data.
AnnaBridge	146:22da6e220af6	5714	* @param[in] x Scaled input value in radians.
AnnaBridge	146:22da6e220af6	5715	* @return cos(x).
AnnaBridge	146:22da6e220af6	5716	*/
AnnaBridge	146:22da6e220af6	5717	q15_t arm_cos_q15(
AnnaBridge	146:22da6e220af6	5718	q15_t x);
AnnaBridge	146:22da6e220af6	5719
AnnaBridge	146:22da6e220af6	5720
AnnaBridge	146:22da6e220af6	5721	/**
AnnaBridge	146:22da6e220af6	5722	* @ingroup groupFastMath
AnnaBridge	146:22da6e220af6	5723	*/
AnnaBridge	146:22da6e220af6	5724
AnnaBridge	146:22da6e220af6	5725
AnnaBridge	146:22da6e220af6	5726	/**
AnnaBridge	146:22da6e220af6	5727	* @defgroup SQRT Square Root
AnnaBridge	146:22da6e220af6	5728	*
AnnaBridge	146:22da6e220af6	5729	* Computes the square root of a number.
AnnaBridge	146:22da6e220af6	5730	* There are separate functions for Q15, Q31, and floating-point data types.
AnnaBridge	146:22da6e220af6	5731	* The square root function is computed using the Newton-Raphson algorithm.
AnnaBridge	146:22da6e220af6	5732	* This is an iterative algorithm of the form:
AnnaBridge	146:22da6e220af6	5733	* <pre>
AnnaBridge	146:22da6e220af6	5734	* x1 = x0 - f(x0)/f'(x0)
AnnaBridge	146:22da6e220af6	5735	* </pre>
AnnaBridge	146:22da6e220af6	5736	* where <code>x1</code> is the current estimate,
AnnaBridge	146:22da6e220af6	5737	* <code>x0</code> is the previous estimate, and
AnnaBridge	146:22da6e220af6	5738	* <code>f'(x0)</code> is the derivative of <code>f()</code> evaluated at <code>x0</code>.
AnnaBridge	146:22da6e220af6	5739	* For the square root function, the algorithm reduces to:
AnnaBridge	146:22da6e220af6	5740	* <pre>
AnnaBridge	146:22da6e220af6	5741	* x0 = in/2 [initial guess]
AnnaBridge	146:22da6e220af6	5742	* x1 = 1/2 * ( x0 + in / x0) [each iteration]
AnnaBridge	146:22da6e220af6	5743	* </pre>
AnnaBridge	146:22da6e220af6	5744	*/
AnnaBridge	146:22da6e220af6	5745
AnnaBridge	146:22da6e220af6	5746
AnnaBridge	146:22da6e220af6	5747	/**
AnnaBridge	146:22da6e220af6	5748	* @addtogroup SQRT
AnnaBridge	146:22da6e220af6	5749	* @{
AnnaBridge	146:22da6e220af6	5750	*/
AnnaBridge	146:22da6e220af6	5751
AnnaBridge	146:22da6e220af6	5752	/**
AnnaBridge	146:22da6e220af6	5753	* @brief Floating-point square root function.
AnnaBridge	146:22da6e220af6	5754	* @param[in] in input value.
AnnaBridge	146:22da6e220af6	5755	* @param[out] pOut square root of input value.
AnnaBridge	146:22da6e220af6	5756	* @return The function returns ARM_MATH_SUCCESS if input value is positive value or ARM_MATH_ARGUMENT_ERROR if
AnnaBridge	146:22da6e220af6	5757	* <code>in</code> is negative value and returns zero output for negative values.
AnnaBridge	146:22da6e220af6	5758	*/
AnnaBridge	146:22da6e220af6	5759	CMSIS_INLINE __STATIC_INLINE arm_status arm_sqrt_f32(
AnnaBridge	146:22da6e220af6	5760	float32_t in,
AnnaBridge	146:22da6e220af6	5761	float32_t * pOut)
AnnaBridge	146:22da6e220af6	5762	{
AnnaBridge	146:22da6e220af6	5763	if (in >= 0.0f)
AnnaBridge	146:22da6e220af6	5764	{
AnnaBridge	146:22da6e220af6	5765
AnnaBridge	146:22da6e220af6	5766	#if (__FPU_USED == 1) && defined ( __CC_ARM )
AnnaBridge	146:22da6e220af6	5767	*pOut = __sqrtf(in);
AnnaBridge	146:22da6e220af6	5768	#elif (__FPU_USED == 1) && (defined(__ARMCC_VERSION) && (__ARMCC_VERSION >= 6010050))
AnnaBridge	146:22da6e220af6	5769	*pOut = __builtin_sqrtf(in);
AnnaBridge	146:22da6e220af6	5770	#elif (__FPU_USED == 1) && defined(__GNUC__)
AnnaBridge	146:22da6e220af6	5771	*pOut = __builtin_sqrtf(in);
AnnaBridge	146:22da6e220af6	5772	#elif (__FPU_USED == 1) && defined ( __ICCARM__ ) && (__VER__ >= 6040000)
AnnaBridge	146:22da6e220af6	5773	__ASM("VSQRT.F32 %0,%1" : "=t"(*pOut) : "t"(in));
AnnaBridge	146:22da6e220af6	5774	#else
AnnaBridge	146:22da6e220af6	5775	*pOut = sqrtf(in);
AnnaBridge	146:22da6e220af6	5776	#endif
AnnaBridge	146:22da6e220af6	5777
AnnaBridge	146:22da6e220af6	5778	return (ARM_MATH_SUCCESS);
AnnaBridge	146:22da6e220af6	5779	}
AnnaBridge	146:22da6e220af6	5780	else
AnnaBridge	146:22da6e220af6	5781	{
AnnaBridge	146:22da6e220af6	5782	*pOut = 0.0f;
AnnaBridge	146:22da6e220af6	5783	return (ARM_MATH_ARGUMENT_ERROR);
AnnaBridge	146:22da6e220af6	5784	}
AnnaBridge	146:22da6e220af6	5785	}
AnnaBridge	146:22da6e220af6	5786
AnnaBridge	146:22da6e220af6	5787
AnnaBridge	146:22da6e220af6	5788	/**
AnnaBridge	146:22da6e220af6	5789	* @brief Q31 square root function.
AnnaBridge	146:22da6e220af6	5790	* @param[in] in input value. The range of the input value is [0 +1) or 0x00000000 to 0x7FFFFFFF.
AnnaBridge	146:22da6e220af6	5791	* @param[out] pOut square root of input value.
AnnaBridge	146:22da6e220af6	5792	* @return The function returns ARM_MATH_SUCCESS if input value is positive value or ARM_MATH_ARGUMENT_ERROR if
AnnaBridge	146:22da6e220af6	5793	* <code>in</code> is negative value and returns zero output for negative values.
AnnaBridge	146:22da6e220af6	5794	*/
AnnaBridge	146:22da6e220af6	5795	arm_status arm_sqrt_q31(
AnnaBridge	146:22da6e220af6	5796	q31_t in,
AnnaBridge	146:22da6e220af6	5797	q31_t * pOut);
AnnaBridge	146:22da6e220af6	5798
AnnaBridge	146:22da6e220af6	5799
AnnaBridge	146:22da6e220af6	5800	/**
AnnaBridge	146:22da6e220af6	5801	* @brief Q15 square root function.
AnnaBridge	146:22da6e220af6	5802	* @param[in] in input value. The range of the input value is [0 +1) or 0x0000 to 0x7FFF.
AnnaBridge	146:22da6e220af6	5803	* @param[out] pOut square root of input value.
AnnaBridge	146:22da6e220af6	5804	* @return The function returns ARM_MATH_SUCCESS if input value is positive value or ARM_MATH_ARGUMENT_ERROR if
AnnaBridge	146:22da6e220af6	5805	* <code>in</code> is negative value and returns zero output for negative values.
AnnaBridge	146:22da6e220af6	5806	*/
AnnaBridge	146:22da6e220af6	5807	arm_status arm_sqrt_q15(
AnnaBridge	146:22da6e220af6	5808	q15_t in,
AnnaBridge	146:22da6e220af6	5809	q15_t * pOut);
AnnaBridge	146:22da6e220af6	5810
AnnaBridge	146:22da6e220af6	5811	/**
AnnaBridge	146:22da6e220af6	5812	* @} end of SQRT group
AnnaBridge	146:22da6e220af6	5813	*/
AnnaBridge	146:22da6e220af6	5814
AnnaBridge	146:22da6e220af6	5815
AnnaBridge	146:22da6e220af6	5816	/**
AnnaBridge	146:22da6e220af6	5817	* @brief floating-point Circular write function.
AnnaBridge	146:22da6e220af6	5818	*/
AnnaBridge	146:22da6e220af6	5819	CMSIS_INLINE __STATIC_INLINE void arm_circularWrite_f32(
AnnaBridge	146:22da6e220af6	5820	int32_t * circBuffer,
AnnaBridge	146:22da6e220af6	5821	int32_t L,
AnnaBridge	146:22da6e220af6	5822	uint16_t * writeOffset,
AnnaBridge	146:22da6e220af6	5823	int32_t bufferInc,
AnnaBridge	146:22da6e220af6	5824	const int32_t * src,
AnnaBridge	146:22da6e220af6	5825	int32_t srcInc,
AnnaBridge	146:22da6e220af6	5826	uint32_t blockSize)
AnnaBridge	146:22da6e220af6	5827	{
AnnaBridge	146:22da6e220af6	5828	uint32_t i = 0u;
AnnaBridge	146:22da6e220af6	5829	int32_t wOffset;
AnnaBridge	146:22da6e220af6	5830
AnnaBridge	146:22da6e220af6	5831	/* Copy the value of Index pointer that points
AnnaBridge	146:22da6e220af6	5832	* to the current location where the input samples to be copied */
AnnaBridge	146:22da6e220af6	5833	wOffset = *writeOffset;
AnnaBridge	146:22da6e220af6	5834
AnnaBridge	146:22da6e220af6	5835	/* Loop over the blockSize */
AnnaBridge	146:22da6e220af6	5836	i = blockSize;
AnnaBridge	146:22da6e220af6	5837
AnnaBridge	146:22da6e220af6	5838	while (i > 0u)
AnnaBridge	146:22da6e220af6	5839	{
AnnaBridge	146:22da6e220af6	5840	/* copy the input sample to the circular buffer */
AnnaBridge	146:22da6e220af6	5841	circBuffer[wOffset] = *src;
AnnaBridge	146:22da6e220af6	5842
AnnaBridge	146:22da6e220af6	5843	/* Update the input pointer */
AnnaBridge	146:22da6e220af6	5844	src += srcInc;
AnnaBridge	146:22da6e220af6	5845
AnnaBridge	146:22da6e220af6	5846	/* Circularly update wOffset. Watch out for positive and negative value */
AnnaBridge	146:22da6e220af6	5847	wOffset += bufferInc;
AnnaBridge	146:22da6e220af6	5848	if (wOffset >= L)
AnnaBridge	146:22da6e220af6	5849	wOffset -= L;
AnnaBridge	146:22da6e220af6	5850
AnnaBridge	146:22da6e220af6	5851	/* Decrement the loop counter */
AnnaBridge	146:22da6e220af6	5852	i--;
AnnaBridge	146:22da6e220af6	5853	}
AnnaBridge	146:22da6e220af6	5854
AnnaBridge	146:22da6e220af6	5855	/* Update the index pointer */
AnnaBridge	146:22da6e220af6	5856	*writeOffset = (uint16_t)wOffset;
AnnaBridge	146:22da6e220af6	5857	}
AnnaBridge	146:22da6e220af6	5858
AnnaBridge	146:22da6e220af6	5859
AnnaBridge	146:22da6e220af6	5860
AnnaBridge	146:22da6e220af6	5861	/**
AnnaBridge	146:22da6e220af6	5862	* @brief floating-point Circular Read function.
AnnaBridge	146:22da6e220af6	5863	*/
AnnaBridge	146:22da6e220af6	5864	CMSIS_INLINE __STATIC_INLINE void arm_circularRead_f32(
AnnaBridge	146:22da6e220af6	5865	int32_t * circBuffer,
AnnaBridge	146:22da6e220af6	5866	int32_t L,
AnnaBridge	146:22da6e220af6	5867	int32_t * readOffset,
AnnaBridge	146:22da6e220af6	5868	int32_t bufferInc,
AnnaBridge	146:22da6e220af6	5869	int32_t * dst,
AnnaBridge	146:22da6e220af6	5870	int32_t * dst_base,
AnnaBridge	146:22da6e220af6	5871	int32_t dst_length,
AnnaBridge	146:22da6e220af6	5872	int32_t dstInc,
AnnaBridge	146:22da6e220af6	5873	uint32_t blockSize)
AnnaBridge	146:22da6e220af6	5874	{
AnnaBridge	146:22da6e220af6	5875	uint32_t i = 0u;
AnnaBridge	146:22da6e220af6	5876	int32_t rOffset, dst_end;
AnnaBridge	146:22da6e220af6	5877
AnnaBridge	146:22da6e220af6	5878	/* Copy the value of Index pointer that points
AnnaBridge	146:22da6e220af6	5879	* to the current location from where the input samples to be read */
AnnaBridge	146:22da6e220af6	5880	rOffset = *readOffset;
AnnaBridge	146:22da6e220af6	5881	dst_end = (int32_t) (dst_base + dst_length);
AnnaBridge	146:22da6e220af6	5882
AnnaBridge	146:22da6e220af6	5883	/* Loop over the blockSize */
AnnaBridge	146:22da6e220af6	5884	i = blockSize;
AnnaBridge	146:22da6e220af6	5885
AnnaBridge	146:22da6e220af6	5886	while (i > 0u)
AnnaBridge	146:22da6e220af6	5887	{
AnnaBridge	146:22da6e220af6	5888	/* copy the sample from the circular buffer to the destination buffer */
AnnaBridge	146:22da6e220af6	5889	*dst = circBuffer[rOffset];
AnnaBridge	146:22da6e220af6	5890
AnnaBridge	146:22da6e220af6	5891	/* Update the input pointer */
AnnaBridge	146:22da6e220af6	5892	dst += dstInc;
AnnaBridge	146:22da6e220af6	5893
AnnaBridge	146:22da6e220af6	5894	if (dst == (int32_t *) dst_end)
AnnaBridge	146:22da6e220af6	5895	{
AnnaBridge	146:22da6e220af6	5896	dst = dst_base;
AnnaBridge	146:22da6e220af6	5897	}
AnnaBridge	146:22da6e220af6	5898
AnnaBridge	146:22da6e220af6	5899	/* Circularly update rOffset. Watch out for positive and negative value */
AnnaBridge	146:22da6e220af6	5900	rOffset += bufferInc;
AnnaBridge	146:22da6e220af6	5901
AnnaBridge	146:22da6e220af6	5902	if (rOffset >= L)
AnnaBridge	146:22da6e220af6	5903	{
AnnaBridge	146:22da6e220af6	5904	rOffset -= L;
AnnaBridge	146:22da6e220af6	5905	}
AnnaBridge	146:22da6e220af6	5906
AnnaBridge	146:22da6e220af6	5907	/* Decrement the loop counter */
AnnaBridge	146:22da6e220af6	5908	i--;
AnnaBridge	146:22da6e220af6	5909	}
AnnaBridge	146:22da6e220af6	5910
AnnaBridge	146:22da6e220af6	5911	/* Update the index pointer */
AnnaBridge	146:22da6e220af6	5912	*readOffset = rOffset;
AnnaBridge	146:22da6e220af6	5913	}
AnnaBridge	146:22da6e220af6	5914
AnnaBridge	146:22da6e220af6	5915
AnnaBridge	146:22da6e220af6	5916	/**
AnnaBridge	146:22da6e220af6	5917	* @brief Q15 Circular write function.
AnnaBridge	146:22da6e220af6	5918	*/
AnnaBridge	146:22da6e220af6	5919	CMSIS_INLINE __STATIC_INLINE void arm_circularWrite_q15(
AnnaBridge	146:22da6e220af6	5920	q15_t * circBuffer,
AnnaBridge	146:22da6e220af6	5921	int32_t L,
AnnaBridge	146:22da6e220af6	5922	uint16_t * writeOffset,
AnnaBridge	146:22da6e220af6	5923	int32_t bufferInc,
AnnaBridge	146:22da6e220af6	5924	const q15_t * src,
AnnaBridge	146:22da6e220af6	5925	int32_t srcInc,
AnnaBridge	146:22da6e220af6	5926	uint32_t blockSize)
AnnaBridge	146:22da6e220af6	5927	{
AnnaBridge	146:22da6e220af6	5928	uint32_t i = 0u;
AnnaBridge	146:22da6e220af6	5929	int32_t wOffset;
AnnaBridge	146:22da6e220af6	5930
AnnaBridge	146:22da6e220af6	5931	/* Copy the value of Index pointer that points
AnnaBridge	146:22da6e220af6	5932	* to the current location where the input samples to be copied */
AnnaBridge	146:22da6e220af6	5933	wOffset = *writeOffset;
AnnaBridge	146:22da6e220af6	5934
AnnaBridge	146:22da6e220af6	5935	/* Loop over the blockSize */
AnnaBridge	146:22da6e220af6	5936	i = blockSize;
AnnaBridge	146:22da6e220af6	5937
AnnaBridge	146:22da6e220af6	5938	while (i > 0u)
AnnaBridge	146:22da6e220af6	5939	{
AnnaBridge	146:22da6e220af6	5940	/* copy the input sample to the circular buffer */
AnnaBridge	146:22da6e220af6	5941	circBuffer[wOffset] = *src;
AnnaBridge	146:22da6e220af6	5942
AnnaBridge	146:22da6e220af6	5943	/* Update the input pointer */
AnnaBridge	146:22da6e220af6	5944	src += srcInc;
AnnaBridge	146:22da6e220af6	5945
AnnaBridge	146:22da6e220af6	5946	/* Circularly update wOffset. Watch out for positive and negative value */
AnnaBridge	146:22da6e220af6	5947	wOffset += bufferInc;
AnnaBridge	146:22da6e220af6	5948	if (wOffset >= L)
AnnaBridge	146:22da6e220af6	5949	wOffset -= L;
AnnaBridge	146:22da6e220af6	5950
AnnaBridge	146:22da6e220af6	5951	/* Decrement the loop counter */
AnnaBridge	146:22da6e220af6	5952	i--;
AnnaBridge	146:22da6e220af6	5953	}
AnnaBridge	146:22da6e220af6	5954
AnnaBridge	146:22da6e220af6	5955	/* Update the index pointer */
AnnaBridge	146:22da6e220af6	5956	*writeOffset = (uint16_t)wOffset;
AnnaBridge	146:22da6e220af6	5957	}
AnnaBridge	146:22da6e220af6	5958
AnnaBridge	146:22da6e220af6	5959
AnnaBridge	146:22da6e220af6	5960	/**
AnnaBridge	146:22da6e220af6	5961	* @brief Q15 Circular Read function.
AnnaBridge	146:22da6e220af6	5962	*/
AnnaBridge	146:22da6e220af6	5963	CMSIS_INLINE __STATIC_INLINE void arm_circularRead_q15(
AnnaBridge	146:22da6e220af6	5964	q15_t * circBuffer,
AnnaBridge	146:22da6e220af6	5965	int32_t L,
AnnaBridge	146:22da6e220af6	5966	int32_t * readOffset,
AnnaBridge	146:22da6e220af6	5967	int32_t bufferInc,
AnnaBridge	146:22da6e220af6	5968	q15_t * dst,
AnnaBridge	146:22da6e220af6	5969	q15_t * dst_base,
AnnaBridge	146:22da6e220af6	5970	int32_t dst_length,
AnnaBridge	146:22da6e220af6	5971	int32_t dstInc,
AnnaBridge	146:22da6e220af6	5972	uint32_t blockSize)
AnnaBridge	146:22da6e220af6	5973	{
AnnaBridge	146:22da6e220af6	5974	uint32_t i = 0;
AnnaBridge	146:22da6e220af6	5975	int32_t rOffset, dst_end;
AnnaBridge	146:22da6e220af6	5976
AnnaBridge	146:22da6e220af6	5977	/* Copy the value of Index pointer that points
AnnaBridge	146:22da6e220af6	5978	* to the current location from where the input samples to be read */
AnnaBridge	146:22da6e220af6	5979	rOffset = *readOffset;
AnnaBridge	146:22da6e220af6	5980
AnnaBridge	146:22da6e220af6	5981	dst_end = (int32_t) (dst_base + dst_length);
AnnaBridge	146:22da6e220af6	5982
AnnaBridge	146:22da6e220af6	5983	/* Loop over the blockSize */
AnnaBridge	146:22da6e220af6	5984	i = blockSize;
AnnaBridge	146:22da6e220af6	5985
AnnaBridge	146:22da6e220af6	5986	while (i > 0u)
AnnaBridge	146:22da6e220af6	5987	{
AnnaBridge	146:22da6e220af6	5988	/* copy the sample from the circular buffer to the destination buffer */
AnnaBridge	146:22da6e220af6	5989	*dst = circBuffer[rOffset];
AnnaBridge	146:22da6e220af6	5990
AnnaBridge	146:22da6e220af6	5991	/* Update the input pointer */
AnnaBridge	146:22da6e220af6	5992	dst += dstInc;
AnnaBridge	146:22da6e220af6	5993
AnnaBridge	146:22da6e220af6	5994	if (dst == (q15_t *) dst_end)
AnnaBridge	146:22da6e220af6	5995	{
AnnaBridge	146:22da6e220af6	5996	dst = dst_base;
AnnaBridge	146:22da6e220af6	5997	}
AnnaBridge	146:22da6e220af6	5998
AnnaBridge	146:22da6e220af6	5999	/* Circularly update wOffset. Watch out for positive and negative value */
AnnaBridge	146:22da6e220af6	6000	rOffset += bufferInc;
AnnaBridge	146:22da6e220af6	6001
AnnaBridge	146:22da6e220af6	6002	if (rOffset >= L)
AnnaBridge	146:22da6e220af6	6003	{
AnnaBridge	146:22da6e220af6	6004	rOffset -= L;
AnnaBridge	146:22da6e220af6	6005	}
AnnaBridge	146:22da6e220af6	6006
AnnaBridge	146:22da6e220af6	6007	/* Decrement the loop counter */
AnnaBridge	146:22da6e220af6	6008	i--;
AnnaBridge	146:22da6e220af6	6009	}
AnnaBridge	146:22da6e220af6	6010
AnnaBridge	146:22da6e220af6	6011	/* Update the index pointer */
AnnaBridge	146:22da6e220af6	6012	*readOffset = rOffset;
AnnaBridge	146:22da6e220af6	6013	}
AnnaBridge	146:22da6e220af6	6014
AnnaBridge	146:22da6e220af6	6015
AnnaBridge	146:22da6e220af6	6016	/**
AnnaBridge	146:22da6e220af6	6017	* @brief Q7 Circular write function.
AnnaBridge	146:22da6e220af6	6018	*/
AnnaBridge	146:22da6e220af6	6019	CMSIS_INLINE __STATIC_INLINE void arm_circularWrite_q7(
AnnaBridge	146:22da6e220af6	6020	q7_t * circBuffer,
AnnaBridge	146:22da6e220af6	6021	int32_t L,
AnnaBridge	146:22da6e220af6	6022	uint16_t * writeOffset,
AnnaBridge	146:22da6e220af6	6023	int32_t bufferInc,
AnnaBridge	146:22da6e220af6	6024	const q7_t * src,
AnnaBridge	146:22da6e220af6	6025	int32_t srcInc,
AnnaBridge	146:22da6e220af6	6026	uint32_t blockSize)
AnnaBridge	146:22da6e220af6	6027	{
AnnaBridge	146:22da6e220af6	6028	uint32_t i = 0u;
AnnaBridge	146:22da6e220af6	6029	int32_t wOffset;
AnnaBridge	146:22da6e220af6	6030
AnnaBridge	146:22da6e220af6	6031	/* Copy the value of Index pointer that points
AnnaBridge	146:22da6e220af6	6032	* to the current location where the input samples to be copied */
AnnaBridge	146:22da6e220af6	6033	wOffset = *writeOffset;
AnnaBridge	146:22da6e220af6	6034
AnnaBridge	146:22da6e220af6	6035	/* Loop over the blockSize */
AnnaBridge	146:22da6e220af6	6036	i = blockSize;
AnnaBridge	146:22da6e220af6	6037
AnnaBridge	146:22da6e220af6	6038	while (i > 0u)
AnnaBridge	146:22da6e220af6	6039	{
AnnaBridge	146:22da6e220af6	6040	/* copy the input sample to the circular buffer */
AnnaBridge	146:22da6e220af6	6041	circBuffer[wOffset] = *src;
AnnaBridge	146:22da6e220af6	6042
AnnaBridge	146:22da6e220af6	6043	/* Update the input pointer */
AnnaBridge	146:22da6e220af6	6044	src += srcInc;
AnnaBridge	146:22da6e220af6	6045
AnnaBridge	146:22da6e220af6	6046	/* Circularly update wOffset. Watch out for positive and negative value */
AnnaBridge	146:22da6e220af6	6047	wOffset += bufferInc;
AnnaBridge	146:22da6e220af6	6048	if (wOffset >= L)
AnnaBridge	146:22da6e220af6	6049	wOffset -= L;
AnnaBridge	146:22da6e220af6	6050
AnnaBridge	146:22da6e220af6	6051	/* Decrement the loop counter */
AnnaBridge	146:22da6e220af6	6052	i--;
AnnaBridge	146:22da6e220af6	6053	}
AnnaBridge	146:22da6e220af6	6054
AnnaBridge	146:22da6e220af6	6055	/* Update the index pointer */
AnnaBridge	146:22da6e220af6	6056	*writeOffset = (uint16_t)wOffset;
AnnaBridge	146:22da6e220af6	6057	}
AnnaBridge	146:22da6e220af6	6058
AnnaBridge	146:22da6e220af6	6059
AnnaBridge	146:22da6e220af6	6060	/**
AnnaBridge	146:22da6e220af6	6061	* @brief Q7 Circular Read function.
AnnaBridge	146:22da6e220af6	6062	*/
AnnaBridge	146:22da6e220af6	6063	CMSIS_INLINE __STATIC_INLINE void arm_circularRead_q7(
AnnaBridge	146:22da6e220af6	6064	q7_t * circBuffer,
AnnaBridge	146:22da6e220af6	6065	int32_t L,
AnnaBridge	146:22da6e220af6	6066	int32_t * readOffset,
AnnaBridge	146:22da6e220af6	6067	int32_t bufferInc,
AnnaBridge	146:22da6e220af6	6068	q7_t * dst,
AnnaBridge	146:22da6e220af6	6069	q7_t * dst_base,
AnnaBridge	146:22da6e220af6	6070	int32_t dst_length,
AnnaBridge	146:22da6e220af6	6071	int32_t dstInc,
AnnaBridge	146:22da6e220af6	6072	uint32_t blockSize)
AnnaBridge	146:22da6e220af6	6073	{
AnnaBridge	146:22da6e220af6	6074	uint32_t i = 0;
AnnaBridge	146:22da6e220af6	6075	int32_t rOffset, dst_end;
AnnaBridge	146:22da6e220af6	6076
AnnaBridge	146:22da6e220af6	6077	/* Copy the value of Index pointer that points
AnnaBridge	146:22da6e220af6	6078	* to the current location from where the input samples to be read */
AnnaBridge	146:22da6e220af6	6079	rOffset = *readOffset;
AnnaBridge	146:22da6e220af6	6080
AnnaBridge	146:22da6e220af6	6081	dst_end = (int32_t) (dst_base + dst_length);
AnnaBridge	146:22da6e220af6	6082
AnnaBridge	146:22da6e220af6	6083	/* Loop over the blockSize */
AnnaBridge	146:22da6e220af6	6084	i = blockSize;
AnnaBridge	146:22da6e220af6	6085
AnnaBridge	146:22da6e220af6	6086	while (i > 0u)
AnnaBridge	146:22da6e220af6	6087	{
AnnaBridge	146:22da6e220af6	6088	/* copy the sample from the circular buffer to the destination buffer */
AnnaBridge	146:22da6e220af6	6089	*dst = circBuffer[rOffset];
AnnaBridge	146:22da6e220af6	6090
AnnaBridge	146:22da6e220af6	6091	/* Update the input pointer */
AnnaBridge	146:22da6e220af6	6092	dst += dstInc;
AnnaBridge	146:22da6e220af6	6093
AnnaBridge	146:22da6e220af6	6094	if (dst == (q7_t *) dst_end)
AnnaBridge	146:22da6e220af6	6095	{
AnnaBridge	146:22da6e220af6	6096	dst = dst_base;
AnnaBridge	146:22da6e220af6	6097	}
AnnaBridge	146:22da6e220af6	6098
AnnaBridge	146:22da6e220af6	6099	/* Circularly update rOffset. Watch out for positive and negative value */
AnnaBridge	146:22da6e220af6	6100	rOffset += bufferInc;
AnnaBridge	146:22da6e220af6	6101
AnnaBridge	146:22da6e220af6	6102	if (rOffset >= L)
AnnaBridge	146:22da6e220af6	6103	{
AnnaBridge	146:22da6e220af6	6104	rOffset -= L;
AnnaBridge	146:22da6e220af6	6105	}
AnnaBridge	146:22da6e220af6	6106
AnnaBridge	146:22da6e220af6	6107	/* Decrement the loop counter */
AnnaBridge	146:22da6e220af6	6108	i--;
AnnaBridge	146:22da6e220af6	6109	}
AnnaBridge	146:22da6e220af6	6110
AnnaBridge	146:22da6e220af6	6111	/* Update the index pointer */
AnnaBridge	146:22da6e220af6	6112	*readOffset = rOffset;
AnnaBridge	146:22da6e220af6	6113	}
AnnaBridge	146:22da6e220af6	6114
AnnaBridge	146:22da6e220af6	6115
AnnaBridge	146:22da6e220af6	6116	/**
AnnaBridge	146:22da6e220af6	6117	* @brief Sum of the squares of the elements of a Q31 vector.
AnnaBridge	146:22da6e220af6	6118	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6119	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6120	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6121	*/
AnnaBridge	146:22da6e220af6	6122	void arm_power_q31(
AnnaBridge	146:22da6e220af6	6123	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	6124	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6125	q63_t * pResult);
AnnaBridge	146:22da6e220af6	6126
AnnaBridge	146:22da6e220af6	6127
AnnaBridge	146:22da6e220af6	6128	/**
AnnaBridge	146:22da6e220af6	6129	* @brief Sum of the squares of the elements of a floating-point vector.
AnnaBridge	146:22da6e220af6	6130	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6131	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6132	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6133	*/
AnnaBridge	146:22da6e220af6	6134	void arm_power_f32(
AnnaBridge	146:22da6e220af6	6135	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	6136	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6137	float32_t * pResult);
AnnaBridge	146:22da6e220af6	6138
AnnaBridge	146:22da6e220af6	6139
AnnaBridge	146:22da6e220af6	6140	/**
AnnaBridge	146:22da6e220af6	6141	* @brief Sum of the squares of the elements of a Q15 vector.
AnnaBridge	146:22da6e220af6	6142	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6143	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6144	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6145	*/
AnnaBridge	146:22da6e220af6	6146	void arm_power_q15(
AnnaBridge	146:22da6e220af6	6147	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	6148	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6149	q63_t * pResult);
AnnaBridge	146:22da6e220af6	6150
AnnaBridge	146:22da6e220af6	6151
AnnaBridge	146:22da6e220af6	6152	/**
AnnaBridge	146:22da6e220af6	6153	* @brief Sum of the squares of the elements of a Q7 vector.
AnnaBridge	146:22da6e220af6	6154	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6155	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6156	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6157	*/
AnnaBridge	146:22da6e220af6	6158	void arm_power_q7(
AnnaBridge	146:22da6e220af6	6159	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	6160	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6161	q31_t * pResult);
AnnaBridge	146:22da6e220af6	6162
AnnaBridge	146:22da6e220af6	6163
AnnaBridge	146:22da6e220af6	6164	/**
AnnaBridge	146:22da6e220af6	6165	* @brief Mean value of a Q7 vector.
AnnaBridge	146:22da6e220af6	6166	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6167	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6168	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6169	*/
AnnaBridge	146:22da6e220af6	6170	void arm_mean_q7(
AnnaBridge	146:22da6e220af6	6171	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	6172	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6173	q7_t * pResult);
AnnaBridge	146:22da6e220af6	6174
AnnaBridge	146:22da6e220af6	6175
AnnaBridge	146:22da6e220af6	6176	/**
AnnaBridge	146:22da6e220af6	6177	* @brief Mean value of a Q15 vector.
AnnaBridge	146:22da6e220af6	6178	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6179	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6180	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6181	*/
AnnaBridge	146:22da6e220af6	6182	void arm_mean_q15(
AnnaBridge	146:22da6e220af6	6183	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	6184	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6185	q15_t * pResult);
AnnaBridge	146:22da6e220af6	6186
AnnaBridge	146:22da6e220af6	6187
AnnaBridge	146:22da6e220af6	6188	/**
AnnaBridge	146:22da6e220af6	6189	* @brief Mean value of a Q31 vector.
AnnaBridge	146:22da6e220af6	6190	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6191	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6192	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6193	*/
AnnaBridge	146:22da6e220af6	6194	void arm_mean_q31(
AnnaBridge	146:22da6e220af6	6195	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	6196	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6197	q31_t * pResult);
AnnaBridge	146:22da6e220af6	6198
AnnaBridge	146:22da6e220af6	6199
AnnaBridge	146:22da6e220af6	6200	/**
AnnaBridge	146:22da6e220af6	6201	* @brief Mean value of a floating-point vector.
AnnaBridge	146:22da6e220af6	6202	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6203	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6204	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6205	*/
AnnaBridge	146:22da6e220af6	6206	void arm_mean_f32(
AnnaBridge	146:22da6e220af6	6207	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	6208	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6209	float32_t * pResult);
AnnaBridge	146:22da6e220af6	6210
AnnaBridge	146:22da6e220af6	6211
AnnaBridge	146:22da6e220af6	6212	/**
AnnaBridge	146:22da6e220af6	6213	* @brief Variance of the elements of a floating-point vector.
AnnaBridge	146:22da6e220af6	6214	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6215	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6216	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6217	*/
AnnaBridge	146:22da6e220af6	6218	void arm_var_f32(
AnnaBridge	146:22da6e220af6	6219	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	6220	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6221	float32_t * pResult);
AnnaBridge	146:22da6e220af6	6222
AnnaBridge	146:22da6e220af6	6223
AnnaBridge	146:22da6e220af6	6224	/**
AnnaBridge	146:22da6e220af6	6225	* @brief Variance of the elements of a Q31 vector.
AnnaBridge	146:22da6e220af6	6226	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6227	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6228	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6229	*/
AnnaBridge	146:22da6e220af6	6230	void arm_var_q31(
AnnaBridge	146:22da6e220af6	6231	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	6232	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6233	q31_t * pResult);
AnnaBridge	146:22da6e220af6	6234
AnnaBridge	146:22da6e220af6	6235
AnnaBridge	146:22da6e220af6	6236	/**
AnnaBridge	146:22da6e220af6	6237	* @brief Variance of the elements of a Q15 vector.
AnnaBridge	146:22da6e220af6	6238	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6239	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6240	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6241	*/
AnnaBridge	146:22da6e220af6	6242	void arm_var_q15(
AnnaBridge	146:22da6e220af6	6243	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	6244	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6245	q15_t * pResult);
AnnaBridge	146:22da6e220af6	6246
AnnaBridge	146:22da6e220af6	6247
AnnaBridge	146:22da6e220af6	6248	/**
AnnaBridge	146:22da6e220af6	6249	* @brief Root Mean Square of the elements of a floating-point vector.
AnnaBridge	146:22da6e220af6	6250	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6251	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6252	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6253	*/
AnnaBridge	146:22da6e220af6	6254	void arm_rms_f32(
AnnaBridge	146:22da6e220af6	6255	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	6256	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6257	float32_t * pResult);
AnnaBridge	146:22da6e220af6	6258
AnnaBridge	146:22da6e220af6	6259
AnnaBridge	146:22da6e220af6	6260	/**
AnnaBridge	146:22da6e220af6	6261	* @brief Root Mean Square of the elements of a Q31 vector.
AnnaBridge	146:22da6e220af6	6262	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6263	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6264	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6265	*/
AnnaBridge	146:22da6e220af6	6266	void arm_rms_q31(
AnnaBridge	146:22da6e220af6	6267	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	6268	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6269	q31_t * pResult);
AnnaBridge	146:22da6e220af6	6270
AnnaBridge	146:22da6e220af6	6271
AnnaBridge	146:22da6e220af6	6272	/**
AnnaBridge	146:22da6e220af6	6273	* @brief Root Mean Square of the elements of a Q15 vector.
AnnaBridge	146:22da6e220af6	6274	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6275	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6276	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6277	*/
AnnaBridge	146:22da6e220af6	6278	void arm_rms_q15(
AnnaBridge	146:22da6e220af6	6279	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	6280	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6281	q15_t * pResult);
AnnaBridge	146:22da6e220af6	6282
AnnaBridge	146:22da6e220af6	6283
AnnaBridge	146:22da6e220af6	6284	/**
AnnaBridge	146:22da6e220af6	6285	* @brief Standard deviation of the elements of a floating-point vector.
AnnaBridge	146:22da6e220af6	6286	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6287	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6288	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6289	*/
AnnaBridge	146:22da6e220af6	6290	void arm_std_f32(
AnnaBridge	146:22da6e220af6	6291	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	6292	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6293	float32_t * pResult);
AnnaBridge	146:22da6e220af6	6294
AnnaBridge	146:22da6e220af6	6295
AnnaBridge	146:22da6e220af6	6296	/**
AnnaBridge	146:22da6e220af6	6297	* @brief Standard deviation of the elements of a Q31 vector.
AnnaBridge	146:22da6e220af6	6298	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6299	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6300	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6301	*/
AnnaBridge	146:22da6e220af6	6302	void arm_std_q31(
AnnaBridge	146:22da6e220af6	6303	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	6304	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6305	q31_t * pResult);
AnnaBridge	146:22da6e220af6	6306
AnnaBridge	146:22da6e220af6	6307
AnnaBridge	146:22da6e220af6	6308	/**
AnnaBridge	146:22da6e220af6	6309	* @brief Standard deviation of the elements of a Q15 vector.
AnnaBridge	146:22da6e220af6	6310	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6311	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6312	* @param[out] pResult is output value.
AnnaBridge	146:22da6e220af6	6313	*/
AnnaBridge	146:22da6e220af6	6314	void arm_std_q15(
AnnaBridge	146:22da6e220af6	6315	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	6316	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6317	q15_t * pResult);
AnnaBridge	146:22da6e220af6	6318
AnnaBridge	146:22da6e220af6	6319
AnnaBridge	146:22da6e220af6	6320	/**
AnnaBridge	146:22da6e220af6	6321	* @brief Floating-point complex magnitude
AnnaBridge	146:22da6e220af6	6322	* @param[in] pSrc points to the complex input vector
AnnaBridge	146:22da6e220af6	6323	* @param[out] pDst points to the real output vector
AnnaBridge	146:22da6e220af6	6324	* @param[in] numSamples number of complex samples in the input vector
AnnaBridge	146:22da6e220af6	6325	*/
AnnaBridge	146:22da6e220af6	6326	void arm_cmplx_mag_f32(
AnnaBridge	146:22da6e220af6	6327	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	6328	float32_t * pDst,
AnnaBridge	146:22da6e220af6	6329	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	6330
AnnaBridge	146:22da6e220af6	6331
AnnaBridge	146:22da6e220af6	6332	/**
AnnaBridge	146:22da6e220af6	6333	* @brief Q31 complex magnitude
AnnaBridge	146:22da6e220af6	6334	* @param[in] pSrc points to the complex input vector
AnnaBridge	146:22da6e220af6	6335	* @param[out] pDst points to the real output vector
AnnaBridge	146:22da6e220af6	6336	* @param[in] numSamples number of complex samples in the input vector
AnnaBridge	146:22da6e220af6	6337	*/
AnnaBridge	146:22da6e220af6	6338	void arm_cmplx_mag_q31(
AnnaBridge	146:22da6e220af6	6339	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	6340	q31_t * pDst,
AnnaBridge	146:22da6e220af6	6341	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	6342
AnnaBridge	146:22da6e220af6	6343
AnnaBridge	146:22da6e220af6	6344	/**
AnnaBridge	146:22da6e220af6	6345	* @brief Q15 complex magnitude
AnnaBridge	146:22da6e220af6	6346	* @param[in] pSrc points to the complex input vector
AnnaBridge	146:22da6e220af6	6347	* @param[out] pDst points to the real output vector
AnnaBridge	146:22da6e220af6	6348	* @param[in] numSamples number of complex samples in the input vector
AnnaBridge	146:22da6e220af6	6349	*/
AnnaBridge	146:22da6e220af6	6350	void arm_cmplx_mag_q15(
AnnaBridge	146:22da6e220af6	6351	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	6352	q15_t * pDst,
AnnaBridge	146:22da6e220af6	6353	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	6354
AnnaBridge	146:22da6e220af6	6355
AnnaBridge	146:22da6e220af6	6356	/**
AnnaBridge	146:22da6e220af6	6357	* @brief Q15 complex dot product
AnnaBridge	146:22da6e220af6	6358	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	6359	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	6360	* @param[in] numSamples number of complex samples in each vector
AnnaBridge	146:22da6e220af6	6361	* @param[out] realResult real part of the result returned here
AnnaBridge	146:22da6e220af6	6362	* @param[out] imagResult imaginary part of the result returned here
AnnaBridge	146:22da6e220af6	6363	*/
AnnaBridge	146:22da6e220af6	6364	void arm_cmplx_dot_prod_q15(
AnnaBridge	146:22da6e220af6	6365	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	6366	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	6367	uint32_t numSamples,
AnnaBridge	146:22da6e220af6	6368	q31_t * realResult,
AnnaBridge	146:22da6e220af6	6369	q31_t * imagResult);
AnnaBridge	146:22da6e220af6	6370
AnnaBridge	146:22da6e220af6	6371
AnnaBridge	146:22da6e220af6	6372	/**
AnnaBridge	146:22da6e220af6	6373	* @brief Q31 complex dot product
AnnaBridge	146:22da6e220af6	6374	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	6375	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	6376	* @param[in] numSamples number of complex samples in each vector
AnnaBridge	146:22da6e220af6	6377	* @param[out] realResult real part of the result returned here
AnnaBridge	146:22da6e220af6	6378	* @param[out] imagResult imaginary part of the result returned here
AnnaBridge	146:22da6e220af6	6379	*/
AnnaBridge	146:22da6e220af6	6380	void arm_cmplx_dot_prod_q31(
AnnaBridge	146:22da6e220af6	6381	q31_t * pSrcA,
AnnaBridge	146:22da6e220af6	6382	q31_t * pSrcB,
AnnaBridge	146:22da6e220af6	6383	uint32_t numSamples,
AnnaBridge	146:22da6e220af6	6384	q63_t * realResult,
AnnaBridge	146:22da6e220af6	6385	q63_t * imagResult);
AnnaBridge	146:22da6e220af6	6386
AnnaBridge	146:22da6e220af6	6387
AnnaBridge	146:22da6e220af6	6388	/**
AnnaBridge	146:22da6e220af6	6389	* @brief Floating-point complex dot product
AnnaBridge	146:22da6e220af6	6390	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	6391	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	6392	* @param[in] numSamples number of complex samples in each vector
AnnaBridge	146:22da6e220af6	6393	* @param[out] realResult real part of the result returned here
AnnaBridge	146:22da6e220af6	6394	* @param[out] imagResult imaginary part of the result returned here
AnnaBridge	146:22da6e220af6	6395	*/
AnnaBridge	146:22da6e220af6	6396	void arm_cmplx_dot_prod_f32(
AnnaBridge	146:22da6e220af6	6397	float32_t * pSrcA,
AnnaBridge	146:22da6e220af6	6398	float32_t * pSrcB,
AnnaBridge	146:22da6e220af6	6399	uint32_t numSamples,
AnnaBridge	146:22da6e220af6	6400	float32_t * realResult,
AnnaBridge	146:22da6e220af6	6401	float32_t * imagResult);
AnnaBridge	146:22da6e220af6	6402
AnnaBridge	146:22da6e220af6	6403
AnnaBridge	146:22da6e220af6	6404	/**
AnnaBridge	146:22da6e220af6	6405	* @brief Q15 complex-by-real multiplication
AnnaBridge	146:22da6e220af6	6406	* @param[in] pSrcCmplx points to the complex input vector
AnnaBridge	146:22da6e220af6	6407	* @param[in] pSrcReal points to the real input vector
AnnaBridge	146:22da6e220af6	6408	* @param[out] pCmplxDst points to the complex output vector
AnnaBridge	146:22da6e220af6	6409	* @param[in] numSamples number of samples in each vector
AnnaBridge	146:22da6e220af6	6410	*/
AnnaBridge	146:22da6e220af6	6411	void arm_cmplx_mult_real_q15(
AnnaBridge	146:22da6e220af6	6412	q15_t * pSrcCmplx,
AnnaBridge	146:22da6e220af6	6413	q15_t * pSrcReal,
AnnaBridge	146:22da6e220af6	6414	q15_t * pCmplxDst,
AnnaBridge	146:22da6e220af6	6415	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	6416
AnnaBridge	146:22da6e220af6	6417
AnnaBridge	146:22da6e220af6	6418	/**
AnnaBridge	146:22da6e220af6	6419	* @brief Q31 complex-by-real multiplication
AnnaBridge	146:22da6e220af6	6420	* @param[in] pSrcCmplx points to the complex input vector
AnnaBridge	146:22da6e220af6	6421	* @param[in] pSrcReal points to the real input vector
AnnaBridge	146:22da6e220af6	6422	* @param[out] pCmplxDst points to the complex output vector
AnnaBridge	146:22da6e220af6	6423	* @param[in] numSamples number of samples in each vector
AnnaBridge	146:22da6e220af6	6424	*/
AnnaBridge	146:22da6e220af6	6425	void arm_cmplx_mult_real_q31(
AnnaBridge	146:22da6e220af6	6426	q31_t * pSrcCmplx,
AnnaBridge	146:22da6e220af6	6427	q31_t * pSrcReal,
AnnaBridge	146:22da6e220af6	6428	q31_t * pCmplxDst,
AnnaBridge	146:22da6e220af6	6429	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	6430
AnnaBridge	146:22da6e220af6	6431
AnnaBridge	146:22da6e220af6	6432	/**
AnnaBridge	146:22da6e220af6	6433	* @brief Floating-point complex-by-real multiplication
AnnaBridge	146:22da6e220af6	6434	* @param[in] pSrcCmplx points to the complex input vector
AnnaBridge	146:22da6e220af6	6435	* @param[in] pSrcReal points to the real input vector
AnnaBridge	146:22da6e220af6	6436	* @param[out] pCmplxDst points to the complex output vector
AnnaBridge	146:22da6e220af6	6437	* @param[in] numSamples number of samples in each vector
AnnaBridge	146:22da6e220af6	6438	*/
AnnaBridge	146:22da6e220af6	6439	void arm_cmplx_mult_real_f32(
AnnaBridge	146:22da6e220af6	6440	float32_t * pSrcCmplx,
AnnaBridge	146:22da6e220af6	6441	float32_t * pSrcReal,
AnnaBridge	146:22da6e220af6	6442	float32_t * pCmplxDst,
AnnaBridge	146:22da6e220af6	6443	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	6444
AnnaBridge	146:22da6e220af6	6445
AnnaBridge	146:22da6e220af6	6446	/**
AnnaBridge	146:22da6e220af6	6447	* @brief Minimum value of a Q7 vector.
AnnaBridge	146:22da6e220af6	6448	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6449	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6450	* @param[out] result is output pointer
AnnaBridge	146:22da6e220af6	6451	* @param[in] index is the array index of the minimum value in the input buffer.
AnnaBridge	146:22da6e220af6	6452	*/
AnnaBridge	146:22da6e220af6	6453	void arm_min_q7(
AnnaBridge	146:22da6e220af6	6454	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	6455	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6456	q7_t * result,
AnnaBridge	146:22da6e220af6	6457	uint32_t * index);
AnnaBridge	146:22da6e220af6	6458
AnnaBridge	146:22da6e220af6	6459
AnnaBridge	146:22da6e220af6	6460	/**
AnnaBridge	146:22da6e220af6	6461	* @brief Minimum value of a Q15 vector.
AnnaBridge	146:22da6e220af6	6462	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6463	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6464	* @param[out] pResult is output pointer
AnnaBridge	146:22da6e220af6	6465	* @param[in] pIndex is the array index of the minimum value in the input buffer.
AnnaBridge	146:22da6e220af6	6466	*/
AnnaBridge	146:22da6e220af6	6467	void arm_min_q15(
AnnaBridge	146:22da6e220af6	6468	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	6469	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6470	q15_t * pResult,
AnnaBridge	146:22da6e220af6	6471	uint32_t * pIndex);
AnnaBridge	146:22da6e220af6	6472
AnnaBridge	146:22da6e220af6	6473
AnnaBridge	146:22da6e220af6	6474	/**
AnnaBridge	146:22da6e220af6	6475	* @brief Minimum value of a Q31 vector.
AnnaBridge	146:22da6e220af6	6476	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6477	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6478	* @param[out] pResult is output pointer
AnnaBridge	146:22da6e220af6	6479	* @param[out] pIndex is the array index of the minimum value in the input buffer.
AnnaBridge	146:22da6e220af6	6480	*/
AnnaBridge	146:22da6e220af6	6481	void arm_min_q31(
AnnaBridge	146:22da6e220af6	6482	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	6483	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6484	q31_t * pResult,
AnnaBridge	146:22da6e220af6	6485	uint32_t * pIndex);
AnnaBridge	146:22da6e220af6	6486
AnnaBridge	146:22da6e220af6	6487
AnnaBridge	146:22da6e220af6	6488	/**
AnnaBridge	146:22da6e220af6	6489	* @brief Minimum value of a floating-point vector.
AnnaBridge	146:22da6e220af6	6490	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6491	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6492	* @param[out] pResult is output pointer
AnnaBridge	146:22da6e220af6	6493	* @param[out] pIndex is the array index of the minimum value in the input buffer.
AnnaBridge	146:22da6e220af6	6494	*/
AnnaBridge	146:22da6e220af6	6495	void arm_min_f32(
AnnaBridge	146:22da6e220af6	6496	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	6497	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6498	float32_t * pResult,
AnnaBridge	146:22da6e220af6	6499	uint32_t * pIndex);
AnnaBridge	146:22da6e220af6	6500
AnnaBridge	146:22da6e220af6	6501
AnnaBridge	146:22da6e220af6	6502	/**
AnnaBridge	146:22da6e220af6	6503	* @brief Maximum value of a Q7 vector.
AnnaBridge	146:22da6e220af6	6504	* @param[in] pSrc points to the input buffer
AnnaBridge	146:22da6e220af6	6505	* @param[in] blockSize length of the input vector
AnnaBridge	146:22da6e220af6	6506	* @param[out] pResult maximum value returned here
AnnaBridge	146:22da6e220af6	6507	* @param[out] pIndex index of maximum value returned here
AnnaBridge	146:22da6e220af6	6508	*/
AnnaBridge	146:22da6e220af6	6509	void arm_max_q7(
AnnaBridge	146:22da6e220af6	6510	q7_t * pSrc,
AnnaBridge	146:22da6e220af6	6511	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6512	q7_t * pResult,
AnnaBridge	146:22da6e220af6	6513	uint32_t * pIndex);
AnnaBridge	146:22da6e220af6	6514
AnnaBridge	146:22da6e220af6	6515
AnnaBridge	146:22da6e220af6	6516	/**
AnnaBridge	146:22da6e220af6	6517	* @brief Maximum value of a Q15 vector.
AnnaBridge	146:22da6e220af6	6518	* @param[in] pSrc points to the input buffer
AnnaBridge	146:22da6e220af6	6519	* @param[in] blockSize length of the input vector
AnnaBridge	146:22da6e220af6	6520	* @param[out] pResult maximum value returned here
AnnaBridge	146:22da6e220af6	6521	* @param[out] pIndex index of maximum value returned here
AnnaBridge	146:22da6e220af6	6522	*/
AnnaBridge	146:22da6e220af6	6523	void arm_max_q15(
AnnaBridge	146:22da6e220af6	6524	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	6525	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6526	q15_t * pResult,
AnnaBridge	146:22da6e220af6	6527	uint32_t * pIndex);
AnnaBridge	146:22da6e220af6	6528
AnnaBridge	146:22da6e220af6	6529
AnnaBridge	146:22da6e220af6	6530	/**
AnnaBridge	146:22da6e220af6	6531	* @brief Maximum value of a Q31 vector.
AnnaBridge	146:22da6e220af6	6532	* @param[in] pSrc points to the input buffer
AnnaBridge	146:22da6e220af6	6533	* @param[in] blockSize length of the input vector
AnnaBridge	146:22da6e220af6	6534	* @param[out] pResult maximum value returned here
AnnaBridge	146:22da6e220af6	6535	* @param[out] pIndex index of maximum value returned here
AnnaBridge	146:22da6e220af6	6536	*/
AnnaBridge	146:22da6e220af6	6537	void arm_max_q31(
AnnaBridge	146:22da6e220af6	6538	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	6539	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6540	q31_t * pResult,
AnnaBridge	146:22da6e220af6	6541	uint32_t * pIndex);
AnnaBridge	146:22da6e220af6	6542
AnnaBridge	146:22da6e220af6	6543
AnnaBridge	146:22da6e220af6	6544	/**
AnnaBridge	146:22da6e220af6	6545	* @brief Maximum value of a floating-point vector.
AnnaBridge	146:22da6e220af6	6546	* @param[in] pSrc points to the input buffer
AnnaBridge	146:22da6e220af6	6547	* @param[in] blockSize length of the input vector
AnnaBridge	146:22da6e220af6	6548	* @param[out] pResult maximum value returned here
AnnaBridge	146:22da6e220af6	6549	* @param[out] pIndex index of maximum value returned here
AnnaBridge	146:22da6e220af6	6550	*/
AnnaBridge	146:22da6e220af6	6551	void arm_max_f32(
AnnaBridge	146:22da6e220af6	6552	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	6553	uint32_t blockSize,
AnnaBridge	146:22da6e220af6	6554	float32_t * pResult,
AnnaBridge	146:22da6e220af6	6555	uint32_t * pIndex);
AnnaBridge	146:22da6e220af6	6556
AnnaBridge	146:22da6e220af6	6557
AnnaBridge	146:22da6e220af6	6558	/**
AnnaBridge	146:22da6e220af6	6559	* @brief Q15 complex-by-complex multiplication
AnnaBridge	146:22da6e220af6	6560	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	6561	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	6562	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	6563	* @param[in] numSamples number of complex samples in each vector
AnnaBridge	146:22da6e220af6	6564	*/
AnnaBridge	146:22da6e220af6	6565	void arm_cmplx_mult_cmplx_q15(
AnnaBridge	146:22da6e220af6	6566	q15_t * pSrcA,
AnnaBridge	146:22da6e220af6	6567	q15_t * pSrcB,
AnnaBridge	146:22da6e220af6	6568	q15_t * pDst,
AnnaBridge	146:22da6e220af6	6569	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	6570
AnnaBridge	146:22da6e220af6	6571
AnnaBridge	146:22da6e220af6	6572	/**
AnnaBridge	146:22da6e220af6	6573	* @brief Q31 complex-by-complex multiplication
AnnaBridge	146:22da6e220af6	6574	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	6575	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	6576	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	6577	* @param[in] numSamples number of complex samples in each vector
AnnaBridge	146:22da6e220af6	6578	*/
AnnaBridge	146:22da6e220af6	6579	void arm_cmplx_mult_cmplx_q31(
AnnaBridge	146:22da6e220af6	6580	q31_t * pSrcA,
AnnaBridge	146:22da6e220af6	6581	q31_t * pSrcB,
AnnaBridge	146:22da6e220af6	6582	q31_t * pDst,
AnnaBridge	146:22da6e220af6	6583	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	6584
AnnaBridge	146:22da6e220af6	6585
AnnaBridge	146:22da6e220af6	6586	/**
AnnaBridge	146:22da6e220af6	6587	* @brief Floating-point complex-by-complex multiplication
AnnaBridge	146:22da6e220af6	6588	* @param[in] pSrcA points to the first input vector
AnnaBridge	146:22da6e220af6	6589	* @param[in] pSrcB points to the second input vector
AnnaBridge	146:22da6e220af6	6590	* @param[out] pDst points to the output vector
AnnaBridge	146:22da6e220af6	6591	* @param[in] numSamples number of complex samples in each vector
AnnaBridge	146:22da6e220af6	6592	*/
AnnaBridge	146:22da6e220af6	6593	void arm_cmplx_mult_cmplx_f32(
AnnaBridge	146:22da6e220af6	6594	float32_t * pSrcA,
AnnaBridge	146:22da6e220af6	6595	float32_t * pSrcB,
AnnaBridge	146:22da6e220af6	6596	float32_t * pDst,
AnnaBridge	146:22da6e220af6	6597	uint32_t numSamples);
AnnaBridge	146:22da6e220af6	6598
AnnaBridge	146:22da6e220af6	6599
AnnaBridge	146:22da6e220af6	6600	/**
AnnaBridge	146:22da6e220af6	6601	* @brief Converts the elements of the floating-point vector to Q31 vector.
AnnaBridge	146:22da6e220af6	6602	* @param[in] pSrc points to the floating-point input vector
AnnaBridge	146:22da6e220af6	6603	* @param[out] pDst points to the Q31 output vector
AnnaBridge	146:22da6e220af6	6604	* @param[in] blockSize length of the input vector
AnnaBridge	146:22da6e220af6	6605	*/
AnnaBridge	146:22da6e220af6	6606	void arm_float_to_q31(
AnnaBridge	146:22da6e220af6	6607	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	6608	q31_t * pDst,
AnnaBridge	146:22da6e220af6	6609	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	6610
AnnaBridge	146:22da6e220af6	6611
AnnaBridge	146:22da6e220af6	6612	/**
AnnaBridge	146:22da6e220af6	6613	* @brief Converts the elements of the floating-point vector to Q15 vector.
AnnaBridge	146:22da6e220af6	6614	* @param[in] pSrc points to the floating-point input vector
AnnaBridge	146:22da6e220af6	6615	* @param[out] pDst points to the Q15 output vector
AnnaBridge	146:22da6e220af6	6616	* @param[in] blockSize length of the input vector
AnnaBridge	146:22da6e220af6	6617	*/
AnnaBridge	146:22da6e220af6	6618	void arm_float_to_q15(
AnnaBridge	146:22da6e220af6	6619	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	6620	q15_t * pDst,
AnnaBridge	146:22da6e220af6	6621	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	6622
AnnaBridge	146:22da6e220af6	6623
AnnaBridge	146:22da6e220af6	6624	/**
AnnaBridge	146:22da6e220af6	6625	* @brief Converts the elements of the floating-point vector to Q7 vector.
AnnaBridge	146:22da6e220af6	6626	* @param[in] pSrc points to the floating-point input vector
AnnaBridge	146:22da6e220af6	6627	* @param[out] pDst points to the Q7 output vector
AnnaBridge	146:22da6e220af6	6628	* @param[in] blockSize length of the input vector
AnnaBridge	146:22da6e220af6	6629	*/
AnnaBridge	146:22da6e220af6	6630	void arm_float_to_q7(
AnnaBridge	146:22da6e220af6	6631	float32_t * pSrc,
AnnaBridge	146:22da6e220af6	6632	q7_t * pDst,
AnnaBridge	146:22da6e220af6	6633	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	6634
AnnaBridge	146:22da6e220af6	6635
AnnaBridge	146:22da6e220af6	6636	/**
AnnaBridge	146:22da6e220af6	6637	* @brief Converts the elements of the Q31 vector to Q15 vector.
AnnaBridge	146:22da6e220af6	6638	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6639	* @param[out] pDst is output pointer
AnnaBridge	146:22da6e220af6	6640	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6641	*/
AnnaBridge	146:22da6e220af6	6642	void arm_q31_to_q15(
AnnaBridge	146:22da6e220af6	6643	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	6644	q15_t * pDst,
AnnaBridge	146:22da6e220af6	6645	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	6646
AnnaBridge	146:22da6e220af6	6647
AnnaBridge	146:22da6e220af6	6648	/**
AnnaBridge	146:22da6e220af6	6649	* @brief Converts the elements of the Q31 vector to Q7 vector.
AnnaBridge	146:22da6e220af6	6650	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6651	* @param[out] pDst is output pointer
AnnaBridge	146:22da6e220af6	6652	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6653	*/
AnnaBridge	146:22da6e220af6	6654	void arm_q31_to_q7(
AnnaBridge	146:22da6e220af6	6655	q31_t * pSrc,
AnnaBridge	146:22da6e220af6	6656	q7_t * pDst,
AnnaBridge	146:22da6e220af6	6657	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	6658
AnnaBridge	146:22da6e220af6	6659
AnnaBridge	146:22da6e220af6	6660	/**
AnnaBridge	146:22da6e220af6	6661	* @brief Converts the elements of the Q15 vector to floating-point vector.
AnnaBridge	146:22da6e220af6	6662	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6663	* @param[out] pDst is output pointer
AnnaBridge	146:22da6e220af6	6664	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6665	*/
AnnaBridge	146:22da6e220af6	6666	void arm_q15_to_float(
AnnaBridge	146:22da6e220af6	6667	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	6668	float32_t * pDst,
AnnaBridge	146:22da6e220af6	6669	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	6670
AnnaBridge	146:22da6e220af6	6671
AnnaBridge	146:22da6e220af6	6672	/**
AnnaBridge	146:22da6e220af6	6673	* @brief Converts the elements of the Q15 vector to Q31 vector.
AnnaBridge	146:22da6e220af6	6674	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6675	* @param[out] pDst is output pointer
AnnaBridge	146:22da6e220af6	6676	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6677	*/
AnnaBridge	146:22da6e220af6	6678	void arm_q15_to_q31(
AnnaBridge	146:22da6e220af6	6679	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	6680	q31_t * pDst,
AnnaBridge	146:22da6e220af6	6681	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	6682
AnnaBridge	146:22da6e220af6	6683
AnnaBridge	146:22da6e220af6	6684	/**
AnnaBridge	146:22da6e220af6	6685	* @brief Converts the elements of the Q15 vector to Q7 vector.
AnnaBridge	146:22da6e220af6	6686	* @param[in] pSrc is input pointer
AnnaBridge	146:22da6e220af6	6687	* @param[out] pDst is output pointer
AnnaBridge	146:22da6e220af6	6688	* @param[in] blockSize is the number of samples to process
AnnaBridge	146:22da6e220af6	6689	*/
AnnaBridge	146:22da6e220af6	6690	void arm_q15_to_q7(
AnnaBridge	146:22da6e220af6	6691	q15_t * pSrc,
AnnaBridge	146:22da6e220af6	6692	q7_t * pDst,
AnnaBridge	146:22da6e220af6	6693	uint32_t blockSize);
AnnaBridge	146:22da6e220af6	6694
AnnaBridge	146:22da6e220af6	6695
AnnaBridge	146:22da6e220af6	6696	/**
AnnaBridge	146:22da6e220af6	6697	* @ingroup groupInterpolation
AnnaBridge	146:22da6e220af6	6698	*/
AnnaBridge	146:22da6e220af6	6699
AnnaBridge	146:22da6e220af6	6700	/**
AnnaBridge	146:22da6e220af6	6701	* @defgroup BilinearInterpolate Bilinear Interpolation
AnnaBridge	146:22da6e220af6	6702	*
AnnaBridge	146:22da6e220af6	6703	* Bilinear interpolation is an extension of linear interpolation applied to a two dimensional grid.
AnnaBridge	146:22da6e220af6	6704	* The underlying function <code>f(x, y)</code> is sampled on a regular grid and the interpolation process
AnnaBridge	146:22da6e220af6	6705	* determines values between the grid points.
AnnaBridge	146:22da6e220af6	6706	* Bilinear interpolation is equivalent to two step linear interpolation, first in the x-dimension and then in the y-dimension.
AnnaBridge	146:22da6e220af6	6707	* Bilinear interpolation is often used in image processing to rescale images.
AnnaBridge	146:22da6e220af6	6708	* The CMSIS DSP library provides bilinear interpolation functions for Q7, Q15, Q31, and floating-point data types.
AnnaBridge	146:22da6e220af6	6709	*
AnnaBridge	146:22da6e220af6	6710	* <b>Algorithm</b>
AnnaBridge	146:22da6e220af6	6711	* \par
AnnaBridge	146:22da6e220af6	6712	* The instance structure used by the bilinear interpolation functions describes a two dimensional data table.
AnnaBridge	146:22da6e220af6	6713	* For floating-point, the instance structure is defined as:
AnnaBridge	146:22da6e220af6	6714	* <pre>
AnnaBridge	146:22da6e220af6	6715	* typedef struct
AnnaBridge	146:22da6e220af6	6716	* {
AnnaBridge	146:22da6e220af6	6717	* uint16_t numRows;
AnnaBridge	146:22da6e220af6	6718	* uint16_t numCols;
AnnaBridge	146:22da6e220af6	6719	* float32_t *pData;
AnnaBridge	146:22da6e220af6	6720	* } arm_bilinear_interp_instance_f32;
AnnaBridge	146:22da6e220af6	6721	* </pre>
AnnaBridge	146:22da6e220af6	6722	*
AnnaBridge	146:22da6e220af6	6723	* \par
AnnaBridge	146:22da6e220af6	6724	* where <code>numRows</code> specifies the number of rows in the table;
AnnaBridge	146:22da6e220af6	6725	* <code>numCols</code> specifies the number of columns in the table;
AnnaBridge	146:22da6e220af6	6726	* and <code>pData</code> points to an array of size <code>numRows*numCols</code> values.
AnnaBridge	146:22da6e220af6	6727	* The data table <code>pTable</code> is organized in row order and the supplied data values fall on integer indexes.
AnnaBridge	146:22da6e220af6	6728	* That is, table element (x,y) is located at <code>pTable[x + y*numCols]</code> where x and y are integers.
AnnaBridge	146:22da6e220af6	6729	*
AnnaBridge	146:22da6e220af6	6730	* \par
AnnaBridge	146:22da6e220af6	6731	* Let <code>(x, y)</code> specify the desired interpolation point. Then define:
AnnaBridge	146:22da6e220af6	6732	* <pre>
AnnaBridge	146:22da6e220af6	6733	* XF = floor(x)
AnnaBridge	146:22da6e220af6	6734	* YF = floor(y)
AnnaBridge	146:22da6e220af6	6735	* </pre>
AnnaBridge	146:22da6e220af6	6736	* \par
AnnaBridge	146:22da6e220af6	6737	* The interpolated output point is computed as:
AnnaBridge	146:22da6e220af6	6738	* <pre>
AnnaBridge	146:22da6e220af6	6739	* f(x, y) = f(XF, YF) * (1-(x-XF)) * (1-(y-YF))
AnnaBridge	146:22da6e220af6	6740	* + f(XF+1, YF) * (x-XF)*(1-(y-YF))
AnnaBridge	146:22da6e220af6	6741	* + f(XF, YF+1) * (1-(x-XF))*(y-YF)
AnnaBridge	146:22da6e220af6	6742	* + f(XF+1, YF+1) * (x-XF)*(y-YF)
AnnaBridge	146:22da6e220af6	6743	* </pre>
AnnaBridge	146:22da6e220af6	6744	* Note that the coordinates (x, y) contain integer and fractional components.
AnnaBridge	146:22da6e220af6	6745	* The integer components specify which portion of the table to use while the
AnnaBridge	146:22da6e220af6	6746	* fractional components control the interpolation processor.
AnnaBridge	146:22da6e220af6	6747	*
AnnaBridge	146:22da6e220af6	6748	* \par
AnnaBridge	146:22da6e220af6	6749	* if (x,y) are outside of the table boundary, Bilinear interpolation returns zero output.
AnnaBridge	146:22da6e220af6	6750	*/
AnnaBridge	146:22da6e220af6	6751
AnnaBridge	146:22da6e220af6	6752	/**
AnnaBridge	146:22da6e220af6	6753	* @addtogroup BilinearInterpolate
AnnaBridge	146:22da6e220af6	6754	* @{
AnnaBridge	146:22da6e220af6	6755	*/
AnnaBridge	146:22da6e220af6	6756
AnnaBridge	146:22da6e220af6	6757
AnnaBridge	146:22da6e220af6	6758	/**
AnnaBridge	146:22da6e220af6	6759	*
AnnaBridge	146:22da6e220af6	6760	* @brief Floating-point bilinear interpolation.
AnnaBridge	146:22da6e220af6	6761	* @param[in,out] S points to an instance of the interpolation structure.
AnnaBridge	146:22da6e220af6	6762	* @param[in] X interpolation coordinate.
AnnaBridge	146:22da6e220af6	6763	* @param[in] Y interpolation coordinate.
AnnaBridge	146:22da6e220af6	6764	* @return out interpolated value.
AnnaBridge	146:22da6e220af6	6765	*/
AnnaBridge	146:22da6e220af6	6766	CMSIS_INLINE __STATIC_INLINE float32_t arm_bilinear_interp_f32(
AnnaBridge	146:22da6e220af6	6767	const arm_bilinear_interp_instance_f32 * S,
AnnaBridge	146:22da6e220af6	6768	float32_t X,
AnnaBridge	146:22da6e220af6	6769	float32_t Y)
AnnaBridge	146:22da6e220af6	6770	{
AnnaBridge	146:22da6e220af6	6771	float32_t out;
AnnaBridge	146:22da6e220af6	6772	float32_t f00, f01, f10, f11;
AnnaBridge	146:22da6e220af6	6773	float32_t *pData = S->pData;
AnnaBridge	146:22da6e220af6	6774	int32_t xIndex, yIndex, index;
AnnaBridge	146:22da6e220af6	6775	float32_t xdiff, ydiff;
AnnaBridge	146:22da6e220af6	6776	float32_t b1, b2, b3, b4;
AnnaBridge	146:22da6e220af6	6777
AnnaBridge	146:22da6e220af6	6778	xIndex = (int32_t) X;
AnnaBridge	146:22da6e220af6	6779	yIndex = (int32_t) Y;
AnnaBridge	146:22da6e220af6	6780
AnnaBridge	146:22da6e220af6	6781	/* Care taken for table outside boundary */
AnnaBridge	146:22da6e220af6	6782	/* Returns zero output when values are outside table boundary */
AnnaBridge	146:22da6e220af6	6783	if (xIndex < 0 \|\| xIndex > (S->numRows - 1) \|\| yIndex < 0 \|\| yIndex > (S->numCols - 1))
AnnaBridge	146:22da6e220af6	6784	{
AnnaBridge	146:22da6e220af6	6785	return (0);
AnnaBridge	146:22da6e220af6	6786	}
AnnaBridge	146:22da6e220af6	6787
AnnaBridge	146:22da6e220af6	6788	/* Calculation of index for two nearest points in X-direction */
AnnaBridge	146:22da6e220af6	6789	index = (xIndex - 1) + (yIndex - 1) * S->numCols;
AnnaBridge	146:22da6e220af6	6790
AnnaBridge	146:22da6e220af6	6791
AnnaBridge	146:22da6e220af6	6792	/* Read two nearest points in X-direction */
AnnaBridge	146:22da6e220af6	6793	f00 = pData[index];
AnnaBridge	146:22da6e220af6	6794	f01 = pData[index + 1];
AnnaBridge	146:22da6e220af6	6795
AnnaBridge	146:22da6e220af6	6796	/* Calculation of index for two nearest points in Y-direction */
AnnaBridge	146:22da6e220af6	6797	index = (xIndex - 1) + (yIndex) * S->numCols;
AnnaBridge	146:22da6e220af6	6798
AnnaBridge	146:22da6e220af6	6799
AnnaBridge	146:22da6e220af6	6800	/* Read two nearest points in Y-direction */
AnnaBridge	146:22da6e220af6	6801	f10 = pData[index];
AnnaBridge	146:22da6e220af6	6802	f11 = pData[index + 1];
AnnaBridge	146:22da6e220af6	6803
AnnaBridge	146:22da6e220af6	6804	/* Calculation of intermediate values */
AnnaBridge	146:22da6e220af6	6805	b1 = f00;
AnnaBridge	146:22da6e220af6	6806	b2 = f01 - f00;
AnnaBridge	146:22da6e220af6	6807	b3 = f10 - f00;
AnnaBridge	146:22da6e220af6	6808	b4 = f00 - f01 - f10 + f11;
AnnaBridge	146:22da6e220af6	6809
AnnaBridge	146:22da6e220af6	6810	/* Calculation of fractional part in X */
AnnaBridge	146:22da6e220af6	6811	xdiff = X - xIndex;
AnnaBridge	146:22da6e220af6	6812
AnnaBridge	146:22da6e220af6	6813	/* Calculation of fractional part in Y */
AnnaBridge	146:22da6e220af6	6814	ydiff = Y - yIndex;
AnnaBridge	146:22da6e220af6	6815
AnnaBridge	146:22da6e220af6	6816	/* Calculation of bi-linear interpolated output */
AnnaBridge	146:22da6e220af6	6817	out = b1 + b2 * xdiff + b3 * ydiff + b4 * xdiff * ydiff;
AnnaBridge	146:22da6e220af6	6818
AnnaBridge	146:22da6e220af6	6819	/* return to application */
AnnaBridge	146:22da6e220af6	6820	return (out);
AnnaBridge	146:22da6e220af6	6821	}
AnnaBridge	146:22da6e220af6	6822
AnnaBridge	146:22da6e220af6	6823
AnnaBridge	146:22da6e220af6	6824	/**
AnnaBridge	146:22da6e220af6	6825	*
AnnaBridge	146:22da6e220af6	6826	* @brief Q31 bilinear interpolation.
AnnaBridge	146:22da6e220af6	6827	* @param[in,out] S points to an instance of the interpolation structure.
AnnaBridge	146:22da6e220af6	6828	* @param[in] X interpolation coordinate in 12.20 format.
AnnaBridge	146:22da6e220af6	6829	* @param[in] Y interpolation coordinate in 12.20 format.
AnnaBridge	146:22da6e220af6	6830	* @return out interpolated value.
AnnaBridge	146:22da6e220af6	6831	*/
AnnaBridge	146:22da6e220af6	6832	CMSIS_INLINE __STATIC_INLINE q31_t arm_bilinear_interp_q31(
AnnaBridge	146:22da6e220af6	6833	arm_bilinear_interp_instance_q31 * S,
AnnaBridge	146:22da6e220af6	6834	q31_t X,
AnnaBridge	146:22da6e220af6	6835	q31_t Y)
AnnaBridge	146:22da6e220af6	6836	{
AnnaBridge	146:22da6e220af6	6837	q31_t out; /* Temporary output */
AnnaBridge	146:22da6e220af6	6838	q31_t acc = 0; /* output */
AnnaBridge	146:22da6e220af6	6839	q31_t xfract, yfract; /* X, Y fractional parts */
AnnaBridge	146:22da6e220af6	6840	q31_t x1, x2, y1, y2; /* Nearest output values */
AnnaBridge	146:22da6e220af6	6841	int32_t rI, cI; /* Row and column indices */
AnnaBridge	146:22da6e220af6	6842	q31_t pYData = S->pData; / pointer to output table values */
AnnaBridge	146:22da6e220af6	6843	uint32_t nCols = S->numCols; /* num of rows */
AnnaBridge	146:22da6e220af6	6844
AnnaBridge	146:22da6e220af6	6845	/* Input is in 12.20 format */
AnnaBridge	146:22da6e220af6	6846	/* 12 bits for the table index */
AnnaBridge	146:22da6e220af6	6847	/* Index value calculation */
AnnaBridge	146:22da6e220af6	6848	rI = ((X & (q31_t)0xFFF00000) >> 20);
AnnaBridge	146:22da6e220af6	6849
AnnaBridge	146:22da6e220af6	6850	/* Input is in 12.20 format */
AnnaBridge	146:22da6e220af6	6851	/* 12 bits for the table index */
AnnaBridge	146:22da6e220af6	6852	/* Index value calculation */
AnnaBridge	146:22da6e220af6	6853	cI = ((Y & (q31_t)0xFFF00000) >> 20);
AnnaBridge	146:22da6e220af6	6854
AnnaBridge	146:22da6e220af6	6855	/* Care taken for table outside boundary */
AnnaBridge	146:22da6e220af6	6856	/* Returns zero output when values are outside table boundary */
AnnaBridge	146:22da6e220af6	6857	if (rI < 0 \|\| rI > (S->numRows - 1) \|\| cI < 0 \|\| cI > (S->numCols - 1))
AnnaBridge	146:22da6e220af6	6858	{
AnnaBridge	146:22da6e220af6	6859	return (0);
AnnaBridge	146:22da6e220af6	6860	}
AnnaBridge	146:22da6e220af6	6861
AnnaBridge	146:22da6e220af6	6862	/* 20 bits for the fractional part */
AnnaBridge	146:22da6e220af6	6863	/* shift left xfract by 11 to keep 1.31 format */
AnnaBridge	146:22da6e220af6	6864	xfract = (X & 0x000FFFFF) << 11u;
AnnaBridge	146:22da6e220af6	6865
AnnaBridge	146:22da6e220af6	6866	/* Read two nearest output values from the index */
AnnaBridge	146:22da6e220af6	6867	x1 = pYData[(rI) + (int32_t)nCols * (cI) ];
AnnaBridge	146:22da6e220af6	6868	x2 = pYData[(rI) + (int32_t)nCols * (cI) + 1];
AnnaBridge	146:22da6e220af6	6869
AnnaBridge	146:22da6e220af6	6870	/* 20 bits for the fractional part */
AnnaBridge	146:22da6e220af6	6871	/* shift left yfract by 11 to keep 1.31 format */
AnnaBridge	146:22da6e220af6	6872	yfract = (Y & 0x000FFFFF) << 11u;
AnnaBridge	146:22da6e220af6	6873
AnnaBridge	146:22da6e220af6	6874	/* Read two nearest output values from the index */
AnnaBridge	146:22da6e220af6	6875	y1 = pYData[(rI) + (int32_t)nCols * (cI + 1) ];
AnnaBridge	146:22da6e220af6	6876	y2 = pYData[(rI) + (int32_t)nCols * (cI + 1) + 1];
AnnaBridge	146:22da6e220af6	6877
AnnaBridge	146:22da6e220af6	6878	/* Calculation of x1 * (1-xfract ) * (1-yfract) and acc is in 3.29(q29) format */
AnnaBridge	146:22da6e220af6	6879	out = ((q31_t) (((q63_t) x1 * (0x7FFFFFFF - xfract)) >> 32));
AnnaBridge	146:22da6e220af6	6880	acc = ((q31_t) (((q63_t) out * (0x7FFFFFFF - yfract)) >> 32));
AnnaBridge	146:22da6e220af6	6881
AnnaBridge	146:22da6e220af6	6882	/* x2 * (xfract) * (1-yfract) in 3.29(q29) and adding to acc */
AnnaBridge	146:22da6e220af6	6883	out = ((q31_t) ((q63_t) x2 * (0x7FFFFFFF - yfract) >> 32));
AnnaBridge	146:22da6e220af6	6884	acc += ((q31_t) ((q63_t) out * (xfract) >> 32));
AnnaBridge	146:22da6e220af6	6885
AnnaBridge	146:22da6e220af6	6886	/* y1 * (1 - xfract) * (yfract) in 3.29(q29) and adding to acc */
AnnaBridge	146:22da6e220af6	6887	out = ((q31_t) ((q63_t) y1 * (0x7FFFFFFF - xfract) >> 32));
AnnaBridge	146:22da6e220af6	6888	acc += ((q31_t) ((q63_t) out * (yfract) >> 32));
AnnaBridge	146:22da6e220af6	6889
AnnaBridge	146:22da6e220af6	6890	/* y2 * (xfract) * (yfract) in 3.29(q29) and adding to acc */
AnnaBridge	146:22da6e220af6	6891	out = ((q31_t) ((q63_t) y2 * (xfract) >> 32));
AnnaBridge	146:22da6e220af6	6892	acc += ((q31_t) ((q63_t) out * (yfract) >> 32));
AnnaBridge	146:22da6e220af6	6893
AnnaBridge	146:22da6e220af6	6894	/* Convert acc to 1.31(q31) format */
AnnaBridge	146:22da6e220af6	6895	return ((q31_t)(acc << 2));
AnnaBridge	146:22da6e220af6	6896	}
AnnaBridge	146:22da6e220af6	6897
AnnaBridge	146:22da6e220af6	6898
AnnaBridge	146:22da6e220af6	6899	/**
AnnaBridge	146:22da6e220af6	6900	* @brief Q15 bilinear interpolation.
AnnaBridge	146:22da6e220af6	6901	* @param[in,out] S points to an instance of the interpolation structure.
AnnaBridge	146:22da6e220af6	6902	* @param[in] X interpolation coordinate in 12.20 format.
AnnaBridge	146:22da6e220af6	6903	* @param[in] Y interpolation coordinate in 12.20 format.
AnnaBridge	146:22da6e220af6	6904	* @return out interpolated value.
AnnaBridge	146:22da6e220af6	6905	*/
AnnaBridge	146:22da6e220af6	6906	CMSIS_INLINE __STATIC_INLINE q15_t arm_bilinear_interp_q15(
AnnaBridge	146:22da6e220af6	6907	arm_bilinear_interp_instance_q15 * S,
AnnaBridge	146:22da6e220af6	6908	q31_t X,
AnnaBridge	146:22da6e220af6	6909	q31_t Y)
AnnaBridge	146:22da6e220af6	6910	{
AnnaBridge	146:22da6e220af6	6911	q63_t acc = 0; /* output */
AnnaBridge	146:22da6e220af6	6912	q31_t out; /* Temporary output */
AnnaBridge	146:22da6e220af6	6913	q15_t x1, x2, y1, y2; /* Nearest output values */
AnnaBridge	146:22da6e220af6	6914	q31_t xfract, yfract; /* X, Y fractional parts */
AnnaBridge	146:22da6e220af6	6915	int32_t rI, cI; /* Row and column indices */
AnnaBridge	146:22da6e220af6	6916	q15_t pYData = S->pData; / pointer to output table values */
AnnaBridge	146:22da6e220af6	6917	uint32_t nCols = S->numCols; /* num of rows */
AnnaBridge	146:22da6e220af6	6918
AnnaBridge	146:22da6e220af6	6919	/* Input is in 12.20 format */
AnnaBridge	146:22da6e220af6	6920	/* 12 bits for the table index */
AnnaBridge	146:22da6e220af6	6921	/* Index value calculation */
AnnaBridge	146:22da6e220af6	6922	rI = ((X & (q31_t)0xFFF00000) >> 20);
AnnaBridge	146:22da6e220af6	6923
AnnaBridge	146:22da6e220af6	6924	/* Input is in 12.20 format */
AnnaBridge	146:22da6e220af6	6925	/* 12 bits for the table index */
AnnaBridge	146:22da6e220af6	6926	/* Index value calculation */
AnnaBridge	146:22da6e220af6	6927	cI = ((Y & (q31_t)0xFFF00000) >> 20);
AnnaBridge	146:22da6e220af6	6928
AnnaBridge	146:22da6e220af6	6929	/* Care taken for table outside boundary */
AnnaBridge	146:22da6e220af6	6930	/* Returns zero output when values are outside table boundary */
AnnaBridge	146:22da6e220af6	6931	if (rI < 0 \|\| rI > (S->numRows - 1) \|\| cI < 0 \|\| cI > (S->numCols - 1))
AnnaBridge	146:22da6e220af6	6932	{
AnnaBridge	146:22da6e220af6	6933	return (0);
AnnaBridge	146:22da6e220af6	6934	}
AnnaBridge	146:22da6e220af6	6935
AnnaBridge	146:22da6e220af6	6936	/* 20 bits for the fractional part */
AnnaBridge	146:22da6e220af6	6937	/* xfract should be in 12.20 format */
AnnaBridge	146:22da6e220af6	6938	xfract = (X & 0x000FFFFF);
AnnaBridge	146:22da6e220af6	6939
AnnaBridge	146:22da6e220af6	6940	/* Read two nearest output values from the index */
AnnaBridge	146:22da6e220af6	6941	x1 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI) ];
AnnaBridge	146:22da6e220af6	6942	x2 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI) + 1];
AnnaBridge	146:22da6e220af6	6943
AnnaBridge	146:22da6e220af6	6944	/* 20 bits for the fractional part */
AnnaBridge	146:22da6e220af6	6945	/* yfract should be in 12.20 format */
AnnaBridge	146:22da6e220af6	6946	yfract = (Y & 0x000FFFFF);
AnnaBridge	146:22da6e220af6	6947
AnnaBridge	146:22da6e220af6	6948	/* Read two nearest output values from the index */
AnnaBridge	146:22da6e220af6	6949	y1 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI + 1) ];
AnnaBridge	146:22da6e220af6	6950	y2 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI + 1) + 1];
AnnaBridge	146:22da6e220af6	6951
AnnaBridge	146:22da6e220af6	6952	/* Calculation of x1 * (1-xfract ) * (1-yfract) and acc is in 13.51 format */
AnnaBridge	146:22da6e220af6	6953
AnnaBridge	146:22da6e220af6	6954	/* x1 is in 1.15(q15), xfract in 12.20 format and out is in 13.35 format */
AnnaBridge	146:22da6e220af6	6955	/* convert 13.35 to 13.31 by right shifting and out is in 1.31 */
AnnaBridge	146:22da6e220af6	6956	out = (q31_t) (((q63_t) x1 * (0xFFFFF - xfract)) >> 4u);
AnnaBridge	146:22da6e220af6	6957	acc = ((q63_t) out * (0xFFFFF - yfract));
AnnaBridge	146:22da6e220af6	6958
AnnaBridge	146:22da6e220af6	6959	/* x2 * (xfract) * (1-yfract) in 1.51 and adding to acc */
AnnaBridge	146:22da6e220af6	6960	out = (q31_t) (((q63_t) x2 * (0xFFFFF - yfract)) >> 4u);
AnnaBridge	146:22da6e220af6	6961	acc += ((q63_t) out * (xfract));
AnnaBridge	146:22da6e220af6	6962
AnnaBridge	146:22da6e220af6	6963	/* y1 * (1 - xfract) * (yfract) in 1.51 and adding to acc */
AnnaBridge	146:22da6e220af6	6964	out = (q31_t) (((q63_t) y1 * (0xFFFFF - xfract)) >> 4u);
AnnaBridge	146:22da6e220af6	6965	acc += ((q63_t) out * (yfract));
AnnaBridge	146:22da6e220af6	6966
AnnaBridge	146:22da6e220af6	6967	/* y2 * (xfract) * (yfract) in 1.51 and adding to acc */
AnnaBridge	146:22da6e220af6	6968	out = (q31_t) (((q63_t) y2 * (xfract)) >> 4u);
AnnaBridge	146:22da6e220af6	6969	acc += ((q63_t) out * (yfract));
AnnaBridge	146:22da6e220af6	6970
AnnaBridge	146:22da6e220af6	6971	/* acc is in 13.51 format and down shift acc by 36 times */
AnnaBridge	146:22da6e220af6	6972	/* Convert out to 1.15 format */
AnnaBridge	146:22da6e220af6	6973	return ((q15_t)(acc >> 36));
AnnaBridge	146:22da6e220af6	6974	}
AnnaBridge	146:22da6e220af6	6975
AnnaBridge	146:22da6e220af6	6976
AnnaBridge	146:22da6e220af6	6977	/**
AnnaBridge	146:22da6e220af6	6978	* @brief Q7 bilinear interpolation.
AnnaBridge	146:22da6e220af6	6979	* @param[in,out] S points to an instance of the interpolation structure.
AnnaBridge	146:22da6e220af6	6980	* @param[in] X interpolation coordinate in 12.20 format.
AnnaBridge	146:22da6e220af6	6981	* @param[in] Y interpolation coordinate in 12.20 format.
AnnaBridge	146:22da6e220af6	6982	* @return out interpolated value.
AnnaBridge	146:22da6e220af6	6983	*/
AnnaBridge	146:22da6e220af6	6984	CMSIS_INLINE __STATIC_INLINE q7_t arm_bilinear_interp_q7(
AnnaBridge	146:22da6e220af6	6985	arm_bilinear_interp_instance_q7 * S,
AnnaBridge	146:22da6e220af6	6986	q31_t X,
AnnaBridge	146:22da6e220af6	6987	q31_t Y)
AnnaBridge	146:22da6e220af6	6988	{
AnnaBridge	146:22da6e220af6	6989	q63_t acc = 0; /* output */
AnnaBridge	146:22da6e220af6	6990	q31_t out; /* Temporary output */
AnnaBridge	146:22da6e220af6	6991	q31_t xfract, yfract; /* X, Y fractional parts */
AnnaBridge	146:22da6e220af6	6992	q7_t x1, x2, y1, y2; /* Nearest output values */
AnnaBridge	146:22da6e220af6	6993	int32_t rI, cI; /* Row and column indices */
AnnaBridge	146:22da6e220af6	6994	q7_t pYData = S->pData; / pointer to output table values */
AnnaBridge	146:22da6e220af6	6995	uint32_t nCols = S->numCols; /* num of rows */
AnnaBridge	146:22da6e220af6	6996
AnnaBridge	146:22da6e220af6	6997	/* Input is in 12.20 format */
AnnaBridge	146:22da6e220af6	6998	/* 12 bits for the table index */
AnnaBridge	146:22da6e220af6	6999	/* Index value calculation */
AnnaBridge	146:22da6e220af6	7000	rI = ((X & (q31_t)0xFFF00000) >> 20);
AnnaBridge	146:22da6e220af6	7001
AnnaBridge	146:22da6e220af6	7002	/* Input is in 12.20 format */
AnnaBridge	146:22da6e220af6	7003	/* 12 bits for the table index */
AnnaBridge	146:22da6e220af6	7004	/* Index value calculation */
AnnaBridge	146:22da6e220af6	7005	cI = ((Y & (q31_t)0xFFF00000) >> 20);
AnnaBridge	146:22da6e220af6	7006
AnnaBridge	146:22da6e220af6	7007	/* Care taken for table outside boundary */
AnnaBridge	146:22da6e220af6	7008	/* Returns zero output when values are outside table boundary */
AnnaBridge	146:22da6e220af6	7009	if (rI < 0 \|\| rI > (S->numRows - 1) \|\| cI < 0 \|\| cI > (S->numCols - 1))
AnnaBridge	146:22da6e220af6	7010	{
AnnaBridge	146:22da6e220af6	7011	return (0);
AnnaBridge	146:22da6e220af6	7012	}
AnnaBridge	146:22da6e220af6	7013
AnnaBridge	146:22da6e220af6	7014	/* 20 bits for the fractional part */
AnnaBridge	146:22da6e220af6	7015	/* xfract should be in 12.20 format */
AnnaBridge	146:22da6e220af6	7016	xfract = (X & (q31_t)0x000FFFFF);
AnnaBridge	146:22da6e220af6	7017
AnnaBridge	146:22da6e220af6	7018	/* Read two nearest output values from the index */
AnnaBridge	146:22da6e220af6	7019	x1 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI) ];
AnnaBridge	146:22da6e220af6	7020	x2 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI) + 1];
AnnaBridge	146:22da6e220af6	7021
AnnaBridge	146:22da6e220af6	7022	/* 20 bits for the fractional part */
AnnaBridge	146:22da6e220af6	7023	/* yfract should be in 12.20 format */
AnnaBridge	146:22da6e220af6	7024	yfract = (Y & (q31_t)0x000FFFFF);
AnnaBridge	146:22da6e220af6	7025
AnnaBridge	146:22da6e220af6	7026	/* Read two nearest output values from the index */
AnnaBridge	146:22da6e220af6	7027	y1 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI + 1) ];
AnnaBridge	146:22da6e220af6	7028	y2 = pYData[((uint32_t)rI) + nCols * ((uint32_t)cI + 1) + 1];
AnnaBridge	146:22da6e220af6	7029
AnnaBridge	146:22da6e220af6	7030	/* Calculation of x1 * (1-xfract ) * (1-yfract) and acc is in 16.47 format */
AnnaBridge	146:22da6e220af6	7031	out = ((x1 * (0xFFFFF - xfract)));
AnnaBridge	146:22da6e220af6	7032	acc = (((q63_t) out * (0xFFFFF - yfract)));
AnnaBridge	146:22da6e220af6	7033
AnnaBridge	146:22da6e220af6	7034	/* x2 * (xfract) * (1-yfract) in 2.22 and adding to acc */
AnnaBridge	146:22da6e220af6	7035	out = ((x2 * (0xFFFFF - yfract)));
AnnaBridge	146:22da6e220af6	7036	acc += (((q63_t) out * (xfract)));
AnnaBridge	146:22da6e220af6	7037
AnnaBridge	146:22da6e220af6	7038	/* y1 * (1 - xfract) * (yfract) in 2.22 and adding to acc */
AnnaBridge	146:22da6e220af6	7039	out = ((y1 * (0xFFFFF - xfract)));
AnnaBridge	146:22da6e220af6	7040	acc += (((q63_t) out * (yfract)));
AnnaBridge	146:22da6e220af6	7041
AnnaBridge	146:22da6e220af6	7042	/* y2 * (xfract) * (yfract) in 2.22 and adding to acc */
AnnaBridge	146:22da6e220af6	7043	out = ((y2 * (yfract)));
AnnaBridge	146:22da6e220af6	7044	acc += (((q63_t) out * (xfract)));
AnnaBridge	146:22da6e220af6	7045
AnnaBridge	146:22da6e220af6	7046	/* acc in 16.47 format and down shift by 40 to convert to 1.7 format */
AnnaBridge	146:22da6e220af6	7047	return ((q7_t)(acc >> 40));
AnnaBridge	146:22da6e220af6	7048	}
AnnaBridge	146:22da6e220af6	7049
AnnaBridge	146:22da6e220af6	7050	/**
AnnaBridge	146:22da6e220af6	7051	* @} end of BilinearInterpolate group
AnnaBridge	146:22da6e220af6	7052	*/
AnnaBridge	146:22da6e220af6	7053
AnnaBridge	146:22da6e220af6	7054
AnnaBridge	146:22da6e220af6	7055	/* SMMLAR */
AnnaBridge	146:22da6e220af6	7056	#define multAcc_32x32_keep32_R(a, x, y) \
AnnaBridge	146:22da6e220af6	7057	a = (q31_t) (((((q63_t) a) << 32) + ((q63_t) x * y) + 0x80000000LL ) >> 32)
AnnaBridge	146:22da6e220af6	7058
AnnaBridge	146:22da6e220af6	7059	/* SMMLSR */
AnnaBridge	146:22da6e220af6	7060	#define multSub_32x32_keep32_R(a, x, y) \
AnnaBridge	146:22da6e220af6	7061	a = (q31_t) (((((q63_t) a) << 32) - ((q63_t) x * y) + 0x80000000LL ) >> 32)
AnnaBridge	146:22da6e220af6	7062
AnnaBridge	146:22da6e220af6	7063	/* SMMULR */
AnnaBridge	146:22da6e220af6	7064	#define mult_32x32_keep32_R(a, x, y) \
AnnaBridge	146:22da6e220af6	7065	a = (q31_t) (((q63_t) x * y + 0x80000000LL ) >> 32)
AnnaBridge	146:22da6e220af6	7066
AnnaBridge	146:22da6e220af6	7067	/* SMMLA */
AnnaBridge	146:22da6e220af6	7068	#define multAcc_32x32_keep32(a, x, y) \
AnnaBridge	146:22da6e220af6	7069	a += (q31_t) (((q63_t) x * y) >> 32)
AnnaBridge	146:22da6e220af6	7070
AnnaBridge	146:22da6e220af6	7071	/* SMMLS */
AnnaBridge	146:22da6e220af6	7072	#define multSub_32x32_keep32(a, x, y) \
AnnaBridge	146:22da6e220af6	7073	a -= (q31_t) (((q63_t) x * y) >> 32)
AnnaBridge	146:22da6e220af6	7074
AnnaBridge	146:22da6e220af6	7075	/* SMMUL */
AnnaBridge	146:22da6e220af6	7076	#define mult_32x32_keep32(a, x, y) \
AnnaBridge	146:22da6e220af6	7077	a = (q31_t) (((q63_t) x * y ) >> 32)
AnnaBridge	146:22da6e220af6	7078
AnnaBridge	146:22da6e220af6	7079
AnnaBridge	146:22da6e220af6	7080	#if defined ( __CC_ARM )
AnnaBridge	146:22da6e220af6	7081	/* Enter low optimization region - place directly above function definition */
AnnaBridge	146:22da6e220af6	7082	#if defined( ARM_MATH_CM4 ) \|\| defined( ARM_MATH_CM7)
AnnaBridge	146:22da6e220af6	7083	#define LOW_OPTIMIZATION_ENTER \
AnnaBridge	146:22da6e220af6	7084	_Pragma ("push") \
AnnaBridge	146:22da6e220af6	7085	_Pragma ("O1")
AnnaBridge	146:22da6e220af6	7086	#else
AnnaBridge	146:22da6e220af6	7087	#define LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7088	#endif
AnnaBridge	146:22da6e220af6	7089
AnnaBridge	146:22da6e220af6	7090	/* Exit low optimization region - place directly after end of function definition */
AnnaBridge	146:22da6e220af6	7091	#if defined ( ARM_MATH_CM4 ) \|\| defined ( ARM_MATH_CM7 )
AnnaBridge	146:22da6e220af6	7092	#define LOW_OPTIMIZATION_EXIT \
AnnaBridge	146:22da6e220af6	7093	_Pragma ("pop")
AnnaBridge	146:22da6e220af6	7094	#else
AnnaBridge	146:22da6e220af6	7095	#define LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7096	#endif
AnnaBridge	146:22da6e220af6	7097
AnnaBridge	146:22da6e220af6	7098	/* Enter low optimization region - place directly above function definition */
AnnaBridge	146:22da6e220af6	7099	#define IAR_ONLY_LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7100
AnnaBridge	146:22da6e220af6	7101	/* Exit low optimization region - place directly after end of function definition */
AnnaBridge	146:22da6e220af6	7102	#define IAR_ONLY_LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7103
AnnaBridge	146:22da6e220af6	7104	#elif defined (__ARMCC_VERSION ) && ( __ARMCC_VERSION >= 6010050 )
AnnaBridge	146:22da6e220af6	7105	#define LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7106	#define LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7107	#define IAR_ONLY_LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7108	#define IAR_ONLY_LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7109
AnnaBridge	146:22da6e220af6	7110	#elif defined ( __GNUC__ )
AnnaBridge	146:22da6e220af6	7111	#define LOW_OPTIMIZATION_ENTER \
AnnaBridge	146:22da6e220af6	7112	__attribute__(( optimize("-O1") ))
AnnaBridge	146:22da6e220af6	7113	#define LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7114	#define IAR_ONLY_LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7115	#define IAR_ONLY_LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7116
AnnaBridge	146:22da6e220af6	7117	#elif defined ( __ICCARM__ )
AnnaBridge	146:22da6e220af6	7118	/* Enter low optimization region - place directly above function definition */
AnnaBridge	146:22da6e220af6	7119	#if defined ( ARM_MATH_CM4 ) \|\| defined ( ARM_MATH_CM7 )
AnnaBridge	146:22da6e220af6	7120	#define LOW_OPTIMIZATION_ENTER \
AnnaBridge	146:22da6e220af6	7121	_Pragma ("optimize=low")
AnnaBridge	146:22da6e220af6	7122	#else
AnnaBridge	146:22da6e220af6	7123	#define LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7124	#endif
AnnaBridge	146:22da6e220af6	7125
AnnaBridge	146:22da6e220af6	7126	/* Exit low optimization region - place directly after end of function definition */
AnnaBridge	146:22da6e220af6	7127	#define LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7128
AnnaBridge	146:22da6e220af6	7129	/* Enter low optimization region - place directly above function definition */
AnnaBridge	146:22da6e220af6	7130	#if defined ( ARM_MATH_CM4 ) \|\| defined ( ARM_MATH_CM7 )
AnnaBridge	146:22da6e220af6	7131	#define IAR_ONLY_LOW_OPTIMIZATION_ENTER \
AnnaBridge	146:22da6e220af6	7132	_Pragma ("optimize=low")
AnnaBridge	146:22da6e220af6	7133	#else
AnnaBridge	146:22da6e220af6	7134	#define IAR_ONLY_LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7135	#endif
AnnaBridge	146:22da6e220af6	7136
AnnaBridge	146:22da6e220af6	7137	/* Exit low optimization region - place directly after end of function definition */
AnnaBridge	146:22da6e220af6	7138	#define IAR_ONLY_LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7139
AnnaBridge	146:22da6e220af6	7140	#elif defined ( __TI_ARM__ )
AnnaBridge	146:22da6e220af6	7141	#define LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7142	#define LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7143	#define IAR_ONLY_LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7144	#define IAR_ONLY_LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7145
AnnaBridge	146:22da6e220af6	7146	#elif defined ( __CSMC__ )
AnnaBridge	146:22da6e220af6	7147	#define LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7148	#define LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7149	#define IAR_ONLY_LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7150	#define IAR_ONLY_LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7151
AnnaBridge	146:22da6e220af6	7152	#elif defined ( __TASKING__ )
AnnaBridge	146:22da6e220af6	7153	#define LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7154	#define LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7155	#define IAR_ONLY_LOW_OPTIMIZATION_ENTER
AnnaBridge	146:22da6e220af6	7156	#define IAR_ONLY_LOW_OPTIMIZATION_EXIT
AnnaBridge	146:22da6e220af6	7157
AnnaBridge	146:22da6e220af6	7158	#endif
AnnaBridge	146:22da6e220af6	7159
AnnaBridge	146:22da6e220af6	7160
AnnaBridge	146:22da6e220af6	7161	#ifdef __cplusplus
AnnaBridge	146:22da6e220af6	7162	}
AnnaBridge	146:22da6e220af6	7163	#endif
AnnaBridge	146:22da6e220af6	7164
AnnaBridge	146:22da6e220af6	7165	/* Compiler specific diagnostic adjustment */
AnnaBridge	146:22da6e220af6	7166	#if defined ( __CC_ARM )
AnnaBridge	146:22da6e220af6	7167
AnnaBridge	146:22da6e220af6	7168	#elif defined ( __ARMCC_VERSION ) && ( __ARMCC_VERSION >= 6010050 )
AnnaBridge	146:22da6e220af6	7169
AnnaBridge	146:22da6e220af6	7170	#elif defined ( __GNUC__ )
AnnaBridge	146:22da6e220af6	7171	#pragma GCC diagnostic pop
AnnaBridge	146:22da6e220af6	7172
AnnaBridge	146:22da6e220af6	7173	#elif defined ( __ICCARM__ )
AnnaBridge	146:22da6e220af6	7174
AnnaBridge	146:22da6e220af6	7175	#elif defined ( __TI_ARM__ )
AnnaBridge	146:22da6e220af6	7176
AnnaBridge	146:22da6e220af6	7177	#elif defined ( __CSMC__ )
AnnaBridge	146:22da6e220af6	7178
AnnaBridge	146:22da6e220af6	7179	#elif defined ( __TASKING__ )
AnnaBridge	146:22da6e220af6	7180
AnnaBridge	146:22da6e220af6	7181	#else
AnnaBridge	146:22da6e220af6	7182	#error Unknown compiler
AnnaBridge	146:22da6e220af6	7183	#endif
AnnaBridge	146:22da6e220af6	7184
AnnaBridge	146:22da6e220af6	7185	#endif /* _ARM_MATH_H */
AnnaBridge	146:22da6e220af6	7186
AnnaBridge	146:22da6e220af6	7187	/**
AnnaBridge	146:22da6e220af6	7188	*
AnnaBridge	146:22da6e220af6	7189	* End of file.
AnnaBridge	146:22da6e220af6	7190	*/