uCOSII移植LPC2119_Keil

【@.1 移植准备】

目标CPU：LPC2119。ARM7TDMI，最高主频60MHz，Flash128KB，RAM20KB，ARM7系列的中断机制可以参考我的这篇文章<uCOS-II的中断-ARM7实现中断嵌套的方法探究>。

OS：uCOS-II，具体内核版本参考官网。应该已经出到2.90以上了，不过移植时的版本可能没这么高。对于uCOS-II的任务切换机制可以参考我的这篇文章<uCOS-II中的任务切换机制>。

Toolchain：Keil，目前我使用的版本是MDK4.60，移植时也用MDK4.60来建立。

官网移植工程下载：不能仅仅下载内核，需要下载整个移植工程进行移植工作。参考官网移植工程时需要注意的是，移植目标CPU内核与自己的CPU一样或相近，uCOS版本不要太旧，编译器跟自己需要使用的编译器一样(比如Keil)。移植时我参考的是

NXP LPC2148（μC/OS-II μC/OS-II V2.85 μC/Probe V1.30， IAR (EWARM) V4.x IAR (EWARM) V5.x Keil MDK V3.x 2012/12/06）

由于官网不断更新，所以可能以后我参考的移植工程就不在网上了。

希望在移植系统时要仔细了解目标CPU的内核机制和对应OS的一些基本原理，即使自己不编写底层移植代码也不能照着下面的步骤，最后能用了事。这样是得不到锻炼的，如果需要移植到其他的CPU，或者移植其他OS时就又不会了，又上网找别人的工程伸手要。

【@.2 工程模板建立】

解压下载的移植工程，仔细阅读解压目录下的ReadMe.pdf，会有详细的目录结构讲解，这里我就不重复了。

uCOS的通用源代码在Micrium\Software下，此文件夹下的各个子文件夹就是uCOS的各个模块。其中uCOS-II是主要源代码，uC-CPU,uC-LIB是必要的模块，uCOSView和uC-Probe可以不用。若要使用别的模块也可以参考这里，一个模块一个文件夹，比如shell和uCGUI。

在这个文件夹下有示范工程例程，用MDK3.xx版本写的，路径这里就不列出来了，因为每次下载的移植工程可能不一样。

先不打开MDK，首先工程文件夹目录如下：

[根目录文件名取工程名字]
+---App
|       app.c        //拷贝自下载的移植工程同名文件，此文件为用户应用程序代码。此文件还需要修改
|       app_cfg.h    //拷贝自下载的移植工程同名文件，自己的任务相关配置（如优先级，堆栈大小）
|       includes.h   //拷贝自移植工程同名文件,源程序都需包含它作为include入口
|       os_cfg.h     //拷贝自移植工程同名文件，uCOS的功能配置文件，只需根据自己需要的功能修改宏定义
|      
+---Bsp
|       bsp.c        //拷贝自移植工程，但是需要修改
|       bsp.h        //拷贝自移植工程，但是需要修改
|       LPC21xx.h    //拷贝自MDK安装目录下\ARM\INC\Philips\ 的头文件
|       Startup.s    //拷贝自MDK安装目录下\ARM\Startup\Philips 的Startup.s。需要修改
|      
+---Libraries        //公司或自己的通用函数库。现在没有可以不放文件
+---Micrium          //uCOS的核心代码，主要拷贝自uCOS的各个模块
|   +---uC-CPU       //拷贝移植工程下整个文件夹。由于LPC2119跟移植CPU差不多所以不需要修改
|   |       cpu.h
|   |       cpu_a.s
|   |       cpu_def.h
|   |      
|   +---uC-Lib      //拷贝移植工程下整个文件夹,uCOS的常用预定义和内存、字符串库，一般不需要修改
|   |       lib_def.h
|   |       lib_mem.c
|   |       lib_mem.h
|   |       lib_str.c
|   |       lib_str.h
|   |      
|   \---uCOS-II     //拷贝移植工程下整个文件夹,
|       +---Port    //移植uCOS时按手册要求需要编写的代码。LPC2119跟移植CPU差不多，所以不需要修改
|       |       os_cpu.h
|       |       os_cpu_a.asm
|       |       os_cpu_c.c
|       |       os_dbg.c
|       |      
|       \---Source  //uCOS的内核代码，千万不要修改
|               os_core.c
|               os_flag.c
|               os_mbox.c
|               os_mem.c
|               os_mutex.c
|               os_q.c
|               os_sem.c
|               os_task.c
|               os_time.c
|               os_tmr.c
|               ucos_ii.h
|              
\---Solution      //与MDK工程相关的文件都放在这里
    |
    |  
    +---LIST      //MDK中的List输出文件夹，待MDK中修改
    +---MDK       //MDK的工程文件就放在这里，如下面文件名
    |      
    |       LPC2119_uCOS-II.uvproj
    |      
    \---OBJ       //MDK的目标输出文件夹，待MDK中修改

