RT-Thread配置开发环境手册

目录1配置RT-Thread开发环境 (2)1.1获取RT-Thread源码 (2)1.1.1安装SVN工具 (2)1.1.2从google code上获取rt-thread源码 (6)1.1.3从google code上更新rt-thread源码 (7)1.2从github获取源码(Realtouch/ART/RT-GUI) (7)1.3安装python 以及SCons工具 (8)1.3.1安装python (8)1.3.2将路径加入到系统PATH变量中 (8)1.3.3安装SCons (10)1.4安装编译工具 (10)1.4.1安装GCC编译工具链 (10)1.4.2安装MDK (13)2开发编译 (14)2.1使用GCC编译 (16)2.2使用MDK编译 (17)2.2.1使用SCons调用armcc编译 (17)2.2.2使用MDK IDE编译 (18)3ART板烧录运行程序 (19)3.1使用DFU烧录 (19)3.1.1驱动安装流程： (19)3.1.2用DFU下载bin文件 (19)3.2使用JLink/ULink/ST-Link烧录 (20)3.2.1SWD转JTAG接线 (21)3.2.2配置MDK（以JLink为例） (22)4Realtouch评估板使用指南 (26)4.1添加环境变量 (27)4.1.1配置RT_ROOT (27)4.1.2修改rtconfig.py (28)1配置RT-Thread开发环境1.1获取RT-Thread源码RTT源码包的里程碑版本可以在RT-Thread官方网站上下载到，/打开页面，可以看到右边下载区中有一些历史版本。

也可以使用google code上的开发版本，下面重点介绍一下如何获取开发版本。

1.1.1安装SVN工具为了取出RTT源码，我们需要先安装SVN工具，笔者推荐TortoiseSVN，下载地址：/downloads.html读者需要根据自己系统情况（32bit或64bit）选择合适的版本。

点击安装，安装过程可以参见图 1-1至图 1-9。

图 1-1图 1-2图 1-3图 1-4图 1-5图 1-6图 1-7图 1-8图 1-9安装完成以后，TortoiseSVN就会被集成到系统的右键菜单中。

1.1.2从google code上获取rt-thread源码如果是第一次使用SVN获取RT-Thread源码，使用如下步骤。

在任意目录，右击，选择 SVN Checkout，见图。

图 1-10弹出如下所示对话框，将下面的地址填入https:///svn/trunk/图 1-11然后点击OK，就可以看到代码更新了,根据网络情况，大约需要等待15至30分钟不等。

1.1.3从google code上更新rt-thread源码1.2从github获取源码(Realtouch/ART/RT-GUI)RT-Thread推出了Realtouch评估板，以及ART板。

这两块板子的测试代码目前都在github上托管。

github网址：https:///这里简要介绍一下git以及github。

Git是一个分布式的版本控制系统，最初由Linus Torvalds编写，用作Linux内核代码的管理。

在推出后，Git在众多知名的开源项目中取得了很大成功。

github就是一个源码托管平台，类似于google code。

目前托管到github上的开源项目以及数以十万计。

github的流行代表着社会化编程时代的到来。

正因为如此，我们将Realtouch/ART评估板的示例代码托管到github上来，以顺应当前开发的潮流。

目前，RT-Thread官方托管到github上的软件仓库共有三个，他们在github上的网址分别为Realtouch源码：https:///RT-Thread/realtouch-stm32f4RT-GUI源码：https:///RT-Thread/RTGUIART work源码：https:///RT-Thread/ART从github上获取源码共有两种，第一种即安装git，使用git开发工具，这有些类似前面介绍的SVN，不过配置略微复杂，好在github网站提供了网页下载，读者可以使用如下方式下载。

这里以realtouch的github软件仓库为例，打开网址后，点击zip，即可打包下载，见图 1-12。

图 1-121.3安装python 以及SCons工具RT-Thread使用SCons作为默认的构建工具。

SCons基于Python开发，因此我们需要先安装python，再安装SCons。

1.3.1安装python/ftp/python/2.7.1/python-2.7.1.msi下载后一路点击下一步（next）即可，不再赘述。

默认情况下，这个程序会被安装到C:\Python27目录下，我们要将这个目录加入到系统PATH变量中，方法见下一小节。

1.3.2将路径加入到系统PATH变量中在windows 7系统上，方法为：1)在计算机上右击，选择【属性】2)打开系统对话框，在其左边点击高级系统设置，弹出【系统属性】对跨框，参见图 1-13。

3)在【系统属性】对话框的【高级】标签，点击下部的【环境变量】，弹出环境变量对话框，选择Administrator的用户变量，选中PATH，点击编辑，见图 1-14。

4)弹出编辑环境变量对话框图，在变量值的最后加入;C:\Python27注意，前面有一个分号，PATH环境变量包含多个路径，他们以分号”;”作为分割符。

图 1-13图 1-14图 1-15点击确定，返回上一对话框，再次点击确定，然后关闭系统属性对话框。

完成PATH变量修改。

