GD32L233C-START评测——03_2.CoreMark测试、RT-Thread-Nano移植

wadeRen

GD32L233C-START评测——03_2.CoreMark测试、RT-Thread-Nano移植 [复制链接]

*（书接上文。。。）*

本文进行RT-Thread-Nano移植。

# 7. RT-Thread简介

RT-Thread，全称是 Real Time-Thread，顾名思义，它是一个嵌入式实时多线程操作系统，基本属性之一是支持多任务。*（此句摘抄自官方介绍）*

简单说，RT-Thread与大名鼎鼎的FreeRTOS、uCOS是一类的。而且它 **国产** 、 **开源** 。*（仅这两点，就值得了解一下。如果合适，还可以实际使用）*

**RT-Thread-Nano** 是 RT-Thread 的最小内核版本。

# 8. RT-Thread-Nano下载

1. 官方地址：https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-nano/an0038-nano-introduction

2. Keil支持包下载：https://www.keil.com/dd2/pack/#!#third-party-download-dialog

（此方式下载的为一个`.pack`格式的文件，类似于芯片支持包）

3. 附件下载：（附件位于贴尾附件处）

# 9. RT-Thread-Nano移植步骤

1. 下载RT-Thread-Nano源码；

2. 准备已实现`printf()`函数重定向的工程；

3. **移植RT-Thread-Nano到工程；**

4. **修改部分配置；**

5. 创建线程，验证移植成功；

# 10. RT-Thread-Nano移植

*（下述小标题步骤对应上方标题**9. RT-Thread-Nano移植步骤**的内容）*

本移植的硬件平台为GD32L233C-START开发板。

> 建议使用手动移植源码的方式进行。安装`.pack`的方式虽然简单便捷，在使用时仅需在Keil的软件管理器中勾选就可使用，但是使用这种方式的工程，在拷贝到一台没有安装 RT-Thread Package 的电脑上面是使用不了的，会提示找不到 RT-Thread 的源文件。

## 10.1 下载RT-Thread-Nano源码

根据上述地址下载的RT-Thread-Nano源码，文件夹内容如下图所示；

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_585800" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=585800&handlekey=savephoto_585800">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

该文件夹说明如下所示：

> *（图片来源：《[野火EmbedFire]《RT-Thread内核实现与应用开发实战——基于STM32》—20210407》）*

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_585801" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=585801&handlekey=savephoto_585801">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

## 10.2 准备已实现`printf()`函数重定向的工程

直接使用前面已经创建好的精简工程。

## 10.3 移植RT-Thread-Nano到工程

1. 在工程文件夹创建“sys_base”文件夹，并按下图所示将RT-Thread-Nano源码**复制**到该文件夹下；

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_585802" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=585802&handlekey=savephoto_585802">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

2. 在工程文件夹下创建“sys_drv”文件夹，并按下图所示将RT-Thread-Nano源码**复制**到该文件夹下；

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_585803" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=585803&handlekey=savephoto_585803">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

3. 在Keil工程组文件夹新建“sys_base”、“sys_drv”；
 
<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_585804" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=585804&handlekey=savephoto_585804">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

4. 将复制好的源码添加到对应的工程组文件夹中；
 
<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_585805" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=585805&handlekey=savephoto_585805">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

5. 在Keil中添加头文件路径；
 
<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_585806" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=585806&handlekey=savephoto_585806">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

## 10.4 修改部分配置

### 10.4.1 修改`rtconfig.h`文件

```c
// rtconfig.h 文件

40.#define RT_MAIN_THREAD_STACK_SIZE 512
```

### 10.4.2 创建`board.h`文件

创建`board.h`文件，文件内容如下：

```c
#ifndef __BOARD_H__
#define __BOARD_H__

#include <board.h>
#include "systick.h"
#include "gd32l23x_it.h"
#include "gd32l23x.h"
#include "gd32l233c_start.h"

#endif
```

