Linux设备树实战:深度解析WiFi外设之有关设备树属性

本文约2500字，对于嵌入式Linux开发者而言，设备树（Device Tree） 是绕不开的核心技术——它脱离内核代码硬编码，以结构化描述文件定义硬件资源，让内核无需重新编译即可适配不同硬件平台。

本文以AX615芯片的 AX615.dtsi（芯片通用设备树）和 AX615_nor.dts（板级设备树）为实战案例，从设备树基础语法、内核资源映射逻辑，根据日志排查解决了wifi的sdhci控制器启用成功（后续wifi驱动工作正常后，再继续更帖)，一起深度学习设备树相关知识和修改方法。

我建了一个Linux BSP学习交流群，想学BSP或者已经是BSP开发者可私信我，加入群，一起交流学习，共同进步。

关注公众号, 即可获得与Linux相关的电子书籍以及常用开发工具，文末有文档清单。

导语：对于嵌入式Linux开发者而言，设备树（Device Tree）是绕不开的核心技术。本文以AX615芯片为实战案例，一起来学习设备树的修改与外设调试技巧。

一  先读懂DTS架构

设备树的本质是硬件资源的树形描述文件，内核通过解析它，完成CPU、外设、中断、时钟、GPIO等资源的映射。

AX615的设备树采用分层设计，这是Linux设备树的标准规范：

1.1 设备树核心语法

设备树语法极简，核心就3类元素，直接对应AX615代码：

// 1. 节点：{} 包裹，描述一个硬件设备uart0: uart@4880000 {  // 标签: 设备名@物理基地址    compatible = "axera,apb-uart";  // 2. 属性：键值对，匹配内核驱动    reg = <0x4880000 0x400>;        // 寄存器地址+长度    interrupts = <GIC_SPI 87 IRQ_TYPE_LEVEL_HIGH>; // 中断号+触发方式    status = "okay";                // 3. 状态：okay=启用，disabled=禁用};// 2. 引用：&标签 覆写dtsi中的节点配置&uart0 {    status = "okay"; // 板级dts启用UART0};// 3. 别名：简化外设访问aliases {    serial0 = &uart0; // 系统中serial0对应uart0    mmc0 = &sdio;     // mmc0对应SDIO控制器（WiFi核心外设）};

1.2 AX615设备树关键模块解析

结合源码，我们先锁定WiFi调试必备的核心模块，这是后续调通的基础：

二 设备树如何让内核识别外设

有时候改了设备树，外设却不工作，核心是没理解设备树→驱动匹配→资源映射的流程：

1. 驱动匹配：设备节点的 compatible 属性，必须与内核驱动的 of_device_id 完全一致，驱动才会挂载；
2. 资源分配：reg（寄存器）、interrupts（中断）、clocks（时钟）被内核提取，分配给驱动；
3. 状态控制：status = "okay" 才会初始化外设，disabled 会跳过；
4. 板级适配：dtsi定义通用资源，dts覆写引脚、状态、外接设备参数，最终生效。

以WiFi为例：SDIO控制器是WiFi的「通信桥梁」，内核先通过设备树识别SDIO控制器，再通过SDIO总线枚举WiFi设备，最终加载WiFi驱动。

三 实战核心：基于AX615，配置WIFI外设

本文以SDIO接口WiFi模块为例，结合AX615设备树，分5步完成调试。

第一步：锁定WiFi依赖的设备树节点

打开 AX615.dtsi 和 AX615_nor.dts，找到SDIO控制器节点（WiFi的核心总线）：

说明: 默认dts中没有对sdio的支持，厂家提供的芯片外围设备驱动开发文档中明确描述，建议从emmc的dts中拷贝sdio的相关配置到nor中，但需要做相应的修改。

