Linux GIC驅(qū)動數(shù)據(jù)結(jié)構(gòu)分析

數(shù)據(jù)結(jié)構(gòu)分析

先來張圖：

• GIC驅(qū)動中，使用struct gic_chip_data結(jié)構(gòu)體來描述GIC控制器的信息，整個驅(qū)動都是圍繞著該結(jié)構(gòu)體的初始化，驅(qū)動中將函數(shù)指針都初始化好，實(shí)際的工作是由中斷信號觸發(fā)，也就是在中斷來臨的時候去進(jìn)行回調(diào)；
• struct irq_chip結(jié)構(gòu)，描述的是中斷控制器的底層操作函數(shù)集，這些函數(shù)集最終完成對控制器硬件的操作；
• struct irq_domain結(jié)構(gòu)，用于硬件中斷號和Linux IRQ中斷號（virq，虛擬中斷號）之間的映射；

還是上一下具體的數(shù)據(jù)結(jié)構(gòu)代碼吧，關(guān)鍵注釋如下：

struct irq_chip {
	struct device	*parent_device;     //指向父設(shè)備
	const char	*name;      //  /proc/interrupts中顯示的名字
	unsigned int	(*irq_startup)(struct irq_data *data);  //啟動中斷，如果設(shè)置成NULL，則默認(rèn)為enable
	void		(*irq_shutdown)(struct irq_data *data);     //關(guān)閉中斷，如果設(shè)置成NULL，則默認(rèn)為disable
	void		(*irq_enable)(struct irq_data *data);   //中斷使能，如果設(shè)置成NULL，則默認(rèn)為chip- >unmask
	void		(*irq_disable)(struct irq_data *data);  //中斷禁止


	void		(*irq_ack)(struct irq_data *data);  //開始新的中斷
	void		(*irq_mask)(struct irq_data *data); //中斷源屏蔽
	void		(*irq_mask_ack)(struct irq_data *data); //應(yīng)答并屏蔽中斷
	void		(*irq_unmask)(struct irq_data *data);   //解除中斷屏蔽
	void		(*irq_eoi)(struct irq_data *data);  //中斷處理結(jié)束后調(diào)用


	int		(*irq_set_affinity)(struct irq_data *data, const struct cpumask *dest, bool force); //在SMP中設(shè)置CPU親和力
	int		(*irq_retrigger)(struct irq_data *data);    //重新發(fā)送中斷到CPU
	int		(*irq_set_type)(struct irq_data *data, unsigned int flow_type); //設(shè)置中斷觸發(fā)類型
	int		(*irq_set_wake)(struct irq_data *data, unsigned int on);    //使能/禁止電源管理中的喚醒功能


	void		(*irq_bus_lock)(struct irq_data *data); //慢速芯片總線上的鎖
	void		(*irq_bus_sync_unlock)(struct irq_data *data);  //同步釋放慢速總線芯片的鎖


	void		(*irq_cpu_online)(struct irq_data *data);
	void		(*irq_cpu_offline)(struct irq_data *data);


	void		(*irq_suspend)(struct irq_data *data);
	void		(*irq_resume)(struct irq_data *data);
	void		(*irq_pm_shutdown)(struct irq_data *data);


	void		(*irq_calc_mask)(struct irq_data *data);


	void		(*irq_print_chip)(struct irq_data *data, struct seq_file *p);
	int		(*irq_request_resources)(struct irq_data *data);
	void		(*irq_release_resources)(struct irq_data *data);


	void		(*irq_compose_msi_msg)(struct irq_data *data, struct msi_msg *msg);
	void		(*irq_write_msi_msg)(struct irq_data *data, struct msi_msg *msg);


	int		(*irq_get_irqchip_state)(struct irq_data *data, enum irqchip_irq_state which, bool *state);
	int		(*irq_set_irqchip_state)(struct irq_data *data, enum irqchip_irq_state which, bool state);


	int		(*irq_set_vcpu_affinity)(struct irq_data *data, void *vcpu_info);


	void		(*ipi_send_single)(struct irq_data *data, unsigned int cpu);
	void		(*ipi_send_mask)(struct irq_data *data, const struct cpumask *dest);


	unsigned long	flags;
};


struct irq_domain {
	struct list_head link;  //用于添加到全局鏈表irq_domain_list中
	const char *name;   //IRQ domain的名字
	const struct irq_domain_ops *ops;   //IRQ domain映射操作函數(shù)集
	void *host_data;    //在GIC驅(qū)動中，指向了irq_gic_data
	unsigned int flags; 
	unsigned int mapcount;  //映射中斷的個數(shù)


	/* Optional data */
	struct fwnode_handle *fwnode;
	enum irq_domain_bus_token bus_token;
	struct irq_domain_chip_generic *gc;
#ifdef	CONFIG_IRQ_DOMAIN_HIERARCHY
	struct irq_domain *parent;  //支持級聯(lián)的話，指向父設(shè)備
#endif
#ifdef CONFIG_GENERIC_IRQ_DEBUGFS
	struct dentry		*debugfs_file;
#endif


	/* reverse map data. The linear map gets appended to the irq_domain */
	irq_hw_number_t hwirq_max;  //IRQ domain支持中斷數(shù)量的最大值
	unsigned int revmap_direct_max_irq;
	unsigned int revmap_size;   //線性映射的大小
	struct radix_tree_root revmap_tree; //Radix Tree映射的根節(jié)點(diǎn)
	unsigned int linear_revmap[];   //線性映射用到的查找表
};


struct irq_domain_ops {
	int (*match)(struct irq_domain *d, struct device_node *node,
		     enum irq_domain_bus_token bus_token);      // 用于中斷控制器設(shè)備與IRQ domain的匹配
	int (*select)(struct irq_domain *d, struct irq_fwspec *fwspec,
		      enum irq_domain_bus_token bus_token);
	int (*map)(struct irq_domain *d, unsigned int virq, irq_hw_number_t hw);    //用于硬件中斷號與Linux中斷號的映射
	void (*unmap)(struct irq_domain *d, unsigned int virq);
	int (*xlate)(struct irq_domain *d, struct device_node *node,
		     const u32 *intspec, unsigned int intsize,
		     unsigned long *out_hwirq, unsigned int *out_type);     //通過device_node，解析硬件中斷號和觸發(fā)方式


#ifdef	CONFIG_IRQ_DOMAIN_HIERARCHY
	/* extended V2 interfaces to support hierarchy irq_domains */
	int (*alloc)(struct irq_domain *d, unsigned int virq,
		     unsigned int nr_irqs, void *arg);
	void (*free)(struct irq_domain *d, unsigned int virq,
		     unsigned int nr_irqs);
	void (*activate)(struct irq_domain *d, struct irq_data *irq_data);
	void (*deactivate)(struct irq_domain *d, struct irq_data *irq_data);
	int (*translate)(struct irq_domain *d, struct irq_fwspec *fwspec,
			 unsigned long *out_hwirq, unsigned int *out_type);
#endif
};