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 <hal_lpuart.h>

初始化 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 <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_lpuart.h>
#include <hal_uart.h>

/* 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 <port> <baudrate>\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)