UCOS2_STM32F1移植详细过程(三)

Ⅰ、概述

上一篇文章是讲述ST芯片相关的配置和OS裁剪相关的配置,接着上一篇文章来讲述关于UCOS的移植,该文主要针对uC/OS-II Ports下面os_cpu_a.asm、os_cpu_c.c和os_cpu.h文件底层端口代码来讲述。

请下载“UCOS2_STM32F1_3个简单任务”作为参考工程。

笔者将“UCOS移植详细过程”分为多篇文章来讲述,敬请关注。

关于本文的详情请往下看(微信请点击“阅读原文”查看内容链接内容)。

本着免费分享的原则,方便大家手机学习知识,定期在微信平台分享技术知识。如果你觉得分享的内容对你有用,又想了解更多相关的文章,请用微信搜索“EmbeddDeveloper” 或者扫描下面二维码、关注,将有更多精彩内容等着你。

UCOS2_STM32F1移植详细过程(三) 

Ⅱ、下载

笔者将F0、F1、F3、F4移植到最新UCOS2.92上。移植好的、独立的4个工程供大家下载学习、研究。建立的任务都是一样的,只是针对芯片不同,Ports目录下相关的源代码有差异、标准外设库也存在差异。每一个系列针对不同型号芯片只需要适当改一下“型号”就行了。

提供下载的软件工程都是在板子上运行,保证没问题才上传至360云盘。

UCOS基于STM32F0系列实例:

https://yunpan.cn/cRCZrQ3dzeVQq  访问密码

UCOS基于STM32F1系列实例:

https://yunpan.cn/cRCZxGFsqHa6Q  访问密码

UCOS基于STM32F3系列实例:

https://yunpan.cn/cRCZqPRCWs8UW  访问密码

UCOS基于STM32F4系列实例:

https://yunpan.cn/cRCZPqbFqXSPR  访问密码

UCOS源代码工程

官网下载(需要账号):

https://www.micrium.com/downloadcenter/download-results/?searchterm=hm-stmicroelectronics&supported=true

360云盘下载(定期更新至最新):

https://yunpan.cn/cRzcf8eSacEhE  访问密码 1235

ST标准外设库

官网下载(需要账号):

http://www.st.com/content/st_com/en/products/embedded-software/mcus-embedded-software/stm32-embedded-software.html?querycriteria=productId=SC961

360云盘下载(定期更新至最新):

https://yunpan.cn/cSaCpGejMSfr8  访问密码 60ae

参考资料:

https://yunpan.cn/cRCdSt73GwT6j  访问密码 499e

Ⅲ、工程目录结构说明

UCOS2_STM32F1移植详细过程(三)

文件结构和工程目录结构对应关系如上图所示。

第一类(标准外设库):

Startup Code:启动代码

STM32F10x_StdPeriph_Driver:标准外设库库驱动

CMSIS:标准接口

第二类(µC/OS-II实时内核):

uC/OS-II Source:内核源代码(与处理器无关)

uC/OS-II Ports:OS端口底层代码(与处理器、编译平台有关)

第三类(用户应用):

Bsp:应用底层代码(初始化、驱动等)

App:应用实现代码(配置OS、应用等)

该文主要针对uC/OS-II Ports进行移植描述。我们不使用UCOS自带的调试功能,这里就不再描述(使用)os_dbg.c文件。

Ⅳ、配置os_cpu_a.asm文件

os_cpu_a.asm文件位于工程uC/OS-II Ports结构下面,主要是系统底层相关的一部分汇编代码。

该文件主要对外部引用(全局变量、函数)做了一个申明,及部分系统相关源代码(汇编)做了一个定义。

下面我将定义的几个源代码做一个描述,移植过程需要修改的我会重点提示出来。

1.全局申明

UCOS2_STM32F1移植详细过程(三)

该文件开头对全局变量和函数进行了一次声明,只是使用的汇编,就如C语言里面的extern。

上面部分是外部(其他源文件)定义的变量和函数,下面部分是申明本文件定义的函数,下面我会对这定义的源代码进行讲述。

将OS_CPU_PendSVHandler改为PendSV_Handler,为了兼容ST标准外设库启动代码(startup_stm32f10x_hd.s)。

2.NVIC配置

UCOS2_STM32F1移植详细过程(三)

这部分是对NVIC(中断控制)寄存器相关进行定义,就如预处理中宏定义一样,对寄存器地址,状态进行定义。

3.代码生成指令

UCOS2_STM32F1移植详细过程(三)

这几条指令主要是针对汇编指令的一个处理。

4.状态保存与恢复

UCOS2_STM32F1移植详细过程(三)

