全志R128 SDK HAL 模块开发指南之 UART

UART

Universal Asynchronous Receiver/Transmitter,通用异步收发传输器

  • Compatible with industry-standard 16450/16550 UARTs
  • 64-Byte Transmit and receive data FIFOs
  • Supports DMA controller interface
  • Supports Software/ Hardware Flow Control
  • Supports IrDA 1.0 SIR
  • Supports RS-485 mode

模块配置

其menuconfig 的配置如下:

Kernel Setup --->Drivers Setup --->SoC HAL Drivers --->UART devices --->[*] enable uart driver[*] enbale uart hal APIs Test command

源码结构

.
│  hal_uart.c         # 驱动源码
│  platform-uart.h    # 平台选择头文件
│  uart.h             # 驱动私有头文件
└─platformuart-sun20iw2p1.h # 平台特化定义

模块接口说明

头文件

#include <hal_uart.h>

返回值枚举

typedef enum
{HAL_UART_STATUS_ERROR_PARAMETER = -4,      /**< Invalid user input parameter. */HAL_UART_STATUS_ERROR_BUSY = -3,           /**< UART port is currently in use. */HAL_UART_STATUS_ERROR_UNINITIALIZED = -2,  /**< UART port has not been initialized. */HAL_UART_STATUS_ERROR = -1,                /**< UART driver detected a common error. */HAL_UART_STATUS_OK = 0                     /**< UART function executed successfully. */
} hal_uart_status_t;

波特率枚举

typedef enum
{UART_BAUDRATE_300 = 0,UART_BAUDRATE_600,UART_BAUDRATE_1200,UART_BAUDRATE_2400,UART_BAUDRATE_4800,UART_BAUDRATE_9600,UART_BAUDRATE_19200,UART_BAUDRATE_38400,UART_BAUDRATE_57600,UART_BAUDRATE_115200,UART_BAUDRATE_230400,UART_BAUDRATE_576000,UART_BAUDRATE_921600,UART_BAUDRATE_1000000,UART_BAUDRATE_1500000,UART_BAUDRATE_3000000,UART_BAUDRATE_4000000,UART_BAUDRATE_MAX,
} uart_baudrate_t;

UART 字长枚举

typedef enum
{UART_WORD_LENGTH_5 = 0,UART_WORD_LENGTH_6,UART_WORD_LENGTH_7,UART_WORD_LENGTH_8,
} uart_word_length_t;

UART 停止位枚举

typedef enum
{UART_STOP_BIT_1 = 0,UART_STOP_BIT_2,
} uart_stop_bit_t;

UART 奇偶枚举

typedef enum
{UART_PARITY_NONE = 0,UART_PARITY_ODD,UART_PARITY_EVEN
} uart_parity_t;

UART 配置结构体

typedef struct
{uart_baudrate_t baudrate;uart_word_length_t word_length;uart_stop_bit_t stop_bit;uart_parity_t parity;
} _uart_config_t;

获取UART驱动的版本号

函数原型:

sunxi_hal_version_t hal_uart_get_version(int32_t dev)

参数:

  • dev:UART端口号

返回:

  • UART 驱动版本号

初始化UART驱动

函数原型:

int32_t hal_uart_init(int32_t uart_port);

参数:

  • uart_port:UART 端口号

返回:

  • 0:成功
  • 负数:失败

初始化异构AMP UART控制台

函数原型:

int32_t hal_uart_init_for_amp_cli(int32_t uart_port);

参数:

  • uart_port:UART 端口号

返回:

  • 0:成功
  • 负数:失败

卸载UART驱动

函数原型:

int32_t hal_uart_deinit(int32_t uart_port);

参数:

  • uart_port:UART 端口号

返回:

  • 0:成功
  • 负数:失败

发送数据

函数原型:

int32_t hal_uart_send(int32_t dev, const uint8_t *data, uint32_t num);

参数:

  • dev:UART 端口号
  • data:准备发送的数据buffer
  • num:buffer 大小

返回:

  • 成功发送的字节数

发送一个字符

函数原型:

int32_t hal_uart_put_char(int32_t dev, char c);

参数:

  • dev:UART 端口号
  • c:待发送的字符

返回:

  • 1:成功

接收数据

函数原型:

int32_t hal_uart_receive(int32_t dev, uint8_t *data, uint32_t num);

参数:

  • dev:UART 端口号
  • data:接收数据缓冲区
  • num:接收数据的大小

