Harmony鸿蒙南向驱动开发-UART接口使用

2024-04-13 14:12
文章标签 接口 使用 开发 驱动 uart 鸿蒙 harmony 南向

本文主要是介绍Harmony鸿蒙南向驱动开发-UART接口使用，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

功能简介

UART指异步收发传输器（Universal Asynchronous Receiver/Transmitter），是通用串行数据总线，用于异步通信。该总线双向通信，可以实现全双工传输。

两个UART设备的连接示意图如下，UART与其他模块一般用2线（图1）或4线（图2）相连，它们分别是：

  • TX：发送数据端，和对端的RX相连。

  • RX：接收数据端，和对端的TX相连。

  • RTS：发送请求信号，用于指示本设备是否准备好，可接受数据，和对端CTS相连。

  • CTS：允许发送信号，用于判断是否可以向对端发送数据，和对端RTS相连。

图 1 2线UART设备连接示意图

2线UART设备连接示意图

图 2 4线UART设备连接示意图

4线UART设备连接示意图

UART通信之前，收发双方需要约定好一些参数：波特率、数据格式（起始位、数据位、校验位、停止位）等。通信过程中，UART通过TX发送给对端数据，通过RX接收对端发送的数据。当UART接收缓存达到预定的门限值时，RTS变为不可发送数据，对端的CTS检测到不可发送数据，则停止发送数据。

UART接口定义了操作UART端口的通用方法集合，包括：

  • 打开/关闭UART设备

  • 读写数据

  • 设置/获取UART设备波特率

  • 设置/获取UART设备属性

基本概念

  • 异步通信

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

  • 全双工传输（Full Duplex）

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

运作机制

在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独立服务模式结构图

UART独立服务模式结构图

约束与限制

UART模块UartSetTransMode接口设置传输模式在Linux中不支持，仅为空实现。

使用指导

场景介绍

UART模块应用比较广泛，主要用于实现设备之间的低速串行通信，例如输出打印信息，当然也可以外接各种模块，如GPS、蓝牙等。

接口说明

UART模块提供的主要接口如表1所示，具体API详见//drivers/hdf_core/framework/include/platform/uart_if.h。

表 1 UART驱动API接口功能介绍

接口名接口描述
DevHandle UartOpen(uint32_t port)UART获取设备句柄
void UartClose(DevHandle handle)UART释放设备句柄
int32_t UartRead(DevHandle handle, uint8_t *data, uint32_t size)从UART设备中读取指定长度的数据
int32_t UartWrite(DevHandle handle, uint8_t *data, uint32_t size)向UART设备中写入指定长度的数据
int32_t UartGetBaud(DevHandle handle, uint32_t *baudRate)UART获取波特率
int32_t UartSetBaud(DevHandle handle, uint32_t baudRate)UART设置波特率
int32_t UartGetAttribute(DevHandle handle, struct UartAttribute *attribute)UART获取设备属性
int32_t UartSetAttribute(DevHandle handle, struct UartAttribute *attribute)UART设置设备属性
int32_t UartSetTransMode(DevHandle handle, enum UartTransMode mode)UART设置传输模式

说明：
本文涉及的UART所有接口，支持内核态及用户态使用。

开发步骤

使用UART的一般流程如下图所示。

图 4 UART使用流程图

UART使用流程图

获取UART设备句柄

在使用UART进行通信时，首先要调用UartOpen获取UART设备句柄，该函数会返回指定端口号的UART设备句柄。

DevHandle UartOpen(uint32_t port);

表 2 UartOpen参数和返回值描述

参数参数描述
portuint32_t类型，UART设备号
返回值返回值描述
NULL获取UART设备句柄失败
设备句柄UART设备句柄

假设系统中的UART端口号为1，获取该UART设备句柄的示例如下：

DevHandle handle = NULL;    // UART设备句柄
uint32_t port = 1;          // UART设备端口号handle = UartOpen(port);
if (handle == NULL) {HDF_LOGE("UartOpen: open uart_%u failed!\n", port);return;
}
UART设置波特率