这个文件结构建好之后如图所示。不要忘了其中的需要拷贝/建立源代码。

之后打开MDK新建工程。打开MDK->新建工程，选择保存路径在刚才新建的文件夹下的\Solution\MDK\ 中，名字自己随便取。CPU选择NXP->LPC2119，当提示是否需要拷贝启动代码到工程文件夹下时选择否，因为我们自己拷贝过了。左侧的Project右击Target 1 -> Manage Components，之后需添加刚才所拷贝/新建的源文件。Project Targets改名随便，比如LPC2119_Target.将中间Group一栏改名为App，点击右侧Add Files可以将源文件添加到这一个Group中。按照之前的文件结构，添加Group的文件如下

可以看到MDK中的工程目录跟实际硬盘上的文件结构是基本一致的，这也便于对MDK工程的理解。右键工程，点击Options for ... 编辑工程属性。

Output选项卡点击Select folder for object，选为刚才新建的目录\Solution\OBJ，选中Create HEX file，Name for Excutable修改为自己需要的hex文件名。最好不要包含'-'等字符。

Listing选项卡点击Select folder for listing，选为刚才新建的目录\Solution\LIST

C/C++选项卡中的Including Path可以选择工程中所用到的头文件搜索路径，点击右侧可添加。这里添加如下

..\..\App

..\..\Bsp

..\..\Libraries

..\..\Micrium\uC-Lib

..\..\Micrium\uCOS-II\Port

..\..\Micrium\uCOS-II\Source

..\..\Micrium\uC-CPU

均为刚才所建工程目录下的文件。以后若新添加的头文件在别的目录也需要在这里添加。

Utilities选项卡 ->J-Link Settings->Add 找到LPC2000 IAP 128KB Flash即可用J-Link即可debug和下载

至此MDK工程设置结束，下面修改代码

【@.3 移植代码修改】

Startup.s是主要修改的文件。在MDK中的Startup.s比较简单，我们需要修改ISR中断入口函数使之与uCOS的中断通用处理函数连接起来即可。

找到 AREA RESET, CODE, READONLY 端， 这一段是此汇编的户口，下面的Vectors标签即所有的中断入口偏移表。在Vectors前面，添加如下代码

IMPORT OS_CPU_ARM_ExceptUndefInstrHndlr

IMPORT OS_CPU_ARM_ExceptSwiHndlr

IMPORT OS_CPU_ARM_ExceptPrefetchAbortHndlr

IMPORT OS_CPU_ARM_ExceptDataAbortHndlr

IMPORT OS_CPU_ARM_ExceptIrqHndlr

IMPORT OS_CPU_ARM_ExceptFiqHndlr

这表示以上IMPORT的函数在别的文件中有定义。而在uCOS中这些函数是在uCOS-II/Port中的os_cpu_a.asm中用汇编写好的。本来这些代码是需要移植时参考uCOS手册的要求和移植的芯片手册自己编写，但是我们下载的移植工程已经写好，我们只需要将这些函数与启动代码中的中断入口链接起来即可。

在Vectors中的IRQ中断一列，Keil可能是下面这样写的：

;LDR PC, IRQ_Addr

