add some code

managed_components/espressif__esp-dsp/modules/support/include/dsps_cplx_gen.h

@@ -0,0 +1,187 @@
+/*
+ * SPDX-FileCopyrightText: 2023 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef _dsps_cplx_gen_H_
+#define _dsps_cplx_gen_H_
+
+#include "dsp_err.h"
+#include "dsps_cplx_gen_platform.h"
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+
+/**
+ * @brief Ennum defining output data type of the complex generator
+ *
+ */
+typedef enum output_data_type {
+    S16_FIXED = 0,              /*!< Q15 fixed point - int16_t*/
+    F32_FLOAT = 1,              /*!< Single precision floating point - float*/
+} out_d_type;
+
+
+/**
+ * @brief Data struct of the complex signal generator
+ *
+ * This structure is used by a complex generator internally. A user should access this structure only in case of
+ * extensions for the DSP Library.
+ * All the fields of this structure are initialized by the dsps_cplx_gen_init(...) function.
+ */
+typedef struct cplx_sig_s {
+    void       *lut;            /*!< Pointer to the lookup table.*/
+    int32_t     lut_len;        /*!< Length of the lookup table.*/
+    float       freq;           /*!< Frequency of the output signal. Nyquist frequency -1 ... 1*/
+    float       phase;          /*!< Phase (initial_phase during init)*/
+    out_d_type  d_type;         /*!< Output data type*/
+    int16_t     free_status;    /*!< Indicator for cplx_gen_free(...) function*/
+} cplx_sig_t;
+
+
+/**
+ * @brief Initialize strucure for complex generator
+ *
+ * Function initializes a structure for either 16-bit fixed point, or 32-bit floating point complex generator using LUT table.
+ * cplx_gen_free(...) must be called, once the generator is not needed anymore to free dynamically allocated memory
+ *
+ * A user can specify his own LUT table and pass a pointer to the table (void *lut) during the initialization. If the LUT table
+ * pointer passed to the init function is a NULL, the LUT table is initialized internally.
+ *
+ * @param cplx_gen: pointer to the floating point generator structure
+ * @param d_type: output data type - out_d_type enum
+ * @param lut: pointer to a user-defined LUT, the data type is void so both (S16_FIXED, F32_FLOAT) types could be used
+ * @param lut_len: length of the LUT
+ * @param freq: Frequency of the output signal in a range of [-1...1], where 1 is a Nyquist frequency
+ * @param initial_phase: initial phase of the complex signal in range of [-1..1] where 1 is related to 2Pi and -1 is related to -2Pi
+ *
+ * @return
+ *      - ESP_OK on success
+ *      - One of the error codes from DSP library
+ */
+esp_err_t dsps_cplx_gen_init(cplx_sig_t *cplx_gen, out_d_type d_type, void *lut, int32_t lut_len, float freq, float initial_phase);
+
+
+/**
+ * @brief function sets the output frequency of the complex generator
+ *
+ * set function can be used after the cplx_gen structure was initialized by the dsps_cplx_gen_init(...) function
+ *
+ * @param cplx_gen: pointer to the complex signal generator structure
+ * @param freq: new frequency to be set in a range of [-1..1] where 1 is a Nyquist frequency
+ *
+ * @return
+ *      - ESP_OK on success
+ *      - ESP_ERR_DSP_INVALID_PARAM if the frequency is out of the Nyquist frequency range
+ */
+esp_err_t dsps_cplx_gen_freq_set(cplx_sig_t *cplx_gen, float freq);
+
+
+/**
+ * @brief function gets the output frequency of the complex generator
+ *
+ * get function can be used after the cplx_gen structure was initialized by the dsps_cplx_gen_init(...) function
+ *
+ * @param cplx_gen: pointer to the complex signal generator structure
+ *
+ * @return function returns frequency of the signal generator
+ */
+float dsps_cplx_gen_freq_get(cplx_sig_t *cplx_gen);
+
+
+/**
+ * @brief function sets the phase of the complex generator
+ *
+ * set function can be used after the cplx_gen structure was initialized by the dsps_cplx_gen_init(...) function
+ *
+ * @param cplx_gen: pointer to the complex signal generator structure
+ * @param phase: new phase to be set in the range of [-1..1] where 1 is related to 2Pi and -1 is related to -2Pi
+ *
+ * @return
+ *      - ESP_OK on success
+ *      - ESP_ERR_DSP_INVALID_PARAM if the phase is out of -1 ... 1 range
+ */
+esp_err_t dsps_cplx_gen_phase_set(cplx_sig_t *cplx_gen, float phase);
+
+
+/**
+ * @brief function gets the phase of the complex generator
+ *
+ * get function can be used after the cplx_gen structure was initialized by the dsps_cplx_gen_init(...) function
+ *
+ * @param cplx_gen: pointer to the complex signal generator structure
+ *
+ * @return function returns phase of the signal generator
+ */
+float dsps_cplx_gen_phase_get(cplx_sig_t *cplx_gen);
+
+
+/**
+ * @brief function sets the output frequency and the phase of the complex generator
+ *
+ * set function can be used after the cplx_gen structure was initialized by the dsps_cplx_gen_init(...) function
+ *
+ * @param cplx_gen: pointer to the complex signal generator structure
+ * @param freq: new frequency to be set in the range of [-1..1] where 1 is a Nyquist frequency
+ * @param phase: new phase to be set in the range of [-1..1] where 1 is related to 2Pi and -1 is related to -2Pi
+ *
+ * @return
+ *      - ESP_OK on success
+ *      - ESP_ERR_DSP_INVALID_PARAM if the frequency is out of the Nyquist frequency range
+ *                                  if the phase is out of -1 ... 1 range
+ */
+esp_err_t dsps_cplx_gen_set(cplx_sig_t *cplx_gen, float freq, float phase);
+
+
+/**
+ * @brief function frees dynamically allocated memory, which was allocated in the init function
+ *
+ * free function must be called after the dsps_cplx_gen_init(...) is called, once the complex generator is not
+ * needed anymore
+ *
+ * @param cplx_gen: pointer to the complex signal generator structure
+ */
+void cplx_gen_free(cplx_sig_t *cplx_gen);
+
+
+/**
+ * @brief The function generates a complex signal
+ *
+ * the generated complex signal is in the form of two harmonics signals in either 16-bit signed fixed point
+ * or 32-bit floating point
+ *
+ * x[i]=   A*sin(step*i + ph/180*Pi)
+ * x[i+1]= B*cos(step*i + ph/180*Pi)
+ * where step = 2*Pi*frequency
+ *
+ * dsps_cplx_gen_ansi() - The implementation uses ANSI C and could be compiled and run on any platform
+ * dsps_cplx_gen_ae32() - Is targetted for Xtensa cores
+ *
+ * @param cplx_gen: pointer to the generator structure
+ * @param output: output array (length of len*2), data type is void so both (S16_FIXED, F32_FLOAT) types could be used
+ * @param len: length of the output signal
+ *
+ * @return
+ *      - ESP_OK on success
+ *      - One of the error codes from DSP library
+ */
+esp_err_t dsps_cplx_gen_ansi(cplx_sig_t *cplx_gen, void *output, int32_t len);
+esp_err_t dsps_cplx_gen_ae32(cplx_sig_t *cplx_gen, void *output, int32_t len);
+
+
+#ifdef __cplusplus
+}
+#endif
+
+
+#if (dsps_cplx_gen_ae32_enbled || dsps_cplx_gen_aes3_enbled)
+#define dsps_cplx_gen dsps_cplx_gen_ae32
+#else // CONFIG_DSP_OPTIMIZED
+#define dsps_cplx_gen dsps_cplx_gen_ansi
+#endif // CONFIG_DSP_OPTIMIZED
+
+#endif // _dsps_cplx_gen_H_

