设备树使用手册(全中文).pdf

设备树使用手册(全 中文) 设设备备树树使使用用手手册册 本文将介绍如何为一个新机器编写设备树。我们准备提供一个有关设备树 念的 述和如何使用这些设备树来描述一个 机器。完整的设备树数据格式的技术说明书请参考 ePAPR 规范。ePAPR 规范涵盖了比本文基本主题更丰富的细节，要查 阅本文没有涉及到的高级用法请参考该规范。 目目录录 11.. 基基本本数数据据格格式式 22.. 基基本本 念念 2.1模型机 2.2初始结构 2.3 中央处理器 2.4 节点名称 2.5 设备 2.6 理解 compatible 属性 33.. 如如何何编编址址 3.1 CPU 编址 3.2 内存映射设备 3.3 非内存映射设备 3.4 范围 （地址转换） 44.. 中中断断的的工工作作方方式式 55.. 设设备备特特定定数数据据 66.. 特特殊殊的的节节点点 6.1 aliases 节点 6.2 chosen 节点 77.. 高高级级主主题题 7.1 高级模型机 7.2 PCI 主桥 7.2.1 PCI 总线编号 7.2.2 PCI 地址转换 7.3 高级中断映射 88.. 附附注注 基基本本数数据据格格式式 设备树是一个包含节点和属性的简单树状结构。属性就是键－值对，而节点可以同时包含属性和子节点。例如，以下就 是一个 .dts 格式的简单树： //{ node1 { a-string-property = A string; a-string-list-property = first string, second string; a-byte-data-property = [0x01 0x23 0x34 0x 6]; child-node1 { first-child-property; second-child-property = 1; a-string-property = Hello, world; }; child-node2 { }; }; node2 { an-empty-property; a-cell-property = 1 2 3 4; /* each number (cell) is a uint32 */ child-node1 { }; }; }; 这棵树显然是没什么用的，因为它并没有描述任何东西，但它确实体现 了节点的一些属性： ■ 一个单独的根节点： “/ ” ■ 两个子节点： “node1”和 “node2” ■ 两个 node1 的子节点： “child-node1”和 “child-node2” ■ 一堆分散在树里的属性。 属性是简单的键－值对，它的值可以为空或者包含一个任意字节流。虽 然数据类型并没有编码进数据结构，但在设备树源文件中仍有几个基本的数据表示形式。 ■ 文本字符串 （无结束符）可以用双引号表示： string-property = a string ■ ‘Cells’是 32 位无符号整数，用尖括号限定： cell-property = 0xbeef 123 0xabcd1234 ■ 二进制数据用方括号限定： binary-property = [0x01 0x23 0x45 0x6 ]; ■ 不同表示形式的数据可以使用逗号连在一起： mixed-property = a string, [0x01 0x23 0x45 0x6 ], 0x123456 8; ■ 逗号也可用于创建字符串列表： string-list = red fish, blue fish;