doaproc.h

Go to the documentation of this file.

 
/**************************************************************************
 *************************** Include Files ********************************
 **************************************************************************/
#ifndef DOAPROC_HWA_H
#define DOAPROC_HWA_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>
#include <common/syscommon.h>
 
/* DPIF Components Include Files */
#include <datapath/dpif/dpif_detmatrix.h>
#include <datapath/dpif/dpif_radarcube.h>
 
/* mmWave SDK Data Path Include Files */
#include <datapath/dpif/dp_error.h>
#include <datapath/dpu/doaproc/v0/doaproccommon.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define DPU_DOAPROC_EINVAL                  (DP_ERRNO_DOA_PROC_BASE-1)
 
#define DPU_DOAPROC_ENOMEM                  (DP_ERRNO_DOA_PROC_BASE-2)
 
#define DPU_DOAPROC_EINPROGRESS             (DP_ERRNO_DOA_PROC_BASE-3)
 
#define DPU_DOAPROC_EHWARES                 (DP_ERRNO_DOA_PROC_BASE-4)
 
#define DPU_DOAPROC_ESEMA                   (DP_ERRNO_DOA_PROC_BASE-5)
 
#define DPU_DOAPROC_ESEMASTATUS             (DP_ERRNO_DOA_PROC_BASE-6)
 
#define DPU_DOAPROC_EEXCEEDHWAMEM           (DP_ERRNO_DOA_PROC_BASE-7)
 
#define DPU_DOAPROC_ECUBEFORMAT             (DP_ERRNO_DOA_PROC_BASE-8)
 
#define DPU_DOAPROC_EDETMFORMAT             (DP_ERRNO_DOA_PROC_BASE-9)
 
#define DPU_DOAPROC_EDETMSIZE               (DP_ERRNO_DOA_PROC_BASE-10)
 
#define DPU_DOAPROC_EWINDSIZE               (DP_ERRNO_DOA_PROC_BASE-11)
 
#define DPU_DOAPROC_E_NOTSUPPORTED_ANGLE_DIM_ONE_AND_CPU_LOOP_CTRL (DP_ERRNO_DOA_PROC_BASE-12)
 
#define DPU_DOAPROC_E_EXCEEDED_MAX_NUM_DOPPLER_BINS (DP_ERRNO_DOA_PROC_BASE-13)
 
#define DPU_DOAPROC_MAX_NUM_HWA_PARAMSET  11
 
#define DPU_DOAPROC_NUM_HWA_MEMBANKS  4 
 
#define DPU_DOAPROC_FIRST_SCALING_DISABLED ((uint8_t)0U)
 
#define DPU_DOAPROC_FIRST_SCALING_ENABLED ((uint8_t)1U)
 
#define DPU_DOAPROC_RANGE_LOOP_HWA_CONTROL (0)
 
#define DPU_DOAPROC_RANGE_LOOP_CPU_CONTROL (1)
 
 
typedef struct DPU_DoaProc_RadarCubeChunkEdmaCfg_t
{
    uint32_t srcAddress;
 
    uint32_t dstAddress;
 
    uint32_t Bcnt_Acnt;
} DPU_DoaProc_RadarCubeChunkEdmaCfg;
 
typedef struct DPU_DoaProc_RadarCubeSource_t
{
    DPU_DoaProc_RadarCubeChunkEdmaCfg chunk[2];
} DPU_DoaProc_RadarCubeSource;
 
typedef void*  DPU_DoaProc_Handle;
 
typedef struct DPU_DoaProc_InitCfg_t
{
    HWA_Handle  hwaHandle;
    
}DPU_DoaProc_InitParams;
 
typedef struct DPU_DoaProc_HWA_Doppler_Fft_Cfg_t
{
    uint16_t    srcBcnt;
 
    int16_t     srcAddrOffset;
 
    int16_t     srcBidx;
 
    int16_t     scale;
 
    int16_t     dstAddrOffset;
 
    int16_t     dstBidx;
} DPU_DoaProc_HWA_Doppler_Fft_Cfg;
 
#define DPU_DOA_PROC_MAX_NUM_DOP_FFFT_PARAMS 5
 
#define DPU_DOA_PROC_MAX_2D_ANT_ARRAY_ELEMENTS 16
 
typedef struct DPU_DoaProc_HWA_Option_Cfg_t
{
    uint8_t numDopFftParams;
    DPU_DoaProc_HWA_Doppler_Fft_Cfg dopFftCfg[DPU_DOA_PROC_MAX_NUM_DOP_FFFT_PARAMS];
} DPU_DoaProc_HWA_Option_Cfg;
 
typedef struct DPU_DoaProc_HwaCfg_t
{
    uint8_t     winSym;
 
    uint32_t    windowSize;
 
    int32_t     *window;
 
    uint32_t    winRamOffset;
    
    uint8_t     firstStageScaling;
 
    uint8_t     numParamSets;
    
    uint32_t    paramSetStartIdx;
 
    uint32_t    hwaMemInpAddr;
 
    DPU_DoaProc_HWA_Option_Cfg doaRngGateCfg;
 
    uint8_t     dmaTrigSrcChan;
}DPU_DoaProc_HwaCfg;
 
