aoaprochwa.h

Go to the documentation of this file.

/*
 *  NOTE:
 *      (C) Copyright 2023 Texas Instruments, Inc.
 *
 *  Redistribution and use in source and binary forms, with or without
 *  modification, are permitted provided that the following conditions
 *  are met:
 *
 *    Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 *    Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the
 *    distribution.
 *
 *    Neither the name of Texas Instruments Incorporated nor the names of
 *    its contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 *  "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 *  LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 *  A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 *  OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 *  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 *  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 *  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 *  THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 *  (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 *  OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
 
/**************************************************************************
 *************************** Include Files ********************************
 **************************************************************************/
#ifndef AOAPROCHWA_H_
#define AOAPROCHWA_H_
 
/* Standard Include Files. */
#include <stdint.h>
#include <stdlib.h>
#include <stddef.h>
#include <string.h>
#include <stdio.h>
#include <math.h>
 
/* mmWave SDK Driver/Common Include Files */
#include <drivers/hwa.h>
 
/* DPIF Components Include Files */
#include <datapath/dpif/dpif_detmatrix.h>
#include <datapath/dpif/dpif_radarcube.h>
#include <datapath/dpif/dpif_anglemat.h>
#include <datapath/dpedma/v0/dpedmahwa.h>
#include <datapath/dpedma/v0/dpedma.h>
#include <datapath/dpu/aoaproc/v0/aoaproc_common.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define DPU_AOAPROCHWA_EINVAL                  (DP_ERRNO_AOA_PROC_BASE-1)
 
#define DPU_AOAPROCHWA_ENOMEM                  (DP_ERRNO_AOA_PROC_BASE-2)
 
#define DPU_AOAPROCHWA_EINPROGRESS             (DP_ERRNO_AOA_PROC_BASE-3)
 
#define DPU_AOAPROCHWA_EHWARES                 (DP_ERRNO_AOA_PROC_BASE-4)
 
#define DPU_AOAPROCHWA_ESEMA                   (DP_ERRNO_AOA_PROC_BASE-5)
 
#define DPU_AOAPROCHWA_ESEMASTATUS             (DP_ERRNO_AOA_PROC_BASE-6)
 
#define DPU_AOAPROCHWA_EEXCEEDHWAMEM           (DP_ERRNO_AOA_PROC_BASE-7)
 
#define DPU_AOAPROCHWA_ECUBEFORMAT             (DP_ERRNO_AOA_PROC_BASE-8)
 
#define DPU_AOAPROCHWA_EDETMFORMAT             (DP_ERRNO_AOA_PROC_BASE-9)
 
#define DPU_AOAPROCHWA_EDETMSIZE               (DP_ERRNO_AOA_PROC_BASE-10)
 
#define DPU_AOAPROCHWA_EWINDSIZE               (DP_ERRNO_AOA_PROC_BASE-11)
 
#define DPU_AOAPROCHWA_MAX_NUM_HWA_PARAMSET 12
 
#define DPU_AOAPROCHWA_NUM_HWA_PARAMSET_DOPPLER_FFT 6
 
#define DPU_AOAPROCHWA_NUM_HWA_PARAMSET_DOPPLER_FFT_ONLY 2
 
#define DPU_AOAPROCHWA_NUM_HWA_PARAMSET_AOA 6
 
#define DPU_AOAPROCHWA_NUM_HWA_MEMBANKS  4
 
typedef void*  DPU_AoAProcHWA_Handle;
 
typedef struct DPU_AoAProcHWA_InitCfg_t
{
    HWA_Handle  hwaHandle;
    
}DPU_AoAProcHWA_InitParams;
 
typedef struct DPU_AoAProcHWA_HwaCfg_t
{
 
    uint8_t     winSym;
 
    uint32_t    windowSize;
 
    int32_t     *window;
 
    uint32_t    winRamOffset;
 
    uint32_t    vectorRamSize;
 
    cmplx32ImRe_t     *vectorRam;
 
    uint32_t    vecRamOffset;
    
    uint32_t    paramSetStartIdx;
    
    uint8_t     hwaDmaTriggerDoppPing;
 
    uint8_t     hwaDmaTriggerDoppPong;
 
    uint8_t     hwaDmaTriggerAoAPing;
 
    uint8_t     hwaDmaTriggerAoAPong;
 
}DPU_AoAProcHWA_HwaCfg;
 
