UART_Open 函数

标头: #include <applibs/uart.h>

打开并配置 UART,并返回用于后续调用的文件描述符。

int UART_Open(UART_Id uartId, const UART_Config * uartConfig);

参数

  • uartId 要打开的 UART 的 ID。

  • uartConfig 指向定义 UART 配置的UART_Config结构的指针。 调用 UART_InitConfig 以获取具有默认设置 的UART_Config

错误

如果遇到错误并设置为 errno 错误值,则返回 -1。

  • EACCES:不允许访问 UART_IduartId 因为 应用程序清单的 Uart 字段中未列出 。

  • ENODEV: uartId 无效。

  • EINVAL: uartConfig 表示无效的配置。

  • EBUSY: uartId 已打开。

  • EFAULT:为 uartConfig NULL。

还可以指定任何其他 errno 错误;此类错误不是确定性的,并且可能不会通过系统更新保留相同的行为。

返回值

如果成功打开,则返回 UART 的文件描述符;如果失败,则返回 -1,在这种情况下 errno ,将 设置为错误值。

应用程序清单要求

若要访问单个 UART,应用程序必须在 应用程序清单的 Uart 字段中标识它们。