何であるか
Devicetree Specificationは、基板のハードウェアをツリーとして記述する方法を定義する。これによりブートソフトウェアとオペレーティングシステムは、単一のハードコードされた基板ファイルではなくデータから、CPU、メモリ、バス、周辺装置を検出できる。各ノードはコンポーネントを命名し、プログラミングモデルを識別する compatible 文字列、レジスタアドレス、割込みルーティング、クロック、他ノードへの参照(phandle)といったプロパティを持つ。作成者はツリーをソーステキストとして記述してフラットなバイナリblobへコンパイルし、ファームウェアがそのblobをブートチェーン経由で渡す。
このフォーマットは、かつてのPowerPCおよびSPARCシステムにおけるOpen Firmwareの慣行に由来する。現在は、ArmおよびRISC-Vアプリケーションプロセッサにおける通常のハードウェア記述である。本仕様はデータフォーマットと基本セマンティクスを定める。オペレーティングシステムは、そのデータの上に独自のドライバモデルを実装する。
適用対象
本文書が重要となるのは、アプリケーションプロセッサがリッチオペレーティングシステムを実行する高性能コントローラ、すなわちコックピットおよび運転支援コンピュータである。ハードウェア技術者は、シリコンおよび部品実装済み基板の記述を作成する。ブートローダ技術者はblobをカーネルへ運ぶ。ドライバおよびハードウェア抽象化の作成者は、デバイスをプローブするためにノードを利用する。
コンフィギュレーションがAUTOSARベーシックソフトウェアの設定として生成されるマイクロコントローラECUは、別の経路をたどる。ソフトウェアイメージが、起動時に渡されるハードウェア記述に基づいて基板へ適応しなければならない場合に、本仕様を用いる。
対象範囲
基本仕様は形状とエンコーディングを標準化する。個々のデバイス向けバインディングは compatible をキーとし、当該部品が必要とするプロパティを規定するものであり、オペレーティングシステムと併せて、または独立したバインディング集として公開される。
| トピック | 日常業務での役割 |
|---|---|
| ノードとプロパティ | 各CPU、バス、周辺装置を命名し、そのパラメータを付与する |
アドレスと ranges |
デバイスをそのバス上に配置し、それらのアドレスをCPUへ向けて変換する |
| 標準ノード | CPU、メモリ、予約領域、エイリアス、選択されたブートパラメータを記述する |
compatible |
ドライバが照合する安定した文字列を与える |
| バイナリblob | ソーステキストなしで引き渡せるコンパクトな形式をファームウェアに与える |
典型的なソース分割では、SoCを共有インクルードに置き、基板の実装、ピン選択、有効なデバイスを基板ファイルに置く。ブート設計が対応する場合、オーバーレイによってプラグインまたはハードウェアバリアント向けにベースツリーへパッチを当てることができる。
他文書との関係
IEEE 1275は、ツリーモデルの祖先にあたるOpen Firmwareである。Devicetree Specificationは独立して成立するため、組込みブートチェーンは完全なOpen Firmwareクライアントインタフェースなしに、フラット化したblobを渡すことができる。
ブートローダとオペレーティングシステムは、blobの所在と、それが記述する基板の版について合意する。バインディング文書は、ドライバ作成者が実装する対となる仕様である。基本仕様は、ベンダのレジスタレベルのプロパティをそれらのバインディングに委ねる。ACPIはPCに典型的なハードウェア記述の仕組みであり、プラットフォームのブート設計は主たる記述を一つ選ぶ。AUTOSAR ClassicのECUコンフィギュレーションは、マイクロコントローラのベーシックソフトウェアに対するコンフィギュレーション経路のままである。アプリケーションプロセッサ上のPOSIXまたはAdaptive AUTOSARスタックも、ファームウェアが提供したツリーの上で依然として起動する。
実務
回路図と照合してツリーをレビューし、基板リビジョンとともに保管する。誤ったアドレス、入れ替わった割込み、または未実装部品に対して有効化されたノードは、誤ったデバイスにアクセスするか、起動しないドライバを生じさせる。シリコンの記述は安定に保ち、基板ストラップ、実装オプション、ピン配線は基板ファイルに記録する。リスピンで配線が変わるときは、ドライバ内部の特例ではなく、新しいblobまたはレビュー済みオーバーレイを出荷する。
ラボ基板、開発イメージ、量産イメージについて、一つのblobに合意する。ドライバコードは compatible に従い、任意プロパティが無い場合は文書化されたデフォルトを適用し、基板の差異はツリーに残す。これにより、同一のソフトウェアビルドが複数のハードウェアバリアントに対応できる。