1. 课程导入

欢迎进入《RISC-V Linux驱动适配工程》。在开始写第一行驱动代码之前，我们需要先建立一张清晰的“地图”：这门课要解决什么问题、涉及哪些核心概念、知识之间如何衔接、以及最终要交付什么样的工程能力。RISC-V 不是又一个“换指令集的 ARM”，它带来的开放指令集、可扩展外设、多样化的 SoC 集成方式，使得 Linux 驱动适配工作既有通用规律，也有大量平台相关细节。本课程的目标，就是把这些细节组织成可复用的工程方法。

一、学习目标：从“能编译”到“能交付”

驱动适配的终点不是“内核能启动”，而是“设备在真实场景下稳定工作”。因此本课程设定四个递进目标：

• 理解架构差异：掌握 RISC-V 在中断控制器、时钟、电源域、设备树描述上与 ARM 的异同，能读懂 SoC 手册中的关键章节。
• 掌握驱动框架：熟悉 Linux 设备模型、platform 总线、设备树匹配、字符设备与 misc 设备、GPIO/I2C/SPI 子系统等通用框架。
• 具备适配能力：能针对具体 RISC-V 开发板，完成从设备树编写、驱动移植、编译配置到上板验证的完整闭环。
• 形成排障方法：能通过 dmesg、sysfs、debugfs、示波器与逻辑分析仪定位“驱动加载失败、时序错误、中断丢失”等典型问题。

二、核心概念：五个必须打牢的支点

本课程反复围绕五个概念展开，它们贯穿所有章节：

1. 设备树（Device Tree）：RISC-V 平台普遍使用设备树描述硬件，驱动与硬件的“契约”就写在 .dts/.dtsi 中。compatible 字符串、reg、interrupts、clocks、pinctrl 是高频字段。
2. platform 总线与驱动匹配：大多数 SoC 内建外设走 platform 总线，匹配依赖 of_match_table。理解 probe 的触发时机，是调试“驱动不加载”的第一把钥匙。
3. 中断与时钟：RISC-V 使用 PLIC/CLINT 或 APLIC/IMSIC，中断号与触发方式必须与设备树一致；时钟频率错误会导致 I2C/SPI 通信失败。
4. 内核配置与编译：Kconfig、defconfig、模块与内建的区别，直接决定驱动是否被编入内核或生成 .ko。
5. 用户态接口：sysfs、debugfs、/dev 节点、ioctl 是验证驱动行为的手段，也是驱动与应用的边界。

三、整体知识框架：一张图看清课程脉络

下图给出本课程的知识框架与实战路线：从硬件描述出发，经过驱动框架与编译配置，最终到达上板验证与排障。它不是简单的章节列表，而是数据与控制的流动关系。

四、实战路线图：七步闭环

课程后续章节将沿着下面这条路线逐步展开，每一步都有明确的输入、输出和验证标准：

五、典型场景：一个 GPIO 驱动适配的缩影

假设我们要在一块 RISC-V 开发板上点亮一个 LED。看似简单，却完整覆盖了本课程的核心链路：

# 1. 设备树中描述 LED
leds {
    compatible = "gpio-leds";
    led0 {
        gpios = <&gpio0 12 GPIO_ACTIVE_HIGH>;
        label = "sys-led";
        default-state = "off";
    };
};

# 2. 内核配置
CONFIG_LEDS_GPIO=y
CONFIG_GPIOLIB=y

# 3. 上板验证
echo 1 > /sys/class/leds/sys-led/brightness
cat /sys/class/leds/sys-led/brightness

如果 LED 不亮，排查顺序通常是：设备树 gpio 引脚是否与原理图一致 → pinctrl 是否配置为 GPIO 功能 → gpio 控制器驱动是否 probe 成功 → 引脚是否被其他驱动占用。这个顺序，正是后续排障章节要训练的判断路径。

六、常见误区与复盘

• 误区一：把设备树当成“配置文件”随便改。设备树描述的是硬件事实，改错会导致驱动匹配到错误资源，甚至影响其他外设。每次修改都应回到原理图和手册核对。
• 误区二：probe 成功就认为驱动没问题。probe 只说明资源申请成功，不代表时序、中断、数据通路正确。必须做功能验证。
• 误区三：忽略 RISC-V 平台差异。中断控制器、时钟树、缓存一致性在不同 RISC-V SoC 上差异很大，不能直接照搬 ARM 经验。
• 误区四：不做版本管理。驱动适配往往需要反复试错，没有 git 分支和补丁管理，很快会陷入“改乱了回不去”的状态。