GPIO

函数列表

简要说明

GPIO(General Purpose Input Output)通用输入/输出接口提供了对每个信号管脚进行单独的高低电平状态控制功能，或者读入管脚高低电平状态的功能。

GPIO可配置为输入模式或输出模式。当配置为输出模式时，由软件来控制管脚的的高低电平状态。输出模式可支持开漏输出或推挽输出两种类型。当配置为输入模式时，管脚的高低电平状态由外部电路控制，软件可以读取管脚的高低电平状态。输入模式可支持带上拉电阻、下拉电阻的属性。

输入模式也支持将GPIO配置为中断触发源。中断触发模式一般包括高电平触发、低电平触发、双边沿触发、下降沿触发、上升沿触发五种模式。

接口描述

csi_gpio_pin_initialize

gpio_pin_handle_t csi_gpio_pin_initialize(int32_t gpio_pin, gpio_event_cb_t cb_event)

• 功能描述:

  • 通过传入的pin号初始化对应的gpio pin实例，返回gpio pin实例的句柄。

• 参数:

  • gpio_pin: pin号。
  • cb_event: 对应pin中断回调函数。

• 返回值:

  • NULL: 初始化失败。
  • 其它: 实例句柄。

csi_gpio_pin_uninitialize

int32_t csi_gpio_pin_uninitialize(gpio_pin_handle_t handle)

• 功能描述:

  • gpio
  • pin实例反初始化。该接口会停止gpio实例正在进行的传输（如果有），并且释放相关的软硬件资源。

• 参数:

  • handle: 实例句柄。

• 返回值:

  • 错误码。

csi_gpio_power_control

int32_t csi_gpio_power_control(gpio_pin_handle_t handle, csi_power_stat_e state)

• 功能描述:

  • 配置设备实例的功耗模式。

• 参数:

  • handle: 实例句柄。
  • state: 设备实例的功耗模式，参看csi_power_stat_e 的定义。

• 返回值:

  • 错误码。

csi_power_stat_e:

csi_gpio_pin_config_mode

int32_t csi_gpio_pin_config_mode(gpio_pin_handle_t handle, gpio_mode_e mode)

• 功能描述:

  • 配置gpio pin实例的工作模式。

• 参数:

  • handle: 实例句柄。
  • mode: gpio的工作方式，参看 gpio_mode_e 定义。

• 返回值:

  • 错误码。

gpio_mode_e:

csi_gpio_pin_config_direction

int32_t csi_gpio_pin_config_direction(gpio_pin_handle_t handle, gpio_direction_e dir);

• 功能描述:

• 参数:

  • handle: 实例句柄。
  • dir: gpio port口的方向，参看gpio_direction_e的定义。

• 返回值:

  • 错误码。

gpio_direction_e:

csi_gpio_pin_write

int32_t csi_gpio_pin_write(gpio_pin_handle_t handle, bool value)

• 功能描述:

  • 设置gpio pin的电平状态。

• 参数:

  • handle: 实例句柄。
  • value: 对应pin口中的值。

• 返回值:

  • 错误码。

csi_gpio_pin_read

int32_t csi_gpio_pin_read(gpio_pin_handle_t handle, bool *value)

• 功能描述:

  • 获取pin脚的电平状态。

• 参数:

  • handle: 实例句柄。
  • value: 存放pin脚的电平状态的缓冲区地址。

• 返回值:

  • 错误码。

csi_gpio_pin_set_irq

int32_t csi_gpio_pin_set_irq(gpio_pin_handle_t handle, gpio_irq_mode_e mode, bool enable)

• 功能描述:

  • 设置pin脚的中断模式。

• 参数:

  • handle: 实例句柄。
  • mode: 中断模式，参见 :gpio_irq_mode_e定义。
  • enable: 设置中断是否开启，0-禁止，1-使能。

• 返回值:

  • 错误码。

gpio_irq_mode_e: