zh_CN/PCI/msi-howto.rst

1 .. SPDX-License-Identifier: GPL-2.0
3 .. include:: ../disclaimer-zh_CN.rst
5 :Original: Documentation/PCI/msi-howto.rst
26 本指南介绍了消息标记中断（MSI）的基本知识，使用MSI相对于传统中断机制的优势，如何
27 改变你的驱动程序以使用MSI或MSI-X，以及在设备不支持MSI时可以尝试的一些基本诊断方法。
36 MSI-X功能也随着PCI 3.0被引入。它比MSI支持每个设备更多的中断，并允许独立配置中断。
38 设备可以同时支持MSI和MSI-X，但一次只能启用一个。
50 之前，中断就已经到达了（这在PCI-PCI桥后面的设备中变得更有可能）。为了确保所有的数
65 PCI设备被初始化为使用基于引脚的中断。设备驱动程序必须将设备设置为使用MSI或MSI-X。
70 -------------------
72 为了支持MSI或MSI-X，内核在构建时必须启用CONFIG_PCI_MSI选项。这个选项只在某些架
77 -------
82 要自动使用MSI或MSI-X中断向量，请使用以下函数::
89 如果PCI核不能满足最小数量的向量，将返回-ENOSPC。
103 如果一个设备同时支持MSI-X和MSI功能，这个API将优先使用MSI-X，而不是MSI。MSI-X支
105 此外，MSI中断向量必须连续分配，所以系统可能无法为MSI分配像MSI-X那样多的向量。在一
106 些平台上，MSI中断必须全部针对同一组CPU，而MSI-X中断可以全部针对不同的CPU。
108 如果一个设备既不支持MSI-X，也不支持MSI，它就会退回到一个传统的IRQ向量。
110 MSI或MSI-X中断的典型用法是分配尽可能多的向量，可能达到设备支持的极限。如果nvec大于
131 一些设备可能不支持使用传统的线路中断，在这种情况下，驱动程序可以指定只接受MSI或MSI-X。::
138 -----------
140 以下用于启用和禁用MSI或MSI-X中断的旧API不应该在新代码中使用::
148 此外，还有一些API来提供支持的MSI或MSI-X向量的数量：pci_msi_vec_count()和
151 并增加一个pci_nr_irq_vectors()助手，透明地处理MSI和MSI-X。
154 -----------------------
165 如何判断一个设备上是否启用了MSI/MSI-X
166 -------------------------------------
168 使用“lspci -v“（以root身份）可能会显示一些具有“MSI“、“Message Signalled Interrupts“
169 或“MSI-X“功能的设备。这些功能中的每一个都有一个“启用“标志，后面是“+“（启用）
170 或“-“（禁用）。
183 -----------
191 备上的MSI。你最好把问题报告给linux-pci@vger.kernel.org，包括完整的
192 “lspci -v“，这样我们就可以把这些怪癖添加到内核中。
195 -------------
212 同样，请通知 linux-pci@vger.kernel.org 任何需要特殊处理的桥。
215 --------------------
222 -------------------------
228 然后，“lspci -t“给出一个设备上面的网列表。读取 ``/sys/bus/pci/devices/*/msi_bus``
236 MSI(-X) APIs设备驱动程序列表
239 PCI/MSI子系统有一个专门的C文件，用于其导出的设备驱动程序APIs - `drivers/pci/msi/api.c` 。
244 drivers/pci/msi/api.c