error_handler.c

Go to the documentation of this file.

 
// Standard Libraries Includes
#include <stdbool.h>
 
// Framework Includes
#include <define_error_criticality.h>
#include <error_handler.h>
#include <error_handler_actions.h>
#include <error_handler_config.h>
 
static errId_t DetermineValidErrorId(errFlag_t flag, errId_t id);
static errCrit_t DetermineErrorIdCriticality(errId_t validId);
 
void EH_HandleError(errFlag_t flag, errId_t id)
{
    const errId_t validId       = DetermineValidErrorId(flag, id);
    const errCrit_t criticality = DetermineErrorIdCriticality(validId);
 
    switch (criticality)
    {
    case IGNORE:
        // Exit error handler without doing anything
        break;
    case NOTIFICATION:
        // Push to log and handle later
        EH_PushNotificationLog(validId);
        break;
    case NON_CRITICAL:
        // Handle error right away by issuing configured callback
        nonCriticalErrorCallback(validId);
        break;
    case CRITICAL:
        // Intentional fallthrough to handle error as CRITICAL by default
    default:
        EH_InitiateSafeState(validId);
        break;
    }
}
 
static errId_t DetermineValidErrorId(errFlag_t flag, errId_t id)
{
    if (flag == NO_ERROR)
    {
        /* cppcheck-suppress misra-c2012-15.5 */
        return ERRID_NONE;
    }
 
    // Invalid error flag
    if (flag != ERROR)
    {
        /* cppcheck-suppress misra-c2012-15.5 */
        return ERRID_ERRFLAG_VAL;
    }
 
    // Invalid error ID
    if (id >= ERRID_MAX)
    {
        /* cppcheck-suppress misra-c2012-15.5 */
        return ERRID_ERRID_VAL;
    }
 
    // Input ID is valid
    return id;
}
 
static errCrit_t DetermineErrorIdCriticality(errId_t validId)
{
    errCrit_t criticality = IGNORE;
 
    // ERRID_NONE is always ignored
    if (validId != ERRID_NONE)
    {
        // Get configured Error ID criticality from lookup table
        criticality = errorIdCritLut[validId];
    }
 
    return criticality;
}
 
void EH_ProcessNotificationLog(void)
{
    while (true)
    {
        // Get and clear the latest Error ID added to the log
        const errId_t id = EH_PopNotificationLog();
 
        // Assumes pop only returns ERRID_NONE when log is empty
        if (id == ERRID_NONE)
        {
            break; // End processing if log is empty
        }
 
        notificationErrorCallback(id);
    }
}