Yocto Project 如何編譯出 ToolChain，如何使用 Toolchain編譯

 Yocto 目前已經是各大IC廠在使用的專案類型，與之相似的，有OpenWRT 或是 BuildRoot

今天要介紹如何從Yocto Project 編譯出ToolChain，並且會說明如何使用ToolChain，最後會說明如何編譯一個簡單的Hello World.

如何編譯出ToolChain
首先我們可以使用以下的Command來編譯出 ToolChain
# bitbake meta-toolchain

編譯完成後，在 build/tmp/deploy/ 資料夾底下，會多出 sdk 資料夾，而裡面會有 ToolChain安裝檔，如下圖:

如何安裝ToolChain
把上面編譯出來的ToolChain安裝檔，執行並且加上參數 -h ，可以看到此安裝檔的使用說明，如下所示:

./oecore-x86_64-aarch64-toolchain-nodistro.0.sh -h
Usage: oecore-x86_64-aarch64-toolchain-nodistro.0.sh [-y] [-d <dir>]
  -y         Automatic yes to all prompts
  -d <dir>   Install the SDK to <dir>
======== Extensible SDK only options ============
  -n         Do not prepare the build system
  -p         Publish mode (implies -n)
======== Advanced DEBUGGING ONLY OPTIONS ========
  -S         Save relocation scripts
  -R         Do not relocate executables
  -D         use set -x to see what is going on
  -l         list files that will be extracted

如果沒有使用 "-d" 來指定安裝路徑，則系統預設會安裝在 /usr/local/oecore-x86_64/
簡單的安裝指令如下，會把ToolChain安裝在 /opt/ 路徑下:
# ./oecore-x86_64-aarch64-toolchain-nodistro.0.sh -d /opt/

可以看到 /opt/ 底下有一些檔案，有一些是環境變數設定檔，而ToolChain都在 sysroot資料夾底下

如何編譯可以放在開發版上的 HelloWorld 程式
假設剛剛我們把ToolChain安裝在 /opt/ 底下，我們可以先使用下面指令來設定一些環境變數
# source /opt/environment-setup-aarch64-poky-linux

環境變數設定好之後，變數 $CC 會是預設的ToolChain執行檔，印出 $CC 這個變數，可以看到如下圖片:

接著先撰寫好簡單的helloWorld.c 小程式，用下面的Command編譯，就可以編譯出開發板可以Run的小程式
# $CC helloWorld.c -o hello

由這邊也可以發現，當要自己加入Package 到 Yocto Project，通常這個Package的 Makefile裡面，不能指定CC的值，不然編譯會出問題，關於這個議題，我再開一篇文章來講解如何加一個Package到 Yocto Project...

vi / vim 常用的搜尋方法

以下方式都是在command 模式，(按小寫i 就會切換到編輯模式，在按一次ESC會切到command模式)

1. 將游標移到字串上，直接按"*" ，可以直接做向下搜尋

2. 輸入"/"， 接著輸入字串，可以向下搜尋此字串，接著按"n"，可以向下搜尋，按"N"，可以向上搜尋

3. 按下"?"， 接著輸入字串，可以向上搜尋字串，接著按"n"，可以向上搜尋，按"N"，可以向下搜尋

4. 按下":"，輸入"set num"，可以列出整篇文字檔的"行號" 

insert BT module hci_uart.ko 的時候，遇到 Unknown symbol in module 的 Error 訊息

 今天在開發platform的時候，準備要把編譯好的 NXP BT module 做insert的動作，卻出現了如下面所列的錯誤訊息:

insmod: ERROR: could not insert module hci_uart.ko: Unknown symbol in module
[   79.719642] .(1)[5227:insmod]hci_uart: Unknown symbol hci_free_dev (err -2)
[   79.719810] .(1)[5227:insmod]hci_uart: Unknown symbol hci_alloc_dev (err -2)
[   79.719875] .(1)[5227:insmod]hci_uart: Unknown symbol hci_unregister_dev (err -2)
[   79.719889] .(1)[5227:insmod]hci_uart: Unknown symbol hci_recv_frame (err -2)
[   79.719927] .(1)[5227:insmod]hci_uart: Unknown symbol hci_register_dev (err -2)

以下我們將一步步來說明，如何找出這個問題的原因

