第一次提交

2026-05-29 17:36:34 +08:00
commit 5b3333125d
1318 changed files with 722705 additions and 0 deletions
@@ -0,0 +1,107 @@
+#include "bsp_pwm.h"
+#include "stdlib.h"
+#include "memory.h"
+
+// 配合中断以及初始化
+static uint8_t idx;
+static PWMInstance *pwm_instance[PWM_DEVICE_CNT] = {NULL}; // 所有的pwm instance保存于此,用于callback时判断中断来源
+static uint32_t PWMSelectTclk(TIM_HandleTypeDef *htim );
+/**
+ * @brief pwm dma传输完成回调函数
+ *
+ * @param htim 发生中断的定时器句柄
+ */
+void HAL_TIM_PWM_PulseFinishedCallback(TIM_HandleTypeDef *htim)
+{
+    for (uint8_t i = 0; i < idx; i++)
+    { // 来自同一个定时器的中断且通道相同
+        if (pwm_instance[i]->htim == htim && htim->Channel == (1<<(pwm_instance[i]->channel/4)))
+        {
+            if (pwm_instance[i]->callback) // 如果有回调函数
+                pwm_instance[i]->callback(pwm_instance[i]);
+            return; // 一次只能有一个通道的中断,所以直接返回
+        }
+    }
+}
+
+PWMInstance *PWMRegister(PWM_Init_Config_s *config)
+{
+    if (idx >= PWM_DEVICE_CNT) // 超过最大实例数,考虑增加或查看是否有内存泄漏
+        while (1)
+            ;
+    PWMInstance *pwm = (PWMInstance *)malloc(sizeof(PWMInstance));
+    memset(pwm, 0, sizeof(PWMInstance));
+
+    pwm->htim = config->htim;
+    pwm->channel = config->channel;
+    pwm->period = config->period;
+    pwm->dutyratio = config->dutyratio;
+    pwm->callback = config->callback;
+    pwm->id = config->id;
+    pwm->tclk = PWMSelectTclk(pwm->htim);
+    // 启动PWM
+    HAL_TIM_PWM_Start(pwm->htim, pwm->channel);
+    PWMSetPeriod(pwm, pwm->period);
+    PWMSetDutyRatio(pwm, pwm->dutyratio);
+    pwm_instance[idx++] = pwm;
+    return pwm;
+}
+
+/* 只是对HAL的函数进行了形式上的封装 */
+void PWMStart(PWMInstance *pwm)
+{
+    HAL_TIM_PWM_Start(pwm->htim, pwm->channel);
+}
+
+/* 只是对HAL的函数进行了形式上的封装 */
+void PWMStop(PWMInstance *pwm)
+{
+    HAL_TIM_PWM_Stop(pwm->htim, pwm->channel);
+}
+
+/*
+ * @brief 设置pwm周期
+ *
+ * @param pwm pwm实例
+ * @param period 周期 单位 s
+ */
+void PWMSetPeriod(PWMInstance *pwm, float period)
+{
+    __HAL_TIM_SetAutoreload(pwm->htim, period*((pwm->tclk)/(pwm->htim->Init.Prescaler+1)));
+}
+/*
+    * @brief 设置pwm占空比
+    *
+    * @param pwm pwm实例
+    * @param dutyratio 占空比 0~1
+*/
+void PWMSetDutyRatio(PWMInstance *pwm, float dutyratio)
+{
+    __HAL_TIM_SetCompare(pwm->htim, pwm->channel, dutyratio * (pwm->htim->Instance->ARR));
+}
+
+/* 只是对HAL的函数进行了形式上的封装 */
+void PWMStartDMA(PWMInstance *pwm, uint32_t *pData, uint32_t Size)
+{
+    HAL_TIM_PWM_Start_DMA(pwm->htim, pwm->channel, pData, Size);
+}
+
+// 设置pwm对应定时器时钟源频率
+static uint32_t PWMSelectTclk(TIM_HandleTypeDef *htim)
+{
+    uintptr_t tclk_temp = ((uintptr_t)((htim)->Instance));
+
+    // 判断是否为 APB1 定时器 (TIM2~TIM7, TIM12~TIM14)
+    if ((tclk_temp >= (APB1PERIPH_BASE + 0x0000UL)) &&
+        (tclk_temp <= (APB1PERIPH_BASE + 0x83FFUL))) // 根据芯片参考手册调整范围
+    {
+        return (HAL_RCC_GetPCLK1Freq() * ((RCC->D1CFGR & RCC_D1CFGR_HPRE) == 0 ? 1 : 2));
+    }
+    // 判断是否为 APB2 定时器 (TIM1, TIM8)
+    else if ((tclk_temp >= (APB2PERIPH_BASE + 0x0000UL)) &&
+             (tclk_temp <= (APB2PERIPH_BASE + 0x03FFUL))) // 根据芯片参考手册调整范围
+    {
+        return (HAL_RCC_GetPCLK2Freq() * ((RCC->D1CFGR & RCC_D1CFGR_HPRE) == 0 ? 1 : 2));
+    }
+    return 0;
+}
@@ -0,0 +1,91 @@
+/**
+ * @file bsp_pwm.h
+ * @author your name (you@domain.com)
+ * @brief 
+ * @version 0.1
+ * @date 2023-02-14
+ * 
+ * @copyright Copyright (c) 2023
+ * 
+ */
+
+#ifndef BSP_PWM_H
+#define BSP_PWM_H
+
+#include "tim.h"
+#include "stdint.h"
+#include "stm32h7xx_hal_rcc.h"
+#include "stm32h723xx.h"
+#define PWM_DEVICE_CNT 16 // 最大支持的PWM实例数量
+
+/* pwm实例结构体 */
+typedef struct pwm_ins_temp
+{
+    TIM_HandleTypeDef *htim;                 // TIM句柄
+    uint32_t channel;                        // 通道
+    uint32_t tclk;                           // 时钟频率
+    float period;                         // 周期
+    float dutyratio;                      // 占空比
+    void (*callback)(struct pwm_ins_temp *); // DMA传输完成回调函数
+    void *id;                                // 实例ID
+} PWMInstance;
+
+typedef struct
+{
+    TIM_HandleTypeDef *htim;                 // TIM句柄
+    uint32_t channel;                        // 通道
+    float period;                         // 周期
+    float dutyratio;                      // 占空比
+    void (*callback)(PWMInstance*); // DMA传输完成回调函数
+    void *id;                                // 实例ID
+} PWM_Init_Config_s;
+
+/**
+ * @brief 注册一个pwm实例
+ *
+ * @param config 初始化配置
+ * @return PWMInstance*
+ */
+PWMInstance *PWMRegister(PWM_Init_Config_s *config);
+
+/**
+ * @brief 启动pwm
+ *
+ * @param pwm pwm实例
+ */
+void PWMStart(PWMInstance *pwm);
+/**
+ * @brief 设置pwm占空比
+ *
+ * @param pwm pwm实例
+ * @param dutyratio 占空比 0~1
+ */
+
+void PWMSetDutyRatio(PWMInstance *pwm, float dutyratio);
+/**
+ * @brief 停止pwm
+ *
+ * @param pwm pwm实例
+ */
+void PWMStop(PWMInstance *pwm);
+
+/**
+ * @brief 设置pwm周期
+ *
+ * @param pwm pwm实例
+ * @param period 周期 单位 s
+ */
+void PWMSetPeriod(PWMInstance *pwm, float period);
+
+/**
+ * @brief 启动pwm dma传输
+ *
+ * @param pwm pwm实例
+ * @param pData 数据首地址指针,注意数据的位数必须和CubeMX配置的DMA传输位数(字长)一致
+ * @param Size 数据长度
+ * @note 如果使用此函数,则需要在CubeMX中配置DMA传输位数为对应位数
+ *       例如:使用16位数据,则需要配置DMA传输位数为16位(half word),配置错误会导致指针越界或数据错误
+ */
+void PWMStartDMA(PWMInstance *pwm, uint32_t *pData, uint32_t Size);
+
+#endif // BSP_PWM_H
@@ -0,0 +1,5 @@
+# bsp pwm
+
+同一定时器下的pwm通道更改周期时请注意该定时器下是否有其他pwm示例，如果有请注意不要影响其他pwm通道的周期。
+使用pwm dma传输中断时注意占空比的设置，设为0将不会进入中断函数
+默认tim psc已在cubemx设置好，详情可参考cubemx配置文件