在通信之前，需要设置UART的波特率，设置波特率的函数如下所示：

int32_t UartSetBaud(DevHandle handle, uint32_t baudRate);

表 3 UartSetBaud参数和返回值描述

参数参数描述
handleDevHandle类型，UART设备句柄
baudRateuint32_t类型，待设置的波特率值
返回值返回值描述
HDF_SUCCESSUART设置波特率成功
负数UART设置波特率失败

假设需要设置的UART波特率为9600，设置波特率的实例如下：

int32_t ret;ret = UartSetBaud(handle, 9600);    // 设置UART波特率
if (ret != HDF_SUCCESS) {HDF_LOGE("UartSetBaud: failed, ret %d\n", ret);return ret;
}
UART获取波特率

设置UART的波特率后，可以通过获取波特率接口来查看UART当前的波特率，获取波特率的函数如下所示：

int32_t UartGetBaud(DevHandle handle, uint32_t *baudRate);

表 4 UartGetBaud参数和返回值描述

参数参数描述
handleDevHandle类型，UART设备句柄
baudRateuint32_t类型指针，用于接收波特率的值
返回值返回值描述
HDF_SUCCESSUART获取波特率成功
负数UART获取波特率失败

获取波特率的实例如下：

int32_t ret;
uint32_t baudRate;ret = UartGetBaud(handle, &baudRate);    // 获取UART波特率
if (ret != HDF_SUCCESS) {HDF_LOGE("UartGetBaud: failed, ret %d\n", ret);return ret;
}
UART设置设备属性

在通信之前，需要设置UART的设备属性，设置设备属性的函数如下所示：

int32_t UartSetAttribute(DevHandle handle, struct UartAttribute *attribute);

表 5 UartSetAttribute参数和返回值描述

参数参数描述
handleDevHandle类型，UART设备句柄
attribute结构体指针，待设置的设备属性
返回值返回值描述
HDF_SUCCESSUART设置设备属性成功
负数UART设置设备属性失败

设置UART的设备属性的实例如下：

int32_t ret;
struct UartAttribute attribute;attribute.dataBits = UART_ATTR_DATABIT_7;     // UART传输数据位宽，一次传输7个bit
attribute.parity = UART_ATTR_PARITY_NONE;     // UART传输数据无校检
attribute.stopBits = UART_ATTR_STOPBIT_1;     // UART传输数据停止位为1位
attribute.rts = UART_ATTR_RTS_DIS;            // UART禁用RTS
attribute.cts = UART_ATTR_CTS_DIS;            // UART禁用CTS
attribute.fifoRxEn = UART_ATTR_RX_FIFO_EN;    // UART使能RX FIFO
attribute.fifoTxEn = UART_ATTR_TX_FIFO_EN;    // UART使能TX FIFOret = UartSetAttribute(handle, &attribute);   // 设置UART设备属性
if (ret != HDF_SUCCESS) {HDF_LOGE("UartSetAttribute: failed, ret %d\n", ret);
turn ret;
}
UART获取设备属性

设置UART的设备属性后，可以通过获取设备属性接口来查看UART当前的设备属性，获取设备属性的函数如下所示：

int32_t UartGetAttribute(DevHandle handle, struct UartAttribute *attribute);

表 6 UartGetAttribute参数和返回值描述

参数参数描述
handleDevHandle类型，UART设备句柄
attribute结构体指针，接收UART设备属性的指针
返回值返回值描述
HDF_SUCCESSUART获取设备属性成功
负数UART获取设备属性失败

获取UART的设备属性的实例如下：

int32_t ret;
struct UartAttribute attribute;ret = UartGetAttribute(handle, &attribute);    // 获取UART设备属性
if (ret != HDF_SUCCESS) {HDF_LOGE("UartGetAttribute: failed, ret %d\n", ret);return ret;
}
设置UART传输模式

在通信之前，需要设置UART的传输模式，设置传输模式的函数如下所示：

int32_t UartSetTransMode(DevHandle handle, enum UartTransMode mode);

表 7 UartSetTransMode参数和返回值描述