这两个汇编函数是程序运行在临界区,对数据的保存和恢复的函数。主要作用就是保护数据不被破坏。

5.运行最高优先级任务

UCOS2_STM32F1移植详细过程(三)

这个函数在任务切换的时候调用,知道任务切换原来的朋友来说这里不难理解。UCOS是按优先级来执行任务,优先级越高(优先级数值越小),越容易被执行。当执行的任务处于挂起(或删除)时,系统就需要进行任务切换,切换的规则就是切换到最高优先级去执行。

6.上下文切换

UCOS2_STM32F1移植详细过程(三)

系统切换任务可以从两个地方,也就是从任务级和中断级。这两个函数的意思都一样,当需要执行任务切换时,根据条件执行某一个。

7.PendSV_Handler中断

UCOS2_STM32F1移植详细过程(三)

PendSV_Handler中断函数定义于这里,主要是在执行该中断对M3内核寄存器进行一些操作(保存与修改)。

将OS_CPU_PendSVHandler改为PendSV_Handler,为了兼容ST标准外设库启动代码(startup_stm32f10x_hd.s)。

8.总结os_cpu_a.asm

对于UCOS的移植,os_cpu_a.asm文件主要就是修改OS_CPU_PendSVHandler的名称,包含申明时的名称和定义源代码时的名称,其他源代码保持不变。

Ⅴ、配置os_cpu_c.c文件

os_cpu_c.c文件位于工程uC/OS-II Ports结构下面,主要是系统底层相关的一部分C语言接口代码。

该文件有许多HOOK函数,也就是所谓的钩子函数,主要用于系统初始化、与任务相关等,如:系统初始化时OSInitHookBegin()、OSInitHookEnd(); 创建任务时OSTaskCreateHook等。其实我们自己移植,有很多HOOK函数是不需要使用,或者不用去实现函数体里面的代码。下面我将讲述几个重要的函数,有些不重要的HOOK函数不再讲述。

下面我将定义的几个源代码做一个描述,移植过程需要修改的我会重点提示出来。

1.系统滴答

UCOS2_STM32F1移植详细过程(三)

UCOS2_STM32F1移植详细过程(三)

这些都是关于SysTick系统滴答的宏定义和函数体,由于我们使用M3标准(ST库里面有)的SysTick系统滴答函数接口,我们屏蔽掉os_cpu_c.c里面SysTick相关的定义。

2.OSInitHookBegin

UCOS2_STM32F1移植详细过程(三)

这个函数被OSInit()开头调用,也就是我们main函数开始调用OSInit()就会调用它。

注意:

#if OS_CPU_HOOKS_EN > 0u

也就是需要在os_cfg.h文件里面配置OS_CPU_HOOKS_EN>0.

3.OSTaskStkInit初始化任务堆栈

UCOS2_STM32F1移植详细过程(三)

这个函数比较重要,在创建任务的时候调用它。主要是对芯片内核寄存器进行一个配置,并现场保护数据。这个函数根据芯片内核不同,也存在很大不同。

Ⅶ、配置os_cpu.h文件

os_cpu.h文件位于工程uC/OS-II Ports结构下面,主要是系统底层相关的某些定义(堆栈、数据类型)、申明(函数)等。

该文件下面源代码比较简单,有些不使用,即移植过程需要修改的我会重点提示出来。

1.OS数据类型

UCOS2_STM32F1移植详细过程(三)

这部分是为系统定义相关的数据类型,这里不用修改。

2.临界区管理

UCOS2_STM32F1移植详细过程(三)

我们使用默认使用临界区第3模式,这个定义主要是与os_cpu_a.asm文件中定义OS_CPU_SR_Save()函数有关。

3.函数申明

UCOS2_STM32F1移植详细过程(三)

函数申明比较简单,这里有几个函数我们在os_cpu_a.asm和os_cpu_c.c文件中都屏蔽掉了的,这里也将他们屏蔽掉。

Ⅷ、说明

相关的文章可以到我博客上查看,我也会定期更新,新内容第一时间在微信分享。

当你掌握UCOS在一种平台上的移植,其他平台移植原理类似,请不要局限某一平台。

以上总结仅供参考,若有不对之处,敬请谅解。

Ⅸ、最后

关注微信,回复“更多内容”,将获得更多内容(如:UCOS实例等,不断更新中......)。

如果你喜欢我分享的内容,你又想了解更多相关内容,请关注文章开头的微信公众号,新内容持续更新中,后期将会有更多精彩内容出现。

上一篇:C#结婚吧(if else if)


下一篇:【山外笔记-云原生】《Docker+Kubernetes应用开发与快速上云》读书笔记-2020.04.25(六)