RT-Thread-梁山派GD32F450/470-RT-Thread Nano 移植（二）RT-Thread问答社区

梁山派GD32F450/470-RT-Thread Nano 移植（二）

发布于 2023-09-25 11:19:03 浏览：1651 订阅该版

在上一篇文章中，我实现了在keil中给梁山派移植RT-Thread Nano，但在官方的移植教程中，除了系统的移植，还有在 RT-Thread Nano 上添加UART控制台与 FinSH的教程，所以我在本文中将实现在梁山派的Nano上添加UART控制台。
还没看过第一篇的可以先去第一篇瞅一瞅：[梁山派GD32F450/470-RT-Thread Nano 移植（一）](https://club.rt-thread.org/ask/article/2d32c106484f38da.html "梁山派GD32F450/470-RT-Thread Nano 移植（一）")

------------

还是老规矩，先给文件

[Nano移植文件(二).7z](https://club.rt-thread.org/file_download/dd52e4a696ba6049)
文件信息如下
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/c32bfa2d6edb6680aec1bddfd400684c.png.webp)

移植步骤如下：
1、打开不含UART控制台的文件，将梁山派的串口文件加到工程中，如下图所示
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/ef1a274192e45dd1d6a59473cd25646a.png.webp)

在keil工程中双击Hardware文件夹，并在弹出的窗口中选中串口文件并添加进工程中
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/e884cbddc88d7f20f90ed8bd4d923de1.png)

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/a8e78a7101423c339340f2e6d4a6cfcd.png)

添加完成后再将文件路径添加到工程包含路径中
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/d283330b902a3c0bac4d7dec98b5bb43.png.webp)

然后我们再将需要的GD32F4库函数文件加入工程，双击Firmware文件夹，找到
\002库函数点灯\Firmware\GD32F4xx_standard_peripheral\Source
路径下的gd32f4xx_misc.c和gd32f4xx_usart.c文件添加到工程中（方法与添加串口文件基本一致，这里不再赘述）
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/2d4178e935544b3e546c0165b1d265ae.png.webp)

编译无错
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/b6332b3cb71510ec7d233b3afa95dadc.png.webp)

2、实现串口初始化
RT-Thread的控制台需要通过uart_init实现串口初始化，在board.c文件中已经搭好了基本框架，但是未开启
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/014cfeca32d3f030da893d718f4f056b.png.webp)

所以我们首先要在rtconfig.h 中使能 RT_USING_CONSOLE 宏定义（这个时候编译有错是正常的）
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/b64c7d5324ff34a0f0a3efe17330ee0d.png.webp)

然后在board.c文件中完善串口初始化函数uart_init
进入bsp_usart.c文件
复制usart_gpio_config函数中的全部代码，粘贴到board.c的uart_init函数中
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/6dcdfcaf83eea58972ade7949528c425.png.webp)

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/94f4747b88766ee7cce79804506745b7.png.webp)

