ECC BUS SAFETY

Table of Contents

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

Features Supported

ECC BUS SAFETY module consists ECC Bus Safety Diagnostics.

• BUS Safety Errors : This includes SEC , DED and RED error injection on the specified node

  Note : SEC - Single Error Correction, DED - Double Error Correction, RED - Redundancy Error Correction

The module supports below API's for the application

• API to support and induce error on particular node bus.
• API to support interrupt configuration

SysConfig Features

• None

Features NOT Supported

• None

Important Usage Guidelines

• None

Example Usage

The following shows an example of SDL ECC BUS SAFETY API usage by the application for Error Injection Tests.

Include the below file to access the APIs

#include <sdl/sdl_ecc_bus_safety.h>

Induce the error SEC in Interrupt Method for MSS Nodes

static int32_t SDL_ECC_BUS_SAFETY_MSS_SEC_test(uint32_t busSftyNode ,uint32_t addr)
{
    int32_t ret_val = SDL_EFAIL;
    uint32_t timeout = SDL_ECC_BUS_SAFETY_TIMEOUT;
    uint32_t writeData = 0x1234567U;
    uint32_t dmaCh = 0U;
    uint32_t tcc = 0U;
    uint32_t param = 0U;
    uint32_t queNum = 0U;
    uint32_t edmaNum = 0U;
        ret_val = SDL_ECC_BUS_SAFETY_MSS_secExecute(busSftyNode,addr,writeData);
        if(ret_val !=SDL_PASS )
        {
            ret_val = SDL_EFAIL;
        }
        else
        {
            if((SDL_ECC_BUS_SAFETY_MSS_TPTC_A0_RD <= busSftyNode )&&(SDL_ECC_BUS_SAFETY_MSS_TPTC_B0_RD>=busSftyNode))
            {
            SDL_ECC_BUS_SAFETY_MSS_getEDMAParameters(busSftyNode,&dmaCh, &tcc, &param, &queNum, &edmaNum );
            test_edmaATransfer(dmaCh,tcc,param,queNum,edmaNum );
            }
            else
            {
                 /* Do Nothing */
            }
            /* wait for error notification from ESM, or for timeout */
            /* fault injection gets deasserted in ISR */
            while((MSSSecFlag!=TRUE) && (timeout!=0U))
            {
                timeout--;
            }
            if(MSSSecFlag==TRUE)
            {
                MSSSecFlag=FALSE;
                ret_val = SDL_PASS;
            }
            else
            {
                ret_val = SDL_EFAIL;
            }
        }
        return ret_val;
}

Induce the error DED in Interrupt Method for MSS Nodes

static int32_t SDL_ECC_BUS_SAFETY_MSS_DED_test(uint32_t busSftyNode ,uint32_t addr)
{
    int32_t ret_val = SDL_EFAIL;
    uint32_t timeout = SDL_ECC_BUS_SAFETY_TIMEOUT;
    uint32_t writeData = 0x1234567U;
    uint32_t dmaCh = 0U;
    uint32_t tcc = 0U;
    uint32_t param = 0U;
    uint32_t queNum = 0U;
    uint32_t edmaNum = 0U;
 
        ret_val = SDL_ECC_BUS_SAFETY_MSS_dedExecute(busSftyNode,addr,writeData);
        if(ret_val !=SDL_PASS )
        {
           ret_val = SDL_EFAIL;
        }
        else
        {
            if((SDL_ECC_BUS_SAFETY_MSS_TPTC_A0_RD <= busSftyNode )&&(SDL_ECC_BUS_SAFETY_MSS_TPTC_B0_RD>=busSftyNode))
            {
            SDL_ECC_BUS_SAFETY_MSS_getEDMAParameters(busSftyNode,&dmaCh, &tcc, &param, &queNum, &edmaNum );
            test_edmaATransfer(busSftyNode,dmaCh,tcc,param,queNum,edmaNum );
            }
            else
            {
                 /* Do Nothing */
            }
            /* wait for error notification from ESM, or for timeout */
            /* fault injection gets deasserted in ISR */
            while((SDL_MSS_intrFlg[busSftyNode]!=TRUE) && (timeout!=0U))
            {
                timeout--;
            }
            if(SDL_MSS_intrFlg[busSftyNode]==TRUE)
            {
                SDL_MSS_intrFlg[busSftyNode]=FALSE;
                ret_val = SDL_PASS;
            }
            else
            {
                ret_val = SDL_EFAIL;
            }
        }
    return ret_val;
}

