UCOS-II移植的基本操作

工程结构组织如下：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-LCrgvXxD-1631626429715)(图片/图片1.bmp)]

其中 uCOSII_core 是uCOS的内核文件，与平台无关，所以无需修改。

在移植uCOS-II时我们只需要关注 uCOSII_port中三个文件和stm32f10x_it.c就可以了：

+++

第一个文件：os_cpu.h

1.定义与编译器相关的数据类型，无需修改

typedef unsigned char  BOOLEAN;typedef unsigned char    INT8U;             // Unsigned 8 bit quantity
typedef signed  char        INT8S;             // Signed  8 bit quantity
typedef unsigned short   INT16U;          // Unsigned 16 bit quantity
typedef signed  short       INT16S;          // Signed  16 bit quantity
typedef unsigned int        INT32U;         // Unsigned 32 bit quantity
typedef signed  int            INT32S;          // Signed  32 bit quantity
typedef float                       FP32;             // Single precision floating point
typedef double                  FP64;              // Double precision floating point
typedef unsigned int        OS_STK;          // Each stack entry is 32-bit wide
typedef unsigned int        OS_CPU_SR;   // Define size of CPU status register (PSR=32 bits)

2.因为CM3是32位宽的，所以OS_STK（堆栈的数据类型）被类型重定义为unsigned int；
因为CM3的状态寄存器（xPSR）是32位宽的，因此OS_CPU_SR被类型重定义为unsigned int；OS_CPU_SR是在OS_CRITICAL_METHOD方法3中保存cpu状态寄存器用的。在CM3中，移植OS_ENTER_CRITICAL()，OS_EXIT_CRITICAL()选方法3是最合适的。

#define OS_CRITICAL_METHOD    3
typedef unsigned int    OS_STK
typedef unsigned int    OS_CPU_SR

3.μC/OS-II定义了三种方法关闭和打开中断（OS_CRITICAL_METHED=1,2,3），
通常情况下，我们都是选用的方法3，这里定义了两个宏来禁止和允许中断

#if OS_CRITICAL_METHOD == 3
#define OS_ENTER_CRITICAL() {cpu_sr = OS_CPU_SR_Save();}
#define OS_EXIT_CRITICAL()    {OS_CPU_SR_Restore(cpu_sr);}
#endif

具体定义宏OS_ENTER_CRITICAL()和OS_EXIT_CRITICAL()，其中OS_CPU_SR_Save() //关中断和OS_CPU_SR_Restore() //开中断是用汇编代码写的，代码在os_cpu_a.asm中。

4.定义栈的增长方向
#define OS_STK_GROWTH 1
置OS_STK_GROWTH为0，表示堆栈从下往上增长；置OS_STK_GROWTH为1，表示堆栈从上往下增长。

5.定义OS_TASK_SW()宏，任务级上下文切换
#define OS_TASK_SW() OSCtxSw()
任务级上下文切换（即任务切换）调用宏定义OS_TASK_SW()。因为上下文切换跟处理器有密切关系，OS_TASK_SW()实质上是调用汇编函数OSCtxSW() ，它在os_cpu_a.asm文件中定义。

6.注释掉如下函数，并添加void PendSV_Handler(void)的函数声明

#if OS_CRITICAL_METHOD == 3
OS_CPU_SR OS_CPU_SR_Save(void);
void    OS_CPU_SR_Restore(OS_CPU_SR cpu_sr);
#endifvoid    OSCtxSw(void);void    OSIntCtxSw(void);void    OSStartHighRdy(void);void    PendSV_Handler(void); // void        OS_CPU_PendSVHandler(void);
// void        OS_CPU_SysTickHandler(void);
// void        OS_CPU_SysTickInit(void);
// INT32U   OS_CPU_SysTickClkFreq(void);

申明几个函数，这里要注意最后四个函数需要注释掉，为什么呢？

**OS_CPU_SysTickHandler()**定义在os_cpu_c.c中，是SysTick中断的中断处理函数，而stm32f10x_it.c，中已经有该中断函数的定义SysTick_Handler()，这里也就不需要了；
**OS_CPU_SysTickInit()**定义在os_cpu_c.c中，用于初始化SysTick定时器，它依赖于OS_CPU_SysTickClkFreq()，而此函数我们自己会实现，所以注释掉；
**OS_CPU_SysTickClkFreq()**定义在BSP.C (Micrium\Software\EvalBoards)中，而本文移植中并未用到BSP.C，后面我们会自己实现，因此可以把它注释掉。
OS_CPU_PendSVHandler()在启动文件上，一般我们自己开发基于stm32芯片的软件，都会使用标准外设库CMSIS中提供的启动文件，而官方移植的启动文件却是自己写的，在两个文件init.s，vectors.s中（Micrium\Software\EvalBoards\ST\STM3210B-EVAL\RVMDK）。init.s负责进入main()，vectors.s设置中断向量。OS_CPU_SysTickHandler和OS_CPU_PendSVHandler就是在vectors.s中被设置的。我的移植是使用标准外设库CMSIS中startup_stm32f10x_md.s作为启动文件的，那该怎么在这个文件中设置OS_CPU_SysTickHandler呢，事实上在startup_stm32f10x_md.s文件中，PendSV中断向量名为PendSV_Handler，所以只需用PendSV_Handler把所有出现OS_CPU_PendSVHandler的地方替换掉就可以了。

我们有提到在startup_stm32f10x_md.s中我们有定义PendSV_Handler，其中PendSV_Handler函数在我们CM3中也有实现，就在stm32f10x_it.c和stm32f10x_it.h中，现在我们选择使用uCOS的PendSV_Handler函数，所以应该将stm32f10x_it.c和stm32f10x_it.h中的PendSV_Handler函数注释起来。

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-8wmyht1i-1631626429717)(图片/图片2.bmp)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-UTGJIy10-1631626429719)(图片/图片7.bmp)]

