.. SPDX-License-Identifier: Apache-2.0 .. .. _chapter-introduction: Introduction ============ .. _chapter-introduction: 序 ============ .. Purpose and Scope 目的と範囲 ----------------- .. To initialize and boot a computer system, various software components interact. Firmware might perform low-level initialization of the system hardware before passing control to software such as an operating system, bootloader, or hypervisor. Bootloaders and hypervisors can, in turn, load and transfer control to operating systems. Standard, consistent interfaces and conventions facilitate the interactions between these software components. In this document the term *boot program* is used to generically refer to a software component that initializes the system state and executes another software component referred to as a *client program*. Examples of a boot program include: firmware, bootloaders, and hypervisors. Examples of a client program include: bootloaders, hypervisors, operating systems, and special purpose programs. A piece of software may be both a client program and a boot program (e.g. a hypervisor). コンピュータシステムを初期化して起動するために、さまざまなソフトウェアコンポーネントが相互作用します。 ファームウェアは、オペレーティングシステム、ブートローダー、ハイパーバイザーなどのソフトウェアに制御を渡す前に、システムハードウェアの低レベルの初期化を実行する場合があります。 次に、ブートローダーとハイパーバイザーは、制御をロードしてオペレーティングシステムに転送できます。 標準の一貫したインターフェイスと規則により、これらのソフトウェアコンポーネント間の相互作用が容易になります。 このドキュメントでは、*ブートプログラム* という用語は、システム状態を初期化し、 *クライアントプログラム* と呼ばれる別のソフトウェアコンポーネントを実行するソフトウェアコンポーネントを総称して指すために使用されます。 ブートプログラムの例には、ファームウェア、ブートローダー、ハイパーバイザーが含まれます。 クライアントプログラムの例には、ブートローダー、ハイパーバイザー、オペレーティングシステム、および専用プログラムが含まれます。 ソフトウェアの一部は、クライアントプログラムとブートプログラム（ハイパーバイザーなど）の両方である可能性があります。 .. This specification, the |spec-fullname| (|spec|), provides a complete boot program to client program interface definition, combined with minimum system requirements that facilitate the development of a wide variety of systems. 本仕様書、 |spec-fullname| (|spec|) は、様々なシステムの開発を容易にする最小システム要件と組み合わせて、クライアントプログラムインターフェイス定義への完全なブートプログラムを提供します。 .. This specification is targeted towards the requirements of embedded systems. An embedded system typically consists of system hardware, an operating system, and application software that are custom designed to perform a fixed, specific set of tasks. This is unlike general purpose computers, which are designed to be customized by a user with a variety of software and I/O devices. Other characteristics of embedded systems may include: 本仕様書は、組み込みシステムの要件を対象としています。 組み込みシステムは通常、固定された特定の一連のタスクを実行するようにカスタム設計されたシステムハードウェア、オペレーティングシステム、およびアプリケーションソフトウェアで構成されます。 これは、さまざまなソフトウェアやI/Oデバイスを使用してユーザーがカスタマイズできるように設計された汎用コンピューターとは異なります。 組み込みシステムのその他の特性には、次のものがあります。 .. * a fixed set of I/O devices, possibly highly customized for the application * I/Oデバイスの固定セット、おそらくアプリケーション用に高度にカスタマイズされたもの .. * a system board optimized for size and cost * サイズとコストに最適化されたシステムボード .. * limited user interface * 限られたユーザーインターフェイス .. * resource constraints like limited memory and limited nonvolatile storage * 限られたメモリや限られた不揮発性ストレージなどのリソースの制約 .. * real-time constraints * リアルタイム制約 .. * use of a wide variety of operating systems, including Linux, real-time operating systems, and custom or proprietary operating systems * Linux、リアルタイムオペレーティングシステム、カスタムまたは独自のオペレーティングシステムなど、さまざまなオペレーティングシステムの使用 .. **Organization of this Document** **本文書の構成** .. * :numref:`Chapter %s ` introduces the architecture being specified by |spec|. * :numref:`Chapter %s ` introduces the devicetree concept and describes its logical structure and standard properties. * :numref:`Chapter %s ` specifies the definition of a base set of device nodes required by |spec|-compliant devicetrees. * :numref:`Chapter %s ` describes device bindings for certain classes of devices and specific device types. * :numref:`Chapter %s ` specifies the DTB encoding of devicetrees. * :numref:`Chapter %s ` specifies the DTS source language. * :numref:`第 %s 章 ` では、 |spec| で指定されているアーキテクチャを紹介します。 * :numref:`第 %s 章 ` では、デバイスツリーの概念を紹介し、その論理構造と標準プロパティについて説明しています。 * :numref:`第 %s 章 ` では、 |spec| 準拠のデバイスツリーに必要なデバイスノードの基本セットの定義を指定します。 * :numref:`第 %s 章 ` では、特定のクラスのデバイスおよび特定のデバイスタイプのデバイスバインディングについて説明しています。 * :numref:`第 %s 章 ` では、デバイスツリーのDTBエンコーディングを指定します。 * :numref:`第 %s 章 ` では、DTSソース言語を指定します。 .. **Conventions Used in this Document** **本文書で使用されている規則** .. The word *shall* is used to indicate mandatory requirements strictly to be followed in order to conform to the standard and from which no deviation is permitted (*shall* equals *is required to*). *shall* (するものとする) という言葉は、標準に準拠するために厳密に従う必要があり、そこからの逸脱が許されない必須要件を示すために使用されます (*shall* と *is equals to* は同等です)。 .. The word *should* is used to indicate that among several possibilities one is recommended as particularly suitable, without mentioning or excluding others; or that a certain course of action is preferred but not necessarily required; or that (in the negative form) a certain course of action is deprecated but not prohibited (*should* equals *is recommended that*). *should* (すべきである) という言葉は、他の可能性に言及したり除外したりすることなく、いくつかの可能性の中で特に適切なものとして推奨されることを示すために使用されます。 または、特定の行動方針が望ましいが、必ずしも必要ではないこと。または、（否定形で）特定の一連の行動が推奨されていないが、禁止されていないこと（*should* と *is recommended that* は同等です）。 .. The word *may* is used to indicate a course of action permissible within the limits of the standard (*may* equals *is permitted*). *may* (してもよい) という言葉は、規格の範囲内で許容される一連の行動を示すために使用されます (*may* と *is permitted* は同等です)。 .. Examples of devicetree constructs are frequently shown in *Devicetree Syntax* form. See :numref:`chapter-devicetree-source-format` for an overview of this syntax. デバイスツリー構造の例は、*デバイスツリー構文形式* で頻繁に示されます。 この構文の概要については、 :numref:`chapter-devicetree-source-format` を参照してください。 .. Relationship to IEEE™ 1275 and |epapr| IEEE™ 1275 と |epapr| の関係 -------------------------------------- |spec| is loosely related to the IEEE 1275 Open Firmware standard—\ *IEEE Standard for Boot (Initialization Configuration) Firmware: Core Requirements and Practices* [IEEE1275]_. The original IEEE 1275 specification and its derivatives such as CHRP [CHRP]_ and PAPR [PAPR]_ address problems of general purpose computers, such as how a single version of an operating system can work on several different computers within the same family and the problem of loading an operating system from user-installed I/O devices. Because of the nature of embedded systems, some of these problems faced by open, general purpose computers do not apply. Notable features of the IEEE 1275 specification that are omitted from the |spec| include: * Plug-in device drivers * FCode * The programmable Open Firmware user interface based on Forth * FCode debugging * Operating system debugging What is retained from IEEE 1275 are concepts from the devicetree architecture by which a boot program can describe and communicate system hardware information to a client program, thus eliminating the need for the client program to have hard-coded descriptions of system hardware. This specification partially supersedes the |epapr| [EPAPR]_ specification. |epapr| documents how devicetree is used by the Power ISA, and covers both general concepts, as well as Power ISA specific bindings. The text of this document was derived from |epapr|, but either removes architecture specific bindings, or moves them into an appendix. .. 32-bit and 64-bit Support 32ビットおよび64ビットのサポート ------------------------- .. The |spec| supports CPUs with both 32-bit and 64-bit addressing capabilities. Where applicable, sections of the |spec| describe any requirements or considerations for 32-bit and 64-bit addressing. |spec| は32ビットと64ビットの両方のアドレス指定機能を備えたCPUをサポートします。 該当する場合、 |spec| のセクションは32ビットおよび64ビットアドレス指定の要件または考慮事項について説明します。 .. Definition of Terms 用語定義 ------------------- .. .. glossary:: AMP Asymmetric Multiprocessing. Computer available CPUs are partitioned into groups, each running a distinct operating system image. The CPUs may or may not be identical. boot CPU The first CPU which a boot program directs to a client program’s entry point. Book III-E Embedded Environment. Section of the Power ISA defining supervisor instructions and related facilities used in embedded Power processor implementations. boot program Used to generically refer to a software component that initializes the system state and executes another software component referred to as a client program. Examples of a boot program include: firmware, bootloaders, and hypervisors. client program Program that typically contains application or operating system software. Examples of a client program include: bootloaders, hypervisors, operating systems, and special purpose programs. cell A unit of information consisting of 32 bits. DMA Direct memory access DTB Devicetree blob. Compact binary representation of the devicetree. DTC Devicetree compiler. An open source tool used to create DTB files from DTS files. DTS Devicetree syntax. A textual representation of a devicetree consumed by the DTC. See Appendix A Devicetree Source Format (version 1). effective address Memory address as computed by processor storage access or branch instruction. physical address Address used by the processor to access external device, typically a memory controller. Power ISA Power Instruction Set Architecture. interrupt specifier A property value that describes an interrupt. Typically information that specifies an interrupt number and sensitivity and triggering mechanism is included. secondary CPU CPUs other than the boot CPU that belong to the client program are considered *secondary CPUs*. SMP Symmetric multiprocessing. A computer architecture where two or more identical CPUs can share memory and IO and operate under a single operating system. SoC System on a chip. A single computer chip integrating one or more CPU core as well as number of other peripherals. unit address The part of a node name specifying the node’s address in the address space of the parent node. quiescent CPU A quiescent CPU is in a state where it cannot interfere with the normal operation of other CPUs, nor can its state be affected by the normal operation of other running CPUs, except by an explicit method for enabling or re-enabling the quiescent CPU. .. glossary:: AMP 非対称型マルチプロセッシング。 コンピューターで使用可能なCPUはグループに分割され、それぞれが個別のオペレーティングシステムイメージを実行します。 CPUは同一である場合とそうでない場合があります。 ブートCPU ブートプログラムがクライアントプログラムのエントリポイントに指示する最初のCPU。 Book III-E Embedded Environment. Section of the Power ISA defining supervisor instructions and related facilities used in embedded Power processor implementations. ブートプログラム システム状態を初期化し、クライアントプログラムと呼ばれる別のソフトウェアコンポーネントを実行するソフトウェアコンポーネントを一般的に指すために使用されます。 ブートプログラムの例には、ファームウェア、ブートローダー、およびハイパーバイザーが含まれます。 クライアントプログラム 通常、アプリケーションまたはオペレーティングシステムソフトウェアを含むプログラム。 クライアントプログラムの例としては、ブートローダー、ハイパーバイザー、オペレーティングシステム、専用プログラムなどがあります。 cell 32ビットで構成される情報の単位。 DMA ダイレクトメモリアクセス DTB デバイスツリーブロブ。 デバイスツリーのコンパクトなバイナリ表現。 DTC デバイスツリーコンパイラ。 DTSファイルからDTBファイルを作成するために使用されるオープンソースツール。 DTS デバイスツリー構文。 DTCによって消費されるデバイスツリーのテキスト表現。 付録Aデバイスツリーソースフォーマット（バージョン1）を参照してください。 effective address Memory address as computed by processor storage access or branch instruction. physical address Address used by the processor to access external device, typically a memory controller. Power ISA Power Instruction Set Architecture. interrupt specifier 割り込みを説明するプロパティ値。 通常、割り込み番号と感度、トリガーメカニズムを指定する情報が含まれています。 secondary CPU CPUs other than the boot CPU that belong to the client program are considered *secondary CPUs*. SMP 対称マルチプロセッシング。 2つ以上の同一のCPUがメモリとIOを共有し、単一のオペレーティングシステムで動作できるコンピュータアーキテクチャ。 SoC チップ上のシステム。 1つまたは複数のCPUコアと他の多数の周辺機器を統合する単一のコンピューターチップ。 unit address 親ノードのアドレス空間でノードのアドレスを指定するノード名の部分。 quiescent CPU 静止CPUは、他のCPUの通常の動作に干渉できない状態にあり、静止CPUを有効または再度有効にする明示的な方法を除いて、他の実行中のCPUの通常の動作の影響を受けることもありません。