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 怎么匹配。
先修与前置
- 建议先读 14.2.1 复位启动流程与 Bootloader,理解 BSP 初始化流程。
- 建议先读 14.3.1 GPIO 与 I2C/SPI/UART 总线驱动,理解外设寄存器。
知识地图
软件分层(依赖方向从上到下)
业务层(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 接口,操作传感器。 - 业务:协议解析、上报、状态机,调用驱动接口。
原理流程
- 换 MCU:只改 HAL(换厂商库),BSP 和驱动不动。
- 换板子(同 MCU):只改 BSP(引脚映射),驱动和业务不动。
- 换传感器:只改驱动(新驱动),业务不动。
- 换业务逻辑:只改业务,驱动和 BSP 不动。
- 层间用接口(函数指针/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 大。
原理流程
- 性能敏感路径(ISR、PWM、SPI 时序):用 LL,直接寄存器。
- 业务初始化(UART 配置、I2C 读写):用 HAL,开发快。
- 混合使用:HAL 初始化,LL 数据传输。
- 代码体积受限:优先 LL。
- 调试方便: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 驱动接口测试。
- 可维护性:寄存器变化集中在底层。
原理流程
- 业务需要 UART 发送:调
uart_send(data, len),不写寄存器。 - BSP/HAL 实现
uart_send,操作寄存器。 - 换 MCU:只改
uart_send实现。 - 业务代码不变。
- 接口定义稳定,业务不关心硬件。
代码或图示
/* 错误:业务直接写寄存器 */
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:匹配成功后调用的初始化函数。
原理流程
- 设备树节点:
uart1: serial@40011000 { compatible = "st,stm32-uart"; reg = <0x40011000 0x40>; } - driver 定义:
static const struct of_device_id stm32_uart_of_match[] = { { .compatible = "st,stm32-uart" }, {} }; - 内核启动,platform bus 遍历设备树,找 compatible 匹配。
- 匹配成功,调用
stm32_uart_driver.probe(&pdev)。 - 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:引脚复用配置。
原理流程
- 设备树节点:
reg = <0x40011000 0x40>表示寄存器基址 0x40011000,长度 0x40。 - probe 里:
base = devm_ioremap(pdev, res->start, resource_size(res))映射地址。 interrupts = <37 0>表示中断号 37,触发方式 0(高电平)。clocks = <&rcc 0>表示使用 rcc 时钟控制器的 0 号时钟。- 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 选择。
- 电气属性:上下拉、驱动强度、速率。
原理流程
- 设备树:
pinctrl-0 = <&uart1_pins>; pinctrl-names = "default"; - pinctrl 节点描述:PA9 复用为 UART1_TX,PA10 复用为 UART1_RX。
- driver probe 时,pinctrl 子系统自动应用引脚配置。
- driver 不需要写寄存器配引脚。
- 低功耗时可切到 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 波特率基于外设时钟分频,时钟错则波特率错。
原理流程
- 初始化时钟树:选 HSE 或 HSI,配 PLL,得到系统时钟。
- 配置总线分频(AHB/APB1/APB2)。
- 使能外设时钟:
__HAL_RCC_USART1_CLK_ENABLE()。 - 配置外设分频(UART BRR、I2C 分频)。
- 常见错误:时钟未使能 → 寄存器读写无效;分频错 → 波特率错。
代码或图示
/* 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,添加设备。
原理流程
- 基础 DTB:描述 SoC 通用部分。
- overlay:描述某块板子的外设连接。
- 启动时或运行时加载 overlay,合并到基础 DTB。
- 同一内核适配多板,只换 overlay。
- 减少内核镜像数量。
代码或图示
/* 基础 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 节点。
原理流程
platform_get_resource获取 reg 资源。devm_ioremap_resource映射寄存器地址。platform_get_irq获取中断号。devm_request_irq申请中断。devm_clk_get+clk_prepare_enable使能时钟。- 初始化硬件(写寄存器)。
- 注册字符设备/输入设备。
代码或图示
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 重新编译。
原理流程
- 定义板级接口:
struct board_ops { uart_init(); sensor_init(); ... }。 - 不同板子实现 board_ops(引脚、时钟、外设实例不同)。
- 业务代码调用 board_ops,不关心具体硬件。
- 编译时选板子(
BOARD=xxx),链接对应 BSP。 - 同一份业务代码跑多块板子。
代码或图示
/* 板级接口 */
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,同一份业务代码跑两块板子。
- 验收标准:
- 业务代码不写
#ifdef。 - 换板子只改 BSP。
- 业务功能正常。
- 业务代码不写
练习 2:写一个简单的 Linux platform driver
- 任务:写一个 misc device driver,匹配设备树节点,实现 read/write,probe 里获取资源。
- 验收标准:
- 设备树节点 compatible 匹配。
- probe 里获取 reg/irq/clocks。
- /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)的完整生命周期