RTT串口V1版本的使用分析及问题排查指南(一)

RT-Thread串口设备驱动框架 串口驱动框架抽象了不同串口设备的共性,实现了IO设备管理层需要的设备操作方法。 阅读详情

本文由RT-Thread论坛用户123原创发布:https://club.rt-thread.org/ask/article/2894.html

RTT串口V1版本的使用分析及问题排查指南(一)

简述

无论是刚接触 RT-Thread 的新手,还是经验老道的大牛们,他们使用 RT-Thread 的时候,使用最频繁最广泛的外设,想必也非串口设备莫属。

回想大家在移植一个新的BSP或者芯片时,如何验证是否移植成功呢?是的,msh控制台窗口走一波 RTT 的 logo 信息,输出成功了就基本代表移植成功了。如下所示:

 \ | /
- RT -     Thread Operating System
 / | \     4.0.4 build Dec  32 2021
 2006 - 2021 Copyright by rt-thread team
msh >

例如 finsh 组件,以命令行的方式实现人机交互的功能,在项目开发调试中有着举足轻重的作用,也是开发者们使用最为频繁的组件。

又例如 ULOG组件,AT组件,ymodem组件,RT_Link组件等,其底层数据流都有串口的踪迹。因此,作为使用最频繁,覆盖面最广泛的串口设备,如果把它搞懂,那将会在你的项目开发中如虎添翼,或对嵌入式系统也会有更深刻的理解。

既然串口设备如此重要,受众人群又如此之多,使用范围如此之广,那么有必要去理一理串口框架,汇总一下问题所在,为广大开发者们指一下解决问题的方向。这也是这篇文章的主要工作。

本文会先结合STM32为平台,以串口V1版本做分析说明 (第一部分),并总结遇到串口方面的问题该如何解决的方法(第二部分)。

(在此需要解释一下,串口V1版本 这个名字非官方冠名,是本人为了区分串口V2版本 而临时起的名字,当然后续会有串口V2版本的介绍说明,马不停蹄更新中)

由于串口V1版本已经历经多年的开发与迭代,也被多数开发者整理成文,广为流传,本文若重新对其做细致的分析显然是在浪费各位看官的宝贵时间。因此,本文旨在总结串口使用过程中遇到的问题,弱化分析串口的执行流程,如需详细的串口流程分析,可移步文档中心串口章节,或者自行上网搜索,相信你一定能找到合适的答案。那么废话不多说,开整。

串口设备使用说明

串口流程分析分为两部分,一部分是串口驱动,另一部分是串口框架,用户(应用层)使用串口时,是按照下图的模型进行操作的:

image.png

首先需要使用 Device 框架(源码位置在 src/device.c 中),什么是Device 框架,比如用到的 rt_device_open/close/read/write/control() 等API操作接口,就是使用的 Device 框架的接口。本文中不做深入探讨,了解即可。

其次是 UART 设备驱动框架 (源码位置在 components\drivers\serial\serial.c),串口设备驱动框架实现了Device框架的操作方法的接口rt_serial_open/close/read/write/control()。举个例子,例如Device框架的rt_device_open() 接口是打开一个设备对象,而对应到串口框架上,就是对接到了 rt_serial_open() 。

然后是串口设备驱动(源码位置在 bsp/xxx/drivers/drv_usart.c),串口设备驱动负责实例化串口设备 。这一层调用了 rt_hw_serial_register() 函数注册串口设备到操作系统中,也是与串口硬件直接打交道的媒介,这一层将会看到串口硬件的配置、读写寄存器、中断的操作等。

下面这张图将介绍串口设备的使用序列:

image.png

串口各个模式的流程分析

串口框架目前适配了三种硬件工作模式,即串口轮询(发送/接收)、串口中断(发送/接收)、串口DMA(发送/接收)。下面分别对三种模式进行介绍:

一:轮询模式

轮询模式即调用串口 接收/发送 的 API 后将一直占用CPU资源直到数据收发完成才返回,使用时需要用户主动调用 接收/发送 的API接口才会执行相应的操作。

轮询接收

应用程序调用 rt_device_read() 接收数据,轮询接收模式下会调用到底层串口驱动提供的 getc 接口,每次接收一个字节,如果接收不到数据将一直占用CPU资源。

轮询发送

应用程序调用 rt_device_write() 发送数据,轮询发送模式下会最终会调用到底层串口驱动提供的 putc 接口,每次发送一个字节,循环发送直到待发送的数据发送完成。

轮询接收和发送调用关系如下图所示:

image.png

二:中断模式

