{
 "byKey": {
  "cover": [
   {"say": "大家好,歡迎回到嵌入式 Linux 課。這一章有兩個重點。前半段是 Yocto 入門,認識它的架構,並且加入自己的 layer 和 recipe。後半段談系統整合,包括 init 和服務管理,還有映像檔的樣貌和檢查方式。", "item": 0}
  ],
  "Yocto 與 OpenEmbedded 的架構#1": [
   {"say": "前面學過 Buildroot,那為什麼還需要 Yocto 呢?", "item": 0},
   {"say": "Buildroot 很適合單一的產品。可是當你需要支援多種硬體、長期維護、套件升級、授權合規、可重現的建置,還要提供 S D K 的時候,就會走向 Yocto。要注意,Yocto 並不是一個發行版,而是用來建立你自己的發行版的工具集和參考設定。", "item": 1},
   {"say": "Yocto 的名詞很多,我們一個一個認識。Open Embedded Core,簡稱 O E Core,提供最基礎的 recipe 和 class,像 G lib C、BusyBox、system D 和 kernel 的配方都在裡面。", "item": 2},
   {"say": "BitBake 是建置引擎。它讀取 recipe、解析相依關係,然後排程並且平行執行各項任務。", "item": 3},
   {"say": "Poky 是 Yocto 的參考發行版和範例組合,裡面包含了 BitBake、O E Core,還有幾個基本的 layer。", "item": 4},
   {"say": "Layer 就是層,是名稱以 meta 開頭的目錄,依照功能分層。例如 meta raspberry pi 是板級支援,meta open embedded 有很多額外的套件,你也可以有自己公司的 layer。", "item": 5}
  ],
  "Yocto 與 OpenEmbedded 的架構#2": [
   {"say": "還有幾個名詞。", "item": 0},
   {"say": "Recipe 是配方,副檔名是點 B B,描述一個軟體要怎麼取得原始碼、設定、編譯和安裝。另外還有點 B B append 檔,用來擴充別的 layer 裡的 recipe,不必整份複製過來。", "item": 1},
   {"say": "Class 的副檔名是點 B B class,是可以被 recipe 繼承的共用邏輯,例如繼承 C make。", "item": 2},
   {"say": "Machine 是目標硬體,例如 QEMU arm 六十四,或是 Raspberry Pi 四的六十四位元版本。", "item": 3},
   {"say": "Distro 是發行版的政策,預設值是 poky。", "item": 4},
   {"say": "Image 則是最終映像檔的 recipe,例如 core image minimal,還有 core image base。", "item": 5}
  ],
  "Yocto 與 OpenEmbedded 的架構#3": [
   {"say": "再來談版本和建置流程。", "item": 0},
   {"say": "Yocto 大約每半年釋出一版,用代號來命名,其中一部分是長期支援版。產品要選長期支援版,而且 Poky 和所有的 layer,都必須用同一個代號的分支。", "item": 1},
   {"say": "語法也會隨著版本演進。例如從三點四版開始,override 的語法從底線改成了冒號。這門課一律使用冒號的語法。", "item": 1},
   {"say": "建置的時候,要先 source 一個初始化環境的腳本。它會建立 build 目錄和裡面的 conf 設定目錄,並且把 BitBake 加進執行路徑。要記得,每次開新的終端機,都要重新 source 一次。", "item": 2},
   {"say": "主機的需求不小:建議有五十到一百 G B 的硬碟空間、八 G B 以上的記憶體、多核心的 C P U。第一次完整建置可能要花好幾個小時。還有,BitBake 不可以用 root 身分執行。", "item": 3}
  ],
  "Yocto 與 OpenEmbedded 的架構#4": [
   {"say": "整個建置流程只有四個指令。", "item": 0},
   {"say": "第一行,用 git clone 把 poky 抓下來,並且用減號 B 指定分支的代號。分支名稱請以官網目前的長期支援版為準。", "item": 1},
   {"say": "第二行,C D 進到 poky 目錄。", "item": 2},
   {"say": "第三行,source 那個初始化腳本,後面接 build,指定建置目錄。", "item": 3},
   {"say": "第四行,用 BitBake 建置 core image minimal 這個最小的映像檔。", "item": 4}
  ],
  "Yocto 與 OpenEmbedded 的架構#5": [
   {"say": "Yocto 的設定,主要寫在 build 底下 conf 目錄的兩個檔案裡。第一個是 local 點 conf,放這次建置的使用者設定。第二個是 B B layers 點 conf,列出啟用了哪些 layer。先說明兩個重點。", "item": 0},
   {"say": "MACHINE 這個變數用來選擇目標硬體。而設定值時用的問號加等號,意思是預設值,只有在還沒被設定的時候才會使用。", "item": 1},
   {"say": "另外有一個叫 debug tweaks 的選項,它會讓 root 不用密碼就能登入,只能在開發的時候用。新版的 Yocto 對這個選項有做調整,量產的時候一定要拿掉。", "item": 2}
  ],
  "Yocto 與 OpenEmbedded 的架構#6": [
   {"say": "來看 local 點 conf 裡常見的項目。", "item": 0},
   {"say": "MACHINE 設成 QEMU arm 六十四。", "item": 1},
   {"say": "DISTRO 設成 poky。", "item": 2},
   {"say": "PACKAGE CLASSES 指定套件格式,這裡是 R P M。", "item": 3},
   {"say": "EXTRA IMAGE FEATURES 加上了剛剛說的 debug tweaks。", "item": 4},
   {"say": "B B NUMBER THREADS 是 BitBake 同時執行的任務數,這裡設成八。", "item": 5}
  ],
  "Yocto 與 OpenEmbedded 的架構#7": [
   {"say": "繼續看。", "item": 0},
   {"say": "PARALLEL MAKE 是每個套件編譯時的平行數,也是八。", "item": 1},
   {"say": "D L DIR 是下載檔案的存放目錄。", "item": 2},
   {"say": "S STATE DIR 是共享狀態快取的目錄,它可以讓下次建置快很多。", "item": 3},
   {"say": "最後這一段是 B B layers 點 conf 的內容,用 B B LAYERS 變數列出啟用的 layer 路徑,包括 meta、meta poky 和 meta yocto B S P。", "item": 4}
  ],
  "Layer 與 Recipe:加入自己的應用程式#1": [
   {"say": "接下來,我們要把自己的應用程式加進 Yocto。第一步是建立自己的 layer。", "item": 0},
   {"say": "原則和 Buildroot 一樣,不要去修改 poky 裡面的 layer,而是用 BitBake layers 這個工具,建立並啟用一個新的 layer。", "item": 1},
   {"say": "用 create layer 建立之後,它會自動產生一個基本的結構。", "item": 2},
   {"say": "裡面有 conf 目錄下的 layer 點 conf、授權檔、說明檔,還有一個範例 recipe。layer 點 conf 裡的設定是工具產生的,其中相容版本那一項的值,必須包含你所使用的 Yocto 代號。", "item": 3}
  ],
  "Layer 與 Recipe:加入自己的應用程式#2": [
   {"say": "實際的指令是這樣。", "item": 0},
   {"say": "先 C D 到 poky。", "item": 1},
   {"say": "source 初始化腳本,進入建置環境。", "item": 2},
   {"say": "用 BitBake layers 的 create layer,在上一層目錄建立一個叫 meta my layer 的 layer。", "item": 3},
   {"say": "再用 add layer 把它啟用。這個動作會把它加進 B B layers 點 conf 裡面。", "item": 4}
  ],
  "Layer 與 Recipe:加入自己的應用程式#3": [
   {"say": "接著確認一下。", "item": 0},
   {"say": "用 show layers 列出目前啟用的所有 layer,應該可以看到剛剛加進去的那一個。", "item": 1},
   {"say": "下面就是工具產生的 meta my layer 目錄結構。", "item": 2}
  ],
  "Layer 與 Recipe:加入自己的應用程式#4": [
   {"say": "有了 layer,就可以寫 recipe 了。我們用一個簡單的 C 程式當例子。Recipe 的檔名格式是名稱、底線、版本,再加上點 B B。內容有幾個重點。", "item": 0},
   {"say": "第一,LICENSE 和授權檔的校驗碼。Yocto 強制每個 recipe 都要宣告授權,並且用校驗碼來驗證,這是授權合規的基礎。", "item": 1},
   {"say": "第二,S R C U R I 是原始碼的來源。用 file 開頭的寫法,是從 recipe 旁邊的 files 目錄拿檔案。來源也可以是 git 或 H T T P S 的網址,那就要另外指定版本或校驗碼。", "item": 2},
   {"say": "第三,編譯的時候,要用 BitBake 提供的 C C、C FLAGS 和 L D FLAGS 這些變數,它們代表交叉編譯器和旗標。千萬不要把 G C C 寫死在裡面。", "item": 3},
   {"say": "第四,安裝的時候,大寫 D 這個變數是安裝用的暫存根目錄,bindir 代表 U S R bin。所以檔案要裝到暫存根目錄底下的 U S R bin,而不是直接裝到你主機的 U S R bin。", "item": 4}
  ],
  "Layer 與 Recipe:加入自己的應用程式#5": [
   {"say": "對照實際的檔案來看。", "item": 0},
   {"say": "第一個路徑是 recipe 檔本身,放在 layer 裡 recipes apps 底下的 hello 目錄,檔名是 hello 底線一點零點 B B。", "item": 1},
   {"say": "第二個路徑是原始碼 hello 點 C,放在同一層的 files 目錄裡。", "item": 2},
   {"say": "hello 點 C 的內容很短,開頭引入標準輸入輸出的標頭檔。", "item": 3}
  ],
  "Layer 與 Recipe:加入自己的應用程式#6": [
   {"say": "我們繼續往下看。", "item": 0},
   {"say": "main 函式只做一件事,印出 Hello from Yocto,然後回傳零。", "item": 1},
   {"say": "下面開始是 recipe 的內容。SUMMARY 是一行簡短的說明。", "item": 2},
   {"say": "LICENSE 宣告授權是 M I T。", "item": 3}
  ],
  "Layer 與 Recipe:加入自己的應用程式#7": [
   {"say": "再往下。", "item": 0},
   {"say": "這一行是授權檔的校驗碼,指向共用授權目錄裡的 M I T 授權檔,後面帶著它的 M D 五值。", "item": 1},
   {"say": "S R C U R I 指定原始碼是 files 目錄裡的 hello 點 C。", "item": 2},
   {"say": "大寫 S 是原始碼所在的目錄,這裡設成工作目錄。提醒一下,這是適用於 kirkstone 和 scarthgap 這兩個版本的寫法,比較新的版本在這個部分有改變,細節要看你用的 Yocto 版本。", "item": 3}
  ],
  "系統啟動與服務管理:init、BusyBox init 與 systemd#1": [
   {"say": "好,接下來進入系統整合的部分,先談 init。", "item": 0},
   {"say": "init 是行程編號一號,是 kernel 啟動的第一個使用者空間程式。它負責掛載檔案系統、啟動服務、收養孤兒行程,並且在關機的時候,有順序地把服務停下來。", "item": 1},
   {"say": "嵌入式常見的 init 有三種,下一張會比較。選擇的原則是:極小的系統用 BusyBox init;需要複雜的服務管理、監控和日誌,就用 system D。", "item": 2}
  ],
  "系統啟動與服務管理:init、BusyBox init 與 systemd#2": [
   {"say": "這三種選擇分別是這樣。", "item": 0},
   {"say": "BusyBox init 最小。它讀取 E T C 底下的 init tab,服務是用 init 點 D 裡的 shell 腳本來啟動的,幾乎沒有相依管理。", "item": 1},
   {"say": "Sys V init 是傳統的做法,使用 run level 和一系列 R C 開頭的目錄。", "item": 2},
   {"say": "system D 功能最完整,有相依管理、平行啟動、自動重啟、日誌、計時器,還有資源限制。代價是它比較大,需要更多的記憶體和儲存空間,開機的基礎成本也比較高。", "item": 3}
  ],
  "系統啟動與服務管理:init、BusyBox init 與 systemd#3": [
   {"say": "先看 BusyBox init 實際怎麼用。", "item": 0},
   {"say": "它的設定檔是 E T C 底下的 init tab,內容下一張會看到。", "item": 1},
   {"say": "其中最後一行,會讓 init 在你的應用程式結束的時候,自動把它重新啟動,這個動作叫 respawn。這是最簡單的看門狗式服務監督。另外,R C S 腳本會去執行 init 點 D 底下 S 開頭的那些腳本,完成開機的初始化。", "item": 2}
  ],
  "系統啟動與服務管理:init、BusyBox init 與 systemd#4": [
   {"say": "init tab 的每一行,用冒號分成幾個欄位,我們一行一行看。", "item": 0},
   {"say": "第一行是 sys init,開機時執行 R C S 這個初始化腳本。", "item": 1},
   {"say": "第二行,在 T T Y A M A 零這個序列埠上啟動 getty,提供登入的提示,鮑率十一萬五千兩百。它也設定了 respawn,所以登出之後會重新出現登入提示。", "item": 2},
   {"say": "第三行,按下 Control Alt Delete 的時候執行 reboot。", "item": 3},
   {"say": "第四行,關機的時候把所有檔案系統卸載。", "item": 4},
   {"say": "第五行,就是剛剛說的,用 respawn 來啟動並監督你的應用程式。", "item": 5}
  ],
  "系統啟動與服務管理:init、BusyBox init 與 systemd#5": [
   {"say": "如果用的是 system D,服務是用服務單元檔來描述的。範例的檔案等一下看,先講三個重點。", "item": 0},
   {"say": "After 定義的是啟動順序。Wanted By 則決定這個服務由哪一個 target 帶起來。常用的 multi user target,大約等同於文字模式的正常運作狀態。", "item": 1},
   {"say": "Restart 設成 on failure,可以讓服務異常結束的時候自動重啟,這在嵌入式很常見。", "item": 2},
   {"say": "進階一點,還可以設定 Watchdog Sec 來搭配硬體看門狗,不過你的程式要定期通知 system D 才行。", "item": 3}
  ],
  "系統啟動與服務管理:init、BusyBox init 與 systemd#6": [
   {"say": "來看服務單元檔的內容。", "item": 0},
   {"say": "第一個區段是 Unit。", "item": 1},
   {"say": "Description 是這個服務的描述。", "item": 2},
   {"say": "After 設成 network target,表示排在網路之後啟動。", "item": 3},
   {"say": "第二個區段是 Service。", "item": 4},
   {"say": "Exec Start 指定要執行的程式,這裡是 U S R bin 底下的 my app。", "item": 5}
  ],
  "系統啟動與服務管理:init、BusyBox init 與 systemd#7": [
   {"say": "我們繼續往下看。", "item": 0},
   {"say": "Restart 設成 on failure。", "item": 1},
   {"say": "Restart Sec 設成二,代表隔兩秒再重啟。", "item": 2},
   {"say": "第三個區段是 Install。", "item": 3},
   {"say": "Wanted By 設成 multi user target。", "item": 4},
   {"say": "單元檔寫好之後,常用的指令有:用 system C T L 的 daemon reload 重新載入設定,用 enable 加上兩個減號 now 設成開機啟動並且立刻啟動,用 status 看狀態,用 journal C T L 看日誌。", "item": 4}
  ],
  "映像檔、套件管理與燒錄#1": [
   {"say": "最後一個單元,來看建置的最終產物。", "item": 0},
   {"say": "建置最後得到的,是可以燒到儲存裝置上的映像檔。它有好幾種常見的形態,下一張會列出來。", "item": 1},
   {"say": "在 Yocto 裡,是用 W I C 這個工具,搭配點 W K S 檔來描述分區的佈局,再用 IMAGE F S TYPES 變數指定要輸出哪些格式。", "item": 2},
   {"say": "Buildroot 則常常搭配 gen image,在 post image 腳本裡,用一個設定檔來描述分區。", "item": 3}
  ],
  "映像檔、套件管理與燒錄#2": [
   {"say": "常見的映像檔形態有這幾種。", "item": 0},
   {"say": "第一種只有根檔案系統,可能是 E X T 四的映像檔,或是壓縮的 tar 檔。", "item": 1},
   {"say": "第二種是 squash F S,唯讀而且壓縮過的根檔案系統。", "item": 2},
   {"say": "第三種是 kernel 的 Image 加上 D T B,通常放在 FAT 格式的開機分區。", "item": 3},
   {"say": "第四種是完整的磁碟映像檔,例如 S D card 點 I M G,或是點 W I C 檔。它包含分區表、開機分區和根檔案系統,可以整個燒進 S D 卡。", "item": 4}
  ],
  "映像檔、套件管理與燒錄#3": [
   {"say": "Yocto 的設定範例。", "item": 0},
   {"say": "這一行設定 IMAGE F S TYPES,同時輸出 W I C、壓縮過的 W I C,還有 E X T 四這三種格式。", "item": 1}
  ],
  "映像檔、套件管理與燒錄#4": [
   {"say": "那一張 S D 卡,典型的分區佈局長什麼樣子呢?", "item": 0},
   {"say": "先提一點,分區需要對齊,常見的是對齊到四 M B 的邊界,不過工具會幫你處理。", "item": 1},
   {"say": "第一個分區是 FAT 三十二格式的 boot 分區,放 bootloader、kernel 和 D T B。用 FAT 是因為 U Boot 讀得到。", "item": 2},
   {"say": "第二個分區是 E X T 四,放根檔案系統,我們叫它 A。", "item": 3},
   {"say": "第三個分區也是 E X T 四,放另一份根檔案系統 B。這是在支援 A B 更新的時候才需要。", "item": 4},
   {"say": "第四個分區是 data,放需要長久保存的資料。", "item": 5}
  ],
  "映像檔、套件管理與燒錄#5": [
   {"say": "映像檔做好之後,燒錄之前,最好先檢查一下內容。指令在下一張。", "item": 0},
   {"say": "有一個很重要的提醒:掛載和卸載的時候,一定要確認你操作的裝置名稱是 loop 裝置,而不是實體的磁碟,免得動到自己電腦的硬碟。", "item": 1}
  ],
  "映像檔、套件管理與燒錄#6": [
   {"say": "檢查的指令是這樣。", "item": 0},
   {"say": "W I C L S 可以列出 Yocto 產生的 W I C 映像檔裡有哪些分區。", "item": 1},
   {"say": "F disk 加上減號 L,可以看一個磁碟映像檔的分區表。", "item": 2},
   {"say": "用 sudo 執行 lo setup,把映像檔掛成 loop 裝置。它會印出裝置的名稱,例如 loop 三。", "item": 3},
   {"say": "然後把這個 loop 裝置的第二個分區,掛載到斜線 M N T。", "item": 4}
  ],
  "映像檔、套件管理與燒錄#7": [
   {"say": "掛載之後。", "item": 0},
   {"say": "用 L S 看斜線 M N T,就能看到根檔案系統裡面的內容。", "item": 1},
   {"say": "看完之後,先用 U mount 卸載,再用 lo setup 加上減號 D,把 loop 裝置釋放掉。", "item": 2}
  ],
  "closing": [
   {"say": "這一章就先到這裡。你已經認識 Yocto 的架構和名詞,會建立自己的 layer 和 recipe,也了解三種 init 的差別,還有映像檔和分區的樣貌。", "item": 0},
   {"say": "接下來,請動手做本章的練習,再完成章末小測驗,檢查自己學會了多少。我們下一章見!", "item": 1, "pause": 1}
  ]
 }
}
