OpenHarmony API-WifiIotIoName 枚举GPIO 硬件引脚名称

作者：马育民 • • 阅读：10026

说明

枚举类型，表示 GPIO 硬件引脚名称

/**
 * @brief Enumerates GPIO hardware pin IDs.
 */
typedef enum {
    /** GPIO hardware pin 0 */
    WIFI_IOT_IO_NAME_GPIO_0,
    /** GPIO hardware pin 1 */
    WIFI_IOT_IO_NAME_GPIO_1,
    /** GPIO hardware pin 2 */
    WIFI_IOT_IO_NAME_GPIO_2,
    /** GPIO hardware pin 3 */
    WIFI_IOT_IO_NAME_GPIO_3,
    /** GPIO hardware pin 4 */
    WIFI_IOT_IO_NAME_GPIO_4,
    /** GPIO hardware pin 5 */
    WIFI_IOT_IO_NAME_GPIO_5,
    /** GPIO hardware pin 6 */
    WIFI_IOT_IO_NAME_GPIO_6,
    /** GPIO hardware pin 7 */
    WIFI_IOT_IO_NAME_GPIO_7,
    /** GPIO hardware pin 8 */
    WIFI_IOT_IO_NAME_GPIO_8,
    /** GPIO hardware pin 9 */
    WIFI_IOT_IO_NAME_GPIO_9,
    /** GPIO hardware pin 10 */
    WIFI_IOT_IO_NAME_GPIO_10,
    /** GPIO hardware pin 11 */
    WIFI_IOT_IO_NAME_GPIO_11,
    /** GPIO hardware pin 12 */
    WIFI_IOT_IO_NAME_GPIO_12,
    /** GPIO hardware pin 13 */
    WIFI_IOT_IO_NAME_GPIO_13,
    /** GPIO hardware pin 14 */
    WIFI_IOT_IO_NAME_GPIO_14,
    /** Maximum value */
    WIFI_IOT_IO_NAME_MAX,
} WifiIotIoName;

头文件

\\base\iot_hardware\interfaces\kits\wifiiot_lite\wifiiot_gpio_ex.h

解释

你列出的是 OpenHarmony 物联网设备开发中 WifiIotIoName 枚举的具体定义，这是一套用于物理引脚名称的标准枚举，用于标识开发板上所有可配置的 GPIO 物理引脚，是硬件引脚与软件操作之间的“桥梁”。以下是详细解析：

1. 枚举值的核心含义

这些枚举值直接对应硬件上的物理 GPIO 引脚，每个值代表一个具体的物理引脚位置，例如：

  • WIFI_IOT_IO_NAME_GPIO_0 对应开发板上的第 0 号 GPIO 物理引脚
  • WIFI_IOT_IO_NAME_GPIO_9 对应开发板上的第 9 号 GPIO 物理引脚
  • …以此类推，直到 WIFI_IOT_IO_NAME_GPIO_14

末尾的 WIFI_IOT_IO_NAME_MAX 是边界标识，不对应实际引脚，主要用途：

  • 作为物理引脚总数的上限（例如遍历所有引脚时作为终止条件）
  • 验证引脚名称的合法性（若名称 >= WIFI_IOT_IO_NAME_MAX，则为无效引脚）

2. 核心特性与作用

  • 物理引脚的“唯一标识”：每个枚举值与硬件上的一个物理引脚一一绑定，无论该引脚后续被配置为通用 GPIO 还是其他复用功能（如 I2C、UART），其物理名称始终不变。
  • 功能配置的“入口参数”：是 IoSetFunc 函数的核心参数（用于配置引脚功能），例如将物理引脚 9 配置为通用 GPIO 或 I2C 时钟线。
  • 涵盖所有 GPIO 引脚：枚举范围从 GPIO0 到 GPIO14，完整覆盖了该平台支持的所有可配置为 GPIO 功能的物理引脚。

3. 与 WifiIotGpioIdx 的对应关系

WifiIotIoName（物理引脚名称）与 WifiIotGpioIdx（GPIO 逻辑索引）是一一对应的，例如：

  • 物理引脚 WIFI_IOT_IO_NAME_GPIO_9 ↔ 逻辑索引 WIFI_IOT_GPIO_IDX_9
  • 物理引脚 WIFI_IOT_IO_NAME_GPIO_5 ↔ 逻辑索引 WIFI_IOT_GPIO_IDX_5

这种对应关系是固定的，确保配置功能（用物理名称）和操作 GPIO（用逻辑索引）时能精准关联到同一硬件引脚。

4. 典型使用场景（配置引脚功能）

WifiIotIoName 最核心的用途是通过 IoSetFunc 函数配置引脚的工作模式，示例如下：

#include "wifiiot_gpio.h"

// 示例1：将物理引脚GPIO9配置为通用GPIO功能
IoSetFunc(WIFI_IOT_IO_NAME_GPIO_9, WIFI_IOT_IO_FUNC_GPIO_9_GPIO);

// 示例2：将物理引脚GPIO5配置为I2C0的SDA线（复用功能）
IoSetFunc(WIFI_IOT_IO_NAME_GPIO_5, WIFI_IOT_IO_FUNC_GPIO_5_I2C0_SDA);

// 示例3：将物理引脚GPIO3配置为PWM0输出（复用功能）
IoSetFunc(WIFI_IOT_IO_NAME_GPIO_3, WIFI_IOT_IO_FUNC_GPIO_3_PWM0_OUT);

配置完成后，若引脚被设为通用 GPIO，后续即可通过对应的 WifiIotGpioIdx 进行读写操作。

5. 注意事项

  • 物理引脚与硬件设计强相关：枚举中的 GPIO 编号（如 GPIO9）对应的实际物理位置（如开发板上的“Pin 20”）需参考开发板的《硬件手册》，不同开发板可能有差异。
  • 功能复用的排他性：同一物理引脚只能配置为一种功能（如配置为 I2C 后，就不能同时作为 GPIO 使用），否则会导致功能冲突。
  • 合法性检查：使用前需确保引脚名称 < WIFI_IOT_IO_NAME_MAX，例如：
    if (ioName >= WIFI_IOT_IO_NAME_MAX) {
    // 无效的物理引脚，处理错误
}

这些枚举值是 OpenHarmony 物联网设备开发中“硬件抽象层”的重要组成部分，通过统一的物理引脚命名，屏蔽了不同芯片底层的硬件差异，让开发者能通过标准化接口操作硬件，大幅降低了开发难度。

原文出处：/show_1GW1wHKNXl2a.html

吉ICP备15003043号