大家好,我是痞子衡,是正经搞技术的痞子。今天痞子衡给大家分享的是IAR下调试信息输出机制之硬件UART外设

  在嵌入式世界里,输出打印信息是一种非常常用的辅助调试手段,借助打印信息,我们可以比较容易地定位和分析程序问题。在嵌入式应用设计里实现打印信息输出的方式有很多,本系列将以 IAR 环境为例逐一介绍 ARM Cortex-M 内核 MCU 下打印信息输出方法。

  本篇是第一篇,我们先介绍最常见的输出打印信息方式,即利用 MCU 芯片内的硬件 UART 外设。本篇其实并不是要具体介绍 UART 外设模块使用方法,而是重点分析 IAR 下是如何联系 C 标准头文件 stdio.h 定义的 printf() 函数与 UART 外设底层驱动函数的。

  • Note: 本文使用的 IAR EWARM 软件版本是 v9.10.2。

一、打印输出整体框图

  首先简介下本文介绍的打印输出方法整体软硬件框图,硬件上主要是 PC 主机、MCU 目标板、一根连接线(连接线有两种方案:一种是 RS232 串口线、另一种是 TTL 串口转 USB 模块板)。

  软件上 PC 这边需要安装一个串口调试助手软件,然后目标板 MCU 应用程序需要包含打印输出相关代码,当 MCU 程序运行起来后,驱动片内 UART 外设实现打印字符数据 (hello world.) 物理传输,在 PC 上串口调试助手软件里可以看到打印信息。

  上图里的 MCU 应用程序是在 IAR 环境下编译链接的,因此我们的重点就是 stdio.h 头文件里的 printf() 在 IAR 下到底是如何与 UART 外设驱动函数“勾搭”起来的。

二、C 标准头文件 stdio.h

  熟悉嵌入式工程的朋友应该都知道 stdio.h 头文件并不在用户工程文件夹里,无需我们手动添加该文件进工程目录,该文件是 C 标准定义的头文件,由工具链自动提供。

  stdio.h 是 C 语言为输入输出提供的标准库头文件,其前身是迈克·莱斯克 20 世纪 70 年代编写的“可移植输入输出程序库”。C 语言中的所有输入和输出都由抽象的字节流来完成,对文件的访问也通过关联的输入或输出流进行。

  大部分人学 C 语言一般都是在 Visual Studio / C++ 环境下,在这个环境里 stdio.h 定义的那些函数底层实现都由 Visual Studio 软件直接搞定,我们通常无需关心其实现细节。

  在嵌入式 IAR 环境下,这些标准 C 定义的头文件大部分也都是可以被支持的,我们可以在如下 IAR 软件目录找到它们,当我们在工程代码里加入 #include <stdio.h> 等语句时,实际上就是添加 IAR 软件目录里的文件进工程编译。

\IAR Systems\Embedded Workbench 9.10.2\arm\inc\c\stdio.h

  但是 IAR 目录下 stdio.h 文件里定义的诸如 printf() 函数具体实现我们是需要关注的,毕竟是要编译链接生成具体机器码下载进 MCU 运行的,但是 printf() 函数原型在哪呢?我们先留个悬念。

三、UART 外设驱动函数

  说到 UART 外设驱动函数,这个大家应该再熟悉不过了。我们以恩智浦 i.MXRT1060 型号(ARM Cortex-M7 内核)为例来具体介绍,在其官方 SDK 包里有相应的 LPUART 驱动文件:

\SDK_2.11.0_EVK-MIMXRT1060\devices\MIMXRT1062\drivers\fsl_lpuart.h
\SDK_2.11.0_EVK-MIMXRT1060\devices\MIMXRT1062\drivers\fsl_lpuart.c

  这个 LPUART 驱动库里的 LPUART_WriteBlocking() 和 LPUART_ReadBlocking() 函数可以完成用户数据包的发送和接收,其实单纯利用 LPUART_WriteBlocking() 函数也可以实现打印信息输出,只是没有 printf() 函数那样包含格式化输出的强大功能。