managed_components/espressif__esp-dsp/modules/support/include/dsps_cplx_gen_platform.h

@@ -0,0 +1,30 @@
+/*
+ * SPDX-FileCopyrightText: 2023 Espressif Systems (Shanghai) CO LTD
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef _dsps_cplx_gen_platform_H_
+#define _dsps_cplx_gen_platform_H_
+
+#include "sdkconfig.h"
+
+#ifdef __XTENSA__
+#include <xtensa/config/core-isa.h>
+#include <xtensa/config/core-matmap.h>
+
+
+#if ((XCHAL_HAVE_FP == 1) && (XCHAL_HAVE_LOOPS == 1))
+
+#if CONFIG_IDF_TARGET_ESP32S3
+#define dsps_cplx_gen_aes3_enbled  1
+#define dsps_cplx_gen_ae32_enbled  0
+
+#elif CONFIG_IDF_TARGET_ESP32
+#define dsps_cplx_gen_ae32_enbled  1
+#define dsps_cplx_gen_aes3_enbled  0
+
+#endif // CONFIG_IDF_TARGET_ESP32S3 CONFIG_IDF_TARGET_ESP32
+#endif //
+#endif // __XTENSA__
+#endif // _dsps_cplx_gen_platform_H_

managed_components/espressif__esp-dsp/modules/support/include/dsps_d_gen.h

@@ -0,0 +1,47 @@
+// Copyright 2018-2019 Espressif Systems (Shanghai) PTE LTD
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef _dsps_d_gen_H_
+#define _dsps_d_gen_H_
+#include "dsp_err.h"
+
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+/**
+ * @brief   delta function
+ *
+ * The function generate delta function.
+ * output[i]=0, if i=[0..N)
+ * output[i]=1, if i=pos, pos: [0..N-1)
+ * The implementation use ANSI C and could be compiled and run on any platform
+ *
+ * @param output: output array.
+ * @param len: length of the input signal
+ * @param pos: delta function position
+ *
+ * @return
+ *      - ESP_OK on success
+ *      - One of the error codes from DSP library
+ */
+esp_err_t dsps_d_gen_f32(float *output, int len, int pos);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // _dsps_d_gen_H_

