/**
 * @file pwms.h
 * @brief Header file for PWMs module.
 *
 * This file contains the declarations and documentation for the PWMs module.
 *
 * @author xxx
 * @date 2023-12-27 14:44:03
 * @version 1.0
 * @copyright Copyright (c) 2024 by xxx, All Rights Reserved.
 */
#ifndef __PWMS_H__
#define __PWMS_H__
#include "lib.h"

/**
 * @brief  Starts the PWM for a specific channel
 * @param  TIMx: TIM instance
 * @param  CHx: Channel to be started
 * @retval None
 */
#define PWM_START(TIMx, CHx)                \
    do                                      \
    {                                       \
        LL_TIM_EnableCounter(TIMx);         \
        LL_TIM_CC_EnableChannel(TIMx, CHx); \
    } while (__LINE__ == -1)

/**
 * @brief  Stops the PWM for a specific channel
 * @param  TIMx: TIM instance
 * @param  CHx: Channel to be stopped
 * @retval None
 */
#define PWM_STOP(TIMx, CHx)                  \
    do                                       \
    {                                        \
        LL_TIM_DisableCounter(TIMx);         \
        LL_TIM_CC_DisableChannel(TIMx, CHx); \
    } while (__LINE__ == -1)

/**
 * @brief  Sets the PWM frequency
 * @param  TIMx: TIM instance
 * @param  CHx: Channel to be set
 * @param  COMPARE: Compare value
 * @retval None
 */
static inline void PWM_SET_COMPARE(TIM_TypeDef *TIMx, uint32_t CHx, uint16_t COMPARE)
{
    switch (CHx)
    {
    case LL_TIM_CHANNEL_CH1:
        LL_TIM_OC_SetCompareCH1(TIMx, COMPARE);
        break;
    case LL_TIM_CHANNEL_CH2:
        LL_TIM_OC_SetCompareCH2(TIMx, COMPARE);
        break;
    case LL_TIM_CHANNEL_CH3:
        LL_TIM_OC_SetCompareCH3(TIMx, COMPARE);
        break;
    case LL_TIM_CHANNEL_CH4:
        LL_TIM_OC_SetCompareCH4(TIMx, COMPARE);
        break;
    default:
        break;
    }
}

/**
 * @brief 设置PWM占空比
 *
 * 设置指定定时器TIMx的指定通道CHx的PWM占空比。
 *
 * @param TIMx 定时器类型，例如TIM1、TIM2等
 * @param CHx 通道号，例如TIM_CHANNEL_1、TIM_CHANNEL_2等
 * @param DUTY 占空比，范围在0到100之间
 */
static inline void PWM_SET_DUTY(TIM_TypeDef *TIMx, uint32_t CHx, uint16_t DUTY)
{
    PWM_SET_COMPARE(TIMx, CHx, DUTY * LL_TIM_GetAutoReload(TIMx) / 100);
}

// 获取当前频率
static inline uint32_t PWM_GET_FREQ(TIM_TypeDef *TIMx)
{
    return SystemCoreClock / (LL_TIM_GetPrescaler(TIMx) + 1) / (LL_TIM_GetAutoReload(TIMx) + 1);
}

#endif ///< __PWMS_H__