```c
	/* 开启时钟 */
	rcu_periph_clock_enable(BSP_USART_TX_RCU);   // 开启串口时钟
	rcu_periph_clock_enable(BSP_USART_RX_RCU);   // 开启端口时钟
	rcu_periph_clock_enable(BSP_USART_RCU);      // 开启端口时钟
	
	/* 配置GPIO复用功能 */
  gpio_af_set(BSP_USART_TX_PORT,BSP_USART_AF,BSP_USART_TX_PIN);	
	gpio_af_set(BSP_USART_RX_PORT,BSP_USART_AF,BSP_USART_RX_PIN);	
	
	/* 配置GPIO的模式 */
	/* 配置TX为复用模式 上拉模式 */
	gpio_mode_set(BSP_USART_TX_PORT,GPIO_MODE_AF,GPIO_PUPD_PULLUP,BSP_USART_TX_PIN);
	/* 配置RX为复用模式 上拉模式 */
	gpio_mode_set(BSP_USART_RX_PORT, GPIO_MODE_AF,GPIO_PUPD_PULLUP,BSP_USART_RX_PIN);
	
	/* 配置TX为推挽输出 50MHZ */
	gpio_output_options_set(BSP_USART_TX_PORT,GPIO_OTYPE_PP,GPIO_OSPEED_50MHZ,BSP_USART_TX_PIN);
	/* 配置RX为推挽输出 50MHZ */
	gpio_output_options_set(BSP_USART_RX_PORT,GPIO_OTYPE_PP, GPIO_OSPEED_50MHZ, BSP_USART_RX_PIN);

/* 配置串口的参数 */
	usart_deinit(BSP_USART);                                 // 复位串口
	usart_baudrate_set(BSP_USART,band_rate);                 // 设置波特率
	usart_parity_config(BSP_USART,USART_PM_NONE);            // 没有校验位
	usart_word_length_set(BSP_USART,USART_WL_8BIT);          // 8位数据位
	usart_stop_bit_set(BSP_USART,USART_STB_1BIT);     			 // 1位停止位

/* 使能串口 */
	usart_enable(BSP_USART);                                 // 使能串口
	usart_transmit_config(BSP_USART,USART_TRANSMIT_ENABLE);  // 使能串口发送
	usart_receive_config(BSP_USART,USART_RECEIVE_ENABLE);    // 使能串口接收
	
	/* 中断配置 */
	nvic_irq_enable(BSP_USART_IRQ, 2, 2); 									 // 配置中断优先级
	usart_interrupt_enable(BSP_USART,USART_INT_RBNE);				 // 读数据缓冲区非空中断和溢出错误中断
	usart_interrupt_enable(BSP_USART,USART_INT_IDLE);				 // 空闲检测中断
```

在borad.c中添加头文件，这一步是为了将bsp_usart.h中的一些宏定义引入，不然会报错
```c
#include "bsp_usart.h"
```
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/1b6e5a9eb65b1cb8a954c838a3ae2e69.png.webp)

最后再将下图中是波特率修改为115200（这个就是控制台串口的波特率，后面如果需要使用其他通信速率，可以来这里修改）
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/e162781033d886bbe493455c981f42c9.png.webp)

串口初始化完成
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/63490b3cd1b54658ed1639d4cac8c7d5.png.webp)
3、实现 rt_hw_console_output
这个就相当于串口输出，实现了它，RT-Thread的串口输出函数rt_kprintf才能够使用
将下面代码复制到rt_hw_console_output函数中去
```c
    rt_size_t i = 0, size = 0;
    char a = '\r';

size = rt_strlen(str);
    for (i = 0; i < size; i++)
    {
        if (*(str + i) == '\n')
        {
            usart_send_data((uint8_t)a);
        }
        usart_send_data((uint8_t)*(str + i));
    }
```

复制前
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/76a0dc7c7c493b0d29f41a5a8fc4932e.png.webp)

复制后（编译无错）
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/d42365ed792787a0934b0185f2c95ef8.png.webp)

------------

以上就实现了在梁山派的Nano上添加UART控制台（实现打印）
搞个例程试一试
在main函数的循环中添加

```c
rt_kprintf("RT-Thread\r");		
```
![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/8e74e306d61e95315b7c986d84e4c76c.png.webp)

例程现象如下：

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20230925/7bc83d7d62e50e3fc677e1f015f2eead.png.webp)

总结如下：
在梁山派的Nano上添加UART控制台
编写使用rt_kprintf函数串口打印的例程

参考资料：
1、[基于 Keil MDK 移植 RT-Thread Nano](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-nano/nano-port-keil/an0039-nano-port-keil "基于 Keil MDK 移植 RT-Thread Nano")
2、[立创开发板-梁山派教程文档](https://lckfb.com/docs/lckfb_lspi/#/ "立创开发板-梁山派教程文档")
3、[立创梁山派](https://lceda001.feishu.cn/wiki/JNDHwxPWWi99CJk6SkMc6Z3Yn2e "立创梁山派")
4、[梁山派GD32F450/470-RT-Thread Nano 移植（一）](https://club.rt-thread.org/ask/article/2d32c106484f38da.html "梁山派GD32F450/470-RT-Thread Nano 移植（一）")