GIC 驅動

這里主要分析 linux kernel 中 GIC v3 中斷控制器的代碼(drivers/irqchip/irq-gic-v3.c)。

設備樹

先來看下一個中斷控制器的設備樹信息：

gic:interrupt-controller@51a00000{
compatible="arm,gic-v3";
reg=<0x00x51a0000000x10000>,/*GICDist*/
<0x00x51b0000000xC0000>,/*GICR*/
<0x00x5200000000x2000>,/*GICC*/
<0x00x5201000000x1000>,/*GICH*/
<0x00x5202000000x20000>;/*GICV*/
#interrupt-cells=<3>;
interrupt-controller;
interrupts=9
(GIC_CPU_MASK_SIMPLE(6)|IRQ_TYPE_LEVEL_HIGH)>;
interrupt-parent=<&gic>;
};

• compatible：用于匹配GICv3驅動
• reg：GIC的物理基地址，分別對應GICD,GICR,GICC…
• #interrupt-cells：這是一個中斷控制器節點的屬性。它聲明了該中斷控制器的中斷指示符(interrupts)中 cell 的個數
• interrupt-controller: 表示該節點是一個中斷控制器
• interrupts：分別代表中斷類型，中斷號，中斷類型， PPI中斷親和， 保留字段

關于設備數的各個字段含義，詳細可以參考 Documentation/devicetree/bindings 下的對應信息。

初始化

1. irq chip driver 的聲明：

IRQCHIP_DECLARE(gic_v3,"arm,gic-v3",gic_of_init);

定義 IRQCHIP_DECLARE 之后，相應的內容會保存到 __irqchip_of_table 里邊:

#defineIRQCHIP_DECLARE(name,compat,fn)OF_DECLARE_2(irqchip,name,compat,fn)

#defineOF_DECLARE_2(table,name,compat,fn)
_OF_DECLARE(table,name,compat,fn,of_init_fn_2)