中断模式下收发数据时,将数据的收发过程放在中断中进行,不再持续占用CPU资源,应用程序只用负责将数据写入串口数据寄存器,然后线程就会让出资源,空出了程序等待串口硬件收发数据的时间。注意一点:中断接收和发送时,每次在中断中操作的还是单个字节。

中断接收

串口硬件接收到一个字节的数据后会触发中断并调用串口驱动框架的 rt_hw_serial_isr() 函数,此函数会将这一字节数据写入环形缓冲区,用户设置的回调函数也会被调用。应用程序读取数据实际是从环形缓冲区读取。

中断接收调用关系如下图所示:

image.png

中断发送

串口框架负责调用底层 putc 接口向串口寄存器写入待发送的数据,然后等待此数据发送完成的信号,此时当前线程会被挂起。上一个数据发送完成后会调用串口驱动框架的 rt_hw_serial_isr() 函数,此函数会发送完成信号唤醒发送数据线程,并重置完成信号状态为未完成。线程运行后会向串口寄存器写入下一个数据,然后等待完成信号,重复上一个流程,直到缓冲区数据发送完成。

该过程与中断接收流程很相像,再次不再贴图赘叙。

三:DMA模式

DMA模式下收发数据与中断模式很相像,可以粗略的认为,两种模式唯一不同的就是,中断模式每次收发数据为单字节,而DMA模式则是多个字节进行收发的。

DMA接收

使用 DMA 接收模式时,首先应用程序打开串口设备会指定打开标志为 RT_DEVICE_FLAG_DMA_RX,此时串口驱动框架会创建环形缓冲区并调用串口驱动层 control 接口使能 DMA 接收完成中断。

DMA接收调用关系如下图所示:

image.png

这里再啰嗦一句,在DMA中断处理流程中,有三种DMA接收中断,分别是DMA空闲中断(IDLE)、DMA半满中断(HFIT)和 DMA满中断(TCIT),这三个中断相辅相成,最后统一交由串口框架中断处理函数 rt_hw_serial_isr(RT_SERIAL_EVENT_RX_DMA_DONE)中做处理。其中DMA空闲中断是在uart_isr中触发的,另外两个是在DMA接收回调中触发的,这两个接收回调是在DMA接收使能启动的时候,由HAL库注册的,用户无需关心这两个DMA接收回调的注册逻辑,只需知道,如果用户不想使用这两个DMA接收回调的时候,只要把函数里面的执行代码注释掉即可。类似下图这样 :

void HAL_UART_RxCpltCallback(UART_HandleTypeDef *huart)
{
    struct stm32_uart *uart;
    RT_ASSERT(huart != NULL);
    // uart = (struct stm32_uart *)huart;
    // dma_isr(&uart->serial);
}

void HAL_UART_RxHalfCpltCallback(UART_HandleTypeDef *huart)
{
    struct stm32_uart *uart;
    RT_ASSERT(huart != NULL);
    // uart = (struct stm32_uart *)huart;
    // dma_isr(&uart->serial);
}

(至于为什么会有用户无需使用该回调函数的应用场景,这里先按下不表,后边会具体详细分析,而且这部分会很重要,该机制在串口V2上照样使用)

DMA发送

应用程序发送数据流程如下图所示,应用程序调用 rt_device_write() 发送数据,最终待发送数据的地址和大小会被放入数据队列,如果此时 DMA 空闲,就会开始发送数据。当 DMA 发送完成触发中断时,rt_hw_serial_isr() 函数会判断数据队列是否有待传输的数据并开始下次 DMA 传输,用户设置的回调函数也会被调用。

image.png

由上图我们可以看出,在使用DMA发送时,串口框架并未使用环形缓冲区,然而我们又知道,DMA发送时,肯定是需要缓冲区来存放数据的,那么DMA发送时候的数据块,存放在哪里呢?这里就需要注意了,DMA发送时候,数据缓冲区是由用户应用层定义的,在传给串口框架的时候,是将应用层定义的数据缓冲区的指针传递过来。如果在发送过程中,该缓冲区的内容被意外修改了,那么将会导致DMA发送的数据出现错误。我们可以再结合下面的图继续说明:

image.png

串口相关问题解析

篇幅有限,本节内容见 RTT串口V1版本的使用分析及问题排查指南(二)

【RTT-Studio】详细使用教程十二:UART的分析和使用 阅读详情

相关推荐

DAPLink V0.0.20上位机实战:手把手教你配置RTT Viewer调试STM32(附常见问题解决)

本文详细介绍了如何使用DAPLink V0.0.20上位机配置RTT Viewer调试STM32。通过手把手实战教学,涵盖环境搭建、RTT核心原理、多开发环境(Keil/IAR/STM32CubeIDE)下的代码集成与配置,并重点解析了利用ELF文件提升连接可靠性的方法。文章还提供了连接失败、无输出等常见问题的排查思路与解决方案,帮助开发者高效利用这一低成本、高速的调试工具。

