2.7 Timer Driver

• System>Clock Control:

  • Clock Source: HFINTOSC

  • HF Internal Clock: 64 MHz

• System>Pins:

  • Pin Grid View: Select LED pin as output (Check the schematic for your board)

  • Pins: Rename Custom Name to "LED"

  • Pin Grid View: Select SWITCH pin as input (check the schematic for your board)

  • Pins: Rename Custom Name to "SW"

  • Enable Weak Pullup if needed

• Drivers>Timer:

  • Timer PLIB Selector: TMR0

  • Timer Enable: False

  • Interrupt Driven: True

  • Requested Period: 100 ms

#include "mcc_generated_files/system/system.h"

/*
 * Development Board: PIC18F57Q43 Curiosity Nano Board
 * MCC Configuration:
 *     System module: HFINTOSC (64 MHz)
 *     Timer module: Timer PLIB Selector - TMR0, Timer Enable - False, Interrupt Driven - True, Requested Timer Period - 100 ms
 *     TMR0 module: Timer_PeriodSet() API Range - [2 us - 131.072 ms] (read-only)
 *     Pins module: RF3 - GPIO Output, CustomName - LED
 *                  RB4 - GPIO Input, CustomName - SW, Weak Pull Up - Enable 
 */

#define SW_PRESSED 0U          // Switch - Active Low
#define SW_NOT_PRESSED 1U 
#define DEBONCE_DELAY_MS 20U      // Depends on hardware

#define MS_TO_TICKS(ms) (((TMR0_CLOCK_FREQ * (ms)) / 1000UL) - 1UL)
#define LED_40_MS (MS_TO_TICKS(40UL))           
#define LED_80_MS (MS_TO_TICKS(80UL))

static const struct TIMER_INTERFACE *Timer = &Timer0;

bool SW_StateGet(void)
{
    bool status = SW_NOT_PRESSED;
    if(SW_PRESSED == SW_GetValue())
    {
        __delay_ms(DEBONCE_DELAY_MS);
        if(SW_PRESSED == SW_GetValue())
        {
            status = SW_PRESSED;
        }        
    }
    return status;
}

void Timer_FrequencyChange(void)
{
    static volatile bool changePeriod = false;
    Timer->Stop();
    
    uint32_t maxCount = Timer->MaxCountGet();
    uint32_t newPeriod = changePeriod ? LED_40_MS:LED_80_MS;
    
    if(maxCount > newPeriod)
    {      
        Timer->PeriodSet(newPeriod);
    }
    else
    {
        // Invalid period
    }
    changePeriod = !changePeriod;
    Timer->Start(); 
}

void Timer_Callback(void)
{
    LED_Toggle();
}

int main(void)
{
    SYSTEM_Initialize();

    Timer->PeriodSet(LED_40_MS);
    Timer->TimeoutCallbackRegister(Timer_Callback);
    Timer->Start();    
  
    // Enable the Global Interrupts 
    INTERRUPT_GlobalInterruptEnable(); 
    
    while(1)
    {
        if(SW_PRESSED == SW_StateGet())
        {
            Timer_FrequencyChange();
        }
    }    
}

• System>Clock Control:

  • Clock Source: HFINTOSC

  • HF Internal Clock: 64 MHz

• System>Pins:

  • Pin Grid View: Select LED1 pin as output (Check the schematic for your board)

  • Pins: Rename Custom Name to "LED1"

  • Pin Grid View: Select LED2 pin as output (Check the schematic for your board)

  • Pins: Rename Custom Name to "LED2"

• Drivers>Timer:

  • Timer PLIB Selector: TMR0

  • Timer Enable: False

  • Interrupt Driven: True

  • Requested Period: 1 ms

#include "mcc_generated_files/system/system.h"

/*
 * Development Board: PIC18F57Q43 Curiosity Nano Board
 * MCC Configuration:
 *     System module: HFINTOSC (64 MHz)
 *     Timer module: Timer PLIB Selector - TMR0, Timer Enable - False, Interrupt Driven - True, Requested Timer Period - 1 ms
 *     Pins module: RF2, RF3 - GPIO Output, CustomName - RF2->LED1, RF3->LED2 
 */

