全志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)

你可能感兴趣的:(全志R128,智能硬件,UART,LPUART,驱动开发,全志,R128)