GPIO_OpenAsOutput 函数

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

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

输出 GPIO 可配置为推送拉取、开路排出开放源代码。 在打开的输出 GPIO 上调用 GPIO_SetValue 以设置输出值。 还可以在打开的输出 GPIO 上调用 GPIO_GetValue 来读取当前值 (例如,当输出 GPIO 配置为GPIO_OutputMode_OpenDrain或GPIO_OutputMode_OpenSource) 时。

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

int GPIO_OpenAsOutput(GPIO_Id gpioId, GPIO_OutputMode_Type outputMode, GPIO_Value_Type initialValue);

参数

  • gpioId 标识 GPIO 的 GPIO_Id

  • outputMode GPIO 的 输出模式 。 输出可以配置为推送拉取、开路排出或开放源代码。

  • initialValue GPIO 的初始 GPIO_Value - GPIO_Value_High或GPIO_Value_Low。

错误

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

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

  • EBUSY: gpioId 已打开。

  • ENODEV: gpioId 无效。

  • EINVAL: outputMode 不是有效的 GPIO_OutputModeinitialValue 不是有效的 GPIO_Value

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

返回值

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

应用程序清单要求

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