static void Task_A_2ms(void)
{
    LED1_SetHigh();
    NOP();
    NOP();
    LED1_SetLow();
    
    // Add your code here. E.g., LED Toggle
}
static void Task_B_5ms(void)
{
    LED2_SetHigh();
    NOP();
    NOP();
    LED2_SetLow();  
    
    // Add your code here. E.g., Read Sensor
}
static void Tasks_Scheduler(void)
{
    static volatile uint8_t oneMs_tickCounter =  0;
    
    oneMs_tickCounter++;
            
    if((oneMs_tickCounter % 2U) == 0U)
    {
        Task_A_2ms();    // Run at 2 ms, 4 ms, 6 ms, 8 ms, and 10 ms.
    }
    
    if((oneMs_tickCounter % 5U) == 0U)
    {
        Task_B_5ms();    // Run at 5 ms and 10 ms.
    }
    if(oneMs_tickCounter == 10U)
    {
        oneMs_tickCounter = 0;
    }
}

int main(void)
{
    const struct TIMER_INTERFACE *Timer = &Timer0;

    SYSTEM_Initialize();
 
    Timer->TimeoutCallbackRegister(Tasks_Scheduler);
    Timer->Start();
    
    // Enable the Global Interrupts 
    INTERRUPT_GlobalInterruptEnable(); 

    while(1)
    {
    }    
}

• System>Clock Control:

  • Clock Source: HFINTOSC

  • HF Internal Clock: 64 MHz

• System>Pins:

  • Pin Grid View: Select LED pin as output (Check the schematic for your board)

  • Pins: Rename Custom Name to "LED"

• Drivers>Timer:

  • Timer PLIB Selector: TMR0

  • Timer Enable: False

  • Interrupt Driven: True

  • Requested Period: 10 ms

#include "mcc_generated_files/system/system.h"

/*
* Development Board: PIC18F57Q43 Curiosity Nano Board
* MCC Configuration:
*     Clock Control: HFINTOSC (64 MHz)
*     Timer module: Timer PLIB Selector - TMR0, Timer Enable - False, Interrupt Driven - True, Requested Timer Period - 10 ms 
*     TMR0 module: Timer_PeriodSet() API Range - [250 ns - 16.384 ms] (read-only)
*     Pins module: RF3 - GPIO Output, CustomName - LED 
*/
 
#define TIMER_TICK_FREQ TMR0_CLOCK_FREQ
#define MS_TO_TICKS(ms) (((TIMER_TICK_FREQ * (ms)) / 1000UL) - 1UL)
#define LED_4_MS MS_TO_TICKS(4UL)        // Set the period to be within the PeriodSet API range
#define LED_8_MS MS_TO_TICKS(8UL)

static const struct TIMER_INTERFACE *Timer = &Timer0;
static void Timer_PeriodChange(void)
{ 
    static volatile bool changePeriod = false;
    LED_Toggle();
    Timer->Stop();
    
    uint32_t maxCount = Timer->MaxCountGet();
    uint32_t newPeriod = changePeriod ? LED_4_MS : LED_8_MS;
    
    if(maxCount > newPeriod)
    {     
        Timer->PeriodSet(newPeriod);
    }
    else
    {
        // Invalid period       
    }
    
    changePeriod = !changePeriod;
    Timer->Start();
}

int main(void)
{
    SYSTEM_Initialize();
    
    Timer->PeriodSet(LED_4_MS);
    Timer->TimeoutCallbackRegister(Timer_PeriodChange);
    Timer->Start();
    
    // Enable the Global Interrupts 
    INTERRUPT_GlobalInterruptEnable(); 
    
    while(1)
    {
    }    
}

• System>Clock Control:

  • Clock Source: HFINTOSC

  • HF Internal Clock: 64 MHz

• System>Pins:

  • Pin Grid View: Select LED pin as output (Check the schematic for your board)

  • Pins: Rename Custom Name to "LED"

• Drivers>Timer:

  • Timer PLIB Selector: TMR0

  • Timer Enable: False

  • Interrupt Driven: False

  • Requested Period: 500 ms

#include "mcc_generated_files/system/system.h"

/*
* Development Board: PIC18F57Q43 Curiosity Nano Board
* MCC Configuration:
*     Clock Control: HFINTOSC (64 MHz)
*     Timer module: Timer PLIB Selector - TMR0, Timer Enable - False, Interrupt Driven - False, Requested Timer Period - 500 ms 
*     Pins module: RF3 - GPIO Output, CustomName - LED 
*/

static void Timer_Callback(void)
{
    LED_Toggle();   
}

int main(void)
{
    SYSTEM_Initialize();

    Timer0.TimeoutCallbackRegister(Timer_Callback);
    Timer0.Start();
    while(1)
    {
        Timer0.Tasks();
    }    
}