罗罗编程学习记录 全栈面试题库
本页导航 展开查看

14.3.4 HAL、BSP 与设备树

所属:全栈开发面试题库 / 14 物联网与嵌入式软件 / 14.3 外设与中断驱动

本节要解决的问题

面试里写"移植驱动",多数人只记得改寄存器,一到板子上就遇到:换 MCU 时业务代码全改、Linux 驱动里 #ifdef 各种板子、设备树节点找不到、BSP 层和 HAL 层职责混乱。本节解决四个具体问题:一是 HAL、BSP、驱动、业务四层的职责边界,为什么不能在业务里直接写寄存器;二是 STM32 HAL 库、LL 库、寄存器层的取舍;三是 Linux 设备树(DTB)怎么描述硬件,platform driver 怎么匹配;四是板级支持包(BSP)的组织方式,怎么做到同一份业务代码跑在不同板子上。

学习目标

学完本节,你应当能够:

  • 说清 HAL、BSP、驱动、业务四层的职责边界,并画出依赖方向。
  • 在 STM32 HAL、LL、寄存器层之间选择,并说明各自代价。
  • 写出一个简单的设备树节点,并解释 compatible、reg、interrupts、clocks 的含义。
  • 说明 platform driver 的 probe/remove 流程,以及 driver 与 device 怎么匹配。

先修与前置

知识地图

软件分层(依赖方向从上到下)
  业务层(Application)    ── 协议、状态机、上报
  ──↑
  驱动层(Driver)         ── 传感器/Flash/显示屏的设备驱动
  ──↑
  BSP 层(Board Support)  ── 引脚映射、时钟配置、外设实例绑定
  ──↑
  HAL 层(Hardware Abstraction) ── 厂商提供的外设寄存器封装
  ──↑
  硬件(Hardware)         ── MCU/外设

Linux 设备模型
  设备树(DTS/DTB)  ── 描述硬件(地址、中断、时钟、引脚)
       ↓
  platform bus     ── 按 compatible 匹配 driver
       ↓
  platform driver  ── probe() 初始化设备
       ↓
  设备驱动         ── i2c_driver / spi_driver / miscdevice

核心术语

  • HAL(Hardware Abstraction Layer):厂商提供的外设寄存器封装库,如 STM32 HAL、ESP-IDF。
  • BSP(Board Support Package):板级支持包,描述具体板子的引脚、时钟、外设连接。
  • LL 库(Low-Layer):HAL 之下的轻量寄存器封装,内联函数,性能高。
  • 设备树(Device Tree):Linux 用数据结构描述硬件,DTS 源文件编译为 DTB。
  • compatible:设备树节点中的字符串,driver 用它匹配设备。
  • platform bus:Linux 虚拟总线,连接设备树节点和 platform driver。
  • probe():driver 匹配设备后调用的初始化函数。
  • 引脚复用(Pin Mux):一个引脚可配为 GPIO 或某外设功能,由 BSP 配置。

覆盖范围

  • HAL/BSP/驱动/业务四层职责与依赖方向
  • STM32 HAL、LL、寄存器层的取舍与性能差异
  • 时钟树(RCC)配置与外设时钟使能
  • Linux 设备树语法:node、reg、interrupts、clocks、pinctrl
  • platform driver 匹配与 probe/remove
  • pinctrl 子系统:引脚复用与上下拉
  • 设备树 overlay:同一内核适配多板
  • BSP 与业务代码解耦的设计模式

高频题速览

编号 题目 难度 频率
14.3.4-001 HAL、BSP、驱动、业务四层怎么分? 基础 ★★★★★
14.3.4-002 STM32 HAL 库和 LL 库有什么区别?怎么选? 基础 ★★★★
14.3.4-003 为什么业务代码不能直接写寄存器? 基础 ★★★★
14.3.4-004 设备树 compatible 怎么匹配 driver? 进阶 ★★★★
14.3.4-005 设备树的 reg、interrupts、clocks 是什么含义? 进阶 ★★★★
14.3.4-006 pinctrl 子系统解决什么问题? 进阶 ★★★
14.3.4-007 时钟树(RCC)配置为什么容易错? 进阶 ★★★
14.3.4-008 设备树 overlay 是什么?解决什么问题? 高级 ★★★
14.3.4-009 platform driver 的 probe 流程? 进阶 ★★★★
14.3.4-010 怎么做到一份业务代码跑多块板子? 高级 ★★★★

