HPM 平台 GPIO 驱动实现 / GPIO driver implementation for HPM platform. More...

#include <hpm_gpio.hpp>

Inheritance diagram for LibXR::HPMGPIO:

Collaboration diagram for LibXR::HPMGPIO:

Data Structures
struct	PortIrqRouteState
	端口级 IRQ 路由状态 / Shared port-level IRQ routing state. More...

Public Member Functions
	HPMGPIO (GPIO_Type *gpio, uint32_t port, uint8_t pin, uint32_t irq=INVALID_IRQ, uint16_t pad_index=INVALID_PAD_INDEX)
	构造 HPM GPIO 对象 / Construct an HPM GPIO object.

bool	Read () override
	读取引脚电平 / Read current pin level.

void	Write (bool value) override
	写引脚电平 / Write output pin level.

ErrorCode	EnableInterrupt () override
	使能当前引脚中断 / Enable GPIO interrupt for current pin.

ErrorCode	DisableInterrupt () override
	失能当前引脚中断 / Disable GPIO interrupt for current pin.

ErrorCode	SetConfig (Configuration config) override
	配置当前引脚模式 / Configure GPIO mode for current pin.

ErrorCode	SetAnalogHighImpedance ()
	将当前 PAD 配置为模拟高阻 / Configure current pad to analog high-impedance.

Public Member Functions inherited from LibXR::GPIO
	GPIO ()
	默认构造函数。Default constructor.

virtual	~GPIO ()=default
	虚析构函数。Virtual destructor.

ErrorCode	RegisterCallback (Callback callback)
	注册 GPIO 事件回调函数。Registers a callback function for GPIO events.

Static Public Member Functions
static void	CheckInterrupt (uint32_t port)
	分发某一端口的 GPIO 中断回调 / Dispatch GPIO interrupt callbacks for one port.

Static Private Member Functions
static uint16_t	ResolvePadIndex (GPIO_Type *gpio, uint32_t port, uint8_t pin)
	根据控制器与端口引脚推导 IOC PAD 编号 / Resolve IOC PAD index from controller/port/pin tuple.

Private Attributes
GPIO_Type *	gpio_
	GPIO 控制器实例 / GPIO controller instance.

uint32_t	port_
	GPIO 端口号 / GPIO port index.

uint8_t	pin_
	GPIO 引脚号 / GPIO pin index.

uint32_t	irq_
	当前 port 对应 IRQ 号 / IRQ number for the current port.

uint16_t	pad_index_
	IOC PAD 编号 / IOC PAD index.

bool	interrupt_enabled_ = false
	当前 pin IRQ 使能状态 / Per-instance IRQ enabled flag.

Static Private Attributes
static constexpr uint32_t	PORT_COUNT = 15u
	支持的端口数量 / Supported port count.

static constexpr uint32_t	PIN_COUNT = 32
	每个端口引脚数 / Pins per port.

static constexpr uint32_t	INVALID_IRQ = 0xFFFFFFFFu
	无效 IRQ 标记 / Invalid IRQ marker.

static constexpr uint16_t	INVALID_PAD_INDEX = 0xFFFFu
	无效 PAD 标记 / Invalid PAD marker.

static HPMGPIO *	map [PORT_COUNT][PIN_COUNT] = {}
	GPIO 对象映射表 / GPIO object dispatch map.

static GPIO_Type *	port_controller_map [PORT_COUNT] = {}

static PortIrqRouteState	port_irq_route_map [PORT_COUNT] = {}

Additional Inherited Members
Public Types inherited from LibXR::GPIO
enum class	Direction : uint8_t { INPUT , OUTPUT_PUSH_PULL , OUTPUT_OPEN_DRAIN , FALL_INTERRUPT , RISING_INTERRUPT , FALL_RISING_INTERRUPT }
	定义 GPIO 引脚的方向类型。Defines the direction types for GPIO pins. More...