返回:

  • size:接收到的数据大小

非阻塞接收数据

函数原型:

int32_t hal_uart_receive_no_block(int32_t dev, uint8_t *data, uint32_t num, int32_t timeout);

参数:

  • dev:UART 端口号
  • data:接收数据缓冲区
  • num:接收数据的大小
  • timeout:超时时间

返回:

  • size:接收到的数据大小

接收一个字符

函数原型:

uint8_t hal_uart_get_char(int32_t dev);

参数:

  • dev:UART 端口号

返回:

  • 收到的字符值

设置 UART 工作参数

函数原型:

int32_t hal_uart_control(int32_t uart_port, int cmd, void *args);

参数:

  • uart_port:UART 端口号
  • cmd:保留
  • args: 指向 _uart_config_t 类型的结构体

返回:

  • 0:成功
  • 负数:失败

轮询接收

函数原型:

int32_t hal_uart_receive_polling(int32_t dev, uint8_t *data, uint32_t num);

参数:

  • dev:UART 端口号
  • data:接收数据缓冲区
  • num:接收数据的大小

返回:

  • size:接收到的数据大小

查看轮询接收状态

函数原型:

int32_t hal_uart_check_poll_state(int32_t dev_id, short key);

参数:

  • dev_id:UART 端口号
  • key:标志位,取值 POLLIN,POLLOUT,POLLERR

返回:

  • UART 当前的接收状态

执行唤醒处理函数

函数原型:

int32_t hal_uart_poll_wakeup(int32_t dev_id, short key);

参数:

  • dev_id:UART 端口号
  • key:标志位,取值 POLLIN,POLLOUT,POLLERR

返回:

  • 回调函数执行返回值

注册唤醒处理函数

函数原型:

int32_t hal_uart_register_poll_wakeup(poll_wakeup_func poll_wakeup);

参数:

  • poll_wakeup:回调函数

返回:

  • 0

设置硬件流控

函数原型:

void hal_uart_set_hardware_flowcontrol(uart_port_t uart_port);

参数:

  • uart_port:UART 端口号

返回:

禁用硬件流控

函数原型:

void hal_uart_disable_flowcontrol(uart_port_t uart_port);

参数:

  • uart_port:UART 端口号

返回:

设置 UART 回环

函数原型:

void hal_uart_set_loopback(uart_port_t uart_port, bool enable);

参数:

  • uart_port:UART 端口号
  • enable:是否开启

返回:

使能 RX 中断

函数原型:

int32_t hal_uart_enable_rx(int32_t uart_port);

参数:

  • uart_port:UART 端口号

返回:

  • 0

失能 RX 中断

函数原型:

int32_t hal_uart_disable_rx(int32_t uart_port);

参数:

  • uart_port:UART 端口号

返回:

  • 0

模块使用范例