14.3.4-001 HAL、BSP、驱动、业务四层怎么分?

一句话结论

HAL 封装外设寄存器(厂商提供,不变),BSP 描述板级连接(引脚、时钟、外设实例),驱动把 BSP 资源包装成设备操作接口,业务调用驱动接口;依赖方向只能从上到下,业务不能直接访问寄存器,HAL 不能包含业务。

概念解释

  • HAL:HAL_UART_Transmit 这类函数,封装寄存器位操作,厂商提供。
  • BSP:bsp_uart_init() 里配置 PA9/PA10、时钟使能、绑定 USART1,与具体板子相关。
  • 驱动:sensor_read_temp() 这类函数,调用 BSP 的 USP/I2C 接口,操作传感器。
  • 业务:协议解析、上报、状态机,调用驱动接口。

原理流程

  1. 换 MCU:只改 HAL(换厂商库),BSP 和驱动不动。
  2. 换板子(同 MCU):只改 BSP(引脚映射),驱动和业务不动。
  3. 换传感器:只改驱动(新驱动),业务不动。
  4. 换业务逻辑:只改业务,驱动和 BSP 不动。
  5. 层间用接口(函数指针/ops 结构体)解耦。

代码或图示

/* HAL 层(厂商提供) */
int HAL_UART_Transmit(UART_HandleTypeDef *h, uint8_t *data, int len, int timeout);

/* BSP 层(板级) */
UART_HandleTypeDef huart1;
void bsp_uart_init(void)
{
    huart1.Instance = USART1;
    huart1.Init.BaudRate = 115200;
    /* 引脚 PA9/PA10、时钟使能由 BSP 配置 */
    HAL_UART_Init(&huart1);
}

/* 驱动层(传感器) */
int sensor_read_temp(float *out)
{
    uint8_t reg[2] = {0x00, 0x01};
    return HAL_I2C_Mem_Read(&hi2c1, 0x48, 0x00, 1, reg, 2, 100);
}

/* 业务层 */
void app_report(void)
{
    float t;
    sensor_read_temp(&t);
    mqtt_publish("temp", t);
}

常见误区

  • 误区:业务里直接调 HAL_UART_Transmit;正解:业务应通过驱动接口,驱动再调 BSP/HAL。
  • 误区:BSP 就是 HAL;正解:BSP 描述板子连接,HAL 是寄存器封装,两者不同。
  • 误区:四层是强制的;正解:小项目可合并,但职责边界要清晰。

追问

  • 为什么依赖方向不能反过来?答:如果 HAL 调用业务,换业务就要重编 HAL;如果业务直接写寄存器,换 MCU 全改。机制上分层是为了隔离变化点。边界在于:某些底层优化(如 ISR 直接操作寄存器)可能破环分层,但要有明确注释。延伸:这就是依赖反转原则(DIP)的嵌入式版。
  • 驱动接口怎么设计?答:用 ops 结构体,如 struct sensor_ops { int (*read)(void *ctx, float *out); int (*init)(void); },业务持 ops 指针。机制上函数指针解耦具体设备。边界在于:小项目直接函数调用更简单。延伸:这就是 Linux file_operations 的设计思路。
  • BSP 层包含什么?答:引脚映射、时钟使能、外设实例绑定、中断优先级、外部电源控制。机制上 BSP 是"这板子怎么连"的唯一描述。边界在于:设备树是 BSP 的声明式实现。延伸:这就是为什么换板子只改 BSP。

14.3.4-002 STM32 HAL 库和 LL 库有什么区别?怎么选?

一句话结论

HAL 是高层封装,函数多、检查多、可移植但慢;LL 是轻量内联函数,直接操作寄存器,性能高但可移植性差;性能敏感(ISR、时序)用 LL,业务逻辑用 HAL。

概念解释

  • HAL:HAL_UART_Transmit,带超时、错误检查、状态机,函数调用开销大。
  • LL:LL_USART_TransmitData8,内联函数,直接写寄存器,开销小。
  • 可移植性:HAL 跨 STM32 系列一致,LL 按寄存器差异。
  • 代码体积:LL 代码体积小,HAL 大。

原理流程

  1. 性能敏感路径(ISR、PWM、SPI 时序):用 LL,直接寄存器。
  2. 业务初始化(UART 配置、I2C 读写):用 HAL,开发快。
  3. 混合使用:HAL 初始化,LL 数据传输。
  4. 代码体积受限:优先 LL。
  5. 调试方便:HAL 错误码更友好。

