此页面由 Cloud Translation API 翻译。

GPIO 初始化

某些驱动程序依赖于静态 GPIO 引脚或引脚多路复用配置，因主板而异在这些情况下，通常需要将 GPIO 保持在配置详细信息，以确保从属驱动程序可移植性这可以通过让板驱动程序通过元数据和初始化步骤列表传递给 GPIO 驱动程序。请参阅下文，了解示例。

在板驱动程序中配置 GPIO 元数据

假设 SDMMC 驱动程序要求引脚配置某些替代功能并推动力量。为此，板驱动程序需要创建一个 fuchsia.hardware.gpioimpl.InitStep 对象列表，用于指定要进行的 GPIO 协议调用，以及进行这些调用的 GPIO 索引：

#include <fidl/fuchsia.hardware.gpioimpl/cpp/wire.h>

// Helper lambda to simplify the following code.
auto sdmmc_gpio = [&](uint64_t alt_function, uint64_t drive_strength_ua) {
  return fuchsia_hardware_gpioimpl::wire::InitOptions::Builder(arena)
      .alt_function(alt_function)
      .drive_strength_ua(drive_strength_ua)
      .Build();
};

const fuchsia_hardware_gpioimpl::wire::InitStep init_steps[] = {
    {SDMMC_GPIO_0, sdmmc_gpio(SDMMC_GPIO_0_ALT_FUNCTION, 4000)},
    {SDMMC_GPIO_1, sdmmc_gpio(SDMMC_GPIO_1_ALT_FUNCTION, 4000)},
    {SDMMC_GPIO_2, sdmmc_gpio(SDMMC_GPIO_2_ALT_FUNCTION, 4000)},
    {SDMMC_GPIO_3, sdmmc_gpio(SDMMC_GPIO_3_ALT_FUNCTION, 4000)},
    {SDMMC_GPIO_4, sdmmc_gpio(SDMMC_GPIO_4_ALT_FUNCTION, 4000)},
    {SDMMC_GPIO_5, sdmmc_gpio(SDMMC_GPIO_5_ALT_FUNCTION, 4000)},
};

然后，系统会将此列表作为元数据提供给 GPIO 驱动程序：


fuchsia_hardware_gpioimpl::wire::InitMetadata metadata;
metadata.steps = fidl::VectorView<fuchsia_hardware_gpioimpl::wire::InitStep>::FromExternal(
    init_steps, std::size(init_steps));

fit::result encoded = fidl::Persist(metadata);
if (!encoded.is_ok()) {
  return encoded.error_value().status();
}

const std::vector<fpbus::Metadata> gpio_metadata{
    {{
        .type = DEVICE_METADATA_GPIO_INIT_STEPS,
        .data = std::move(encoded.value()),
    }},
    // Other metadata goes here.
};

const fpbus::Node gpio_dev = []() {
  fpbus::Node dev = {};
  dev.name() = "gpio";
  dev.vid() = PDEV_VID_SOME_VENDOR;
  dev.pid() = PDEV_PID_SOME_PRODUCT;
  dev.did() = PDEV_DID_SOME_GPIO_DEVICE;
  dev.mmio() = gpio_mmios;
  dev.irq() = gpio_irqs;
  dev.metadata() = gpio_metadata;
  return dev;
}();

// Add the node here.

使用绑定规则创建对 GPIO 配置的依赖项

现在，GPIO 驱动程序已正确配置这些引脚，SDMMC 驱动程序必须使该配置依赖于此配置这是通过在主板中向 SDMMC 设备添加额外的 Fragment 来实现驱动程序绑定文件：

using fuchsia.gpio;

// Other nodes go here.

node "gpio-init" {
  fuchsia.BIND_INIT_STEP == fuchsia.gpio.BIND_INIT_STEP.GPIO;
  fuchsia.BIND_GPIO_CONTROLLER = 1;
}

之后，GPIO 驱动程序会添加 fuchsia.gpio.BIND_INIT_STEP.GPIO 设备，它就已完成初始化步骤的处理。任意数量的子元素绑定到此设备，以确保之前已配置其 GPIO 启动。

GPIO 驱动程序如何处理配置错误

如果 GPIO 驱动程序在处理初始化步骤时遇到错误，它会继续设置其余的 GPIO，但不会添加 init 设备。这是为了确保将尽可能多的引脚置于已知状态，并且驱动程序不会尝试使用可能配置有误。同样，如果 GPIO 驱动程序不添加 init 设备，具有或无法解析初始化元数据。

GPIO 初始化选项

如需查看初始化选项的完整列表及其说明，请参阅 fuchsia.hardware.pinimpl FIDL 规范