#include <stdio.h>
#include <stdlib.h>
#include <stdint.h>
#include <string.h>#include <hal_log.h>
#include <hal_cmd.h>
#include <hal_timer.h>
#include <hal_uart.h>static void cmd_usage(void)
{printf("Usage:\n""\t hal_uart <port> <baudrate>\n");
}int cmd_test_uart(int argc, char **argv)
{uint8_t tbuf[6] = {"hello"};uint8_t rbuf[10] = {0};uart_port_t port;uint32_t baudrate;_uart_config_t uart_config;int i;hal_log_info("Testing UART in loopback mode");if (argc != 3) {cmd_usage();return -1;}port = strtol(argv[1], NULL, 0);baudrate = strtol(argv[2], NULL, 0);if(CONFIG_CLI_UART_PORT == port){hal_log_info("uart0 can't test, please use other port!");return -1;}memset(rbuf, 0, 10 * sizeof(uint8_t));switch (baudrate) {case 4800:uart_config.baudrate = UART_BAUDRATE_4800;break;case 9600:uart_config.baudrate = UART_BAUDRATE_9600;break;case 115200:uart_config.baudrate = UART_BAUDRATE_115200;break;case 1500000:uart_config.baudrate = UART_BAUDRATE_1500000;break;case 4000000:uart_config.baudrate = UART_BAUDRATE_4000000;break;default:hal_log_info("Using default baudrate: 115200");uart_config.baudrate = UART_BAUDRATE_115200;break;}uart_config.word_length = UART_WORD_LENGTH_8;uart_config.stop_bit = UART_STOP_BIT_1;uart_config.parity = UART_PARITY_NONE;hal_uart_init(port);hal_uart_control(port, 0, &uart_config);hal_uart_disable_flowcontrol(port);hal_uart_set_loopback(port, 1);/* send */hal_uart_send(port, tbuf, 5);/* loopback receive */hal_uart_receive_no_block(port, rbuf, 5, MS_TO_OSTICK(1000));printf("Sending:");for (i = 0; i < 5; i++)printf("%c", tbuf[i]);printf("\n");printf("Receiving:");for (i = 0; i < 5; i++)printf("%c", rbuf[i]);printf("\n");/* verify data */for (i = 0; i < 5; i++) {if (tbuf[i] != rbuf[i])break;}if (i == 5) {hal_log_info("Test hal_uart_init API success!");hal_log_info("Test hal_uart_control API success!");hal_log_info("Test hal_uart_disable_flowcontrol API success!");hal_log_info("Test hal_uart_set_loopback API success!");hal_log_info("Test hal_uart_send API success!");hal_log_info("Test hal_uart_receive API success!");hal_log_info("Test hal_uart_deinit API success!");hal_log_info("Test uart hal APIs success!");} else {hal_log_info("Test uart hal APIs failed!");}hal_msleep(1000);hal_uart_deinit(port);return 0;
}FINSH_FUNCTION_EXPORT_CMD(cmd_test_uart, hal_uart, uart hal APIs tests)#define BUFFSIZE 4096static void cmd_stress_usage(void)
{printf("Usage:\n""\t hal_uart <port> <baudrate> <flowctrl> <loopback> <len>\n");
}int cmd_test_uart_stress(int argc, char **argv)
{uint8_t *tbuf = malloc(BUFFSIZE);uint8_t *rbuf = malloc(BUFFSIZE);uart_port_t port;uint32_t baudrate;_uart_config_t uart_config;int i;int flowctrl, loopback, testlen;hal_log_info("Testing UART in loopback mode with stress");if (argc != 6) {cmd_stress_usage();free(tbuf);free(rbuf);return -1;}port = strtol(argv[1], NULL, 0);baudrate = strtol(argv[2], NULL, 0);flowctrl = strtol(argv[3], NULL, 0);loopback = strtol(argv[4], NULL, 0);testlen = strtol(argv[5], NULL, 0);for (i = 0; i < BUFFSIZE; i++) {tbuf[i] = ('a' + i) & 0xff;}memset(rbuf, 0, BUFFSIZE * sizeof(uint8_t));switch (baudrate) {case 4800:uart_config.baudrate = UART_BAUDRATE_4800;break;case 9600:uart_config.baudrate = UART_BAUDRATE_9600;break;case 115200:uart_config.baudrate = UART_BAUDRATE_115200;break;case 1500000:uart_config.baudrate = UART_BAUDRATE_1500000;break;default:hal_log_info("Using default baudrate: 115200");uart_config.baudrate = UART_BAUDRATE_115200;break;}uart_config.word_length = UART_WORD_LENGTH_8;uart_config.stop_bit = UART_STOP_BIT_1;uart_config.parity = UART_PARITY_NONE;hal_uart_init(port);hal_uart_control(port, 0, &uart_config);printf("flow:%d, loopback:%d len:%d\n", flowctrl, loopback, testlen);if (flowctrl)hal_uart_set_hardware_flowcontrol(port);elsehal_uart_disable_flowcontrol(port);if (loopback)hal_uart_set_loopback(port, 1);elsehal_uart_set_loopback(port, 0);/* send */printf("send\n");hal_uart_send(port, tbuf, testlen);printf("send done\n");printf("recv\n");/* loopback receive */hal_uart_receive(port, rbuf, testlen);printf("recv done\n");#if 0printf("Sending:");for (i = 0; i < testlen; i++) {if (i % 16 == 0)printf("\n");printf("0x%x ", tbuf[i]);}printf("\n");printf("Receiving:");for (i = 0; i < testlen; i++) {if (i % 16 == 0)printf("\n");printf("0x%x ", rbuf[i]);}printf("\n");
#endif/* verify data */for (i = 0; i < testlen; i++) {if (tbuf[i] != rbuf[i]) {printf("check %d fail, 0x%x != 0x%x\n", i, tbuf[i], rbuf[i]);break;}}if (i == testlen) {hal_log_info("Test hal_uart_init API success!");hal_log_info("Test hal_uart_control API success!");hal_log_info("Test hal_uart_disable_flowcontrol API success!");hal_log_info("Test hal_uart_set_loopback API success!");hal_log_info("Test hal_uart_send API success!");hal_log_info("Test hal_uart_receive API success!");hal_log_info("Test hal_uart_deinit API success!");hal_log_info("Test uart hal APIs success!");} else {hal_log_info("Test uart hal APIs failed!");}hal_msleep(1000);hal_uart_deinit(port);free(tbuf);free(rbuf);return 0;
}FINSH_FUNCTION_EXPORT_CMD(cmd_test_uart_stress, hal_uart_stress, uart hal APIs tests)

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/819532.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

