文件移植函数

UCOS移植到STM32

MBH开发的树莓派扩展板，stm32,UCOS系统移植...

【作者简介】远方，山东大学系统工程博士，MBH资深会员，擅长机械结构的设计，电子设备和编程狂热者！

Ucos移植到stm32移植时首先需要ucos源码和stm32的库函数，可以从网上下载.
如下图所示，具体内容大家可以到网上查找一下，主要是CMSIS和StdPeriphDriver，里面主要是关于stm32内核代码和库函数。在移植前需要对这个库函数进行测试，保证函数能用，避免移植后错误出现，引起过多的麻烦。

Ucos的代码从网上下载，Cpu内放置从网上下载或者大牛自己写的ucos与stm32的接口函数，主要是内核驱动。Source为ucos的源文件，从网上下载即可。UCOS-LIB里面放置的库文件，主要与内存和系统库函数有关，具体内容以后在研究。

移植将与STM32有关的文件放到STM32文件夹中，将与UCOS有关的文件放在UCOS中，将具体的驱动文件，比如串口驱动、芯片初始化等，放在Device_Driver中，将自己写的具体应用文件放在Users中。具体文件中中将同文件放在Inc中，将c文件放在Src中。
在keil5中建立如下所示工程

STM32_CMSIS放置STM32内核文件

STM32_StdPeriphDriver放置STM32的库文件

STM32_CPU放置STM32芯片的处理器接口文件用于与嵌入式系统的接口

UCOS_Source放置ucos的系统文件

UCOS_Cpu放置ucos与stm32的具体移植文件

UCOS_Lib放置ucos相关的库文件，具体使用方式以后研究

Device_Drivers放置驱动文件

Users放置用户文件

本文在main.c中建立了三个任务，两个led显示，一个串口发送。

在移植过程中主要是对包含的库文件进行修改，有些地址可能不对，还有对keil5中Options for target“Flash”中内容修改，具体大家可以找相关文档，如果修改不对可能能编译通过，但是无法运行。如果大家有什么疑问可以加我微信聊。

在移植过程中需要对OS_CPU.H, OS_CPU_C.C, OS_CPU_A.ASM进行修改，这与具体平台有关，可以直接从网上找其他人已经修改好的，可以避开相关知识，以后等熟悉了平台在仔细解读。在使用过程中，需要对OS_CFH.H, INCLUDES.H进行修改，这与具体应用程序有关，到具体应用时在进行讲解。
下面是移植中具体的内容，从网上摘抄的，大家可以参考一下
首先，简单总结一下移植的大概过程:
（1）去uC/OS-ii官网下载你要移植芯片CPU的相关案例，不一定完全对应，那就找相应系列吧。
（2）编程环境一般有两种，分别是IAR和MDK，这个根据你自己的编程环境进行下载。
（3）本案例需要将uC/OS-II 移植到STM32F103ZET6上，而我使用的编程环境是MDK,很遗憾，官网上提供的案例是基于IAR的，所以要基于IAR的案例进行更改。
（4）使用MDK创建一个无操作系统的最简单程序，确保这个程序能够使用，这样做的目的是为了一步步的排查错误，假如无操作系统时，都有错误，移植过程中也肯定会有编译错误，那么在排查错误的时候也就增加了难度，不会写物操作系统的简单程序怎么办。。。那就不要往下看了。
（5）移植的最大的改动主要有两部分，一个是一些头文件的增减，另外一个就是向量表中PendSV_Handler和SysTick_Handler的修改。这里我要吐槽一下，网上说了一大堆关于什么OS_CPU.H的更改还有各种函数的的分析，这都是扯淡。。。这些根本就不用移植者去修改，官网提供的案例都已经提供了，除非你选择移植的CPU是比较偏的，那么这些东西需要移植者自己去编写。
好了，下面就开始详细的记录怎么去移植。
一、创建一个无操作系统的简单裸板系统
1．创建源文件工程文件夹，如下图所示：

其中文件夹“CMSIS”为内核的接口，包含的文件如下图

