1 SPDX-License-Identifier: GPL-2.0
3 Chinese translated version of Documentation/arch/arm64/booting.rst
5 If you have any comment or update to the content, please contact the
6 original document maintainer directly. However, if you have a problem
7 communicating in English you can also ask the Chinese maintainer for
8 help. Contact the Chinese maintainer if this translation is outdated
9 or if there is a problem with the translation.
11 M: Will Deacon <will.deacon@arm.com>
12 zh_CN: Fu Wei <wefu@redhat.com>
13 zh_TW: Hu Haowen <src.res.211@gmail.com>
14 C: 55f058e7574c3615dea4615573a19bdb258696c6
15 ---------------------------------------------------------------------
16 Documentation/arch/arm64/booting.rst 的中文翻譯
18 如果想評論或更新本文的內容,請直接聯繫原文檔的維護者。如果你使用英文
19 交流有困難的話,也可以向中文版維護者求助。如果本翻譯更新不及時或者翻
22 英文版維護者: Will Deacon <will.deacon@arm.com>
23 中文版維護者: 傅煒 Fu Wei <wefu@redhat.com>
24 中文版翻譯者: 傅煒 Fu Wei <wefu@redhat.com>
25 中文版校譯者: 傅煒 Fu Wei <wefu@redhat.com>
26 繁體中文版校譯者: 胡皓文 Hu Haowen <src.res.211@gmail.com>
27 本文翻譯提交時的 Git 檢出點爲: 55f058e7574c3615dea4615573a19bdb258696c6
30 ---------------------------------------------------------------------
34 作者: Will Deacon <will.deacon@arm.com>
37 本文檔基於 Russell King 的 ARM 啓動文檔,且適用於所有公開發布的
40 AArch64 異常模型由多個異常級(EL0 - EL3)組成,對於 EL0 和 EL1 異常級
41 有對應的安全和非安全模式。EL2 是系統管理級,且僅存在於非安全模式下。
42 EL3 是最高特權級,且僅存在於安全模式下。
44 基於本文檔的目的,我們將簡單地使用‘引導裝載程序’(‘boot loader’)
45 這個術語來定義在將控制權交給 Linux 內核前 CPU 上執行的所有軟件。
46 這可能包含安全監控和系統管理代碼,或者它可能只是一些用於準備最小啓動
49 基本上,引導裝載程序(至少)應實現以下操作:
62 引導裝載程序應該找到並初始化系統中所有內核用於保持系統變量數據的 RAM。
63 這個操作的執行方式因設備而異。(它可能使用內部算法來自動定位和計算所有
64 RAM,或可能使用對這個設備已知的 RAM 信息,還可能是引導裝載程序設計者
73 設備樹數據塊(dtb)必須 8 字節對齊,且大小不能超過 2MB。由於設備樹
74 數據塊將在使能緩存的情況下以 2MB 粒度被映射,故其不能被置於必須以特定
77 注: v4.2 之前的版本同時要求設備樹數據塊被置於從內核映像以下
78 text_offset 字節處算起第一個 512MB 內。
85 AArch64 內核當前沒有提供自解壓代碼,因此如果使用了壓縮內核映像文件
86 (比如 Image.gz),則需要通過引導裝載程序(使用 gzip 等)來進行解壓。
87 若引導裝載程序沒有實現這個功能,就要使用非壓縮內核映像文件。
95 已解壓的內核映像包含一個 64 字節的頭,內容如下:
97 u32 code0; /* 可執行代碼 */
98 u32 code1; /* 可執行代碼 */
99 u64 text_offset; /* 映像裝載偏移,小端模式 */
100 u64 image_size; /* 映像實際大小, 小端模式 */
101 u64 flags; /* 內核旗標, 小端模式 *
102 u64 res2 = 0; /* 保留 */
103 u64 res3 = 0; /* 保留 */
104 u64 res4 = 0; /* 保留 */
105 u32 magic = 0x644d5241; /* 魔數, 小端, "ARM\x64" */
106 u32 res5; /* 保留 (用於 PE COFF 偏移) */
111 - 自 v3.17 起,除非另有說明,所有域都是小端模式。
113 - code0/code1 負責跳轉到 stext.
115 - 當通過 EFI 啓動時, 最初 code0/code1 被跳過。
116 res5 是到 PE 文件頭的偏移,而 PE 文件頭含有 EFI 的啓動入口點
117 (efi_stub_entry)。當 stub 代碼完成了它的使命,它會跳轉到 code0
120 - v3.17 之前,未明確指定 text_offset 的字節序。此時,image_size 爲零,
121 且 text_offset 依照內核字節序爲 0x80000。
122 當 image_size 非零,text_offset 爲小端模式且是有效值,應被引導加載
123 程序使用。當 image_size 爲零,text_offset 可假定爲 0x80000。
125 - flags 域 (v3.17 引入) 爲 64 位小端模式,其編碼如下:
126 位 0: 內核字節序。 1 表示大端模式,0 表示小端模式。
133 0 - 2MB 對齊基址應儘量靠近內存起始處,因爲
135 1 - 2MB 對齊基址可以在物理內存的任意位置
138 - 當 image_size 爲零時,引導裝載程序應試圖在內核映像末尾之後儘可能
139 多地保留空閒內存供內核直接使用。對內存空間的需求量因所選定的內核
142 內核映像必須被放置在任意一個可用系統內存 2MB 對齊基址的 text_offset
143 字節處,並從該處被調用。2MB 對齊基址和內核映像起始地址之間的區域對於
144 內核來說沒有特殊意義,且可能被用於其他目的。
145 從映像起始地址算起,最少必須準備 image_size 字節的空閒內存供內核使用。
146 注: v4.6 之前的版本無法使用內核映像物理偏移以下的內存,所以當時建議
149 任何提供給內核的內存(甚至在映像起始地址之前),若未從內核中標記爲保留
150 (如在設備樹(dtb)的 memreserve 區域),都將被認爲對內核是可用。
154 - 停止所有 DMA 設備,這樣內存數據就不會因爲虛假網絡包或磁盤數據而
158 x0 = 系統 RAM 中設備樹數據塊(dtb)的物理地址。
164 所有形式的中斷必須在 PSTATE.DAIF 中被屏蔽(Debug、SError、IRQ
166 CPU 必須處於 EL2(推薦,可訪問虛擬化擴展)或非安全 EL1 模式下。
171 已載入的內核映像的相應內存區必須被清理,以達到緩存一致性點(PoC)。
172 當存在系統緩存或其他使能緩存的一致性主控器時,通常需使用虛擬地址
174 遵從通過虛擬地址操作維護構架緩存的系統緩存必須被配置,並可以被使能。
175 而不通過虛擬地址操作維護構架緩存的系統緩存(不推薦),必須被配置且
178 *譯者注:對於 PoC 以及緩存相關內容,請參考 ARMv8 構架參考手冊
182 CNTFRQ 必須設定爲計時器的頻率,且 CNTVOFF 必須設定爲對所有 CPU
183 都一致的值。如果在 EL1 模式下進入內核,則 CNTHCTL_EL2 中的
184 EL1PCTEN (bit 0) 必須置位。
187 通過內核啓動的所有 CPU 在內核入口地址上必須處於相同的一致性域中。
188 這可能要根據具體實現來定義初始化過程,以使能每個CPU上對維護操作的
192 在進入內核映像的異常級中,所有構架中可寫的系統寄存器必須通過軟件
193 在一個更高的異常級別下初始化,以防止在 未知 狀態下運行。
195 對於擁有 GICv3 中斷控制器並以 v3 模式運行的系統:
197 ICC_SRE_EL3.Enable (位 3) 必須初始化爲 0b1。
198 ICC_SRE_EL3.SRE (位 0) 必須初始化爲 0b1。
200 ICC_SRE_EL2.Enable (位 3) 必須初始化爲 0b1。
201 ICC_SRE_EL2.SRE (位 0) 必須初始化爲 0b1。
202 - 設備樹(DT)或 ACPI 表必須描述一個 GICv3 中斷控制器。
204 對於擁有 GICv3 中斷控制器並以兼容(v2)模式運行的系統:
206 ICC_SRE_EL3.SRE (位 0) 必須初始化爲 0b0。
208 ICC_SRE_EL2.SRE (位 0) 必須初始化爲 0b0。
209 - 設備樹(DT)或 ACPI 表必須描述一個 GICv2 中斷控制器。
211 以上對於 CPU 模式、高速緩存、MMU、架構計時器、一致性、系統寄存器的
212 必要條件描述適用於所有 CPU。所有 CPU 必須在同一異常級別跳入內核。
214 引導裝載程序必須在每個 CPU 處於以下狀態時跳入內核入口:
216 - 主 CPU 必須直接跳入內核映像的第一條指令。通過此 CPU 傳遞的設備樹
217 數據塊必須在每個 CPU 節點中包含一個 ‘enable-method’ 屬性,所
218 支持的 enable-method 請見下文。
220 引導裝載程序必須生成這些設備樹屬性,並在跳入內核入口之前將其插入
223 - enable-method 爲 “spin-table” 的 CPU 必須在它們的 CPU
224 節點中包含一個 ‘cpu-release-addr’ 屬性。這個屬性標識了一個
227 這些 CPU 必須在內存保留區(通過設備樹中的 /memreserve/ 域傳遞
228 給內核)中自旋於內核之外,輪詢它們的 cpu-release-addr 位置(必須
229 包含在保留區中)。可通過插入 wfe 指令來降低忙循環開銷,而主 CPU 將
230 發出 sev 指令。當對 cpu-release-addr 所指位置的讀取操作返回非零值
231 時,CPU 必須跳入此值所指向的地址。此值爲一個單獨的 64 位小端值,
232 因此 CPU 須在跳轉前將所讀取的值轉換爲其本身的端模式。
234 - enable-method 爲 “psci” 的 CPU 保持在內核外(比如,在
235 memory 節點中描述爲內核空間的內存區外,或在通過設備樹 /memreserve/
236 域中描述爲內核保留區的空間中)。內核將會發起在 ARM 文檔(編號
237 ARM DEN 0022A:用於 ARM 上的電源狀態協調接口系統軟件)中描述的
238 CPU_ON 調用來將 CPU 帶入內核。
240 *譯者注: ARM DEN 0022A 已更新到 ARM DEN 0022C。
242 設備樹必須包含一個 ‘psci’ 節點,請參考以下文檔:
243 Documentation/devicetree/bindings/arm/psci.yaml