RT-Thread硬件定时器HWTIMER实战在STM32F1上实现5秒周期任务附完整代码1. 环境准备与基础概念在开始硬件定时器的实战之前我们需要先了解一些基本概念和准备工作。RT-Thread的硬件定时器HWTIMER设备提供了一套统一的接口来访问芯片内部的硬件定时器使得开发者可以方便地实现精确的定时功能。硬件准备STM32F1系列开发板如正点原子MiniSTM32、野火指南者等USB转串口工具用于调试输出ST-Link或其他调试器可选用于程序下载和调试软件准备RT-Thread Studio或Keil MDK开发环境RT-Thread源码4.0.0或以上版本STM32CubeMX用于生成HAL库初始化代码硬件定时器与软件定时器的主要区别在于精度和资源占用。硬件定时器直接使用芯片内部的定时器外设具有更高的精度通常可达微秒级且不占用CPU资源而软件定时器基于系统tick实现精度受限于系统tick周期通常为1ms或10ms。2. 工程配置与硬件定时器初始化2.1 RT-Thread Settings配置首先我们需要在RT-Thread Settings中启用硬件定时器支持打开项目中的RT-Thread Settings配置文件在硬件选项卡下找到硬件定时器设备驱动勾选启用该选项保存配置系统会自动生成相应的宏定义2.2 board.h文件修改接下来我们需要在board.h文件中配置具体的定时器/* 硬件定时器配置 */ #define BSP_USING_TIM #define BSP_USING_TIM2 // 使用TIM2定时器注意根据实际使用的定时器修改宏定义例如使用TIM3则改为BSP_USING_TIM3。2.3 CubeMX配置使用STM32CubeMX进行定时器配置打开CubeMX加载对应芯片的配置文件在Timers选项卡中选择要使用的定时器如TIM2配置定时器参数Clock Source: Internal ClockPrescaler: 根据需求设置Counter Mode: UpPeriod: 自动重装载值其他参数保持默认生成代码将stm32f1xx_hal_msp.c中的HAL_TIM_Base_MspInit函数复制到board.c中常见问题解决如果编译报错函数重复定义删除board.c中已有的HAL_TIM_Base_MspInit函数确保stm32f1xx_hal_conf.h中HAL_TIM_MODULE_ENABLED宏已取消注释3. 硬件定时器应用开发3.1 定时器设备查找与初始化在main.c中我们首先需要查找并初始化定时器设备#include rtthread.h #include rtdevice.h #define HWTIMER_DEV_NAME timer2 // 定时器设备名称 static rt_device_t hw_dev RT_NULL; /* 查找并打开定时器设备 */ int hwtimer_init(void) { rt_err_t ret RT_EOK; /* 查找定时器设备 */ hw_dev rt_device_find(HWTIMER_DEV_NAME); if (hw_dev RT_NULL) { rt_kprintf(找不到 %s 设备!\n, HWTIMER_DEV_NAME); return -RT_ERROR; } /* 以读写方式打开设备 */ ret rt_device_open(hw_dev, RT_DEVICE_OFLAG_RDWR); if (ret ! RT_EOK) { rt_kprintf(打开 %s 设备失败!\n, HWTIMER_DEV_NAME); return ret; } return RT_EOK; }3.2 定时器回调函数实现定时器超时回调函数是定时器应用的核心部分需要注意以下几点回调函数中不能使用可能导致阻塞的函数如rt_thread_mdelay回调函数执行时间应尽可能短如果需要执行耗时操作建议使用消息队列或信号量通知其他线程处理/* 定时器超时回调函数 */ static rt_err_t timeout_cb(rt_device_t dev, rt_size_t size) { static rt_uint32_t count 0; rt_kprintf(定时器超时回调! 计数: %d\n, count); rt_kprintf(当前系统tick: %d\n, rt_tick_get()); return RT_EOK; }3.3 定时器参数配置与启动配置定时器参数并启动定时器int hwtimer_start(void) { rt_err_t ret RT_EOK; rt_hwtimerval_t timeout_s; rt_hwtimer_mode_t mode; rt_uint32_t freq 10000; // 计数频率10kHz /* 设置超时回调函数 */ rt_device_set_rx_indicate(hw_dev, timeout_cb); /* 设置计数频率 */ ret rt_device_control(hw_dev, HWTIMER_CTRL_FREQ_SET, freq); if (ret ! RT_EOK) { rt_kprintf(设置计数频率失败! 错误码: %d\n, ret); return ret; } /* 设置模式为周期性定时器 */ mode HWTIMER_MODE_PERIOD; ret rt_device_control(hw_dev, HWTIMER_CTRL_MODE_SET, mode); if (ret ! RT_EOK) { rt_kprintf(设置定时器模式失败! 错误码: %d\n, ret); return ret; } /* 设置定时器超时值为5s并启动定时器 */ timeout_s.sec 5; // 秒 timeout_s.usec 0; // 微秒 if (rt_device_write(hw_dev, 0, timeout_s, sizeof(timeout_s)) ! sizeof(timeout_s)) { rt_kprintf(设置超时值失败\n); return -RT_ERROR; } return RT_EOK; }4. 完整示例与调试技巧4.1 完整示例代码将上述代码整合并导出MSH命令#include rtthread.h #include rtdevice.h #define HWTIMER_DEV_NAME timer2 static rt_device_t hw_dev RT_NULL; /* 定时器超时回调函数 */ static rt_err_t timeout_cb(rt_device_t dev, rt_size_t size) { static rt_uint32_t count 0; rt_kprintf(定时器超时回调! 计数: %d\n, count); rt_kprintf(当前系统tick: %d\n, rt_tick_get()); return RT_EOK; } /* 硬件定时器示例 */ static int hwtimer_sample(int argc, char *argv[]) { rt_err_t ret RT_EOK; rt_hwtimerval_t timeout_s; rt_hwtimer_mode_t mode; rt_uint32_t freq 10000; /* 查找定时器设备 */ hw_dev rt_device_find(HWTIMER_DEV_NAME); if (hw_dev RT_NULL) { rt_kprintf(找不到 %s 设备!\n, HWTIMER_DEV_NAME); return -RT_ERROR; } /* 打开设备 */ ret rt_device_open(hw_dev, RT_DEVICE_OFLAG_RDWR); if (ret ! RT_EOK) { rt_kprintf(打开 %s 设备失败!\n, HWTIMER_DEV_NAME); return ret; } /* 设置回调函数 */ rt_device_set_rx_indicate(hw_dev, timeout_cb); /* 设置计数频率 */ ret rt_device_control(hw_dev, HWTIMER_CTRL_FREQ_SET, freq); if (ret ! RT_EOK) { rt_kprintf(设置计数频率失败! 错误码: %d\n, ret); goto __exit; } /* 设置模式为周期性定时器 */ mode HWTIMER_MODE_PERIOD; ret rt_device_control(hw_dev, HWTIMER_CTRL_MODE_SET, mode); if (ret ! RT_EOK) { rt_kprintf(设置定时器模式失败! 错误码: %d\n, ret); goto __exit; } /* 设置超时值并启动定时器 */ timeout_s.sec 5; timeout_s.usec 0; if (rt_device_write(hw_dev, 0, timeout_s, sizeof(timeout_s)) ! sizeof(timeout_s)) { rt_kprintf(设置超时值失败\n); ret -RT_ERROR; goto __exit; } rt_kprintf(硬件定时器已启动5秒周期\n); __exit: if (ret ! RT_EOK) { rt_device_close(hw_dev); } return ret; } /* 导出到MSH命令列表 */ MSH_CMD_EXPORT(hwtimer_sample, 硬件定时器示例); int main(void) { rt_kprintf(硬件定时器示例工程\n); return 0; }4.2 调试技巧与常见问题调试技巧使用list_device命令查看已注册的设备确认定时器设备是否成功注册在回调函数中添加rt_kprintf输出确认定时器是否正常工作使用逻辑分析仪或示波器测量定器相关引脚验证定时精度常见问题及解决方案问题现象可能原因解决方案找不到定时器设备1. 未在RT-Thread Settings中启用硬件定时器2. board.h配置错误3. 驱动未正确初始化1. 检查RT-Thread Settings配置2. 检查board.h中的宏定义3. 检查驱动初始化代码定时器不触发回调1. 回调函数未正确设置2. 定时器未启动3. 计数频率设置不当1. 检查rt_device_set_rx_indicate调用2. 检查rt_device_write调用3. 调整计数频率系统卡死或异常1. 回调函数中使用了阻塞函数2. 回调函数执行时间过长1. 移除回调函数中的阻塞调用2. 优化回调函数逻辑性能优化建议根据实际需求选择合适的计数频率过高的频率会增加系统开销对于多个定时任务可以考虑使用单个硬件定时器软件逻辑的方式实现在低功耗应用中注意定时器的唤醒配置
RT-Thread硬件定时器HWTIMER实战：在STM32F1上实现5秒周期任务（附完整代码）
发布时间：2026/6/8 1:53:31
RT-Thread硬件定时器HWTIMER实战在STM32F1上实现5秒周期任务附完整代码1. 环境准备与基础概念在开始硬件定时器的实战之前我们需要先了解一些基本概念和准备工作。RT-Thread的硬件定时器HWTIMER设备提供了一套统一的接口来访问芯片内部的硬件定时器使得开发者可以方便地实现精确的定时功能。硬件准备STM32F1系列开发板如正点原子MiniSTM32、野火指南者等USB转串口工具用于调试输出ST-Link或其他调试器可选用于程序下载和调试软件准备RT-Thread Studio或Keil MDK开发环境RT-Thread源码4.0.0或以上版本STM32CubeMX用于生成HAL库初始化代码硬件定时器与软件定时器的主要区别在于精度和资源占用。硬件定时器直接使用芯片内部的定时器外设具有更高的精度通常可达微秒级且不占用CPU资源而软件定时器基于系统tick实现精度受限于系统tick周期通常为1ms或10ms。2. 工程配置与硬件定时器初始化2.1 RT-Thread Settings配置首先我们需要在RT-Thread Settings中启用硬件定时器支持打开项目中的RT-Thread Settings配置文件在硬件选项卡下找到硬件定时器设备驱动勾选启用该选项保存配置系统会自动生成相应的宏定义2.2 board.h文件修改接下来我们需要在board.h文件中配置具体的定时器/* 硬件定时器配置 */ #define BSP_USING_TIM #define BSP_USING_TIM2 // 使用TIM2定时器注意根据实际使用的定时器修改宏定义例如使用TIM3则改为BSP_USING_TIM3。2.3 CubeMX配置使用STM32CubeMX进行定时器配置打开CubeMX加载对应芯片的配置文件在Timers选项卡中选择要使用的定时器如TIM2配置定时器参数Clock Source: Internal ClockPrescaler: 根据需求设置Counter Mode: UpPeriod: 自动重装载值其他参数保持默认生成代码将stm32f1xx_hal_msp.c中的HAL_TIM_Base_MspInit函数复制到board.c中常见问题解决如果编译报错函数重复定义删除board.c中已有的HAL_TIM_Base_MspInit函数确保stm32f1xx_hal_conf.h中HAL_TIM_MODULE_ENABLED宏已取消注释3. 硬件定时器应用开发3.1 定时器设备查找与初始化在main.c中我们首先需要查找并初始化定时器设备#include rtthread.h #include rtdevice.h #define HWTIMER_DEV_NAME timer2 // 定时器设备名称 static rt_device_t hw_dev RT_NULL; /* 查找并打开定时器设备 */ int hwtimer_init(void) { rt_err_t ret RT_EOK; /* 查找定时器设备 */ hw_dev rt_device_find(HWTIMER_DEV_NAME); if (hw_dev RT_NULL) { rt_kprintf(找不到 %s 设备!\n, HWTIMER_DEV_NAME); return -RT_ERROR; } /* 以读写方式打开设备 */ ret rt_device_open(hw_dev, RT_DEVICE_OFLAG_RDWR); if (ret ! RT_EOK) { rt_kprintf(打开 %s 设备失败!\n, HWTIMER_DEV_NAME); return ret; } return RT_EOK; }3.2 定时器回调函数实现定时器超时回调函数是定时器应用的核心部分需要注意以下几点回调函数中不能使用可能导致阻塞的函数如rt_thread_mdelay回调函数执行时间应尽可能短如果需要执行耗时操作建议使用消息队列或信号量通知其他线程处理/* 定时器超时回调函数 */ static rt_err_t timeout_cb(rt_device_t dev, rt_size_t size) { static rt_uint32_t count 0; rt_kprintf(定时器超时回调! 计数: %d\n, count); rt_kprintf(当前系统tick: %d\n, rt_tick_get()); return RT_EOK; }3.3 定时器参数配置与启动配置定时器参数并启动定时器int hwtimer_start(void) { rt_err_t ret RT_EOK; rt_hwtimerval_t timeout_s; rt_hwtimer_mode_t mode; rt_uint32_t freq 10000; // 计数频率10kHz /* 设置超时回调函数 */ rt_device_set_rx_indicate(hw_dev, timeout_cb); /* 设置计数频率 */ ret rt_device_control(hw_dev, HWTIMER_CTRL_FREQ_SET, freq); if (ret ! RT_EOK) { rt_kprintf(设置计数频率失败! 错误码: %d\n, ret); return ret; } /* 设置模式为周期性定时器 */ mode HWTIMER_MODE_PERIOD; ret rt_device_control(hw_dev, HWTIMER_CTRL_MODE_SET, mode); if (ret ! RT_EOK) { rt_kprintf(设置定时器模式失败! 错误码: %d\n, ret); return ret; } /* 设置定时器超时值为5s并启动定时器 */ timeout_s.sec 5; // 秒 timeout_s.usec 0; // 微秒 if (rt_device_write(hw_dev, 0, timeout_s, sizeof(timeout_s)) ! sizeof(timeout_s)) { rt_kprintf(设置超时值失败\n); return -RT_ERROR; } return RT_EOK; }4. 完整示例与调试技巧4.1 完整示例代码将上述代码整合并导出MSH命令#include rtthread.h #include rtdevice.h #define HWTIMER_DEV_NAME timer2 static rt_device_t hw_dev RT_NULL; /* 定时器超时回调函数 */ static rt_err_t timeout_cb(rt_device_t dev, rt_size_t size) { static rt_uint32_t count 0; rt_kprintf(定时器超时回调! 计数: %d\n, count); rt_kprintf(当前系统tick: %d\n, rt_tick_get()); return RT_EOK; } /* 硬件定时器示例 */ static int hwtimer_sample(int argc, char *argv[]) { rt_err_t ret RT_EOK; rt_hwtimerval_t timeout_s; rt_hwtimer_mode_t mode; rt_uint32_t freq 10000; /* 查找定时器设备 */ hw_dev rt_device_find(HWTIMER_DEV_NAME); if (hw_dev RT_NULL) { rt_kprintf(找不到 %s 设备!\n, HWTIMER_DEV_NAME); return -RT_ERROR; } /* 打开设备 */ ret rt_device_open(hw_dev, RT_DEVICE_OFLAG_RDWR); if (ret ! RT_EOK) { rt_kprintf(打开 %s 设备失败!\n, HWTIMER_DEV_NAME); return ret; } /* 设置回调函数 */ rt_device_set_rx_indicate(hw_dev, timeout_cb); /* 设置计数频率 */ ret rt_device_control(hw_dev, HWTIMER_CTRL_FREQ_SET, freq); if (ret ! RT_EOK) { rt_kprintf(设置计数频率失败! 错误码: %d\n, ret); goto __exit; } /* 设置模式为周期性定时器 */ mode HWTIMER_MODE_PERIOD; ret rt_device_control(hw_dev, HWTIMER_CTRL_MODE_SET, mode); if (ret ! RT_EOK) { rt_kprintf(设置定时器模式失败! 错误码: %d\n, ret); goto __exit; } /* 设置超时值并启动定时器 */ timeout_s.sec 5; timeout_s.usec 0; if (rt_device_write(hw_dev, 0, timeout_s, sizeof(timeout_s)) ! sizeof(timeout_s)) { rt_kprintf(设置超时值失败\n); ret -RT_ERROR; goto __exit; } rt_kprintf(硬件定时器已启动5秒周期\n); __exit: if (ret ! RT_EOK) { rt_device_close(hw_dev); } return ret; } /* 导出到MSH命令列表 */ MSH_CMD_EXPORT(hwtimer_sample, 硬件定时器示例); int main(void) { rt_kprintf(硬件定时器示例工程\n); return 0; }4.2 调试技巧与常见问题调试技巧使用list_device命令查看已注册的设备确认定时器设备是否成功注册在回调函数中添加rt_kprintf输出确认定时器是否正常工作使用逻辑分析仪或示波器测量定器相关引脚验证定时精度常见问题及解决方案问题现象可能原因解决方案找不到定时器设备1. 未在RT-Thread Settings中启用硬件定时器2. board.h配置错误3. 驱动未正确初始化1. 检查RT-Thread Settings配置2. 检查board.h中的宏定义3. 检查驱动初始化代码定时器不触发回调1. 回调函数未正确设置2. 定时器未启动3. 计数频率设置不当1. 检查rt_device_set_rx_indicate调用2. 检查rt_device_write调用3. 调整计数频率系统卡死或异常1. 回调函数中使用了阻塞函数2. 回调函数执行时间过长1. 移除回调函数中的阻塞调用2. 优化回调函数逻辑性能优化建议根据实际需求选择合适的计数频率过高的频率会增加系统开销对于多个定时任务可以考虑使用单个硬件定时器软件逻辑的方式实现在低功耗应用中注意定时器的唤醒配置
（支持资料、图片参考_降重降ai）)
