功能描述

本节描述 GPIO 的功能。

方向控制

每个 I/O 信号的方向通过对应的 Port X 数据方向寄存器 (GPIO_DDR) 进行配置。GPIO_DDR 中的每一位独立控制其对应信号的方向(输入或输出)。处理器可通过 APB 总线接口访问 GPIO_DDR 寄存器。

数据和控制流的架构如以下框图所示。

../../../_images/control_rtl_block_diagram.svg

在 GPIO_DDR 中,每一位均可单独控制,因此该寄存器实际上为宽度为 N 的 Port X GPIO 总线提供了 N 个独立的方向控制位(位索引范围为 0 到 N-1)。

对于 GPIO_DDR 中的每一位:

  • 写入 1 将对应的 I/O 信号配置为输出。

  • 写入 0 将对应的 I/O 信号配置为输入。

数据输出

当 GPIO 引脚被配置为输出时,写入 Port X 数据寄存器 (GPIO_DR) 的数据会按位直接驱动对应 I/O 信号的输出缓冲器。

基本数据输出

GPIO_DR 中的每一位控制一个输出信号:

  • 写入 1 将对应的 I/O 信号输出驱动为高电平。

  • 写入 0 将对应的 I/O 信号输出驱动为低电平。

竞态条件保护

RTL8721Dx:

不支持。

数据输入

通过 APB 总线读取 GPIO_EXT_PORT 寄存器可获取外部引脚的电平状态。无论引脚配置为输入或输出模式,该寄存器的读回值均为外部引脚实际电平对应的逻辑值。

备注

当 GPIO 配置为输出模式且 GPIO_DR 输出高电平(逻辑值 1)时,若外部引脚连接至低电平(如 GND),读取 GPIO_EXT_PORT 将返回 0,表明外部引脚实际处于低电平状态。

GPIO_EXT_PORT 寄存器是只读的,意味着无法通过 APB 软件接口对其进行写操作。

下图展示了当方向设置为输入且包含亚稳态寄存器时,读取 GPIO_EXT_PORT 内存映射寄存器的时序图,亚稳态寄存器会引入端口线的数据延迟。

../../../_images/read_back_of_external_i_o_data_timing.png

备注

从 GPIO_EXT_PORT 连续读取时能够读回的最大数据速率必须小于 PCLK/2。由于 APB 的非流水线特性,每次读访问需要两个 pclk 周期。前提假设是当 PCLK=HCLK 时,APB 桥在连续访问期间不会失去 AHB 的所有权。

直连 Pad 输入选择

RTL8721Dx:

不支持。

中断

GPIO 外设支持在任何 GPIO 引脚上配置可编程的中断源,中断类型可通过以下设置进行编程:

  • 边沿触发中断:上升沿、下降沿或双边沿

  • 电平触发中断:高电平有效或低电平有效

中断屏蔽通过 GPIO_INT_MASK 寄存器实现,同时提供屏蔽后 (GPIO_INT_STATUS) 和原始 (GPIO_INT_STATUS_RAW) 的中断状态信息。配置中断需要将 GPIO 端口的数据方向设置为 Input(输入)。将方向重新编程为 Output(输出)时,待处理的中断会保留,但不会产生新的中断。

下图展示了中断生成和数据流,包含两种可能的输出架构:

  • 独立中断模式:独立的信号(gpio_intr[N] 或 gpio_intr_n[N])

  • 组合中断模式:单一统一信号(gpio_intr_flag 或 gpio_intr_flag_n)

../../../_images/interrupt_rtl_block_diagram.png

中断 RTL 框图

在组合模式下,中断信号通过对所有独立中断线进行逻辑 OR 运算生成。本芯片采用组合中断架构。每个 GPIO 端口在系统中断控制器中拥有一个专用的 IRQ 编号。由于采用组合中断实现方式,中断服务程序 (ISR) 必须读取 GPIO_INT_STATUS 寄存器以确定是哪些 GPIO 引脚触发了中断。处理器通过软件负责中断优先级排序和处理。

中断同步

中断信号可以在内部同步到专用系统时钟 pclk_intr,同步要求由中断类型决定:

  • 边沿触发中断:必须同步到 pclk_intr。送到处理器的边沿触发中断信号保证与系统总线时钟同步。

  • 电平触发中断:同步到 pclk_intr 是可选的,可通过软件配置 GPIO_INT_LS_SYNC 寄存器来控制。

pclk_intr 信号在电源管理系统中起着关键作用。如果系统要求在 GPIO pclk 被关闭时仍具备中断检测能力,则必须提供 pclk_intr。通常假设 pclk_intr 与 pclk 同步运行。反之,如果仅在 pclk 运行时才需要检测中断,则可以将 pclk_intr 和 pclk 连接到同一个时钟源。