managed_components/espressif__esp-dsp/modules/support/include/dsps_h_gen.h

@@ -0,0 +1,48 @@
+// Copyright 2018-2019 Espressif Systems (Shanghai) PTE LTD
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef _dsps_h_gen_H_
+#define _dsps_h_gen_H_
+#include "dsp_err.h"
+
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+/**
+ * @brief   Heviside function
+ *
+ * The Heviside function.
+ * output[i]=0, if i=[0..pos)
+ * output[i]=1, if i=[pos..N)
+ * The implementation use ANSI C and could be compiled and run on any platform
+ *
+ * @param output: output array.
+ * @param len: length of the input signal
+ * @param pos: heviside function position
+ *
+ * @return
+ *      - ESP_OK on success
+ *      - One of the error codes from DSP library
+ */
+
+esp_err_t dsps_h_gen_f32(float *output, int len, int pos);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // _dsps_h_gen_H_

managed_components/espressif__esp-dsp/modules/support/include/dsps_sfdr.h

@@ -0,0 +1,51 @@
+// Copyright 2018-2019 Espressif Systems (Shanghai) PTE LTD
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef _dsps_sfdr_H_
+#define _dsps_sfdr_H_
+
+
+#include "dsp_err.h"
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+/**
+ * @brief   SFDR
+ *
+ * The function calculates Spurious-Free Dynamic Range.
+ * The function makes FFT of the input, then search a spectrum maximum, and then compare
+ * maximum value with all others. Result calculated as minimum value.
+ * This function have to be used for debug and unit tests only. It's not optimized for real-time processing.
+ * The implementation use ANSI C and could be compiled and run on any platform
+ *
+ * @param[in] input: input array.
+ * @param len: length of the input signal
+ * @param use_dc: this parameter define will be DC value used for calculation or not.
+ *                0 - SNR will not include DC power
+ *                1 - SNR will include DC power
+ *
+ * @return
+ *      - SFDR in DB
+ */
+float dsps_sfdr_f32(const float *input, int32_t len, int8_t use_dc);
+float dsps_sfdr_fc32(const float *input, int32_t len);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // _dsps_sfdr_H_