// AX615.dtsi 芯片级SDIO定义sdio: sdhci@1B40000 {    compatible = "axera,sdhc";           // 匹配AX615 SDIO驱动    reg = <0x01B40000 0x1000>;           // SDIO寄存器基地址    interrupts = <GIC_SPI 7 IRQ_TYPE_LEVEL_HIGH>; // SDIO中断号    max-frequency = <50000000>;          // 最大时钟50MHz    no-sd;                               // 不支持SD卡    no-mmc;                              // 不支持eMMC    cap-sdio-irq;                        // 支持SDIO中断（WiFi必需）    status = "disabled";                 // 默认禁用，板级启用};// AX615_nor.dts 板级覆写（关键修改）&sdio {    status = "okay";                     // 1. 启用SDIO控制器    bus-width = <4>;                     // 2. 数据位宽4线（WiFi标准配置）    pwr_en_gpioD = <&gpio0 26 0>;        // 3. WiFi电源使能GPIO    post-power-on-delay-ms = <30>;       // 上电延时30ms    non-removable;                       // WiFi为板载设备，不可移除    cap-sd-highspeed;                    // 支持高速模式};

第二步：配置WiFi关键GPIO（电源/复位）

WiFi模块必须通过GPIO控制电源使能和硬件复位，这是设备树必改点：

// 电源使能GPIOpwr_en_gpioD = <&gpio0 26 0>;  // gpio0:控制器，26:引脚，0:高电平有效// 复位GPIO（若WiFi有复位脚）&sdio {    reset_gpio = <&gpio0 27 0>; // GPIO0_A27 复位引脚};// 启用GPIO控制器&gpio0 { status = "okay"; };&gpio1 { status = "okay"; };

第三步：引脚复用配置（PinMux）—— 最容易踩坑的点

AX615的GPIO支持多功能复用，必须将SDIO的CLK/CMD/D0-D3引脚配置为SDIO功能：

&sdio {    // 示例：SDIO引脚复用配置（根据实际手册修改）    axera_pinmux_clk = <0x2304000 0xXX 16 1 6>;    axera_pinmux_cmd = <0x2304000 0xXX 16 1 6>;    axera_pinmux_d0 = <0x2304000 0xXX 16 1 6>;};

✅ 调试技巧：若SDIO枚举失败，极有可能是引脚复用错误，优先核对手册！

第四步：检查中断与时钟（内核资源必备）

• 中断检查：interrupts 必须与芯片手册一致
• 时钟检查：max-frequency = <50000000> 符合WiFi模块要求

第五步：编译、烧录与验证

正确修改dts、dtsi文件后编译完验证, 内核打印如下：

四 设备树修改避坑指南（WiFi调试专属）

五 深度总结：设备树修改的核心思维

通过AX615 WiFi外设调试，我们可以总结设备树的万能修改思维：

1. 分层修改：不改dtsi通用配置，只在板级dts覆写
2. 按需启用：外设默认 disabled，用到哪个改哪个
3. 硬件优先：所有配置必须贴合芯片手册 + 硬件原理图
4. 驱动联动：设备树配置最终要匹配内核驱动
5. 调试闭环：修改 → 编译 → 烧录 → 日志排查

结语

设备树是硬件与内核的沟通语言。以AX615芯片为例，只要掌握「节点匹配、资源配置、状态控制、引脚复用」四大核心，无论WiFi、以太网、UART、I2C等任何外设，都能按照这套逻辑快速调通。

后续进阶可深入学习设备树的 overlay（动态加载）、中断映射、时钟树配置，一起认真学习，成为嵌入式Linux硬件适配的高手！

📌 关键知识点回顾

• 设备树分层：dtsi（芯片通用）+ dts（板级专属）
• WiFi调试核心：SDIO控制器 → GPIO电源/复位 → 引脚复用 → 中断/时钟
• 万能调试法：dmesg 查日志，核对 compatible、reg、interrupts、status
• 核心原则：设备树描述硬件，硬件决定配置，驱动完成适配

往期文章（欢迎订阅技术分享栏目全部文章）：