RT-Thread-STM32超低功耗之移植 RT-Thread PM 组件RT-Thread问答社区

STM32超低功耗之移植 RT-Thread PM 组件

发布于 2021-06-06 19:54:20 浏览：2265 订阅该版

[tocm]

# 一， 认识 PM 组件

目前低功耗产品的功能越来越丰富，使用裸机方式的方式，已经无法满足日益增长的市场需求，所以如何在 RTOS 中加入低功耗组件也是市场发展的必然趋势。
在 RTOS 中实现超低功耗都使用到了 tickless 机制，其中不乏RT-Thread ，embOS，RTX 和 uCOS-III。本文主要研究的是 RT-Thread 的 PM(Power Managment) 组件。

# 二，移植 PM 组件

对于已经使用过 RT-Thread 的小伙伴来讲，移植 PM 组件，非常的简单。注意 RT-Thread  PM 组件在 2020 年底更新了到了 2.0 版本，所以在使用的时候，要保证 RT-Thread 的源码是 2021 年以后的。

- 选择一个 STM32L4 系列的 BSP，本文以 STM32L433-NUCLEO 为例。
- 打开 ENV 配置界面，输入 menuconfig
  ![在这里插入图片描述](https://img-blog.csdnimg.cn/20210530224627890.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3doajEyMzk5OQ==,size_16,color_FFFFFF,t_70)
- 选择 RT-Thread 组件

![在这里插入图片描述](https://img-blog.csdnimg.cn/20210530224811470.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3doajEyMzk5OQ==,size_16,color_FFFFFF,t_70)

- 选择 PM 组件
  ![在这里插入图片描述](https://img-blog.csdnimg.cn/20210530224237255.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3doajEyMzk5OQ==,size_16,color_FFFFFF,t_70)
- 修改空闲线程的配置，按 ESC 可以返回到上一层
  ![在这里插入图片描述](https://img-blog.csdnimg.cn/20210530225006487.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3doajEyMzk5OQ==,size_16,color_FFFFFF,t_70)
- 修改空闲线程的栈大小，不得小于 512，不然会编译报错
  ![在这里插入图片描述](https://img-blog.csdnimg.cn/20210530225058893.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3doajEyMzk5OQ==,size_16,color_FFFFFF,t_70)
- 然后保存退出
  ![在这里插入图片描述](https://img-blog.csdnimg.cn/20210530225153952.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3doajEyMzk5OQ==,size_16,color_FFFFFF,t_70)
- 执行 scons --target=mdk5 生成新的工程
  ![在这里插入图片描述](https://img-blog.csdnimg.cn/20210530225518945.png)
- 查看编译报错
  ![在这里插入图片描述](https://img-blog.csdnimg.cn/20210530225910741.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3doajEyMzk5OQ==,size_16,color_FFFFFF,t_70)
  报错显示有 5 个函数未找到定义，如果看过我前面的文章看见这几个函数的名字就大概能知道他们的功能了：

2. void SystemClock_MSI_ON(void);  // 使能 MSI 作为时钟源
3. void SystemClock_80M(void); //  使 MCU 工作在 80M
4. void SystemClock_24M(void); // 使 MCU 工作在 24M
5. void SystemClock_2M(void); // 使 MCU 工作在 2M
6. void SystemClock_ReConfig(uint8_t mode); // 重新配置时钟
   以上几个函数，由用户根据自己实际的情况去配置，也可以[参考](https://gitee.com/rtthread/rt-thread/blob/gitee_master/bsp/stm32/stm32l475-atk-pandora/board/board.c#L83)。

至此，就完成了在 STM32L4 上移植 PM 组件，暂未测试不支持 LPTIM 的系列。

# 三，使用 PM 组件

- 查看 PM 组件导出的命令

```
 \ | /
- RT -     Thread Operating System
 / | \     4.0.3 build May 30 2021
 2006 - 2021 Copyright by rt-thread team
msh >pm
pm_release
pm_release_all
pm_request
pm_module_release
pm_module_release_all
pm_module_request
pm_module_delay
pm_run
pm_dump
msh >

```

- 查看 PM 组件每个命令的作用，参考[官方文档](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/programming-manual/pm/pm)
  pm_release : 释放休眠模式
  实际调用函数为 `void rt_pm_release(rt_uint8_t mode)`  
  pm_request : 请求休眠模式
  实际调用函数为 `void rt_pm_request(rt_uint8_t mode)`  
  pm_module_release ： 上层运用或者驱动层释放休眠模式
  实际调用函数为 `void rt_pm_module_release(uint8_t module_id, rt_uint8_t mode)`
  pm_module_request ： 上层运用或者驱动层请求睡眠模式
  实际调用函数为 `void rt_pm_module_request(uint8_t module_id, rt_uint8_t mode)`
  pm_run：设置进入的运行模式
  实际调用函数为 `rt_pm_run_enter(mode);`
  pm_dump：显示当前的 PM 组件的运行信息
  实际调用函数为 `rt_pm_run_enter(mode);`

# 四，总结

- 通过 ENV 工具可以很方便的移植 PM 组件，但是移植到自己的板子上，需要自己根据需求去实现对应的功耗切换函数
- 注意 RT-Thread  PM 组件在 2020 年底更新了到了 2.0 版本，所以在使用的时候，要保证 RT-Thread 的源码是 2021 年以后的。