代码或图示

/* HAL:慢但方便 */
HAL_UART_Transmit(&huart1, data, len, 100);

/* LL:快但直接 */
static inline void LL_uart_putc(uint8_t c)
{
    while (!LL_USART_IsActiveFlag_TXE(USART1));
    LL_USART_TransmitData8(USART1, c);
}

常见误区

  • 误区:HAL 一定慢;正解:HAL 的初始化路径慢,但 DMA 模式下数据路径不经过 HAL,性能相同。
  • 误区:LL 可移植;正解:LL 直接操作寄存器,换系列要改。
  • 误区:混合用会冲突;正解:HAL 和 LL 操作同一外设要注意状态机,不能同时调用。

追问

  • HAL 的开销在哪?答:函数调用、参数检查、超时计数、错误状态维护。机制上 HAL 每个函数都检查句柄状态。边界在于:DMA 传输时数据路径在 DMA 控制器,CPU 不经过 HAL。延伸:这就是为什么高吞吐用 DMA + HAL。
  • 为什么不直接写寄存器?答:直接写寄存器代码短、性能高,但可读性差、易出错、换芯片要全改。机制上寄存器位操作易错。边界在于:关键时序路径可以直接写寄存器,加注释。延伸:LL 是折中。
  • ESP-IDF 是什么层次?答:ESP-IDF 是乐鑫的开发框架,包含 HAL、BSP、驱动、RTOS 集成,比 STM32 HAL 更完整。机制上它把 Wi-Fi/BLE/网络都封装好。边界在于:ESP-IDF 锁定乐鑫芯片。延伸:这就是不同厂商框架的差异。

14.3.4-003 为什么业务代码不能直接写寄存器?

一句话结论

业务直接写寄存器会导致换 MCU、换板子时全改,且寄存器位操作易错、不可读;通过 BSP/HAL 接口隔离,硬件变化只影响底层,业务代码稳定。

概念解释

  • 可移植性:业务不变,硬件变化只改底层。
  • 可读性:业务代码读语义化函数,不读寄存器位。
  • 可测试性:业务可 mock 驱动接口测试。
  • 可维护性:寄存器变化集中在底层。

原理流程

  1. 业务需要 UART 发送:调 uart_send(data, len),不写寄存器。
  2. BSP/HAL 实现 uart_send,操作寄存器。
  3. 换 MCU:只改 uart_send 实现。
  4. 业务代码不变。
  5. 接口定义稳定,业务不关心硬件。

代码或图示

/* 错误:业务直接写寄存器 */
void app_bad(void)
{
    USART1->DR = 'A';           /* 业务耦合硬件 */
    while (!(USART1->SR & USART_SR_TXE));
}

/* 正确:业务调接口 */
void app_good(void)
{
    uart_send((uint8_t*)"A", 1);
}

常见误区

  • 误区:小项目直接写寄存器快;正解:即使小项目,直接写寄存器也难调试、难移植。
  • 误区:寄存器操作很快;正解:可读性差导致 bug,调试时间远多于节省的开发时间。
  • 误区:接口层有开销;正解:函数调用开销可忽略,DMA 路径不经过 CPU。

追问

  • 性能敏感路径怎么办?答:用 LL 或直接寄存器,但封装在驱动层,业务不感知。机制上驱动内部用 LL,对外暴露语义接口。边界在于:ISR 里用 LL 是合理的。延伸:这就是分层的价值。
  • 怎么 mock 驱动接口?答:定义 ops 结构体,测试时注入 mock ops。机制上函数指针解耦。边界在于:嵌入式 mock 比 PC 难(要跑在硬件上)。延伸:单元测试用 host 编译。
  • 寄存器位操作为什么易错?答:位掩码、移位、读改写都容易错,如 USART1->CR1 |= 0x20 不如 LL_USART_Enable(USART1) 可读。机制上寄存器位编号易记错。边界在于:厂商头文件(如 stm32f4xx.h)定义了位宏,减少错误。延伸:LL 库就是把这些宏函数化。

14.3.4-004 设备树 compatible 怎么匹配 driver?

一句话结论

设备树节点里的 compatible 字符串是 driver 的匹配 ID,内核启动时 platform bus 遍历设备树节点,用 of_match_table 里的字符串与节点 compatible 比较,匹配成功则调用 driver 的 probe。