参数参数描述
handleDevHandle类型，UART设备句柄
mode枚举类型，待设置的传输模式
返回值返回值描述
HDF_SUCCESSUART设置传输模式成功
负数UART设置传输模式失败

假设需要设置的UART传输模式为UART_MODE_RD_BLOCK，设置传输模式的实例如下：

int32_t ret;ret = UartSetTransMode(handle, UART_MODE_RD_BLOCK);    // 设置UART传输模式
if (ret != HDF_SUCCESS) {HDF_LOGE("UartSetTransMode: failed, ret %d\n", ret);return ret;
}
向UART设备写入指定长度的数据

对应的接口函数如下所示：

int32_t UartWrite(DevHandle handle, uint8_t *data, uint32_t size);

表 8 UartWrite参数和返回值描述

参数参数描述
handleDevHandle类型，UART设备句柄
datauint8_t类型指针，待写入数据的
sizeuint32_t类型，待写入数据的长度
返回值返回值描述
HDF_SUCCESSUART写数据成功
负数UART写数据失败

写入指定长度数据的实例如下：

int32_t ret;
uint8_t wbuff[5] = {1, 2, 3, 4, 5};ret = UartWrite(handle, wbuff, 5);    // 向UART设备写入指定长度的数据
if (ret != HDF_SUCCESS) {HDF_LOGE("UartWrite: failed, ret %d\n", ret);return ret;
}
从UART设备中读取指定长度的数据

对应的接口函数如下所示：

int32_t UartRead(DevHandle handle, uint8_t *data, uint32_t size);

表 9 UartRead参数和返回值描述

参数参数描述
handleDevHandle类型，UART设备句柄
datauint8_t类型指针，接收读取数据
sizeuint32_t类型，待读取数据的长度
返回值返回值描述
非负数UART读取到的数据长度
负数UART读取数据失败

读取指定长度数据的实例如下：

int32_t ret;
uint8_t rbuff[5] = {0};ret = UartRead(handle, rbuff, 5);    // 从UART设备读取指定长度的数据
if (ret < 0) {HDF_LOGE("UartRead: failed, ret %d\n", ret);return ret;
}

注意： UART返回值为非负值，表示UART读取成功。若返回值等于0，表示UART无有效数据可以读取。若返回值大于0，表示实际读取到的数据长度，该长度小于或等于传入的参数size的大小，并且不超过当前正在使用的UART控制器规定的最大单次读取数据长度的值。

销毁UART设备句柄

UART通信完成之后，需要销毁UART设备句柄，函数如下所示：

void UartClose(DevHandle handle);

该函数会释放申请的资源。

表 10 UartClose参数和返回值描述

参数参数描述
handleUART设备句柄

销毁UART设备句柄的实例如下：

UartClose(handle);    // 销毁UART设备句柄

使用实例

下面将基于Hi3516DV300开发板展示使用UART完整操作，步骤主要如下：

  1. 传入UART端口号num，打开端口号对应的UART设备并获得UART设备句柄。

  2. 通过UART设备句柄及设置的波特率，设置UART设备的波特率。

  3. 通过UART设备句柄及待获取的波特率，获取UART设备的波特率。

  4. 通过UART设备句柄及待设置的设备属性，设置UART设备的设备属性。

  5. 通过UART设备句柄及待获取的设备属性，获取UART设备的设备属性。

  6. 通过UART设备句柄及待设置的传输模式，设置UART设备的传输模式。

  7. 通过UART设备句柄及待传输的数据及大小，传输指定长度的数据。

  8. 通过UART设备句柄及待接收的数据及大小，接收指定长度的数据。

  9. 通过UART设备句柄，关闭UART设备。