为了验证我们是否正确将路径添加到PATH中，可以使用如下方法验证，在运行中输入cmd，打开命令行工具，输入echo %PATH%CMD就会返回当前系统的PATH变量的值，其中就会包含自己添加的路径，见图 1-16。

图 1-161.3.3安装SCons下载SCons /download/scons-2.0.1.win32.exe 点击安装，SCons会被自动安装到python安装目录中，即C:\Python27\Scripts参考1.3.2节，将上述路径同样添加到系统PATH变量中。

1.4安装编译工具RT-Thread源码目前支持三种编译工具工具，分别是1.GCC2.MDK3.IAR本文将介绍GCC和MDK的安装，这两种编译工具只需要安装一个即可，当然两个都安装也可以。

1.4.1安装GCC编译工具链下载GCC工具链安装包，这里提供两种下载方式。

笔者推荐下载方式2。

1)官方下载地址：https:///sgpp/lite/arm/portal/subscription3 053点击下载Sourcery G++ Lite 2011.03-42，注册后即可下载注意：不要下载Sourcery CodeBench Lite 2011.09-69，这个版本可能会导致后面编译失败。

2)RT-Thread的官方百度网盘中，也提供了上述编译器下载地址。

地址如下：/netdisk/extractpublic?uk=4264488348在GCC编译工具目录下。

安装过程如下所示，图 1-17至图 1-21。

图 1-17图 1-18图 1-19注意在下面的对话框中，选择为当前用户修改PATH，那么gcc的安装路径就会被自动加入到系统环境变量中去。

图 1-20图 1-211.4.2安装MDKMDK为商业软件，这里对MDK的安装不予介绍，实际除了修改安装路径外，其他选项均选择NEXT即可完成安装。

2开发编译打开1.1节中我们下载的RT-Threand源码目录。

其中目录结构如下所示：RT-Thread├─bsp 各个平台的工程目录├─components 组件源码目录├─documentation 文档目录├─examples 测试用例目录├─include 头文件目录├─libcpu 存放各个平台的启动程序以及线程切换程序├─tools SCons脚本目录└─src RT-Thread内核源码目录RT-Thread源码包支持多种编译方式，笔者重点介绍两种编译开发方式，使用SCons 编译或者使用MDK编译。

笔者将以ART开发板为例子介绍这两种编译方式。

ART板上使用STM32F40x芯片，因此对应的BSP为 bsp\stm32f40x目录，打开这个目录我们可以看到。

applications目录下存放一些顶层应用程序drivers目录下存放RT-Thread设备驱动程序Libraries目录下存放stm32官方固件库代码rtconfig.h为当前工程的头文件，用于控制RT-Thread组件裁剪Project.uvproj为MDK工程文件Template.uvproj为生成MDK工程文件模板文件，由SCons使用。

Stm32_rom.ld为GCC链接文件，用于GCC编译Stm32_rom.sct 为MDK分散加载文件，当使用SCons调用armcc编译时需要使用rtconfig.py 为python脚本，主要用于配置SCons的底层编译器。

SConscript 为python脚本，由SCons使用SConsctruct 为python脚本，由SCons使用这里来实现一个简单的LED等闪烁程序。

需要说明的是，这个BSP面向的是ST官方的F4 Discovery开发板。

为了要在ART板子上运行，我们需要做一些修改。

修改applications/application.c，static void rt_thread_entry_led1(void* parameter){GPIO_InitTypeDef GPIO_InitStructure;/* GPIOD Periph clock enable */RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOD| RCC_AHB1Periph_GPIOB, ENABLE);/* Configure PD12, PD13, PD14 and PD15 in output pushpull mode */ GPIO_InitStructure.GPIO_Pin = GPIO_Pin_12 |GPIO_Pin_13| GPIO_Pin_14| GPIO_Pin_15;GPIO_InitStructure.GPIO_Mode = GPIO_Mode_OUT;GPIO_InitStructure.GPIO_OType = GPIO_OType_PP;GPIO_InitStructure.GPIO_Speed = GPIO_Speed_100MHz;GPIO_InitStructure.GPIO_PuPd = GPIO_PuPd_NOPULL;GPIO_Init(GPIOD, &GPIO_InitStructure);GPIO_InitStructure.GPIO_Pin = GPIO_Pin_2;GPIO_Init(GPIOB, &GPIO_InitStructure);while (1){GPIO_SetBits(GPIOB, GPIO_Pin_2);/* Insert delay */rt_thread_delay(RT_TICK_PER_SECOND/2);GPIO_ResetBits(GPIOB, GPIO_Pin_2);rt_thread_delay(RT_TICK_PER_SECOND/2);}}修改drivers/stm32f4xx_conf.h ，ART板子上使用的时钟的频率为25M，修改：#if defined (HSE_VALUE)/* Redefine the HSE value; it's equal to 8 MHz on the STM32F4-DISCOVERY Kit */#undef HSE_VALUE#define HSE_VALUE ((uint32_t)25000000)#endif /* HSE_VALUE */至此修改结束。