LDR PC, [PC, #-0x0FF0] ; Vector from VicVectAddr

其实第一句被注释掉了，所以起作用的是第二句，这句话直接将IRQ的中断跳转到PC, #-0x0FF0，也就是地址位于0xFFFFF030的VICVectAddr寄存器，这是LPC的中断控制器，中断向量的入口地址，按照LPC2000系列的规定这里存放了我们在程序中注册的中断服务程序地址。因此采用第二句话实际上是将中断直接交给LPC的中断控制器进行中断控制。但是我们需要将IRQ中断交给uCOS一并管理所以需要修改，应该采用第一句的LDR PC, IRQ_Addr进行偏移，之后再进行如下程序的链接。

Reset_Addr DCD Reset_Handler

Undef_Addr DCD OS_CPU_ARM_ExceptUndefInstrHndlr

SWI_Addr DCD OS_CPU_ARM_ExceptSwiHndlr

PAbt_Addr DCD OS_CPU_ARM_ExceptPrefetchAbortHndlr

DAbt_Addr DCD OS_CPU_ARM_ExceptDataAbortHndlr

DCD 0 ; Reserved Address

IRQ_Addr DCD OS_CPU_ARM_ExceptIrqHndlr

FIQ_Addr DCD OS_CPU_ARM_ExceptFiqHndlr

删掉源文件中Keil对中断地址的定义，修改为如上的uCOS的中断入口。其中IRQ_Addr将跳转到OS_CPU_ARM_ExceptIrqHndlr，也就是交给uCOS对IRQ中断进行控制。所以不管移植到哪种CPU上，所有的异常和中断的入口都要像上面一样进行重新定位，到自己编写的os_cpu_a.asm中的对应函数。最终的RESET代码段的代码修改如下：

另外，由于uCOS要求在LCP2xxx上应该运行在Supervisor模式，而Keil默认的启动代码在结束startup后是进入的User模式，权限太低不能进行一些特定的汇编指令操作，因此在Startup.s的下面，初始化堆栈中Enter User Mode and set its Stack Pointer下面的代码全部删除或注释掉，需要删除或注释的代码如下

; MSR CPSR_c, #Mode_USR

; IF :DEF:__MICROLIB

; EXPORT __initial_sp

; ELSE

; MOV SP, R0

; SUB SL, SP, #USR_Stack_Size

; ENDIF

这里我们不再进入用户模式对堆栈初始化了，因为进入了用户模式之后要切换到Supervisor模式需要使用软件中断，不能简单的进行切换，比较麻烦，所以干脆舍弃用户模式，我们永远不进入用户模式也不需要对其堆栈初始化，这里只需要保证堆栈初始化时最后一个是对Supervisor模式进行的堆栈初始化即可保证进入main函数之后不在其他模式下进行的。所以像STM32这样没有那么多复杂的模式的CPU移植起来就简单得多。

下面不是具体的代码操作，但是还是说一些注意事项

@->app.c中保留下列函数用于application hook 功能，里面空即可，否则编译时找不到函数定义，

#if (OS_APP_HOOKS_EN > 0)

void App_TaskCreateHook (OS_TCB *ptcb) { ;}

void App_TaskDelHook (OS_TCB *ptcb){ ;}

#if OS_VERSION >= 251

void App_TaskIdleHook (void){ ;}

#endif

void App_TaskStatHook (void){ ;}

#if OS_TASK_SW_HOOK_EN > 0

void App_TaskSwHook (void){ ;}

#endif

#if OS_VERSION >= 204

void App_TCBInitHook (OS_TCB *ptcb){ (void)ptcb; }

#endif

#if OS_TIME_TICK_HOOK_EN > 0

void App_TimeTickHook (void){ ;}

#endif

#endif

所以可以看到其实也可以在os_cfg.h中将OS_APP_HOOKS_EN设置为0关掉这个功能。不过为了了解uCOS-II的所有特性以免井底之蛙，现在暂时留着。

主函数和任务函数现在先保留，可以根据自己的任务需要另作修改

@->app_cfg.h中包含的是任务堆栈大小和优先级，以及一些其他应用程序相关的定义。

@->bsp.c中的Tmr_TickISR_Handler(void)需要保留，这是uCOS ticker的服务代码，这个ticker使用的是LPC中的Timer0中断，因此这个服务函数必须保留。

OS_CPU_ExceptHndlr(CPU_INT32U)这个函数必须保留，这是所有异常发生时都将进入的函数，这里可能只写了IRQ发生时的代码，其他异常发生时都将进入死循环(除了Reset)。也可以自己添加其他异常代码，不过小的应用也不需要。

【@.4 移植工程测试代码】

下面仅仅列出app.c中的用户代码，注意，实际对硬件操作的功能函数都在bsp.c中，所以每个移植工程的实际bsp.c是不一样的。

主函数中需首先对OS初始化，再新建至少一个任务，最后调用OSStart()之后则完成整个OS的启动过程。一般新建的一个任务叫做启动任务(Task Starter)，其中需进行OS所需的系统时钟中断的启动(这里包含在了BSP_Init()硬件初始化函数中)，之后再新建其他任务。这里的启动任务中不建立新的任务，仅仅进行通过延时对小灯进行亮、灭的控制。将整个工程编译后下载即可观察到运行效果。

最后附工程模板的下载链接

LPC2119_uCOSPrj.7z

另外添加一个实现了中断机制的工程模板，利用两个外部中断控制流水灯的启停。可以参考这个源文件看看uCOS-II中的中断是怎么编写的。

LPC2119_uCOSPrj_LEDSample.7z

@.[FIN]      @.date->Mar 28, 2013      @.author->apollius