#include "hdf_log.h"
#include "uart_if.h"static int32_t UartTestSample(void)
{int32_t ret;uint32_t port;uint32_t baud;DevHandle handle = NULL;uint8_t wbuff[5] = { 1, 2, 3, 4, 5 };uint8_t rbuff[5] = { 0 };struct UartAttribute attribute;attribute.dataBits = UART_ATTR_DATABIT_7;                  // UART传输数据位宽，一次传输7个bitattribute.parity = UART_ATTR_PARITY_NONE;                  // UART传输数据无校检attribute.stopBits = UART_ATTR_STOPBIT_1;                  // UART传输数据停止位为1位attribute.rts = UART_ATTR_RTS_DIS;                         // UART禁用RTSattribute.cts = UART_ATTR_CTS_DIS;                         // UART禁用CTSattribute.fifoRxEn = UART_ATTR_RX_FIFO_EN;                 // UART使能RX FIFOattribute.fifoTxEn = UART_ATTR_TX_FIFO_EN;                 // UART使能TX FIFOport = 1;                                                  // UART设备端口号，要填写实际平台上的端口号handle = UartOpen(port);                                   // 获取UART设备句柄if (handle == NULL) {HDF_LOGE("UartOpen: open uart_%u failed!\n", port);return HDF_FAILURE;}ret = UartSetBaud(handle, 9600);                           // 设置UART波特率为9600if (ret != HDF_SUCCESS) {HDF_LOGE("UartSetBaud: set baud failed, ret %d\n", ret);goto ERR;}ret = UartGetBaud(handle, &baud);                          // 获取UART波特率if (ret != HDF_SUCCESS) {HDF_LOGE("UartGetBaud: get baud failed, ret %d\n", ret);goto ERR;}ret = UartSetAttribute(handle, &attribute);                // 设置UART设备属性if (ret != HDF_SUCCESS) {HDF_LOGE("UartSetAttribute: set attribute failed, ret %d\n", ret);goto ERR;}ret = UartGetAttribute(handle, &attribute);                // 获取UART设备属性if (ret != HDF_SUCCESS) {HDF_LOGE("UartGetAttribute: get attribute failed, ret %d\n", ret);goto ERR;}ret = UartSetTransMode(handle, UART_MODE_RD_NONBLOCK);     // 设置UART传输模式为非阻塞模式if (ret != HDF_SUCCESS) {HDF_LOGE("UartSetTransMode: set trans mode failed, ret %d\n", ret);goto ERR;}ret = UartWrite(handle, wbuff, 5);                         // 向UART设备写入5字节的数据if (ret != HDF_SUCCESS) {HDF_LOGE("UartWrite: write data failed, ret %d\n", ret);goto ERR;}ret = UartRead(handle, rbuff, 5);                          // 从UART设备读取5字节的数据if (ret < 0) {HDF_LOGE("UartRead: read data failed, ret %d\n", ret);goto ERR;}HDF_LOGI("%s: function tests end, %d", __func__, ret);
ERR:UartClose(handle);                                         // 销毁UART设备句柄return ret;
}

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。 

这篇关于Harmony鸿蒙南向驱动开发-UART接口使用的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/900359。

相关文章

这15个Vue指令，让你的项目开发爽到爆

这15个Vue指令，让你的项目开发爽到爆

1. V-Hotkey 仓库地址: github.com/Dafrok/v-ho… Demo: 戳这里 https://dafrok.github.io/v-hotkey 安装: npm install --save v-hotkey 这个指令可以给组件绑定一个或多个快捷键。你想要通过按下 Escape 键后隐藏某个组件，按住 Control 和回车键再显示它吗？小菜一碟： <template
阅读更多...
中文分词jieba库的使用与实景应用（一）

中文分词jieba库的使用与实景应用（一）

知识星球：https://articles.zsxq.com/id_fxvgc803qmr2.html 目录 一.定义： 精确模式（默认模式）： 全模式： 搜索引擎模式： paddle 模式（基于深度学习的分词模式）： 二 自定义词典 三.文本解析   调整词出现的频率 四. 关键词提取 A. 基于TF-IDF算法的关键词提取 B. 基于TextRank算法的关键词提取
阅读更多...
Hadoop企业开发案例调优场景

Hadoop企业开发案例调优场景

