HCIA-HarmonyOS设备开发认证V2.0-IOT硬件子系统-UART

一、UART 概述

UART 是通用异步收发传输器（Universal Asynchronous Receiver/Transmitter）的缩写，是通用串行数据总线，用于异步通信，该总线双向通信，可以实现全双工传输。UART 应用比较广泛，常用于输出打印信息，也可以外接各种模块，如 GPS、蓝牙等。

• 异步通信

异步通信中，数据通常以字符或者字节为单位组成字符帧传送。字符帧由发送端逐帧发送，通过传输线被接收设备逐帧接收。发送端和接收端可以由各自的时钟来控制数据的发送和接收，这两个时钟源彼此独立，互不同步。异步通信以一个字符为传输单位，通信中两个字符间的时间间隔是不固定的，然而在同一个字符中的两个相邻位代码间的时间间隔是固定的。

• 全双工传输（Full Duplex）

此通信模式允许数据在两个方向上同时传输，它在能力上相当于两个单工通信方式的结合。全双工可以同时进行信号的双向传输。

UART 设备的连接示意图如下：

• TX：发送数据端，和对端的 RX 相连。
• RX：接收数据端，和对端的 TX 相连。
• RTS：发送请求信号，用于指示本设备是否准备好，可以接收数据，和对端 CTS 相连。
• CTS：允许发送信号，用于判断是否可以向对端发送数据，和对端 RTS 相连。

UART 通信之前，收发双方需要约定好：波特率、数据格式。

• 波特率：指信息传输到信道的速率。例如：9600、961200、115200 等。
• 数据格式：一帧数据由起始位、数据位、校验位、停止位组成。

UART 通信过程中，UART 通过 TX 发送数据给对端，通过 RX 接收对端数据。当 UART 接收缓存达到预定的门限值时，RTS 变为不可发送数据，对端的 CTS 检测到不可发送数据的信号，则停止发送数据。

UART 在进行数据传输时的数据格式如下：

UART 操作流程如下：

二、UART 模块相关API

头文件路径：base/iothardware/peripheral/interfaces/inner_api/iot_uart.h

接口函数	描述
unsigned int IoTUartInit(unsigned int id, const IotUartAttribute *param);	初始化UART
unsigned int IoTUartDeinit(unsigned int id);	清除初始化UART
int IoTUartWrite(unsigned int id, const unsigned char *data, unsigned int dataLen);	UART写操作
int IoTUartRead(unsigned int id, unsigned char *data, unsigned int dataLen);	UART读操作

三、UART 接口调用实例

//代码功能：定义了 UART 接口功能以及 UART 相关参数，GPIO_00 号口作为 UART1_TXD 模式以及 UART 相关参数，最后进行读写操作。

#include "iot_uart.h"
IotUartAttribute uart_attr = {
.baudRate = 9600, //波特率
.dataBits = 8, //数据位
.stopBits = 1, //停止位
.parity = 0, //优先级
};

IoTUartInit(UART1_TXD, &uart_attr);
IoTUartWrite(UART1_TXD, data, strlen(data));
IoTUartRead(UART1_TXD, buff, BUFF_SIZE);

四、UART HDF驱动开发

在HDF框架中，UART接口适配模式采用独立服务模式（如图3所示）。在这种模式下，每一个设备对象会独立发布一个设备服务来处理外部访问，设备管理器收到API的访问请求之后，通过提取该请求的参数，达到调用实际设备对象的相应内部方法的目的。独立服务模式可以直接借助HDF设备管理器的服务管理能力，但需要为每个设备单独配置设备节点，增加内存占用。

独立服务模式下，核心层不会统一发布一个服务供上层使用，因此这种模式下驱动要为每个控制器发布一个服务，具体表现为：

驱动适配者需要实现HdfDriverEntry的Bind钩子函数以绑定服务。

device_info.hcs文件中deviceNode的policy字段为1或2，不能为0。

UART模块各分层作用：

接口层提供打开UART设备、UART设备读取指定长度数据、UART设备写入指定长度数据、设置UART设备波特率、获取设UART设备波特率、设置UART设备属性、获取UART设备波特率、设置UART设备传输模式、关闭UART设备的接口。

核心层主要提供UART控制器的创建、移除以及管理的能力，通过钩子函数与适配层交互。

适配层主要是将钩子函数的功能实例化，实现具体的功能。

图 3 UART独立服务模式结构图

4.1、开发步骤(待续…)

UART模块适配包含以下四个部分。

• 驱实例化驱动入口
• 配置属性文件
• 实例化UART控制器对象
• 驱动调试

坚持就有收获