【M61笔记】PWM

**M61 模组是 BL618 芯片，基于 LHAL 库****只支持 PWM\_V2****，该 PWM 版本支持四个 PWM 通道。** **PWM 频率：** **一秒钟内，信号完整的从高电平到低电平的次数（完整的一个脉冲周期），单位是 Hz。1Hz 也就是一秒钟一个脉冲周期，周期是 1000ms。** **PWM 周期：** **周期=1/频率，也就是周期与频率互为倒数，单位一般是 ms，若频率为 5Hz，周期也就是 1/5=0.2S=200ms。** **PWM 占空比：** 一个脉冲周期内，高电平的时间占整个周期时间的比例。单位是 %，高电平时间是 50ms，周期是 100ms。占空比就是 50/100\*100%=50%。 **(\*\*\*\*)以下没懂，多了解** **PWM V2 版本输出有效极性。当正向通道阈值位于设置的低阈值和高阈值之间，为有效极性，如果设置有效极性为高，则输出高电平，反之输出低电平。反向通道相反，阈值位于设置的低阈值和高阈值之外，为有效极性，如果设置有效极性为高，则输出高电平，反之输出低电平。** ```c // bflb_pwm_v2.h /** @defgroup 极性定义 (PWM_POLARITY pwm polarity definition) * @{ */ #define PWM_POLARITY_ACTIVE_LOW 0 #define PWM_POLARITY_ACTIVE_HIGH 1 ``` ## PWM配置 ### bflb\_pwm\_v2\_config\_s PWM**初始化配置结构体** **pwm\_v2 初始化配置结构体** **PWM 最终产生的频率为 clk\_source/clk\_div/period** ```c /**bflb_pwm_v2.h * @brief PWM配置结构 * * @param clk_source PWM时钟源, use @ref BFLB_SYSTEM_CLOCK bflb_clock.h * @param clk_div PWM时钟分频器，应在1~65535 * @param period PWM周期数，应在2~65535 */ struct bflb_pwm_v2_config_s { uint8_t clk_source; uint16_t clk_div; uint16_t period; }; ``` **clk\_source 时钟源选择范围 可选 2，3，4** ```c /** bflb_pwm_v2.h * @defgroup BFLB_SYSTEM_CLOCK 系统时钟定义 * @{ */ #define BFLB_SYSTEM_ROOT_CLOCK 0 #define BFLB_SYSTEM_CPU_CLK 1 #define BFLB_SYSTEM_PBCLK 2 #define BFLB_SYSTEM_XCLK 3 // 40MHz #define BFLB_SYSTEM_32K_CLK 4 ``` ### bflb\_pwm\_v2\_channel\_config\_s **通道初始化配置结构体** **通道初始化配置结构体** ```c /**bflb_pwm_v2.h * @brief PWM通道配置结构 * * @param positive_polarity 正向输出极性PWM posotive channel polarity, use @ref PWM_POLARITY * @param negative_polarity 反向输出极性PWM negative channel polarity, use @ref PWM_POLARITY * @param positive_stop_state 正向输出空闲状态 PWM posotive channel state when stop, use @ref PWM_STATE * @param negative_stop_state 反向输出空闲状态 channel state when stop, use @ref PWM_STATE * @param positive_brake_state 正向输出刹车状态PWM posotive channel state when brake, use @ref PWM_STATE * @param negative_brake_state 反向输出刹车状态PWM negative channel state when brake, use @ref PWM_STATE * @param dead_time 死区时间PWM channel dead time */ struct bflb_pwm_v2_channel_config_s { uint8_t positive_polarity; uint8_t negative_polarity; uint8_t positive_stop_state; uint8_t negative_stop_state; uint8_t positive_brake_state; uint8_t negative_brake_state; uint8_t dead_time; }; ``` ## PWM函数 ### bflb\_pwm\_v2\_init **初始化 pwm** **初始化 pwm。使用之前需要选择 gpio 为 pwm 功能。** ```c /**bflb_pwm_v2.h * @brief 初始化PWM * * @param [in] dev 设备句柄 * @param [in] config 配置项 用于保存PWM配置的指针 */ void bflb_pwm_v2_init(struct bflb_device_s *dev, const struct bflb_pwm_v2_config_s *config); ``` ### bflb\_pwm\_v2\_deinit **复位 pwm** **复位 pwm** ```c /**bflb_pwm_v2.h * @brief 复位PWM * * @param [in] dev 设备句柄 */ void bflb_pwm_v2_deinit(struct bflb_device_s *dev); ``` ### bflb\_pwm\_v2\_start **启动 pwm 输出** **启动 pwm 输出** ```c /**bflb_pwm_v2.h * @brief 启动PWM输出 * * @param [in] dev 设备句柄 */ void bflb_pwm_v2_start(struct bflb_device_s *dev); ``` ### bflb\_pwm\_v2\_stop **关闭 pwm 输出** **关闭 pwm 输出** ```cpp /**bflb_pwm_v2.h * @brief 关闭PWM输出 * * @param [in] dev 设备句柄 */ void bflb_pwm_v2_stop(struct bflb_device_s *dev); ``` ### bflb\_pwm\_v2\_set\_period **修改 pwm 周期值，从而更改 pwm 输出的频率** ```c /**bflb_pwm_v2.h * @brief 设置 pwm 周期以更改 pwm 频率。频率（hz） = pwm 源时钟 /div/period。 Set pwm period to change pwm frequence. Frequcence(hz) = pwm source clock /div/period. * * @param [in] dev 设备句柄 * @param [in] period PWM周期 */ void bflb_pwm_v2_set_period(struct bflb_device_s *dev, uint16_t period); ``` ### bflb\_pwm\_v2\_get\_frequency 获取频率 ```cpp /**bflb_pwm_v2.h * @brief 获取PWM频率. * * @param [in] dev 设备句柄 * @return 频率 */ float bflb_pwm_v2_get_frequency(struct bflb_device_s *dev); ``` ### bflb\_pwm\_v2\_channel\_init **PWM 通道初始化** ```cpp /**bflb_pwm_v2.h * @brief 配置通道 * * @param [in] dev 设备句柄 * @param [in] ch 通道号 * @param [in] config 通道配置 */ void bflb_pwm_v2_channel_init(struct bflb_device_s *dev, uint8_t ch, struct bflb_pwm_v2_channel_config_s *config); ``` ### bflb\_pwm\_v2\_channel\_set\_threshold **设置 PWM 占空比** **设置 PWM 占空比。** **PWM 占空比=（high\_threhold - low\_threhold）/period周期** ```cpp /**bflb_pwm_v2.h * @brief * * @param [in] dev 设备句柄 * @param [in] ch 通道号 * @param [in] low_threhold 低阈值 * @param [in] high_threhold 高阈值,需要大于 low_threhold，并且小于等于周期 */ void bflb_pwm_v2_channel_set_threshold(struct bflb_device_s *dev, uint8_t ch, uint16_t low_threhold, uint16_t high_threhold); ``` ### bflb\_pwm\_v2\_channel\_positive\_start **PWM 正向通道使能输出** **正向通道使能输出** ```cpp /**bflb_pwm_v2.h * @brief PWM 正向通道使能输出 * * @param [in] dev 设备句柄 * @param [in] ch 通道号 */ void bflb_pwm_v2_channel_positive_start(struct bflb_device_s *dev, uint8_t ch); ``` ### bflb\_pwm\_v2\_channel\_negative\_start **PWM 反向通道使能输出** **PWM 反向通道使能输出** ```cpp /**bflb_pwm_v2.h * @brief PWM 反向通道使能输出 * * @param [in] dev 设备句柄 * @param [in] ch 通道号 */ void bflb_pwm_v2_channel_negative_start(struct bflb_device_s *dev, uint8_t ch); ``` ### bflb\_pwm\_v2\_channel\_positive\_stop **PWM 正向通道停止输出** **PWM 正向通道停止输出** ```cpp /**bflb_pwm_v2.h * @brief PWM 正向通道停止输出 * * @param [in] dev 设备句柄 * @param [in] ch 通道号 */ void bflb_pwm_v2_channel_positive_stop(struct bflb_device_s *dev, uint8_t ch); ``` ### bflb\_pwm\_v2\_channel\_negative\_stop **PWM 反向通道停止输出** ```c /**bflb_pwm_v2.h * @brief PWM 反向通道停止输出 * * @param [in] dev 设备句柄 * @param [in] ch 通道号 */ void bflb_pwm_v2_channel_negative_stop(struct bflb_device_s *dev, uint8_t ch); ``` ### bflb\_pwm\_v2\_int\_enable **PWM 中断使能和关闭。** **PWM 中断使能和关闭。** ```cpp /**bflb_pwm_v2.h * @brief PWM 中断使能和关闭 * * @param [in] dev 设备句柄 * @param [in] int_en 中断类型 * @param [in] enable true 表示启用，否则禁用 */ void bflb_pwm_v2_int_enable(struct bflb_device_s *dev, uint32_t int_en, bool enable); ``` **int\_en可以填入以下值，多个中断可以使用 | 连接** ```cpp /** bflb_pwm_v2.h * @defgroup PWM_INTEN PWM 中断使能定义 * @{ */ #define PWM_INTEN_CH0_L (1 << 0) #define PWM_INTEN_CH0_H (1 << 1) #define PWM_INTEN_CH1_L (1 << 2) #define PWM_INTEN_CH1_H (1 << 3) #define PWM_INTEN_CH2_L (1 << 4) #define PWM_INTEN_CH2_H (1 << 5) #define PWM_INTEN_CH3_L (1 << 6) #define PWM_INTEN_CH3_H (1 << 7) #define PWM_INTEN_PERIOD (1 << 8) #define PWM_INTEN_BRAKE (1 << 9) #define PWM_INTEN_REPT (1 << 10) ``` ### bflb\_pwm\_v2\_get\_intstatus **获取 PWM 中断标志** **获取 PWM 中断标志** ```cpp /**bflb_pwm_v2.h * @brief 获取 PWM 中断标志 * * @param [in] dev 设备句柄 * @return 返回中断标志, use @ref PWM_INTSTS */ uint32_t bflb_pwm_v2_get_intstatus(struct bflb_device_s *dev); ``` **返回值如下：** ```cpp /** bflb_pwm_v2.h @defgroup PWM_INTSTS PWM 中断状态定义 pwm interrupt status definition * @{ */ #define PWM_INTSTS_CH0_L (1 << 0) #define PWM_INTSTS_CH0_H (1 << 1) #define PWM_INTSTS_CH1_L (1 << 2) #define PWM_INTSTS_CH1_H (1 << 3) #define PWM_INTSTS_CH2_L (1 << 4) #define PWM_INTSTS_CH2_H (1 << 5) #define PWM_INTSTS_CH3_L (1 << 6) #define PWM_INTSTS_CH3_H (1 << 7) #define PWM_INTSTS_PERIOD (1 << 8) #define PWM_INTSTS_BRAKE (1 << 9) #define PWM_INTSTS_REPT (1 << 10) ``` ### bflb\_pwm\_v2\_int\_clear **清除 PWM 中断标志** ```cpp /**bflb_pwm_v2.h * @brief 清除 PWM 中断标志 * * @param [in] dev 设备句柄 * @param [in] int_clear 清除值, use @ref PWM_INTCLR */ void bflb_pwm_v2_int_clear(struct bflb_device_s *dev, uint32_t int_clear); ``` **int\_clear 可以填入以下参数:** ```cpp /** bflb_pwm_v2.h @defgroup PWM_INTCLR PWM 中断清除定义 pwm interrupt clear definition * @{ */ #define PWM_INTCLR_CH0_L (1 << 0) #define PWM_INTCLR_CH0_H (1 << 1) #define PWM_INTCLR_CH1_L (1 << 2) #define PWM_INTCLR_CH1_H (1 << 3) #define PWM_INTCLR_CH2_L (1 << 4) #define PWM_INTCLR_CH2_H (1 << 5) #define PWM_INTCLR_CH3_L (1 << 6) #define PWM_INTCLR_CH3_H (1 << 7) #define PWM_INTCLR_PERIOD (1 << 8) #define PWM_INTCLR_BRAKE (1 << 9) #define PWM_INTCLR_REPT (1 << 10) ``` ### bflb\_pwm\_v2\_feature\_control **PWM 其他特性相关控制，一般不常用** **其他特性相关控制，一般不常用。** ```cpp /**bflb_pwm_v2.h * @brief Control pwm feature. * * @param [in] dev 设备句柄 * @param [in] cmd feature command, use @ref PWM_CMD * @param [in] arg user data * @return A negated errno value on failure. */ int bflb_pwm_v2_feature_control(struct bflb_device_s *dev, int cmd, size_t arg); ``` **cmd **可以填入以下参数: ```cpp /** bflb_pwm_v2.h @defgroup PWM_CMD PWM 特征控制 CMD 定义 pwm feature control cmd definition * @{ */ #define PWM_CMD_SET_TRIG_ADC_SRC (0x01) #define PWM_CMD_SET_EXT_BRAKE_POLARITY (0x02) #define PWM_CMD_SET_EXT_BRAKE_ENABLE (0x03) #define PWM_CMD_SET_SW_BRAKE_ENABLE (0x04) #define PWM_CMD_SET_STOP_ON_REPT (0x05) #define PWM_CMD_SET_REPT_COUNT (0x06) ``` ## 示例 ```c #include "bflb_mtimer.h" //mtimer定时器头文件 #include "bflb_pwm_v2.h" //pwm_v2头文件 #include "bflb_clock.h" //系统时钟头文件 #include "board.h" //开发板头文件，包装的库 #include "bflb_gpio.h" //gpio头文件 struct bflb_device_s *pwm; //创建LHAL外设库结构体，名称为pwm struct bflb_device_s *gpio; //创建LHAL外设库结构体，名称为gpio int main(void) { int i; //临时变量i，作为改变占空比的变量 board_init(); //板子初始化 gpio = bflb_device_get_by_name("gpio"); //选择IO15作为pwm输出， // PWM 复用 上拉 滤波 输出能力1 bflb_gpio_init(gpio, GPIO_PIN_15, GPIO_FUNC_PWM0 | GPIO_ALTERNATE | GPIO_PULLUP | GPIO_SMT_EN | GPIO_DRV_1); pwm = bflb_device_get_by_name("pwm_v2_0"); //给外设接口赋名pwm_v2_0 /* period = .XCLK / .clk_div / .period = 40MHz / 40 / 1000 = 1KHz */ struct bflb_pwm_v2_config_s cfg = { .clk_source = BFLB_SYSTEM_XCLK, // 时钟源40M .clk_div = 40, // 分频数 .period = 1000, // 周期 };//设置PWM的频率，选择时钟，分频，和周期。根据上面的公式算出最终的频率。 /*初始化PWM输出*/ bflb_pwm_v2_init(pwm, &cfg); bflb_pwm_v2_start(pwm); //将设置好的频率开启pwm输出 while (1) { //蓝灯呼吸亮灭 // 正向通道使能输出 bflb_pwm_v2_channel_positive_start(pwm, PWM_CH3); // 需要看数据手册确定通道 for(i=150;i>0;i--) { /**bflb_pwm_v2.h * @param [in] dev 设备句柄 * @param [in] ch 通道号 * @param [in] low_threhold 低阈值 * @param [in] high_threhold 高阈值,需要大于 low_threhold，并且小于等于周期 * PWM 占空比=（high_threhold - low_threhold）/period周期 * bflb_pwm_v2_channel_set_threshold */ bflb_pwm_v2_channel_set_threshold(pwm, PWM_CH3, i, 150); //改变占空比，变量i会不断变化 bflb_mtimer_delay_ms(10); } for(i=1;i<150;i++) { bflb_pwm_v2_channel_set_threshold(pwm, PWM_CH3, i, 150); bflb_mtimer_delay_ms(10); } bflb_pwm_v2_channel_positive_stop(pwm, PWM_CH3); } } ```

很棒

赞

赞

民间文档

实力强大