4. 外设驱动模拟：GPIO、UART、定时器

外设模拟，是 Renode 里最见真功夫的地方。

你写了个驱动，在真实板子上跑得挺好，一换到模拟环境就卡住。为什么？多半是外设模拟没配好。我刚开始用 Renode 时也踩过这个坑——GPIO 中断死活不触发，查了两天才发现是寄存器地址写错了。

这一章，咱们把 GPIO、UART、定时器这三个最常用的外设模拟讲透。你跟着走一遍，后面做多核调试心里就有底了。

4.1 GPIO 驱动模拟

GPIO 模拟的核心就两件事：寄存器映射和中断触发。

4.1.1 基础 GPIO 模型配置

先看一个最简单的 GPIO 控制器 .repl 文件怎么写。我习惯把外设模型拆成独立文件，方便复用。

gpio: GPIO.STMP32F4_GPIOPort @ gpioPorts 0x40020000 {
    id = 0;
    mode = 0x00000000;
    outputData = 0x00000000;
    inputData = 0x00000000;
    interruptEnable = 0x00000000;
    interruptPending = 0x00000000;
}

这里每个寄存器偏移量是固定的。Renode 会根据 .repl 里的地址自动计算偏移。我个人习惯把寄存器定义和初始化值写在一起，这样一眼就能看出复位状态。

4.1.2 中断触发模拟

GPIO 中断模拟是容易出问题的地方。我记得有一次，驱动里配了上升沿触发，但模拟时怎么都进不了中断服务函数。

后来发现，Renode 的 GPIO 模型默认只支持电平触发，边沿触发需要额外配置。解决办法是在 .repl 里显式声明中断类型：

gpio: GPIO.STMP32F4_GPIOPort @ gpioPorts 0x40020000 {
    // ... 其他配置
    irq -> cpu@0 { 
        type = RisingEdge;  // 显式指定上升沿触发
    };
}

4.2 UART 驱动模拟

UART 模拟，说白了就是让 Renode 把串口数据流重定向到主机终端或文件。你想想看，嵌入式开发里最常用的调试手段就是串口打印。如果串口模拟不对，你连 printf 都看不到。

4.2.1 终端重定向

最常用的方式是把 UART 输出重定向到主机终端。这样你在开发机上就能直接看到嵌入式设备的打印信息。

uart: UART.STMP32F4_USART @ uartPorts 0x40011000 {
    // 重定向到主机终端
    -> terminal @ "/dev/pts/4" {
        baudRate = 115200;
        dataBits = 8;
        stopBits = 1;
        parity = None;
    };
}

这里有个坑：baudRate 在 Renode 模拟里其实不影响数据传输速度，但驱动初始化时会检查这个值。我建议你保持和真实硬件一致，避免驱动在波特率校验时卡住。

4.2.2 回环测试模式

做 UART 驱动调试时，我经常先用回环模式验证基本功能。Renode 支持内部回环，不需要外部连线：

uart: UART.STMP32F4_USART @ uartPorts 0x40011000 {
    loopback = true;  // 开启内部回环
    -> terminal @ "/dev/pts/4";
}

4.2.3 多 UART 通道模拟

实际项目中往往有多个 UART 接口。比如一个接调试串口，一个接蓝牙模块，一个接传感器。Renode 里可以这样配：

UART 实例	用途	重定向目标	波特率
USART1	调试输出	主机终端 /dev/pts/4	115200
USART2	蓝牙通信	虚拟蓝牙设备	9600
USART3	传感器数据	文件 /tmp/sensor.log	57600

每个 UART 可以独立配置重定向目标。我曾经在一个项目里同时接了 5 个 UART 设备，Renode 跑起来一点问题没有。

4.3 定时器驱动模拟

定时器模拟，是外设模拟里最考验时序精度的。为什么？因为定时器直接关系到系统调度、PWM 生成、延时函数这些时间敏感操作。

4.3.1 基本定时器模型

一个典型的定时器模型包含预分频器、计数器、自动重装载寄存器和中断控制。Renode 里这样配：

timer: Timer.STMP32F4_Timer @ timerPorts 0x40000400 {
    prescaler = 0x00000000;
    counter = 0x00000000;
    autoReload = 0x0000FFFF;
    interruptEnable = 0x00000000;
    interruptPending = 0x00000000;
    clockFrequency = 84000000;  // 84 MHz 系统时钟
}

这里 clockFrequency 是关键参数。Renode 用它来计算定时器的实际溢出时间。如果这个值和真实硬件不一致，你的延时函数就会不准。

4.3.2 时序精度问题

我记得有一次，客户反馈说产品上的 LED 闪烁频率不对。我查了半天，最后发现是 Renode 模拟时定时器时钟频率配错了。

真实硬件上，定时器时钟来自 APB 总线，APB 时钟又是系统时钟分频得到的。但在 Renode 模拟里，如果你不显式配置时钟树，定时器会直接用默认频率。这就导致了时序偏差。

4.3.3 多定时器同步

有些场景需要多个定时器同步工作，比如电机控制里的 PWM 生成。Renode 支持定时器同步，但需要手动配置同步关系：

timer1: Timer.STMP32F4_Timer @ timerPorts 0x40000400 {
    // ... 基本配置
    syncMaster = true;  // 作为同步主设备
}

timer2: Timer.STMP32F4_Timer @ timerPorts 0x40000800 {
    // ... 基本配置
    syncSlave = true;   // 作为同步从设备
    syncSource = timer1; // 同步源是 timer1
}

这样配置后，timer2 的计数器会跟随 timer1 的更新事件同步复位。我在做多轴电机控制模拟时用过这个功能，效果还不错。

4.4 外设模拟知识体系

下面这张图总结了 GPIO、UART、定时器模拟的核心要点和它们之间的关系：

4.5 实战：组合外设调试

最后，咱们看一个实际场景：用 GPIO 控制 LED，用定时器产生 PWM，用 UART 打印占空比信息。

这个场景在真实项目中很常见。比如你要调试一个呼吸灯效果，需要同时操作 GPIO、定时器和 UART。在 Renode 里，你可以这样组合：

// 组合外设配置示例
led_gpio: GPIO.STMP32F4_GPIOPort @ gpioPorts 0x40020000 {
    id = 0;
    mode = 0x00000001;  // 输出模式
    outputData = 0x00000000;
}

pwm_timer: Timer.STMP32F4_Timer @ timerPorts 0x40000400 {
    prescaler = 83;      // 1 MHz 定时器时钟
    autoReload = 999;    // 1 kHz PWM 频率
    clockFrequency = 84000000;
}

debug_uart: UART.STMP32F4_USART @ uartPorts 0x40011000 {
    -> terminal @ "/dev/pts/4";
    baudRate = 115200;
}

配置好之后，在驱动代码里操作这些外设，Renode 会按照你定义的时序模拟运行。你可以用 monitor 命令实时查看寄存器状态，也可以用 logLevel -1 打开详细日志，看每个外设的读写操作。

外设模拟这块，说白了就是「配好参数、验证时序、反复调试」。你多做几个项目，自然就熟练了。