status_t LPUART_Init(LPUART_Type *base, const lpuart_config_t *config, uint32_t srcClock_Hz)
status_t LPUART_WriteBlocking(LPUART_Type *base, const uint8_t *data, size_t length)
status_t LPUART_ReadBlocking(LPUART_Type *base, uint8_t *data, size_t length)

四、IAR 对 C 标准 I/O 库的支持

  IAR 显然是对 C 标准 I/O 库有支持的,不然我们不可能在工程里能使用 printf() 函数,只是这个支持我们如何去轻松发现呢?痞子衡今天教大家一个方法,就是看工程编译链接后生成的 .map 文件,这个 map 文件里会列出工程里所有函数的来源。

4.1 引出底层接口 __write()

  我们以 \SDK_2.11.0_EVK-MIMXRT1060\boards\evkmimxrt1060\demo_apps\hello_world\iar 工程为例来介绍,需要简单改造一下工程里 hello_world.c 文件里的 main() 函数,将原来代码全部删掉(原来的打印输出涉及恩智浦 SDK 封装,本文没必要关心其实现),只要如下一句打印即可:

#include <stdio.h>
int main(void)
{
printf("hello world.\r\n");
while (1);
}

  然后注意工程选项里跟 Library 实现相关的如下三处设置。其中 Library 选项配置的是 runtime lib 的功能,有 Normal 和 Full 两个选项(可按需选择);Printf formatter 选项决定格式化输出功能细节,分 Full、Large、Small、Tiny 四个选项(可按需选择)。Library low-level interface implementation 选项决定低层 I/O 实现,这里我们选 None,即由用户来实现。

  配置好 Library 后编译工程会发现有如下报错,根据这个报错我们可以猜到 dl7M_tln.a 是 IAR 编译好的 C/C++ 库,库里面实现了 printf() 函数及其所依赖的 putchar() 函数,而 puchar() 函数对外提供了底层 I/O 接口函数,这个 I/O 函数名字叫 __write(),它就是需要用户结合芯片 UART 外设去实现的发送函数。

 Error[Li005]: no definition for "__write" [referenced from putchar.o(dl7M_tln.a)]

  在 IAR 目录下我们可以找到 dl7M_tln.a 文件路径,经过测试,工程 Library 设置里 Normal 和 Full 选项其实就是选 dl7M_tln.a 还是 dl7M_tlf.a 进用户工程去链接。

4.2 DLIB底层 I/O 接口设计

  找到了 __write() 函数,但是它的原型到底是什么?我们该如何实现它?这时候需要去查万能的 \IAR Systems\Embedded Workbench 9.10.2\arm\doc\EWARM_DevelopmentGuide.ENU 手册,在里面搜索 __write 字样可以找到如下设计,原来我们在代码里调用的 C 标准 I/O 接口均是由 IAR 底层预编译好的 DLIB 去具体实现的,这个 DLIB 库也留下了给用户实现的最底层与硬件相关的接口函数。

  IAR 为 DLIB 里那些最底层的 I/O 接口函数都创建了模板源文件,在这些模板文件里我们可以找到它们的原型,所以我们在 write.c 文件里找到了 __write() 原型及其示例实现。

size_t __write(int handle, const unsigned char * buffer, size_t size)

4.3 DLIB库 I/O 相关源码实现

  有了 __write() 原型及示例代码,我们很容易便能用 LPUART_WriteBlocking() 函数去实现它,将这个代码添加进 hello_world 工程编译,这时候就不会报错了(当然要想真正在板子上测试打印功能,main 函数里还得加入 LPUART 初始化代码)。

#include "fsl_lpuart.h"
size_t __write(int handle, const unsigned char *buf, size_t size)
{
// 假设使用 LPUART1 去做输出
(void)LPUART_WriteBlocking(LPUART1, buf, size); return 0;
}

  工程编译完成后,查看生成的 hello_world.map 文件,找到 dl7M_tln.a 部分的信息,可以看到其由很多个 .o 文件组成(功能比较丰富),这些 .o 文件都是可以在 IAR 安装目录下找到其源码的。

