Linux Kernel Devicetree Specification v0.4

"devicetree-specification-英文原版-v0.4.pdf" 这篇文档是Linux内核设备树（Device Tree）的规格说明，版本为v0.4，发布于2023年6月28日。设备树是一种在嵌入式系统中描述硬件结构的数据结构，它为操作系统提供了关于硬件平台的详细信息，使得内核能够动态地配置和初始化硬件。此文档主要针对Linux内核的设备树源码描述（DTS）规范。 1. **目的和范围** 设备树的目的是提供一个平台无关的、结构化的描述，用于传递硬件信息给引导加载程序和操作系统。其范围包括了硬件组件的描述、中断处理、内存映射等关键信息。 2. **与IEEE 1275和ePAPR的关系** 设备树规范与IEEE 1275（Open Firmware）和ePAPR（Power Architecture Platform Requirements）中的概念有关，但具有自己的特性，适应现代Linux内核的需求。 3. **32位和64位支持** 规范支持32位和64位架构，确保跨不同硬件平台的兼容性。 4. **术语定义** 文档中定义了一系列关键术语，如节点（node）、属性（properties）、标准属性（standard properties）等，以确保读者对概念的理解一致。 5. **设备树结构和约定** - **节点名称**：每个硬件组件或功能被表示为一个节点，有唯一的名称。 - **通用名称推荐**：建议使用简明的、描述性的名称。 - **路径名称**：节点在设备树中的位置由路径表示。 - **属性**：节点包含一系列键值对，表示该硬件的具体信息。 6. **标准属性** - **compatible**：标识硬件兼容性，如驱动程序可以匹配的设备ID。 - **model**：描述硬件模型。 - **phandle**：节点的处理程序，用于引用其他节点。 - **status**：表示硬件状态，如启用、禁用等。 - **#address-cells 和 #size-cells**：定义地址和大小的表示方式。 - **reg**：描述硬件在内存或I/O空间的地址范围。 - **virtual-reg**：虚拟地址映射。 - **ranges**：转换物理地址到子节点的地址。 - **dma-ranges**：DMA（直接内存访问）地址范围。 - **dma-coherent** 和 **dma-noncoherent**：标识内存是否适合DMA操作。 - **name**（已弃用）和 **device_type**（已弃用）：以前的属性，现在不推荐使用。 7. **中断和中断映射** - **中断生成设备的属性**：描述产生中断的设备。 - **中断控制器的属性**：定义中断控制器的行为。 - **中断 Nexus 属性**：用于中断连接的节点。 - **中断映射示例**：展示了如何通过设备树描述中断结构。 8. **Nexus 节点和指定器映射** - **Nexus 节点属性**：描述Nexus节点如何处理子节点的指定器。 这份规范详细解释了设备树的构成和工作原理，对于理解和编写设备树源码以及优化Linux内核在特定硬件上的启动和运行至关重要。通过遵循这些规定，开发者可以确保硬件被正确地识别和配置，从而实现更稳定和高效的系统运行。