GPIO使用指导

使用流程

GPIO标准API通过GPIO管脚号来操作指定管脚，使用GPIO的一般流程如图1所示。

图 1 GPIO使用流程图
GPIO使用指导 - 图1

确定GPIO管脚号

不同SOC芯片由于其GPIO控制器型号、参数、以及控制器驱动的不同，GPIO管脚号的换算方式不一样。

  • Hi3516DV300

控制器管理12组GPIO管脚，每组8个。

GPIO号 = GPIO组索引 (0~11) * 每组GPIO管脚数(8) + 组内偏移

举例：GPIO10_3的GPIO号 = 10 * 8 + 3 = 83 - Hi3518EV300

控制器管理10组GPIO管脚，每组10个。

GPIO号 = GPIO组索引 (0~9) * 每组GPIO管脚数(10) + 组内偏移

举例：GPIO7_3的GPIO管脚号 = 7 * 10 + 3 = 73

使用API操作GPIO管脚

  • 设置GPIO管脚方向

在进行GPIO管脚读写前，需要先通过如下函数设置GPIO管脚方向：

int32_t GpioSetDir(uint16_t gpio, uint16_t dir);

表 1 GpioSetDir参数和返回值描述
参数 参数描述
gpio 待设置的GPIO管脚号
dir 待设置的方向值
返回值 返回值描述
0 设置成功
负数 设置失败
- 读写GPIO管脚

如果要读取一个GPIO管脚电平，通过以下函数完成：

int32_t GpioRead(uint16_t gpio, uint16_t *val);

表 2 GpioRead参数和返回值描述
参数 参数描述
gpio 待读取的GPIO管脚号
val 接收读取电平值的指针
返回值 返回值描述
0 读取成功
负数 读取失败

如果要向GPIO管脚写入电平值，通过以下函数完成：

int32_t GpioWrite(uint16_t gpio, uint16_t val);

表 3 GpioWrite参数和返回值描述
参数 参数描述
gpio 待写入的GPIO管脚号
val 待写入的电平值
返回值 返回值描述
0 写入成功
负数 写入失败

示例代码：

```

  1. int32_t ret;
  2. uint16_t val;
  3. / 将3号GPIO管脚配置为输出 /
  4. ret = GpioSetDir(3, GPIO_DIR_OUT);
  5. if (ret != 0) {
  6. HDF_LOGE("GpioSerDir: failed, ret %d\n", ret);
  7. return;
  8. }
  9. / 向3号GPIO管脚写入低电平GPIO_VAL_LOW /
  10. ret = GpioWrite(3, GPIO_VAL_LOW);
  11. if (ret != 0) {
  12. HDF_LOGE("GpioWrite: failed, ret %d\n", ret);
  13. return;
  14. }
  15. / 将6号GPIO管脚配置为输入 /
  16. ret = GpioSetDir(6, GPIO_DIR_IN);
  17. if (ret != 0) {
  18. HDF_LOGE("GpioSetDir: failed, ret %d\n", ret);
  19. return;
  20. }
  21. / 读取6号GPIO管脚的电平值 /
  22. ret = GpioRead(6, &val); ```
  • 设置GPIO中断

如果要为一个GPIO管脚设置中断响程序，使用如下函数：

int32_t GpioSetIrq(uint16_t gpio, uint16_t mode, GpioIrqFunc func, void *arg);

表 4 GpioSetIrq参数和返回值描述
参数 参数描述
gpio GPIO管脚号
mode 中断触发模式
func 中断服务程序
arg 传递给中断服务程序的入参
返回值 返回值描述
0 设置成功
负数 设置失败

GPIO使用指导 - 图2 注意： 同一时间，只能为某个GPIO管脚设置一个中断服务函数，如果重复调用GpioSetIrq函数，则之前设置的中断服务函数会被取代。

当不再需要响应中断服务函数时，使用如下函数取消中断设置：

int32_t GpioUnSetIrq(uint16_t gpio);

表 5 GpioUnSetIrq参数和返回值描述
参数 参数描述
gpio GPIO管脚号
返回值 返回值描述
0 取消成功
负数 取消失败

在中断服务程序设置完成后，还需要先通过如下函数使能GPIO管脚的中断：

int32_t GpioEnableIrq(uint16_t gpio);

表 6 GpioEnableIrq参数和返回值描述
参数 参数描述
gpio GPIO管脚号
返回值 返回值描述
0 使能成功
负数 使能失败

GPIO使用指导 - 图3 注意： 必须通过此函数使能管脚中断，之前设置的中断服务函数才能被正确响应。

如果要临时屏蔽此中断，可以通过如下函数禁止GPIO管脚中断：

int32_t GpioDisableIrq(uint16_t gpio);

表 7 GpioDisableIrq参数和返回值描述
参数 参数描述
gpio GPIO管脚号
返回值 返回值描述
0 禁止成功
负数 禁止失败

示例代码：

```

  1. /* 中断服务函数
  2. */
  3. int32_t MyCallBackFunc(uint16_t gpio, void *data)
  4. {
  5. HDF_LOGI("%s: gpio:%u interrupt service in! data=%p\n", func, gpio, data);
  6. return 0;

  7. }

  8. int32_t ret;

  9. / 设置中断服务程序为MyCallBackFunc，入参为NULL，中断触发模式为上升沿触发 /
  10. ret = GpioSetIrq(3, OSAL_IRQF_TRIGGER_RISING, MyCallBackFunc, NULL);
  11. if (ret != 0) {
  12. HDF_LOGE("GpioSetIrq: failed, ret %d\n", ret);
  13. return;

  14. }

  15. / 使能3号GPIO管脚中断 /

  16. ret = GpioEnableIrq(3);
  17. if (ret != 0) {
  18. HDF_LOGE("GpioEnableIrq: failed, ret %d\n", ret);
  19. return;

  20. }

  21. / 禁止3号GPIO管脚中断 /

  22. ret = GpioDisableIrq(3);
  23. if (ret != 0) {
  24. HDF_LOGE("GpioDisableIrq: failed, ret %d\n", ret);
  25. return;

  26. }

  27. / 取消3号GPIO管脚中断服务程序 /

  28. ret = GpioUnSetIrq(3);
  29. if (ret != 0) {
  30. HDF_LOGE("GpioUnSetIrq: failed, ret %d\n", ret);
  31. return;
  32. } ```