*******************************************************************************
*** MODULE SUMMARY
*** Module ro code ro data rw data
------ ------- ------- -------
dl7M_tln.a: [10]
abort.o 6
exit.o 4
low_level_init.o 4
printf.o 40
putchar.o 32
xfail_s.o 64 4
xprintfsmall_nomb.o 1'281
xprout.o 22
-----------------------------------------------
Total: 1'453 4

  DLIB 库中关于 I/O 相关的源码放在了如下目录里,感兴趣的可以去查看其具体实现,这里特别提一下 formatter 文件夹下 xprintf 有很多种不同的源文件实现,其实就对应了工程选项 Printf formatter 里的不同配置。

\IAR Systems\Embedded Workbench 9.10.2\arm\src\lib\dlib\file
\IAR Systems\Embedded Workbench 9.10.2\arm\src\lib\dlib\formatters

  至此,IAR下调试信息输出机制之硬件UART外设痞子衡便介绍完毕了,掌声在哪里~~~

欢迎订阅

文章会同时发布到我的 博客园主页CSDN主页知乎主页微信公众号 平台上。

微信搜索"痞子衡嵌入式"或者扫描下面二维码,就可以在手机上第一时间看了哦。

痞子衡嵌入式:浅析IAR下调试信息输出机制之硬件UART外设的更多相关文章

  1. 痞子衡嵌入式:浅析IAR下调试信息输出机制之半主机(Semihosting)

    大家好,我是痞子衡,是正经搞技术的痞子.今天痞子衡给大家分享的是IAR下调试信息输出机制之半主机(Semihosting). 在嵌入式世界里,输出打印信息是一种非常常用的辅助调试手段,借助打印信息,我 ...

  2. 痞子衡嵌入式:IAR在线调试时设不同复位类型可能会导致i.MXRT下调试现象不一致(J-Link / CMSIS-DAP)

    大家好,我是痞子衡,是正经搞技术的痞子.今天痞子衡给大家分享的是IAR在线调试时设不同复位类型可能会导致i.MXRT下调试现象不一致. 做Cortex-M内核MCU嵌入式软件开发,可用的集成开发环境( ...

  3. 痞子衡嵌入式:IAR内部C-SPY调试组件配套宏文件(.mac)用法介绍

    大家好,我是痞子衡,是正经搞技术的痞子.今天痞子衡给大家分享的是IAR内部C-SPY调试组件配套宏文件(.mac)用法. 痞子衡之前写过一篇 <JLink Script文件基础及其在IAR下调用 ...

  4. 痞子衡嵌入式:ARM Cortex-M调试那些事(1)- 4线协议标准(JTAG)

    大家好,我是痞子衡,是正经搞技术的痞子.今天痞子衡给大家讲的是嵌入式调试里的接口标准JTAG. 在结束<ARM Cortex-M文件那些事>系列文章之后,痞子衡休整了一小段时间,但是讲课的 ...

  5. 痞子衡嵌入式:飞思卡尔i.MX RTyyyy系列MCU硬件那些事(2.1)- 玩转板载OpenSDA,Freelink调试器

    大家好,我是痞子衡,是正经搞技术的痞子.今天痞子衡给大家介绍的是飞思卡尔i.MX RTyyyy系列EVK上板载调试器的用法. 本文是i.MXRT硬件那些事系列第二篇,第一篇痞子衡给大家整体介绍了i.M ...

  6. 痞子衡嵌入式:飞思卡尔i.MX RTyyyy系列MCU硬件那些事(2.2)- 在串行NOR Flash XIP调试原理

    大家好,我是痞子衡,是正经搞技术的痞子.今天痞子衡给大家介绍的是飞思卡尔i.MX RTyyyy系列EVK在串行NOR Flash调试的原理. 本文是i.MXRT硬件那些事系列第二篇的续集,在第二篇首集 ...

  7. 痞子衡嵌入式:飞思卡尔i.MX RTyyyy系列MCU硬件那些事(1)- 官方EVK简介

    大家好,我是痞子衡,是正经搞技术的痞子.今天痞子衡给大家介绍的是飞思卡尔i.MX RTyyyy系列MCU的配套EVK板. 半导体设计厂商发布任何一块MCU芯片新品,一般都会同步推出基于这款MCU的配套 ...

  8. 痞子衡嵌入式:在IAR开发环境下为工程开启CRC完整性校验功能的方法

    大家好,我是痞子衡,是正经搞技术的痞子.今天痞子衡给大家分享的是在IAR开发环境下为工程开启CRC完整性校验功能的方法. CRC校验在嵌入式领域里的应用非常广,比如在通信领域,CRC检验值可以作为数据 ...

  9. 痞子衡嵌入式:大话双核i.MXRT1170之在线联合调试双核工程的三种方法(IAR篇)

    大家好,我是痞子衡,是正经搞技术的痞子.今天痞子衡给大家分享的是i.MXRT1170下在线联合调试双核工程的方法(基于IAR). 前段时间痞子衡写过一篇<双核i.MXRT1170之单独在线调试从 ...

随机推荐

  1. Java 进阶路线图

    前言 个人的从事Java开发行业已经也有一段时间,提升自己的Java水平,特整理下学习路线图,以备日后使用. 路线图资料收集 图片打不开,建议使用复制链接打开:或者私信告诉我. Java架构师学习路线 ...

  2. PyTorch DataSet Normalization torchvision.transforms.Normalize()

         特征缩放, 在这种情况下,我们不仅仅考虑是一个值的数据集,我们考虑的是具有多个特征和相关的值的样本或元素的数据集. 假如正在处理一个人的数据集,           归一化数据集有许多不同的 ...

  3. python实现对简单的运算型验证码的识别【不使用OpenCV】

    最近在写我们学校的教务系统的手机版,在前端用户执行绑定操作后,服务器将执行登录,但在登录过程中,教务系统中有个运算型的验证码,大致是这个样子的: 下面我们开始实现这个验证码的识别. 1.图片读取 从网 ...

  4. CVE-2021-3156漏洞复现

    CVE-2021-3156linux sudo 权限提升 版本ubantu18.04 使用这个命令可以是普通用户直接提升至管理员权限. 手动测试终端输入 sudoedit -s / 不知道什么原因ub ...

  5. vue大型电商项目尚品汇(后台终结篇)day06 重磅!!!

    自此整个项目前后台,全部搭建完毕. 今天是最后一天,内容很多,而且也比较常用,一个图标类数据可视化,一个后台的权限管理,都是很经典的类型. 一.数据可视化 1.简介 专门的一门学科,有专门研究这个的岗 ...

  6. RPA 快手自动上传机器人

    1.打开账号Cookie预存表格 2.机器人自动登录账号 3.机器人开始按照预设视频位置开始自动上传视频 4.机器人开始自动填写视频相关信息内容 5.完成后,可自动切换下一个账号继续上传

  7. 前端下载图片的N种方法

    前几天一个简单的下载图片的需求折腾了我后端大佬好几天,最终还是需要前端来搞,开始说不行的笔者最后又行了,所以趁着这个机会来总结一下下载图片到底有多少种方法. 先起个服务 使用expressjs起个简单 ...

  8. (一)Linux环境的学习环境的搭建

    我们使用VMWARE来安装Debian11系统来进行我们的LINUX学习 Debian虚拟机的安装 vmware-tools的安装 xShell的安装使用 samba的配置 gcc环境的配置 Debi ...

  9. zip格式文件编码检测

    解压后文件名乱码 由于zip格式文件无编码存储的结构,因此解压时无法知道原先的编码. 当解压zip格式文件时使用的编码和原编码不一致时,就可能会出现解压后文件名乱码问题. 猜测编码 基于上述问题,需要 ...

  10. 5-15 Virtual 虚拟机

    虚拟机基本使用 Virtualbox安装流程 RockyLinux VirtualBox清华大学个版本下载路径 https://mirrors.tuna.tsinghua.edu.cn/virtual ...