1.. SPDX-License-Identifier: GPL-2.0
2
3.. include:: ../disclaimer-zh_CN.rst
4
5:Original: Documentation/loongarch/irq-chip-model.rst
6:Translator: Huacai Chen <chenhuacai@loongson.cn>
7
8==================================
9LoongArch的IRQ芯片模型（层级关系）
10==================================
11
12目前，基于LoongArch的处理器（如龙芯3A5000）只能与LS7A芯片组配合工作。LoongArch计算机
13中的中断控制器（即IRQ芯片）包括CPUINTC（CPU Core Interrupt Controller）、LIOINTC（
14Legacy I/O Interrupt Controller）、EIOINTC（Extended I/O Interrupt Controller）、
15HTVECINTC（Hyper-Transport Vector Interrupt Controller）、PCH-PIC（LS7A芯片组的主中
16断控制器）、PCH-LPC（LS7A芯片组的LPC中断控制器）和PCH-MSI（MSI中断控制器）。
17
18CPUINTC是一种CPU内部的每个核本地的中断控制器，LIOINTC/EIOINTC/HTVECINTC是CPU内部的
19全局中断控制器（每个芯片一个，所有核共享），而PCH-PIC/PCH-LPC/PCH-MSI是CPU外部的中
20断控制器（在配套芯片组里面）。这些中断控制器（或者说IRQ芯片）以一种层次树的组织形式
21级联在一起，一共有两种层级关系模型（传统IRQ模型和扩展IRQ模型）。
22
23传统IRQ模型
24===========
25
26在这种模型里面，IPI（Inter-Processor Interrupt）和CPU本地时钟中断直接发送到CPUINTC，
27CPU串口（UARTs）中断发送到LIOINTC，而其他所有设备的中断则分别发送到所连接的PCH-PIC/
28PCH-LPC/PCH-MSI，然后被HTVECINTC统一收集，再发送到LIOINTC，最后到达CPUINTC::
29
30     +-----+     +---------+     +-------+
31     | IPI | --> | CPUINTC | <-- | Timer |
32     +-----+     +---------+     +-------+
33                      ^
34                      |
35                 +---------+     +-------+
36                 | LIOINTC | <-- | UARTs |
37                 +---------+     +-------+
38                      ^
39                      |
40                +-----------+
41                | HTVECINTC |
42                +-----------+
43                 ^         ^
44                 |         |
45           +---------+ +---------+
46           | PCH-PIC | | PCH-MSI |
47           +---------+ +---------+
48             ^     ^           ^
49             |     |           |
50     +---------+ +---------+ +---------+
51     | PCH-LPC | | Devices | | Devices |
52     +---------+ +---------+ +---------+
53          ^
54          |
55     +---------+
56     | Devices |
57     +---------+
58
59扩展IRQ模型
60===========
61
62在这种模型里面，IPI（Inter-Processor Interrupt）和CPU本地时钟中断直接发送到CPUINTC，
63CPU串口（UARTs）中断发送到LIOINTC，而其他所有设备的中断则分别发送到所连接的PCH-PIC/
64PCH-LPC/PCH-MSI，然后被EIOINTC统一收集，再直接到达CPUINTC::
65
66          +-----+     +---------+     +-------+
67          | IPI | --> | CPUINTC | <-- | Timer |
68          +-----+     +---------+     +-------+
69                       ^       ^
70                       |       |
71                +---------+ +---------+     +-------+
72                | EIOINTC | | LIOINTC | <-- | UARTs |
73                +---------+ +---------+     +-------+
74                 ^       ^
75                 |       |
76          +---------+ +---------+
77          | PCH-PIC | | PCH-MSI |
78          +---------+ +---------+
79            ^     ^           ^
80            |     |           |
81    +---------+ +---------+ +---------+
82    | PCH-LPC | | Devices | | Devices |
83    +---------+ +---------+ +---------+
84         ^
85         |
86    +---------+
87    | Devices |
88    +---------+
89
90ACPI相关的定义
91==============
92
93CPUINTC::
94
95  ACPI_MADT_TYPE_CORE_PIC;
96  struct acpi_madt_core_pic;
97  enum acpi_madt_core_pic_version;
98
99LIOINTC::
100
101  ACPI_MADT_TYPE_LIO_PIC;
102  struct acpi_madt_lio_pic;
103  enum acpi_madt_lio_pic_version;
104
105EIOINTC::
106
107  ACPI_MADT_TYPE_EIO_PIC;
108  struct acpi_madt_eio_pic;
109  enum acpi_madt_eio_pic_version;
110
111HTVECINTC::
112
113  ACPI_MADT_TYPE_HT_PIC;
114  struct acpi_madt_ht_pic;
115  enum acpi_madt_ht_pic_version;
116
117PCH-PIC::
118
119  ACPI_MADT_TYPE_BIO_PIC;
120  struct acpi_madt_bio_pic;
121  enum acpi_madt_bio_pic_version;
122
123PCH-MSI::
124
125  ACPI_MADT_TYPE_MSI_PIC;
126  struct acpi_madt_msi_pic;
127  enum acpi_madt_msi_pic_version;
128
129PCH-LPC::
130
131  ACPI_MADT_TYPE_LPC_PIC;
132  struct acpi_madt_lpc_pic;
133  enum acpi_madt_lpc_pic_version;
134
135参考文献
136========
137
138龙芯3A5000的文档：
139
140  https://github.com/loongson/LoongArch-Documentation/releases/latest/download/Loongson-3A5000-usermanual-1.02-CN.pdf (中文版)
141
142  https://github.com/loongson/LoongArch-Documentation/releases/latest/download/Loongson-3A5000-usermanual-1.02-EN.pdf (英文版)
143
144龙芯LS7A芯片组的文档：
145
146  https://github.com/loongson/LoongArch-Documentation/releases/latest/download/Loongson-7A1000-usermanual-2.00-CN.pdf (中文版)
147
148  https://github.com/loongson/LoongArch-Documentation/releases/latest/download/Loongson-7A1000-usermanual-2.00-EN.pdf (英文版)
149
150.. note::
151    - CPUINTC：即《龙芯架构参考手册卷一》第7.4节所描述的CSR.ECFG/CSR.ESTAT寄存器及其
152      中断控制逻辑；
153    - LIOINTC：即《龙芯3A5000处理器使用手册》第11.1节所描述的“传统I/O中断”；
154    - EIOINTC：即《龙芯3A5000处理器使用手册》第11.2节所描述的“扩展I/O中断”；
155    - HTVECINTC：即《龙芯3A5000处理器使用手册》第14.3节所描述的“HyperTransport中断”；
156    - PCH-PIC/PCH-MSI：即《龙芯7A1000桥片用户手册》第5章所描述的“中断控制器”；
157    - PCH-LPC：即《龙芯7A1000桥片用户手册》第24.3节所描述的“LPC中断”。
158