GPIO_OpenAsInput 函数

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

打开 GPIO (常规用途 输入/输出) 作为输入。

  • 调用 打开 的输入 GPIO 上的GPIO_GetValue来读取输入值。

  • 对打开的输入 GPIO 进行GPIO_SetValue 调用将不起作用。

GPIO 函数在对不同 GPIO 的调用之间是线程安全的;但是,调用方负责确保访问同一 GPIO 的线程安全。

int GPIO_OpenAsInput(GPIO_Id gpioId);

参数

  • gpioId 标识 GPIO 的 GPIO_Id

错误

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

  • EACCES:不允许访问 gpioId ,因为 GPIO 未在应用程序清单的 Gpio 字段中列出。

  • ENODEV:提供的 gpioId 无效。

  • EBUSY: gpioId 已打开。

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

返回值

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

应用程序清单要求

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