enum class	Pull : uint8_t { NONE , UP , DOWN }
	定义 GPIO 引脚的上拉/下拉模式。Defines the pull-up/pull-down configurations for GPIO pins. More...

using	Callback = LibXR::Callback<>

Data Fields inherited from LibXR::GPIO
Callback	callback_
	GPIO 事件的回调函数。Callback function for GPIO events.

Detailed Description

HPM 平台 GPIO 驱动实现 / GPIO driver implementation for HPM platform.

该类将 LibXR GPIO 抽象接口适配到 HPM SDK GPIO API。Read() 和 Write() 分别调用 gpio_read_pin() 与 gpio_write_pin()；SetConfig() 调用 gpio_set_pin_input()、gpio_set_pin_output() 和 gpio_config_pin_interrupt()，并在可解析 PAD 时更新 IOC FUNC_CTL、 PAD_CTL 的 GPIO 复用、loopback、上下拉和开漏位。EnableInterrupt() 与 DisableInterrupt() 只支持普通 HPM_GPIO0 中断路径；完整 SDK GPIO 示例说明 FGPIO 不支持中断，因此 HPM_FGPIO 中断请求返回 ErrorCode::NOT_SUPPORT，并且不会注册到中断分发表。

This class adapts the LibXR GPIO abstraction to HPM SDK GPIO APIs. Read() and Write() call gpio_read_pin() and gpio_write_pin() respectively. SetConfig() calls gpio_set_pin_input(), gpio_set_pin_output(), and gpio_config_pin_interrupt(), and updates IOC FUNC_CTL / PAD_CTL GPIO mux, loopback, pull, and open-drain bits when the PAD can be resolved. EnableInterrupt() and DisableInterrupt() support only the normal HPM_GPIO0 IRQ path; the full SDK GPIO sample states that FGPIO does not support interrupts, so interrupt requests on HPM_FGPIO return ErrorCode::NOT_SUPPORT and are not registered in the interrupt dispatch map.

中断回调由 CheckInterrupt() 统一分发。 Interrupt callbacks are dispatched through CheckInterrupt().

Definition at line 59 of file hpm_gpio.hpp.

Constructor & Destructor Documentation

◆ HPMGPIO()

HPMGPIO::HPMGPIO	(	GPIO_Type *	gpio,
		uint32_t	port,
		uint8_t	pin,
		uint32_t	irq = INVALID_IRQ,
		uint16_t	pad_index = INVALID_PAD_INDEX )

构造 HPM GPIO 对象 / Construct an HPM GPIO object.

构造 HPM GPIO 对象并注册到中断映射表 / Construct HPM GPIO object and register into interrupt map.

Parameters

gpio	GPIO 控制器基地址 / GPIO controller base address.
port	GPIO 端口号 / GPIO port index.
pin	GPIO 引脚号 / GPIO pin index.
irq	当前 port 对应的 PLIC IRQ 号；没有中断需求时可保持默认值 / PLIC IRQ number for the current port. Keep the default when interrupt support is not needed.
pad_index	IOC PAD 编号，默认值表示自动由 `(gpio, port, pin)` 推导；无法推导时仍可读写 GPIO，但 PAD 复用和模拟高阻配置会受限 / IOC PAD index. The default auto-resolves it from `(gpio, port, pin)`. If it cannot be resolved, GPIO read/write can still work, while PAD mux and analog high-impedance configuration are limited.

Definition at line 97 of file hpm_gpio.cpp.

    : gpio_(gpio),
      port_(port),
      pin_(pin),
      irq_(irq),
      pad_index_(pad_index == INVALID_PAD_INDEX ? ResolvePadIndex(gpio, port, pin)
                                                : pad_index)
{
  if (port_ < PORT_COUNT && pin_ < PIN_COUNT && !HPM_GPIO_IsFastController(gpio_))
  {
    map[port_][pin_] = this;
    if (port_controller_map[port_] == nullptr)
    {
      port_controller_map[port_] = gpio_;
    }
  }
}

