引言：设备树的"身份证号"
在嵌入式Linux开发中，设备树的model属性扮演着至关重要的角色。它就像设备的"身份证号"，唯一标识硬件平台的型号和制造商。理解model属性是掌握设备树开发的关键一步。
一、model属性本质解析
1.1 基础定义
model是设备树根节点（/）的一个标准属性，用于描述硬件平台的完整标识：
/ { model = "制造商, 产品型号"; // 示例： model = "Raspberry Pi Foundation, Raspberry Pi 4 Model B"; };1.2 核心作用
| 作用 | 说明 | 类比 |
|---|---|---|
| 硬件识别 | 标识具体硬件平台 | 设备的"身份证号" |
| 版本控制 | 区分硬件修订版 | 产品的"批次号" |
| 兼容性检查 | 验证软件与硬件匹配 | 驱动程序的"适配清单" |
1.3 典型位置
/dts-v1/; / { model = "全志,t113-i-evb"; // 根节点下的model属性 compatible = "allwinner,sun8i-t113"; #address-cells = <1>; #size-cells = <1>; // 其他节点... };二、modelvscompatible：关键区别
2.1 功能对比
| 属性 | model | compatible |
|---|---|---|
| 位置 | 仅根节点 | 所有设备节点 |
| 作用 | 硬件平台识别 | 驱动匹配 |
| 格式 | 可读性描述 | 技术性标识 |
| 数量 | 单一值 | 可多个值（兼容链） |
2.2 使用场景对比
// model：描述整个开发板 model = "Rockchip,RK3568-EVB1-V10"; // compatible：匹配具体设备驱动 &i2c0 { status = "okay"; temperature-sensor@48 { compatible = "ti,tmp75"; // 匹配温度传感器驱动 reg = <0x48>; }; };三、model属性的实战应用
3.1 内核启动识别
在内核启动时，model信息会首先显示：
[0.000000] OF: fdt: Machine model: Rockchip RK3568 EVB1 V103.2 用户空间查看
通过/proc/device-tree/model文件查看：
$cat/proc/device-tree/model Rockchip RK3568 EVB1 V103.3 驱动代码中的应用
在内核驱动中获取model信息：
#include<linux/of.h>staticint__initmy_driver_init(void){constchar*model;// 获取根节点structdevice_node*root=of_find_node_by_path("/");// 读取model属性if(of_property_read_string(root,"model",&model)){pr_err("无法获取设备型号\n");}else{pr_info("设备型号: %s\n",model);}// 根据型号进行特殊处理if(strstr(model,"RK3568")){// RK3568平台特定配置}elseif(strstr(model,"T113-i")){// 全志T113平台配置}return0;}四、model属性的设计规范
4.1 命名规范
| 组件 | 格式要求 | 示例 |
|---|---|---|
| 制造商 | 小写字母，无空格 | rockchip |
| 产品线 | 首字母大写 | RK3568 |
| 型号/版本 | 清晰版本标识 | EVB1-V10 |
| 完整格式 | <制造商>,<产品型号> | "rockchip,rk3568-evb1-v10" |
4.2 多版本支持
// 硬件版本区分 / { model = "friendlyarm,nanopi-r4s"; // 通过子属性细化 hardware-version = "rev2.1"; compatible = "friendlyarm,nanopi-r4s", "rockchip,rk3568"; };五、跨平台开发实战案例
5.1 全志T113-i vs 瑞芯微RK3568
// 全志T113-i开发板 / { model = "allwinner,t113-i-evb-v1.0"; compatible = "allwinner,sun8i-t113"; }; // 瑞芯微RK3568开发板 / { model = "rockchip,rk3568-evb1-v10"; compatible = "rockchip,rk3568"; };5.2 设备树中的条件编译
在内核设备树文件中使用预处理指令：
#include "sun8i-t113.dtsi" / { model = "allwinner,t113-i-evb"; #ifdef CONFIG_TOUCHSCREEN &i2c1 { touchscreen@38 { compatible = "focaltech,ft6236"; reg = <0x38>; }; }; #endif };六、调试技巧与最佳实践
6.1 调试命令
# 查看完整设备树dtc-Ifs /proc/device-tree# 提取model信息strings /proc/device-tree/model# 内核调试信息dmesg|grep"Machine model"6.2 常见问题排查
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
| 内核无法识别硬件 | model属性缺失 | 检查设备树根节点 |
| 驱动加载错误 | model与硬件不匹配 | 验证实际硬件型号 |
| 启动卡住 | model格式错误 | 检查引号和逗号使用 |
6.3 最佳实践原则
- 唯一性原则：每个硬件平台应有唯一model
- 版本控制：硬件修订时更新model
- 可读性：保持人类可读的命名
- 一致性：与产品文档保持一致
七、model属性的扩展应用
7.1 与U-Boot的交互
U-Boot传递设备树给内核时添加model：
// U-Boot源码中设置intft_system_setup(void*blob,bd_t*bd){constchar*model="allwinner,t113-i-evb";do_fixup_by_path_string(blob,"/","model",model);return0;}7.2 自动化构建系统
在Makefile中使用model：
DTB_FILE = $(MODEL).dtb %.dtb: %.dts dtc -I dts -O dtb -o $@ $< all: @echo "Building for model: $(MODEL)" make DTS_FILE=$(MODEL).dts7.3 动态设备配置
// 根据model动态加载配置staticvoidload_hardware_config(void){constchar*model=get_model_from_dt();if(strcmp(model,"rk3568-evb1")==0){init_rk3568_specific();}elseif(strcmp(model,"t113-i-evb")==0){init_t113_specific();}}结语：model的核心价值
model属性在嵌入式Linux系统中扮演着硬件标识基石的角色：
- 硬件识别：精确标识物理设备
- 版本控制：管理硬件迭代
- 兼容性桥梁：连接软件与硬件
开发箴言：
优秀的设备树设计：
- 始于精确的
model定义- 成于合理的
compatible规划- 终于一致的硬件描述
学习资源：
- 设备树规范
- Linux设备树文档
- 全志T113设备树示例
