HWA

Table of Contents

• Features Supported
• SysConfig Features
• Features NOT Supported
• Important Usage Guidelines
• Example Usage
• API

The HWA driver provides APIs to configure, trigger and obtain results from the hardware accelerator

Features Supported

• All HWA operating modes: FFT, CFAR, compression/decompression and local maxima
• API to program common HWA registers, HWA param sets
• API to program pre/post processing blocks and core computational units
• API to get output statistics and histogram outputs
• Interrupt and polling mode of operations - param done, processing done
• Manual or DMA trigger for data copy from/to HWA memories

SysConfig Features

Note

It is strongly recommend to use SysConfig where it is available instead of using direct SW API calls. This will help simplify the SW application and also catch common mistakes early in the development cycle.

• HWA instances selection
• Init/Deinit API integration with SYSCFG

Features NOT Supported

• None

Important Usage Guidelines

• The HWA Driver needs to be initialized once across the System. This is done using the HWA_init. None of the HWA API can be used without invoking this API. Note: This API is integrated into Sysconfig and can be skipped by user if Sysconfig is used for integrating HWA
• Once the HWA Driver has been initialized; the HWA Driver instance can be opened using the HWA_open. The HWA_open can be called multiple times from different context to obtain a valid HWA handle. However, only the first call to HWA_open will perform the hardware initialization. Other subsequent calls will just return the already open handle.

Example Usage

Include the below file to access the APIs

#include <drivers/hwa.h>

Instance Open Example

    int32_t             status = SystemP_SUCCESS;
    HWA_CommonConfig    commonCfg;
    HWA_ParamConfig     paramCfg;
    uint32_t            paramIdx = 0U;  /* Can be any paramset as per need */
 
    /* Open HWA driver */
    gHwaHandle = HWA_open(0, NULL, &status);
    DebugP_assert(gHwaHandle == NULL);
 
    /* Init Common Params */
    memset(&commonCfg, 0, sizeof(commonCfg));
    commonCfg.configMask = HWA_COMMONCONFIG_MASK_STATEMACHINE_CFG |
                            HWA_COMMONCONFIG_MASK_TWIDDITHERENABLE |
                            HWA_COMMONCONFIG_MASK_LFSRSEED;
    commonCfg.fftConfig.twidDitherEnable = 1U;
    commonCfg.fftConfig.lfsrSeed = 11U;
    commonCfg.paramStartIdx = paramIdx;
    commonCfg.paramStopIdx = paramIdx;
    commonCfg.numLoops = (commonCfg.paramStopIdx - commonCfg.paramStartIdx) + 1U;
    status = HWA_configCommon(gHwaHandle, &commonCfg);
    DebugP_assert(status == SystemP_SUCCESS);
 
    /* Init param set */
    memset(&paramCfg , 0, sizeof(paramCfg));
    paramCfg.triggerMode = HWA_TRIG_MODE_DMA;
    paramCfg.accelMode = HWA_ACCELMODE_FFT;
    /* ... Add init all other parameters as per need */
    status = HWA_configParamSet(gHwaHandle, paramIdx, &paramCfg, NULL);
    DebugP_assert(status == SystemP_SUCCESS);

Instance Close Example

    int32_t status;
 
    status = HWA_close(gHwaHandle);
    DebugP_assert(status == SystemP_SUCCESS);

Instance Processing Example

    int32_t     status;
    uint32_t    dmaCh = 0U; /* Can be any DMA channel as per need */
 
    /* Enable HWA */
    status = HWA_enable(gHwaHandle, 1U);
    DebugP_assert(status == SystemP_SUCCESS);
    status = HWA_reset(gHwaHandle);
    DebugP_assert(status == SystemP_SUCCESS);
 
    /* Trigger and wait */
    status = HWA_setDMA2ACCManualTrig(gHwaHandle, dmaCh);
    DebugP_assert(status == SystemP_SUCCESS);
    /* Wait for Done Callback */
 
    /* Disable HWA */
    status = HWA_enable(gHwaHandle, 0U);
    DebugP_assert(status == SystemP_SUCCESS);

API

APIs for HWA