Member Function Documentation

◆ CheckInterrupt()

void HPMGPIO::CheckInterrupt ( uint32_t port )

static

分发某一端口的 GPIO 中断回调 / Dispatch GPIO interrupt callbacks for one port.

扫描并分发指定端口的 GPIO 中断 / Scan and dispatch GPIO IRQ callbacks for one port.

Parameters

port	GPIO 端口号 / GPIO port index.

该函数应在板级 GPIO IRQ Handler 中调用。 This function should be called by board IRQ handlers.

同时会清除触发引脚的中断标志位。 It also clears interrupt flags for triggered pins.

Parameters

port	GPIO 端口号 / GPIO port index.

建议在板级 IRQHandler 中仅调用一次该函数：

读取端口中断标志；
逐 pin 清标志；
触发对应对象的 LibXR 回调。 Recommended to call once from board IRQ handler:
read port IRQ flags;
clear flag per asserted pin;
run corresponding LibXR callback.

Definition at line 393 of file hpm_gpio.cpp.

{
  if (port >= PORT_COUNT)
  {
    return;
  }
 
  GPIO_Type* controller = port_controller_map[port];
  if (controller == nullptr)
  {
    return;
  }
 
  const uint32_t flags = gpio_get_port_interrupt_flags(controller, port);
  if (flags == 0u)
  {
    return;
  }
 
  for (uint8_t pin = 0; pin < PIN_COUNT; ++pin)
  {
    if ((flags & (1u << pin)) == 0u)
    {
      continue;
    }
 
    gpio_clear_pin_interrupt_flag(controller, port, pin);
    if (auto* gpio = map[port][pin]; gpio != nullptr && gpio->interrupt_enabled_)
    {
      gpio->callback_.Run(true);
    }
  }
}

◆ DisableInterrupt()

ErrorCode HPMGPIO::DisableInterrupt ( )

overridevirtual

失能当前引脚中断 / Disable GPIO interrupt for current pin.

失能当前引脚中断 / Disable interrupt for current pin.

Returns: 成功返回 ErrorCode::OK；IRQ/端口参数无效返回 ErrorCode::ARG_ERR； HPM_FGPIO 返回 ErrorCode::NOT_SUPPORT；端口路由状态异常返回 ErrorCode::STATE_ERR / Returns ErrorCode::OK on success, ErrorCode::ARG_ERR for invalid irq/port/pin, ErrorCode::NOT_SUPPORT for HPM_FGPIO, and ErrorCode::STATE_ERR when shared port-route state is inconsistent.

Note: HPM SDK gpio_disable_pin_interrupt() 只清当前 pin 的 GPIO IE 位；共享 PLIC 路由只在同 port 最后一个已启用 pin disable 后关闭 / HPM SDK gpio_disable_pin_interrupt() only clears the current pin's GPIO IE bit; the shared PLIC route is closed only after the last enabled pin on the same port is disabled.

先关闭当前 pin 的 GPIO 事件；仅当该 port 最后一个已使能 pin 被释放时，才关闭共享的 PLIC 路由。 FGPIO 没有 GPIO 中断能力，按完整 SDK GPIO 示例的约束返回 NOT_SUPPORT。 Disable the current pin's GPIO event first; the shared PLIC route is disabled only after the last enabled pin on the same port is released. FGPIO has no GPIO interrupt capability and returns NOT_SUPPORT according to the full SDK GPIO sample constraint.

Implements LibXR::GPIO.

Definition at line 178 of file hpm_gpio.cpp.