### 10.4.3 修改`board.c`文件

1.调用`board.h`文件；

```c
// board.c 文件

#include "board.h"
```

2.注释部分代码；添加板级硬件初始化代码；

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_585807" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=585807&handlekey=savephoto_585807">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

## 10.5 创建线程，验证移植成功

1.在`main.c`中创建两个线程，`main.c`代码如下：

```c
//#include "gd32l23x.h"
//#include "gd32l233c_start.h"
//#include "systick.h"
//#include "stdio.h"

#include "stdio.h"
#include "board.h"
#include "rtthread.h"

/*!
  \brief  main function
  \param[in]none
  \param[out] none
  \retval none
*/

//定义线程控制块
static struct rt_thread led_on_thread;
static struct rt_thread led_off_thread;

//定义线程控栈时要求 RT_ALIGN_SIZE 个字节对齐
ALIGN(RT_ALIGN_SIZE)

//定义线程栈
static rt_uint8_t rt_led_on_thread_stack[1024];
static rt_uint8_t rt_led_off_thread_stack[1024];

/****函数声明****/
static void led_on_thread_entry(void *parameter);
static void led_off_thread_entry(void *parameter);

int main(void)
{
//创建线程
  rt_thread_init(&led_on_thread,"led_on",led_on_thread_entry,RT_NULL,&rt_led_on_thread_stack[0],
         sizeof(rt_led_on_thread_stack),3,50);
    
    rt_thread_init(&led_off_thread,"led_off",led_off_thread_entry,RT_NULL,&rt_led_off_thread_stack[0],
         sizeof(rt_led_off_thread_stack),3,50);

//启动线程，开启调度
    rt_thread_startup(&led_on_thread);
    rt_thread_startup(&led_off_thread);
}

static void led_on_thread_entry(void *parameter)
{
    while(1)
    {
        gd_eval_led_on(LED1);
  gd_eval_led_on(LED2);
  gd_eval_led_on(LED3);
  gd_eval_led_on(LED4);
        rt_thread_delay(500);
    }
}

static void led_off_thread_entry(void *parameter)
{
    while(1)
    {
        gd_eval_led_off(LED1);
        gd_eval_led_off(LED2);
        gd_eval_led_off(LED3);
        gd_eval_led_off(LED4);
        rt_thread_delay(600);
    }
}

int fputc(int ch, FILE *f)
{
    usart_data_transmit(USART0, (uint8_t) ch );         //发送字符
    while (usart_flag_get(USART0,USART_FLAG_TC) == RESET); //检查是否发送完毕
    return (ch);
}
```
2.编译、下载；

3.出现如下现象；

<ignore_js_op>

<a href="javascript:;" onclick="showWindow(this.id, this.getAttribute('url'), 'get', 0);" id="savephoto_585808" url="home.php?mod=spacecp&ac=album&op=saveforumphoto&aid=585808&handlekey=savephoto_585808">保存到相册</a>

</p>

</div>
<div class="tip_horn"></div>
</div>

</ignore_js_op>

# 结语

评测的跑分测试和移植操作系统写到这里，以上内容若有错误，请不吝赐教。

下节开始测试MCU的外设。（为后续的实践项目做准备工作）

> 另：文末附件上传工程源码、CoreMark源码、RT-Thread-Nano源码。附件说明如下：
>
> **01-GD32L233CCT6-Test.zip** ：基于开发板的的最精简工程，已实现串口0的printf()函数重定向
>
> **02-GD32L233CCT6-Test.zip ** ：已将coremark源码添加到工程中
>
> **03-GD32L233CCT6-Test.zip ** ：可以跑分的完整工程
>
> **05-GD32L233CCT6-Test.zip ** ：已完成系统移植，且创建两个静态线程，正常运行的工程
>
> **coremark-main.zip** ：CoreMark源码
>
> **rtthread-nano-master.zip** ：RT-Thread-Nano源码