概念解释

  • compatible:设备树节点中的字符串,如 "st,stm32-uart",格式 厂商,设备名。
  • of_match_table:driver 定义的匹配表,列出支持的 compatible 字符串。
  • platform bus:虚拟总线,负责匹配设备和 driver。
  • probe:匹配成功后调用的初始化函数。

原理流程

  1. 设备树节点:uart1: serial@40011000 { compatible = "st,stm32-uart"; reg = <0x40011000 0x40>; }
  2. driver 定义:static const struct of_device_id stm32_uart_of_match[] = { { .compatible = "st,stm32-uart" }, {} };
  3. 内核启动,platform bus 遍历设备树,找 compatible 匹配。
  4. 匹配成功,调用 stm32_uart_driver.probe(&pdev)。
  5. probe 里初始化硬件、注册字符设备。

代码或图示

/* driver */
static const struct of_device_id stm32_uart_of_match[] = {
    { .compatible = "st,stm32f4-uart" },
    { .compatible = "st,stm32h7-uart" },
    { /* sentinel */ }
};
MODULE_DEVICE_TABLE(of, stm32_uart_of_match);

static struct platform_driver stm32_uart_driver = {
    .probe = stm32_uart_probe,
    .driver = {
        .name = "stm32-uart",
        .of_match_table = stm32_uart_of_match,
    },
};
module_platform_driver(stm32_uart_driver);
/* 设备树 */
uart1: serial@40011000 {
    compatible = "st,stm32f4-uart";
    reg = <0x40011000 0x40>;
    interrupts = <37 0>;
    clocks = <&rcc 0>;
};

常见误区

  • 误区:compatible 随便写;正解:它是 driver 匹配 ID,写错则 probe 不调用。
  • 误区:compatible 只匹配一个;正解:of_match_table 可列多个,一个 driver 适配多版硬件。
  • 误区:设备树是必须的;正解:简单 MCU 裸机不用设备树,Linux 用。

追问

  • compatible 命名规范?答:厂商,设备名,如 "st,stm32-uart",厂商是厂商缩写,设备名是设备类型。机制上内核用字符串匹配。边界在于:同一硬件可列多个 compatible(兼容旧版)。延伸:这就是为什么设备树里 compatible 常有多个字符串。
  • 怎么确认 driver 匹配成功?答:看 dmesg 里有没有 probe 日志,或 ls /sys/bus/platform/drivers/。机制上匹配成功会创建设备。边界在于:匹配失败常见原因是 compatible 字符串拼写错误。延伸:调试时用 dtc 反编译 DTB。
  • platform driver 和 module driver 区别?答:platform driver 绑定设备树,module driver 通过 USB/PCI 热插拔发现。机制上 platform bus 是静态匹配。边界在于:嵌入式设备大多是 platform 设备。延伸:这就是 Linux 驱动模型的基础。

14.3.4-005 设备树的 reg、interrupts、clocks 是什么含义?

一句话结论

reg 描述设备寄存器地址和长度,interrupts 描述中断号和触发方式,clocks 描述设备使用的时钟源;driver 在 probe 里用这些信息初始化硬件。

概念解释

  • reg:reg = <address size>,寄存器物理地址映射。
  • interrupts:interrupts = <irq_number trigger_type>,中断号和触发方式。
  • clocks:clocks = <&clock_controller clock_id>,时钟源。
  • pinctrl:引脚复用配置。

原理流程

  1. 设备树节点:reg = <0x40011000 0x40> 表示寄存器基址 0x40011000,长度 0x40。
  2. probe 里:base = devm_ioremap(pdev, res->start, resource_size(res)) 映射地址。
  3. interrupts = <37 0> 表示中断号 37,触发方式 0(高电平)。
  4. clocks = <&rcc 0> 表示使用 rcc 时钟控制器的 0 号时钟。
  5. driver 调用 clk_prepare_enable() 使能时钟。

代码或图示

static int stm32_uart_probe(struct platform_device *pdev)
{
    struct resource *res;
    int irq;
    void __iomem *base;

    res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
    base = devm_ioremap_resource(&pdev->dev, res);  /* reg */

    irq = platform_get_irq(pdev, 0);                  /* interrupts */
    devm_request_irq(&pdev->dev, irq, uart_isr, 0, "uart", NULL);

    clk = devm_clk_get(&pdev->dev, NULL);             /* clocks */
    clk_prepare_enable(clk);

    /* 初始化硬件... */
    return 0;
}
uart1: serial@40011000 {
    compatible = "st,stm32f4-uart";
    reg = <0x40011000 0x40>;        /* 寄存器地址 */
    interrupts = <37 0>;            /* 中断号 37,高电平 */
    clocks = <&rcc 0>;              /* 使用 rcc 时钟 */
    pinctrl-names = "default";
    pinctrl-0 = <&uart1_pins>;      /* 引脚复用 */
};