文件夹STM32_StdPeriph为固件驱动文件夹，这个把STM32的固件全都添加进去即可。
文件夹User为其他文件，如下图所示：

文件夹Output和List主要是放那些编译产生的乱七八糟的文件，为了使工程代码更加简洁。
2.使用MDK创建无操作系统工程项目，这一点就不一一说了，将创建后的工程项目文件树截图如下：

这个时候还没有main文件，那么创建一个mian.c文档即可，这里需要注意，创建main.c后，要将其添加到项目中才行，而不是简单的保存。如下图所示：、

注意：main.c中要有一个mian函数，否则编译器会报错提示你的。然后就是项目的配置，这个还是很重要的，下面分别说需要配置的地方：

（1）Output选项如下：

这里面勾选了Create HEX File选项，同时将项目输出放到了之前创建的Output文件夹。

（2）List选项，将List产生的文件放入到之前创建的List文件夹中。

（3）C/C++配置选项如下：

其中Define选项中，填入：USE_STDPERIPH_DRIVER,STM32F10X_HD，这是告诉编译器，使用标准外设，还有选择的CPU类型，其中CPU类型需要根据你选择移植的CPU进行适当的更改。Include Paths是要包含的头文件路径，这个为了保险，将项目中的所有有.h的文件的文件夹都包含进去就可以了。

4.Debug选项如下：

,我使用的是Jlink进行烧写调试，所以选择了如图所示，还要进行settings，如下：

这里要勾选“Reset and Run”，这样做的目的是，每当烧写下载后，CPU进行复位并运行。
5.Utilities选项设置如下所示：

至此，配置完毕，编译一下，没有错误，创建一个简单的点亮LED程序，验证一下即可。
备注说明：如果按照这个步骤操作，编译，如果出现一些简单的错误，比如没有main函数，没有发现某个头文件，那么按照提示解决即可，但是如果发现了很多怪怪的编译错误，比如说未定义u32,u8这些符号时，那就要注意一下了，有可能是MDK版本的问题，我在使用MDK低版本的时候，发现有问题，而使用高版本的时候就没问题了，所以需要注意一下。
二、移植uC/OS-ii到STM32F10X上
1.首先在官网上下载基于STM32的移植工程案例，里面的移植文档AN-1018中是作者写的移植文档，说的很详细，想要移植的话，多看看这个文档。
2.其中有张图，非常重要，其实就是告诉了移植者要做的工作，如下图所示：

这个图表达了什么信息呢，其实就是告诉移植者需要将那些文件移植到你的工程当中，首先是uC/OS-ii的源文件，就是OS_CORE.C、OS_FLAG.C.....ucos_ii.H这些文件，其实是uC/OS-ii的Port文件，包括4个，分别是OS_CPU_C.C,OS_CPU_A.ASM,OS_CPU.H,OS_DBG.C,还有是用户应用程序里的包含文件，这个里面不能照搬，选择使用两个文件，分别为OS_CFG.H和INCLUDES.H，其他三个，可以自己编写，为什么不套用另外那三个呢，主要是因为那三个文件是针对官方开发板创建的任务，里面包含的信息量太大，编译的时候，肯定会有大量的错误（因为我们是一直到我们自己的板子），所以最好自己写最简单的，至于怎么写，后面再详细说，可以先建2个空文件，分别是APP.C和APP_CFG.H,这两个文件的含义很简单，APP是自己的应用程序C文件，APP_CFG.H是对我们自己的应用程序做的配置文件，看到这里可能会有个疑问，APP_VECT.C文件怎么处理呢，答案是舍弃，因为官方提供的案例是自己写启动文件，APP_VECT.C文件是向量表，我们使用的是STM32固件库里的启动代码，所以就不用使用了。BSP部分有两个文件BSP.C和BSP.H，这个也建议直接舍弃，这个是官方文档中针对他们的的开发板写的一些底层的设备驱动，我们自己的开发板跟他们的不同，所以根本就没必要要，至此，将刚刚分析的这些必须的文件加入到上面创建的无操作系统裸板程序中，进行编译。肯定会有很多错误，下面我们就一一的修改这些错误。添加到项目后的文件树，如下图所示：

