全志R128 SDK HAL 模块开发指南之 LPUART
模块介绍
LPUART 驱动主要实现设备驱动的底层细节，并为上层提供一套标准的 API 接口以供使用。
模块配置
配置路径如下:
Kernel Setup --->
Drivers Setup --->
SoC HAL Drivers --->
LPUART Devices --->
[*] enable lpuart driver
源码结构
LPUART 模块源码结构如下所示：
hal/source/lpuart/ ---- 驱动源码
├── hal_lpuart.c
├── Kconfig
├── Makefile
├── platform
│ ├── lpuart-sun20iw2p1.h ---- 平台地址，引脚复用等配置
│ └── ...
├── platform-lpuart.h
└── lpuart.h
include/hal/ ---- 驱动APIs声明头文件
└── hal_lpuart.h
模块接口说明
需要包含头文件
#include
初始化 LPUART 驱动
函数原型：
int32_t hal_lpuart_init(int32_t lpuart_port)
参数：
- lpuart_port：LPUART 端口号
返回值：
- SUNXI_HAL_OK: 成功
- HAL_LPUART_STATUS_ERROR: 失败
卸载 LPUART 驱动
函数原型：
int32_t hal_lpuart_deinit(int32_t lpuart_port)
参数：
- lpuart_port：LPUART 端口号
返回值：
- SUNXI_HAL_OK: 成功
设置波特率及参数
函数原型：
int32_t hal_lpuart_control(lpuart_port_t lpuart_port, int cmd, void *args)
参数：
- lpuart_port_t：LPUART 端口号
- cmd：预留，暂未使用
- args：指向 _lpuart_config_t 类型变量的数组
返回值：
- SUNXI_HAL_OK: 成功
- HAL_LPUART_STATUS_ERROR: 失败
接收处理
函数原型：
int32_t hal_lpuart_receive(int32_t dev, uint8_t *data, uint32_t num)
参数：
- dev：LPUART 端口号
- data: 接收数据缓冲区
- num: 接收数据长度
返回值：
- size: 成功接收的字节数
接收对比处理
函数原型：
int32_t hal_lpuart_rx_cmp(lpuart_port_t lpuart_port, uint8_t cmp_len, uint8_t *cmp_data);
参数：
- lpuart_port：LPUART 端口号
- cmp_len：比较数据的长度
- cmp_data：比较的数据
返回值：
- SUNXI_HAL_OK: 成功
- HAL_LPUART_STATUS_ERROR: 失败
启用接收对比处理回调
函数原型：
int32_t hal_lpuart_enable_rx_cmp(lpuart_port_t lpuart_port, lpuart_callback_t cb, void *arg);
参数：
- lpuart_port：LPUART 端口号
- cb：处理回调函数
- arg：回调函数的参数
返回值：
- SUNXI_HAL_OK: 成功
- HAL_LPUART_STATUS_ERROR: 失败
禁用接收对比处理回调
函数原型：
int32_t hal_lpuart_disable_rx_cmp(lpuart_port_t lpuart_port);
参数：
- lpuart_port：LPUART 端口号
返回值：
- SUNXI_HAL_OK: 成功
- HAL_LPUART_STATUS_ERROR: 失败
配置PM绕过模式
函数原型：
int32_t HAL_LPUART_SetBypassPmMode(lpuart_port_t lpuart_port, uint8_t mode);
参数：
- lpuart_port：LPUART 端口号
- mode：配置模式
返回值：
- SUNXI_HAL_OK: 成功
- HAL_LPUART_STATUS_ERROR: 失败
模块使用范例
#include
#include
#include
#include
#include
#include
#include
#include
#include
/* find a free uart_port or pc com as source */
#define UART_TEST UART_1
#define TEST_LEN 5
static void cmd_usage(void)
{
printf("Usage:\n"
"\t hal_lpuart \n");
}
void test_recv_data(lpuart_port_t port)
{
printf("enter recv data test\n");
hal_lpuart_enable_rx_data(port, NULL, NULL);
/* use uart as source */
hal_uart_init(UART_TEST);
hal_uart_send(UART_TEST, "a", 1);
/* use pc com as source */
printf("enter\n");
hal_sleep(5);
hal_lpuart_disable_rx_data(port);
}
static void compare_callback(void *arg)
{
printf("data compare success!\n");
}
void test_cmp_data(lpuart_port_t port)
{
printf("enter cmp data test\n");
char cmp[TEST_LEN + 1] = "abcde";
if (hal_lpuart_init(port)) {
printf("lpuart %d not inited\n", port);
return;
}
hal_lpuart_rx_cmp(port, TEST_LEN, cmp);
hal_lpuart_enable_rx_cmp(port, compare_callback, NULL);
/* use uart as source, stop bit of uart should be 2 */
hal_uart_init(UART_TEST);
hal_uart_send(UART_TEST, cmp, TEST_LEN);
/* use pc com as source */
printf("enter abcde\n");
hal_sleep(5);
hal_lpuart_disable_rx_cmp(port);
}
void lpuart_reset_multiplex()
{
lpuart_multiplex(LPUART_0, UART_0);
lpuart_multiplex(LPUART_1, UART_1);
}
int cmd_test_lpuart(int argc, char **argv)
{
if (argc != 3) {
cmd_usage();
return -1;
}
lpuart_port_t port;
uint32_t baudrate;
port = strtol(argv[1], NULL, 0);
baudrate = strtol(argv[2], NULL, 0);
if (hal_lpuart_init(port) != SUNXI_HAL_OK) {
printf("Fail to init lpuart\n");
return -1;
}
if (port == 0) {
lpuart_multiplex(LPUART_0, UART_TEST);
} else if (port == 1) {
lpuart_multiplex(LPUART_1, UART_TEST);
}
test_recv_data(port);
test_cmp_data(port);
lpuart_reset_multiplex();
return 0;
}
FINSH_FUNCTION_EXPORT_CMD(cmd_test_lpuart, hal_lpuart, lpuart hal APIs tests)