apple5的专栏 788

《RT-Thread设备驱动开发指南》—— 基础篇之UART设备驱动开发

RT-Thread设备驱动开发-第2章 UART设备驱动开发UART介绍UART(Universal Asynchronous Receiver/Transmitter,通用异步收发传输器)也常被称为串口。UART作为异步串口通信协议的一种,工作原理是将传输数据的每个字符一位接一位地传输。UART是在应用程序开发过程中使用频率最高的数据总线。在嵌入式设计中,UART常用于主机与辅助设备通信,如嵌...

weixin_46158019的博客 2848

WCH CH32V303RCT6 SDI Printf虚拟串口:原理剖析与RTT式调试实战

本文深入剖析了WCH CH32V303RCT6的SDI Printf虚拟串口功能,详细介绍了其原理、配置步骤及与SEGGER RTT的对比。通过实战案例展示了如何在资源受限的项目中高效使用这一调试工具,并提供了性能优化和常见问题解决方案。

weixin_33721427的博客 830

I/O 设备模型-2

旧版本接收缓冲区统一为 RT_SERIAL_RB_BUFSZ ,旧版本没有发送缓冲区的设置。

qq_37932504的博客 1366

JLink RTT 完整教程

JLink RTT是一种高效的嵌入式调试技术,通过RAM缓冲区实现MCU与主机的双向高速通信。相比传统串口调试,RTT不占用硬件资源、传输速度快(可达1Mbps以上)、不影响程序实时性,且支持多通道日志分类。本文详细介绍了RTT的核心优势、适用场景及完整实现步骤,包括源码移植、API调用和日志查看方法,并提供了printf重定向、多通道使用等进阶技巧。该技术兼容各类ARM内核芯片,只需J-Link仿真器即可快速部署,能显著提升嵌入式开发调试效率。

z521524的博客 808

告别传统串口调试:利用JLink RTT实现高效日志输出的完整指南

本文详细介绍了如何利用JLink RTT技术替代传统串口调试,实现高效日志输出。通过零硬件成本的RTT技术,开发者可以快速定位问题,提升调试效率。文章包含环境搭建、工程移植、高级应用技巧及常见问题解决方案,特别适合嵌入式开发人员参考。

weixin_29168393的博客 250

rt-thread------串口V1版本(一)配置

UART(Universal Asynchronous Receiver/Transmitter)通用异步收发传输器,UART 作为异步串口通信协议的一种,工作原理是将传输数据的每个字符一位接一位地传输,是在应用程序开发过程中使用频率最高的数据总线。我们经常在串口上接WIFI、4G模块,也可以增加电平转换芯片变成RS232和RS485通信接口。rt-thread官网对串口做了详细的说明。这篇文章的目的是讲一下我对串口发送接收模式的理解和使用过程中遇到的问题。

qq_39854159的博客 3092

告别串口!用STM32CubeMX+J-Link RTT三分钟搭建极速调试环境(Keil版)

本文详细介绍了如何使用STM32CubeMX和J-Link RTT技术快速搭建高效调试环境,替代传统串口调试。通过性能对比和实战步骤,展示了RTT在速度、资源占用和多任务支持方面的显著优势,帮助开发者提升嵌入式调试效率。

weixin_42567497的博客 364

RTT串口v1使用分析以及问题排查指南 (二)

本文由RT-Thread论坛账号123 原创发布:https://club.rt-thread.org/ask/article/2898.html RTT串口V1版本的使用分析及问题排查指南(二) 串口相关问题解析 承接RTT串口V1版本的使用分析及问题排查指南(一)文章。 结合串口使用过程的反馈信息,本章节将结合 FinSH组件的串口相关问题 和 应用层上使用串口设备的相关问题 这两个方面进行分析。这一章节探讨FinSH组件上的串口问题。 由于串口外设所涉及的方面过于广泛,分析时不可能涵盖全部应用场景(

rtthreadiotos的博客 1268

JLink V9虚拟串口功能全攻略:告别USB转TTL,一根线搞定SWD调试和串口通信

本文详细介绍了JLink V9虚拟串口功能的全面应用指南,通过单线实现SWD调试和串口通信的双重功能,显著提升嵌入式开发效率。内容涵盖硬件连接、驱动配置、跨平台适配及高级优化技巧,特别适合需要高稳定性的工业场景。

spice的博客 788

SEGGER JLink隐藏功能全解锁:RTT比UART快3倍的调试方案(V6.44b实测)