{
  if (irq_ == INVALID_IRQ || port_ >= PORT_COUNT || pin_ >= PIN_COUNT)
  {
    return ErrorCode::ARG_ERR;
  }
  if (HPM_GPIO_IsFastController(gpio_))
  {
    return ErrorCode::NOT_SUPPORT;
  }
 
  HPMGPIOIrqRouteGuard guard;
  if (!interrupt_enabled_)
  {
    return ErrorCode::OK;
  }
 
  gpio_disable_pin_interrupt(gpio_, port_, pin_);
 
  PortIrqRouteState& route = port_irq_route_map[port_];
  if (route.enabled_pin_count == 0u)
  {
    route = {};
    interrupt_enabled_ = false;
    return ErrorCode::STATE_ERR;
  }
 
  if (route.controller != gpio_ || route.irq != irq_)
  {
    interrupt_enabled_ = false;
    return ErrorCode::STATE_ERR;
  }
 
  --route.enabled_pin_count;
  if (route.enabled_pin_count == 0u)
  {
    const uint32_t route_irq = route.irq;
    route = {};
    intc_m_disable_irq(route_irq);
  }
 
  interrupt_enabled_ = false;
  return ErrorCode::OK;
}

◆ EnableInterrupt()

ErrorCode HPMGPIO::EnableInterrupt ( )

overridevirtual

使能当前引脚中断 / Enable GPIO interrupt for current pin.

使能当前引脚中断 / Enable interrupt for current pin.

Returns: 成功返回 ErrorCode::OK；IRQ/端口参数无效返回 ErrorCode::ARG_ERR； HPM_FGPIO 返回 ErrorCode::NOT_SUPPORT；同 port 存在冲突 IRQ 路由返回 ErrorCode::STATE_ERR / Returns ErrorCode::OK on success, ErrorCode::ARG_ERR for invalid irq/port/pin, ErrorCode::NOT_SUPPORT for HPM_FGPIO, and ErrorCode::STATE_ERR when the same port is already routed to another IRQ.

Note: HPM SDK gpio_enable_pin_interrupt() 只设置 GPIO IE 位；PLIC 路由由 intc_m_enable_irq_with_priority() 打开，且同一 port 只在首个 pin enable 时调用 / HPM SDK gpio_enable_pin_interrupt() only sets the GPIO IE bit; PLIC routing is opened through intc_m_enable_irq_with_priority() only when the first pin on the same port is enabled.

对于共享同一 port IRQ 的多个 pin：

gpio_enable_pin_interrupt() 始终按 pin 开事件；
PLIC 路由只在该 port 首次进入“已使能”状态时打开一次。
FGPIO 没有 GPIO 中断能力，按完整 SDK GPIO 示例的约束返回 NOT_SUPPORT。 For multiple pins sharing one port IRQ:
gpio_enable_pin_interrupt() always operates per pin;
PLIC routing is enabled only once when the first pin on that port becomes active.
FGPIO has no GPIO interrupt capability and returns NOT_SUPPORT according to the full SDK GPIO sample constraint.

Implements LibXR::GPIO.

Definition at line 129 of file hpm_gpio.cpp.

{
  if (irq_ == INVALID_IRQ || port_ >= PORT_COUNT || pin_ >= PIN_COUNT)
  {
    return ErrorCode::ARG_ERR;
  }
  if (HPM_GPIO_IsFastController(gpio_))
  {
    return ErrorCode::NOT_SUPPORT;
  }
 
  HPMGPIOIrqRouteGuard guard;
  if (interrupt_enabled_)
  {
    return ErrorCode::OK;
  }
 
  PortIrqRouteState& route = port_irq_route_map[port_];
  const bool needs_port_irq_enable = (route.enabled_pin_count == 0u);
  if (!needs_port_irq_enable && (route.controller != gpio_ || route.irq != irq_))
  {
    return ErrorCode::STATE_ERR;
  }
 
  gpio_enable_pin_interrupt(gpio_, port_, pin_);
 
  if (needs_port_irq_enable)
  {
    route.controller = gpio_;
    route.irq = irq_;
    intc_m_enable_irq_with_priority(irq_, 1);
  }
 
  ++route.enabled_pin_count;
  interrupt_enabled_ = true;
  return ErrorCode::OK;
}

