{
 "byKey": {
  "cover": [
   {"say": "大家好,歡迎回到嵌入式 Linux 課。這一章要開始碰硬體了。我們會從使用者空間,去存取 G P I O、I 平方 C 和 S P I 這三種最常見的硬體介面,每一種都會看命令列工具,也會看 C 程式怎麼寫。", "item": 0}
  ],
  "GPIO 與 libgpiod:取代 sysfs 的新介面#1": [
   {"say": "先從最基本的 G P I O 開始。", "item": 0},
   {"say": "G P I O 是通用輸入輸出的縮寫,它是 S o C 上面,可以用軟體控制高低電位的腳位。設成輸出,可以點亮 L E D、驅動繼電器。設成輸入,可以讀取按鈕,或是感測器的開關狀態。", "item": 1},
   {"say": "要注意,腳位通常是三點三伏特的邏輯,而且電流能力很小,每支腳常常只有幾毫安培。所以不可以直接推動馬達或大電流的負載,也不可以直接接五伏特。", "item": 1}
  ],
  "GPIO 與 libgpiod:取代 sysfs 的新介面#2": [
   {"say": "那 kernel 是怎麼管理 G P I O 的呢?", "item": 0},
   {"say": "在 Linux 裡,每一個 G P I O 控制器,會註冊成一個 G P I O chip。每個 chip 裡面有若干條線,英文叫 line,用偏移量來編號。", "item": 1},
   {"say": "使用者空間是透過斜線 dev 底下,G P I O chip 零、G P I O chip 一這些字元裝置來存取的,kernel 要開啟對應的設定才會有。還有,chip 的編號和腳位名稱,每塊板子都不一樣,一定要用工具查,不要憑印象。", "item": 1}
  ],
  "GPIO 與 libgpiod:取代 sysfs 的新介面#3": [
   {"say": "講新介面之前,要先提醒你一個已經被棄用的舊介面。", "item": 0},
   {"say": "很多比較舊的教學,會教你用 sys F S 來控制 G P I O。", "item": 1},
   {"say": "但是這個 sys F S 介面,從 Linux 四點八開始就被標示為棄用,只保留相容的用途,新版的 kernel 常常預設就關閉了。而且它用的全域編號,會隨著 G P I O chip 註冊的順序改變,並不可靠。", "item": 2},
   {"say": "舊的做法是這樣:先把腳位編號十七,寫進 export 這個檔案。", "item": 3},
   {"say": "再把 out 寫進 direction,設成輸出。", "item": 4},
   {"say": "最後把一寫進 value,輸出高電位。這種做法在程式結束時也不會自動釋放線路,又缺少事件之類的功能。所以新的專案,請改用字元裝置介面,也就是接下來要講的 lib G P I O D。", "item": 5}
  ],
  "GPIO 與 libgpiod:取代 sysfs 的新介面#4": [
   {"say": "lib G P I O D 提供一個函式庫,還有一組命令列工具。", "item": 0},
   {"say": "在 Debian 或 Ubuntu 上,用 A P T 就可以安裝。", "item": 1},
   {"say": "如果用 Buildroot,在 Target packages 裡面勾選 lib G P I O D,並且勾選要安裝工具。用 Yocto 的話,就加入 lib G P I O D 和它的 tools 套件。", "item": 2},
   {"say": "接下來的範例,用的是 lib G P I O D 一點六版的語法。", "item": 3},
   {"say": "另外,範例裡的輸出只是示意,你的板子顯示的內容會不一樣。", "item": 4}
  ],
  "GPIO 與 libgpiod:取代 sysfs 的新介面#5": [
   {"say": "我們先看安裝指令,還有有哪些工具。", "item": 0},
   {"say": "安裝的是 G P I O D 和它的開發套件。", "item": 1},
   {"say": "第一個工具 G P I O detect,會列出所有的 G P I O chip。", "item": 2},
   {"say": "第二個 G P I O info,會列出每一條線的名稱、方向、目前是誰在使用,還有狀態。", "item": 3},
   {"say": "第三個 G P I O get,用來讀取輸入線的值。", "item": 4}
  ],
  "GPIO 與 libgpiod:取代 sysfs 的新介面#6": [
   {"say": "還有兩個工具,然後看實際操作。", "item": 0},
   {"say": "G P I O set,用來設定輸出線的值。", "item": 1},
   {"say": "G P I O mon,用來監看邊緣事件,例如按鈕被按下。", "item": 2},
   {"say": "實際操作,先執行 G P I O detect。", "item": 3},
   {"say": "它回報有一個 G P I O chip 零,後面是控制器的名稱,總共有五十四條線。", "item": 4},
   {"say": "接著用 G P I O info 看 chip 零的每一條線,因為很長,用管線接到 head,只看前面幾行。", "item": 5}
  ],
  "GPIO 與 libgpiod:取代 sysfs 的新介面#7": [
   {"say": "再來是讀和寫。", "item": 0},
   {"say": "用 G P I O get,讀取 chip 零的第十七號線。", "item": 1},
   {"say": "它回傳零,代表現在是低電位。", "item": 2},
   {"say": "用 G P I O set,把第十七號線設成一,輸出高電位。", "item": 3},
   {"say": "也可以加上時間模式的選項,讓它維持兩秒鐘。", "item": 4},
   {"say": "最後用 G P I O mon,監看第二十二號線的上升邊緣,按鈕按下去的時候,就會印出事件。", "item": 5}
  ],
  "用 C 程式與 LED 子系統控制 GPIO#1": [
   {"say": "如果要控制 L E D 這一類的輸出,其實有兩條合理的路可以走。", "item": 0},
   {"say": "第一條是 L E D 子系統。在裝置樹裡宣告 G P I O L E D S,這顆燈就交給 kernel 管理,使用者空間透過 sys class L E D S 來控制,還可以使用觸發器。", "item": 1},
   {"say": "要分清楚的是,它的 sys F S 介面是 L E D 類別的正式介面,和剛剛說的已棄用的 sys F S G P I O 不一樣。", "item": 1},
   {"say": "第二條是 lib G P I O D 函式庫。由你的程式自己持有 G P I O 線,適合按鈕輸入,和一般用途的控制。", "item": 2},
   {"say": "先看 L E D 子系統。只要裝置樹裡有 compatible 是 G P I O L E D S 的節點,就像第三章做過的那樣,開機之後就可以在 sys 底下看到它。", "item": 3},
   {"say": "其中 trigger 這個檔案,決定 L E D 的行為。例如 heartbeat 是心跳、timer 是週期性閃爍、M M C 零是跟著磁碟活動閃。可以用哪些觸發器,要看 kernel 的設定。", "item": 4}
  ],
  "用 C 程式與 LED 子系統控制 GPIO#2": [
   {"say": "我們實際操作看看。", "item": 0},
   {"say": "先用 L S 看 sys class L E D S 目錄。", "item": 1},
   {"say": "裡面有一顆叫 debug 的燈。", "item": 2},
   {"say": "用 cat 讀它的 trigger 檔。", "item": 3},
   {"say": "它會列出所有可用的觸發器,其中用中括號框起來的,就是目前正在使用的,這裡是 heartbeat。", "item": 4}
  ],
  "用 C 程式與 LED 子系統控制 GPIO#3": [
   {"say": "接著改變它的行為。", "item": 0},
   {"say": "把 none 寫進 trigger,關掉觸發器。", "item": 1},
   {"say": "把一寫進 brightness,手動把燈點亮。", "item": 2},
   {"say": "把 timer 寫進 trigger,改成週期性閃爍。", "item": 3}
  ],
  "用 C 程式與 LED 子系統控制 GPIO#4": [
   {"say": "選了 timer 之後,目錄裡才會多出兩個檔案。", "item": 0},
   {"say": "把兩百寫進 delay on,代表每次亮兩百毫秒。", "item": 1},
   {"say": "把八百寫進 delay off,代表每次暗八百毫秒。還有一點要注意:已經被 G P I O L E D S 佔用的腳位,就不能再用 lib G P I O D 去要求,不然會出現 busy 的錯誤。", "item": 2}
  ],
  "用 C 程式與 LED 子系統控制 GPIO#5": [
   {"say": "再來看第二條路,用 lib G P I O D 一點六版的 C A P I,寫一個讓 L E D 閃爍的程式。", "item": 0},
   {"say": "檔名叫做 led 點 C。", "item": 1},
   {"say": "第一步,用名稱打開 G P I O chip 零。如果失敗,就印出錯誤訊息然後結束。", "item": 2},
   {"say": "第二步,從這個 chip 取得第十七號線。失敗的話,要記得先把 chip 關掉再結束。", "item": 3},
   {"say": "第三步,要求把這條線當作輸出使用,並且給它一個使用者名稱,初始值是零。", "item": 4},
   {"say": "第四步是一個跑十次的迴圈。每一次把輸出值在零和一之間切換,然後睡半秒鐘,所以燈就會一亮一滅地閃。", "item": 5}
  ],
  "用 C 程式與 LED 子系統控制 GPIO#6": [
   {"say": "程式的結尾,還有編譯的方式。", "item": 0},
   {"say": "迴圈結束之後,把線釋放、把 chip 關閉,然後回傳零。用完要釋放,是寫這類程式的好習慣。", "item": 1},
   {"say": "編譯的時候,用 G C C 並且連結 G P I O D 這個函式庫,編好就可以直接執行。", "item": 2},
   {"say": "如果要交叉編譯,就改用 A arch 六十四的 G C C。不過你需要目標架構版本的 lib G P I O D 和標頭檔,所以最方便的做法,是直接用 Buildroot 或 Yocto 提供的工具鏈和 sysroot。", "item": 3}
  ],
  "用 C 程式與 LED 子系統控制 GPIO#7": [
   {"say": "看一下程式開頭的部分。", "item": 0},
   {"say": "第一個引入的是 G P I O D 的標頭檔。", "item": 1},
   {"say": "第二個是標準輸入輸出。", "item": 2},
   {"say": "第三個是 U N I S T D,因為要用到睡眠的函式。", "item": 3},
   {"say": "接著是 main 函式。", "item": 4},
   {"say": "大括號裡面,就是剛剛說明過的那四個步驟。", "item": 5}
  ],
  "I2C:i2c-tools 與 /dev/i2c-N#1": [
   {"say": "接下來是 I 平方 C。", "item": 0},
   {"say": "I 平方 C 用兩條線,S D A 是資料,S C L 是時脈,再加上共地,就可以掛上很多裝置,像感測器、E E PROM、即時時鐘。每個從屬裝置有一個七位元的位址,主控端就用位址來選擇要跟誰通訊。", "item": 1},
   {"say": "常見的速率是標準的一百 K 赫茲,和快速的四百 K 赫茲。線路需要上拉電阻,很多開發板已經內建了。電平同樣是三點三伏特。", "item": 1},
   {"say": "要使用它,kernel 要開啟 I 平方 C 的支援、板子的控制器驅動,還有 I 平方 C 的字元裝置。有了字元裝置,使用者空間才會有斜線 dev 底下的裝置節點可以用。裝置樹裡,控制器節點的 status 也要是 okay。", "item": 2},
   {"say": "設定好並且重新開機之後,就可以確認裝置節點有沒有出現。", "item": 3},
   {"say": "如果沒有看到節點,而這個功能是編成模組的話,要用 mod probe 把 I 平方 C dev 這個模組載入。", "item": 4}
  ],
  "I2C:i2c-tools 與 /dev/i2c-N#2": [
   {"say": "以 Raspberry Pi O S 為例,啟用的方式是這樣。", "item": 0},
   {"say": "可以執行 raspi config,在 Interface Options 裡把 I 平方 C 打開。", "item": 1},
   {"say": "或者在 config 點 T X T 裡,加入第三章看過的那一行 D T param。", "item": 2},
   {"say": "重新開機之後,用 L S 列出斜線 dev 底下,I 平方 C 開頭的裝置。", "item": 3},
   {"say": "看到編號一的 I 平方 C 裝置,就代表成功了。", "item": 4}
  ],
  "I2C:i2c-tools 與 /dev/i2c-N#3": [
   {"say": "操作 I 平方 C 最常用的是 I 平方 C tools 這組工具。指令等一下看,先講幾個重要的注意事項。", "item": 0},
   {"say": "指令裡的減號 Y,代表略過互動式的確認。", "item": 1},
   {"say": "掃描結果裡,兩個減號代表沒有回應,出現數字代表那個位址有裝置回應。如果顯示兩個大寫的 U,表示那個位址已經被 kernel 的驅動佔用,使用者空間就不應該再直接存取。", "item": 2},
   {"say": "掃描的動作有可能干擾某些裝置。所以在量產的機器,或是不熟悉的匯流排上,不要隨便執行,尤其是接了電源管理晶片或電池充電器的匯流排。", "item": 3},
   {"say": "還有,I 平方 C set 是真的會寫入裝置的暫存器。寫錯 E E PROM 或電源管理晶片的暫存器,可能會把設定弄壞。所以操作之前,一定要先查 datasheet。", "item": 4}
  ],
  "I2C:i2c-tools 與 /dev/i2c-N#4": [
   {"say": "來看實際的指令。", "item": 0},
   {"say": "先用 A P T 安裝 I 平方 C tools。", "item": 1},
   {"say": "I 平方 C detect 加上減號 L,列出系統上所有的 I 平方 C 匯流排。", "item": 2},
   {"say": "這裡的輸出顯示有一條編號一的匯流排,後面是控制器的名稱。", "item": 3},
   {"say": "接著用 sudo 執行 I 平方 C detect,加上減號 Y 和匯流排編號一,掃描這條匯流排上有哪些位址有回應。", "item": 4}
  ],
  "I2C:i2c-tools 與 /dev/i2c-N#5": [
   {"say": "掃描的結果是一張表格。", "item": 0},
   {"say": "每一列代表一段位址,沒有回應的位置顯示兩個減號。", "item": 1},
   {"say": "在四十那一列,可以看到出現了四八,代表十六進位四八這個位址上有一個裝置。", "item": 2},
   {"say": "其他的列就省略了。", "item": 3}
  ],
  "I2C:i2c-tools 與 /dev/i2c-N#6": [
   {"say": "找到裝置之後,就可以讀寫它。", "item": 0},
   {"say": "I 平方 C get 用來讀取。這一行是讀取剛剛那個裝置的第零號暫存器,最後的 W,代表要讀十六位元的字組。", "item": 1},
   {"say": "I 平方 C set 用來寫入。這一行是把一個值寫進第一號暫存器。", "item": 2},
   {"say": "I 平方 C dump 則是把整個裝置的暫存器,全部傾印出來看。", "item": 3}
  ],
  "I2C:i2c-tools 與 /dev/i2c-N#7": [
   {"say": "最後看怎麼在 C 程式裡讀取,用 T M P 一零二這一類的溫度感測器當例子。", "item": 0},
   {"say": "假設它接在匯流排一,位址是十六進位的四八。這顆晶片的溫度是十二位元,解析度是零點零六二五度,溫度放在第零號暫存器。", "item": 1},
   {"say": "程式先打開 I 平方 C 的裝置檔,再用 I O control 搭配 I 平方 C SLAVE,選擇要通訊的位址。", "item": 2},
   {"say": "然後先寫入一個位元組,告訴晶片要讀哪個暫存器,再讀回兩個位元組的資料。", "item": 3},
   {"say": "最後把兩個位元組組合起來,取出十二位元的原始值,處理負溫度的情況,再乘上解析度,就得到攝氏溫度。", "item": 4},
   {"say": "重點是三件事:用 I 平方 C SLAVE 選位址;先寫暫存器位址,再讀資料;資料位元怎麼排列,每顆晶片都不同,要讀 datasheet。如果那個位址已經被 kernel 驅動佔用,I O control 會失敗,回報裝置忙碌中。", "item": 4}
  ],
  "SPI 與 UART:spidev 與序列埠存取#1": [
   {"say": "第三種介面是 S P I。它用四條線:時脈、主出從入、主入從出,還有晶片選擇線,每個從屬裝置各有一條。它是全雙工的,速度很快,常用在 Flash、顯示器、類比數位轉換器和無線模組。使用時有四個重要的參數。", "item": 0},
   {"say": "第一是模式,從零到三共四種,是時脈極性和相位的組合,一定要和裝置的 datasheet 一致。", "item": 1},
   {"say": "第二是最大時脈頻率。", "item": 2},
   {"say": "第三是每個字的位元數,通常是八。", "item": 3},
   {"say": "第四是位元順序,通常是最高位元先送。", "item": 4}
  ],
  "SPI 與 UART:spidev 與序列埠存取#2": [
   {"say": "要從使用者空間存取 S P I,靠的是 S P I dev 這個驅動。", "item": 0},
   {"say": "它會提供斜線 dev 底下的裝置檔,檔名裡有兩個數字,前面是匯流排的編號,後面是片選的編號。要啟用它,kernel 要開啟 S P I、控制器驅動和 S P I dev 的設定,裝置樹也要有對應的節點。", "item": 1},
   {"say": "在 Raspberry Pi 上,只要用 D T param 把 S P I 打開,重新開機之後,就會出現零點零和零點一這兩個 S P I dev 裝置。", "item": 2},
   {"say": "如果是一般自訂的板子,要自己在裝置樹裡寫節點。先引用 S P I 零這個控制器,把 status 設成 okay。", "item": 3},
   {"say": "再加上一個子節點。要注意它的 compatible,必須是 S P I dev 驅動接受的字串。比較新的 kernel 已經不接受單純寫 S P I dev 了,必須用已經註冊的裝置 I D,畫面上的只是借用的範例。細節依 kernel 版本而定。", "item": 4},
   {"say": "另外,正式的產品,建議替你的裝置寫真正的 kernel 驅動。S P I dev 主要是用在原型和測試階段。", "item": 5}
  ],
  "SPI 與 UART:spidev 與序列埠存取#3": [
   {"say": "把剛剛說的設定再對照一次。", "item": 0},
   {"say": "這一行是 Raspberry Pi 的 config 點 T X T 設定,把 S P I 打開。", "item": 1},
   {"say": "這是自訂板子的裝置樹寫法,用標籤引用 S P I 零控制器,裡面的子節點寫了 compatible、片選編號零,還有最大頻率。", "item": 2},
   {"say": "最後用右大括號和分號結束。", "item": 3}
  ],
  "SPI 與 UART:spidev 與序列埠存取#4": [
   {"say": "怎麼確認 S P I 是通的呢?可以做一個迴路測試。", "item": 0},
   {"say": "做法是不接任何 S P I 裝置,直接用一條跳線,把主出和主入這兩支腳短接。這樣送出去的資料,就會被自己收回來。Kernel 原始碼的 tools 目錄裡,有一支 S P I dev test 程式,編譯之後就可以做這個測試。", "item": 1},
   {"say": "如果收到的資料和送出去的一模一樣,就代表控制器和接線都正常。", "item": 2},
   {"say": "第一個指令,用減號大寫 D 指定裝置,用減號 S 指定速度,這裡是五十萬赫茲。", "item": 3},
   {"say": "第二個指令加上減號 V,會把送出和收到的資料詳細印出來。", "item": 4}
  ],
  "SPI 與 UART:spidev 與序列埠存取#5": [
   {"say": "最後來看 C 程式怎麼做一次 S P I 傳輸。", "item": 0},
   {"say": "第一步,打開 S P I dev 的裝置檔,失敗就結束。", "item": 1},
   {"say": "第二步,用三個 I O control 呼叫,分別設定模式零、每字八位元,還有速度五十萬赫茲。", "item": 2},
   {"say": "第三步,準備一個四個位元組的傳送緩衝區,和一個同樣大小的接收緩衝區,把它們填進一個傳輸結構裡,再用一次 I O control 把訊息送出去。因為是全雙工,送的同時就收到資料了,最後把收到的位元組印出來。", "item": 3},
   {"say": "傳送的第一個位元組,是很多 S P I NOR Flash 的讀取 JEDEC I D 指令。這個範例只是用來說明流程,實際的指令和回傳格式,要看你那顆晶片的 datasheet。", "item": 4}
  ],
  "SPI 與 UART:spidev 與序列埠存取#6": [
   {"say": "這支程式開頭引入的標頭檔比較多,我們快速看過。", "item": 0},
   {"say": "F C N T L,開檔要用的。", "item": 1},
   {"say": "S P I dev 的標頭檔,定義了那些 I O control 的命令。", "item": 2},
   {"say": "標準整數型別。", "item": 3},
   {"say": "標準輸入輸出。", "item": 4},
   {"say": "字串處理。", "item": 5},
   {"say": "還有 I O control 本身的標頭檔。", "item": 6}
  ],
  "SPI 與 UART:spidev 與序列埠存取#7": [
   {"say": "最後一段。", "item": 0},
   {"say": "再引入 U N I S T D。", "item": 1},
   {"say": "然後是 main 函式。", "item": 2},
   {"say": "左大括號開始。", "item": 3},
   {"say": "到右大括號結束,中間就是前面說明過的三個步驟。", "item": 4}
  ],
  "closing": [
   {"say": "這一章就先到這裡。你已經學會用 lib G P I O D 和 L E D 子系統控制 G P I O,用 I 平方 C tools 和 C 程式讀取 I 平方 C 裝置,也知道怎麼透過 S P I dev 存取 S P I 了。", "item": 0},
   {"say": "接下來,請動手做本章的練習,再完成章末小測驗,檢查自己學會了多少。我們下一章見!", "item": 1, "pause": 1}
  ]
 }
}