常见误区

  • 误区:reg 地址随便写;正解:必须与硬件手册一致,否则 ioremap 失败。
  • 误区:interrupts 触发方式不重要;正解:边沿/电平触发错误会导致中断不触发。
  • 误区:时钟自动使能;正解:driver 必须显式 clk_prepare_enable。

追问

  • reg 的 size 怎么定?答:按寄存器映射范围,通常 0x40 或 0x100,覆盖所有寄存器。机制上 ioremap 按 size 映射。边界在于:size 太大可能映射到其他设备。延伸:硬件手册给出寄存器范围。
  • interrupts 的触发方式有哪些?答:高电平、低电平、上升沿、下降沿,对应 0-3。机制上中断控制器按触发方式配置。边界在于:电平触发需要 ISR 清标志,否则连续触发。延伸:这就是中断驱动要清标志的原因。
  • clocks 为什么要显式使能?答:低功耗设计,外设时钟默认关闭,driver 用才开。机制上时钟控制器按设备请求开/关。边界在于:时钟没使能,寄存器读写无效。延伸:这就是为什么 driver probe 第一步是使能时钟。

14.3.4-006 pinctrl 子系统解决什么问题?

一句话结论

pinctrl 子系统统一管理引脚复用和电气配置(上下拉、驱动强度),设备树用 pinctrl-0 引用引脚配置,driver probe 时自动应用,避免在驱动里写寄存器配引脚。

概念解释

  • pinctrl:引脚控制子系统,管理复用和电气属性。
  • pinctrl-0:设备树引用的引脚配置组。
  • 复用:一个引脚可配为 GPIO/UART/SPI,由 pinctrl 选择。
  • 电气属性:上下拉、驱动强度、速率。

原理流程

  1. 设备树:pinctrl-0 = <&uart1_pins>; pinctrl-names = "default";
  2. pinctrl 节点描述:PA9 复用为 UART1_TX,PA10 复用为 UART1_RX。
  3. driver probe 时,pinctrl 子系统自动应用引脚配置。
  4. driver 不需要写寄存器配引脚。
  5. 低功耗时可切到 sleep 状态引脚(pinctrl-1)。

代码或图示

&pinctrl {
    uart1_pins: uart1-pins {
        pins = "PA9", "PA10";
        function = "uart1";
        drive-push-pull;
        bias-pull-up;
    };
};

&uart1 {
    pinctrl-names = "default", "sleep";
    pinctrl-0 = <&uart1_pins>;
    pinctrl-1 = <&uart1_sleep_pins>;
    status = "okay";
};

常见误区

  • 误区:pinctrl 就是 GPIO;正解:pinctrl 管复用,GPIO 是数字输入输出。
  • 误区:引脚配置在 driver 里写;正解:pinctrl 子系统统一管理,driver 不写。
  • 误区:pinctrl 只复用;正解:还管上下拉、驱动强度、速率。

追问

  • 为什么要统一 pinctrl?答:避免每个 driver 自己写引脚寄存器,配置分散难维护。机制上 pinctrl 子系统集中管理。边界在于:简单 MCU 裸机不用 pinctrl,直接写寄存器。延伸:这就是 Linux 设备模型的统一管理。
  • sleep 状态引脚怎么用?答:低功耗时引脚切为高阻或上下拉,减少漏电。机制上 pinctrl-1 是 sleep 配置。边界在于:某些引脚在 sleep 时要保持状态(如复位脚)。延伸:这就是低功耗设计的一部分。
  • 引脚冲突怎么发现?答:两个设备同时引用同一引脚,pinctrl 子系统会报错。机制上 pinctrl 记录每个引脚的使用者。边界在于:设备树配置错误会导致冲突。延伸:调试时看 dmesg 的 pinctrl 日志。

14.3.4-007 时钟树(RCC)配置为什么容易错?

一句话结论

时钟树决定每个外设的时钟源和分频,配错会导致外设不工作、串口波特率错、I2C 时序错;常见错误是时钟未使能、时钟源选错、分频系数错。

