接下來的實驗中，會寫一個把 GPIO 當作是中斷的來源的程式。這個 GPIO 由 Arduino 發出，每當邊緣上升時，忌諱觸發一次 IRQ。
這個應用比如說 DHT11 在核心的驅動程式，就是用這種機制來實作從 DHT11 收到的訊號：每次發生 edge-triggered 時，都把資料紀錄推進 buffer 最後方，最後再解析整個 buffer 的內容，去判斷讀取的數值是多少。
在這之前，可能會想先知道一下關於目前的 IRQ 相關的資訊與統計資料。這可以透過察看 /proc/interrupts 這個內容得知：
$ cat /proc/interrupts
會出現類似以下的輸出：
這個檔案中會顯示每個 CPU 處理中斷的次數。接下來會比較載入模組前後不同的地方。為了方便，等一下在比較的時候，會省略掉中間 CPU 的執行次數，只留下第一欄的 IRQ 編號，以及最後 4 攔的說明。
Raspberry Pi 的 GPIO17 透過 Logic Level Shifter 連接給 Arduino 的 A0，並且在 Logic Level Shifter 的兩端都加上適當的供電。如下圖：
在程式能執行之前，當然少不了裝置樹的準備。不過這個跟前面大同小異，所以就把內容放在附錄。
這邊資料結構的設計，就是把 irq 編號跟對應的 gpio descriptor 形成一個結構體：
struct minirq_dev {
struct gpio_desc *gpiod;
struct work_struct work;
int irq;
};
就是在 probe 當中，把對應的資源，比如說記憶體空間與 GPIO 等等進行初始化：
static int minirq_probe(struct platform_device *pdev)
{
struct device *dev = &(pdev-> dev);
struct minirq_dev *minirq;
int ret = 0;
minirq = devm_kzalloc(dev, sizeof(struct minirq_dev), GFP_KERNEL);
minirq->gpiod = devm_gpiod_get_index(dev, "minirq", 0, GPIOD_IN);
...
}
為了清楚，錯誤處理的程式沒有列出來。詳細的程式會於最後面附上。
參考 GPIO 文件的 GPIOs mapped to IRQs：
static int minirq_probe(struct platform_device *pdev)
{
...
minirq->irq = gpiod_to_irq(minirq->gpiod);
...
}
這邊有個前提是：GPIO 的 controller 要可以作為中斷的來源，才可以這樣做。關於這點可以去看裝置樹：
$ dtc -I fs /proc/device-tree | less
就會在 GPIO 的部分，發現 interrupts 相關的屬性：
gpio@7e200000 {
compatible = "brcm,bcm2835-gpio";
gpio-controller;
#interrupt-cells = < 0x02 >;
interrupts = < 0x02 0x11 0x02 0x12 >;
phandle = < 0x10 >;
reg = < 0x7e200000 0xb4 >;
#gpio-cells = < 0x02 >;
pinctrl-names = "default";
interrupt-controller;
...
};
上半部要實作一個 prototype 為：
irqreturn_t (*irq_handler_t)(int, void *);
的函數。其中，第一個參數是剛剛得到的 irq 編號，而第二個參數是一個「能用以辨認裝置的唯一結構」。不過通常都是把類似 struct platform_device，或是 struct device 這類的資料結構傳進去：
static irqreturn_t irq_top_half(int irq, void *p)
{
struct platform_device *pdev = p;
struct minirq_dev *minirq;
minirq = platform_get_drvdata(pdev);
schedule_work(&(minirq -> work));
return IRQ_HANDLED;
}
在這個 top-half 中，做的事情就是把一個工作用 schedule_work 推給一個核心全域的 Workqueue 做，然後就結束。而這個回傳的值必須是個 irqreturn_t，相關的定義可以在這裡找到：
enum irqreturn {
IRQ_NONE = (0 << 0),
IRQ_HANDLED = (1 << 0),
IRQ_WAKE_THREAD = (1 << 1),
};
typedef enum irqreturn irqreturn_t;
其中，如果這個 IRQ 是現在這個執行單元需要負責處理的，那麼處理完之後就回傳 IRQ_HANDLED。而那個 IRQ_NONE 會出現的原因是：不同的執行單元有可能會同時幫一個 IRQ 註冊各自的 IRQ handler。這時如果有 IRQ，那麼這所有的 handler 就會同時被觸發。
如果這種共享的狀況可能發生，那麼在 handler 裡面就要判斷被觸發時，是不是當下的執行單元需要去理會的？如果發現不是，就什麼都不做，直接回傳 IRQ_NONE 就好; 反之，如果是的話，就去把它處理掉，最後再回傳 IRQ_HANDLED。
而如同昨天描述的，上半部是 interrupt context，所以不能在裡面休眠。而且處理要快，所以這邊就把工作交給 Workqueue 去處理，然後就速速離開。這個下半部也可以比如說是 tasklet 或 kthread，或是整個用 threaded IRQ 來處理。但總之這邊使用 Workqueue。
至於要把什麼樣的工作推給 Workqueue 呢？這邊的 struct work_struct 是嵌入在剛剛的 minirq 中的那個成員。我們就把他在 probe 裡面時初始化成下面這個東西：
static int minirq_probe(struct platform_device *pdev)
{
...
INIT_WORK(&minirq->work, irq_bottom_half);
...
}
其中，irq_bottom_half 是一個下面這樣的函數：
void irq_bottom_half(struct work_struct *work)
{
pr_info("Rising edge detected!\n");
return;
}
沒錯，他就是簡單印出一個資料，讓我們知道 IRQ 被觸發了：
上半部跟下半部都處理好之後，接著就在 probe 當中幫這個 IRQ 「註冊」這個 IRQ handler：
static int minirq_probe(struct platform_device *pdev)
{
...
ret = devm_request_irq(dev, minirq->irq, irq_top_half,
IRQF_TRIGGER_RISING, "minirq", pdev);
...
}
首先，這個函式有幾種變形。最一開始的是 request_irq()：
int request_irq(unsigned int irq, irq_handler_t handler,
unsigned long flags, const char * name, void * dev)
其中，irq 是 IRQ 編號; handler 就是前面所說的，上半部的函式：
irqreturn_t (*irq_handler_t)(int irq, void *p);
而 flag 則是這個 IRQ 的細部調整，比如說是上升觸發還是下降觸發？有沒有跟其他裝置共享？是不是 timer 觸發的？等等。詳細的敘述可以在include/linux/interrupt.h 中找到。最後，那個 dev 會在參數中的 handler 被呼叫時，作為他的二個參數傳給 handler。
而如果使用 request_irq，那麼事後就要有對應的 free_irq。而類似地，雖然文件中沒有寫到，但這個函數有 devm_* 版本的函式，會自動跟裝置有關的資源 (也就是這裡使用的)，因此就不用擔心清理的問題。
最後一個版本是 threaded IRQ，雖然說用法很類似 (事實上是更方便)，但本質上跟現在這個 IRQ 不同。這個之後會另外介紹。
大致上就是裝置樹的配置、提供 of_device_id、模組的初始化、提供 platform_driver 的資料結構等等。為版面簡潔，這邊就不多贅述。完整程式碼附於後方。
每 0.5 秒改變一次電位高低：
void setup() {
pinMode(A0, OUTPUT);
Serial.begin(9600);
}
void loop() {
digitalWrite(A0, HIGH);
delay(500);
digitalWrite(A0, LOW);
delay(500);
}
換句話說，每 1 秒會有一個上升的邊緣。
載入模組之後，再去用 /proc/interrupts 觀察，既可以發現 pinctrl-brcm2835 後面出現了一個 minirq 的裝置：
161: bcm2836-timer 0 Edge arch_timer
162: bcm2836-timer 1 Edge arch_timer
165: bcm2836-pmu 9 Edge arm-pmu
-167: pinctrl-bcm2835 17 Edge
+167: pinctrl-bcm2835 17 Edge minirq
FIQ: usb_fiq
IPI0: CPU wakeup interrupts
IPI1: Timer broadcast interrupts
除此之外，用 dmesg 也可以看見每秒一次印出的訊息：
[ 4222.224497] Rising edge detected!
[ 4223.225439] Rising edge detected!
[ 4224.226387] Rising edge detected!
[ 4225.227340] Rising edge detected!
[ 4226.228285] Rising edge detected!
[ 4227.229231] Rising edge detected!
[ 4228.230173] Rising edge detected!
[ 4229.231120] Rising edge detected!
[ 4230.232070] Rising edge detected!
[ 4231.233014] Rising edge detected!
[ 4232.233958] Rising edge detected!
裝置樹的部分跟 IIO 時類似，只是名稱有所不同：
/dts-v1/;
/plugin/;
/ {
compatible="brcm,brcm2835";
fragment@0 {
target = <&gpio>;
__overlay__ {
minirq: minirq_gpio_pins {
brcm,pins = <0x11>;
brcm,function = <0x0>;
brcm,pull = <0x1>;
};
};
};
fragment@1 {
target-path = "/";
__overlay__ {
minirq {
minirq-gpios = <&gpio 0x11 0x0>;
compatible = "minirq";
status = "ok";
pinctrl-0 = <&minirq>;
pinctrl-names = "default";
};
};
};
};
#include <linux/kernel.h>
#include <linux/init.h>
#include <linux/module.h>
#include <linux/platform_device.h>
#include <linux/gpio/consumer.h>
#include <linux/of.h>
#include <linux/gpio/consumer.h>
#include <linux/interrupt.h>
#include <linux/workqueue.h>
struct minirq_dev {
struct gpio_desc *gpiod;
struct work_struct work;
int irq;
};
void irq_bottom_half(struct work_struct *work)
{
pr_info("Rising edge detected!\n");
return;
}
static irqreturn_t irq_top_half(int irq, void *p)
{
struct platform_device *pdev = p;
struct minirq_dev *minirq;
minirq = platform_get_drvdata(pdev);
schedule_work(&(minirq -> work));
return IRQ_HANDLED;
}
static int minirq_probe(struct platform_device *pdev)
{
struct device *dev = &(pdev-> dev);
struct minirq_dev *minirq;
int ret = 0;
minirq = devm_kzalloc(dev, sizeof(struct minirq_dev), GFP_KERNEL);
if (!minirq) {
dev_err(dev, "Failed to allocate memory.\n");
return -ENOMEM;
}
minirq->gpiod = devm_gpiod_get_index(dev, "minirq", 0, GPIOD_IN);
if (IS_ERR(minirq->gpiod)) {
dev_err(dev, "Failed to get gpio descriptor.\n");
return PTR_ERR(minirq -> gpiod);
}
ret = gpiod_to_irq(minirq->gpiod);
if (ret < 0) {
dev_err(dev, "Failed to get irq from gpiod.\n");
return ret;
}
minirq->irq = ret;
INIT_WORK(&minirq->work, irq_bottom_half);
ret = devm_request_irq(dev, minirq->irq, irq_top_half,
IRQF_TRIGGER_RISING, "minirq", pdev);
if (ret < 0) {
dev_err(dev, "Failed to request IRQ.\n");
return ret;
}
platform_set_drvdata(pdev, minirq);
return 0;
}
static const struct of_device_id minirq_ids[] = {
{.compatible = "minirq",},
{}
};
static struct platform_driver minirq_driver = {
.driver = {
.name = "minirq",
.of_match_table = minirq_ids,
},
.probe = minirq_probe
};
MODULE_LICENSE("GPL");
module_platform_driver(minirq_driver);
PWD := $(shell pwd)
KVERSION := $(shell uname -r)
KERNEL_DIR := /lib/modules/$(shell uname -r)/build
MODULE_NAME = minirq
obj-m := $(MODULE_NAME).o
all:
make -C $(KERNEL_DIR) M=$(PWD) modules
clean:
make -C $(KERNEL_DIR) M=$(PWD) clean
rm -f $(MODULE_NAME).dtbo
dts:
dtc -@ -I dts -O dtb -o $(MODULE_NAME).dtbo $(MODULE_NAME).dts
順帶一提，可以直接：
$ make dts
來編譯 .dtbo。
iThome鐵人賽
看影片追技術