◆ Read()

bool LibXR::HPMGPIO::Read ( )

inlineoverridevirtual

读取引脚电平 / Read current pin level.

Returns: true 高电平，false 低电平 / true for high level, false for low level.

Implements LibXR::GPIO.

Definition at line 83 of file hpm_gpio.hpp.

  {
    const uint32_t level = gpio_read_pin(gpio_, port_, pin_);
    return level == 1u;
  }

◆ ResolvePadIndex()

uint16_t HPMGPIO::ResolvePadIndex	(	GPIO_Type *	gpio,
		uint32_t	port,
		uint8_t	pin )

staticprivate

根据控制器与端口引脚推导 IOC PAD 编号 / Resolve IOC PAD index from controller/port/pin tuple.

推导指定 GPIO 对应的 IOC PAD 编号 / Resolve IOC PAD index for a GPIO pin.

Parameters

gpio	GPIO 控制器基地址 / GPIO controller base address.
port	GPIO 端口号 / GPIO port index.
pin	GPIO 引脚号 / GPIO pin index.

Returns: 有效 PAD 编号，无法推导时返回 INVALID_PAD_INDEX / Resolved PAD index, or INVALID_PAD_INDEX if unavailable. 端口-引脚到对象实例的静态映射，用于中断分发 / Static port-pin to object map for interrupt dispatch.

Definition at line 430 of file hpm_gpio.cpp.

{
  if (gpio != HPM_GPIO0 && !HPM_GPIO_IsFastController(gpio))
  {
    return INVALID_PAD_INDEX;
  }
 
  switch (port)
  {
#if defined(GPIO_DI_GPIOA) && defined(IOC_PAD_PA00)
    case GPIO_DI_GPIOA:
      return static_cast<uint16_t>(IOC_PAD_PA00 + pin);
#endif
#if defined(GPIO_DI_GPIOB) && defined(IOC_PAD_PB00)
    case GPIO_DI_GPIOB:
      return static_cast<uint16_t>(IOC_PAD_PB00 + pin);
#endif
#if defined(GPIO_DI_GPIOX) && defined(IOC_PAD_PX00)
    case GPIO_DI_GPIOX:
      return pin < 8u ? static_cast<uint16_t>(IOC_PAD_PX00 + pin) : INVALID_PAD_INDEX;
#endif
#if defined(GPIO_DI_GPIOY) && defined(IOC_PAD_PY00)
    case GPIO_DI_GPIOY:
      return pin < 8u ? static_cast<uint16_t>(IOC_PAD_PY00 + pin) : INVALID_PAD_INDEX;
#endif
    default:
      return INVALID_PAD_INDEX;
  }
}

◆ SetAnalogHighImpedance()

ErrorCode HPMGPIO::SetAnalogHighImpedance ( )

将当前 PAD 配置为模拟高阻 / Configure current pad to analog high-impedance.

将引脚切换为模拟高阻 / Put current pin into analog high-impedance mode.

Returns: 成功返回 ErrorCode::OK；port/pin 无效返回 ErrorCode::ARG_ERR； PAD 不可解析返回 ErrorCode::NOT_SUPPORT / Returns ErrorCode::OK on success, ErrorCode::ARG_ERR for invalid port/pin, or ErrorCode::NOT_SUPPORT when PAD is unavailable.

Note: 该接口直接写 IOC FUNC_CTL 的 ANALOG 位并清除上下拉和开漏位，未上板前仍需用实际电气连接确认高阻效果 / This API writes the IOC FUNC_CTL ANALOG bit and clears pull/open-drain bits. The high-impedance effect still needs board-level electrical verification.; 如果当前 pin 已经通过 EnableInterrupt() 进入共享 port IRQ 路由，本接口会先走 DisableInterrupt() 维护引用计数；否则只清当前 pin 的 GPIO IE 位 / If the pin is already routed through EnableInterrupt(), this API first calls DisableInterrupt() to keep the shared port IRQ reference count consistent; otherwise it only clears the current pin's GPIO IE bit.