+++

第二个文件：os_cpu_c.c

ucosii移植时需要我们写10个相当简单的C函数

OSInitHookBegin()
OSInitHookEnd()
OSTaskCreateHook()
OSTaskDelHook()
OSTaskIdleHook()
OSTaskStatHook()
OSTaskStkInit()
OSTaskSwHook()
OSTCBInitHook()
OSTimeTickHook()

这些函数除了OSTaskStkInit()，都是一些hook函数。这些hook函数如果不使能的话，都不会用上，也都比较简单，看看就应该明白了，所以就不介绍

OS_STK *OSTaskStkInit (void (*task)(void *p_arg), void *p_arg, OS_STK *ptos, INT16U opt)
{OS_STK *stk;(void)opt;                 /* 'opt' is not used, prevent warning    */stk    = ptos;             /* Load stack pointer                     *//* Registers stacked as if auto-saved on exception  */(stk)  = (INT32U)0x01000000L;          /* xPSR           */*(--stk) = (INT32U)task;               /* Entry Point    */*(--stk) = (INT32U)0xFFFFFFFEL;        /* R14 (LR) (init value will cause fault if ever used)*/*(--stk) = (INT32U)0x12121212L;        /*  R12    */*(--stk) = (INT32U)0x03030303L;        /*  R3     */*(--stk) = (INT32U)0x02020202L;        /*  R2     */*(--stk) = (INT32U)0x01010101L;        /*  R1     */*(--stk) = (INT32U)p_arg;              /*  R0 : argument   *//* Remaining registers saved on process stack   */*(--stk) = (INT32U)0x11111111L;        /*  R11    */                            *(--stk) = (INT32U)0x10101010L;        /*  R1     */                           *(--stk) = (INT32U)0x09090909L;        /*  R9     */                        *(--stk) = (INT32U)0x08080808L;        /*  R8     */                       *(--stk) = (INT32U)0x07070707L;        /*  R7     */                    *(--stk) = (INT32U)0x06060606L;        /*  R6     */                   *(--stk) = (INT32U)0x05050505L;        /*  R5     */                **(--stk) = (INT32U)0x04040404L;        /*  R4     */              return (stk);
}

xPSR，PC，LR，R12，R3-R0被自动保存到栈中的，R11-R4如果需要保存，只能手工保存。因此OSTaskStkInit()的工作就是在任务自己的栈中保存cpu的所有寄存器。这些值里R1-R12都没什么意义，这里用相应的数字代号（如R1用0x01010101）主要是方便调试。
其他的几个函数都可以空着，例如：

#if (OS_CPU_HOOKS_EN > 0) && (OS_TASK_SW_HOOK_EN > 0)
void OSTaskSwHook (void)
{
#if OS_APP_HOOKS_EN > 0App_TaskSwHook();
#endif
}
#endif

注释掉其中的一些内容
把OS_CPU_SysTickHandler(), OS_CPU_SysTickInit()注释掉。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-z97UT5p5-1631626429719)(图片/图片3.bmp)]

把上面这些宏定义也注释掉，因为它们都用于OS_CPU_SysTickHandler(), OS_CPU_SysTickInit()。

++++

第三个文件：os_cpu_a.asm

在os_cpu_a.asm中定义了4个与处理器相关的汇编函数，我们是从micrium网站上下载官方移植版本，所以其中的函数都已经实现了，如果需要了解的可以参照《Cortex-M3权威指南》。
我们在注释掉os_cpu.h中的OS_CPU_PendSVHandler() 提到需用PendSV_Handler把所有出现OS_CPU_PendSVHandler的地方替换掉,而这些需要替换掉的内容就在os_cpu_a.asm中，只需将下面的地方替换就好了

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-OfdTieiU-1631626429720)(图片/图片4.bmp)]

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-du3X2ZGp-1631626429722)(图片/图片5.bmp)]

第四个文件：stm32f10x_it.c

在前面修改os_cpu.h 文件时注释过一个OS_CPU_SysTickHandler()，是因为这个函数是提供系统时钟中断的，而在我们CM3中已经有了自己的系统时钟中断函数，就是stm32f10x_it.c的void SysTick_Handler(void),在这里只需要把OS_CPU_SysTickHandler()的内容复制给SysTick_Handler()即可(记得把头文件包含进来)：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-44tGlxuE-1631626429722)(图片/图片6.bmp)]

++++

到这里为止我们的移植就算是完成了，接下来任务就是在app.c文件中实现我们的测试程序了

#include "includes.h"static OS_STK task_led1_stk[LED1_TASK_STK_SIZE];static void systick_init(void)
{RCC_ClocksTypeDef rcc_clock;
RCC_GetClocksFreq(&rcc_clock);
SysTick_Config(rcc_clock.HCLK_Frequency/OS_TICKS_PER_SEC);
}void LED1_Tast(void *p_arg)
{p_arg=p_arg;while(1)
{GPIO_WriteBit(GPIOA, GPIO_Pin_15, Bit_RESET);OSTimeDlyHMSM(0, 0,1,0);GPIO_WriteBit(GPIOA, GPIO_Pin_15, Bit_SET);OSTimeDlyHMSM(0, 0,1,0);
}
int main(void)
{BSP_Init();OSInit();systick_init();OSTaskCreate(LED1_Tast,(void *)0,&task_led1_stk[LED1_TASK_STK_SIZE-1],LED1_TASK_PRIO);  OSStart();return 0;
}

如果LED灯出现闪烁的话就大功告成了！