概念解释

  • 时钟树:MCU 内部时钟分配,从 HSE/HSI 到 PLL 到各外设。
  • RCC:复位和时钟控制寄存器,配置时钟源和分频。
  • 时钟使能:每个外设时钟默认关闭,必须显式使能。
  • 波特率:UART 波特率基于外设时钟分频,时钟错则波特率错。

原理流程

  1. 初始化时钟树:选 HSE 或 HSI,配 PLL,得到系统时钟。
  2. 配置总线分频(AHB/APB1/APB2)。
  3. 使能外设时钟:__HAL_RCC_USART1_CLK_ENABLE()。
  4. 配置外设分频(UART BRR、I2C 分频)。
  5. 常见错误:时钟未使能 → 寄存器读写无效;分频错 → 波特率错。

代码或图示

/* STM32 时钟配置(CubeMX 生成) */
void SystemClock_Config(void)
{
    RCC_OscInitTypeDef osc = {0};
    osc.OscillatorType = RCC_OSCILLATORTYPE_HSE;
    osc.HSEState = RCC_HSE_ON;
    osc.PLL.PLLState = RCC_PLL_ON;
    osc.PLL.PLLSource = RCC_PLLSOURCE_HSE;
    osc.PLL.PLLM = 8;
    osc.PLL.PLLN = 336;
    osc.PLL.PLLP = RCC_PLLP_DIV2;
    HAL_RCC_OscConfig(&osc);

    RCC_ClkInitTypeDef clk = {0};
    clk.ClockType = RCC_CLOCKTYPE_HCLK | RCC_CLOCKTYPE_SYSCLK |
                    RCC_CLOCKTYPE_PCLK1 | RCC_CLOCKTYPE_PCLK2;
    clk.SYSCLKSource = RCC_SYSCLKSOURCE_PLLCLK;
    clk.AHBCLKDivider = RCC_SYSCLK_DIV1;
    clk.APB1CLKDivider = RCC_HCLK_DIV4;
    clk.APB2CLKDivider = RCC_HCLK_DIV2;
    HAL_RCC_ClockConfig(&clk, FLASH_LATENCY_5);

    __HAL_RCC_USART1_CLK_ENABLE();  /* 外设时钟使能 */
}

常见误区

  • 误区:外设时钟自动使能;正解:必须显式使能,否则寄存器读写无效。
  • 误区:时钟树配一次就行;正解:低功耗模式下时钟会切换,恢复后要重配。
  • 误区:分频系数不影响波特率;正解:UART BRR 基于外设时钟,分频错则波特率错。

追问

  • 怎么排查时钟问题?答:先用示波器量 MCO 引脚输出时钟,确认系统时钟;再检查外设时钟使能。机制上 MCO 可输出内部时钟到引脚。边界在于:时钟没起来,所有外设都不工作。延伸:这就是为什么启动代码先配时钟。
  • 低功耗模式时钟怎么切?答:Stop 模式下 HSE/PLL 关闭,用 HSI 或 LSI 维持;唤醒后重配 PLL。机制上低功耗自动切时钟源。边界在于:唤醒延迟包含时钟稳定时间。延伸:这就是 tickless 设计的一部分。
  • HSE 和 HSI 区别?答:HSE 是外部晶振(精确),HSI 是内部 RC(便宜但漂移)。机制上 HSE 精度高但需要外部元件。边界在于:成本敏感用 HSI,精度要求用 HSE。延伸:这就是为什么某些板子用外部 8MHz 晶振。

14.3.4-008 设备树 overlay 是什么?解决什么问题?

一句话结论

设备树 overlay 是可动态加载的设备树片段,同一内核适配多块板子(如同 SoC 不同板型),不需要为每块板子编一个 DTB;运行时加载 overlay 添加/修改设备节点。

概念解释

  • overlay:动态设备树片段,.dtbo 文件。
  • 基础 DTB:SoC 通用描述,包含 CPU、内存、总线。
  • overlay:板级差异(外设连接、引脚、电源)。
  • 动态加载:用户空间加载 overlay,添加设备。

原理流程

  1. 基础 DTB:描述 SoC 通用部分。
  2. overlay:描述某块板子的外设连接。
  3. 启动时或运行时加载 overlay,合并到基础 DTB。
  4. 同一内核适配多板,只换 overlay。
  5. 减少内核镜像数量。

代码或图示

/* 基础 DTB(SoC 通用) */
/ {
    soc {
        uart1: serial@40011000 { status = "disabled"; };
    };
};

