(一)移植前的准备
1.HAL库基本工程模板
新建一个工程模块,其中包含LED驱动和串口驱动程序即可,用于验证UCOS-III系统能够正常工作。
2.UCOS-III源码准备
去Micrium官网下载最新的UCOSIII源码,下载地址:Micrium官网下载地址,没有注册过的用户需要注册一下,我自己注册的过程都是泪。由于我选择的是正点原子F7的开发板,所以在官网上选择合适源码时就选择F7的。具体版本选择下图中19年2月6号的版本:
下载完成之后发现,发现源码文件夹中东西很多大部分都是和网络移植相关的,目前我们只移植最新版本的UCOSIII,所以这些文件夹都不需要去看。进入源码目录下的uCOS-III文件夹,发现里面只有针对IAR的编译器的文件,难道MDK就凉凉了吗?凡是先不要慌,虽然编译器不同,但是实现的功能就是相同的,并不会影响到移植后操作系统的运行。
UCOSIII的移植
(一)源码文件的摘选
1.在准备好的工程文件夹下新建一个UCOS-III目录,用于存放和UCOSIII相关的所有代码。在UCOS-III目录下新建如下目录,用于UCOS源码的分类。
(1)将源码目录Micrium_STM32F746G-DISCO_Crypto\Micrium\Software\uC-CPU下的文件全部拷贝到我们创建的uC-CPU目录下,为了减少文件夹的个数,我把ARM-Cortex-M\ARMv7-M目录下和ARM-Cortex-M\ARMv7-M\ARM目录下的文件都移到了自己创建的uC-CPU目录下了。这里我要说明下一下IAR和ARM目录下的文件,除了汇编文件有些不同以外,头文件内容都是相同的,这边选择ARM目录下的汇编文件还是IAR目录下的汇编文件都行,因为我们都是要修改成MDK支持的形式的。
(2)将源码目录Micrium_STM32F746G-DISCO_Crypto\Micrium\Software\uC-LIB文件夹下的文件全部拷贝到自己创建的uC-LIB目录下,这边我直接把Micrium\Software\uC-LIB\Ports\ARM-Cortex-M4\RealView目录下的文件和其他文件放在了一个文件夹下,具体如下图所示:
由于我们使用的是MDK编译,所以这边选择的是RealView目录下的汇编文件,具体什么原因的话,网上有很多解释,我就不复制他们的解释了。
(3)将Micrium_STM32F746G-DISCO_Crypto\Micrium\Software\uCOS-III目录下的文件全部拷贝到自己创建uCOS-III目录下。点开Ports的目录,发现最后只有一个IAR文件下,这边我们先不用关注,只需将文件都拷贝过来,具体内容如下图所示:
(4)将源码例程目录Micrium_STM32F746G-DISCO_Crypto\ST\STM32F746G_Disco\Crypto下的部分文件和OS3下的部分文件拷贝到自己创建的UCOS-CONFIG文件夹下。具体文件如下图所示:
在源码例程文件中,发现很多都是网络相关的移植代码,所以没有拷贝过来。但是有一个clk_cfg.h很明显不是和网络相关的,为什么不移植过来呢?从名字上看就是和时钟相关的,难道说不需要时钟配置吗?时钟当然是需要配置的,但是裸机工程中时钟已经配置OK了,这边和时钟相关的文件也就不需要了,后面操作系统的时钟需要自己通过HAL库配置,这边就不详细说明了。
(5)将Micrium_STM32F746G-DISCO_Crypto\ST\BSP\STM32F746G_Disco目录下的bsp_cpu.c文件拷贝到自己创建的UCOS-BSP目录下,并且新建一个bsp_cpu.h头文件(用于包含操作系统的头文件)。其他文件都不需要拷贝,大多是和芯片外设相关的初始化。
(二)文件添加
(1)打开MDK工程,将拷贝的文件添加至工程当中,具体内容如下图所示:
以及头文件路径添加,如下图所示:
上述文件都添加完成之后,点击编译,提示下图错误:
出现unknown opcode什么的错误,而且出现在os_cpu_a.asm文件中,那就打开这个汇编文件看一下,是什么问题,发现PUBLIC关键字都没有标蓝,那肯定是由于这个关键字不是MDK的关键字,所以讲PUBLIC修改为MDK所用的关键字EXPORT,具体EXPORT这个关键字怎么来的,我是查看了其他版本的UCOS在STM32的移植,看到用的是这个关键字,就直接抄过来了。还有错误与FPU相关,如下图所示:
#ifdef __ARMVFP__
EXPORT OS_CPU_FP_Reg_Push
EXPORT OS_CPU_FP_Reg_Pop
#endif
查看了正点原子的移植手册,发现上面说到
Cortex-M7内核中有个Lazy Stacking的功能,如果使用FPU功能的话就需要关闭这个功能,需要修改startup_stm32f767xx.s汇编文件,在里面关闭这个功能。
具体代码如下所示:
IF { FPU} != "SoftVFP"
; Enable Floating Point Support at reset for FPU
LDR.W R0, =0xE000ED88 ; Load address of CPACR register
LDR R1, [R0] ; Read value at CPACR
ORR R1, R1, #(0xF <<20) ; Set bits 20-23 to enable CP10 and CP11 coprocessors
; Write back the modified CPACR value
STR R1, [R0] ; Wait for store to complete
DSB
; Disable automatic FP register content
; Disable lazy context switch
LDR.W R0, =0xE000EF34 ; Load address to FPCCR register
LDR R1, [R0]
AND R1, R1, #(0x3FFFFFFF) ; Clear the LSPEN and ASPEN bits
STR R1, [R0]
ISB ; Reset pipeline now the FPU is enabled
ENDIF
在startup_stm32f767xx.s中就如下图所示:
修改完这些,接下去就解决… error: A1163E: Unknown opcode ARMVFP , expecting opcode or Macro 这个错误。将原先的判断语句修改为如下语句:
IF { FPU} != "SoftVFP"
EXPORT OS_CPU_FP_Reg_Push
EXPORT OS_CPU_FP_Reg_Pop
ENDIF
IF { FPU} != "SoftVFP"
OS_CPU_FP_Reg_Push
MRS R1, PSP ; PSP is process stack pointer
CBZ R1, OS_CPU_FP_nosave ; Skip FP register save the first time
VSTMDB R0!, { S16-S31}
LDR R1, =OSTCBCurPtr
LDR R2, [R1]
STR R0, [R2]
OS_CPU_FP_nosave
BX LR
ENDIF
IF { FPU} != "SoftVFP"
OS_CPU_FP_Reg_Pop
VLDMIA R0!, { S16-S31}
LDR R1, =OSTCBHighRdyPtr
LDR R2, [R1]
STR R0, [R2]
BX LR
ENDIF
修改完成之后,再次编译,依旧存在 error: A1163E: Unknown opcode RSEG , expecting opcode or Macro 的错误,这主要是由于编译器关键字的问题,所以这里直接借鉴其他其他版本在MDK上的移植。具体修改代码如下:
PRESERVE8
THUMB
AREA CODE, CODE, READONLY
再次编译,发现这个汇编文件中还有一个警告: warning: A1581W: Added 2 bytes of padding at address 0x112,这是提示地址没对齐,那就在末尾添加一个对齐指令,具体代码如下:
OS_CPU_PendSVHandler
CPSID I ; Cortex-M7 errata notice. See Note #5
MOV32 R2, OS_KA_BASEPRI_Boundary ; Set BASEPRI priority level required for exception preemption
LDR R1, [R2]
MSR BASEPRI, R1
DSB
ISB
CPSIE I
MRS R0, PSP ; PSP is process stack pointer
STMFD R0!, { R4-R11, R14} ; Save remaining regs r4-11, R14 on process stack
MOV32 R5, OSTCBCurPtr ; OSTCBCurPtr->StkPtr = SP;
LDR R1, [R5]
STR R0, [R1] ; R0 is SP of process being switched out
; At this point, entire context of process has been saved
MOV R4, LR ; Save LR exc_return value
BL OSTaskSwHook ; Call OSTaskSwHook() for FPU Push & Pop
MOV32 R0, OSPrioCur ; OSPrioCur = OSPrioHighRdy;
MOV32 R1, OSPrioHighRdy
LDRB R2, [R1]
STRB R2, [R0]
MOV32 R1, OSTCBHighRdyPtr ; OSTCBCurPtr = OSTCBHighRdyPtr;
LDR R2, [R1]
STR R2, [R5]
ORR LR, R4, #0x04 ; Ensure exception return uses process stack
LDR R0, [R2] ; R0 is new process SP; SP = OSTCBHighRdyPtr->StkPtr;
LDMFD R0!, { R4-R11, R14} ; Restore r4-11, R14 from new process stack
MSR PSP, R0 ; Load PSP with new process SP
MOV32 R2, #0 ; Restore BASEPRI priority level to 0
MSR BASEPRI, R2
BX LR ; Exception return will restore remaining context
ALIGN
END
再次编译,os_cpu_a.asm文件内没有错误,还有两个小错误:
将os_cpu_c.c中os.h的头文件路径修改意见,将bsp_cpu.c中的bsp_clk.h头文件注释掉,再次编译。报错信息如下图:
发现报错信息都在bsp_cpu.c当中,而且都是和时钟频率相关的,打开源码例程中的bsp_clk.c文件,查看BSP_ClkFreqGet()函数,发现里面调用的函数不就是HAL库提供的吗,那我们直接将bsp_cpu.c中的时钟获取函数修改为HAL库提供的函数,不就OK了吗。修改后的代码如下所示:
#if (CPU_CFG_TS_TMR_EN == DEF_ENABLED)
void CPU_TS_TmrInit (void)
{
CPU_INT32U fclk_freq;
CPU_INT32U reg_val;
reg_val = CPU_BSP_REG_DWT_LSR;
if ((reg_val & CPU_BSP_BIT_DWT_LSR_SLI) != 0) {
if ((reg_val & CPU_BSP_BIT_DWT_LSR_SLK) != 0) {
CPU_BSP_REG_DWT_LAR = CPU_BSP_DWT_LAR_KEY;
}
}
fclk_freq = HAL_RCC_GetHCLKFreq();
CPU_BSP_REG_DEMCR |= DEF_BIT_24;
CPU_BSP_REG_DWT_CR |= DEF_BIT_00;
CPU_TS_TmrFreqSet((CPU_TS_TMR_FREQ)fclk_freq);
}
#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 = HAL_RCC_GetHCLKFreq();
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 = HAL_RCC_GetHCLKFreq();
ts_us = ts_cnts / (fclk_freq / DEF_TIME_NBR_uS_PER_SEC);
return (ts_us);
}
#endif
修改完之后,再次编译,发现了很多重复定义的错误,都适合__dbg_ucos-iii.c文件相关,那就直接移除掉这个文件,再编译看看结果如何。
编译之后发现只有一个未定义的错误,打开os_cpu.h头文件,发现了下面这行代码:
#define OS_TASK_SW_SYNC() __ISB()
明明定义了,却还是提示未定义的错误,那我搜索了一下__ISB()函数,在cmsis_armcc.h中明确定义了,难道没添加头文件引起的吗,那就添加头文件再编译一下,报错信息更多了,那很明显不是这个问题了。看到cmsis_armcc.h中有这一行代码:
#define __ISB() do {\ __schedule_barrier();\ __isb(0xF);\ __schedule_barrier();\ } while (0U)
那就直接修改成
#define OS_TASK_SW_SYNC() __isb(0xF)
这样编译倒是没问题了。但是系统运行起来有没有问题就不知道,先这么做吧,这个头文件中还有一行代码也需要修改:
#ifdef __ARMVFP__
#define OS_CPU_ARM_FP_EN 1u
#else
#define OS_CPU_ARM_FP_EN 0u
#endif
修改为
#ifdef __TARGET_FPU_SOFTVFP
#define OS_CPU_ARM_FP_EN 1u
#else
#define OS_CPU_ARM_FP_EN 0u
#endif
编译后无错误。现在这系统能够正常运行起来了吗?讲实话我也不太清楚,那就测试一下吧。
(三)测试系统
拷贝如下代码至main.c中。
#include <stdio.h>
#include <string.h>
#include <ctype.h>
#include <stdlib.h>
#include <stdarg.h>
#include <math.h>
#include <os.h>
#include <cpu.h>
#include <lib_def.h>
#include <lib_ascii.h>
#include <lib_math.h>
#include <lib_mem.h>
#include <lib_str.h>
#include <app_cfg.h>
#include "bsp_cpu.h"
//任务优先级
#define START_TASK_PRIO 2
//任务堆栈大小
#define START_STK_SIZE 512
//任务控制块
OS_TCB StartTaskTCB;
//任务堆栈
CPU_STK START_TASK_STK[START_STK_SIZE];
//任务函数
void start_task(void *p_arg);
//任务优先级
#define LED0_TASK_PRIO 3
//任务堆栈大小
#define LED0_STK_SIZE 128
//任务控制块
OS_TCB Led0TaskTCB;
//任务堆栈
CPU_STK LED0_TASK_STK[LED0_STK_SIZE];
void led0_task(void *p_arg);
//任务优先级
#define LED1_TASK_PRIO 4
//任务堆栈大小
#define LED1_STK_SIZE 128
//任务控制块
OS_TCB Led1TaskTCB;
//任务堆栈
CPU_STK LED1_TASK_STK[LED1_STK_SIZE];
//任务函数
void led1_task(void *p_arg);
//任务优先级
#define FLOAT_TASK_PRIO 5
//任务堆栈大小
#define FLOAT_STK_SIZE 256
//任务控制块
OS_TCB FloatTaskTCB;
//任务堆栈
CPU_STK FLOAT_TASK_STK[FLOAT_STK_SIZE];
//任务函数
void float_task(void *p_arg);
int main(void)
{
OS_ERR err;
CPU_SR_ALLOC();
HW_Init();
MT_Init();
OSInit(&err); //初始化UCOSIII
CPU_CRITICAL_ENTER(); //进入临界区
//创建开始任务
OSTaskCreate((OS_TCB * )&StartTaskTCB, //任务控制块
(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, //任务内部消息队列能够接收的最大消息数目,为0时禁止接收消息
(OS_TICK )0, //当使能时间片轮转时的时间片长度,为0时为默认长度,
(void * )0, //用户补充的存储区
(OS_OPT )OS_OPT_TASK_STK_CHK|OS_OPT_TASK_STK_CLR|OS_OPT_TASK_SAVE_FP, //任务选项,为了保险起见,所有任务都保存浮点寄存器的值
(OS_ERR * )&err); //存放该函数错误时的返回值
CPU_CRITICAL_EXIT(); //退出临界区
OSStart(&err); //开启UCOSIII
while(1)
{
}
}
//开始任务函数
void start_task(void *p_arg)
{
OS_ERR err;
CPU_SR_ALLOC();
p_arg = p_arg;
CPU_Init();
#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 //当使用时间片轮转的时候
//使能时间片轮转调度功能,设置默认的时间片长度s
OSSchedRoundRobinCfg(DEF_ENABLED,10,&err);
#endif
CPU_CRITICAL_ENTER(); //进入临界区
//创建LED0任务
OSTaskCreate((OS_TCB * )&Led0TaskTCB,
(CPU_CHAR * )"led0 task",
(OS_TASK_PTR )led0_task,
(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_OPT_TASK_SAVE_FP,
(OS_ERR * )&err);
//创建LED1任务
OSTaskCreate((OS_TCB * )&Led1TaskTCB,
(CPU_CHAR * )"led1 task",
(OS_TASK_PTR )led1_task,
(void * )0,
(OS_PRIO )LED1_TASK_PRIO,
(CPU_STK * )&LED1_TASK_STK[0],
(CPU_STK_SIZE)LED1_STK_SIZE/10,
(CPU_STK_SIZE)LED1_STK_SIZE,
(OS_MSG_QTY )0,
(OS_TICK )0,
(void * )0,
(OS_OPT )OS_OPT_TASK_STK_CHK|OS_OPT_TASK_STK_CLR|OS_OPT_TASK_SAVE_FP,
(OS_ERR * )&err);
//创建浮点测试任务
OSTaskCreate((OS_TCB * )&FloatTaskTCB,
(CPU_CHAR * )"float test task",
(OS_TASK_PTR )float_task,
(void * )0,
(OS_PRIO )FLOAT_TASK_PRIO,
(CPU_STK * )&FLOAT_TASK_STK[0],
(CPU_STK_SIZE)FLOAT_STK_SIZE/10,
(CPU_STK_SIZE)FLOAT_STK_SIZE,
(OS_MSG_QTY )0,
(OS_TICK )0,
(void * )0,
(OS_OPT )OS_OPT_TASK_STK_CHK|OS_OPT_TASK_STK_CLR|OS_OPT_TASK_SAVE_FP,
(OS_ERR * )&err);
CPU_CRITICAL_EXIT(); //进入临界区
OSTaskSuspend((OS_TCB*)&StartTaskTCB,&err); //挂起开始任务
}
//led0任务函数
void led0_task(void *p_arg)
{
OS_ERR err;
p_arg = p_arg;
while(1)
{
HW_Led0_On(); //LED0打开
OSTimeDlyHMSM(0,0,0,200,OS_OPT_TIME_HMSM_STRICT,&err); //延时200ms
HW_Led0_Off(); //LED0关闭
OSTimeDlyHMSM(0,0,0,500,OS_OPT_TIME_HMSM_STRICT,&err); //延时500ms
}
}
//led1任务函数
void led1_task(void *p_arg)
{
OS_ERR err;
p_arg = p_arg;
while(1)
{
HW_Led1_On();
HW_Delay_ms(500);//延时500ms
HW_Led1_Off();
HW_Delay_ms(500);
OSTimeDlyHMSM(0,0,0,100,OS_OPT_TIME_HMSM_STRICT,&err);
}
}
//浮点测试任务
void float_task(void *p_arg)
{
OS_ERR err;
CPU_SR_ALLOC();
static double double_num=0.00;
while(1)
{
double_num+=0.01f;
CPU_CRITICAL_ENTER(); //进入临界区
printf("double_num的值为: %.4f\r\n",double_num);
CPU_CRITICAL_EXIT(); //退出临界区
OSTimeDlyHMSM(0,0,0,20,OS_OPT_TIME_HMSM_STRICT,&err);
}
}
编译后,烧写进开发板,查看现象:LED灯没亮;那系统肯定没有运行起来,通过Debug看看哪里出问题了,结果发现程序停在了如下地方:
那说明是PendSV中断处理出了问题,看看整个工程中哪里需要调整。os_cpu_a.asm汇编文件中定义了OS_CPU_PendSVHandler函数,这是Micrium官方移植例程中修改了PendSV中断函数的名称,所以这边需要修改回来,然后再编译报该函数的重定义错误。
这边屏蔽掉stm32f7xx_it.c中的PendSV_Handler函数定义,再次编译;没有报错,那就再下载验证一下。结果还是失败了,那就再Debug一下,看看是哪里的问题,发现程序运行之后,开始任务调度之后就挂在空闲任务上。找来找去没发现什么问题,本来都准备放弃了,后来看到操作系统的时间都是通过滴答定时器中断产生的,然后仔细看了一下代码,虽然使用了滴答定时器,但是没有使用中断,那赶紧加上试试,顺便将stm32f7xx_it.h中定义的滴答定时器中断函数屏蔽掉。编译之后没报错,那就在测试一下。终于,LED灯如愿的闪烁起来 ,串口也正常工作起来了,说明操作系统真正运行起来了。
下面附上移植后的工程。
链接:https://pan.baidu.com/s/1AGw1SWNMI_BpX7NLsxvQdg
提取码:bzne
复制这段内容后打开百度网盘手机App,操作更方便哦