Linux设备树实战：如何为IMX6ULL开发板定制dts文件（附完整编译流程）-酒店常州论坛

Linux设备树实战：如何为IMX6ULL开发板定制dts文件（附完整编译流程）

在嵌入式Linux开发中，设备树（Device Tree）已经成为硬件描述的标准方式。对于使用NXP i.MX6ULL处理器的开发者来说，掌握设备树的定制与编译是必备技能。本文将带你从零开始，完成一个完整的设备树开发流程。

1. 设备树基础与IMX6ULL特性

设备树的核心作用是将硬件配置信息从内核代码中分离出来，实现"一次编写，多处适配"。i.MX6ULL作为一款广泛应用的Cortex-A7处理器，其设备树结构具有典型参考价值。

关键概念速览：

.dts：设备树源文件（人类可读文本）
.dtb：编译后的设备树二进制文件
DTC：设备树编译器（Device Tree Compiler）

i.MX6ULL的设备树文件通常位于内核源码的arch/arm/boot/dts/目录下。以常见的14x14 EVK板为例，其基础设备树文件包括：

imx6ull-14x14-evk.dts imx6ull-14x14-evk-emmc.dts imx6ull-14x14-evk-btwifi.dts

2. 创建自定义设备树文件

2.1 确定基础模板

为新的开发板创建设备树时，最佳实践是基于最接近的现有配置进行修改。对于i.MX6ULL平台：

cd arch/arm/boot/dts/ cp imx6ull-14x14-evk.dts imx6ull-myboard.dts

2.2 关键修改区域

典型的定制内容包括：

模块	典型修改内容	示例代码
内存	调整内存大小	`memory@80000000 { reg = <0x80000000 0x20000000>; }`
GPIO	配置引脚功能	`pinctrl_uart1: uart1grp { fsl,pins = <MX6UL_PAD_UART1_TX_DATA__UART1_DCE_TX 0x1b0b1>; }`
外设	启用/禁用设备	`&usdhc1 { status = "okay"; pinctrl-names = "default"; }`

2.3 添加自定义硬件

假设我们需要添加一个LED设备：

/ { leds { compatible = "gpio-leds"; led0 { label = "heartbeat"; gpios = <&gpio1 5 GPIO_ACTIVE_HIGH>; linux,default-trigger = "heartbeat"; }; }; };

3. 编译流程详解

3.1 单文件编译方法

最直接的编译方式是使用make指定目标：

make imx6ull-myboard.dtb

注意：此命令需要在Linux内核源码根目录执行，且依赖正确的交叉编译工具链配置

3.2 编译系统集成

要使新设备树纳入常规编译流程，需修改Makefile：

打开arch/arm/boot/dts/Makefile
在dtb-$(CONFIG_SOC_IMX6ULL)段添加：

dtb-$(CONFIG_SOC_IMX6ULL) += \ imx6ull-myboard.dtb

3.3 编译验证技巧

使用fdtdump工具检查生成的dtb文件：

fdtdump imx6ull-myboard.dtb | less

典型输出应包含：

/dts-v1/; // { // model = "My i.MX6ULL Board"; // compatible = "fsl,imx6ull-myboard", "fsl,imx6ull"; ...

4. 常见问题排查

4.1 语法错误处理

DTC编译器会报告具体错误位置：

Error: arch/arm/boot/dts/imx6ull-myboard.dts:45.1-9 syntax error FATAL ERROR: Unable to parse input tree

调试步骤：

检查行号附近的括号匹配
验证属性值格式（特别是<>和[]的使用）
确认节点路径正确性

4.2 运行时问题诊断

内核启动时关注设备树相关日志：

dmesg | grep -i device-tree

常见问题包括：

内存区域冲突（reserved-memory处理不当）
时钟配置错误（clocks属性缺失）
引脚复用冲突（pinctrl配置错误）

4.3 设备树覆盖技术

对于快速迭代开发，可以使用动态设备树覆盖：

fdtoverlay -o merged.dtb -i base.dtb overlay1.dtbo overlay2.dtbo

5. 高级定制技巧

5.1 条件编译支持

设备树支持类似C语言的预处理指令：

#ifdef CONFIG_TOUCHSCREEN &i2c1 { touchscreen@38 { compatible = "edt,edt-ft5x06"; reg = <0x38>; }; }; #endif

5.2 多板卡支持方案

通过compatible字符串实现单一dts适配多个硬件：

/ { model = "MyBoard Family"; compatible = "myboard,revA", "myboard,revB", "fsl,imx6ull"; board-rev { compatible = "myboard,revision"; revA-gpio = <&gpio1 12 GPIO_ACTIVE_HIGH>; revB-gpio = <&gpio1 13 GPIO_ACTIVE_HIGH>; }; };

5.3 调试接口优化

添加专用调试节点：

/debug { compatible = "myboard,debug"; regmap = <&iomuxc>; status-gpios = <&gpio2 15 GPIO_ACTIVE_HIGH>; };

在实际项目中，设备树的调试往往占用了大量开发时间。建议在硬件设计阶段就与电路工程师确认好关键引脚分配，可以节省后期大量的调试成本。对于复杂的板级支持包，采用分模块的dtsi包含方式会让维护更加轻松。

企业官网建设流程全解析