STMCUBEIDE RT-THREAD NANO工程搭建(LED闪灯 )
RT-THREAD提供了用于STM32CUBEIDE/STM32CUBEMX的支持包,从而可以搭建资源占用最小化的Nano系统。这里以STM32F401CCU6开发板和STM32CUBEIDE开发环境为例,搭建只有1个LED闪灯的工程并查看工程占用的资源。
RT-THREAD支持包安装
- 从 https://www.rt-thread.org/download/cube/地址下载如下支持包到本地:
2.在STM32CUBEIDE里导入支持包
首先建立一个STM32CUBEIDE工程,并导入支持包:
导入成功后,RT-THREAD就出现在软件包管理器里:
然后还需要选上RT-THREAD,如下:
有三个组件,可以都选上,后面工程配置里还可以再做控制:
然后在STM32CUBEIDE的Catogories里找到RT-THREAD的配置项, 因为要实现最简化Nano操作系统实现,所以只选中kernel:
相关参数保持默认,可以根据需要再改。
工程的堆和栈参数可以保持默认,可以根据需要再改,这里的工程只是点LED,所以把堆改小到0x200,:
另外堆也可以由RT-THREAD来做管理:
LED工程配置
配置工程的时钟系统:
开发板的LED连接到了PC13管脚, 则设置PC13管脚为GPIO输出:
中断函数处理
一些中断函数会由RT-THREAD接管,所以在工程配置里要去掉自动生成的一部分中断处理函数,对NVIC项进行配置:
弹出的提醒信息,点击OK忽略即可。
然后将下述三项设置为不选中:
时钟源选择
然后保存后生成初始工程:
这个时候会产生警告,可以选择Yes忽略继续产生初始代码,RT-THREAD会接管时钟系统:
也可以选择将时钟源调整为其它TIM再保存产生代码, 这种选择下HAL_Delay()函数仍然可以使用:
项目文件修改和增加
修改启动文件bl main为bl entry, 使芯片在启动RT-THREAD后再进入main:
增加LED任务源文件app_rt_thread.c:
app_rt_thread.c文件代码为:
#include "rtthread.h"
#include "main.h"
#include "stdio.h"
/* 定义线程控制块 */
//添加LED闪烁线程
static struct rt_thread led_thread;
static char led_thread_stack[256];
static void led_thread_entry(void *parameter);
void MX_RT_Thread_Init(void);
void MX_RT_Thread_Init(void)
{
//初始化线程
rt_err_t rst;
rst = rt_thread_init(&led_thread,
(const char *)"ledshine", /* 线程名字 */
led_thread_entry, /* 线程入口函数 */
RT_NULL, /* 线程入口函数参数 */
&led_thread_stack[0],
sizeof(led_thread_stack), /* 线程栈大小 */
RT_THREAD_PRIORITY_MAX-2, /* 线程的优先级 */
20); /* 线程时间片 */
if(rst == RT_EOK)
{///* 启动线程,开启调度 */
rt_thread_startup(&led_thread);
}
}
/*
*************************************************************************
* 线程定义
*************************************************************************
*/
static void led_thread_entry(void *parameter)
{
while(1)
{
HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
rt_thread_mdelay(500);
}
}
MSH_CMD_EXPORT(led_thread_entry,thread running);
因为不用串口打印功能,串口并没有初始化,这里要把功能代码使能RT_USING_CONSOLE注释掉:
操作系统是做软件浮点处理,还需要将浮点处理方式改为软件方式:
退出设置后,进行main.c文件的修改,注意已经是RT-THREAD初始化后再调用main()函数,而在RT-THREAD初始化时,已经做了一些系统和时钟的初始化,所以main()函数里的这部分会通过#if 0 … #endif的方式规避掉。RT-THREAD的初始化函数如下:
修改后的main.c文件为:
/* USER CODE BEGIN Header */
/**
******************************************************************************
* @file : main.c
* @brief : Main program body
******************************************************************************
* @attention
*
* Copyright (c) 2022 STMicroelectronics.
* All rights reserved.
*
* This software is licensed under terms that can be found in the LICENSE file
* in the root directory of this software component.
* If no LICENSE file comes with this software, it is provided AS-IS.
*
******************************************************************************
*/
/* USER CODE END Header */
/* Includes ------------------------------------------------------------------*/
#include "main.h"
/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */
#include "rtthread.h"
extern void MX_RT_Thread_Init(void);
/* USER CODE END Includes */
/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PTD */
/* USER CODE END PTD */
/* Private define ------------------------------------------------------------*/
/* USER CODE BEGIN PD */
/* USER CODE END PD */
/* Private macro -------------------------------------------------------------*/
/* USER CODE BEGIN PM */
/* USER CODE END PM */
/* Private variables ---------------------------------------------------------*/
/* USER CODE BEGIN PV */
/* USER CODE END PV */
/* Private function prototypes -----------------------------------------------*/
void SystemClock_Config(void);
static void MX_GPIO_Init(void);
/* USER CODE BEGIN PFP */
/* USER CODE END PFP */
/* Private user code ---------------------------------------------------------*/
/* USER CODE BEGIN 0 */
/* USER CODE END 0 */
/**
* @brief The application entry point.
* @retval int
*/
int main(void)
{
/* USER CODE BEGIN 1 */
#if 0
/* USER CODE END 1 */
/* MCU Configuration--------------------------------------------------------*/
/* Reset of all peripherals, Initializes the Flash interface and the Systick. */
HAL_Init();
/* USER CODE BEGIN Init */
/* USER CODE END Init */
/* Configure the system clock */
SystemClock_Config();
/* USER CODE BEGIN SysInit */
#endif
/* USER CODE END SysInit */
/* Initialize all configured peripherals */
MX_GPIO_Init();
/* USER CODE BEGIN 2 */
MX_RT_Thread_Init();
/* USER CODE END 2 */
/* Infinite loop */
/* USER CODE BEGIN WHILE */
while (1)
{
rt_thread_mdelay(1000);
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
}
/* USER CODE END 3 */
}
/**
* @brief System Clock Configuration
* @retval None
*/
void SystemClock_Config(void)
{
RCC_OscInitTypeDef RCC_OscInitStruct = {0};
RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
/** Configure the main internal regulator output voltage
*/
__HAL_RCC_PWR_CLK_ENABLE();
__HAL_PWR_VOLTAGESCALING_CONFIG(PWR_REGULATOR_VOLTAGE_SCALE2);
/** Initializes the RCC Oscillators according to the specified parameters
* in the RCC_OscInitTypeDef structure.
*/
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSI;
RCC_OscInitStruct.HSIState = RCC_HSI_ON;
RCC_OscInitStruct.HSICalibrationValue = RCC_HSICALIBRATION_DEFAULT;
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSI;
RCC_OscInitStruct.PLL.PLLM = 16;
RCC_OscInitStruct.PLL.PLLN = 168;
RCC_OscInitStruct.PLL.PLLP = RCC_PLLP_DIV2;
RCC_OscInitStruct.PLL.PLLQ = 4;
if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
{
Error_Handler();
}
/** Initializes the CPU, AHB and APB buses clocks
*/
RCC_ClkInitStruct.ClockType = RCC_CLOCKTYPE_HCLK|RCC_CLOCKTYPE_SYSCLK
|RCC_CLOCKTYPE_PCLK1|RCC_CLOCKTYPE_PCLK2;
RCC_ClkInitStruct.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
RCC_ClkInitStruct.AHBCLKDivider = RCC_SYSCLK_DIV1;
RCC_ClkInitStruct.APB1CLKDivider = RCC_HCLK_DIV2;
RCC_ClkInitStruct.APB2CLKDivider = RCC_HCLK_DIV1;
if (HAL_RCC_ClockConfig(&RCC_ClkInitStruct, FLASH_LATENCY_2) != HAL_OK)
{
Error_Handler();
}
}
/**
* @brief GPIO Initialization Function
* @param None
* @retval None
*/
static void MX_GPIO_Init(void)
{
GPIO_InitTypeDef GPIO_InitStruct = {0};
/* GPIO Ports Clock Enable */
__HAL_RCC_GPIOC_CLK_ENABLE();
/*Configure GPIO pin Output Level */
HAL_GPIO_WritePin(GPIOC, GPIO_PIN_13, GPIO_PIN_SET);
/*Configure GPIO pin : PC13 */
GPIO_InitStruct.Pin = GPIO_PIN_13;
GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_PP;
GPIO_InitStruct.Pull = GPIO_NOPULL;
GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_LOW;
HAL_GPIO_Init(GPIOC, &GPIO_InitStruct);
}
/* USER CODE BEGIN 4 */
/* USER CODE END 4 */
/**
* @brief Period elapsed callback in non blocking mode
* @note This function is called when TIM2 interrupt took place, inside
* HAL_TIM_IRQHandler(). It makes a direct call to HAL_IncTick() to increment
* a global variable "uwTick" used as application time base.
* @param htim : TIM handle
* @retval None
*/
void HAL_TIM_PeriodElapsedCallback(TIM_HandleTypeDef *htim)
{
/* USER CODE BEGIN Callback 0 */
/* USER CODE END Callback 0 */
if (htim->Instance == TIM2) {
HAL_IncTick();
}
/* USER CODE BEGIN Callback 1 */
/* USER CODE END Callback 1 */
}
/**
* @brief This function is executed in case of error occurrence.
* @retval None
*/
void Error_Handler(void)
{
/* USER CODE BEGIN Error_Handler_Debug */
/* User can add his own implementation to report the HAL error return state */
__disable_irq();
while (1)
{
}
/* USER CODE END Error_Handler_Debug */
}
#ifdef USE_FULL_ASSERT
/**
* @brief Reports the name of the source file and the source line number
* where the assert_param error has occurred.
* @param file: pointer to the source file name
* @param line: assert_param error line source number
* @retval None
*/
void assert_failed(uint8_t *file, uint32_t line)
{
/* USER CODE BEGIN 6 */
/* User can add his own implementation to report the file name and line number,
ex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
/* USER CODE END 6 */
}
#endif /* USE_FULL_ASSERT */
编译下载后即可看到LED闪灯的效果。
工程资源占用
编译后的资源占用:
RAM的占用不到4K, FLASH的占用不到12K。
通过存储空间节省的编译方式,还能进一步减少FLASH的占用,参考 STM32 region `FLASH‘ overflowed by xxx bytes 问题解决 的方式。则编译后的Flash占用减少到了7K:
STM32CUBEIDE工程操作系统选用
对于资源少的STM32芯片,采用RT-THREAD NANO实现嵌入式实时操作系统是一个可行性选择。对于资源多的STM32芯片,也可以采用STM32CUBEIDE集成支持的FREE-RTOS,免去了移植的过程。
注意事项
如果在配置界面升级了配置和生成代码,则board.c和rtconfig.h会被重新生成,修改会丢失,所以就需要做好这两个文件的备份和恢复。
如果需要使用微秒延时函数,参考:STM32 HAL us delay(微秒延时)的指令延时实现方式及优化 里介绍的方法, 采用相同时钟配置工程,测出浮点参数usDelayBase并定义void PY_Delay_us_t(uint32_t Delay);就可以在有嵌入式系统(包括Ucos, Free-RTOS, RT-Thread等)的工程里使用微秒延时函数,如对于系统时钟(SYSCLK)为84MHz的STM32F401CCU6,测得usDelayBase = 7.632387,则在工程里定义如下内容:
__IO const float usDelayBase = 7.632387; //for STM32F401CCU6 in 84MHz
void PY_Delay_us_t(uint32_t Delay)
{
__IO uint32_t delayReg;
__IO uint32_t usNum = (uint32_t)(Delay*usDelayBase);
delayReg = 0;
while(delayReg!=usNum) delayReg++;
}
则可以在工程里通过调用PY_Delay_us_t(x);实现x微秒的延时。
例程下载
参考文章
1. STM32 CubeIDE 使用RT-Thread Nano
2. Keil下搭建RT-Thread最小系统工程
–End–