#define_OF_DECLARE(table,name,compat,fn,fn_type)
staticconststructof_device_id__of_table_##name
__used__section(__##table##_of_table)
={.compatible=compat,
.data=(fn==(fn_type)NULL)?fn:fn}

__irqchip_of_table 在鏈接腳本 vmlinux.lds 里，被放到了 __irqchip_begin 和 __irqchip_of_end 之間，該段用于存放中斷控制器信息：

#ifdefCONFIG_IRQCHIP
#defineIRQCHIP_OF_MATCH_TABLE()
.=ALIGN(8);
VMLINUX_SYMBOL(__irqchip_begin)=.;
*(__irqchip_of_table)
*(__irqchip_of_end)
#endif

在內核啟動初始化中斷的函數中，of_irq_init 函數會去查找設備節點信息，該函數的傳入參數就是 __irqchip_of_table 段，由于 IRQCHIP_DECLARE 已經將信息填充好了，of_irq_init 函數會根據 “arm,gic-v3” 去查找對應的設備節點，并獲取設備的信息。or_irq_init 函數中，最終會回調 IRQCHIP_DECLARE 聲明的回調函數，也就是 gic_of_init，而這個函數就是 GIC 驅動的初始化入口。

2. gic_of_init 流程：

staticint__initgic_of_init(structdevice_node*node,structdevice_node*parent)
{
......
dist_base=of_iomap(node,0);------(1)
if(!dist_base){
pr_err("%pOF:unabletomapgicdistregisters
",node);
return-ENXIO;
}

err=gic_validate_dist_version(dist_base);------(2)
if(err){
pr_err("%pOF:nodistributordetected,givingup
",node);
gotoout_unmap_dist;
}

if(of_property_read_u32(node,"#redistributor-regions",&nr_redist_regions))------(3)
nr_redist_regions=1;

rdist_regs=kzalloc(sizeof(*rdist_regs)*nr_redist_regions,GFP_KERNEL);
if(!rdist_regs){
err=-ENOMEM;
gotoout_unmap_dist;
}

for(i=0;i4)
structresourceres;
intret;

ret=of_address_to_resource(node,1+i,&res);
rdist_regs[i].redist_base=of_iomap(node,1+i);
if(ret||!rdist_regs[i].redist_base){
pr_err("%pOF:couldn'tmapregion%d
",node,i);
err=-ENODEV;
gotoout_unmap_rdist;
}
rdist_regs[i].phys_base=res.start;
}

if(of_property_read_u64(node,"redistributor-stride",&redist_stride))------(5)
redist_stride=0;

err=gic_init_bases(dist_base,rdist_regs,nr_redist_regions,------(6)
redist_stride,&node->fwnode);
if(err)
gotoout_unmap_rdist;

gic_populate_ppi_partitions(node);------(7)
gic_of_setup_kvm_info(node);
return0;
......
returnerr;
}

1. 映射 GICD 的寄存器地址空間。
2. 驗證 GICD 的版本是 GICv3 還是 GICv4（主要通過讀GICD_PIDR2寄存器bit[7:4]. 0x1代表GICv1， 0x2代表GICv2…以此類推）。
3. 通過 DTS 讀取 redistributor-regions 的值。
4. 為一個 GICR 域分配基地址。
5. 通過 DTS 讀取 redistributor-stride 的值。
6. 下面詳細介紹。
7. 設置一組 PPI的親和性。

staticint__initgic_init_bases(void__iomem*dist_base,
structredist_region*rdist_regs,
u32nr_redist_regions,
u64redist_stride,
structfwnode_handle*handle)
{
......
typer=readl_relaxed(gic_data.dist_base+GICD_TYPER);------(1)
gic_data.rdists.id_bits=GICD_TYPER_ID_BITS(typer);
gic_irqs=GICD_TYPER_IRQS(typer);
if(gic_irqs>1020)
gic_irqs=1020;
gic_data.irq_nr=gic_irqs;

gic_data.domain=irq_domain_create_tree(handle,&gic_irq_domain_ops,------(2)
&gic_data);
gic_data.rdists.rdist=alloc_percpu(typeof(*gic_data.rdists.rdist));
gic_data.rdists.has_vlpis=true;
gic_data.rdists.has_direct_lpi=true;
......
set_handle_irq(gic_handle_irq);------(3)

gic_update_vlpi_properties();------(4)

if(IS_ENABLED(CONFIG_ARM_GIC_V3_ITS)&&gic_dist_supports_lpis())
its_init(handle,&gic_data.rdists,gic_data.domain);------(5)

gic_smp_init();------(6)
gic_dist_init();------(7)
gic_cpu_init();------(8)
gic_cpu_pm_init();------(9)

return0;
......
}

1. 確認支持 SPI 中斷號最大的值為多少。
2. 向系統中注冊一個 irq domain 的數據結構，irq_domain 主要作用是將硬件中斷號映射到 irq number，后面會做詳細的介紹。
3. 設定 arch 相關的 irq handler。gic_irq_handle 是內核 gic 中斷處理的入口函數，后面會做詳細的介紹。
4. gic 虛擬化相關的內容。
5. 初始化 ITS。
6. 設置 SMP 核間交互的回調函數，用于 IPI，回到函數為 gic_raise_softir。
7. 初始化 Distributor。
8. 初始化 CPU interface。
9. 初始化 GIC 電源管理。

中斷的映射

當早期的系統只存在一個中斷控制器，而且中斷數目也不多的時候，一個很簡單的做法就是一個中斷號對應到中斷控制器的一個號，可以說是簡單的線性映射：

但當一個系統中有多個中斷控制器，而且中斷號也逐漸增加的時候。linux 內核為了應對此問題，引入了 irq_domain 的概念。

irq_domain 的引入相當于一個中斷控制器就是一個 irq_domain。這樣一來所有的中斷控制器就會出現級聯的布局。利用樹狀的結構可以充分的利用 irq 數目，而且每一個 irq_domain 區域可以自己去管理自己 interrupt 的特性。

每一個中斷控制器對應多個中斷號， 而硬件中斷號在不同的中斷控制器上是會重復編碼的， 這時僅僅用硬中斷號已經不能唯一標識一個外設中斷，因此 linux kernel 提供了一個虛擬中斷號的概念。

接下來我們看下硬件中斷號是如何映射到虛擬中斷號的。

數據結構

在看硬件中斷號映射到虛擬中斷號之前，先來看下幾個比較重要的數據結構。

struct irq_desc描述一個外設的中斷，稱之中斷描述符。

structirq_desc{
structirq_common_datairq_common_data;
structirq_datairq_data;
unsignedint__percpu*kstat_irqs;
irq_flow_handler_thandle_irq;
......
structirqaction*action;
......
}____cacheline_internodealigned_in_smp;

• irq_data：中斷控制器的硬件數據
• handle_irq：中斷控制器驅動的處理函數，指向一個 struct irqaction 的鏈表，一個中斷源可以多個設備共享，所以一個 irq_desc 可以掛載多個 action，由鏈表結構組織起來
• action：設備驅動的處理函數

struct irq_data包含中斷控制器的硬件數據。

structirq_data{
u32mask;
unsignedintirq;
unsignedlonghwirq;
structirq_common_data*common;
structirq_chip*chip;
structirq_domain*domain;
#ifdefCONFIG_IRQ_DOMAIN_HIERARCHY
structirq_data*parent_data;
#endif
void*chip_data;
};

• irq：虛擬中斷號
• hwirq：硬件中斷號
• chip：對應的 irq_chip 數據結構
• domain：對應的 irq_domain 數據結構

struct irq_chip用于對中斷控制器的硬件操作。

structirq_chip{
structdevice*parent_device;
constchar*name;
unsignedint(*irq_startup)(structirq_data*data);
void(*irq_shutdown)(structirq_data*data);
void(*irq_enable)(structirq_data*data);
void(*irq_disable)(structirq_data*data);

void(*irq_ack)(structirq_data*data);
void(*irq_mask)(structirq_data*data);
void(*irq_mask_ack)(structirq_data*data);
void(*irq_unmask)(structirq_data*data);
void(*irq_eoi)(structirq_data*data);

int(*irq_set_affinity)(structirq_data*data,conststructcpumask*dest,boolforce);
int(*irq_retrigger)(structirq_data*data);
int(*irq_set_type)(structirq_data*data,unsignedintflow_type);
int(*irq_set_wake)(structirq_data*data,unsignedinton);

void(*irq_bus_lock)(structirq_data*data);
void(*irq_bus_sync_unlock)(structirq_data*data);
......
};

• parent_device：指向父設備
• name：/proc/interrupts 中顯示的名字
• irq_startup：啟動中斷，如果設置成 NULL，則默認為 enable
• irq_shutdown：關閉中斷，如果設置成 NULL，則默認為 disable
• irq_enable：中斷使能，如果設置成 NULL，則默認為 chip->unmask
• irq_disable：中斷禁止
• irq_ack：開始新的中斷
• irq_mask：中斷源屏蔽
• irq_mask_ack：應答并屏蔽中斷
• irq_unmask：解除中斷屏蔽
• irq_eoi：中斷處理結束后調用
• irq_set_affinity：在 SMP 中設置 CPU 親和力
• irq_retrigger：重新發送中斷到 CPU
• irq_set_type：設置中斷觸發類型
• irq_set_wake：使能/禁止電源管理中的喚醒功能
• irq_bus_lock：慢速芯片總線上的鎖
• irq_bus_sync_unlock：同步釋放慢速總線芯片的鎖

struct irq_domain與中斷控制器對應，完成硬件中斷號 hwirq 到 virq 的映射。

structirq_domain{
structlist_headlink;
constchar*name;
conststructirq_domain_ops*ops;
void*host_data;
unsignedintflags;
unsignedintmapcount;

/*Optionaldata*/
structfwnode_handle*fwnode;
enumirq_domain_bus_tokenbus_token;
structirq_domain_chip_generic*gc;
#ifdefCONFIG_IRQ_DOMAIN_HIERARCHY
structirq_domain*parent;
#endif
#ifdefCONFIG_GENERIC_IRQ_DEBUGFS
structdentry*debugfs_file;
#endif

/*reversemapdata.Thelinearmapgetsappendedtotheirq_domain*/
irq_hw_number_thwirq_max;
unsignedintrevmap_direct_max_irq;
unsignedintrevmap_size;
structradix_tree_rootrevmap_tree;
unsignedintlinear_revmap[];
};

• link：用于將 irq_domain 連接到全局鏈表 irq_domain_list 中
• name：irq_domain 的名稱
• ops：irq_domain 映射操作函數集
• mapcount：映射好的中斷的數量
• fwnode：對應中斷控制器的 device node
• parent：指向父級 irq_domain 的指針，用于支持級聯 irq_domain
• hwirq_max：該 irq_domain 支持的中斷最大數量
• linear_revmap[]：hwirq->virq 反向映射的線性表

struct irq_domain_ops是 irq_domain 映射操作函數集。

structirq_domain_ops{
int(*match)(structirq_domain*d,structdevice_node*node,
enumirq_domain_bus_tokenbus_token);
int(*select)(structirq_domain*d,structirq_fwspec*fwspec,
enumirq_domain_bus_tokenbus_token);
int(*map)(structirq_domain*d,unsignedintvirq,irq_hw_number_thw);
void(*unmap)(structirq_domain*d,unsignedintvirq);
int(*xlate)(structirq_domain*d,structdevice_node*node,
constu32*intspec,unsignedintintsize,
unsignedlong*out_hwirq,unsignedint*out_type);
......
};

• match：用于中斷控制器設備與 irq_domain 的匹配
• map：用于硬件中斷號與 Linux 中斷號的映射
• xlate：通過 device_node，解析硬件中斷號和觸發方式

struct irqaction主要是用來存設備驅動注冊的中斷處理函數。

structirqaction{
irq_handler_thandler;
void*dev_id;
......
unsignedintirq;
unsignedintflags;
......
constchar*name;
structproc_dir_entry*dir;
}____cacheline_internodealigned_in_smp;

• handler：設備驅動里的中斷處理函數
• dev_id：設備 id
• irq：中斷號
• flags：中斷標志，注冊時設置，比如上升沿中斷，下降沿中斷等
• name：中斷名稱,產生中斷的硬件的名字
• dir：指向 /proc/irq/ 相關的信息

這里，我們用一張圖來匯總下上面的數據結構：

上面的結構體 struct irq_desc 是設備驅動加載的過程中完成的，讓設備樹中的中斷能與具體的中斷描述符 irq_desc 匹配，其中 struct irqaction 保存著設備的中斷處理函數。右邊框內的結構體主要是在中斷控制器驅動加載的過程中完成的，其中 struct irq_chip 用于對中斷控制器的硬件操作，struct irq_domain 用于硬件中斷號到 Linux irq 的映射。

下面我們結合代碼看下中斷控制器驅動和設備驅動是如何創建這些結構體，并且硬中斷和虛擬中斷號是如何完成映射的。

中斷控制器注冊 irq_domain

通過 __irq_domain_add 初始化irq_domain數據結構，然后把 irq_domain 添加到全局的鏈表 irq_domain_list 中。

外設的驅動創建硬中斷和虛擬中斷號的映射關系

設備的驅動在初始化的時候可以調用 irq_of_parse_and_map 這個接口函數進行該 device node 中和中斷相關的內容的解析，并建立映射關系

• of_irq_parse_one 函數用于解析DTS文件中設備定義的屬性，如"reg", “interrupt”
• irq_find_matching_fwspec 遍歷 irq_domain_list 鏈表，找到 device node 匹配的irq_domain
• gic_irq_domain_translate 解析出中斷信息，比如硬件中斷號 hwirq，中斷觸發方式
• irq_domain_alloc_descs 分配一個虛擬的中斷號 virq，分配和初始化中斷描述符irq_desc
• gic_irq_domain_alloc 為 hwirq 和 virq 創建映射關系。內部會通過 irq_domain_set_info 調用 irq_domain_set_hwirq_and_chip，然后通過 virq 獲取irq_data結構體，并將 hwirq 設置到 irq_data->hwirq 中， 最終完成 hwirq 到 virq 的映射
• irq_domain_set_info 根據硬件中斷號的范圍設置 irq_desc->handle_irq 的指針，共享中斷入口為 handle_fasteoi_irq，私有中斷入口為 handle_percpu_devid_irq

最后，我們可以通過 /proc/interrupts 下的值來看下它們的關系：

現在，我們已經知道內核為硬件中斷號與 Linux 中斷號做了映射，相關數據結構的綁定及初始化，并且設置了中斷處理函數執行的入口。接下來我們再看下設備的中斷是怎么來注冊的？

中斷的注冊

設備驅動中，獲取到了 irq 中斷號后，通常就會采用 request_irq/request_threaded_irq 來注冊中斷，其中 request_irq 用于注冊普通處理的中斷。request_threaded_irq 用于注冊線程化處理的中斷，線程化中斷的主要目的把中斷上下文的任務遷移到線程中，減少系統關中斷的時間，增強系統的實時性。

staticinlineint__must_check
request_irq(unsignedintirq,irq_handler_thandler,unsignedlongflags,
constchar*name,void*dev)
{
returnrequest_threaded_irq(irq,handler,NULL,flags,name,dev);
}

其中 irq 是 linux 中斷號，handler 是中斷處理函數，flags 是中斷標志位，name 是中斷的名字。在講具體的注冊流程前，先看一下主要的中斷標志位：

#defineIRQF_SHARED0x00000080//多個設備共享一個中斷號，需要外設硬件支持
#defineIRQF_PROBE_SHARED0x00000100//中斷處理程序允許sharingmismatch發生
#define__IRQF_TIMER0x00000200//時鐘中斷
#defineIRQF_PERCPU0x00000400//屬于特定CPU的中斷
#defineIRQF_NOBALANCING0x00000800//禁止在CPU之間進行中斷均衡處理
#defineIRQF_IRQPOLL0x00001000//中斷被用作輪訓
#defineIRQF_ONESHOT0x00002000//一次性觸發的中斷，不能嵌套，1）在硬件中斷處理完成后才能打開中斷；2）在中斷線程化中保持關閉狀態，直到該中斷源上的所有thread_fn函數都執行完
#defineIRQF_NO_SUSPEND0x00004000//系統休眠喚醒操作中，不關閉該中斷
#defineIRQF_FORCE_RESUME0x00008000//系統喚醒過程中必須強制打開該中斷
#defineIRQF_NO_THREAD0x00010000//禁止中斷線程化
#defineIRQF_EARLY_RESUME0x00020000//系統喚醒過程中在syscore階段resume，而不用等到設備resume階段
#defineIRQF_COND_SUSPEND0x00040000//與NO_SUSPEND的用戶共享中斷時，執行本設備的中斷處理函數

創建完成后，通過 ps 命令可以查看系統中的中斷線程，注意這些線程是實時線程 SCHED_FIFO：

#ps-A|grep"irq/"
root1749200irq_thread0S[irq/433-imx_drm]
root1750200irq_thread0S[irq/439-imx_drm]
root1751200irq_thread0S[irq/445-imx_drm]
root1752200irq_thread0S[irq/451-imx_drm]
root2044200irq_thread0S[irq/279-isl2902]
root2192200irq_thread0S[irq/114-mmc0]
root2199200irq_thread0S[irq/115-mmc1]
root2203200irq_thread0S[irq/322-5b02000]
root2361200irq_thread0S[irq/294-4-0051]