本文深度解析SEGGER J-Link的RTT(Real Time Transfer)调试方案,通过实测数据对比,揭示其相比传统UART在速度上的巨大优势(实测快3倍以上)及低CPU占用特性。文章详细探讨了V6.44b等版本的实际配置差异、大数据量场景下的缓冲区优化策略,并介绍了RTT在交互式命令控制、系统监控等高阶调试场景中的应用,为嵌入式工程师提供了一套高效、现代的调试方法学。

xray4的博客 893

RTT串口V1版本的使用分析及问题排查指南(三)

本文由RT-Thread论坛用户123原创发布,原文:https://club.rt-thread.org/ask/article/2904.html 应用层的串口问题 应用层使用串口时,需要先指定以何种方式(轮询、中断或者DMA)去打开串口,然后再进行串口的操作。这部分相关的内容在第一章已经说过,这里主要用来总结串口使用时遇到的一些问题。 串口注册时候的默认规则慢慢道来: 串口注册的默认规则 我们都知道,串口设备需要先注册,才能通过rt_device_open API 去访问,那么串口注册时候的默认规则是

rtthreadiotos的博客 1159

STM32CUBEIDE调试神器:用J-Link RTT替代串口打印,效率翻倍(附完整配置流程)

本文详细介绍了如何在STM32CUBEIDE中使用J-Link RTT技术替代传统UART串口打印,实现调试效率的显著提升。通过对比RTT与UART的性能差异,解析RTT技术原理,并提供完整的配置流程和代码实现,帮助嵌入式开发者快速掌握这一高效调试工具。文章还包含性能优化建议和常见问题解决方案,特别适合实时控制系统和高频数据采集场景。

weixin_33712987的博客 435

工程调试利器:RTT(Real-Time Transfer)保姆级使用教程

摘要: RTT(Real-Time Transfer)是SEGGER推出的高速嵌入式调试技术,利用调试通道实现MB/s级数据传输,无需占用串口引脚。本教程详解RTT优势、文件结构及集成方法:1)硬件需J-Link调试器和支持RTT的MCU;2)软件需安装V864版J-Link驱动包;3)工程集成时添加SEGGER_RTT核心文件,配置缓冲区大小。RTT支持多通道双向通信,适用于实时日志、性能分析等场景,显著提升调试效率。注意根据工具链选择正确的系统调用文件,并合理优化缓冲区配置。

曾记否@ 5278

STM32F4开发实战:用Segger Embedded Studio的RTT功能替代串口打印,调试效率翻倍(附CubeMX配置)

本文详细介绍了如何在STM32F4开发中使用Segger Embedded Studio的RTT功能替代传统串口打印,显著提升调试效率。通过STM32CubeMX配置和Segger Embedded Studio的工程设置,开发者可以轻松实现高速日志输出、终端输入和实时变量监控,无需额外硬件支持。文章还提供了高级调试技巧和常见问题解决方案,帮助开发者充分利用RTT的强大功能。

weixin_30698297的博客 670

H7-TOOL全功能RTT Viewer实战:如何用SWD两线替代串口调试(含代码移植指南)

本文详细介绍了H7-TOOL全功能RTT Viewer如何通过SWD两线替代传统串口调试,提供完整的解决方案。文章涵盖RTT技术原理、代码移植指南及多端协同调试技巧,特别适合嵌入式开发者在引脚资源受限场景下的高效调试。H7-TOOL的RTT Viewer功能显著提升调试效率,释放串口资源。

weixin_29166013的博客 181

告别串口占用!用JLink RTT Viewer调试NRF52832蓝牙项目(附完整SDK配置流程)

本文详细介绍了如何使用JLink RTT Viewer调试NRF52832蓝牙项目,避免串口占用问题。通过完整的SDK配置流程和实战技巧,开发者可以高效实现RTT打印调试,提升开发效率。文章还对比了RTT与串口打印的优势,并提供了常见问题解决方案。

weixin_42570484的博客 149

利用CMSIS DAPLink实现SEGGER RTT日志输出的实战指南

本文详细介绍了如何利用CMSIS DAPLink实现SEGGER RTT日志输出的实战方法,包括环境搭建、RTT库集成、printf重定向及性能优化技巧。通过SEGGER_RTT_printf技术,开发者可以高效输出调试信息,提升嵌入式开发效率。文章还提供了常见问题排查和高级应用技巧,适合嵌入式开发人员参考。

weixin_30415113的博客 462
上一篇: RT-Thread的课程教学内容梳理及资源介绍分享交流会
下一篇: 【每周话题第三期】朋友们,你最拼命的时候是怎样的?
评论 2
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值