目录
一、前言
好久没更新博客了,今天来教一教大家如何将一个小的操作系统(uCOS)移植到咱们的C8T6最小系统板中从而实现多任务分时执行。由于各任务分得的时间片非常的少,我们也可以认为多个任务是同时运行的。移植过程有点繁琐,但是大家只要跟着我一起做保证不会出现问题。另外,我将会在结尾利用逻辑分析仪抓取一下我们各项任务的电平波形,并进行协议分析。
二、题目要求
学习嵌入式实时操作系统(RTOS),以uc/OS-III为例,将其移植到stm32F103上,构建至少3个任务(task):其中两个task分别以1s和3s周期对LED等进行点亮-熄灭的控制;另外一个task以2s周期通过串口发送“hello uc/OS! 欢迎来到RTOS多任务环境!”。记录详细的移植过程。
从题目中我们可以看到,我们需要移植的是uc/OS-III操作系统,这点一定要记住!
三、利用CubeMX建立一个STM32F103C8T6工程(HAL库)
之前的博客中也向大家介绍过MX的使用方法(如何利用MX来创建一个工程)。
咱们首先配置好我们的输出管脚(PC13),因为C8T6的最小系统板上的LED1对应的输出管脚为PC13。
之前教过大家的初始化三步走,现在我们需要来配置时钟源RCC:
接着配置SYS:
因为我们要用到串口,所以还得初始化USART1:
接着我们就可以导出工程文件啦:
四、准备好uCOS-III源码
大家可以去官网下载,也可以去我的百度网盘直接下载
提取码:1111
下载好咱们的uCOS-III源码之后打开software文件夹可以看到如图所示:
这样就证明咱们下载OK啦,可以准备移植代码咯!
五、移植前的准备工作
在移植之前我们需要做一些工作,将一些源文件拷贝到咱们的工程文件目录之下。
1、为uC-BSP文件夹新建bsp.c和bsp.h文件
2、将下图中的对应文件夹复制到uC-CONFIG文件夹中
复制:
粘贴:
3、将uCOS相关文件赋值到HAL工程的MDK-ARM文件夹中
复制:
粘贴:
咱们做好准备工作之后就可以正式开始移植工作了。
六、开始移植
打开之前我们用MX生成的工程文件,该过程有点无聊但是希望大家还是要仔细避免后续文件添加错误一大堆BUG。
1、在项目中添加我们需要的文件
首先需要我们在工程中创建我们放置我们文件的文件夹,点击Manage Project Items:
接着为咱们的项目新建我们需要用到的文件夹:
然后现在我们需要往我们新建的文件夹中添加对应的文件:
在CPU中添加如下文件:
在LIB中添加如下文件:
在PORT中添加如下文件:
在CONFIG中添加如下文件:
在BSP中添加如下文件:
添加完成以后咱们可以看到如下图所示效果:
紧接着就需要我们将刚刚添加的文件路径导入进咱们的项目了:
点击“仙女棒”:
点击C/C++选项卡,添加路径:
添加如下图所示路径:
点击“OK”即可。
2、添加bsp.c和bsp.h代码
大家是否还记得我们之前创建的空文件bsp.c和bsp.h,现在时候向这两个文件中添加对应的代码了,代码如下:
bsp.h:
// bsp.h
#ifndef __BSP_H__
#define __BSP_H__
#include "stm32f1xx_hal.h"
void BSP_Init(void);
#endif
bsp.c:
// bsp.c
#include "includes.h"
#define DWT_CR *(CPU_REG32 *)0xE0001000
#define DWT_CYCCNT *(CPU_REG32 *)0xE0001004
#define DEM_CR *(CPU_REG32 *)0xE000EDFC
#define DBGMCU_CR *(CPU_REG32 *)0xE0042004
#define DEM_CR_TRCENA (1 << 24)
#define DWT_CR_CYCCNTENA (1 << 0)
CPU_INT32U BSP_CPU_ClkFreq (void)
{
return HAL_RCC_GetHCLKFreq();
}
void BSP_Tick_Init(void)
{
CPU_INT32U cpu_clk_freq;
CPU_INT32U cnts;
cpu_clk_freq = BSP_CPU_ClkFreq();
#if(OS_VERSION>=3000u)
cnts = cpu_clk_freq/(CPU_INT32U)OSCfg_TickRate_Hz;
#else
cnts = cpu_clk_freq/(CPU_INT32U)OS_TICKS_PER_SEC;
#endif
OS_CPU_SysTickInit(cnts);
}
void BSP_Init(void)
{
BSP_Tick_Init();
MX_GPIO_Init();
}
#if (CPU_CFG_TS_TMR_EN == DEF_ENABLED)
void CPU_TS_TmrInit (void)
{
CPU_INT32U cpu_clk_freq_hz;
DEM_CR |= (CPU_INT32U)DEM_CR_TRCENA; /* Enable Cortex-M3's DWT CYCCNT reg. */
DWT_CYCCNT = (CPU_INT32U)0u;
DWT_CR |= (CPU_INT32U)DWT_CR_CYCCNTENA;
cpu_clk_freq_hz = BSP_CPU_ClkFreq();
CPU_TS_TmrFreqSet(cpu_clk_freq_hz);
}
#endif
#if (CPU_CFG_TS_TMR_EN == DEF_ENABLED)
CPU_TS_TMR CPU_TS_TmrRd (void)
{
return ((CPU_TS_TMR)DWT_CYCCNT);
}
#endif
#if (CPU_CFG_TS_32_EN == DEF_ENABLED)
CPU_INT64U CPU_TS32_to_uSec (CPU_TS32 ts_cnts)
{
CPU_INT64U ts_us;
CPU_INT64U fclk_freq;
fclk_freq = BSP_CPU_ClkFreq();
ts_us = ts_cnts / (fclk_freq / DEF_TIME_NBR_uS_PER_SEC);
return (ts_us);
}
#endif
#if (CPU_CFG_TS_64_EN == DEF_ENABLED)
CPU_INT64U CPU_TS64_to_uSec (CPU_TS64 ts_cnts)
{
CPU_INT64U ts_us;
CPU_INT64U fclk_freq;
fclk_freq = BSP_CPU_ClkFreq();
ts_us = ts_cnts / (fclk_freq / DEF_TIME_NBR_uS_PER_SEC);
return (ts_us);
}
#endif
3、修改main.c文件代码
在编写好bsp.c和bsp.h文件的代码之后就该进行最重要的主文件代码编写了:
main.c:
/* USER CODE END Header */
/* Includes ------------------------------------------------------------------*/
#include "main.h"
#include "gpio.h"
#include "usart.h"
/* Private includes ----------------------------------------------------------*/
/* USER CODE BEGIN Includes */
#include <includes.h>
#include "stm32f1xx_hal.h"
/* USER CODE END Includes */
/* Private typedef -----------------------------------------------------------*/
/* USER CODE BEGIN PTD */
/* USER CODE END PTD */
/* Private define ------------------------------------------------------------*/
/* USER CODE BEGIN PD */
/* 任务优先级 */
#define START_TASK_PRIO 3
#define LED0_TASK_PRIO 4
#define MSG_TASK_PRIO 5
/* 任务堆栈大小 */
#define START_STK_SIZE 64
#define LED0_STK_SIZE 64
#define MSG_STK_SIZE 64//任务堆大小过大会报错,可以试着改小一点
/* 任务栈 */
CPU_STK START_TASK_STK[START_STK_SIZE];
CPU_STK LED0_TASK_STK[LED0_STK_SIZE];
CPU_STK MSG_TASK_STK[MSG_STK_SIZE];
/* 任务控制块 */
OS_TCB StartTaskTCB;
OS_TCB Led0TaskTCB;
OS_TCB MsgTaskTCB;
/* USER CODE END PD */
/* Private macro -------------------------------------------------------------*/
/* USER CODE BEGIN PM */
/* USER CODE END PM */
/* Private variables ---------------------------------------------------------*/
/* USER CODE BEGIN PV */
/* 任务函数定义 */
void start_task(void *p_arg);
static void AppTaskCreate(void);
static void AppObjCreate(void);
static void led_pc13(void *p_arg);
static void send_msg(void *p_arg);
/* USER CODE END PV */
/* Private function prototypes -----------------------------------------------*/
void SystemClock_Config(void);
/* USER CODE BEGIN PFP */
/* USER CODE END PFP */
/* Private user code ---------------------------------------------------------*/
/* USER CODE BEGIN 0 */
/**
* @brief System Clock Configuration
* @retval None
*/
void SystemClock_Config(void)
{
RCC_OscInitTypeDef RCC_OscInitStruct = {0};
RCC_ClkInitTypeDef RCC_ClkInitStruct = {0};
/**Initializes the CPU, AHB and APB busses clocks
*/
RCC_OscInitStruct.OscillatorType = RCC_OSCILLATORTYPE_HSE;
RCC_OscInitStruct.HSEState = RCC_HSE_ON;
RCC_OscInitStruct.HSEPredivValue = RCC_HSE_PREDIV_DIV1;
RCC_OscInitStruct.HSIState = RCC_HSI_ON;
RCC_OscInitStruct.PLL.PLLState = RCC_PLL_ON;
RCC_OscInitStruct.PLL.PLLSource = RCC_PLLSOURCE_HSE;
RCC_OscInitStruct.PLL.PLLMUL = RCC_PLL_MUL9;
if (HAL_RCC_OscConfig(&RCC_OscInitStruct) != HAL_OK)
{
Error_Handler();
}
/**Initializes the CPU, AHB and APB busses 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();
}
}
/* USER CODE END 0 */
/**
* @brief The application entry point.
* @retval int
*/
int main(void)
{
OS_ERR err;
OSInit(&err);
HAL_Init();
SystemClock_Config();
//MX_GPIO_Init(); 这个在BSP的初始化里也会初始化
MX_USART1_UART_Init();
/* 创建任务 */
OSTaskCreate((OS_TCB *)&StartTaskTCB, /* Create the start task */
(CPU_CHAR *)"start task",
(OS_TASK_PTR ) start_task,
(void *) 0,
(OS_PRIO ) START_TASK_PRIO,
(CPU_STK *)&START_TASK_STK[0],
(CPU_STK_SIZE) START_STK_SIZE/10,
(CPU_STK_SIZE) START_STK_SIZE,
(OS_MSG_QTY ) 0,
(OS_TICK ) 0,
(void *) 0,
(OS_OPT )(OS_OPT_TASK_STK_CHK | OS_OPT_TASK_STK_CLR),
(OS_ERR *)&err);
/* 启动多任务系统,控制权交给uC/OS-III */
OSStart(&err); /* Start multitasking (i.e. give control to uC/OS-III). */
}
void start_task(void *p_arg)
{
OS_ERR err;
CPU_SR_ALLOC();
p_arg = p_arg;
/* YangJie add 2021.05.20*/
BSP_Init(); /* Initialize BSP functions */
//CPU_Init();
//Mem_Init(); /* Initialize Memory Management Module */
#if OS_CFG_STAT_TASK_EN > 0u
OSStatTaskCPUUsageInit(&err); //统计任务
#endif
#ifdef CPU_CFG_INT_DIS_MEAS_EN //如果使能了测量中断关闭时间
CPU_IntDisMeasMaxCurReset();
#endif
#if OS_CFG_SCHED_ROUND_ROBIN_EN //当使用时间片轮转的时候
//使能时间片轮转调度功能,时间片长度为1个系统时钟节拍,既1*5=5ms
OSSchedRoundRobinCfg(DEF_ENABLED,1,&err);
#endif
OS_CRITICAL_ENTER(); //进入临界区
/* 创建LED0任务 */
OSTaskCreate((OS_TCB * )&Led0TaskTCB,
(CPU_CHAR * )"led_pc13",
(OS_TASK_PTR )led_pc13,
(void * )0,
(OS_PRIO )LED0_TASK_PRIO,
(CPU_STK * )&LED0_TASK_STK[0],
(CPU_STK_SIZE)LED0_STK_SIZE/10,
(CPU_STK_SIZE)LED0_STK_SIZE,
(OS_MSG_QTY )0,
(OS_TICK )0,
(void * )0,
(OS_OPT )OS_OPT_TASK_STK_CHK|OS_OPT_TASK_STK_CLR,
(OS_ERR * )&err);
/* 创建LED1任务 */
OSTaskCreate((OS_TCB * )&MsgTaskTCB,
(CPU_CHAR * )"send_msg",
(OS_TASK_PTR )send_msg,
(void * )0,
(OS_PRIO )MSG_TASK_PRIO,
(CPU_STK * )&MSG_TASK_STK[0],
(CPU_STK_SIZE)MSG_STK_SIZE/10,
(CPU_STK_SIZE)MSG_STK_SIZE,
(OS_MSG_QTY )0,
(OS_TICK )0,
(void * )0,
(OS_OPT )OS_OPT_TASK_STK_CHK|OS_OPT_TASK_STK_CLR,
(OS_ERR * )&err);
OS_TaskSuspend((OS_TCB*)&StartTaskTCB,&err); //挂起开始任务
OS_CRITICAL_EXIT(); //进入临界区
}
/**
* 函数功能: 启动任务函数体。
* 输入参数: p_arg 是在创建该任务时传递的形参
* 返 回 值: 无
* 说 明:无
*/
static void led_pc13 (void *p_arg)
{
OS_ERR err;
(void)p_arg;
BSP_Init(); /* Initialize BSP functions */
CPU_Init();
Mem_Init(); /* Initialize Memory Management Module */
#if OS_CFG_STAT_TASK_EN > 0u
OSStatTaskCPUUsageInit(&err); /* Compute CPU capacity with no task running */
#endif
CPU_IntDisMeasMaxCurReset();
AppTaskCreate(); /* Create Application Tasks */
AppObjCreate(); /* Create Application Objects */
while (DEF_TRUE)
{
HAL_GPIO_WritePin(GPIOC,GPIO_PIN_13,GPIO_PIN_RESET);
OSTimeDlyHMSM(0, 0, 0, 500,OS_OPT_TIME_HMSM_STRICT,&err);
HAL_GPIO_WritePin(GPIOC,GPIO_PIN_13,GPIO_PIN_SET);
OSTimeDlyHMSM(0, 0, 0, 500,OS_OPT_TIME_HMSM_STRICT,&err);
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
}
/* USER CODE END 3 */
}
static void send_msg (void *p_arg)
{
OS_ERR err;
(void)p_arg;
BSP_Init(); /* Initialize BSP functions */
CPU_Init();
Mem_Init(); /* Initialize Memory Management Module */
#if OS_CFG_STAT_TASK_EN > 0u
OSStatTaskCPUUsageInit(&err); /* Compute CPU capacity with no task running */
#endif
CPU_IntDisMeasMaxCurReset();
AppTaskCreate(); /* Create Application Tasks */
AppObjCreate(); /* Create Application Objects */
while (DEF_TRUE)
{
printf("hello world \r\n");
OSTimeDlyHMSM(0, 0, 0, 500,OS_OPT_TIME_HMSM_STRICT,&err);
/* USER CODE END WHILE */
/* USER CODE BEGIN 3 */
}
/* USER CODE END 3 */
}
/* USER CODE BEGIN 4 */
/**
* 函数功能: 创建应用任务
* 输入参数: p_arg 是在创建该任务时传递的形参
* 返 回 值: 无
* 说 明:无
*/
static void AppTaskCreate (void)
{
}
/**
* 函数功能: uCOSIII内核对象创建
* 输入参数: 无
* 返 回 值: 无
* 说 明:无
*/
static void AppObjCreate (void)
{
}
/* USER CODE END 4 */
/**
* @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 */
/* 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,
tex: printf("Wrong parameters value: file %s on line %d\r\n", file, line) */
/* USER CODE END 6 */
}
#endif /* USE_FULL_ASSERT */
/************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/
4、修改其他文件代码
打开我们的启动文件:
在该文件中的第75、76行和第174、175、178、179行中将PendSV_Handler和SysTick_Handler改为OS_CPU_PendSVHandler和OS_CPU_SysTickHandler,如图所示:
接着再从项目中的CONFIG文件夹中找到app_cfg.h文件
打开该文件找到该文件的第42行,将 #define APP_CFG_SERIAL_EN DEF_ENABLED 改为 #define APP_CFG_SERIAL_EN DEF_DISABLED
第85行,将#define APP_TRACE BSP_Ser_Printf 改为 #define APP_TRACE(void)
继续在该文件夹下找到includes.h文件
在#include<bsp.h>下添加,#include "gpio.h"和#include “app_cfg.h”
找到第88行,将 #include <stm32f10x_lib.h> 改为 #include “stm32f1xx_hal.h”
紧接着在该文件夹下找到lib_cfg.h文件
找到第120行,将27修改为5(此处为宏定义设置堆空间的大小,STM32F103C8T6的RAM只有20K,默认的是27K,所以需要我们改小一点,不然会报错的。)
由于我们需要用到串口输出,所以需要我们重定向一下printf函数,找到usart.c文件,并在其中添加如下代码:
/* USER CODE BEGIN 1 */
int fputc(int ch,FILE *f){
HAL_UART_Transmit(&huart1,(uint8_t *)&ch,1,0xffff);
return ch;
}
/* USER CODE END 1 */
这里注意我们定义的fputc函数中的参数f用到了“FILE”类型,但是这里的FILE我们在之前并为定义,所以我们直接编译会报错,需要我们在文件中定义一下。打开usart.h文件,在开头加上 typedef struct __FILE FILE; 即可。
5、配置参数
点击“仙女棒”,接着点击Target选项卡按照如下图配置:
接下来是Debug选项卡,做好仿真的准备。
现在我们打开仿真看看波形:
点击Setup,输入我们要观察的管脚。分别是PA3、PC13、USART1_SR,保存即可。
相信很多小伙伴到这一步之后直接仿真会出现一些问题,大家肯定会发现点一下运行无法自动持续运行,需要自己手动一直点执行才可以,并且左下角命令行会报错说没有读取权限。请大家点击错误解决方案照着做就OK啦。
七、仿真查看波形
在大家解决完问题以后可以通过Keil自带的仿真调试功能来查看各管脚的输出波形从而判断自己对错。
可以看到上图中我的仿真波形,我对PC13的高电平时间进行了测量,测量值是d=1.008364s,可以看出来还是比较接近1s整的,另外可以看到PA3的波形的前一个波峰起点到后一个波峰起点一共包含了三个PC13的高电平持续时间,从实际直观的表达就是PA3亮3次PC13亮1次。另外最后的USART1_SR输出的波形经过放大得到:
这里是串口输出的数据,我们在Keil中无法直观的看出来所包含的到底是哪个数据,我会在后续使用逻辑分析仪来对串口传输进行抓包并对其进行分析。
八、实际效果
可以看到效果与我之前说的一样,绿灯连续亮两次之后第三次与黄灯一起亮,并且此时的串口也在一直输出数据。
九、逻辑分析
我们用到的逻辑分析仪需要硬件所以小伙伴们可以自行购买,我们用到的分析软件可以点击进行下载,里面有它的教程,特别简单很容易上手。废话不多说我们直接开始波形分析。
我进行波形分析的管脚与在Keil中的仿真调试用到的管脚相同,都是PA3、PC13和USART1_SR,因此我们需要将硬件逻辑分析仪预留三个通道分别接最小系统板的PA3、PC13和PA9。进行波形采样得到的波形如图:
其中0通道接的是PC13,1通道接的是PA9,2通道接的是PA3,现在我们用软件自带的测量功能对PA3和PC13的高电平持续时间进行测量进一步验证我们的想法:
通道0:
通道2:
可以看到测试出来的时间与Keil中的还是有一定的差距,也许是因为延时函数的问题才导致的实际持续时间与仿真持续时间不同。
最后我们再来分析PA9的串口通信发送的数据,经过放大之后我们得到如下图所示波形(由于采样之前就已经将通道1设置为异步传输协议,所以我们可以直接看到具体发送的数据):
协议分析:由于图中横坐标为时间轴,所以需要我们将发送的二进制高低电平倒过来看就可以对应每个字符的ASCII码了,图中我只对“h”和“e”两个字符做了分析,其他的字符也是一样的,我们可以通过对其他字符的ASCII码进行解析从而得到我们发送的字符信息。
可以从图上很直观地看到传输的数据为hello“uc/OS”,这与我们通过串口得到的数据是一致的。当然我们也可以通过抓包来直接看出我们发送的数据:
好了,到这里我们就完成所有的要求了。
十、总结
在工程执行的过程中可能会出现很多问题,大家遇到问题一定要尽快解决,可以选择直接在网上找答案。当时我在Keil中做仿真的时候发现仿真运行时老是报错,在后续按照网上加了文件和相应路径之后才解决。在文件添加过程中一定要仔细,一不小心就加错了,加重复了,代码编译不报错,但不能运行,很大可能是参数配置的问题。
参考资料
STM32F103C8T6移植uCOS基于HAL库
Keil仿真问题解决
逻辑分析仪软件下载
uc/OS-III源码下载
完整工程下载
提取码全是 1111