用途：

该引脚仅作为外部网络连接点，不希望其数字输入/上下拉影响外部 PWM 信号；
例如 PB10 外部跳线到 PA10 时，PA10 需保持高阻避免“分流”。 Usage:
Keep this pin from loading an externally driven signal (PWM/analog net);
Example: PB10 externally jumpered to PA10, PA10 should stay high-Z.

Definition at line 343 of file hpm_gpio.cpp.

{
  if (port_ >= PORT_COUNT || pin_ >= PIN_COUNT)
  {
    return ErrorCode::ARG_ERR;
  }
 
  if (pad_index_ == INVALID_PAD_INDEX)
  {
    return ErrorCode::NOT_SUPPORT;
  }
 
  if (interrupt_enabled_)
  {
    ErrorCode ans = DisableInterrupt();
    if (ans != ErrorCode::OK)
    {
      return ans;
    }
  }
  else
  {
    gpio_disable_pin_interrupt(gpio_, port_, pin_);
  }
 
  gpio_set_pin_input(gpio_, port_, pin_);
 
  HPM_IOC->PAD[pad_index_].FUNC_CTL = IOC_PAD_FUNC_CTL_ANALOG_MASK;
 
  uint32_t pad_ctl = HPM_IOC->PAD[pad_index_].PAD_CTL;
  pad_ctl &= ~(IOC_PAD_PAD_CTL_PE_MASK | IOC_PAD_PAD_CTL_OD_MASK);
  HPM_IOC->PAD[pad_index_].PAD_CTL = pad_ctl;
 
  return ErrorCode::OK;
}

◆ SetConfig()

ErrorCode HPMGPIO::SetConfig ( Configuration config )

overridevirtual

配置当前引脚模式 / Configure GPIO mode for current pin.

配置 GPIO 方向、中断模式与上下拉 / Configure GPIO direction, interrupt mode, and pull.

Parameters

config GPIO 配置参数 / GPIO configuration.

Returns: 成功返回 ErrorCode::OK；port/pin 或枚举值无效返回 ErrorCode::ARG_ERR； HPM_FGPIO 的中断方向或 SDK 未提供双沿枚举时返回 ErrorCode::NOT_SUPPORT / Returns ErrorCode::OK on success, ErrorCode::ARG_ERR for invalid port/pin or enum values, or ErrorCode::NOT_SUPPORT for interrupt directions on HPM_FGPIO or when the SDK does not provide the both-edge enum.

Note: 该接口会将 PAD 复用强制切换为 GPIO，不负责外设复用配置 / This API forces pad mux to GPIO function (no peripheral alternate-function setup).; 在可解析到 PAD 时会自动开启 IOC loopback，用于输出模式下直接通过 Read() 读取实际引脚电平 / When PAD can be resolved, IOC loopback is enabled so Read() can return the actual pad level even in output mode.

与 STM32 HAL 的常见用法对齐：

Direction 对应 GPIO 模式（输入/输出/中断边沿）
Pull 对应上拉/下拉配置 Aligned with common STM32 HAL usage:
Direction maps to GPIO mode (input/output/IRQ edge)
Pull maps to pull-up / pull-down configuration

Implements LibXR::GPIO.

Definition at line 234 of file hpm_gpio.cpp.

