从裸机开始，创建一个RT-Thread Nano系统工程

AndyRTThread · 发表于 2017-8-28 11:07:32

——/// 概述 \\\——

☟☟☟

RT-Thread Nano是一个精炼的硬实时内核，支持多任务处理、软件定时器、信号量、邮箱和实时调度等相对完整的实时操作系统特性，用户可以直接从MDK的Run-time Environment获取，可以使用shell高效地进行在线动态调试。

在支持semaphore和mailbox特性，并运行两个线程(main线程+idle线程)情况下，ROM和RAM依然保持着极小的尺寸。我们基于Cortex M0 MCU的一个例子，编译后的大小(ROM: 3.25K, RAM: 1.04K)，除去MCU需要的ROM和RAM， RT-Thread Nano本身需要的ROM是2.5K , RAM 是1K。

接下来将描述如何在MDK5上基于RTE(Run-Time Environment)，从裸机开始，创建一个RT-Thread RTOS的小系统工程。

01

Pack安装

Pack可以通过MDK联网安装，也可以离线安装。下面开始介绍两种安装方式。

Pack Installer安装

打开MDK软件，点击工具栏的Pack Installer图标：

点击右侧的Pack，展开General，可以找到rt-thread::rthread，点击对应的Action的Install，就可以在线安装Pack了。安装成功后Action栏显示 ”Up to date”。

手动安装我们也可以从官网下载安装文件。双击下载好的文件进行安装：

02

基础工程准备在开始创建RT-Thread小系统之前，我们需要准备一个能正常运行的裸机工程。作为示例，这边使用的是基于STM32L072-Discovery 和Low-Level Library的一个LED 闪烁程序。程序的主要截图如下：

在我们的例程中，编译下载程序后，就可以看到3个LED交替闪烁了。读者可以根据自己的需要使用其他芯片，完成一个简单的类似裸机工程。

03

添加RT-Thread到工程基于一个可以运行的裸机程序，我们来添加RT-Thread到工程。如下图，点击Manage Run-Time Environment。

在Manage Rum-Time Environment里”Software Component”栏找到RTOS，Variant栏选择RT-Thread，然后勾选kernel。就可以将RT-Thread内核添加到工程了。点击”OK”就添加RT-Thread到工程了。

现在可以在Project看到RT-Thread RTOS已经添加进来了，展开RTOS，可以看到这些文件被添加到工程：

04

适配RT-Thread在board.c完成systick的配置。以STM32L072为例，需要添加以下代码：

包含相应的头文件
初始化Systick：根据系统频率和每秒tick数量，配置Systick
在Systick中断处理函数里添加rt_tick_increase()函数。

因为RT-Thread用到了异常处理函数HardFault_Handler()和悬挂处理函数 PendSV_Handler()，所以用户代码需要保证这两个函数没有被使用。

最后替换掉上面例程的delay函数：

包含RT-Thread的相关头文件<rtthread.h>
将delay()函数替换成rt_thread_delay(RT_TICK_PER_SECOND)。

下面是完成修改的代码：

编译程序之后下载到芯片就可以看到基于RT-Thread的程序运行起来了。

05

更多例程更多参看例程可以在MDK上通过Pack Installer找到。点击Pack Installer图标：

我们可以在Search里输入stm32l0，点击Device里的STM32L0 Serials，然后点击右侧的Example，可以看到右侧有基于stm32l0的两个例程。

补充内容 (2017-10-12 09:40):
RT-Thread Nano离线安装包下载地址：http://www.rt-thread.org/downloa ... rtthread.2.1.1.pack

806034232 · 发表于 2017-9-3 22:55:59

很实用很仔细，感谢楼主

hncjs · 发表于 2017-9-4 21:11:23

好的，不错的

xhuaihe · 发表于 2017-9-11 17:47:00

请教楼主，如何使用RTE新建线程，无论是我自己的工程，还是从例程拷贝过来的，都会出现
.\rtthread\rtthread.bin: Error: L6218E: Undefined symbol rt_thread_create (referred from main.o).
错误，但是
#include <rthw.h>
#include <rtthread.h>
这两个是存在的。
请楼主帮忙解答

aozima · 发表于 2017-9-18 09:44:36

xhuaihe 发表于 2017-9-11 17:47
请教楼主，如何使用RTE新建线程，无论是我自己的工程，还是从例程拷贝过来的，都会出现
.\rtthread\rtthre ...

编译错误才是检查头文件是否包含

链接错误是检查源文件 xx.c 是否参与编译和链接

rt_thread_create 在 thread.c 中，
且需要使用 RT_USING_HEAP 动态内存功能才有用。

aozima · 发表于 2017-10-7 20:46:19

扒了一下直接下载的链接

http://www.rt-thread.org/downloa ... rtthread.2.1.1.pack

如果需要手动导入，可以用这个链接直接下载。
有部分网友反应MDK 5.14等比较老的版本，即使使用管理员权限打开，也会提示没有写权限。
应该是MDK的问题，升级为新的就好。

南帝 · 发表于 2017-10-28 17:45:25

加入RT变的如此容易，真的很6啊。

wcyingdream · 发表于 2017-11-4 08:45:48

赞一个，支持一下

tototm · 发表于 2017-11-15 15:38:28

很不错就等接下来弄了！

曹伟 · 发表于 2019-12-20 09:25:36

为什么老是显示UsbSecurity\UsbSecurity.axf: Error: L6218E: Undefined symbol rt_thread_create (referred from main.o).但是明明#include <rthw.h> #include <rtthread.h>这两个都有的