ECAP

Table of Contents

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

The eCAP driver provides API to configure eCAP module. Below are the high level features supported by the driver.

Features Supported

• Configuration of timestamp capture event
• Configuration of one-shot/continuous mode
• Configuration of independent edge polarity (rising / falling edge) selection for all 4 capture events
• Configuration of interrupt on any of the 4 capture events
• Configuration of input signal prescaling
• Configuration of mode to aPWM when not used in capture mode

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.

SysConfig can be used to configure below parameters apart from common configuration like Clock, MPU, RAT and others.

• ECAP instances and pin mux configurations.

Features NOT Supported

NA

Important Usage Guidelines

NA

Example Usage

Include the below file to access the APIs

#include <drivers/ecap.h>

ECAP Interrupt Registration

    int32_t             status = SystemP_SUCCESS;
    HwiP_Params         hwiPrms;
 
    /* Register interrupt */
    HwiP_Params_init(&hwiPrms);
    hwiPrms.intNum      = CONFIG_ECAP0_INTR;
    hwiPrms.callback    = &App_ecapIntrISR;
    hwiPrms.isPulse     = CONFIG_ECAP0_INTR_IS_PULSE;
    status              = HwiP_construct(&gEcapHwiObject, &hwiPrms);
    DebugP_assert(status == SystemP_SUCCESS);

ECAP Operating Mode Configuration

    /* Enable capture mode */
    ECAP_operatingModeSelect(gEcapBaseAddr, ECAP_CAPTURE_MODE);

ECAP One Shot Mode Configuration

    /* One shot mode, stop capture at event 4 */
    ECAP_oneShotModeConfig(gEcapBaseAddr, ECAP_CAPTURE_EVENT4_STOP);

ECAP Capture Event Polarity Configuration

    /* Set polarity of the events to rising, falling, rising, falling edge */
    ECAP_captureEvtPolarityConfig(gEcapBaseAddr,
                                 ECAP_CAPTURE_EVENT_RISING,
                                 ECAP_CAPTURE_EVENT_FALLING,
                                 ECAP_CAPTURE_EVENT_RISING,
                                 ECAP_CAPTURE_EVENT_FALLING);

ECAP Interrupt Service Routine

    /* Clear Ecap Interrupt. */
    ECAP_intrStatusClear(gEcapBaseAddr, ECAP_INT_ALL);
    /* Clear Global Interrupt Flag. */
    ECAP_globalIntrClear(gEcapBaseAddr);
 
    SemaphoreP_post(&gEcapSyncSemObject);

ECAP Interrupt De-Registration

    HwiP_destruct(&gEcapHwiObject);

API

APIs for ECAP