/* overlay(某板) */
&uart1 {
    status = "okay";
    pinctrl-0 = <&uart1_pins>;
};

常见误区

  • 误区:overlay 就是设备树;正解:overlay 是片段,基础 DTB 是完整描述。
  • 误区:overlay 运行时加载;正解:多数系统启动时加载,少数支持运行时。
  • 误区:overlay 可修改任何节点;正解:只能添加/启用节点,不能改 SoC 核心。

追问

  • 为什么要用 overlay?答:同一 SoC 多块板子,每块板子外设不同,用 overlay 避免每块板子编一个 DTB。机制上基础 DTB + 板级 overlay。边界在于:overlay 增加复杂度,简单系统不用。延伸:这就是树莓派的设备树模型。
  • overlay 怎么调试?答:用 dtc -I fs /proc/device-tree 看合并后的设备树。机制上 overlay 加载后合并到基础 DTB。边界在于:overlay 语法错误会导致加载失败。延伸:看 dmesg 的 overlay 日志。
  • 什么系统用 overlay?答:树莓派、Android、商业嵌入式 Linux 用,简单 MCU 裸机不用。机制上 overlay 是 Linux 生态。边界在于:裸机 RTOS 没有设备树概念。延伸:这就是 Linux 和裸机的差异。

14.3.4-009 platform driver 的 probe 流程?

一句话结论

probe 是 driver 匹配设备后调用的初始化函数,流程是:获取资源(reg/irq/clocks)→ 映射地址 → 申请中断 → 初始化硬件 → 注册设备(字符设备/input/网络)→ 返回成功。

概念解释

  • probe:设备匹配后调用的初始化函数。
  • remove:设备移除时调用的清理函数。
  • devm_*:资源管理函数,自动释放(不需要手动清理)。
  • 字符设备:注册为 /dev/xxx 节点。

原理流程

  1. platform_get_resource 获取 reg 资源。
  2. devm_ioremap_resource 映射寄存器地址。
  3. platform_get_irq 获取中断号。
  4. devm_request_irq 申请中断。
  5. devm_clk_get + clk_prepare_enable 使能时钟。
  6. 初始化硬件(写寄存器)。
  7. 注册字符设备/输入设备。

代码或图示

static int stm32_uart_probe(struct platform_device *pdev)
{
    struct resource *res;
    int irq, ret;
    void __iomem *base;
    struct clk *clk;

    res = platform_get_resource(pdev, IORESOURCE_MEM, 0);
    base = devm_ioremap_resource(&pdev->dev, res);
    if (IS_ERR(base)) return PTR_ERR(base);

    irq = platform_get_irq(pdev, 0);
    ret = devm_request_irq(&pdev->dev, irq, uart_isr, 0, "uart", NULL);
    if (ret) return ret;

    clk = devm_clk_get(&pdev->dev, NULL);
    clk_prepare_enable(clk);

    /* 初始化硬件 */
    uart_hw_init(base);

    /* 注册字符设备 */
    alloc_chrdev_region(&dev, 0, 1, "uart");
    cdev_init(&cdev, &uart_fops);
    cdev_add(&cdev, dev, 1);

    platform_set_drvdata(pdev, base);
    return 0;
}

常见误区

  • 误区:probe 里做业务;正解:probe 只初始化硬件,业务在用户空间。
  • 误区:手动释放资源;正解:用 devm_* 自动释放。
  • 误区:probe 失败不清理;正解:返回错误码,devm_* 自动回滚。

追问

  • devm_* 是什么?答:设备资源管理,绑定设备生命周期,设备移除时自动释放。机制上 devm_* 注册清理函数。边界在于:某些资源不能用 devm(如全局状态)。延伸:这就是 Linux 驱动减少内存泄漏的设计。
  • probe 为什么可能失败?答:资源不足(内存、中断)、硬件不存在、时钟失败。机制上 probe 返回错误码,设备不注册。边界在于:probe 失败要打印错误日志。延伸:看 dmesg 的 probe 失败原因。
  • remove 做什么?答:清理 probe 里分配的资源(devm_* 自动,手动的要手动释放)。机制上设备移除时调用。边界在于:用 devm_* 就不需要写 remove。延伸:这就是 devm 的价值。

14.3.4-010 怎么做到一份业务代码跑多块板子?

一句话结论

通过 BSP 层抽象板级差异,业务代码只依赖驱动接口,同一份业务代码通过换 BSP(不同板子的引脚、时钟、外设配置)跑在多块板子上,业务代码不变。

