一、使用说明
目前我使用的是STM32L475系列单片机,是ali当时在PDD 50块钱卖的一个开发板,其他STM32单片机参考即可,这里会手把手教大家基于RTT Studio 来使用PWM。
二、创建工程
1.创建工程
首先大家打开RT-Thread Studio 来基于单片机创建工程。点击左上角文件,新建 RT-Thread项目
Project name就是项目名称,如果大家想自定义路径保存,就取消掉缺省位置然后自定义路径。
2.芯片参数设置
选择基于芯片,下面的参数需要大家根据自己的主板来选择,我这个板子 使用LPUART作为CMD输出,单片机型号,下载器比如JLINK或者STLINK等等都需要自己适配开发板。
3.下载设置
创建项目完成后大家可以先编译后下载进开发板测试一下 CMD的输出。
这里可以开启下载后自动软件复位。
4.编译 下载
大家在编译后就可以尝试下载。
我使用的工具是XShell,可以看到复位后有启动log输出,就正常啦。
三、修改时钟并配置串口
在创建工程的时候,RT-Thread Studio 默认使用的是内部低俗时钟,我们需要更改到外部高速时钟来提高MCU工作性能,后面PWM 的时钟外设也使用的是外部高速时钟。
1.打开CUBEMX
双击工程中的CUBEMX图标,可以打开cubemx,如果没有安装请自行安装。
2.打开高速时钟
打开CUBEmx的 System Core,选择RCC配置,将HSE与LSE均设置为Crystal/Ceramic Resonator,然后点击左上角文件保存。
3.配置时钟树
打开 Clock Configuration
锁相环PLL选择HSE,然后Clock Mux选择PLLCLK,PLLM数值选择合适的数值,这个一般都有参考,每种单片机时钟频率不同,大家可以搜索对应的时钟树设置。
4.打开LPUART
因为在创建工程时,默认打开了LPUART,但是使用cubemx获取代码后,LPUART是关闭的,我们需要重新打开LPUART。
首先在右侧选择 PB10与PB11 为LPUART外设,然后在左侧 Connectivity -LPUART外设中将Mode选择为Asynchronous 模式,就已经成功打开了。
5.获取代码
首先点击左上角文件 选择Save Project,然后点击右上角 Generate Code,代码获取完成后就可以关闭CubeMX了。
6.修改时钟定义
刚才Cubemx已经帮我们生成了时钟代码,但是代码需要我们手动加入到 BSP中,找到cubemx 里的src 然后打开main.c文件。
然后将 void SystemClock_Config(void) 这个函数内容复制到 drivers里的 drv_clk.c 文件中 void system_clock_config(void)。
7.编译下载
这时候时钟已经修改完成了,可以编译下载应该是没有错误的。
有一个reboot的调用警告,这是因为目前FINSH_FUNCTION_EXPORT_ALIAS 这个函数已经没有调用了,
MSH_CMD_EXPORT(reboot, Reboot System);
将这句代码替换掉上面的 FINSH_FUNCTION_EXPORT_ALIAS 即可。
四、配置PWM
1.使能PWM
首先打开RT-Thread Settings 打开PWM驱动。
选择组件,设备驱动程序,使能PWM,然后点击左上角保存。
2.配置时钟
配置时钟我们仍然需要使用CUBEMX工具,我目前要使用的PWM是A0引脚,将A0设置为TIM2的通道1
然后选择Timers 的TIM2 将通道1 设置为 比较输出模式。然后点击左上角保存,右上角获取代码。
3.修改驱动
这时候 CUBEMX已经帮我们生成了需要使用的代码,我们还需要将它修改到BSP里。
打开 cubemx的src文件夹,打开stm32l4xx_hal_msp.c,将以下三个函数的实现全部剪贴到drivers的board.c的最下面
void HAL_TIM_OC_MspInit(TIM_HandleTypeDef* htim_oc)
void HAL_TIM_MspPostInit(TIM_HandleTypeDef* htim)
void HAL_TIM_OC_MspDeInit(TIM_HandleTypeDef* htim_oc)
4.修改调用
打开drivers 里的 drv_pwm.c 找到 stm32_hw_pwm_init这个函数,在TIM初始化之前初始化以下时钟引脚。
在图里所示的位置调用这个函数。
HAL_TIM_OC_MspInit(tim);
5.配置PWM通道
这时候PWM的驱动就已经做好了,打开board.h ,打开需要使用的PWM通道
比如你使用的是TIM1,就是 pwm1, 通道同理。
#define BSP_USING_PWM2
#define BSP_USING_PWM2_CH1
6.保存编译
这时候我们需要使用的驱动已经全部构建完成了,接下来就使用RT-Thread的接口来完成用户代码吧。
五、用户代码
1.新建一个.c文件来存放用户代码,名字随便起,我放在了applications里,文件格式一定要加.c
2.PWM相关API
3.查找设备
rt_device_t rt_device_find(const char* name);
这个API会返回设备句柄
4.设置PWM参数
rt_err_t rt_pwm_set(struct rt_device_pwm *device,
int channel,rt_uint32_t period,rt_uint32_t pulse);
struct rt_device_pwm *device PWM设备句柄
int channel PWM通道数
rt_uint32_t period PWM周期,单位ns
rt_uint32_t pulse PWM脉冲宽度,单位ns
如果设置成功,会返回RT_EOK,
频率= 1000000000/period
占空比 = pulse/period
3.使能PWM通道
rt_err_t rt_pwm_enable(struct rt_device_pwm *device, int channel);
struct rt_device_pwm *device 这是设备句柄
int channel PWM通道数
如果使能正常的话会返回RT_EOK,其他错误就是使能失败。
3.PWM用户Demo
/*
Copyright (c) 2006-2021, RT-Thread Development Team
SPDX-License-Identifier: Apache-2.0
Change Logs:
Date Author Notes
2022-03-13 desktop the first version
/
#include
#include
//设置log文件
#define DBG_TAG 'pwm_test.c'
#define DBG_LVL DBG_LOG
#include
#define PWM_DEV_NAME 'pwm2' / PWM 设 备 名 称 */
#define PWM_DEV_CHANNEL 1
struct rt_device_pwm pwm_dev; / PWM 设 备 句 柄 /
static int pwm_test(void)
{
rt_uint32_t period , pulse;
//设置周期及 脉冲长度
period = 200000;
pulse = 100000;
pwm_dev = (struct rt_device_pwm )rt_device_find(PWM_DEV_NAME); //查找PWM设备
//配置PWM
rt_pwm_set(pwm_dev, PWM_DEV_CHANNEL, period, pulse); //占空比应该是50%
if (rt_pwm_enable(pwm_dev, PWM_DEV_CHANNEL) == RT_EOK)
{
LOG_D('PWM Init is ok tn');
return RT_EOK;
}
return RT_EOK;
}
MSH_CMD_EXPORT(pwm_test, pwm device sample);
代码注释基本上已经写清楚啦,我用的是TIM2的通道1,就是pwm2的通道1,大家可以参考这个Demo。
4.命令行调用
完成了代码,我们编译下载进单片机,打开命令行 输入help命令,可以将main中的log日志代码删除掉,不然会一直弹 Hello RT-Thread
可以看到help 显示的命令, pwm_test就是我们刚才用户代码的命令,
然后我用逻辑分析仪抓一下 PWM波形,应该是50%占空比。