需要注意的是，这其中的app.c和app_cfg.h是自己创建的空的文件，而不是使用官网案例里提供的，如果非要使用官网里面的，那么只能不停的更正其中的错误啦。下面就是要修改错误的过程了。
3.修改os_cfg.h 这个是配置uCOS-ii系统功能的头文件，根据自己的需要进行裁剪任务吧，我只做了一个修改，就是
#define OS_APP_HOOKS_EN 0

，禁用钩子函数，这是为了防止出现那些所谓的文档中分析的要写的那几个钩子函数出现错误，禁用钩子函数了，也就不用写钩子函数了，其他的根据自己需要裁减吧。

4.OS_CPU_A.ASM文件的修改

首先是修改

为

这样修改的目的，是因为MDK编程环境不认识PUBLIC，要用EXPORT.

其次是修改：

为：

这个也是因为编程环境的问题。
5.修改OS_DBG.C
修改： #define OS_COMPILER_OP __root为：
#define OS_COMPILER_OPT原因也是编程环境的问题。
6.修改启动代码
这个步骤是移植的核心：上面说的其他的修改，都是一些附属的格式方面的修改，而启动代码的修改才是移植的核心，这里简单的分析2个问题，一是，什么叫移植，二是移植的操作系统如何能够被我们的工程所应用。所谓移植，打一个恰当的比喻——器官移植，就是将A的器官移植到B身上，使A的器官能够为B所用。所以移植绝对不是简单的“复制”，不仅要放到你的工程项目中，更重要的是要能够和你的项目建立联系。那么uCOS-ii怎么跟STM32建立联系呢？
uCOS-ii的核心作用就是任务调度，要使用STM32的一个特殊中断——PendSV，就是可挂起系统任务中断，通过该中断进行系统的调度。还有就是uCOS-ii需要一个基准时间，那么STM32中有一个专用的定时器，嘀嗒定时器SysTick，这个定时器，就是专为操作系统而设计的，通过这个滴答定时器给uCOS-ii提供一个时间基准，每隔固定的时间出发一个PendSV中断，进行任务的调度。所以呢，在官方案例的移植文档AN-1018中也特别提到这一点，要将启动代码中所有“PendSV_Handler”和“SysTick_Handler”，替换成“OS_CPU_PendSVHandler”和“OS_CPU_SysTickHandler”，这样就相当于将uCOS-ii的“神经”跟你的项目的“神经”搭在了一起。
7.此时编译，发现还有一个错误：

error: #20:identifier "os_task_tmr_prio" is undefined

在uCOS-ii源码中查找OS_TASK_TMR_PRIO定义，原来这个定义在源码文件app_cfg.h中，如下所示：

比葫芦画瓢，复制到自己创建的那个空白app_cfg.h中。然后编译，发现已经还有的错误就是在includes.h中，说没有包含一些的头文件，这个把includes.h中对应错误的那些包含头文件代码删掉即可，这是因为我们没有完全的使用官方案例中的所有文件。至此移植的修改工作告一段落，已经完成。
8.创建任务，验证移植效果。

这个可以参照源代码中APP.C进行创建任务，在app_cfg.h中编写各个任务的配置文件，这里需要注意的是，我们之前创建的裸板中已经有main.c文件，其中已经有main.c函数，所以我们在app.c中就不必再创建main函数了，直接在main函数中初始化uCOS-ii，然后创建一个任务，或者调用一个函数，在这个任务或者函数中再创建需要的几个任务即可。案例如下图所示：

其中需要注意的是，在创建的第一个任务里，一定要先初始化嘀嗒定时器，这个是仿照官方案例中的代码格式写的，直接使用OS_CPU_SysTickInit(),可能在编译的时候，会发现这个嘀嗒定时器初始化启动函数有报错，这个一般是没有包含这个函数中调用的函数，或者直接没有，那么在源代码中搜索这个函数，比葫芦画瓢照抄写就行啦。
另外特别注意，官网代码的创建的第一个开始任务里有一段代码，如下图所示：