{
 "byKey": {
  "cover": [
   {"say": "大家好,歡迎回到嵌入式 Linux 課。這一章的主角是 bootloader。我們會認識最常見的 U Boot,學會它的常用指令和環境變數,然後進入非常重要的主題,裝置樹,也就是 device tree。", "item": 0}
  ],
  "U-Boot 的角色與啟動流程#1": [
   {"say": "先來想一下,bootloader 到底在做什麼?", "item": 0},
   {"say": "板子上電之後,Linux kernel 並不會自己跑起來。要先有一段小程式,把硬體帶到 kernel 可以接手的狀態。", "item": 1},
   {"say": "它要設定時脈和記憶體、初始化序列埠和儲存裝置,再把 kernel 映像檔和裝置樹,從 S D 卡、e M M C、網路或 U S B 搬進記憶體,最後跳到 kernel 的進入點。這段程式就是 bootloader。", "item": 1},
   {"say": "在嵌入式 ARM 的世界裡,最普及的開源 bootloader 就是 U Boot,全名是 Universal Bootloader。", "item": 1}
  ],
  "U-Boot 的角色與啟動流程#2": [
   {"say": "U Boot 有哪些主要功能呢?", "item": 0},
   {"say": "第一,它提供命令列,透過序列主控台,你可以手動查看記憶體、讀寫儲存裝置、設定環境變數。", "item": 1},
   {"say": "第二,它支援很多種開機來源,像是 S D 卡和 e M M C、U S B、網路上的 T F T P 和 N F S,還有 S P I Flash 和 NAND。", "item": 2},
   {"say": "第三,它支援多種映像檔格式,包括沒有包裝的 Image、Z Image、U Image,還有 FIT image。FIT image 可以把好幾個 kernel、D T B 和簽章包在一起。", "item": 3}
  ],
  "U-Boot 的角色與啟動流程#3": [
   {"say": "還有兩項功能。", "item": 0},
   {"say": "第四是環境變數,用來儲存開機的行為,最重要的兩個是 boot C M D 和 boot args,等一下會詳細說明。", "item": 1},
   {"say": "第五,它可以做 secure boot 的驗證,靠的是 FIT image 的簽章,實際怎麼設定要看平台。", "item": 2}
  ],
  "U-Boot 的角色與啟動流程#4": [
   {"say": "U Boot 自己的啟動,也分成幾個階段。", "item": 0},
   {"say": "第一是 S P L。因為 Boot ROM 能載入的容量有限,所以先載入很小的 S P L,由它初始化記憶體,再載入完整的 U Boot。", "item": 1},
   {"say": "第二是 U Boot 本體,它會初始化周邊,印出版本和板子的資訊。", "item": 2},
   {"say": "第三是 autoboot 倒數。畫面會顯示按任意鍵停止自動開機,後面有一個秒數。在倒數結束前按下任意鍵,就會中斷開機,進入 U Boot 的命令列提示。", "item": 3},
   {"say": "第四,如果你沒有按鍵,倒數結束之後,U Boot 就會執行 boot C M D 這個環境變數的內容。它通常是一串指令:載入 kernel、載入 D T B、設定 boot args,然後啟動。", "item": 4}
  ],
  "U-Boot 的角色與啟動流程#5": [
   {"say": "用一行來總結這個流程。", "item": 0},
   {"say": "先是可有可無的 S P L,接著是 U Boot 本體,然後倒數 autoboot,執行 boot C M D,載入 kernel,最後跳轉過去。跳過去之後,U Boot 的任務就結束了。", "item": 1}
  ],
  "U-Boot 的角色與啟動流程#6": [
   {"say": "剛剛一直提到 boot C M D 和 boot args,這兩個名字很像,一定要分清楚。", "item": 0},
   {"say": "boot C M D 是 U Boot 自己要執行的指令序列。", "item": 1},
   {"say": "boot args 則是 U Boot 要傳給 kernel 的命令列字串,裡面就是上一章看過的 console、root 這些參數。", "item": 2},
   {"say": "要注意,很多新的板子改用 distro boot 的機制。這時候 boot C M D 只是去自動掃描分區裡的 extlinux 點 conf 或是開機腳本,kernel 的路徑和參數是寫在 extlinux 點 conf 裡面。", "item": 2},
   {"say": "實際的行為會因為板子和 U Boot 版本而不同,要以 print env 的結果和板子的文件為準。", "item": 2}
  ],
  "U-Boot 的角色與啟動流程#7": [
   {"say": "我們看一個簡化的例子。", "item": 0},
   {"say": "第一行用 set env 設定 boot args,內容是主控台、根檔案系統的位置,還有 root wait 和可讀寫。", "item": 1},
   {"say": "第二行設定 boot C M D,裡面有三個動作,用分號隔開:先從記憶卡的第一個分區把 kernel 映像檔載入記憶體,再載入 D T B,最後用 boot I 指令,帶著這兩個位址啟動。", "item": 2},
   {"say": "下面則是典型的 extlinux 設定檔的開頭。它會設定預設的項目和等待時間,再用一個 label 寫明 kernel 檔案、裝置樹檔案,還有要附加的 kernel 命令列。", "item": 3}
  ],
  "U-Boot 常用指令與環境變數#1": [
   {"say": "接下來,我們實際進到 U Boot 的命令列裡操作。", "item": 0},
   {"say": "開機的時候,在自動開機倒數結束前按任意鍵,看到提示符號,通常是一個等號加大於符號,就進入 U Boot 的 shell 了。輸入 help 可以列出所有指令,help 後面接指令名稱,可以看單一指令的用法。", "item": 1},
   {"say": "環境變數主要用 set env 來操作。Set env 後面接名稱和值,就是設定。如果只給名稱不給值,就是把這個變數刪掉。", "item": 2},
   {"say": "如果值裡面有空白或分號,要用單引號包起來。", "item": 3},
   {"say": "要引用變數的時候,寫錢字號加大括號,裡面放變數名稱。", "item": 4},
   {"say": "還有一個 run 指令,後面接變數名稱,會把那個變數的內容當成指令腳本來執行。例如 run boot C M D,就等於手動開機。", "item": 5}
  ],
  "U-Boot 常用指令與環境變數#2": [
   {"say": "我們來看環境變數的實際操作。", "item": 0},
   {"say": "print env 什麼都不接,會列出全部的環境變數。", "item": 1},
   {"say": "後面接變數名稱,例如 boot args,就只看那一個。", "item": 2},
   {"say": "這一行是用 set env 設定 boot args,因為值裡面有空白,所以用單引號包起來。", "item": 3},
   {"say": "這一行設定 server I P,也就是伺服器的 I P 位址。", "item": 4},
   {"say": "這一行設定 I P addr,是板子自己的 I P 位址。", "item": 5}
  ],
  "U-Boot 常用指令與環境變數#3": [
   {"say": "還有三個指令。", "item": 0},
   {"say": "save env 會把環境變數寫入永久儲存,前提是平台有支援。要特別注意,set env 只改記憶體裡的環境,不做 save env 的話,重開機就不見了。不過有時候,這正好是你想要的測試方式。", "item": 1},
   {"say": "edit env 可以互動式地編輯一個變數,不用整串重打。", "item": 2},
   {"say": "env default 加上減號 A,會把整個環境重設成預設值。之後可以再 save env 把它存起來。", "item": 3}
  ],
  "U-Boot 常用指令與環境變數#4": [
   {"say": "再來是查看硬體和儲存裝置的指令,等一下會一個一個看。", "item": 0},
   {"say": "先講一個表示法。M M C 零冒號一,意思是裝置編號零的第一個分區,這是 U Boot 裡面很常見的寫法。", "item": 1}
  ],
  "U-Boot 常用指令與環境變數#5": [
   {"say": "我們來看這些指令。", "item": 0},
   {"say": "B D info 會顯示板子的資訊,像是記憶體的範圍、環境變數存放的位置。", "item": 1},
   {"say": "M M C list 列出所有的 M M C 控制器。", "item": 2},
   {"say": "M M C dev 零,是選擇第零個 M M C 裝置。", "item": 3},
   {"say": "M M C part 會列出目前這個裝置的分區。", "item": 4},
   {"say": "L S 後面接 M M C 零冒號一,再接一個斜線,就是列出第零個裝置、第一個分區的根目錄。檔案系統的類型它會自動判斷。", "item": 5}
  ],
  "U-Boot 常用指令與環境變數#6": [
   {"say": "另外還有這幾個。", "item": 0},
   {"say": "fat L S 專門用來列出 FAT 分區的內容。", "item": 1},
   {"say": "E X T 四 L S 用來列出 E X T 四分區,例如第二個分區裡 boot 目錄的內容。", "item": 2},
   {"say": "U S B start 是初始化 U S B,如果板子有 U S B 的話。", "item": 3}
  ],
  "U-Boot 常用指令與環境變數#7": [
   {"say": "看得到檔案之後,下一步就是把檔案載入到記憶體。", "item": 0},
   {"say": "載入成功的時候,它會顯示讀了多少個位元組、花了多少毫秒,畫面上的數字只是示意。載入之後,U Boot 還會把檔案大小存在 file size 這個變數裡。", "item": 1},
   {"say": "第一個指令 fat load,從 FAT 分區把 kernel 映像檔,載入到 kernel 的載入位址。", "item": 2},
   {"say": "第二個 E X T 四 load,從 E X T 四分區把 D T B 載入到裝置樹的載入位址。", "item": 3},
   {"say": "第三個是 load,比較新的版本才有,它會自動判斷檔案系統,用起來最方便。", "item": 4}
  ],
  "裝置樹(Device Tree)語法與概念#1": [
   {"say": "好,接下來進入這一章的第二個主題,裝置樹。先問一個問題:為什麼需要它?", "item": 0},
   {"say": "在 P C 上,P C I、U S B、A C P I 可以讓系統自動發現硬體。但是 ARM 板子上的周邊,例如 U A R T 在哪個位址、中斷是幾號、L E D 接在哪一支腳,是沒辦法自動探測的。", "item": 1},
   {"say": "早期的 Linux 把這些資訊用 C 程式碼寫死在每塊板子的檔案裡,結果核心充滿重複的程式碼。後來改用裝置樹:用一份資料結構來描述硬體,由 bootloader 交給 kernel,kernel 再依照內容建立裝置、載入對應的驅動。", "item": 1},
   {"say": "這樣的好處是,同一份 kernel 可以支援很多塊板子,只要換 D T B 就好。", "item": 1},
   {"say": "裝置樹有幾種檔案類型,下一張會介紹。而把原始檔編譯成二進位檔的編譯器,叫做 D T C,就是 Device Tree Compiler。", "item": 2}
  ],
  "裝置樹(Device Tree)語法與概念#2": [
   {"say": "裝置樹相關的檔案,有四種副檔名。", "item": 0},
   {"say": "點 D T S 是裝置樹的原始檔,是某一塊板子的完整描述,是純文字。", "item": 1},
   {"say": "點 D T S I 多了一個 I,代表 include。它放的是 S o C 共用的部分,會被板子的 D T S 檔引入。", "item": 2},
   {"say": "點 D T B 是 D T C 編譯之後的二進位檔,真正交給 kernel 的就是它。", "item": 3}
  ],
  "裝置樹(Device Tree)語法與概念#3": [
   {"say": "還有第四種。", "item": 0},
   {"say": "點 D T B O 是 overlay,是可以在開機時疊加上去的片段。這一章的最後會介紹它。", "item": 1}
  ],
  "裝置樹(Device Tree)語法與概念#4": [
   {"say": "我們來看裝置樹的基本語法,有四個要點。", "item": 0},
   {"say": "第一,它是樹狀結構。最上面是根節點,用一個斜線表示,底下是一層一層的子節點。每個節點的寫法是:名稱、小老鼠符號、單元位址,後面用大括號把屬性包起來。", "item": 1},
   {"say": "第二,屬性的寫法是名稱等於值,最後加分號。值可以是雙引號包起來的字串、角括號包起來的三十二位元整數,或是中括號包起來的位元組陣列。", "item": 2},
   {"say": "第三,節點名稱裡小老鼠後面的單元位址,通常就是 reg 屬性的第一個位址,用十六進位寫,而且前面不加零 X。", "item": 3},
   {"say": "第四是標籤,寫在節點名稱前面,後面加冒號。有了標籤,其他地方就可以用 and 符號加上標籤名稱來引用這個節點。", "item": 4}
  ],
  "裝置樹(Device Tree)語法與概念#5": [
   {"say": "對照一個實際的範例來看。", "item": 0},
   {"say": "檔案的第一行是版本宣告,固定要寫。", "item": 1},
   {"say": "接著是根節點。裡面先寫板子的型號和 compatible 字串,然後有三個子節點:chosen 節點放開機參數和主控台的設定;memory 節點描述記憶體的起始位址和大小;還有一個序列埠節點,前面帶著 uart 零這個標籤。", "item": 2},
   {"say": "序列埠節點裡寫了 compatible、暫存器位址、中斷,還有 status 是 okay。最後用右大括號和分號,把根節點結束。", "item": 3}
  ],
  "裝置樹(Device Tree)語法與概念#6": [
   {"say": "裝置樹裡有幾個重要的屬性,一定要認識。", "item": 0},
   {"say": "第一個是 compatible。它是一串字串,從最具體排到最通用,驅動程式就是靠它來跟裝置配對的。", "item": 1},
   {"say": "第二個是 reg,寫的是暫存器的位址和大小。它的格式,由父節點的 address cells 和 size cells 這兩個屬性決定。剛剛的例子兩個都是一,所以位址和大小各佔一個三十二位元的數字。六十四位元的平台,常常會設成二。", "item": 2},
   {"say": "第三個是 status。寫 okay 是啟用,寫 disabled 是停用,驅動就不會去綁定它。S o C 的共用檔常常預設是 disabled,板子的 D T S 檔再用標籤引用的方式,把它改成 okay 打開。", "item": 3}
  ],
  "裝置樹(Device Tree)語法與概念#7": [
   {"say": "繼續看其他的屬性。", "item": 0},
   {"say": "interrupts 和 interrupt parent 是用來描述中斷的,格式要看中斷控制器的設定。", "item": 1},
   {"say": "clocks、resets,還有 pin control 相關的屬性,分別描述時脈、重置,和腳位的複用。", "item": 2},
   {"say": "G P I O S 這個屬性,用來引用 G P I O 控制器,並且指定第幾號腳位,還有它是高電位有效,還是低電位有效。", "item": 3},
   {"say": "P handle 是節點之間的引用。你寫的標籤引用,會被 D T C 轉換成一個數字代號。", "item": 4},
   {"say": "最後是 aliases,可以幫常用的節點取別名,例如把 serial 零指到 uart 零這個節點。", "item": 5}
  ],
  "裝置樹實戰:新增節點、編譯與 Overlay#1": [
   {"say": "觀念有了,我們來實戰。情境是這樣:要替板子加一顆 L E D,接在 G P I O 的第十七號腳位,高電位點亮,並且設成心跳式閃爍。做法是在板子的 D T S 檔裡,加入一個 L E D S 節點。", "item": 0},
   {"say": "節點裡的 compatible 寫 G P I O L E D S,這樣核心裡的 G P I O L E D 驅動就會負責它。當然,核心要有開啟對應的設定選項。", "item": 1},
   {"say": "腳位後面的 G P I O ACTIVE HIGH,代表輸出一就是亮。如果你的 L E D 另一端接的是電源,要拉低才會亮,那就改用 ACTIVE LOW。", "item": 2},
   {"say": "label 是它顯示在 sys class L E D S 目錄底下的名稱。比較新的核心偏好用 function 和 color 這兩個屬性,不過舊的 label 寫法還是很普遍。", "item": 3}
  ],
  "裝置樹實戰:新增節點、編譯與 Overlay#2": [
   {"say": "看一下要加進去的內容。", "item": 0},
   {"say": "第一行先引入 G P I O 的標頭檔,這樣才能使用 ACTIVE HIGH 這類常數。", "item": 1},
   {"say": "接著在根節點底下,加入 L E D S 節點。裡面有一個子節點代表這顆燈,寫了三件事:名稱叫 debug、接在 G P I O 第十七號腳而且高電位有效,還有預設的觸發方式是 heartbeat,也就是心跳。", "item": 2},
   {"say": "最後一樣用右大括號加分號收尾。", "item": 3}
  ],
  "裝置樹實戰:新增節點、編譯與 Overlay#3": [
   {"say": "用新的 D T B 開機之後,就可以在系統裡看到這顆燈了。", "item": 0},
   {"say": "先用 L S 看 sys class L E D S 這個目錄,應該會出現 debug。", "item": 1},
   {"say": "用 cat 讀它底下的 trigger 檔,可以看到目前的觸發方式。", "item": 2},
   {"say": "把 none 寫進 trigger,就是關掉自動觸發,心跳閃爍會停下來。", "item": 3},
   {"say": "再把一寫進 brightness,就能手動把燈點亮。", "item": 4}
  ],
  "裝置樹實戰:新增節點、編譯與 Overlay#4": [
   {"say": "那 D T S 要怎麼編譯成 D T B 呢?最常見的做法,是用 kernel 的建置系統。", "item": 0},
   {"say": "板子的 D T S 檔,放在 arch、arm 六十四、boot、D T S 底下,各家廠商自己的目錄裡。並且要在同一個目錄的 Makefile,加上對應的 D T B 目標。", "item": 1},
   {"say": "編出來的檔案會放在同一個目錄,副檔名是點 D T B。", "item": 2},
   {"say": "指令是 make,指定架構是 arm 六十四,指定交叉編譯器的前綴,最後的目標是 D T B S。如果再加上 W 等於一,可以看到更多裝置樹的警告。", "item": 3}
  ],
  "裝置樹實戰:新增節點、編譯與 Overlay#5": [
   {"say": "想學裝置樹,有一份很棒的教材,就是 QEMU 自己的裝置樹。", "item": 0},
   {"say": "virt 機型的 D T B 是 QEMU 動態產生的,我們可以把它匯出來,再反組譯成看得懂的文字。", "item": 1},
   {"say": "打開之後,你會看到記憶體、C P U、中斷控制器、P L 零一一序列埠、P L 零六一 G P I O,還有 virtio 這些節點。", "item": 2},
   {"say": "第一個指令,是在機型 virt 後面加上 dump D T B 這個選項,指定輸出的檔名,QEMU 就會把裝置樹存成檔案。", "item": 3},
   {"say": "第二個指令用 D T C,輸入格式指定 D T B,輸出格式指定 D T S,把它轉回文字,再接到 less 慢慢看。D T C 在 Debian 和 Ubuntu 上,屬於 device tree compiler 這個套件。", "item": 4}
  ],
  "裝置樹實戰:新增節點、編譯與 Overlay#6": [
   {"say": "最後介紹 overlay。Overlay 是疊加在基礎 D T B 上面的片段,不用重編整份 D T B,很適合可插拔的擴充板。Raspberry Pi 把它做得很方便,只要在開機分區的 config 點 T X T 裡加幾行設定。", "item": 0},
   {"say": "D T param 這個設定,是用來開關基本 D T B 裡面預留好的參數。", "item": 1},
   {"say": "D T overlay 這個設定,會去載入 boot 底下 overlays 目錄裡,對應名稱的 D T B O 檔,後面還可以帶參數。", "item": 2},
   {"say": "如果要自己編譯 overlay,一樣用 D T C,而且要加一個選項來產生符號資訊,才能解析標籤的引用。U Boot 這邊,也可以用 F D T apply 指令來套用 overlay,細節依板子而定。", "item": 2}
  ],
  "裝置樹實戰:新增節點、編譯與 Overlay#7": [
   {"say": "看一下實際的寫法。", "item": 0},
   {"say": "第一行用 D T param,把 ARM 這一側的 I 平方 C 打開。", "item": 1},
   {"say": "第二行同樣用 D T param,把 S P I 打開。", "item": 2},
   {"say": "第三行用 D T overlay,載入 G P I O 風扇的 overlay,並且用參數指定腳位是十四號。", "item": 3},
   {"say": "下面是 overlay 原始檔的寫法。開頭一樣是版本宣告。", "item": 4},
   {"say": "第二行多了一個 plugin 的宣告,表示這是一個 overlay。後面再指定要疊加到根節點,並寫上要新增的節點內容。這個片段的寫法,會因為 D T C 的版本和平台而有一些不同。", "item": 5}
  ],
  "closing": [
   {"say": "這一章就先到這裡。你已經認識 U Boot 的啟動流程、常用指令和環境變數,也學會裝置樹的語法、重要屬性,還有怎麼新增節點、編譯和使用 overlay。", "item": 0},
   {"say": "接下來,請動手做本章的練習,再完成章末小測驗,檢查自己學會了多少。我們下一章見!", "item": 1, "pause": 1}
  ]
 }
}