[ROS 系列学习教程] 建模与仿真 - URDF 语法介绍

ROS 系列学习教程(总目录) 本文目录 一、robot标签二、link标签三、joint标签 URDF文件中使用XML格式描述的机器人模型&#xff0c;下面介绍URDF的XML标签。 一、robot标签 机器人描述文件中的根元素必须是robot&#xff0c;所有其他元素必须封装在其中。 属性 name&#x…

postman接口测试(入门到精通)

下载&#xff1a; postman官方地址 测试外部接口&#xff1a;测试被测系统和外部系统之间的接口。&#xff08;只需要测试正例即可&#xff09; 测试内部接口&#xff1a; 1.内部接口只提供给内部系统使用。&#xff08;只需要测试正例即可&#xff09; 2.内部接口提供给外…

AI大模型探索之路-应用篇13:企业AI大模型选型指南

目录 前言 一、概述 二、有哪些主流模型&#xff1f; 三、模型参数怎么选&#xff1f; 四、参数有什么作用&#xff1f; 五、CPU和GPU怎么选&#xff1f; 六、GPU和显卡有什么关系&#xff1f; 七、GPU主流厂商有哪些&#xff1f; 1、NVIDIA芯片怎么选&#xff1f; 2、…

P8602蓝桥杯大臣找路

很久以前&#xff0c;T 王国空前繁荣。为了更好地管理国家&#xff0c;王国修建了大量的快速路&#xff0c;用于连接首都和王国内的各大城市。 为节省经费&#xff0c;T 国的大臣们经过思考&#xff0c;制定了一套优秀的修建方案&#xff0c;使得任何一个大城市都能从首都直接…

政安晨:【深度学习神经网络基础】(八)—— 神经网络评估回归与模拟退火训练

目录 简述 评估回归 模拟退火训练 政安晨的个人主页&#xff1a;政安晨 欢迎 &#x1f44d;点赞✍评论⭐收藏 收录专栏: 政安晨的机器学习笔记 希望政安晨的博客能够对您有所裨益&#xff0c;如有不足之处&#xff0c;欢迎在评论区提出指正&#xff01; 简述 深度学习神经网…

全排列问题

日升时奋斗&#xff0c;日落时自省 目录 1、全排列 2、全排列II 3、子集 4、组合 1、全排列 首先要了解全排列是怎么样的 例如:数组[1,2,3]的全排列&#xff08;全排列就是不同顺序排列方式&#xff09; 例子所有的排列方式如&#xff1a;[1,2,3],[1,3,2],[2,1,3],[2,3…

大话设计模式之享元模式

享元模式是一种结构型设计模式&#xff0c;旨在有效地支持大量细粒度的对象共享&#xff0c;从而减少内存消耗和提高性能。 在享元模式中&#xff0c;对象分为两种&#xff1a;内部状态&#xff08;Intrinsic State&#xff09;和外部状态&#xff08;Extrinsic State&#xf…

初级软件测试常见问题

1.JMeter &#xff08;1&#xff09;在http请求的时候&#xff0c;消息体数据中的数据需要用{}和“”标记起来&#xff0c;变量要用${}括起来。 &#xff08;2&#xff09;在响应断言的时候&#xff0c;要根据测试模式输出的内容来改变测试字段&#xff0c;假如输出错误可以把…

vscode 调试debug gdb vector string等STL容器,指定长度

主要展示2个调试信息&#xff1a; 1. 数组 *tr20&#xff0c;指tr数组的前20个元素 2.Vector *(int(*)[5])a ,指a容器前5个元素&#xff0c;也可以解决1的问题 二维数组 -exec p/d b也可以 附&#xff1a;命令参考 gdb 调试常用命令 - 红旗kernel - 博客园 (cnblogs.com) GD…

书生·浦语大模型开源体系(五)笔记