Induce the error RED in Interrupt Method for MSS Nodes

static int32_t SDL_ECC_BUS_SAFETY_MSS_RED_test(uint32_t busSftyNode, SDL_ECC_BUS_SAFETY_busSftyFiType fiType, SDL_ECC_BUS_SAFETY_busSftyFiRedType redType)
{
  int32_t ret_val = SDL_EFAIL;
  uint32_t timeout = SDL_ECC_BUS_SAFETY_TIMEOUT;
      ret_val= SDL_ECC_BUS_SAFETY_MSS_redExecute(busSftyNode, fiType, redType);
      if(ret_val !=SDL_PASS )
      {
          ret_val = SDL_EFAIL;
      }
      else
      {
          /* wait for error notification from ESM, or for timeout */
          /* fault injection gets deasserted in ISR */
          while((SDL_MSS_intrFlg[busSftyNode]!=TRUE) && (timeout!=0U))
          {
              timeout--;
          }
          if(SDL_MSS_intrFlg[busSftyNode]==TRUE)
          {
              SDL_MSS_intrFlg[busSftyNode]=FALSE;
              ret_val = SDL_PASS;
          }
          else
          {
              ret_val = SDL_EFAIL;
          }
      }
  return ret_val;
}

Induce the error SEC in Polling Method for DSS Nodes

retval = SDL_ECC_BUS_SAFETY_DSS_secExecute(busSftyNode,addr,writeData);
if(retval !=SDL_PASS )
{
    retval = SDL_EFAIL;
}
else
{
        if(((SDL_ECC_BUS_SAFETY_DSS_TPTC_A0_RD <= busSftyNode )&&(SDL_ECC_BUS_SAFETY_DSS_TPTC_C5_RD>=busSftyNode))||(SDL_ECC_BUS_SAFETY_DSS_PCR==busSftyNode))
    {
        SDL_ECC_BUS_SAFETY_DSS_getEDMAParameters(busSftyNode,&dmaCh, &tcc, &param, &queNum, &edmaNum );
        test_edmaATransfer(dmaCh,tcc,param,queNum,edmaNum );
    }
    else
    {
         /* Do Nothing */
    }
    /* Wait for test to complete/timeout. */
    while((status == 0U) && (timeout!=0U))
    {
        retval =SDL_ECC_BUS_SAFETY_DSS_getSecErrorStatus(busSftyNode,&status);
        if(retval !=SDL_PASS )
        {
            timeout--;
        }
        else
        {
            break;
        }
 
    }
    if(status!=0U)
    {
        retval = SDL_PASS;
        SDL_ECC_BUS_SAFETY_DSS_secErrorClear(busSftyNode );
    }
    else
    {
        retval = SDL_EFAIL;
    }
}

Induce the error DED in Polling Method for DSS Nodes

retval = SDL_ECC_BUS_SAFETY_DSS_dedExecute(busSftyNode,addr,writeData);
if(retval !=SDL_PASS )
{
    retval = SDL_EFAIL;
}
else
{
        if(((SDL_ECC_BUS_SAFETY_DSS_TPTC_A0_RD <= busSftyNode )&&(SDL_ECC_BUS_SAFETY_DSS_TPTC_C5_RD>=busSftyNode))||(SDL_ECC_BUS_SAFETY_DSS_PCR==busSftyNode))
    {
        SDL_ECC_BUS_SAFETY_DSS_getEDMAParameters(busSftyNode,&dmaCh, &tcc, &param, &queNum, &edmaNum );
        test_edmaATransfer(dmaCh,tcc,param,queNum,edmaNum );
    }
    else
    {
        /* Do Nothing */
    }
    /* Wait for test to complete/timeout. */
    while((status == 0U) && (timeout!=0U))
    {
        retval =SDL_ECC_BUS_SAFETY_DSS_getDedErrorStatus(busSftyNode,&status);
        if(retval !=SDL_PASS )
        {
            timeout--;
        }
        else
        {
            break;
        }
 
    }
    if(status!=0U)
    {
        retval = SDL_PASS;
        SDL_ECC_BUS_SAFETY_DSS_dedErrorClear(busSftyNode);
    }
    else
    {
        retval = SDL_EFAIL;
    }
}

Induce the error RED in Polling Method for DSS Nodes

