保姆级教程：基于RK3588 EVB1参考板，手把手教你创建自定义板级DTS文件

从零构建RK3588自定义硬件描述DTS文件实战指南当开发者拿到一块基于RK3588的自研开发板时第一道门槛往往是如何让系统正确识别硬件配置。本文将带你深入Linux内核的设备树Device Tree机制以EVB1参考板为基础逐步构建适配自定义硬件的DTS文件。1. 设备树基础与Rockchip平台特性设备树DTS作为ARM架构下硬件描述的标准化方案已取代传统的硬编码方式。Rockchip平台的DTS文件通常采用分层结构SoC级DTSI描述RK3588芯片内部资源如rk3588.dtsi板级DTSI定义参考板通用配置如rk3588-evb1-lp4.dtsi产品级DTS最终板卡的具体实现如rk3588-evb1-lp4-v10.dts典型文件结构示例/dts-v1/; #include rk3588.dtsi // SoC级定义 #include rk3588-evb1-lp4.dtsi // 板级通用配置 #include rk3588-android.dtsi // 系统级配置 / { model My Custom Board; compatible rockchip,rk3588-myboard, rockchip,rk3588; };2. 参考板选择与差异分析选择参考板时需重点对比以下硬件模块硬件模块EVB1配置自定义板差异点电源管理双RK806 PMIC单RK806分立电源内存LPDDR4 200Ball封装同封装但厂商不同显示接口双HDMI2.11xVGA仅保留单HDMI外设接口6xUSB3.02xRJ454xUSB3.01xRJ45扩展槽PCIe3.0 x4PCIe2.0 x1实操建议使用diff工具对比不同参考板的DTS文件diff -u rk3588-evb1-lp4-v10.dts rk3588-evb7-lp4-v10.dts3. 自定义DTS文件创建实战3.1 基础文件搭建在内核源码目录创建新文件cd arch/arm64/boot/dts/rockchip cp rk3588-evb1-lp4-v10.dts rk3588-myboard-v1.dts修改文件头信息// SPDX-License-Identifier: (GPL-2.0 OR MIT) /* * Copyright (c) 2023 [Your Company] */ /dts-v1/; #include rk3588-evb1-lp4.dtsi #include rk3588-linux.dtsi / { model My Custom RK3588 Board V1; compatible rockchip,rk3588-myboard-v1, rockchip,rk3588; };3.2 关键硬件适配修改案例1GPIO背光控制修改backlight { enable-gpios gpio2 RK_PB7 GPIO_ACTIVE_HIGH; // 修改为实际GPIO pwm-duty-cycle 500; // 调整PWM占空比 };案例2禁用未使用的外设/* 禁用未使用的触摸控制器 */ gt1x { status disabled; }; /* 关闭第二个以太网接口 */ gmac1 { status disabled; };案例3内存参数调整dmc { memory-timings /* 根据实际内存芯片修改时序参数 */ 0x0 0x0 0x0 0x0 0x0 0x0 0x0 0x0 ; };4. 编译验证与调试技巧4.1 编译流程make ARCHarm64 rk3588-myboard-v1.dtb4.2 调试方法查看设备树展开结果fdtdump rk3588-myboard-v1.dtb运行时调试# 查看已加载的设备树节点 ls /proc/device-tree/ # 获取特定属性值 hexdump -C /proc/device-tree/gpiofec20000/reg常见问题处理GPIO冲突检查pinctrl配置时钟缺失验证assigned-clocks属性驱动加载失败确认status属性为okay提示Rockchip平台提供专用调试工具rkdeveloptool dbg rk3588-myboard-v1.dtb5. 高级定制与优化策略5.1 电源管理优化rk806_dvs1 { regulator-init-microvolt 900000; regulator-always-on; };5.2 性能调优参数cpu_l0 { operating-points-v2 cluster0_opp_table; cpu-supply vdd_cpu_lit; dynamic-power-coefficient 100; };5.3 设备树覆盖机制// 在uboot环境设置覆盖文件 env set fdt_overlays my_overlay.dtbo在实际项目中我曾遇到一个显示接口配置问题由于疏忽了port0的phy-mode设置导致HDMI输出异常。经过示波器抓取信号和逐行核对DTS配置最终发现需要明确指定hdmi0 { ports { port0 { hdmi0_out: endpoint { remote-endpoint hdmi_con_in; phy-mode tmds; }; }; }; };