1. 首先我們先到linux kernel driver底下，我們使用grep 來找一下，到底哪裡實作了 hci_free_dev()
# grep -rn hci_free_dev
結果找到的都是呼叫此function的地方，於是我們再往上一層路徑去尋找

2. 我們在kernel底下，再次輸入grep 指令來尋找看看哪裡實作了 hci_free_dev()
# grep -rn hci_free_dev
結果發現，此function實作在 net/bluetooth/hci_core.c 當中

3. 因為是Unkown Symbol錯誤，其原因可能是 kernel config 沒有開到需要的功能，導致找不到function實作的地方。
所以我們可以切換到 net資料夾底下，查看Makefile檔案，看看 bluetooth/hci_core.c 要開啟那些 config才會被編譯到。於是，我們發現，CONFIG_BT必須在Kernel Config當中被開啟才行

4. 接著準備去開啟kernel的config檔案。依據每個專案不同，位置與檔案名稱不一定相同，一般原生linux會是在 kernel/linux/v4.19/.config，我們編輯.config來查看CONFIG_BT的設定。
我們發現這邊設定為m，表示module的意思，Linux在開機過程，不會自動insert此 module，除非自己手動 insmod。因此我們把 "CONFIG_BT=m" 改為 "CONFIG_BT=y"，然後重新編譯。
*如果找不到 CONFIG_BT，則必須自己加入字串CONFIG_BT=y，來做設定

5. 在重新編譯過後，再去insert hci_uart.ko，就沒有再報錯誤，問題就解決了!

git 打 patch的方法

 假設我現在的Source code有git資訊，也就是可以用 "git status" 或是 "git diff" 等指令來查看目前狀態或是差異

 假設我目前修改了檔案，路徑與檔名為
  /home/danny/src/example/aaa.c
 當前所在目錄為 /home/danny/ 底下

打一個patch(讓別人Merge你的修改) 
於是我們可以很簡單的，使用下面的命令，先打一個patch檔案
 git diff src/example/aaa.c > aaa.c.patch
於是就會多出一個檔案，位於 /home/danny/aaa.c.patch

 aaa.c.patch大概內容會如下，可以看到差異:

--- a/src/example/aaa.c
+++ b/src/example/aaa.c
@@ -33,7 +33,11 @@
-      printf("Hello\n");
+     printf("Hello World\n");

如何把patch檔Merge入自己的code
假設我現在是在 /home/andy/ 目錄下，先把 aaa.c.patch 複製到此目錄底下
接著確定此檔案確實存在 src/example/aaa.c
使用以下指令把patch檔打入
  patch -p1 < aaa.c.patch

這樣就可以了!!

編譯遇到 error: braces around scalar initializer [-Werror] 的解決方法

首先 braces 中文意思為 "大括號"，

而編譯出現這個錯誤訊息時，十之八九問題出在少了對稱的大括號，

因此請仔細檢查一下，是否漏了"{" 或是加錯地方.

當要 export GPIO, 或是使用 gpio_request 遇到 write error: Device or resource busy 的解決方法

 當使用  echo 0 > /sys/class/gpio/export
kernel卻拋出 -sh: echo: write error: Device or resource busy

這表示此GPIO正被某個driver占用，因此你沒辦法申請這個GPIO來使用
而這個問題的解決方法，只能找出是哪個driver code, 做完 gpio_request()之後 卻沒有做 gpio_free()的地方

另外可以使用下面指令來查看那些gpio被占用

cat /sys/kernel/debug/gpio

=======================================================

另外下面記錄一些gpio操作的指令

第一步可以先ls /sys/class/gpio，有的可以從這邊看到gpio的base值 

(例如base=268, gpio0在下面的操作就要echo 268+0, gpio10就會是 268+10)

1. request gpio
echo 0 > /sys/class/gpio/export

2. check dicrection value
cat /sys/class/gpio/gpio0/direction

3. change direction
echo out > /sys/class/gpio/gpio0/direction

4. check output value
cat /sys/class/gpio/gpio0/value

5. change output value to high
echo 1 > /sys/class/gpio/gpio0/value

6. free the gpio
echo 0 > /sys/class/gpio/unexport

Linux Terminal 顯示亂碼

 如果再Linux teminal底下，遇到顯示亂碼的問題，可以用下面的指令解決

$ export LANG=zh_CN.UTF-8