需求 （1）需求：从1G数据中，统计每个单词出现次数。服务器3台，每台配置4G内存，4核CPU，4线程。 （2）需求分析： 1G / 128m = 8个MapTask；1个ReduceTask；1个mrAppMaster 平均每个节点运行10个 / 3台 ≈ 3个任务（4    3    3） HDFS参数调优 （1）修改：hadoop-env.sh export HDFS_NAMENOD
阅读更多...
使用SecondaryNameNode恢复NameNode的数据

使用SecondaryNameNode恢复NameNode的数据

1）需求： NameNode进程挂了并且存储的数据也丢失了，如何恢复NameNode 此种方式恢复的数据可能存在小部分数据的丢失。 2）故障模拟 （1）kill -9 NameNode进程 [lytfly@hadoop102 current]$ kill -9 19886 （2）删除NameNode存储的数据（/opt/module/hadoop-3.1.4/data/tmp/dfs/na
阅读更多...
Hadoop数据压缩使用介绍

Hadoop数据压缩使用介绍

一、压缩原则 （1）运算密集型的Job，少用压缩 （2）IO密集型的Job，多用压缩 二、压缩算法比较 三、压缩位置选择 四、压缩参数配置 1）为了支持多种压缩/解压缩算法，Hadoop引入了编码/解码器 2）要在Hadoop中启用压缩，可以配置如下参数
阅读更多...
Makefile简明使用教程

Makefile简明使用教程

文章目录 规则makefile文件的基本语法：加在命令前的特殊符号：.PHONY伪目标: Makefilev1 直观写法v2 加上中间过程v3 伪目标v4 变量 make 选项-f-n-C Make 是一种流行的构建工具，常用于将源代码转换成可执行文件或者其他形式的输出文件(如库文件、文档等)。Make 可以自动化地执行编译、链接等一系列操作。 规则 makefile文件
阅读更多...
使用opencv优化图片（画面变清晰）

使用opencv优化图片（画面变清晰）

文章目录 需求影响照片清晰度的因素 实现降噪测试代码 锐化空间锐化Unsharp Masking频率域锐化对比测试 对比度增强常用算法对比测试 需求 对图像进行优化，使其看起来更清晰，同时保持尺寸不变，通常涉及到图像处理技术如锐化、降噪、对比度增强等 影响照片清晰度的因素 影响照片清晰度的因素有很多，主要可以从以下几个方面来分析 1. 拍摄设备 相机传感器：相机传
阅读更多...
嵌入式QT开发：构建高效智能的嵌入式系统

嵌入式QT开发：构建高效智能的嵌入式系统

摘要： 本文深入探讨了嵌入式 QT 相关的各个方面。从 QT 框架的基础架构和核心概念出发，详细阐述了其在嵌入式环境中的优势与特点。文中分析了嵌入式 QT 的开发环境搭建过程，包括交叉编译工具链的配置等关键步骤。进一步探讨了嵌入式 QT 的界面设计与开发，涵盖了从基本控件的使用到复杂界面布局的构建。同时也深入研究了信号与槽机制在嵌入式系统中的应用，以及嵌入式 QT 与硬件设备的交互，包括输入输出设
阅读更多...
OpenHarmony鸿蒙开发（ Beta5.0）无感配网详解

OpenHarmony鸿蒙开发（ Beta5.0）无感配网详解

1、简介 无感配网是指在设备联网过程中无需输入热点相关账号信息，即可快速实现设备配网，是一种兼顾高效性、可靠性和安全性的配网方式。 2、配网原理 2.1 通信原理 手机和智能设备之间的信息传递，利用特有的NAN协议实现。利用手机和智能设备之间的WiFi 感知订阅、发布能力，实现了数字管家应用和设备之间的发现。在完成设备间的认证和响应后，即可发送相关配网数据。同时还支持与常规Sof
阅读更多...
活用c4d官方开发文档查询代码

活用c4d官方开发文档查询代码

当你问AI助手比如豆包，如何用python禁止掉xpresso标签时候，它会提示到 这时候要用到两个东西。https://developers.maxon.net/论坛搜索和开发文档 比如这里我就在官方找到正确的id描述 然后我就把参数标签换过来
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2