没有合适的资源?快使用搜索试试~ 我知道了~
首页linux devicetree-specification 2021.pdf
linux devicetree-specification 2021.pdf
需积分: 40 27 下载量 198 浏览量
更新于2023-03-16
评论
收藏 354KB PDF 举报
linux devicetree-specification 2021
资源详情
资源评论
资源推荐
unknown-rev
Devicetree Specification
Release unknown-rev
devicetree.org
13 September 2021
unknown-rev
Contents
1 Introduction 3
1.1 Purpose and Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2 Relationship to IEEE™ 1275 and ePAPR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3 32-bit and 64-bit Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.4 Definition of Terms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2 The Devicetree 6
2.1 Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.2 Devicetree Structure and Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2.1 Node Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
2.2.2 Generic Names Recommendation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2.2.3 Path Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.2.4 Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.3 Standard Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.3.1 compatible . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.3.2 model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.3.3 phandle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.3.4 status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.3.5 #address-cells and #size-cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.3.6 reg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.3.7 virtual-reg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.3.8 ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.3.9 dma-ranges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.3.10 dma-coherent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.3.11 name (deprecated) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.3.12 device_type (deprecated) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.4 Interrupts and Interrupt Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.4.1 Properties for Interrupt Generating Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.4.2 Properties for Interrupt Controllers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.4.3 Interrupt Nexus Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.4.4 Interrupt Mapping Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.5 Nexus Nodes and Specifier Mapping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.5.1 Nexus Node Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.5.2 Specifier Mapping Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
3 Device Node Requirements 26
3.1 Base Device Node Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.2 Root node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.3 /aliases node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.4 /memory node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.4.1 /memory node and UEFI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
i
unknown-rev
3.4.2 /memory Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.5 /reserved-memory Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.5.1 /reserved-memory parent node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.5.2 /reserved-memory/ child nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.5.3 Device node references to reserved memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.5.4 /reserved-memory and UEFI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.5.5 /reserved-memory Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.6 /chosen Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.7 /cpus Node Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.8 /cpus/cpu
*
Node Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.8.1 General Properties of /cpus/cpu
*
nodes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.8.2 TLB Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
3.8.3 Internal (L1) Cache Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
3.8.4 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
3.9 Multi-level and Shared Cache Nodes (/cpus/cpu
*
/l?-cache) . . . . . . . . . . . . . . . . . . . . 40
3.9.1 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
4 Device Bindings 42
4.1 Binding Guidelines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
4.1.1 General Principles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
4.1.2 Miscellaneous Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
4.2 Serial devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
4.2.1 Serial Class Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
4.2.2 National Semiconductor 16450/16550 Compatible UART Requirements . . . . . . . . . . . . . 44
4.3 Network devices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
4.3.1 Network Class Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
4.3.2 Ethernet specific considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
4.4 Power ISA Open PIC Interrupt Controllers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
4.5 simple-bus Compatible Value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
5 Flattened Devicetree (DTB) Format 48
5.1 Versioning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
5.2 Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
5.3 Memory Reservation Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
5.3.1 Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
5.3.2 Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
5.3.3 Memory Reservation Block and UEFI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
5.4 Structure Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
5.4.1 Lexical structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
5.4.2 Tree structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
5.5 Strings Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
5.6 Alignment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
6 Devicetree Source (DTS) Format (version 1) 54
6.1 Compiler directives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
6.2 Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
6.3 Node and property definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
6.4 File layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Bibliography 58
Index 59
ii
unknown-rev
Devicetree Specification, Release unknown-rev
Copyright
Copyright 2008,2011 Power.org, Inc.
Copyright 2008,2011 Freescale Semiconductor, Inc.
Copyright 2008,2011 International Business Machines Corporation.
Copyright 2016,2017 Linaro, Ltd.
Copyright 2016,2017 Arm, Ltd.
The Linaro and devicetree.org word marks and the Linaro and devicetree.org logos and related marks are trademarks and
service marks licensed by Linaro Ltd. Implementation of certain elements of this document may require licenses under
third party intellectual property rights, including without limitation, patent rights. Linaro and its Members are not, and
shall not be held, responsible in any manner for identifying or failing to identify any or all such third party intellectual
property rights.
The Power Architecture and Power.org word marks and the Power and Power.org logos and related marks are trademarks
and service marks licensed by Power.org. Implementation of certain elements of this document may require licenses under
third party intellectual property rights, including without limitation, patent rights. Power.org and its Members are not, and
shall not be held, responsible in any manner for identifying or failing to identify any or all such third party intellectual
property rights.
THIS SPECIFICATION PROVIDED “AS IS” AND WITHOUT ANY WARRANTY OF ANY KIND, INCLUD-
ING, WITHOUT LIMITATION, ANY EXPRESS OR IMPLIED WARRANTY OF NON-INFRINGEMENT, MER-
CHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL LINARO OR ANY MEM-
BER OF LINARO BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, EXEMPLARY, PUNITIVE, OR CON-
SEQUENTIAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
Questions pertaining to this document, or the terms or conditions of its provision, should be addressed to:
Linaro, Ltd
Harston Mill,
Royston Road,
Harston CB22 7GG
Attn: Devicetree.org Board Secretary
License Information
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the
License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS
IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License
for the specific language governing permissions and limitations under the License.
Contents 1
unknown-rev
Devicetree Specification, Release unknown-rev
Acknowledgements
The devicetree.org Technical Steering Committee would like to thank the many individuals and companies that contributed
to the development of this specification through writing, technical discussions and reviews.
We want to thank the power.org Platform Architecture Technical Subcommittee who developed and published ePAPR.
The text of ePAPR was used as the starting point for this document.
Significant aspects of the Devicetree Specification are based on work done by the Open Firmware Working Group which
developed bindings for IEEE-1275. We would like to acknowledge their contributions.
We would also like to acknowledge the contribution of the PowerPC and ARM Linux communities that developed and
implemented the flattened devicetree concept.
Table 1: Revision History
Revision Date Description
0.1 2016-MAY-24 Initial prerelease version. Imported ePAPR text into reStructured Text format and
removed Power ISA specific elements.
0.2 2017-DEC-20
• Added more recommended generic node names
• Added interrupts-extended
• Additional phy times
• Filled out detail in source language chapter
• Editorial changes
• Added changebar version to release documents
0.3 2020-FEB-13
• Added more recommended generic node names
• Document generic nexus binding
• codespell support and spelling fixes
Contents 2
剩余61页未读,继续阅读
kingvon_liwei
- 粉丝: 55
- 资源: 18
上传资源 快速赚钱
- 我的内容管理 收起
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
会员权益专享
最新资源
- RTL8188FU-Linux-v5.7.4.2-36687.20200602.tar(20765).gz
- c++校园超市商品信息管理系统课程设计说明书(含源代码) (2).pdf
- 建筑供配电系统相关课件.pptx
- 企业管理规章制度及管理模式.doc
- vb打开摄像头.doc
- 云计算-可信计算中认证协议改进方案.pdf
- [详细完整版]单片机编程4.ppt
- c语言常用算法.pdf
- c++经典程序代码大全.pdf
- 单片机数字时钟资料.doc
- 11项目管理前沿1.0.pptx
- 基于ssm的“魅力”繁峙宣传网站的设计与实现论文.doc
- 智慧交通综合解决方案.pptx
- 建筑防潮设计-PowerPointPresentati.pptx
- SPC统计过程控制程序.pptx
- SPC统计方法基础知识.pptx
资源上传下载、课程学习等过程中有任何疑问或建议,欢迎提出宝贵意见哦~我们会及时处理!
点击此处反馈
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功
评论0