os_timer.c

 
//=======================================================================================================
// @file os_timer.c
//
// @brief contains the functions for using software timers
//
// @note    in this file you will find functions for using timers and countdowns for your application
//          These software timers are updated by the hardware timer interrupt of the os_scheduler
//          The number of timers need to be defined in main/project_settings.h :
//              #define OS_TIMER_NUMBER_OF_TIMERS 3
//          You should also put your your individual Timer defines with the corresponding index there
//              #define OS_TIMER_COUNTDOWN_EXAMPLE_SWITCHOFFTHELIGHT        0
//              #define OS_TIMER_COUNTDOWN_EXAMPLE_SWITCHOFFCOFFEEMACHINE   1
//              #define OS_TIMER_COUNTDOWN_EXAMPLE_IAMGOINGHOMENOW          2
//
//
// @version v1.0
// @date 2019-08-30
// @author M52409
//
//=======================================================================================================
 
#include <stdbool.h>
#include <stdint.h>
#include <string.h>
#include "os_config.h"
#include "os_timer.h"
 
#ifndef OS_TIMER_NUMBER_OF_TIMERS
    #pragma message "OS_TIMER_NUMBER_OF_TIMERS needs to be defined in the file project_settings.h"
#endif  //OS_TIMER_NUMBER_OF_TIMERS
 
#if OS_TIMER_NUMBER_OF_TIMERS > 0
 
typedef struct
{
    uint16_t timerval;
    uint8_t countdown:1;
    uint8_t countup:1;
    uint8_t expired:1;
    uint8_t reserved:5;
} OS_TIMER_DATA_t;
 
/* The variable below need not be static */
/* LDRA_EXCLUDE 27 D */
#if OS_TIMER_NUMBER_OF_TIMERS > 0
OS_TIMER_DATA_t os_timer_data[OS_TIMER_NUMBER_OF_TIMERS];
#endif
 
//=======================================================================================================
// @brief   OS_Timer_Init initializes the Software Timers
// @note    call this function at boot up to initialize the Software Timers
//=======================================================================================================
void OS_Timer_Init(void)
{
#if OS_TIMER_NUMBER_OF_TIMERS > 0
    uint8_t i;
    /* Return of the memset is not required */
    /* LDRA_EXCLUDE 382 S */
    memset(os_timer_data, 0, sizeof(os_timer_data));
    for (i=0U; i < OS_TIMER_NUMBER_OF_TIMERS; i++)
    {
        os_timer_data[i].expired = true;
    }
#endif
}
 
 
//=======================================================================================================
// @brief   OS_Timer_StartCountdown_100us/1ms starts a new Countdown
// @note    call this function if you want to use a new countdown
// @param   timer_index - index of the timer that should be used for that countdown
// @param   numOfTicks - depending on the scheduler timing, the number of 100µs or 1ms ticks to count
//=======================================================================================================
 
/* OS_Timer_StartCountdown_1ms, OS_Timer_StartCountdown_100us and 
 OS_Timer_IsCountdownExpired are not called in the project, hence the violations
 76 D and 61 D */
/* LDRA_EXCLUDE 76 D */
/* LDRA_EXCLUDE 61 D */
#if OS_USE_SCHEDULER_100us == 1
void OS_Timer_StartCountdown_100us(uint8_t timer_index, uint16_t numOfTicks)
#elif OS_USE_SCHEDULER_1ms == 1
void OS_Timer_StartCountdown_1ms(uint8_t timer_index, uint16_t numOfTicks)
#else
#error OS_USE_SCHEDULER_100us or OS_USE_SCHEDULER_1ms needs to be definied as 1 to get the right timer functions
#endif
{
    if (timer_index < OS_TIMER_NUMBER_OF_TIMERS)
    {
        os_timer_data[timer_index].countup = false;
        os_timer_data[timer_index].countdown = true;
        os_timer_data[timer_index].expired = false;
        os_timer_data[timer_index].timerval = numOfTicks;
    }
}
 
/* LDRA_EXCLUDE 76 D */
/* LDRA_EXCLUDE 61 D */
bool OS_Timer_IsCountdownExpired(uint8_t timer_index)
{
    if (timer_index >= OS_TIMER_NUMBER_OF_TIMERS)
    {
        return false;
    }
    if (os_timer_data[timer_index].expired == 0U)
    {
        return false;
    }
    return true;
}
 
void OS_Timer_Tick(void)
{
    uint8_t i;
    for (i=0U; i < OS_TIMER_NUMBER_OF_TIMERS; i++)
    {
        if (os_timer_data[i].countdown == 1U)
        {
            if (os_timer_data[i].timerval != 0U)
            {
                os_timer_data[i].timerval -= 1U;
                if (os_timer_data[i].timerval == 0U)
                {
                    os_timer_data[i].expired = true;
                }
            }
        }
    }
}
 
#endif