边沿触发中断

边沿触发中断通过向 GPIO_INT_EOI 寄存器写入来清除,该操作会同时清除中断状态寄存器和原始状态寄存器。建议在向 GPIO_INT_EOI 写入之前先清除中断源。此寄存器对电平触发中断无效。在组合中断配置中,可以同时清除多个边沿触发中断。

单边沿检测

下图展示了当 GPIO_INT_BOTHEDGE = 0 时,gpio_ext_portaN 信号上的中断源同步与边沿检测的 RTL 示意图。

../../../_images/synchronization_and_edge_detect_interrupt_generation_gpio_int_both_edge_0.png

同步与边沿检测中断生成 (GPIO_INT_BOTHEDGE=0)

备注

亚稳态部分默认包含在内。

图 GPIO 中断亚稳态 展示了一个在 Port A 输入上升沿产生中断的时序图;在该场景中,消抖逻辑被禁用,亚稳态寄存器被包含在内。该图还展示了通过写入中断清除寄存器来清除中断的方式。

../../../_images/interrupt_edge_detection_and_interrupt_clear_timing_gpio_sync_pa_interrupts_1_metastability_included.png

中断边沿检测与中断清除时序(GPIO_SYNC_PA_INTERRUPTS = 1,包含亚稳态寄存器)

ISR 可能在检测到新中断的同一时钟周期内写中断清除寄存器,以清除已有中断。此时只会清除第一个中断;同一周期内中断的置位优先于清除,因此新中断不会丢失。

图 GPIO 中断稳定 展示了一个与 图 GPIO 中断亚稳态 类似的时序图,不同之处在于亚稳态寄存器已被移除。该图还展示了通过写入中断清除寄存器来清除中断的方式。

备注

由于亚稳态寄存器已从路径中移除,图 GPIO 中断亚稳态 中所示的 A 和 B 波形不再存在,所有后续信号延迟减少两个时钟周期。

../../../_images/interrupt_edge_detection_and_interrupt_clear_timing_gpio_sync_pa_interrupts_0_metastability_removed.png

中断边沿检测与中断清除时序(GPIO_SYNC_PA_INTERRUPTS = 0,移除亚稳态寄存器)

下图展示了消抖逻辑未被使用的场景。在该时序图中,meta_out 和 edge_detect_out 分别是第二个亚稳态寄存器和边沿检测逻辑的输出。第二次边沿检测发生在写入中断清除寄存器的同一周期。在此示例中,写入中断清除寄存器不会清除第二个中断,gpio_intr{_n} 信号不会被撤销。

../../../_images/write_to_interrupt_clear_register_coincident_with_detection_of_new_interrupt.png

写入中断清除寄存器与新中断检测同时发生

双边沿检测

上升沿和下降沿的双边沿中断检测逻辑仅在 GPIO_INT_BOTHEDGE 寄存器被编程为 1 时才可用,此逻辑会同时检测上升沿和下降沿的中断。

下图展示了 gpio_ext_portaN 信号上中断源的同步和边沿检测中断生成。

../../../_images/synchronization_and_edge_detect_interrupt_generation_gpio_int_both_edge_1.png

同步和边沿检测中断生成 (GPIO_INT_BOTHEDGE = 1)

下图展示了一个时序图,其中在 Port A 输入的上升沿和下降沿均会产生中断,即 GPIO_INT_BOTHEDGE = 1 被编程为检测双边沿。

在此场景中,消抖 (debounce) 逻辑被禁用,并且包含亚稳态 (metastability) 寄存器。该图还展示了如何通过写中断清除寄存器来清除中断。

../../../_images/interrupt_edge_detection_and_interrupt_clear_timing_gpio_sync_pa_interrupts_1_and_gpio_int_both_edge_1_metastability_included.png

中断边沿检测和中断清除时序(GPIO_SYNC_PA_INTERRUPTS = 1 且 GPIO_INT_BOTHEDGE = 1,包含亚稳态寄存器)

下图展示了与图 interrupt_metastability_included 类似的时序图,不同之处在于此场景中移除了亚稳态寄存器。

../../../_images/interrupt_edge_detection_and_interrupt_clear_timing_gpio_sync_pa_interrupts_0_and_gpio_int_both_edge_1_metastability_removed.png

中断边沿检测和中断清除时序(GPIO_SYNC_PA_INTERRUPTS = 0 且 GPIO_INT_BOTHEDGE = 1,移除亚稳态寄存器)