概念解释

  • BSP 抽象:定义板级接口(引脚、时钟、外设实例),不同板子实现不同。
  • 驱动接口:业务只依赖驱动 ops,不关心硬件细节。
  • 配置项:通过编译时配置(宏)或运行时配置(设备树)选择板子。
  • 同一份业务:代码不修改,换 BSP 重新编译。

原理流程

  1. 定义板级接口:struct board_ops { uart_init(); sensor_init(); ... }。
  2. 不同板子实现 board_ops(引脚、时钟、外设实例不同)。
  3. 业务代码调用 board_ops,不关心具体硬件。
  4. 编译时选板子(BOARD=xxx),链接对应 BSP。
  5. 同一份业务代码跑多块板子。

代码或图示

/* 板级接口 */
struct board_ops {
    void (*uart_init)(void);
    int (*sensor_read)(float *out);
};

/* 业务代码 */
void app(void)
{
    board->uart_init();
    float t;
    board->sensor_read(&t);
    mqtt_publish("temp", t);
}

/* 板子 A BSP */
static struct board_ops board_a = {
    .uart_init = board_a_uart_init,
    .sensor_read = board_a_sensor_read,
};

/* 板子 B BSP */
static struct board_ops board_b = {
    .uart_init = board_b_uart_init,
    .sensor_read = board_b_sensor_read,
};

/* 编译时选择 */
#ifdef BOARD_A
struct board_ops *board = &board_a;
#else
struct board_ops *board = &board_b;
#endif

常见误区

  • 误区:业务里写 #ifdef BOARD_A;正解:用 ops 抽象,业务不写条件编译。
  • 误区:BSP 就是驱动;正解:BSP 描述板级连接,驱动操作设备。
  • 误区:多板子要改业务;正解:业务不变,只换 BSP。

追问

  • 编译时还是运行时选板子?答:编译时用宏选(简单),运行时用设备树选(灵活)。机制上编译时链接对应 BSP。边界在于:运行时选板子增加复杂度,适合多产品共线。延伸:这就是设备树的价值。
  • 怎么测试业务代码?答:用 mock board_ops 跑在 host 上,不依赖硬件。机制上函数指针注入 mock。边界在于:硬件相关测试要在板子上做。延伸:这就是分层测试的价值。
  • 多板子维护成本?答:业务一份,BSP 多份,维护成本主要在 BSP。机制上 BSP 随硬件变化。边界在于:BSP 要版本管理,避免混乱。延伸:这就是为什么 BSP 要文档化。

动手练习

练习 1:为你的板子写一个简单的 BSP

  • 任务:定义板级接口(UART、I2C、LED),实现至少两块板子的 BSP,同一份业务代码跑两块板子。
  • 验收标准:
    1. 业务代码不写 #ifdef。
    2. 换板子只改 BSP。
    3. 业务功能正常。

练习 2:写一个简单的 Linux platform driver

  • 任务:写一个 misc device driver,匹配设备树节点,实现 read/write,probe 里获取资源。
  • 验收标准:
    1. 设备树节点 compatible 匹配。
    2. probe 里获取 reg/irq/clocks。
    3. /dev 节点可读写。

自检清单

  • [ ] 能否说清 HAL/BSP/驱动/业务四层职责?
  • [ ] 能否在 HAL/LL/寄存器之间选择?
  • [ ] 能否解释 compatible 匹配流程?
  • [ ] 能否说明 reg/interrupts/clocks 的含义?
  • [ ] 能否解释 pinctrl 的作用?
  • [ ] 能否说明时钟树配置常见错误?
  • [ ] 能否写出 platform driver 的 probe 流程?
  • [ ] 能否说明怎么做到一份业务跑多板?

延伸阅读

  • STMicroelectronics:STM32 HAL 与 LL 用户手册(UM1850)。
  • Linux 内核文档:devicetree/bindings/、driver-api/platform.txt、driver-api/pinctrl.txt。
  • Bootlin:Linux 设备树教程(bootlin.com)。
  • Zephyr 官方文档:Devicetree、Board Support。
  • ESP-IDF 文档:硬件抽象层、BSP。

待整理清单

  • [ ] 补充 Zephyr 设备树与 Kconfig 配合
  • [ ] 补充 Yocto/OpenEmbedded 的 BSP 层组织
  • [ ] 补充 Linux 驱动模型(设备/驱动/bus)的完整生命周期