typedef volatile struct DPU_DoaProc_HwaMaxOutput_t
{
    uint32_t   maxInd;      
    uint32_t   peak;        
}  DPU_DoaProc_HwaMaxOutput;
 
 
typedef struct DPU_DoaProc_EdmaCfg_t
{
    EDMA_Handle edmaHandle;
 
    uint32_t    edmaInstanceId;
    
    DPU_DoaProc_Edma edmaIn;
 
    DPEDMA_ChanCfg edmaHotSig;
    
    DPEDMA_ChanCfg edmaDetMatOut;
    DPEDMA_ChanCfg dopIndMatOut;
    DPEDMA_ChanCfg elevIndMatOut;
 
    DPEDMA_ChanCfg edmaInterLoopOut;
    DPEDMA_ChanCfg edmaInterLoopIn;
    DPEDMA_ChanCfg edmaInterLoopHotSig;
    DPEDMA_ChanCfg edmaInterLoopChainBack;
    Edma_IntrObject   *intrObj;
 
    uint32_t dummySrc;
    uint32_t dummyDst;
    
}DPU_DoaProc_EdmaCfg;
 
typedef struct DPU_DoaProc_HW_Resources_t
{
    DPU_DoaProc_EdmaCfg edmaCfg;
    
    DPU_DoaProc_HwaCfg  hwaCfg;
    
    DPIF_RadarCube radarCube;
    
    DPIF_RadarCube      radarCubeMinMot;
 
    DPIF_DetMatrix detMatrix;
 
    DPIF_DetMatrix dopplerIndexMatrix;
 
    DPIF_DetMatrix elevationIndexMatrix;
 
    cmplx32ImRe_t *interLoopDataBuffer;
}DPU_DoaProc_HW_Resources;
 
typedef struct DPU_DoaProc_compRxChannelBiasCfg_t
{
 
    float rangeBias;
 
    cmplx32ReIm_t rxChPhaseComp[SYS_COMMON_NUM_TX_ANTENNAS * SYS_COMMON_NUM_RX_CHANNEL];
 
} DPU_DoaProc_compRxChannelBiasCfg;
 
typedef struct DPU_DoaProc_compRxChannelBiasFloatCfg_t
{
 
    float rangeBias;
 
    float rxChPhaseComp[2 * SYS_COMMON_NUM_TX_ANTENNAS * SYS_COMMON_NUM_RX_CHANNEL];
 
} DPU_DoaProc_compRxChannelBiasFloatCfg;
 
 
typedef struct DPU_DoaProc_StaticConfig_t
{
    uint8_t     numTxAntennas;
    
    uint8_t     numRxAntennas;
    
    uint8_t     numVirtualAntennas; 
    
    uint16_t    numRangeBins;
    
    uint16_t    numDopplerChirps;
    
    uint16_t    numDopplerBins;
    
    uint16_t    azimuthFftSize;
 
    uint16_t    elevationFftSize;
 
    uint16_t    numMinorMotionChirpsPerFrame;
 
    uint16_t    numFrmPerMinorMotProc;
 
 
    uint8_t     log2NumDopplerBins;
    
    uint8_t     selectCoherentPeakInDopplerDim;
 
    uint8_t     angleDimension;
 
    bool        isDetMatrixLogScale;
 
    bool        isStaticClutterRemovalEnabled;
 
    bool        isRxChGainPhaseCompensationEnabled;
 
    DPU_DoaProc_compRxChannelBiasCfg compRxChanCfg;
 
    uint16_t    doaRangeLoopType;
 
    bool        enableMajorMotion;
 
    bool        enableMinorMotion;
 
    uint16_t    numAntRow;
 
    uint16_t    numAntCol;
 
}DPU_DoaProc_StaticConfig;
 
typedef struct DPU_DoaProc_Config_t
{
    DPU_DoaProc_HW_Resources  hwRes;
    
    DPU_DoaProc_StaticConfig  staticCfg;
    
}DPU_DoaProc_Config;
 
 
typedef struct DPU_DoaProc_OutParams_t
{
    DPU_DoaProc_Stats  stats;
}DPU_DoaProc_OutParams;
 
 
DPU_DoaProc_Handle DPU_DoaProc_init(DPU_DoaProc_InitParams *initCfg, int32_t* errCode);
int32_t DPU_DoaProc_process(DPU_DoaProc_Handle handle,
                            DPU_DoaProc_RadarCubeSource *radarCubeSrc,
                            DPIF_DetMatrix *detMatrix,
                            DPU_DoaProc_OutParams *outParams);
int32_t DPU_DoaProc_deinit(DPU_DoaProc_Handle handle);
int32_t DPU_DoaProc_config(DPU_DoaProc_Handle handle, DPU_DoaProc_Config *cfg);
 
#if 0
int32_t DPU_DoaProcHWA_control
(
   DPU_AoAProcHWA_Handle handle,
   DPU_AoAProcHWA_Cmd cmd,
   void *arg,
   uint32_t argSize
);
#endif
 
 
#ifdef __cplusplus
}
#endif
 
#endif