电平触发中断

电平触发中断在中断源条件消除之前会反复触发,因此需要 ISR 正确处理:ISR 可以轮询 GPIO_INT_STATUS_RAW 寄存器直到中断源被清除,或者在退出前通过 GPIO_INT_MASK 寄存器屏蔽中断。

下图展示了电平触发中断的生成过程。同时,下面的消抖电路是消除宽度小于一个消抖时钟 (dbclk) 周期的虚假毛刺的示例。

../../../_images/level_sensitive_interrupt_rtl_diagram.png

电平触发中断 RTL 原理图

对于电平触发中断,可以选择将其同步到中断时钟 pclk_intr,或者完全采用组合逻辑(消抖电路除外)。

该选择通过编程 GPIO_INT_LS_SYNC(GPIO 电平触发同步)寄存器来完成。

这是一个内存映射位,它会插入两个由 pclk_intr 驱动的亚稳态寄存器,以将电平触发中断同步到 pclk_intr。

当 GPIO_INT_LS_SYNC 未置位时,无法保证中断线与 pclk_intr 同步。可能需要设置处理器状态寄存器以指示异步中断。当 GPIO_INT_LS_SYNC 置位时,pclk_intr 时钟必须存在,才能将中断传递到中断控制器模块。

当选择将电平触发中断同步到 pclk_intr 时,gpio_intrclk_en 输出信号会被置位。gpio_intrclk_en 信号可用于时钟生成模块来开启 pclk_intr。

备注

  • 在正常运行模式下,建议将 pclk_intr 同步到 pclk,以防止电路产生毛刺。

  • 在睡眠模式下,如果需要更快的唤醒速度,可以禁用此同步。

下图展示了禁用消抖电路时低电平有效电平触发中断的生成过程。

../../../_images/active_low_level_sensitive_interrupt_generation_timing.png

低电平有效电平触发中断生成时序图

消抖功能

如果用户配置了中断功能,可以通过 GPIO_DEBOUNCE 寄存器来配置 GPIO 是否包含消抖功能。外部信号可以进行消抖处理,以消除宽度小于一个消抖时钟 (dbclk) 周期的毛刺。

下图展示了消抖电路的 RTL 示意图。时序图显示了 gpio_ext_portxN 上的高电平有效输入信号。输入信号检测的极性由存储器映射信号 gpio_int_polarity 控制。对于下降沿或低电平有效的输入,输入信号会被反相,然后使用与上升沿或高电平有效中断相同的消抖逻辑。

../../../_images/debounce_rtl_diagram.png

消抖 RTL 示意图

  • dbclk_res_n 信号相对于消抖时钟 dbclk 异步有效、同步释放。

  • presetn 为系统复位信号,相对于 pclk 异步有效、同步释放;同步必须在组件外部完成。

  • 假设 pclk 和 dbclk 信号彼此异步。

当使用消抖时钟对输入中断信号进行消抖处理时,信号必须保持至少两个消抖时钟周期的有效状态,才能确保被正确锁存。任何小于消抖时钟周期的输入脉冲宽度都会被滤除。脉冲宽度在一到两个消抖时钟周期之间时,可能会也可能不会传播,具体取决于其与消抖时钟的相位关系。如果输入脉冲跨越消抖时钟的两个上升沿,则会被锁存;如果仅跨越一个上升沿,则不会被锁存。

下面的时序图展示了两种情况:输入信号被滤除,以及随后的输入信号被传播。如果 GPIO 支持消抖功能,则可以在软件控制下启用或禁用 Port A 上输入信号的消抖处理。

../../../_images/debounce_timing_with_asynchronous_reset_flip_flops.png

异步复位触发器消抖时序图

备注

  • 使用消抖电路会使中断延迟增加两个消抖时钟周期。

  • 消抖电路仅适用于异步复位触发器。

编程注意事项

  • 在启用 Portx 的中断之前,应完成对 GPIO 寄存器的中断能力、边沿触发或电平触发中断以及中断极性的配置,以防止中断控制器的中断线上出现毛刺。

    • 如果使用外部消抖功能来消除毛刺,在启用中断时可能会将非预期的中断引入中断控制器。

    • 为避免在重新配置中断触发模式时因消抖电路产生意外中断,建议在再次启用中断之前等待消抖时间。

  • 写入中断清除寄存器可清除边沿检测中断,但对电平触发中断没有影响。

  • 当读取因配置参数设置而不再存在的寄存器时,读回的值为 0。例如,如果 APB_DATA_WIDTH = 32 bits 且 GPIO_PWIDTH_A = 8,则高 24 位读回 0。