managed_components/espressif__esp-dsp/modules/support/include/dsps_snr.h

@@ -0,0 +1,51 @@
+// Copyright 2018-2019 Espressif Systems (Shanghai) PTE LTD
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef _DSP_SNR_H_
+#define _DSP_SNR_H_
+
+#include "dsp_err.h"
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+/**
+ * @brief   SNR
+ *
+ * The function calculates signal to noise ration in case if signal is sine tone.
+ * The function makes FFT of the input, then search a spectrum maximum, and then calculated
+ * SNR as sum of all harmonics to the maximum value.
+ * This function have to be used for debug and unit tests only. It's not optimized for real-time processing.
+ * The implementation use ANSI C and could be compiled and run on any platform
+ *
+ * @param input: input array.
+ * @param len: length of the input signal
+ * @param use_dc: this parameter define will be DC value used for calculation or not.
+ *                0 - SNR will not include DC power
+ *                1 - SNR will include DC power
+ *
+ * @return
+ *      - SNR in dB
+ */
+float dsps_snr_f32(const float *input, int32_t len, uint8_t use_dc);
+float dsps_snr_fc32(const float *input, int32_t len);
+
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // _DSP_SNR_H_

managed_components/espressif__esp-dsp/modules/support/include/dsps_tone_gen.h

@@ -0,0 +1,48 @@
+// Copyright 2018-2019 Espressif Systems (Shanghai) PTE LTD
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef _dsps_tone_gen_H_
+#define _dsps_tone_gen_H_
+#include "dsp_err.h"
+
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+/**
+ * @brief   tone
+ *
+ * The function generate a tone signal.
+ * x[i]=A*sin(2*PI*i + ph/180*PI)
+ * The implementation use ANSI C and could be compiled and run on any platform
+ *
+ * @param output: output array.
+ * @param len: length of the input signal
+ * @param Ampl: amplitude
+ * @param freq: Naiquist frequency -1..1
+ * @param phase: phase in degree
+ *
+ * @return
+ *      - ESP_OK on success
+ *      - One of the error codes from DSP library
+ */
+esp_err_t dsps_tone_gen_f32(float *output, int len, float Ampl, float freq, float phase);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // _dsps_tone_gen_H_

managed_components/espressif__esp-dsp/modules/support/include/dsps_view.h

@@ -0,0 +1,64 @@
+// Copyright 2018-2019 Espressif Systems (Shanghai) PTE LTD
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+#ifndef _dsps_view_H_
+#define _dsps_view_H_
+
+#include "dsp_err.h"
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+/**@{*/
+/**
+ * @brief   plot view
+ *
+ * Generic view function.
+ * This function takes input samples and show then in console view as a plot.
+ * The main purpose to give and draft debug information to the DSP developer.
+ *
+ * @param[in] data: array with input samples.
+ * @param len: length of the input array
+ * @param width: plot width in symbols
+ * @param height: plot height in lines
+ * @param min: minimum value that will be limited by Axis Y.
+ * @param max: maximum value that will be limited by Axis Y.
+ * @param view_char: character to draw the plot calues ('.' or '|' etc)
+ *
+ */
+void dsps_view(const float *data, int32_t len, int width, int height, float min, float max, char view_char);
+void dsps_view_s16(const int16_t *data, int32_t len, int width, int height, float min, float max, char view_char);
+/**@}*/
+
+/**
+ * @brief   spectrum view
+ *
+ * The view function to show spectrum values  in 64x10 screen.
+ * The function based on dsps_view.
+ *
+ * @param[in] data: array with input samples.
+ * @param len: length of the input array
+ * @param min: minimum value that will be limited by Axis Y.
+ * @param max: maximum value that will be limited by Axis Y.
+ *
+ */
+void dsps_view_spectrum(const float *data, int32_t len, float min, float max);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // _dsps_view_H_