dsps_fir.h

Go to the documentation of this file.

/*
 * SPDX-FileCopyrightText: 2018-2025 Espressif Systems (Shanghai) CO LTD
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
 
#ifndef _dsps_fir_H_
#define _dsps_fir_H_
 
 
#include "dsp_err.h"
 
#include "dsps_fir_platform.h"
#include "dsp_common.h"
 
#ifdef __cplusplus
extern "C"
{
#endif

typedef struct fir_f32_s {
    float  *coeffs;     
    float  *delay;      
    int     N;          
    int     pos;        
    int     decim;      
    int16_t use_delay;  
    int     delay_size;   
    int     interp;     
    int     interp_pos; 
    int     start_pos;  
} fir_f32_t;

typedef struct fir_s16_s {
    int16_t    *coeffs;         
    int16_t    *delay;          
    int16_t     coeffs_len;     
    int16_t     pos;            
    int16_t     decim;          
    int16_t     d_pos;          
    int16_t     shift;          
    int32_t    *rounding_buff;  
    int32_t     rounding_val;   
    int16_t     free_status;    

    int16_t     delay_size;   
    int16_t     interp;     
    int16_t     interp_pos; 
    int16_t     start_pos;  
} fir_s16_t;

esp_err_t dsps_fir_init_f32(fir_f32_t *fir, float *coeffs, float *delay, int coeffs_len);

esp_err_t dsps_fird_init_f32(fir_f32_t *fir, float *coeffs, float *delay, int N, int decim);

esp_err_t dsps_fird_init_s16(fir_s16_t *fir, int16_t *coeffs, int16_t *delay, int16_t coeffs_len, int16_t decim, int16_t start_pos, int16_t shift);
 

esp_err_t dsps_fir_f32_ansi(fir_f32_t *fir, const float *input, float *output, int len);
esp_err_t dsps_fir_f32_ae32(fir_f32_t *fir, const float *input, float *output, int len);
esp_err_t dsps_fir_f32_aes3(fir_f32_t *fir, const float *input, float *output, int len);

int dsps_fird_f32_ansi(fir_f32_t *fir, const float *input, float *output, int len);
int dsps_fird_f32_ae32(fir_f32_t *fir, const float *input, float *output, int len);
int dsps_fird_f32_aes3(fir_f32_t *fir, const float *input, float *output, int len);
int dsps_fird_f32_arp4(fir_f32_t *fir, const float *input, float *output, int len);

int32_t dsps_fird_s16_ansi(fir_s16_t *fir, const int16_t *input, int16_t *output, int32_t len);
int32_t dsps_fird_s16_ae32(fir_s16_t *fir, const int16_t *input, int16_t *output, int32_t len);
int32_t dsps_fird_s16_aes3(fir_s16_t *fir, const int16_t *input, int16_t *output, int32_t len);
int32_t dsps_fird_s16_arp4(fir_s16_t *fir, const int16_t *input, int16_t *output, int32_t len);

esp_err_t dsps_firmr_init_f32(fir_f32_t *fir, float *coeffs, float *delay, int length, int interp, int decim, int start_pos );

esp_err_t dsps_firmr_init_s16(fir_s16_t *fir, int16_t *coeffs, int16_t *delay, int16_t length, int16_t interp, int16_t decim, int16_t start_pos, int16_t shift);

int dsps_firmr_f32_ansi(fir_f32_t *fir, const float *input, float *output, int input_len);

int32_t dsps_firmr_s16_ansi(fir_s16_t *fir, const int16_t *input, int16_t *output, int32_t input_len);
 

esp_err_t dsps_fird_s16_aexx_free(fir_s16_t *fir);
 

esp_err_t dsps_fir_f32_free(fir_f32_t *fir);
 

esp_err_t dsps_16_array_rev(int16_t *arr, int16_t len);
 
#ifdef __cplusplus
}
#endif
 
 
#if CONFIG_DSP_OPTIMIZED
 
#if (dsps_fir_f32_ae32_enabled == 1)
#define dsps_fir_f32 dsps_fir_f32_ae32
#elif (dsps_fir_f32_aes3_enabled == 1)
#define dsps_fir_f32 dsps_fir_f32_aes3
#else
#define dsps_fir_f32 dsps_fir_f32_ansi
#endif
 
#if (dsps_fird_f32_aes3_enabled == 1)
#define dsps_fird_f32 dsps_fird_f32_aes3
#define dsps_firmr_f32 dsps_firmr_f32_ansi
#elif (dsps_fird_f32_ae32_enabled == 1)
#define dsps_fird_f32 dsps_fird_f32_ae32
#define dsps_firmr_f32 dsps_firmr_f32_ansi
#elif (dsps_fird_f32_arp4_enabled == 1)
#define dsps_fird_f32 dsps_fird_f32_arp4
#define dsps_firmr_f32 dsps_firmr_f32_ansi
#else
#define dsps_fird_f32 dsps_fird_f32_ansi
#define dsps_firmr_f32 dsps_firmr_f32_ansi
#endif
 
 
#if (dsps_fird_s16_ae32_enabled == 1)
#define dsps_fird_s16 dsps_fird_s16_ae32
#define dsps_firmr_s16 dsps_firmr_s16_ansi
#elif (dsps_fird_s16_aes3_enabled == 1)
#define dsps_fird_s16 dsps_fird_s16_aes3
#define dsps_firmr_s16 dsps_firmr_s16_ansi
#elif (dsps_fird_s16_arp4_enabled == 1)
#define dsps_fird_s16 dsps_fird_s16_arp4
#define dsps_firmr_s16 dsps_firmr_s16_ansi
#else
#define dsps_fird_s16 dsps_fird_s16_ansi
#define dsps_firmr_s16 dsps_firmr_s16_ansi
#endif
 
#else // CONFIG_DSP_OPTIMIZED
 
#define dsps_fir_f32 dsps_fir_f32_ansi
#define dsps_fird_f32 dsps_fird_f32_ansi
#define dsps_firmr_f32 dsps_firmr_f32_ansi
#define dsps_fird_s16 dsps_fird_s16_ansi
#define dsps_firmr_s16 dsps_firmr_s16_ansi
 
#endif // CONFIG_DSP_OPTIMIZED
 
#endif // _dsps_fir_H_