retval= SDL_ECC_BUS_SAFETY_DSS_redExecute(busSftyNode, fiType, redType);
if(retval !=SDL_PASS )
{
    retval = SDL_EFAIL;
}
else
{
    /* Wait for test to complete/timeout. */
    while((status == 0U) && (timeout!=0U))
    {
        retval =SDL_ECC_BUS_SAFETY_DSS_getRedErrorStatus(busSftyNode,&status);
        if(retval !=SDL_PASS )
        {
            timeout--;
        }
        else
        {
            break;
        }
 
    }
    if(status!=0U)
    {
        retval = SDL_PASS;
        SDL_ECC_BUS_SAFETY_DSS_redErrorClear(busSftyNode);
    }
    else
    {
        retval = SDL_EFAIL;
    }
}

Induce the error SEC in Interrupt Method for DSS Nodes

ret_val = SDL_ECC_BUS_SAFETY_DSS_secExecute(busSftyNode,addr,writeData);
if(ret_val !=SDL_PASS )
{
    ret_val = SDL_EFAIL;
}
else
{
    if(((SDL_ECC_BUS_SAFETY_DSS_TPTC_A0_RD <= busSftyNode )&&(SDL_ECC_BUS_SAFETY_DSS_TPTC_C5_RD>=busSftyNode))||(SDL_ECC_BUS_SAFETY_DSS_PCR==busSftyNode))
    {
        SDL_ECC_BUS_SAFETY_DSS_getEDMAParameters(busSftyNode,&dmaCh, &tcc, &param, &queNum, &edmaNum );
        test_edmaATransfer(busSftyNode, dmaCh,tcc,param,queNum,edmaNum );
    }
    else
    {
        /* Do Nothing */
    }
    /* wait for error notification from ESM, or for timeout */
    /* fault injection gets deasserted in ISR */
    while((dssSecFlag!=TRUE) && (timeout!=0U))
    {
        timeout--;
    }
    if(dssSecFlag==TRUE)
    {
        dssSecFlag=FALSE;
        ret_val = SDL_PASS;
    }
    else
    {
        ret_val = SDL_EFAIL;
    }
}

Induce the error DED in Interrupt Method for DSS Nodes

ret_val = SDL_ECC_BUS_SAFETY_DSS_dedExecute(busSftyNode,addr,writeData);
if(ret_val !=SDL_PASS )
{
    ret_val = SDL_EFAIL;
}
else
{
    if(((SDL_ECC_BUS_SAFETY_DSS_TPTC_A0_RD <= busSftyNode )&&(SDL_ECC_BUS_SAFETY_DSS_TPTC_C5_RD>=busSftyNode))||(SDL_ECC_BUS_SAFETY_DSS_PCR==busSftyNode))
    {
        SDL_ECC_BUS_SAFETY_DSS_getEDMAParameters(busSftyNode,&dmaCh, &tcc, &param, &queNum, &edmaNum );
        test_edmaATransfer(busSftyNode,dmaCh,tcc,param,queNum,edmaNum );
    }
    else
    {
        /* Do Nothing */
    }
    /* wait for error notification from ESM, or for timeout */
    /* fault injection gets deasserted in ISR */
    while((SDL_DSS_intrFlg[busSftyNode]!=TRUE) && (timeout!=0U))
    {
        timeout--;
    }
    if(SDL_DSS_intrFlg[busSftyNode]==TRUE)
    {
        SDL_DSS_intrFlg[busSftyNode]=FALSE;
        ret_val = SDL_PASS;
    }
    else
    {
        ret_val = SDL_EFAIL;
    }
}

Induce the error RED in Interrupt Method for DSS Nodes

ret_val= SDL_ECC_BUS_SAFETY_DSS_redExecute(busSftyNode, fiType, redType);
if(ret_val !=SDL_PASS )
{
    ret_val = SDL_EFAIL;
}
else
{
    /* wait for error notification from ESM, or for timeout */
    /* fault injection gets deasserted in ISR */
    while((SDL_DSS_intrFlg[busSftyNode]!=TRUE) && (timeout!=0U))
    {
        timeout--;
    }
    if(SDL_DSS_intrFlg[busSftyNode]==TRUE)
    {
        SDL_DSS_intrFlg[busSftyNode]=FALSE;
        ret_val = SDL_PASS;
    }
    else
    {
        ret_val = SDL_EFAIL;
    }
}

API

APIs for SDL ECC BUS SAFETY