ATY_LIB/FwLib_STC8/src/fw_tim.c

// Copyright 2021 IOsetting <iosetting(at)outlook.com>
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

#include "fw_tim.h"
#include "fw_sys.h"
#include "fw_util.h"

/**
 * Calculate the initial value of Timer0 & Timer1 counter
 * - If the frequency is too high, it will return the value of `limit`, so the timer
 *   will run in the highest frequency
 * - If the frequency is too low, it will return 0, so the timer will run in the 
 *   lowest possible frequency
*/
int16_t TIM_Timer0n1_CalculateInitValue(uint16_t frequency, HAL_State_t freq1t, uint16_t limit)
{
    uint32_t value = __SYSCLOCK;
    if (!freq1t)
        value = value / 12;
    value = value / frequency;
    if (value > limit)
        return 0;
    else
        return limit - value;
}

void TIM_Timer0_Config(HAL_State_t freq1t, TIM_TimerMode_t mode, uint16_t frequency)
{
    uint16_t init;
    TIM_Timer0_Set1TMode(freq1t);
    TIM_Timer0_SetMode(mode);
    if (mode == TIM_TimerMode_8BitAuto)
    {
        init = TIM_Timer0n1_CalculateInitValue(frequency, freq1t, 0xFF);
        TIM_Timer0_SetInitValue(init & 0xFF, init & 0xFF);
    }
    else
    {
        init = TIM_Timer0n1_CalculateInitValue(frequency, freq1t, 0xFFFF);
        TIM_Timer0_SetInitValue(init >> 8, init & 0xFF);
    }
}

void TIM_Timer1_Config(HAL_State_t freq1t, TIM_TimerMode_t mode, uint16_t frequency)
{
    uint16_t init;
    TIM_Timer1_Set1TMode(freq1t);
    TIM_Timer1_SetMode(mode);
    if (mode == TIM_TimerMode_8BitAuto)
    {
        init = TIM_Timer0n1_CalculateInitValue(frequency, freq1t, 0xFF);
        TIM_Timer1_SetInitValue(init & 0xFF, init & 0xFF);
    }
    else
    {
        init = TIM_Timer0n1_CalculateInitValue(frequency, freq1t, 0xFF);
        TIM_Timer1_SetInitValue(init >> 8, init & 0xFF);
    }
}

int16_t _TIM_Timer234_InitValueCalculate(
    uint16_t frequency, uint8_t prescaler, HAL_State_t freq1t)
{
    uint32_t value = __SYSCLOCK;
    if (!freq1t)
        value = value / 12;
    value = value / ((prescaler + 1) * frequency);

    if (value > 0xFFFF)
        return 0;
    else
        return 0xFFFF - value;
}

/**
 * Timer2,3,4 Configuration
 * 
 * 1. no interrupt priority
 * 2. frequency = SYSCLK / (TMxPS + 1) / (0xFFFF - TxH,TxL) / (1T? 1 : 12)
*/

void TIM_Timer2_Config(HAL_State_t freq1t, uint8_t prescaler, uint16_t frequency)
{
    uint16_t init = _TIM_Timer234_InitValueCalculate(frequency, prescaler, freq1t);
    TIM_Timer2_Set1TMode(freq1t);
    TIM_Timer2_SetPreScaler(prescaler);
    TIM_Timer2_SetInitValue(init >> 8, init & 0xFF);
}

void TIM_Timer3_Config(
    HAL_State_t freq1t, uint8_t prescaler, uint16_t frequency, HAL_State_t intState)
{
    uint16_t init = _TIM_Timer234_InitValueCalculate(frequency, prescaler, freq1t);
    TIM_Timer3_Set1TMode(freq1t);
    TIM_Timer3_SetPreScaler(prescaler);
    TIM_Timer3_SetInitValue(init >> 8, init & 0xFF);
    EXTI_Timer3_SetIntState(intState);
}

void TIM_Timer4_Config(
    HAL_State_t freq1t, uint8_t prescaler, uint16_t frequency, HAL_State_t intState)
{
    uint16_t init = _TIM_Timer234_InitValueCalculate(frequency, prescaler, freq1t);
    TIM_Timer4_Set1TMode(freq1t);
    TIM_Timer4_SetPreScaler(prescaler);
    TIM_Timer4_SetInitValue(init >> 8, init & 0xFF);
    EXTI_Timer4_SetIntState(intState);
}