{
  if (port_ >= PORT_COUNT || pin_ >= PIN_COUNT)
  {
    return ErrorCode::ARG_ERR;
  }
 
  switch (config.pull)
  {
    case Pull::NONE:
    case Pull::UP:
    case Pull::DOWN:
      break;
    default:
      return ErrorCode::ARG_ERR;
  }
 
  const bool is_interrupt_direction =
      config.direction == Direction::FALL_INTERRUPT ||
      config.direction == Direction::RISING_INTERRUPT ||
      config.direction == Direction::FALL_RISING_INTERRUPT;
  if (is_interrupt_direction && HPM_GPIO_IsFastController(gpio_))
  {
    return ErrorCode::NOT_SUPPORT;
  }
  if (config.direction == Direction::FALL_RISING_INTERRUPT)
  {
#if !defined(GPIO_SOC_HAS_EDGE_BOTH_INTERRUPT) || (GPIO_SOC_HAS_EDGE_BOTH_INTERRUPT != 1)
    return ErrorCode::NOT_SUPPORT;
#endif
  }
 
  if (pad_index_ != INVALID_PAD_INDEX)
  {
    // 保持接口自洽：先确保 PAD 复用到 GPIO / Keep API self-contained: force GPIO mux
    // first.
    HPM_GPIO_ConfigMuxToGPIO(gpio_, port_, pad_index_);
  }
 
  switch (config.direction)
  {
    case Direction::INPUT:
      gpio_set_pin_input(gpio_, port_, pin_);
      break;
    case Direction::OUTPUT_PUSH_PULL:
    case Direction::OUTPUT_OPEN_DRAIN:
      gpio_set_pin_output(gpio_, port_, pin_);
      break;
    case Direction::FALL_INTERRUPT:
      gpio_set_pin_input(gpio_, port_, pin_);
      gpio_config_pin_interrupt(gpio_, port_, pin_, gpio_interrupt_trigger_edge_falling);
      break;
    case Direction::RISING_INTERRUPT:
      gpio_set_pin_input(gpio_, port_, pin_);
      gpio_config_pin_interrupt(gpio_, port_, pin_, gpio_interrupt_trigger_edge_rising);
      break;
    case Direction::FALL_RISING_INTERRUPT:
#if defined(GPIO_SOC_HAS_EDGE_BOTH_INTERRUPT) && (GPIO_SOC_HAS_EDGE_BOTH_INTERRUPT == 1)
      gpio_set_pin_input(gpio_, port_, pin_);
      gpio_config_pin_interrupt(gpio_, port_, pin_, gpio_interrupt_trigger_edge_both);
      break;
#else
      return ErrorCode::NOT_SUPPORT;
#endif
    default:
      return ErrorCode::ARG_ERR;
  }
 
  if (pad_index_ != INVALID_PAD_INDEX)
  {
    uint32_t pad_ctl = HPM_IOC->PAD[pad_index_].PAD_CTL;
 
    // 仅更新上下拉与开漏位，保留其他电气属性 / Update pull + open-drain bits only.
    pad_ctl &=
        ~(IOC_PAD_PAD_CTL_PE_MASK | IOC_PAD_PAD_CTL_PS_MASK | IOC_PAD_PAD_CTL_OD_MASK);
 
    switch (config.pull)
    {
      case Pull::NONE:
        break;
      case Pull::UP:
        pad_ctl |= IOC_PAD_PAD_CTL_PE_SET(1) | IOC_PAD_PAD_CTL_PS_SET(1);
        break;
      case Pull::DOWN:
        pad_ctl |= IOC_PAD_PAD_CTL_PE_SET(1) | IOC_PAD_PAD_CTL_PS_SET(0);
        break;
    }
 
    if (config.direction == Direction::OUTPUT_OPEN_DRAIN)
    {
      pad_ctl |= IOC_PAD_PAD_CTL_OD_SET(1);
    }
 
    HPM_IOC->PAD[pad_index_].PAD_CTL = pad_ctl;
  }
 
  return ErrorCode::OK;
}

◆ Write()

void LibXR::HPMGPIO::Write ( bool value )

inlineoverridevirtual

写引脚电平 / Write output pin level.

Parameters

value true 高电平，false 低电平 / true for high level, false for low level.

Implements LibXR::GPIO.

Definition at line 94 of file hpm_gpio.hpp.

  {
    gpio_write_pin(gpio_, port_, pin_, value ? 1u : 0u);
  }

