このページはAIで英語から翻訳されており、誤りが含まれる場合があります。 英語の原文を読む →
目次
仕様devicetree.org

Devicetree Specification

Devicetree Specification

Devicetree Specificationは、ファームウェアがオペレーティングシステムへ渡すツリー状のハードウェア記述を定義し、ドライバが基板上のCPU、メモリ、周辺装置を検出できるようにする。

何であるか

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 に従い、任意プロパティが無い場合は文書化されたデフォルトを適用し、基板の差異はツリーに残す。これにより、同一のソフトウェアビルドが複数のハードウェアバリアントに対応できる。

専門分野との関わり

  • ハードウェア・半導体主要

    ハードウェア技術者はツリーの内容を所掌する。どのデバイスを実装するか、どのようにアドレス指定するか、どの割込み・クロック・ピンを使うかである。基板変更が完了するのは、devicetreeが回路図と一致したときだけである。

  • HPC・アプリケーションソフトウェア主要

    ドライバおよびオペレーティングシステムの技術者は、compatible文字列でノードを照合し、プロパティからアドレス、割込み、クロックを取得する。ブリングアップ作業とは、各ノードが実際に実装された部品を記述していることの確認である。

  • 基本ソフトウェア主要

    アプリケーションプロセッサ上では、ハードウェア抽象化層とドライバ層が起動時にdevicetreeからプラットフォームを把握する。クラシックECUではベーシックソフトウェアのコンフィギュレーションに固定するパラメータが、ここではノードとプロパティとして現れる。

  • E/Eアーキテクチャ関連

    ツリーは基板リビジョンの契約を記録する。メモリマップ、リッチOSから見える周辺装置、予約領域である。アーキテクトはこれを用いてハードウェアバリアントを明示し、一つのソフトウェア系列が各リスピンを追跡できるようにする。

  • 機能安全関連

    アプリケーションプロセッサを担当する安全技術者は、起動されたツリーを実際に動作するコンフィギュレーションの一部として扱う。blob内のウォッチドッグ、メモリ予約、安全関連周辺装置が、セーフティケースの前提とするハードウェアと一致することを確認する。

直接の関与なし: サイバーセキュリティ · ネットワーク・通信 · 診断・ライフサイクル · ソフトウェア更新・OTA