{
 "byKey": {
  "cover": [
   {"say": "大家好,歡迎回到嵌入式 Linux 課。這一章的主題是根檔案系統,也就是 root filesystem。我們先看它的組成和型態,再用 BusyBox 手工做一個最小系統,最後用 Buildroot 一次建置完整的系統,並且學會客製化。", "item": 0}
  ],
  "Root Filesystem 的組成與型態#1": [
   {"say": "先來弄清楚,什麼是 root filesystem?", "item": 0},
   {"say": "Kernel 啟動完成之後,需要一個根目錄,才能執行第一個使用者空間的程式。這個根目錄所在的檔案系統,就是 root filesystem,常常簡寫成 root F S。", "item": 1},
   {"say": "它裡面有 C 函式庫、基本的命令、init、設定檔、裝置節點,還有你的應用程式。Kernel 只負責找到它、把它掛載起來,至於裡面要放什麼,完全由你決定。", "item": 1}
  ],
  "Root Filesystem 的組成與型態#2": [
   {"say": "那一個最小、可以開機的根檔案系統,需要哪些東西呢?下一張會逐項列出來。", "item": 0},
   {"say": "這些目錄的配置,大致遵循一個叫 F H S 的檔案系統階層標準。另外,很多現代的系統,會把根目錄下的 bin、S bin、lib,做成指向 U S R 底下對應目錄的符號連結,這個做法叫做 U S R merge。", "item": 1}
  ],
  "Root Filesystem 的組成與型態#3": [
   {"say": "我們來看需要哪些目錄。", "item": 0},
   {"say": "首先是放可執行檔的幾個目錄:bin、S bin,還有 U S R 底下的 bin 和 S bin。BusyBox 通常就放在 bin 裡面。", "item": 1},
   {"say": "再來是 lib 目錄,放共享函式庫和動態連結器。如果程式都是靜態連結的,這個可以省略。", "item": 2},
   {"say": "E T C 目錄放設定檔,例如 init tab、F S tab、passwd、hostname。", "item": 3}
  ],
  "Root Filesystem 的組成與型態#4": [
   {"say": "繼續看。", "item": 0},
   {"say": "dev 目錄放裝置節點,可以由 dev T M P F S 自動提供。", "item": 1},
   {"say": "proc 和 sys 是虛擬檔案系統的掛載點,開機的時候要把它們掛載起來。", "item": 2},
   {"say": "T M P、var、run、root、M N T 這幾個,分別是暫存、狀態資料和家目錄等用途。", "item": 3},
   {"say": "最後是第一個行程,放在根目錄的 init,或是 S bin 底下的 init。", "item": 4}
  ],
  "Root Filesystem 的組成與型態#5": [
   {"say": "根檔案系統可以放在不同的地方,常見的有三種型態。", "item": 0},
   {"say": "第一種,是放在儲存裝置上的檔案系統,這裡面又有幾個選擇。", "item": 1},
   {"say": "E X T 四最通用,可以讀寫,放在 S D 卡或 e M M C 的分區上。", "item": 2},
   {"say": "Squash F S 是壓縮的唯讀檔案系統,體積小、不容易被破壞,很適合產品的韌體。它常常搭配 overlay F S 或 T M P F S,來提供可以寫入的那一層。", "item": 3},
   {"say": "U B I F S 和 J F F S 二,是直接建立在原始的 NAND 或 NOR Flash 上面的,本身就帶有磨損均衡的功能。", "item": 4},
   {"say": "第二種是 init ram F S。它把根檔案系統做成 C P I O 壓縮檔,和 kernel 一起載入記憶體,開機之後直接在 RAM 裡面執行。它適合極小的系統、除錯,或是當作第一階段,去準備真正的根檔案系統。重開機就還原,也不會磨損儲存裝置。", "item": 5}
  ],
  "Root Filesystem 的組成與型態#6": [
   {"say": "還有第三種。", "item": 0},
   {"say": "第三種是網路上的根檔案系統,叫做 N F S root。根檔案系統放在開發 P C 上,板子透過 N F S 來掛載。你在 P C 上改了檔案,板子馬上就能用,開發應用程式的時候非常方便。", "item": 1},
   {"say": "不過它需要 kernel 開啟 N F S root 的支援,還要設定正確的網路和 N F S 相關的開機參數。這種方式只用在開發,量產不會用。", "item": 1}
  ],
  "Root Filesystem 的組成與型態#7": [
   {"say": "根檔案系統掛載好之後,kernel 要怎麼找到 init 呢?", "item": 0},
   {"say": "它會依序嘗試:先看命令列有沒有用 init 參數指定,再來試 S bin 底下的 init、E T C 底下的 init、bin 底下的 init,最後是 bin 底下的 S H。如果是 init ram F S,通常是用根目錄的 init。", "item": 1},
   {"say": "如果全部都失敗,常見的原因有:檔案不存在、沒有執行權限、架構編錯了,或者動態連結的程式缺少函式庫或直譯器。最後這一種最容易讓人困惑,因為檔案明明存在,卻回報 not found。", "item": 2},
   {"say": "這時候畫面上會出現這一行 kernel panic,說找不到可以用的 init,並且建議你用 init 參數來指定。以後看到這行訊息,就往剛剛那幾個原因去查。", "item": 3}
  ],
  "BusyBox:用一個執行檔組成最小系統#1": [
   {"say": "知道需要什麼之後,我們來動手做。主角是 BusyBox。", "item": 0},
   {"say": "BusyBox 把幾百個常用的 Unix 指令,像是 L S、C P、grep、mount、init,甚至 V I 和 W get,合併成一個執行檔。每一個指令叫做一個 applet。整個檔案很小,大約幾百 K B 到一 M B 多。", "item": 1},
   {"say": "系統是透過符號連結來呼叫它的。例如 bin 底下的 L S,其實是指向 BusyBox 的連結。BusyBox 會檢查自己是被用什麼名字啟動的,再決定執行哪一個 applet。它的指令選項比 G N U 的版本少,但是在嵌入式已經夠用了。", "item": 1}
  ],
  "BusyBox:用一個執行檔組成最小系統#2": [
   {"say": "先取得原始碼並且設定。", "item": 0},
   {"say": "BusyBox 和 kernel 一樣,也是用 Kconfig 來設定的。", "item": 1},
   {"say": "第一步,用 git clone 把 BusyBox 抓下來,或者直接下載穩定版的壓縮檔也可以。", "item": 2},
   {"say": "第二步,C D 進到 BusyBox 目錄。", "item": 3},
   {"say": "第三步,make defconfig,產生預設的設定。", "item": 4},
   {"say": "第四步,make menuconfig 進去調整。要放進極簡的根檔案系統,最簡單的方式是靜態連結:進到 Settings,把 Build static binary 這個選項勾起來。這樣就不用另外準備 C 函式庫,不過你的工具鏈要有靜態版的函式庫才行。", "item": 5}
  ],
  "BusyBox:用一個執行檔組成最小系統#3": [
   {"say": "設定好之後,交叉編譯,並且安裝到一個暫存目錄。", "item": 0},
   {"say": "安裝的時候用 CONFIG PREFIX 指定目標目錄。安裝完,裡面會出現 bin、S bin、U S R 這些目錄,還有一大堆符號連結,通通指向 BusyBox。", "item": 1},
   {"say": "第一行指令是編譯:make,指定架構 arm 六十四和交叉編譯器的前綴,再加上平行編譯。", "item": 2},
   {"say": "第二行是安裝:同樣的參數,再加上 CONFIG PREFIX,指到家目錄底下的 E M B、root F S 這個目錄,最後的目標是 install。", "item": 3}
  ],
  "BusyBox:用一個執行檔組成最小系統#4": [
   {"say": "BusyBox 裝好了,但是根檔案系統的骨架還不完整,要手工補齊幾樣東西:先補上缺的目錄,檢查一下 BusyBox 執行檔,然後寫一個 init 腳本。", "item": 0},
   {"say": "這個 init 腳本放在根目錄,是給 init ram F S 用的,內容等一下會看到。", "item": 1},
   {"say": "寫好之後,記得用 C H mod 加上執行權限。如果你想要完整的登入流程和 init tab,可以改用 BusyBox 自己的 init。做簡單的實驗,直接執行 shell 是最快的。", "item": 2},
   {"say": "另外要留意,如果 kernel 沒有開啟 dev T M P F S 的支援,腳本裡掛載它的那一行就會失敗。", "item": 2}
  ],
  "BusyBox:用一個執行檔組成最小系統#5": [
   {"say": "先補目錄和檢查。", "item": 0},
   {"say": "C D 到剛剛安裝的 root F S 目錄。", "item": 1},
   {"say": "用 M K D I R 加上減號 P,一次建立 proc、sys、dev、E T C、T M P 這些缺少的目錄。", "item": 2},
   {"say": "用 file 檢查 BusyBox 執行檔,確認它是 ARM 六十四的架構。", "item": 3},
   {"say": "再用 read E L F 找 NEEDED。如果是靜態連結,應該不會有任何輸出,代表它不依賴任何共享函式庫。", "item": 4}
  ],
  "BusyBox:用一個執行檔組成最小系統#6": [
   {"say": "再來是 init 腳本的內容。", "item": 0},
   {"say": "第一行是井字號加驚嘆號開頭的宣告,指定用 bin 底下的 S H 來執行這個腳本。", "item": 1},
   {"say": "第二行,把 proc 檔案系統掛載到斜線 proc。", "item": 2},
   {"say": "第三行,把 sys F S 掛載到斜線 sys。", "item": 3},
   {"say": "第四行,把 dev T M P F S 掛載到斜線 dev,這樣裝置節點就會自動出現。", "item": 4},
   {"say": "第五行,用 echo 印出一行歡迎訊息。", "item": 5}
  ],
  "BusyBox:用一個執行檔組成最小系統#7": [
   {"say": "腳本的最後一行。", "item": 0},
   {"say": "用 exec 執行 bin 底下的 S H,也就是讓 shell 直接取代這個腳本,成為一號行程。這樣開機之後,你就會直接拿到一個 shell 提示符號。", "item": 1}
  ],
  "Buildroot:一鍵建置完整系統#1": [
   {"say": "手工做過一次,你就會懂得 Buildroot 的好。", "item": 0},
   {"say": "手工做根檔案系統,做到第三個套件大概就會崩潰,因為每個套件都要下載、設定、交叉編譯、解決相依、安裝。Buildroot 把這些事情通通自動化。", "item": 1},
   {"say": "它是用 Makefile 加上 Kconfig 組成的建置系統,可以一次產生交叉工具鏈、bootloader、kernel、根檔案系統,還有最終的映像檔。你只要在 menuconfig 裡選好,再執行 make 就可以了。", "item": 1}
  ],
  "Buildroot:一鍵建置完整系統#2": [
   {"say": "先取得 Buildroot。", "item": 0},
   {"say": "你可以用 git,也可以到 Buildroot 的官方網站下載壓縮檔。它需要主機上有一些基本工具,缺少的話,Buildroot 一開始就會提示你。", "item": 1},
   {"say": "用 git 的話,第一行是 git clone,把 Buildroot 的原始碼庫抓下來。", "item": 2},
   {"say": "第二行 C D 進去。", "item": 3},
   {"say": "第三行用 git checkout 切換到某一個版本。畫面上的版本只是舉例,建議使用還有在維護的長期支援版本,實際的版本請查官網。", "item": 4}
  ],
  "Buildroot:一鍵建置完整系統#3": [
   {"say": "最快看到成果的路徑,是使用 QEMU 的預設設定。指令在下一張,先說明會發生什麼事。", "item": 0},
   {"say": "執行 make 之後,它會下載原始碼,建置工具鏈、kernel 和根檔案系統。第一次要花幾十分鐘到幾個小時,要看你的網路和 C P U。完成之後,成品會放在 output 底下的 images 目錄。", "item": 1},
   {"say": "開機之後用 root 登入。這個預設設定通常是 root 沒有密碼,實際上要以那個版本 board 目錄下的說明檔為準。要離開 QEMU,一樣是按 Control A 再按 X。", "item": 2}
  ],
  "Buildroot:一鍵建置完整系統#4": [
   {"say": "指令只有四行。", "item": 0},
   {"say": "第一行,make 後面接 QEMU A arch 六十四 virt 的 defconfig,載入預設設定。", "item": 1},
   {"say": "第二行,就是一個 make,然後去泡杯咖啡慢慢等。", "item": 2},
   {"say": "第三行,用 L S 看 output 底下的 images,裡面可能有 kernel 的 Image、E X T 四的根檔案系統映像檔,還有一個啟動 QEMU 的腳本。", "item": 3},
   {"say": "第四行,直接執行那個 start QEMU 腳本,系統就開機了。另外,用 make list defconfigs,可以列出所有內建的設定。", "item": 4}
  ],
  "Buildroot:一鍵建置完整系統#5": [
   {"say": "接著認識 Buildroot 的目錄結構,尤其是 output 目錄。", "item": 0},
   {"say": "output 底下有五個子目錄。build 是各個套件解壓縮和編譯的地方。host 放的是在開發機上執行的工具,包含交叉編譯器。staging 是目標的標頭檔和函式庫,給編譯的時候用。", "item": 1},
   {"say": "target 是目標根檔案系統的內容,不過它還不是最終的映像檔。images 才是最終的成品,kernel、D T B、根檔案系統映像檔和 S D 卡映像檔都在這裡。", "item": 1}
  ],
  "Buildroot:一鍵建置完整系統#6": [
   {"say": "再看最上層的幾個目錄。", "item": 0},
   {"say": "configs 放的是各種板子的 defconfig。", "item": 1},
   {"say": "board 放的是板子的輔助檔案,像是 kernel 的設定片段、overlay、建置後的腳本,還有說明檔。", "item": 2},
   {"say": "package 裡面有好幾千個套件的定義。", "item": 3},
   {"say": "output 就是剛剛介紹的輸出目錄。", "item": 4}
  ],
  "Buildroot:一鍵建置完整系統#7": [
   {"say": "還有一個。", "item": 0},
   {"say": "D L 目錄,是下載回來的原始碼壓縮檔的快取。有了它,重新建置的時候就不用再下載一次。", "item": 1}
  ],
  "客製化 rootfs:overlay、自訂套件與燒錄 SD 卡#1": [
   {"say": "預設的系統能開機了,接下來要把它變成你自己的系統。第一個方法,也是最簡單的方法,叫做 root filesystem overlay。", "item": 0},
   {"say": "做法是在 menuconfig 的 System configuration 裡,找到 Root filesystem overlay directories 這個選項,填入一個目錄。這個目錄裡的結構,會在建置的最後,原封不動覆蓋到根檔案系統上。", "item": 1},
   {"say": "例如在 overlay 目錄裡放 E T C 底下的 hostname 檔,它就會變成目標上的 hostname 設定。放一個 init 點 D 底下的腳本,就成為開機自動啟動的腳本。", "item": 2},
   {"say": "畫面上這個路徑,就是一個 overlay 目錄的例子。要注意,檔案的執行權限,要在原始目錄裡就先設定好。", "item": 3}
  ],
  "客製化 rootfs:overlay、自訂套件與燒錄 SD 卡#2": [
   {"say": "剛剛提到開機自動啟動的腳本,我們來看它怎麼寫。Buildroot 預設使用 BusyBox 的 init。在 E T C 的 init 點 D 目錄下,檔名用大寫 S 開頭、加上兩位數字的腳本,開機時會依照數字順序,帶著 start 參數執行,關機時則帶著 stop 參數執行。", "item": 0},
   {"say": "腳本裡有三個分支。收到 start 就印出訊息,並且在背景啟動你的程式。收到 stop 就把程式結束掉。其他情況,則印出用法說明,然後以錯誤碼離開。", "item": 1},
   {"say": "腳本的第一行,一樣是指定用 S H 執行的宣告。", "item": 2},
   {"say": "接著用 case 判斷第一個參數是什麼。", "item": 3},
   {"say": "最後用 E S A C,也就是 case 倒過來寫,把判斷結束。實際的機制會因為你選的 init 系統和版本而不同,Buildroot 也可以改用 system D。", "item": 4}
  ],
  "客製化 rootfs:overlay、自訂套件與燒錄 SD 卡#3": [
   {"say": "第二個客製化的方法,是用腳本。Buildroot 提供兩個掛勾。", "item": 0},
   {"say": "第一個是 post build 腳本。它在根檔案系統組好、還沒打包成映像檔之前執行,收到的第一個參數是 target 目錄的路徑。可以用它來修改 F S tab,或是刪掉不需要的檔案。", "item": 1},
   {"say": "第二個是 post image 腳本。它在映像檔產生之後才執行,常用來組合最終的 S D 卡映像檔,例如搭配 gen image 這個工具。", "item": 2}
  ],
  "客製化 rootfs:overlay、自訂套件與燒錄 SD 卡#4": [
   {"say": "第三個方法,是加入你自己的套件。這裡要用到外掛樹,設定的名稱是 B R 二 EXTERNAL。", "item": 0},
   {"say": "原則是,不要直接去改 Buildroot 的原始碼樹,把自己的東西放在外面獨立的一個目錄裡。", "item": 1},
   {"say": "這個目錄裡要有幾個固定的檔案。External 點 desc 用來幫外掛樹取名字,這裡叫 MYBOARD。另外還有 external 點 M K 和 Config 點 in,負責把你的套件引入進來。", "item": 2},
   {"say": "每個套件有自己的 Config 點 in,宣告一個布林選項,名字叫 hello,並且附上一行說明。這樣它才會出現在 menuconfig 的選單裡。", "item": 3},
   {"say": "套件還有一個點 M K 檔。裡面的建置命令,是用目標的交叉編譯器去執行 make。", "item": 4},
   {"say": "安裝命令,則是把編好的 hello 執行檔,裝到目標目錄的 U S R bin 底下,並且設定成可以執行的權限。", "item": 5}
  ],
  "客製化 rootfs:overlay、自訂套件與燒錄 SD 卡#5": [
   {"say": "再補充說明幾件事。", "item": 0},
   {"say": "套件的變數,前綴都是大寫的套件名稱。來源方式設成 local,表示直接從本機目錄複製原始碼。建置和安裝各有一段命令定義,最後一行則是呼叫通用套件的基礎設施。還有,命令列的縮排要用 Tab。", "item": 1},
   {"say": "使用外掛樹的時候,第一次 make 要帶上 B R 二 EXTERNAL 指到你的目錄。這個路徑會被記錄在點 config 裡面,之後的 make 就不用再重複帶了。之後修改程式,只要重編 hello 這一個套件,再 make 一次就好。", "item": 2}
  ],
  "客製化 rootfs:overlay、自訂套件與燒錄 SD 卡#6": [
   {"say": "對照畫面上的檔案內容來看。", "item": 0},
   {"say": "最上面是外掛樹的目錄結構,有剛剛說的三個固定檔案、configs 目錄,還有 package 底下 hello 套件的資料夾。", "item": 1},
   {"say": "中間是套件的 Config 點 in,宣告 hello 這個選項。", "item": 2},
   {"say": "下面開始是 hello 點 M K 的內容,第一行定義套件的版本是一點零。", "item": 3}
  ],
  "客製化 rootfs:overlay、自訂套件與燒錄 SD 卡#7": [
   {"say": "繼續看點 M K 檔。", "item": 0},
   {"say": "這一行設定原始碼的位置,指到外掛樹裡面 hello 套件的 S R C 目錄。", "item": 1},
   {"say": "這一行把來源方式設成 local。", "item": 2},
   {"say": "接著開始定義建置的命令,也就是前面講過的,用交叉編譯器執行 make。這個檔案你不用背,以後要加自己的套件時,拿這個範本來改就可以了。", "item": 3}
  ],
  "closing": [
   {"say": "這一章就先到這裡。你已經知道根檔案系統裡有什麼、有哪幾種型態,會用 BusyBox 手工做出最小系統,也會用 Buildroot 建置和客製化完整的系統了。", "item": 0},
   {"say": "接下來,請動手做本章的練習,再完成章末小測驗,檢查自己學會了多少。我們下一章見!", "item": 1, "pause": 1}
  ]
 }
}