Field Documentation

◆ gpio_

GPIO_Type* LibXR::HPMGPIO::gpio_

private

GPIO 控制器实例 / GPIO controller instance.

Definition at line 241 of file hpm_gpio.hpp.

◆ interrupt_enabled_

bool LibXR::HPMGPIO::interrupt_enabled_ = false

private

当前 pin IRQ 使能状态 / Per-instance IRQ enabled flag.

Definition at line 246 of file hpm_gpio.hpp.

◆ INVALID_IRQ

uint32_t LibXR::HPMGPIO::INVALID_IRQ = 0xFFFFFFFFu

staticconstexprprivate

无效 IRQ 标记 / Invalid IRQ marker.

Definition at line 206 of file hpm_gpio.hpp.

◆ INVALID_PAD_INDEX

uint16_t LibXR::HPMGPIO::INVALID_PAD_INDEX = 0xFFFFu

staticconstexprprivate

无效 PAD 标记 / Invalid PAD marker.

Definition at line 207 of file hpm_gpio.hpp.

◆ irq_

uint32_t LibXR::HPMGPIO::irq_

private

当前 port 对应 IRQ 号 / IRQ number for the current port.

Definition at line 244 of file hpm_gpio.hpp.

◆ map

HPMGPIO * HPMGPIO::map = {}

staticprivate

GPIO 对象映射表 / GPIO object dispatch map.

按端口和引脚保存对象指针，供中断入口快速找到具体实例并触发回调。 Stores instance pointers by port/pin so IRQ entry can dispatch callbacks quickly.

Definition at line 237 of file hpm_gpio.hpp.

◆ pad_index_

uint16_t LibXR::HPMGPIO::pad_index_

private

IOC PAD 编号 / IOC PAD index.

Definition at line 245 of file hpm_gpio.hpp.

◆ pin_

uint8_t LibXR::HPMGPIO::pin_

private

GPIO 引脚号 / GPIO pin index.

Definition at line 243 of file hpm_gpio.hpp.

◆ PIN_COUNT

uint32_t LibXR::HPMGPIO::PIN_COUNT = 32

staticconstexprprivate

每个端口引脚数 / Pins per port.

Definition at line 205 of file hpm_gpio.hpp.

◆ port_

uint32_t LibXR::HPMGPIO::port_

private

GPIO 端口号 / GPIO port index.

Definition at line 242 of file hpm_gpio.hpp.

◆ port_controller_map

GPIO_Type * HPMGPIO::port_controller_map = {}

staticprivate

Definition at line 238 of file hpm_gpio.hpp.

◆ PORT_COUNT

uint32_t LibXR::HPMGPIO::PORT_COUNT = 15u

staticconstexprprivate

支持的端口数量 / Supported port count.

Definition at line 203 of file hpm_gpio.hpp.

◆ port_irq_route_map

HPMGPIO::PortIrqRouteState HPMGPIO::port_irq_route_map = {}

staticprivate

Definition at line 239 of file hpm_gpio.hpp.

The documentation for this class was generated from the following files:

driver/hpm/hpm_gpio.hpp
driver/hpm/hpm_gpio.cpp

Data Structures

Public Member Functions

Static Public Member Functions

Static Private Member Functions

Private Attributes

Static Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ HPMGPIO()

Member Function Documentation

◆ CheckInterrupt()

◆ DisableInterrupt()

◆ EnableInterrupt()

◆ Read()

◆ ResolvePadIndex()

◆ SetAnalogHighImpedance()

◆ SetConfig()

◆ Write()

Field Documentation

◆ gpio_

◆ interrupt_enabled_

◆ INVALID_IRQ

◆ INVALID_PAD_INDEX

◆ irq_

◆ map

◆ pad_index_

◆ pin_

◆ PIN_COUNT

◆ port_

◆ port_controller_map

◆ PORT_COUNT

◆ port_irq_route_map