1SPDX-License-Identifier: GPL-2.0 2 3Chinese translated version of Documentation/arch/arm64/booting.rst 4 5If you have any comment or update to the content, please contact the 6original document maintainer directly. However, if you have a problem 7communicating in English you can also ask the Chinese maintainer for 8help. Contact the Chinese maintainer if this translation is outdated 9or if there is a problem with the translation. 10 11M: Will Deacon <will.deacon@arm.com> 12zh_CN: Fu Wei <wefu@redhat.com> 13zh_TW: Hu Haowen <2023002089@link.tyut.edu.cn> 14C: 55f058e7574c3615dea4615573a19bdb258696c6 15--------------------------------------------------------------------- 16Documentation/arch/arm64/booting.rst 的中文翻譯 17 18如果想評論或更新本文的內容，請直接聯繫原文檔的維護者。如果你使用英文 19交流有困難的話，也可以向中文版維護者求助。如果本翻譯更新不及時或者翻 20譯存在問題，請聯繫中文版維護者。 21 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 <2023002089@link.tyut.edu.cn> 27本文翻譯提交時的 Git 檢出點爲： 55f058e7574c3615dea4615573a19bdb258696c6 28 29以下爲正文 30--------------------------------------------------------------------- 31 啓動 AArch64 Linux 32 ================== 33 34作者: Will Deacon <will.deacon@arm.com> 35日期: 2012 年 09 月 07 日 36 37本文檔基於 Russell King 的 ARM 啓動文檔，且適用於所有公開發布的 38AArch64 Linux 內核代碼。 39 40AArch64 異常模型由多個異常級（EL0 - EL3）組成，對於 EL0 和 EL1 異常級 41有對應的安全和非安全模式。EL2 是系統管理級，且僅存在於非安全模式下。 42EL3 是最高特權級，且僅存在於安全模式下。 43 44基於本文檔的目的，我們將簡單地使用‘引導裝載程序’（‘boot loader’） 45這個術語來定義在將控制權交給 Linux 內核前 CPU 上執行的所有軟件。 46這可能包含安全監控和系統管理代碼，或者它可能只是一些用於準備最小啓動 47環境的指令。 48 49基本上，引導裝載程序（至少）應實現以下操作： 50 511、設置和初始化 RAM 522、設置設備樹數據 533、解壓內核映像 544、調用內核映像 55 56 571、設置和初始化 RAM 58----------------- 59 60必要性: 強制 61 62引導裝載程序應該找到並初始化系統中所有內核用於保持系統變量數據的 RAM。 63這個操作的執行方式因設備而異。（它可能使用內部算法來自動定位和計算所有 64RAM，或可能使用對這個設備已知的 RAM 信息，還可能是引導裝載程序設計者 65想到的任何合適的方法。） 66 67 682、設置設備樹數據 69--------------- 70 71必要性: 強制 72 73設備樹數據塊（dtb）必須 8 字節對齊，且大小不能超過 2MB。由於設備樹 74數據塊將在使能緩存的情況下以 2MB 粒度被映射，故其不能被置於必須以特定 75屬性映射的2M區域內。 76 77注： v4.2 之前的版本同時要求設備樹數據塊被置於從內核映像以下 78text_offset 字節處算起第一個 512MB 內。 79 803、解壓內核映像 81------------- 82 83必要性: 可選 84 85AArch64 內核當前沒有提供自解壓代碼，因此如果使用了壓縮內核映像文件 86（比如 Image.gz），則需要通過引導裝載程序（使用 gzip 等）來進行解壓。 87若引導裝載程序沒有實現這個功能，就要使用非壓縮內核映像文件。 88 89 904、調用內核映像 91------------- 92 93必要性: 強制 94 95已解壓的內核映像包含一個 64 字節的頭，內容如下： 96 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 偏移） */ 107 108 109映像頭註釋： 110 111- 自 v3.17 起，除非另有說明，所有域都是小端模式。 112 113- code0/code1 負責跳轉到 stext. 114 115- 當通過 EFI 啓動時， 最初 code0/code1 被跳過。 116 res5 是到 PE 文件頭的偏移，而 PE 文件頭含有 EFI 的啓動入口點 117 （efi_stub_entry）。當 stub 代碼完成了它的使命，它會跳轉到 code0 118 繼續正常的啓動流程。 119 120- v3.17 之前，未明確指定 text_offset 的字節序。此時，image_size 爲零， 121 且 text_offset 依照內核字節序爲 0x80000。 122 當 image_size 非零，text_offset 爲小端模式且是有效值，應被引導加載 123 程序使用。當 image_size 爲零，text_offset 可假定爲 0x80000。 124 125- flags 域 (v3.17 引入) 爲 64 位小端模式，其編碼如下： 126 位 0: 內核字節序。 1 表示大端模式，0 表示小端模式。 127 位 1-2: 內核頁大小。 128 0 - 未指定。 129 1 - 4K 130 2 - 16K 131 3 - 64K 132 位 3: 內核物理位置 133 0 - 2MB 對齊基址應儘量靠近內存起始處，因爲 134 其基址以下的內存無法通過線性映射訪問 135 1 - 2MB 對齊基址可以在物理內存的任意位置 136 位 4-63: 保留。 137 138- 當 image_size 爲零時，引導裝載程序應試圖在內核映像末尾之後儘可能 139 多地保留空閒內存供內核直接使用。對內存空間的需求量因所選定的內核 140 特性而異, 並無實際限制。 141 142內核映像必須被放置在任意一個可用系統內存 2MB 對齊基址的 text_offset 143字節處，並從該處被調用。2MB 對齊基址和內核映像起始地址之間的區域對於 144內核來說沒有特殊意義，且可能被用於其他目的。 145從映像起始地址算起，最少必須準備 image_size 字節的空閒內存供內核使用。 146注： v4.6 之前的版本無法使用內核映像物理偏移以下的內存，所以當時建議 147將映像儘量放置在靠近系統內存起始的地方。 148 149任何提供給內核的內存（甚至在映像起始地址之前），若未從內核中標記爲保留 150(如在設備樹（dtb）的 memreserve 區域），都將被認爲對內核是可用。 151 152在跳轉入內核前，必須符合以下狀態： 153 154- 停止所有 DMA 設備，這樣內存數據就不會因爲虛假網絡包或磁盤數據而 155 被破壞。這可能可以節省你許多的調試時間。 156 157- 主 CPU 通用寄存器設置 158 x0 = 系統 RAM 中設備樹數據塊（dtb）的物理地址。 159 x1 = 0 (保留，將來可能使用) 160 x2 = 0 (保留，將來可能使用) 161 x3 = 0 (保留，將來可能使用) 162 163- CPU 模式 164 所有形式的中斷必須在 PSTATE.DAIF 中被屏蔽（Debug、SError、IRQ 165 和 FIQ）。 166 CPU 必須處於 EL2（推薦，可訪問虛擬化擴展）或非安全 EL1 模式下。 167 168- 高速緩存、MMU 169 MMU 必須關閉。 170 指令緩存開啓或關閉皆可。 171 已載入的內核映像的相應內存區必須被清理，以達到緩存一致性點（PoC）。 172 當存在系統緩存或其他使能緩存的一致性主控器時，通常需使用虛擬地址 173 維護其緩存，而非 set/way 操作。 174 遵從通過虛擬地址操作維護構架緩存的系統緩存必須被配置，並可以被使能。 175 而不通過虛擬地址操作維護構架緩存的系統緩存（不推薦），必須被配置且 176 禁用。 177 178 *譯者注：對於 PoC 以及緩存相關內容，請參考 ARMv8 構架參考手冊 179 ARM DDI 0487A 180 181- 架構計時器 182 CNTFRQ 必須設定爲計時器的頻率，且 CNTVOFF 必須設定爲對所有 CPU 183 都一致的值。如果在 EL1 模式下進入內核，則 CNTHCTL_EL2 中的 184 EL1PCTEN (bit 0) 必須置位。 185 186- 一致性 187 通過內核啓動的所有 CPU 在內核入口地址上必須處於相同的一致性域中。 188 這可能要根據具體實現來定義初始化過程，以使能每個CPU上對維護操作的 189 接收。 190 191- 系統寄存器 192 在進入內核映像的異常級中，所有構架中可寫的系統寄存器必須通過軟件 193 在一個更高的異常級別下初始化，以防止在 未知 狀態下運行。 194 195 對於擁有 GICv3 中斷控制器並以 v3 模式運行的系統： 196 - 如果 EL3 存在： 197 ICC_SRE_EL3.Enable (位 3) 必須初始化爲 0b1。 198 ICC_SRE_EL3.SRE (位 0) 必須初始化爲 0b1。 199 - 若內核運行在 EL1： 200 ICC_SRE_EL2.Enable (位 3) 必須初始化爲 0b1。 201 ICC_SRE_EL2.SRE (位 0) 必須初始化爲 0b1。 202 - 設備樹（DT）或 ACPI 表必須描述一個 GICv3 中斷控制器。 203 204 對於擁有 GICv3 中斷控制器並以兼容（v2）模式運行的系統： 205 - 如果 EL3 存在： 206 ICC_SRE_EL3.SRE (位 0) 必須初始化爲 0b0。 207 - 若內核運行在 EL1： 208 ICC_SRE_EL2.SRE (位 0) 必須初始化爲 0b0。 209 - 設備樹（DT）或 ACPI 表必須描述一個 GICv2 中斷控制器。 210 211以上對於 CPU 模式、高速緩存、MMU、架構計時器、一致性、系統寄存器的 212必要條件描述適用於所有 CPU。所有 CPU 必須在同一異常級別跳入內核。 213 214引導裝載程序必須在每個 CPU 處於以下狀態時跳入內核入口： 215 216- 主 CPU 必須直接跳入內核映像的第一條指令。通過此 CPU 傳遞的設備樹 217 數據塊必須在每個 CPU 節點中包含一個 ‘enable-method’ 屬性，所 218 支持的 enable-method 請見下文。 219 220 引導裝載程序必須生成這些設備樹屬性，並在跳入內核入口之前將其插入 221 數據塊。 222 223- enable-method 爲 “spin-table” 的 CPU 必須在它們的 CPU 224 節點中包含一個 ‘cpu-release-addr’ 屬性。這個屬性標識了一個 225 64 位自然對齊且初始化爲零的內存位置。 226 227 這些 CPU 必須在內存保留區（通過設備樹中的 /memreserve/ 域傳遞 228 給內核）中自旋於內核之外，輪詢它們的 cpu-release-addr 位置（必須 229 包含在保留區中）。可通過插入 wfe 指令來降低忙循環開銷，而主 CPU 將 230 發出 sev 指令。當對 cpu-release-addr 所指位置的讀取操作返回非零值 231 時，CPU 必須跳入此值所指向的地址。此值爲一個單獨的 64 位小端值， 232 因此 CPU 須在跳轉前將所讀取的值轉換爲其本身的端模式。 233 234- enable-method 爲 “psci” 的 CPU 保持在內核外（比如，在 235 memory 節點中描述爲內核空間的內存區外，或在通過設備樹 /memreserve/ 236 域中描述爲內核保留區的空間中）。內核將會發起在 ARM 文檔（編號 237 ARM DEN 0022A：用於 ARM 上的電源狀態協調接口系統軟件）中描述的 238 CPU_ON 調用來將 CPU 帶入內核。 239 240 *譯者注: ARM DEN 0022A 已更新到 ARM DEN 0022C。 241 242 設備樹必須包含一個 ‘psci’ 節點，請參考以下文檔： 243 Documentation/devicetree/bindings/arm/psci.yaml 244 245 246- 輔助 CPU 通用寄存器設置 247 x0 = 0 (保留，將來可能使用) 248 x1 = 0 (保留，將來可能使用) 249 x2 = 0 (保留，將來可能使用) 250 x3 = 0 (保留，將來可能使用) 251 252