typedef struct DPU_AoAProcHWA_EdmaCfg_t
{
    EDMA_Handle edmaHandle;
    
    DPU_AoAProc_Edma edmaIn_rangeFFT;
 
    DPU_AoAProc_Edma edmaIn_dopplerFFT;
 
    DPU_AoAProc_Edma edmaHotSigDoppler;
 
    DPU_AoAProc_Edma edmaHotSigAoA;
 
    DPU_AoAProc_Edma edmaOut_maxAoA;
    
}DPU_AoAProcHWA_EdmaCfg;
 
typedef struct DPU_AoAProcHWA_HW_Resources_t
{
    DPU_AoAProcHWA_EdmaCfg edmaCfg;
    
    DPU_AoAProcHWA_HwaCfg  hwaCfg;
    
    DPIF_RadarCube radar_1D_FFT_Cube;
 
    DPIF_Anglemat angleMat;
 
    uint32_t *maxVal_elev_azim;
 
    /* NOTE: Application needs to provide address of the EDMA interrupt object.
     * This needs to be done as there might be multiple subframes configured
     * and each subframe needs EDMA interrupt to be registered.
     */
    Edma_IntrObject *intrObj;
}DPU_AoAProcHWA_HW_Resources;
 
typedef struct DPU_AoAProcHWA_maxDetMatrix_Resources_t
{
    uint16_t     *rangeGatesCount;    
 
    uint16_t    *range_idx_arr;
 
    uint16_t    *angle_idx_doppler_count_arr;
 
    int16_t    *doppler_idx_arr;//Pointer to array of size [MAX_NUM_RANGE_BINS][MAX_NUM_POINTS];
 
    cmplx32ImRe_t     *antenna_array;
 
    uint8_t                max_num_points;
 
    uint8_t                antenna_array_elements;
}DPU_AoAProcHWA_maxDetMatrix_Resources;
 
typedef struct DPU_AoAProcHWA_StaticConfig_t
{
    uint8_t     numTxAntennas;
    
    uint8_t     numRxAntennas;
    
    uint8_t     numVirtualAntennas; 
    
    uint16_t    numRangeBins;
    
    uint16_t    numDopplerChirps;
    
    uint16_t    numDopplerBins;
    
    uint8_t     log2NumDopplerBins;
 
    uint8_t     doppFFT_is16b;
 
    uint8_t     azimuthFFTSize;
 
    uint8_t     log2NumAzimuthBins;
 
    uint8_t     log2NumElevationBins;
 
    uint8_t     elevationFFTSize;  
 
    uint8_t     numCols_Antenna;
 
    uint8_t     numRows_Antenna;  
 
}DPU_AoAProcHWA_StaticConfig;
 
typedef struct DPU_AoAProcHWA_Config_t
{
    DPU_AoAProcHWA_HW_Resources  hwRes;
    
    DPU_AoAProcHWA_StaticConfig  staticCfg;
 
    DPU_AoAProcHWA_maxDetMatrix_Resources maxDetmatrix_res;
    
}DPU_AoAProcHWA_Config;
 
 
typedef struct DPU_AoAProcHWA_OutParams_t
{
    DPU_AoAProc_stats  stats;
}DPU_AoAProcHWA_OutParams;
 
DPU_AoAProcHWA_Handle DPU_AoAProcHWA_init(DPU_AoAProcHWA_InitParams *initCfg, int32_t* errCode);
int32_t DPU_AoAProcHWA_Dopplerprocess(DPU_AoAProcHWA_Handle handle, DPU_AoAProcHWA_OutParams *outParams);
int32_t DPU_AoAProcHWA_AoAprocess(DPU_AoAProcHWA_Handle handle, DPU_AoAProcHWA_OutParams *outParams);
int32_t DPU_AoAProcHWA_deinit(DPU_AoAProcHWA_Handle handle);
int32_t DPU_AoAProcHWA_config(DPU_AoAProcHWA_Handle handle, DPU_AoAProcHWA_Config *cfg);
 
#ifdef __cplusplus
}
#endif
 
#endif