3、RK3588硬件平台详解：处理器架构、内存映射、GPIO/中断/时钟等外设资源分布

RK3588作为瑞芯微旗舰级SoC，采用8nm制程，集成了四核Cortex-A76与四核Cortex-A55的big.LITTLE架构，并内置独立的NPU（6 TOPS算力）、GPU（Mali-G610 MP4）以及强大的多媒体编解码单元。对于驱动开发者而言，理解其处理器架构、内存映射规则以及GPIO/中断/时钟等基础资源的分布，是编写可靠外设驱动的第一道门槛。本章将从硬件视角出发，结合数据手册与实战经验，系统拆解RK3588的硬件资源布局，并给出驱动开发中常用的判断方法与操作流程。

上图展示了RK3588的核心资源拓扑与地址映射关系。驱动开发中，我们最常打交道的三个基础资源——GPIO、中断、时钟——分别对应芯片内部的IOMUX/GRF（通用寄存器文件）、GIC（通用中断控制器）和CRU（时钟/复位单元）。下面逐一深入解析。

3.1 处理器架构与内存映射

RK3588采用异构多核架构，CPU侧通过DSU（DynamIQ共享单元）连接两个Cortex-A76簇和两个Cortex-A55簇，共享L3缓存。内存子系统支持LPDDR4/4X/5，最高频率可达4266MT/s。从驱动视角看，最重要的内存映射规则如下：

• DDR区域：起始地址0x0000_0000，大小由实际物理内存决定（常见2GB/4GB/8GB）。驱动通过DMA API访问时，需注意一致性映射与流式映射的区别。
• 外设I/O区域：起始地址0xF000_0000，包含所有外设控制器寄存器。例如UART2的寄存器基址为0xFEB50000，I2C0为0xFEB00000。
• 系统控制区域：0xFD00_0000~0xFEFF_FFFF，包含CRU、GRF、PMU等系统级控制单元。其中GRF（General Register File）负责GPIO复用和上下拉配置。
• 安全/非安全映射：ARM TrustZone架构下，部分寄存器（如安全OTP、安全定时器）仅允许在安全世界访问。普通Linux驱动无法直接操作，需通过OP-TEE或ATF提供的服务接口。

uart2: serial@feb50000 {
    compatible = "rockchip,rk3588-uart";
    reg = <0x0 0xfeb50000 0x0 0x100>;
    interrupts = <GIC_SPI 115 IRQ_TYPE_LEVEL_HIGH>;
    clocks = <&cru SCLK_UART2>, <&cru PCLK_UART2>;
    clock-names = "baudclk", "apb_pclk";
    status = "disabled";
};

3.2 GPIO资源分布与操作流程

RK3588提供5组GPIO（GPIO0~GPIO4），每组最多32个引脚，总计最多160个GPIO。但实际可用数量受封装和复用限制。每个GPIO引脚支持多种复用功能（如UART、I2C、SPI、PWM等），通过IOMUX寄存器选择。

GPIO操作标准流程：

1. 查看原理图：确认引脚编号（如GPIO3_C5），换算成bank/group/pin：bank=3, group=C(即2), pin=5。
2. 配置IOMUX：通过GRF寄存器将引脚复用为GPIO功能。例如GPIO3_C5的IOMUX寄存器偏移为0x0008，写入对应值。
3. 设置方向：通过GPIO_SWPORT_DR_L/H寄存器配置输入/输出。
4. 读写数据：输出时写GPIO_SWPORT_DR，输入时读GPIO_EXT_PORT。
5. 配置中断（如需）：设置GPIO_INT_EN、GPIO_INT_TYPE、GPIO_INT_BOTHEDGE等寄存器。

led-gpios = <&gpio3 RK_PC5 GPIO_ACTIVE_HIGH>;

3.3 中断资源与GIC配置

RK3588使用ARM GIC-400中断控制器，支持三种中断类型：SGI（软件触发中断，用于CPU间通信）、PPI（私有外设中断，如每个CPU的定时器）、SPI（共享外设中断，所有外设中断源）。

中断号计算规则：设备树中interrupts = <GIC_SPI 115 IRQ_TYPE_LEVEL_HIGH>表示SPI中断号115。在Linux内核中，实际IRQ号 = 32 + 115 = 147（因为前32个IRQ号分配给SGI和PPI）。驱动中无需手动计算，使用platform_get_irq()自动获取。

中断调试方法：

• 查看/proc/interrupts确认中断是否注册成功及触发次数。
• 使用cat /proc/irq/147/spurious检查是否有意外中断。
• 在设备树中设置wakeup-source属性，使能中断唤醒功能。

3.4 时钟资源与CRU操作

CRU（Clock and Reset Unit）是RK3588的时钟/复位管理中心。系统以24MHz晶振为基准，通过多个PLL（锁相环）生成不同频率的时钟源，再经过分频、门控、复用等逻辑分配给各外设。

时钟操作流程：

1. 在设备树中声明clocks和clock-names属性。
2. 驱动中通过devm_clk_get()获取时钟句柄。
3. 调用clk_prepare_enable()使能时钟。
4. 使用clk_set_rate()调整频率（需确认外设支持范围）。
5. 释放时调用clk_disable_unprepare()。

struct clk *pclk = devm_clk_get(&pdev->dev, "apb_pclk");
if (IS_ERR(pclk)) {
    dev_err(&pdev->dev, "failed to get apb_pclk\n");
    return PTR_ERR(pclk);
}
ret = clk_prepare_enable(pclk);
if (ret) {
    dev_err(&pdev->dev, "failed to enable apb_pclk\n");
    return ret;
}

3.5 常见误区与总结复盘

在RK3588驱动开发中，以下问题出现频率最高：

• GPIO编号混淆：设备树中&gpio3 RK_PC5与直接使用数字编号（如113）不一致。建议始终使用宏定义RK_PC5，避免手动计算。
• 中断触发类型不匹配：硬件实际为低电平触发，设备树却配置为上升沿触发，导致中断丢失或反复触发。务必对照原理图确认。
• 时钟未使能导致外设无响应：这是最常见的问题。外设寄存器读回全为0xFFFFFFFF或总线错误，多半是时钟门控未打开。
• ioremap后未使用readl/writel：直接解引用指针访问寄存器，在ARM架构下可能因缓存一致性导致数据异常。必须使用readl_relaxed()/writel_relaxed()系列函数。