{
 "byKey": {
  "cover": [
   {"say": "大家好,歡迎回到嵌入式 Linux 課。這一章要把開發環境準備好,內容有三個重點:交叉編譯和工具鏈、用 QEMU 模擬一台 ARM 機器,還有嵌入式除錯最重要的序列主控台。", "item": 0}
  ],
  "交叉編譯的概念與工具鏈#1": [
   {"say": "先來想一下,為什麼需要交叉編譯?目標板的 C P U 慢、記憶體小、儲存空間也有限,直接在板子上編譯大型程式,尤其是 kernel,又慢又不實際。", "item": 0},
   {"say": "所以我們改在速度快的開發 P C 上編譯,產生給另一種 C P U 執行的程式,這就叫做交叉編譯。這裡有三個名詞要分清楚。", "item": 0},
   {"say": "Build 是建置機,也就是執行編譯器的那台機器,例如你的 P C。", "item": 1},
   {"say": "Host 是執行機,是編出來的程式要跑的機器,例如 ARM 六十四位元的板子。", "item": 2},
   {"say": "Target 只有在編譯編譯器本身的時候才有意義,一般寫應用程式可以先不管它。不過要留意,很多文件會把板子叫做 target,讀文件的時候要看上下文。", "item": 3}
  ],
  "交叉編譯的概念與工具鏈#2": [
   {"say": "交叉編譯要靠工具鏈,那工具鏈裡面有什麼呢?", "item": 0},
   {"say": "首先是編譯器 G C C,或者 clang,還有組譯器和連結器,它們屬於 binutils 這一包,裡面也有 objdump、read E L F、strip 這些小工具。", "item": 1},
   {"say": "再來是 C 函式庫,常見的有 G lib C、musl,還有 U C lib C N G。你編出來的程式,會連結到它上面。", "item": 2},
   {"say": "第三是 kernel headers,它讓 C 函式庫和你的程式,知道系統呼叫的介面長什麼樣子。", "item": 3},
   {"say": "最後是除錯工具 G D B,它可以搭配 G D B server 做遠端除錯。", "item": 4}
  ],
  "交叉編譯的概念與工具鏈#3": [
   {"say": "工具鏈的名字都很長,其實是有規則的。", "item": 0},
   {"say": "交叉編譯器檔名前面那一串前綴,叫做 triplet,中文叫三元組。它的格式大致是架構、廠商、作業系統,再加上 A B I,中間用減號連起來。", "item": 1},
   {"say": "所以看前綴,就知道這個編譯器會產生哪一種目標的程式。使用的時候,會把前綴設定在 CROSS COMPILE 這個變數裡,傳給 Makefile。Kernel 和 U Boot 都是用這個慣例。", "item": 2}
  ],
  "交叉編譯的概念與工具鏈#4": [
   {"say": "我們來看幾個實際的名字。", "item": 0},
   {"say": "第一個,arm 開頭、結尾有 H F 的,是三十二位元 ARM 的編譯器,搭配 G lib C,而且使用硬體浮點。H F 就是 hard float 的意思。", "item": 1},
   {"say": "第二個,A arch 六十四開頭的,是六十四位元 ARM,搭配 G lib C。這門課最常用的就是它。", "item": 2},
   {"say": "第三個,RISC five 六十四開頭的,當然就是六十四位元的 RISC five,一樣搭配 G lib C。", "item": 3}
  ],
  "交叉編譯的概念與工具鏈#5": [
   {"say": "還有一個例子。", "item": 0},
   {"say": "這個名字裡面出現了 musl,代表它是三十二位元 ARM,但是 C 函式庫用的是 musl,而不是 G lib C。", "item": 1}
  ],
  "交叉編譯的概念與工具鏈#6": [
   {"say": "那工具鏈要去哪裡拿呢?有四種方式。", "item": 0},
   {"say": "第一種最簡單,直接裝發行版的套件。在 Debian 或 Ubuntu 上,用 A P T 就可以安裝。", "item": 1},
   {"say": "第二種是下載預先建好的工具鏈,例如 Arm 官方提供的版本,或是 Bootlin 的 toolchains 網站。", "item": 2},
   {"say": "第三種是讓建置系統自己產生。Buildroot 和 Yocto 都會建置或下載一套跟目標根檔案系統完全匹配的工具鏈。這也是最推薦的方式,因為 C 函式庫的版本,一定要和根檔案系統一致。", "item": 3},
   {"say": "第四種是 crosstool N G,可以自己調整參數來產生工具鏈。", "item": 4}
  ],
  "交叉編譯的概念與工具鏈#7": [
   {"say": "用套件安裝的話,就是畫面上這兩行。", "item": 0},
   {"say": "第一行用 sudo A P T install,安裝六十四位元 ARM 的 G C C。", "item": 1},
   {"say": "第二行安裝的是三十二位元 ARM、硬體浮點的版本。裝好之後,交叉編譯器就可以用了。", "item": 2}
  ],
  "實際交叉編譯 Hello World 並檢查結果#1": [
   {"say": "好,工具有了,我們實際來編一個 Hello World。", "item": 0},
   {"say": "先建立一個檔案,叫做 hello 點 C。", "item": 1},
   {"say": "程式的主要內容是:呼叫 uname 這個函式取得系統資訊,然後用 printf 印出一行 Hello from,後面接主機名稱,還有機器的架構。", "item": 2},
   {"say": "所以這個程式一執行,就會告訴我們它跑在哪一種機器上,非常適合拿來驗證交叉編譯的結果。", "item": 3}
  ],
  "實際交叉編譯 Hello World 並檢查結果#2": [
   {"say": "我們看一下完整的程式碼。", "item": 0},
   {"say": "最前面引入標準輸入輸出的標頭檔。", "item": 1},
   {"say": "第二行引入 uname 需要的標頭檔。", "item": 2},
   {"say": "接著是 main 函式。", "item": 3},
   {"say": "大括號裡面,就是剛剛說的那幾行:宣告一個結構、呼叫 uname、用 printf 印出來,最後回傳零。", "item": 4}
  ],
  "實際交叉編譯 Hello World 並檢查結果#3": [
   {"say": "程式的最後。", "item": 0},
   {"say": "用一個右大括號把 main 函式結束,整支程式就這麼短。", "item": 1}
  ],
  "實際交叉編譯 Hello World 並檢查結果#4": [
   {"say": "同一份原始碼,我們編出三種版本。", "item": 0},
   {"say": "第一行用 P C 上原本的 G C C,編出 X 八六的版本。", "item": 1},
   {"say": "第二行換成 A arch 六十四的交叉編譯器,編出 ARM 六十四位元的版本。", "item": 2},
   {"say": "第三行用三十二位元 ARM 的交叉編譯器,編出 ARM 三十二位元的版本。你會發現,指令的用法完全一樣,只是編譯器的名字換了。", "item": 3}
  ],
  "實際交叉編譯 Hello World 並檢查結果#5": [
   {"say": "編譯完先別急著執行,我們先檢查一下結果。", "item": 0},
   {"say": "第一個工具是 file,它可以告訴你這個執行檔是什麼架構。", "item": 1},
   {"say": "順帶一提,file 輸出的詳細字樣,不同版本會有一點點差異,不用太在意。", "item": 2},
   {"say": "想看更多細節,就用 read E L F。記得要用交叉工具鏈裡帶前綴的那一個版本。", "item": 3},
   {"say": "加上減號 H 看檔頭,可以看到 Class 是 E L F 六十四,Machine 是 A arch 六十四。", "item": 4},
   {"say": "加上減號 D,再篩選出 NEEDED 這個關鍵字,會列出執行時需要的共享函式庫,這裡是 lib C。之後如果遇到板子上缺少函式庫的問題,這就是排查的第一步。", "item": 5}
  ],
  "實際交叉編譯 Hello World 並檢查結果#6": [
   {"say": "我們看實際的輸出。", "item": 0},
   {"say": "用 file 一次檢查 X 八六和 ARM 六十四這兩個檔案。", "item": 1},
   {"say": "第一個檔案顯示是六十四位元的 E L F 執行檔,架構是 X 八六的六十四位元,是動態連結的,後面還寫出它用的動態載入器。", "item": 2},
   {"say": "第二個檔案同樣是六十四位元的 E L F,但是架構變成 ARM 的 A arch 六十四,動態載入器的路徑也跟著不一樣了。", "item": 3}
  ],
  "實際交叉編譯 Hello World 並檢查結果#7": [
   {"say": "再來是 read E L F 的兩個用法。", "item": 0},
   {"say": "第一行,用減號 H 顯示檔頭,再用 grep 只留下 Class 和 Machine 這兩行。", "item": 1},
   {"say": "第二行,用減號 D 顯示動態區段,再用 grep 找出 NEEDED,看它依賴哪些函式庫。", "item": 2}
  ],
  "QEMU 系統模擬與 virt 機型#1": [
   {"say": "編好的 ARM 程式要在哪裡跑呢?不一定要有板子,我們可以用 QEMU。", "item": 0},
   {"say": "沒有開發板、板子被你刷壞了,或是想做自動化測試的時候,QEMU 可以模擬一整台機器,包含 C P U、記憶體、序列埠、磁碟和網路,讓你載入自己編的 kernel 和根檔案系統。", "item": 1},
   {"say": "重開機只要幾秒鐘,弄壞了也不心疼。這門課大部分的實作,都會在 QEMU 上進行。", "item": 1}
  ],
  "QEMU 系統模擬與 virt 機型#2": [
   {"say": "QEMU 裡面有一個機型叫做 virt。它是專門為虛擬化和開發設計的虛構機型,不對應任何真實的板子,但是設計很乾淨,沒有真實硬體的怪癖,所以很多教學和 Buildroot 的範例都用它。", "item": 0},
   {"say": "六十四位元的話,用 QEMU system A arch 六十四這支程式,機型選 virt,C P U 選 Cortex A 五七。", "item": 1},
   {"say": "三十二位元的話,用 QEMU system arm,C P U 選 Cortex A 十五。指定機型的減號 M,和減號 machine 是一樣的意思。", "item": 2},
   {"say": "想知道支援哪些機型,在減號 M 後面接 help 就會列出來。", "item": 3},
   {"say": "想知道支援哪些 C P U,則是減號 cpu 後面接 help。安裝的話,在 Debian 或 Ubuntu 上裝 QEMU system arm 這個套件,三十二和六十四位元兩種都會包含在裡面。", "item": 4}
  ],
  "QEMU 系統模擬與 virt 機型#3": [
   {"say": "接下來看一個完整的啟動命令。假設我們已經有 kernel 的映像檔 Image,還有一個 E X T 四格式的根檔案系統映像檔。這個命令很長,我們一行一行看。", "item": 0},
   {"say": "第一行選機型 virt、C P U 是 Cortex A 五七,記憶體五百一十二 M B,兩個核心。", "item": 1},
   {"say": "第二行是 no graphic,不開圖形視窗。", "item": 2},
   {"say": "第三行用減號 kernel 指定要載入的 kernel 映像檔。", "item": 3},
   {"say": "第四行的 append,後面接的是 kernel 命令列,指定主控台,還有根檔案系統在 V D A 這個裝置上,用可讀寫的方式掛載。", "item": 4},
   {"say": "第五行的 drive,指定磁碟映像檔就是我們的根檔案系統,格式是 raw。", "item": 5}
  ],
  "QEMU 系統模擬與 virt 機型#4": [
   {"say": "命令還有後半段。", "item": 0},
   {"say": "這一行加上一個 virtio 區塊裝置,把剛剛那個磁碟接上去。", "item": 1},
   {"say": "這一行設定使用者模式的網路,並且做了連接埠轉送。", "item": 2},
   {"say": "最後一行加上一張 virtio 網路卡。好,接著來逐項說明。", "item": 3},
   {"say": "減號 M 後面的五一二,是記憶體五百一十二 M B。S M P 二,是兩個 C P U 核心。", "item": 4},
   {"say": "No graphic 是不開圖形視窗,直接把模擬出來的序列埠,接到你目前的終端機上。", "item": 5}
  ],
  "QEMU 系統模擬與 virt 機型#5": [
   {"say": "繼續說明其他的選項。", "item": 0},
   {"say": "減號 kernel 是直接載入 kernel,也就是跳過 bootloader。搭配的 append,就是傳給 kernel 的命令列。", "item": 1},
   {"say": "Drive 加上 virtio 區塊裝置這一組,是接上一顆 virtio 的磁碟,在系統裡面會看到它叫做斜線 dev 底下的 V D A。", "item": 2},
   {"say": "Net dev user 是 QEMU 內建的使用者模式網路,不需要 root 權限。後面的 host forward 設定,會把主機的兩千兩百二十二埠,轉到模擬機器裡的二十二埠,之後就可以用 S S H 連到本機的兩千兩百二十二埠登入。", "item": 3},
   {"say": "最後的 virtio net device,就是一張 virtio 的網路卡。", "item": 4}
  ],
  "QEMU 系統模擬與 virt 機型#6": [
   {"say": "把這些選項全部接在一起,就是一個完整的命令。", "item": 0},
   {"say": "命令從 QEMU system A arch 六十四開始,每一行結尾的反斜線,代表命令還沒結束,下一行繼續。你不用背,需要的時候回來對照就可以了。", "item": 1}
  ],
  "QEMU 系統模擬與 virt 機型#7": [
   {"say": "進去之後,要怎麼離開 QEMU 呢?", "item": 0},
   {"say": "在 no graphic 模式下,先按 Control A,放開之後再按 X,就可以結束 QEMU。如果是 Control A 之後按 C,會進入 QEMU 的 monitor。這個組合鍵一定要記住,不然很容易關不掉。", "item": 1}
  ],
  "序列主控台:UART 連線與 console 設定#1": [
   {"say": "接下來談序列主控台。為什麼嵌入式開發這麼依賴它呢?", "item": 0},
   {"say": "因為開發板常常沒有螢幕,網路又可能還沒設定好。而 U A R T 序列埠只需要三條線,在 bootloader、kernel、init 的每一個階段,都能輸出訊息、接受輸入,是嵌入式除錯最可靠的管道。看不到序列輸出,就像蒙著眼睛修機器。", "item": 1},
   {"say": "硬體要怎麼接呢?第一步,準備一條 U S B 轉 T T L 的序列線,並且確認它是三點三伏特的準位。有些線可以用跳線來切換。", "item": 2},
   {"say": "第二步是接線,要交叉接。序列線的傳送接板子的接收,序列線的接收接板子的傳送,地線接地線。", "item": 3},
   {"say": "第三步,不要把序列線上的五伏特或三點三伏特電源線接到板子上,除非你很清楚要用它來供電,不然可能造成電源衝突。", "item": 4}
  ],
  "序列主控台:UART 連線與 console 設定#2": [
   {"say": "繼續看硬體連接,還有通訊參數和主機端的工具。", "item": 0},
   {"say": "如果你用的是 Raspberry Pi,序列腳位在四十針排針上的 G P I O 十四和十五,再加上一支接地腳。另外要在 config 點 T X T 裡把 U A R T 啟用。Pi 三和 Pi 四上面,藍牙和序列埠的對應關係會因型號和設定而不同,請查官方文件。", "item": 1},
   {"say": "通訊參數最常見的是一一五二零零、八 N 一。意思是鮑率十一萬五千兩百、八個資料位元、沒有同位檢查、一個停止位元,而且沒有流量控制。兩端的參數如果不一致,你就會看到一堆亂碼。", "item": 2},
   {"say": "主機端常用的終端程式有三個,先記一下它們怎麼離開。picocom 是先按 Control A,再按 Control X。", "item": 3},
   {"say": "screen 是 Control A 之後按 K,再按 Y 確認。", "item": 4},
   {"say": "minicom 是 Control A 之後按 X。", "item": 5}
  ],
  "序列主控台:UART 連線與 console 設定#3": [
   {"say": "那這些工具怎麼用呢?序列線插上去之後,Linux 主機通常會多出一個裝置,名字是 T T Y U S B 零,或是 T T Y A C M 零。", "item": 0},
   {"say": "可以用 L S 列出斜線 dev 底下,T T Y U S B 開頭的裝置。", "item": 1},
   {"say": "也可以用 D mesg 接管線到 tail,看最後幾行訊息,確認剛插上去的裝置叫什麼名字。", "item": 2},
   {"say": "接著任選一種終端程式。例如用 A P T 安裝 picocom。", "item": 3},
   {"say": "然後執行 picocom,用減號 B 指定鮑率十一萬五千兩百,後面接裝置的路徑。", "item": 4},
   {"say": "如果用 screen,就是 screen 後面接裝置路徑,再接鮑率。", "item": 5}
  ],
  "序列主控台:UART 連線與 console 設定#4": [
   {"say": "還有兩個指令。", "item": 0},
   {"say": "用 minicom 的話,減號大寫 D 指定裝置,減號 B 指定鮑率。", "item": 1},
   {"say": "如果出現 Permission denied,是因為這個序列裝置通常屬於 dial out 群組。用畫面上這行 user mod 指令,把自己加進 dial out 群組,登出再登入之後就會生效。不建議長期用 sudo 來執行終端程式。", "item": 2}
  ],
  "序列主控台:UART 連線與 console 設定#5": [
   {"say": "線接好了,kernel 這邊也要設定,訊息才會送到正確的地方。", "item": 0},
   {"say": "Kernel 命令列裡的 console 參數,決定主控台要輸出到哪裡。", "item": 1},
   {"say": "這個參數可以寫很多個,每一個都會收到訊息,而最後一個會成為斜線 dev 底下的 console。", "item": 2},
   {"say": "實際的裝置名稱,會因為 S o C 和裝置樹而不同,可以查板子的文件,或是去看 proc 底下 device tree 裡面,chosen 節點的 stdout path。", "item": 3},
   {"say": "裝置樹的 chosen 節點,也可以用 stdout path 這個屬性來指定主控台,像畫面上寫的,就是第零個序列埠,鮑率十一萬五千兩百。", "item": 4}
  ],
  "序列主控台:UART 連線與 console 設定#6": [
   {"say": "我們來看幾種常見的寫法。", "item": 0},
   {"say": "T T Y S 零,是一般 P C 和部分 S o C 上,一六五五零相容的序列埠。", "item": 1},
   {"say": "T T Y A M A 零,是 ARM 的 P L 零一一序列埠,QEMU 的 virt 機型和 Raspberry Pi 都會用到。", "item": 2},
   {"say": "T T Y M X C 零,是 N X P 的 i M X 系列在用的。", "item": 3},
   {"say": "如果寫 T T Y 一,指的就是螢幕。", "item": 4}
  ],
  "序列主控台:UART 連線與 console 設定#7": [
   {"say": "最後看兩個例子。", "item": 0},
   {"say": "第一個例子寫了兩個 console,一個是螢幕,一個是序列埠,所以兩邊都看得到 kernel 的訊息。", "item": 1},
   {"say": "第二個例子是裝置樹裡的 chosen 節點。", "item": 2},
   {"say": "大括號裡面,寫的就是剛剛提到的 stdout path 屬性。", "item": 3}
  ],
  "closing": [
   {"say": "這一章就先到這裡。你已經學會交叉編譯的觀念、怎麼檢查編出來的執行檔、怎麼用 QEMU 開一台虛擬的 ARM 機器,還有序列主控台的接法和設定。", "item": 0},
   {"say": "接下來,請動手做本章的實作練習,再完成章末小測驗,檢查自己學會了多少。我們下一章見!", "item": 1, "pause": 1}
  ]
 }
}
