AN0001 RT-Thread串口应用指南学习笔记

• 文章作者：Wendell
• 原文地址：https://www.jianshu.com/p/7d8ec9a37f11
• 转载请注明出处！

---

说明：

• 开发环境：keil MDK V5.21.1.0
• 硬件平台：STM32F429-apollo开发板（正点原子）
• Env工具：env_released_0.7.1
• RT-Thread版本: 3.1.1

• 本文以RT-Thread官网的AN0001 RT-Thread串口应用指南为依据，在STM32F429-apollo开发板上进行相应实验。

配置工程

  在工程目录下右击，选择ConEmu Here，打开Env工具。

image.png

  在Env 命令行中输入menuconfig，进入配置界面，使用menuconfig工具配置工程。操作方法如下：

image.png

  浏览各选项，熟悉结构，确定以下3处设置正确，路径在图片左上角红框内。（官方bsp已经将串口配置好了，所以应该不需要修改，使用默认配置即可。）

image.png

image.png

image.png

  为了加快编译速度，也为了避免带来不必要的影响，将LWIP和SAL相关功能删除，具体配置如下图：

image.png

image.png

  在这里提一个小技巧，Env工具支持自动补全，按Tab键即可。例如要求“在 env 命令行中输入 menuconfig”，我们输入men之后按Tab，则出现完整的menuconfig命令；要求“输入命令scons”，我们输入sco之后按Tab，则出现完整的scons命令。

  配置好之后保存退出，输入命令 scons --target=mdk5 -s 生成 MDK5 工程（如果使用MDK4则使用scons --target=mdk4 -s生成），工程名称为project.uvprojx，打开该工程，可以看到相关设置与模板一致，不需要再次修改。编译后会有3个warning，不用管它，下载到开发板中，打开串口调试助手XCOM V2.0，输出如下，红色方框内为配置参数和输入指令。

image.png

串口输出与官方教程中差别很大，主要有以下3点：

• 输出内容比官方教程多出了各模块启动情况。
• 官方教程显示的为msh，而该程序输出为finsh，输入list_device，返回的输出与官方教程不一致。
• 如果使用官方教程中的串口调试助手putty，则无法接收到输出。

  第1点是因为apollo的bsp默认打开了宏RT_USING_COMPONENTS_INIT，这个宏负责输出具体的初始化过程，不管输出成功还是失败暂时不用管它。

  第2点是因为finsh支持两种模式：C语言解释器模式（为行文方便称之为c-style）和 传统命令行模式（此模式又称为msh）。官方教程使用名为STM32F4xx-HAL的bsp，该bsp采用的 传统命令行模式，而名为STM32F429-apollo的bsp中使用的是C语言解释器模式。使用Env工具按照下图配置。左上角红框为路径，下方红框为需要打开的选项。

image.png

  第3点是因为stm32f429-Apollo开发板的USB-232的串口（即uart1）只能使用原子哥的XCOM V2.0接收，其它串口调试助手测试了SecureCRT 8.3、realterm、PuTTY都无法接收。原因是正点原子的开发板的复位电路和串口相连，导致使用其它串口调试助手时开发板无法正常复位，而使用正点原子的XCOM V2.0是由于软件在打开串口的时候先发送了复位信号。（开发板中另外两路使用DB9插头的串口可以正常使用各种软件！）

  重新使用Evn配置后，保存，退出，输入命令 scons --target=mdk5 -s 重新生成工程，编译下载后可以看到出口输出如下，与官方教程中一直，成功！

image.png

加入代码

  打开rt-thread学习准备一文中下载的“RT-Thread应用笔记资料(STM32F429阿波罗)”，在“串口数据应用笔记”文件夹下有代码 文件app_uart.c、 app_uart.h，将这两个文件拷贝到项目文件夹stm32f429-apollo\applications目录下。
  Env工具是通过SConscript文件来组织文件的，手动添加的文件会在下次使用Env工具时被删除，因此修改SConscript文件才是正确的添加方法！使用notepad++打开applications文件夹中的SConscript文件，并按照图中位置添加app_uart.c，保存后退出。

image.png

  使用Env命令行重新生成工程并打开，可以看到app_uart.c已经成功添加到application目录下

image.png

  在application.c文件添加有文件

#include "app_uart.h"

  使用如下函数代替application.c文件的rt_application_init()函数

int rt_application_init(void)
{
    rt_thread_t tid;

    tid = rt_thread_create("init",
        rt_init_thread_entry, RT_NULL,
        2048, RT_THREAD_PRIORITY_MAX/3, 20);

    if (tid != RT_NULL)
        rt_thread_startup(tid);
    
    tid = rt_thread_create("uart",
                    uart_thread_entry, 
                    RT_NULL,
                    1024, 
                    2, 
                    10);
    /* 创建成功则启动线程 */
    if (tid != RT_NULL)
        rt_thread_startup(tid);

    return 0;
}

  编译下载，打开两个串口调试助手XCOM V2.0和Realterm（不用putty的原因上文已经解释），按照自己计算机显示的com口编号配置串口助手（串口2记得连接电脑呀），开发板上电后，在Realterm中输入EmbededLife，每个字符输入后会显示比该字符ASCII码大1的字符，两个串口调试助手的显示如下：

image.png

打完收工