LISA UART 轮询接收示例（轮询模式）

功能说明

演示如何使用 lisa_uart_poll_in() API 以轮询方式接收单字节数据。

底层使用轮询方式非阻塞接收每个字节，适用于简单的字符输入场景。

硬件连接

PB2: UART1 TX（发送）
PB3: UART1 RX（接收）

连接到 PC 串口工具，配置为 115200, 8N1, 无流控

使用场景

适用于以下场景：

简单的字符输入
命令行交互
低速率字节接收
不需要中断/事件的场景

示例步骤

获取 UART 设备
配置引脚
配置 UART
循环轮询检查是否有数据
调用 lisa_uart_poll_in() 尝试接收
如果成功，处理接收到的字节
短暂延时，避免CPU占用过高

编译

重要提示：在编译前，请先确认您使用的开发板型号。SDK 目前支持以下开发板：

arcs_evb - ARCS EVB 评估板
arcs_mini - ARCS Mini 开发板

根据您的开发板型号，选择对应的编译命令：

在示例目录下执行编译:

# 使用 arcs_evb 开发板
./build.sh -C -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -DBOARD=arcs_mini

Note

如果在 SDK 根目录执行，需要指定示例路径:

# 使用 arcs_evb 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_evb

# 或使用 arcs_mini 开发板
./build.sh -C -S samples/<示例路径> -DBOARD=arcs_mini

Note

确保已安装对应的工具链。

烧录

编译完成后，使用 SDK tools 目录下的 cskburn 工具烧录固件:

./tools/burn/cskburn -s /dev/ttyUSB0 -b 3000000 0x0 build/arcs.bin -C arcs

Note

烧录参数说明：

-s /dev/ttyUSB0：串口设备路径，需要根据实际情况修改 - Linux 系统：通常是 /dev/ttyUSB0 或 /dev/ttyACM0 - 可通过 ls /dev/tty* 命令查看可用串口设备 - 不同开发板或 USB 转串口芯片可能使用不同的设备名
-b 3000000：烧录波特率（3Mbps）
0x0：烧录起始地址
build/arcs.bin：编译生成的固件路径
-C arcs：芯片类型

注意事项：

确保开发板已正确连接到电脑
如果无法识别串口设备，请检查 USB 连接线是否正常，或尝试其他 USB 端口

预期输出

终端输出：

=== LISA UART poll_in example ===
UART ready, waiting for data...
Please send data via serial tool.

Received: 0x48 ('H')
Received: 0x65 ('e')
Received: 0x6C ('l')
Received: 0x6C ('l')
Received: 0x6F ('o')
...

PC 串口工具发送：

Hello

程序会实时显示接收到的每个字节，可打印字符会同时显示十六进制值和字符。

核心 API

API	说明
`lisa_device_get()`	获取 UART 设备
`lisa_uart_configure()`	配置 UART 参数
`lisa_uart_poll_in()`	轮询接收单字节（非阻塞）

轮询接收说明

lisa_uart_poll_in() 是一个非阻塞的单字节接收接口：

尝试接收一个字节：每次调用尝试读取一个字节
立即返回：不阻塞，无数据时立即返回错误码
轮询方式：底层不使用中断，直接读取硬件FIFO状态
返回值：
- 0：成功接收到数据
- LISA_DEVICE_ERR_TIMEOUT：无数据可读
- 其他负数：错误码
适用场景：轮询检查是否有数据到达

关键代码

/* 1. 获取并检查设备 */
lisa_device_t *uart_dev = lisa_device_get("uart1");

/* 2. 配置 UART (115200, 8N1) */
lisa_uart_config_t config = LISA_UART_CONFIG_DEFAULT();
lisa_uart_configure(uart_dev, &config);

/* 3. 循环轮询接收 */
while (1) {
    unsigned char ch;
    int ret = lisa_uart_poll_in(uart_dev, &ch);

    if (ret == 0) {
        /* 成功接收到数据 */
        if (ch >= 32 && ch <= 126) {
            printf("Received: 0x%02X ('%c')\n", ch, ch);
        } else {
            printf("Received: 0x%02X\n", ch);
        }
    }

    /* 短暂延时，避免CPU占用过高 */
    vTaskDelay(pdMS_TO_TICKS(10));
}

注意事项

非阻塞调用：lisa_uart_poll_in() 立即返回，无数据时不等待
单字节接收：每次只能接收一个字节，需要循环调用
CPU占用：需要循环轮询，建议添加适当延时以降低CPU占用
简单场景：适合简单字符输入，生产环境建议使用中断或DMA模式