&#x1f497;&#x1f497;&#x1f497;欢迎来到我的博客&#xff0c;你将找到有关如何使用技术解决问题的文章&#xff0c;也会找到某个技术的学习路线。无论你是何种职业&#xff0c;我都希望我的博客对你有所帮助。最后不要忘记订阅我的博客以获取最新文章&#xff0c;也欢…

定时器、PWM定时器、UART串口通信

我要成为嵌入式高手之4月15日ARM第八天&#xff01;&#xff01; ———————————————————————————— 定时器 S3C2440A 有 5 个 16 位定时器。其中定时器 0、1、2 和 3 具有脉宽调制&#xff08;PWM&#xff09;功能。定时器 4 是一个无 输出引脚的内部…

部署项目的时候的一些错误

项目打jar包&#xff0c;找不到资源&#xff0c;连接不上数据库 项目打包后无法运行 直接在idea运行可以 解决方法&#xff1a;pom文件中增加&#xff08;配置文件如果是yml&#xff0c;写yml&#xff09; <resources><resource><directory>src/main/java&…

MySQL—MySQL架构

MySQL—MySQL架构 MySQL逻辑架构图如下&#xff1a; Connectors连接器:负责跟客户端建立连接&#xff1b;Management Serveices & Utilities系统管理和控制工具&#xff1b;Connection Pool连接池:管理用户连接&#xff0c;监听并接收连接的请求&#xff0c;转发所有连接的…

使用Scrapy选择器提取豆瓣电影信息,并用正则表达式从介绍详情中获取指定信息

本文同步更新于博主个人博客&#xff1a;blog.buzzchat.top 一、Scrapy框架 1. 介绍 在当今数字化的时代&#xff0c;数据是一种宝贵的资源&#xff0c;而网络爬虫&#xff08;Web Scraping&#xff09;则是获取网络数据的重要工具之一。而在 Python 生态系统中&#xff0c;S…

hadoop编程之部门工资求和

数据集展示 7369SMITHCLERK79021980/12/17800207499ALLENSALESMAN76981981/2/201600300307521WARDSALESMAN76981981/2/221250500307566JONESMANAGER78391981/4/22975207654MARTINSALESMAN76981981/9/2812501400307698BLAKEMANAGER78391981/5/12850307782CLARKMANAGER78391981/…

Rust语言入门第五篇-数据类型

文章目录 数据类型1.标量类型1. 整数类型2.浮点数类型f32 和 f64示例代码注意事项 3.布尔类型4.字符类型 2.复合类型整数类型技术细节1. 检查溢出&#xff08;Checking Overflow&#xff09;2. 溢出时 panic&#xff08;Panic on Overflow&#xff09;3. 使用 Wrapping 模式&am…

hadoop编程之工资序列化排序

数据集展示 7369SMITHCLERK79021980/12/17800207499ALLENSALESMAN76981981/2/201600300307521WARDSALESMAN76981981/2/221250500307566JONESMANAGER78391981/4/22975207654MARTINSALESMAN76981981/9/2812501400307698BLAKEMANAGER78391981/5/12850307782CLARKMANAGER78391981/…

【C语言基础】:预处理详解(二)

文章目录 一、宏和函数的对比二、#和##运算符2.1 #运算符2.2 ##运算符 三、#undef四、命令行定义五、条件编译六、头文件的包含1. 头文件包含的方式2. 嵌套文件包含 上期回顾&#xff1a; 【C语言基础】&#xff1a;预处理详解(一) 一、宏和函数的对比 宏通常被应有于执行简单…

Web前端-JavaScript

黑马程序员JavaWeb开发教程 文章目录 一、js引入方式1、内部脚本2、外部脚本 二、js基础语法1、书写语法&#xff08;1&#xff09;基本语法&#xff08;2&#xff09;输出语句 2、变量&#xff08;1&#xff09;变量&#xff08;2&#xff09;注意事项 3、数据类型、运算符、流…

腾讯云服务器CVM标准型S8实例CPU内存、网络和存储性能测评

腾讯云第八代云服务器标准型S8实例基于全新优化虚拟化平台&#xff0c;CPU采用Intel Emerald Rapids 全新处理器&#xff0c;睿频3.0GHz&#xff0c;内存采用最新DDR5&#xff0c;默认网络优化&#xff0c;最高内网收发能力达4500万pps&#xff0c;最高内网带宽可支持120Gbps。…