[sphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/PCI/pciebus-howtomodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/zh_TW/PCI/pciebus-howtomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/it_IT/PCI/pciebus-howtomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/ja_JP/PCI/pciebus-howtomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/ko_KR/PCI/pciebus-howtomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hPortuguese (Brazilian)}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/pt_BR/PCI/pciebus-howtomodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget%/translations/sp_SP/PCI/pciebus-howtomodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Simplified)uh1h hh _documenthsourceNlineNubhcomment)}(h SPDX-License-Identifier: GPL-2.0h]h SPDX-License-Identifier: GPL-2.0}hhsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1hhhhhhR/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/PCI/pciebus-howto.rsthKubh)}(h4This data file has been placed in the public domain.h]h4This data file has been placed in the public domain.}hhsbah}(h]h ]h"]h$]h&]hhuh1hhhhhho/srv/docbuild/lib/venvs/build-kernel-docs/lib64/python3.9/site-packages/docutils/parsers/rst/include/isonum.txthKubh)}(hDerived from the Unicode character mappings available from . Processed by unicode2rstsubs.py, part of Docutils: .h]hDerived from the Unicode character mappings available from . Processed by unicode2rstsubs.py, part of Docutils: .}hhsbah}(h]h ]h"]h$]h&]hhuh1hhhhhhhhKubhsubstitution_definition)}(h*.. |amp| unicode:: U+00026 .. AMPERSANDh]h&}hhsbah}(h]h ]h"]ampah$]h&]uh1hhhhKhhhhubh)}(h+.. |apos| unicode:: U+00027 .. APOSTROPHEh]h'}hhsbah}(h]h ]h"]aposah$]h&]uh1hhhhKhhhhubh)}(h).. |ast| unicode:: U+0002A .. ASTERISKh]h*}hjsbah}(h]h ]h"]astah$]h&]uh1hhhhK hhhhubh)}(h+.. |brvbar| unicode:: U+000A6 .. BROKEN BARh]h¦}hjsbah}(h]h ]h"]brvbarah$]h&]uh1hhhhK hhhhubh)}(h0.. |bsol| unicode:: U+0005C .. REVERSE SOLIDUSh]h\}hj#sbah}(h]h ]h"]bsolah$]h&]uh1hhhhK hhhhubh)}(h*.. |cent| unicode:: U+000A2 .. CENT SIGNh]h¢}hj2sbah}(h]h ]h"]centah$]h&]uh1hhhhK hhhhubh)}(h&.. |colon| unicode:: U+0003A .. COLONh]h:}hjAsbah}(h]h ]h"]colonah$]h&]uh1hhhhK hhhhubh)}(h&.. |comma| unicode:: U+0002C .. COMMAh]h,}hjPsbah}(h]h ]h"]commaah$]h&]uh1hhhhKhhhhubh)}(h... |commat| unicode:: U+00040 .. COMMERCIAL ATh]h@}hj_sbah}(h]h ]h"]commatah$]h&]uh1hhhhKhhhhubh)}(h/.. |copy| unicode:: U+000A9 .. COPYRIGHT SIGNh]h©}hjnsbah}(h]h ]h"]copyah$]h&]uh1hhhhKhhhhubh)}(h... |curren| unicode:: U+000A4 .. CURRENCY SIGNh]h¤}hj}sbah}(h]h ]h"]currenah$]h&]uh1hhhhKhhhhubh)}(h0.. |darr| unicode:: U+02193 .. DOWNWARDS ARROWh]h↓}hjsbah}(h]h ]h"]darrah$]h&]uh1hhhhKhhhhubh)}(h,.. |deg| unicode:: U+000B0 .. DEGREE SIGNh]h°}hjsbah}(h]h ]h"]degah$]h&]uh1hhhhKhhhhubh)}(h... |divide| unicode:: U+000F7 .. DIVISION SIGNh]h÷}hjsbah}(h]h ]h"]divideah$]h&]uh1hhhhKhhhhubh)}(h,.. |dollar| unicode:: U+00024 .. DOLLAR SIGNh]h$}hjsbah}(h]h ]h"]dollarah$]h&]uh1hhhhKhhhhubh)}(h,.. |equals| unicode:: U+0003D .. EQUALS SIGNh]h=}hjsbah}(h]h ]h"]equalsah$]h&]uh1hhhhKhhhhubh)}(h1.. |excl| unicode:: U+00021 .. EXCLAMATION MARKh]h!}hjsbah}(h]h ]h"]exclah$]h&]uh1hhhhKhhhhubh)}(h9.. |frac12| unicode:: U+000BD .. VULGAR FRACTION ONE HALFh]h½}hjsbah}(h]h ]h"]frac12ah$]h&]uh1hhhhKhhhhubh)}(h<.. |frac14| unicode:: U+000BC .. VULGAR FRACTION ONE QUARTERh]h¼}hjsbah}(h]h ]h"]frac14ah$]h&]uh1hhhhKhhhhubh)}(h;.. |frac18| unicode:: U+0215B .. VULGAR FRACTION ONE EIGHTHh]h⅛}hjsbah}(h]h ]h"]frac18ah$]h&]uh1hhhhKhhhhubh)}(h?.. |frac34| unicode:: U+000BE .. VULGAR FRACTION THREE QUARTERSh]h¾}hjsbah}(h]h ]h"]frac34ah$]h&]uh1hhhhKhhhhubh)}(h>.. |frac38| unicode:: U+0215C .. VULGAR FRACTION THREE EIGHTHSh]h⅜}hj"sbah}(h]h ]h"]frac38ah$]h&]uh1hhhhKhhhhubh)}(h=.. |frac58| unicode:: U+0215D .. VULGAR FRACTION FIVE EIGHTHSh]h⅝}hj1sbah}(h]h ]h"]frac58ah$]h&]uh1hhhhKhhhhubh)}(h>.. |frac78| unicode:: U+0215E .. VULGAR FRACTION SEVEN EIGHTHSh]h⅞}hj@sbah}(h]h ]h"]frac78ah$]h&]uh1hhhhKhhhhubh)}(h2.. |gt| unicode:: U+0003E .. GREATER-THAN SIGNh]h>}hjOsbah}(h]h ]h"]gtah$]h&]uh1hhhhKhhhhubh)}(h9.. |half| unicode:: U+000BD .. VULGAR FRACTION ONE HALFh]h½}hj^sbah}(h]h ]h"]halfah$]h&]uh1hhhhK hhhhubh)}(h/.. |horbar| unicode:: U+02015 .. HORIZONTAL BARh]h―}hjmsbah}(h]h ]h"]horbarah$]h&]uh1hhhhK!hhhhubh)}(h'.. |hyphen| unicode:: U+02010 .. HYPHENh]h‐}hj|sbah}(h]h ]h"]hyphenah$]h&]uh1hhhhK"hhhhubh)}(h:.. |iexcl| unicode:: U+000A1 .. INVERTED EXCLAMATION MARKh]h¡}hjsbah}(h]h ]h"]iexclah$]h&]uh1hhhhK#hhhhubh)}(h7.. |iquest| unicode:: U+000BF .. INVERTED QUESTION MARKh]h¿}hjsbah}(h]h ]h"]iquestah$]h&]uh1hhhhK$hhhhubh)}(hJ.. |laquo| unicode:: U+000AB .. LEFT-POINTING DOUBLE ANGLE QUOTATION MARKh]h«}hjsbah}(h]h ]h"]laquoah$]h&]uh1hhhhK%hhhhubh)}(h0.. |larr| unicode:: U+02190 .. LEFTWARDS ARROWh]h←}hjsbah}(h]h ]h"]larrah$]h&]uh1hhhhK&hhhhubh)}(h3.. |lcub| unicode:: U+0007B .. LEFT CURLY BRACKETh]h{}hjsbah}(h]h ]h"]lcubah$]h&]uh1hhhhK'hhhhubh)}(h;.. |ldquo| unicode:: U+0201C .. LEFT DOUBLE QUOTATION MARKh]h“}hjsbah}(h]h ]h"]ldquoah$]h&]uh1hhhhK(hhhhubh)}(h).. |lowbar| unicode:: U+0005F .. LOW LINEh]h_}hjsbah}(h]h ]h"]lowbarah$]h&]uh1hhhhK)hhhhubh)}(h1.. |lpar| unicode:: U+00028 .. LEFT PARENTHESISh]h(}hjsbah}(h]h ]h"]lparah$]h&]uh1hhhhK*hhhhubh)}(h4.. |lsqb| unicode:: U+0005B .. LEFT SQUARE BRACKETh]h[}hjsbah}(h]h ]h"]lsqbah$]h&]uh1hhhhK+hhhhubh)}(h;.. |lsquo| unicode:: U+02018 .. LEFT SINGLE QUOTATION MARKh]h‘}hjsbah}(h]h ]h"]lsquoah$]h&]uh1hhhhK,hhhhubh)}(h/.. |lt| unicode:: U+0003C .. LESS-THAN SIGNh]h<}hj!sbah}(h]h ]h"]ltah$]h&]uh1hhhhK-hhhhubh)}(h+.. |micro| unicode:: U+000B5 .. MICRO SIGNh]hµ}hj0sbah}(h]h ]h"]microah$]h&]uh1hhhhK.hhhhubh)}(h+.. |middot| unicode:: U+000B7 .. MIDDLE DOTh]h·}hj?sbah}(h]h ]h"]middotah$]h&]uh1hhhhK/hhhhubh)}(h/.. |nbsp| unicode:: U+000A0 .. NO-BREAK SPACEh]h }hjNsbah}(h]h ]h"]nbspah$]h&]uh1hhhhK0hhhhubh)}(h).. |not| unicode:: U+000AC .. NOT SIGNh]h¬}hj]sbah}(h]h ]h"]notah$]h&]uh1hhhhK1hhhhubh)}(h,.. |num| unicode:: U+00023 .. NUMBER SIGNh]h#}hjlsbah}(h]h ]h"]numah$]h&]uh1hhhhK2hhhhubh)}(h).. |ohm| unicode:: U+02126 .. OHM SIGNh]hΩ}hj{sbah}(h]h ]h"]ohmah$]h&]uh1hhhhK3hhhhubh)}(h;.. |ordf| unicode:: U+000AA .. FEMININE ORDINAL INDICATORh]hª}hjsbah}(h]h ]h"]ordfah$]h&]uh1hhhhK4hhhhubh)}(h<.. |ordm| unicode:: U+000BA .. MASCULINE ORDINAL INDICATORh]hº}hjsbah}(h]h ]h"]ordmah$]h&]uh1hhhhK5hhhhubh)}(h-.. |para| unicode:: U+000B6 .. PILCROW SIGNh]h¶}hjsbah}(h]h ]h"]paraah$]h&]uh1hhhhK6hhhhubh)}(h-.. |percnt| unicode:: U+00025 .. PERCENT SIGNh]h%}hjsbah}(h]h ]h"]percntah$]h&]uh1hhhhK7hhhhubh)}(h*.. |period| unicode:: U+0002E .. FULL STOPh]h.}hjsbah}(h]h ]h"]periodah$]h&]uh1hhhhK8hhhhubh)}(h*.. |plus| unicode:: U+0002B .. PLUS SIGNh]h+}hjsbah}(h]h ]h"]plusah$]h&]uh1hhhhK9hhhhubh)}(h0.. |plusmn| unicode:: U+000B1 .. PLUS-MINUS SIGNh]h±}hjsbah}(h]h ]h"]plusmnah$]h&]uh1hhhhK:hhhhubh)}(h+.. |pound| unicode:: U+000A3 .. POUND SIGNh]h£}hjsbah}(h]h ]h"]poundah$]h&]uh1hhhhK;hhhhubh)}(h... |quest| unicode:: U+0003F .. QUESTION MARKh]h?}hjsbah}(h]h ]h"]questah$]h&]uh1hhhhKhhhhubh)}(h1.. |rarr| unicode:: U+02192 .. RIGHTWARDS ARROWh]h→}hj/sbah}(h]h ]h"]rarrah$]h&]uh1hhhhK?hhhhubh)}(h4.. |rcub| unicode:: U+0007D .. RIGHT CURLY BRACKETh]h}}hj>sbah}(h]h ]h"]rcubah$]h&]uh1hhhhK@hhhhubh)}(h<.. |rdquo| unicode:: U+0201D .. RIGHT DOUBLE QUOTATION MARKh]h”}hjMsbah}(h]h ]h"]rdquoah$]h&]uh1hhhhKAhhhhubh)}(h0.. |reg| unicode:: U+000AE .. REGISTERED SIGNh]h®}hj\sbah}(h]h ]h"]regah$]h&]uh1hhhhKBhhhhubh)}(h2.. |rpar| unicode:: U+00029 .. RIGHT PARENTHESISh]h)}hjksbah}(h]h ]h"]rparah$]h&]uh1hhhhKChhhhubh)}(h5.. |rsqb| unicode:: U+0005D .. RIGHT SQUARE BRACKETh]h]}hjzsbah}(h]h ]h"]rsqbah$]h&]uh1hhhhKDhhhhubh)}(h<.. |rsquo| unicode:: U+02019 .. RIGHT SINGLE QUOTATION MARKh]h’}hjsbah}(h]h ]h"]rsquoah$]h&]uh1hhhhKEhhhhubh)}(h-.. |sect| unicode:: U+000A7 .. SECTION SIGNh]h§}hjsbah}(h]h ]h"]sectah$]h&]uh1hhhhKFhhhhubh)}(h*.. |semi| unicode:: U+0003B .. SEMICOLONh]h;}hjsbah}(h]h ]h"]semiah$]h&]uh1hhhhKGhhhhubh)}(h,.. |shy| unicode:: U+000AD .. SOFT HYPHENh]h­}hjsbah}(h]h ]h"]shyah$]h&]uh1hhhhKHhhhhubh)}(h(.. |sol| unicode:: U+0002F .. SOLIDUSh]h/}hjsbah}(h]h ]h"]solah$]h&]uh1hhhhKIhhhhubh)}(h,.. |sung| unicode:: U+0266A .. EIGHTH NOTEh]h♪}hjsbah}(h]h ]h"]sungah$]h&]uh1hhhhKJhhhhubh)}(h0.. |sup1| unicode:: U+000B9 .. SUPERSCRIPT ONEh]h¹}hjsbah}(h]h ]h"]sup1ah$]h&]uh1hhhhKKhhhhubh)}(h0.. |sup2| unicode:: U+000B2 .. SUPERSCRIPT TWOh]h²}hjsbah}(h]h ]h"]sup2ah$]h&]uh1hhhhKLhhhhubh)}(h2.. |sup3| unicode:: U+000B3 .. SUPERSCRIPT THREEh]h³}hjsbah}(h]h ]h"]sup3ah$]h&]uh1hhhhKMhhhhubh)}(h4.. |times| unicode:: U+000D7 .. MULTIPLICATION SIGNh]h×}hjsbah}(h]h ]h"]timesah$]h&]uh1hhhhKNhhhhubh)}(h0.. |trade| unicode:: U+02122 .. TRADE MARK SIGNh]h™}hjsbah}(h]h ]h"]tradeah$]h&]uh1hhhhKOhhhhubh)}(h... |uarr| unicode:: U+02191 .. UPWARDS ARROWh]h↑}hj.sbah}(h]h ]h"]uarrah$]h&]uh1hhhhKPhhhhubh)}(h... |verbar| unicode:: U+0007C .. VERTICAL LINEh]h|}hj=sbah}(h]h ]h"]verbarah$]h&]uh1hhhhKQhhhhubh)}(h*.. |yen| unicode:: U+000A5 .. YEN SIGN h]h¥}hjLsbah}(h]h ]h"]yenah$]h&]uh1hhhhKRhhhhubhnote)}(hX{此文件的目的是为让中文读者更容易阅读和理解,而不是作为一个分支。 因此, 如果您对此文件有任何意见或更新,请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题,请发建议或者补丁给 该文件的译者,或者请求中文文档维护者和审阅者的帮助。h]h paragraph)}(hX{此文件的目的是为让中文读者更容易阅读和理解,而不是作为一个分支。 因此, 如果您对此文件有任何意见或更新,请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题,请发建议或者补丁给 该文件的译者,或者请求中文文档维护者和审阅者的帮助。h]hX{此文件的目的是为让中文读者更容易阅读和理解,而不是作为一个分支。 因此, 如果您对此文件有任何意见或更新,请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题,请发建议或者补丁给 该文件的译者,或者请求中文文档维护者和审阅者的帮助。}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1jah5Documentation/translations/zh_CN/disclaimer-zh_CN.rsthKhj]ubah}(h]h ]h"]h$]h&]uh1j[hhhhhjqhNubh field_list)}(hhh](hfield)}(hhh](h field_name)}(hOriginalh]hOriginal}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhKubh field_body)}(h$Documentation/PCI/pciebus-howto.rst h]jb)}(h#Documentation/PCI/pciebus-howto.rsth]h#Documentation/PCI/pciebus-howto.rst}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hhhKhjzhhubj~)}(hhh](j)}(h翻译h]h翻译}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhKubj)}(h-司延腾 Yanteng Si h]jb)}(h,司延腾 Yanteng Si h](h司延腾 Yanteng Si <}(hjhhhNhNubh reference)}(hsiyanteng@loongson.cnh]hsiyanteng@loongson.cn}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:siyanteng@loongson.cnuh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jahhhK hjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hhhKhjzhhubj~)}(hhh](j)}(h校译h]h校译}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhKubj)}(hhh]h}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hhhK hjzhhubeh}(h]h ]h"]h$]h&]uh1jxhhhhhhhKubhtarget)}(h.. _cn_pciebus-howto:h]h}(h]h ]h"]h$]h&]refidcn-pciebus-howtouh1jhKphhhhhhubhsection)}(hhh](htitle)}(h#PCI Express端口总线驱动指南h]h#PCI Express端口总线驱动指南}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1j0hj-hhhhhKubjy)}(hhh](j~)}(hhh](j)}(h作者h]h作者}(hjFhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjChhhKubj)}(h.Tom L Nguyen tom.l.nguyen@intel.com 11/03/2004h]jb)}(hjVh](h Tom L Nguyen }(hjXhhhNhNubj)}(htom.l.nguyen@intel.comh]htom.l.nguyen@intel.com}(hj_hhhNhNubah}(h]h ]h"]h$]h&]refurimailto:tom.l.nguyen@intel.comuh1jhjXubh 11/03/2004}(hjXhhhNhNubeh}(h]h ]h"]h$]h&]uh1jahhhKhjTubah}(h]h ]h"]h$]h&]uh1jhjCubeh}(h]h ]h"]h$]h&]uh1j}hhhKhj@hhubj~)}(hhh](j)}(h版权h]h版权}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jhjhhhKubj)}(h|copy| 2004 Intel Corporation h]jb)}(h|copy| 2004 Intel Corporationh](h©}(hjhhhNhNubh 2004 Intel Corporation}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1jahhhKhjubah}(h]h ]h"]h$]h&]uh1jhjubeh}(h]h ]h"]h$]h&]uh1j}hhhKhj@hhubeh}(h]h ]h"]h$]h&]uh1jxhj-hhhhhKubj,)}(hhh](j1)}(h关于本指南h]h关于本指南}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjhhhhhKubjb)}(h本指南介绍了PCI Express端口总线驱动程序的基本知识,并提供了如何使服务驱 动程序在PCI Express端口总线驱动程序中注册/取消注册的介绍。h]h本指南介绍了PCI Express端口总线驱动程序的基本知识,并提供了如何使服务驱 动程序在PCI Express端口总线驱动程序中注册/取消注册的介绍。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKhjhhubeh}(h]id1ah ]h"]关于本指南ah$]h&]uh1j+hj-hhhhhKubj,)}(hhh](j1)}(h,什么是PCI Express端口总线驱动程序h]h,什么是PCI Express端口总线驱动程序}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjhhhhhK ubjb)}(hX一个PCI Express端口是一个逻辑的PCI-PCI桥结构。有两种类型的PCI Express端 口:根端口和交换端口。根端口从PCI Express根综合体发起一个PCI Express链接, 交换端口将PCI Express链接连接到内部逻辑PCI总线。交换机端口,其二级总线代表 交换机的内部路由逻辑,被称为交换机的上行端口。交换机的下行端口是从交换机的内部 路由总线桥接到代表来自PCI Express交换机的下游PCI Express链接的总线。h]hX一个PCI Express端口是一个逻辑的PCI-PCI桥结构。有两种类型的PCI Express端 口:根端口和交换端口。根端口从PCI Express根综合体发起一个PCI Express链接, 交换端口将PCI Express链接连接到内部逻辑PCI总线。交换机端口,其二级总线代表 交换机的内部路由逻辑,被称为交换机的上行端口。交换机的下行端口是从交换机的内部 路由总线桥接到代表来自PCI Express交换机的下游PCI Express链接的总线。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhK"hjhhubjb)}(hX一个PCI Express端口可以提供多达四个不同的功能,在本文中被称为服务,这取决于 其端口类型。PCI Express端口的服务包括本地热拔插支持(HP)、电源管理事件支持(PME)、 高级错误报告支持(AER)和虚拟通道支持(VC)。这些服务可以由一个复杂的驱动程序 处理,也可以单独分布并由相应的服务驱动程序处理。h]hX一个PCI Express端口可以提供多达四个不同的功能,在本文中被称为服务,这取决于 其端口类型。PCI Express端口的服务包括本地热拔插支持(HP)、电源管理事件支持(PME)、 高级错误报告支持(AER)和虚拟通道支持(VC)。这些服务可以由一个复杂的驱动程序 处理,也可以单独分布并由相应的服务驱动程序处理。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhK(hjhhubeh}(h]id2ah ]h"],什么是pci express端口总线驱动程序ah$]h&]uh1j+hj-hhhhhK ubj,)}(hhh](j1)}(h8为什么要使用PCI Express端口总线驱动程序?h]h8为什么要使用PCI Express端口总线驱动程序?}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjhhhhhK.ubjb)}(hX在现有的Linux内核中,Linux设备驱动模型允许一个物理设备只由一个驱动处理。 PCI Express端口是一个具有多个不同服务的PCI-PCI桥设备。为了保持一个干净和简 单的解决方案,每个服务都可以有自己的软件服务驱动。在这种情况下,几个服务驱动将 竞争一个PCI-PCI桥设备。例如,如果PCI Express根端口的本机热拔插服务驱动程序 首先被加载,它就会要求一个PCI-PCI桥根端口。因此,内核不会为该根端口加载其他服 务驱动。换句话说,使用当前的驱动模型,不可能让多个服务驱动同时加载并运行在 PCI-PCI桥设备上。h]hX在现有的Linux内核中,Linux设备驱动模型允许一个物理设备只由一个驱动处理。 PCI Express端口是一个具有多个不同服务的PCI-PCI桥设备。为了保持一个干净和简 单的解决方案,每个服务都可以有自己的软件服务驱动。在这种情况下,几个服务驱动将 竞争一个PCI-PCI桥设备。例如,如果PCI Express根端口的本机热拔插服务驱动程序 首先被加载,它就会要求一个PCI-PCI桥根端口。因此,内核不会为该根端口加载其他服 务驱动。换句话说,使用当前的驱动模型,不可能让多个服务驱动同时加载并运行在 PCI-PCI桥设备上。}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhK0hjhhubjb)}(hX5为了使多个服务驱动程序同时运行,需要有一个PCI Express端口总线驱动程序,它管 理所有填充的PCI Express端口,并根据需要将所有提供的服务请求分配给相应的服务 驱动程序。下面列出了使用PCI Express端口总线驱动程序的一些关键优势:h]hX5为了使多个服务驱动程序同时运行,需要有一个PCI Express端口总线驱动程序,它管 理所有填充的PCI Express端口,并根据需要将所有提供的服务请求分配给相应的服务 驱动程序。下面列出了使用PCI Express端口总线驱动程序的一些关键优势:}(hj9hhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhK8hjhhubh block_quote)}(hX5- 允许在一个PCI-PCI桥接端口设备上同时运行多个服务驱动。 - 允许以独立的分阶段方式实施服务驱动程序。 - 允许一个服务驱动程序在多个PCI-PCI桥接端口设备上运行。 - 管理和分配PCI-PCI桥接端口设备的资源给要求的服务驱动程序。 h]h bullet_list)}(hhh](h list_item)}(hM允许在一个PCI-PCI桥接端口设备上同时运行多个服务驱动。 h]jb)}(hL允许在一个PCI-PCI桥接端口设备上同时运行多个服务驱动。h]hL允许在一个PCI-PCI桥接端口设备上同时运行多个服务驱动。}(hjXhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKhjlubah}(h]h ]h"]h$]h&]uh1jRhjOubjS)}(hM允许一个服务驱动程序在多个PCI-PCI桥接端口设备上运行。 h]jb)}(hL允许一个服务驱动程序在多个PCI-PCI桥接端口设备上运行。h]hL允许一个服务驱动程序在多个PCI-PCI桥接端口设备上运行。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhK@hjubah}(h]h ]h"]h$]h&]uh1jRhjOubjS)}(hS管理和分配PCI-PCI桥接端口设备的资源给要求的服务驱动程序。 h]jb)}(hR管理和分配PCI-PCI桥接端口设备的资源给要求的服务驱动程序。h]hR管理和分配PCI-PCI桥接端口设备的资源给要求的服务驱动程序。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKBhjubah}(h]h ]h"]h$]h&]uh1jRhjOubeh}(h]h ]h"]h$]h&]bullet-uh1jMhhhK配置PCI Express端口总线驱动程序与服务驱动程序h]h>配置PCI Express端口总线驱动程序与服务驱动程序}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjhhhhhKEubj,)}(hhh](j1)}(h2将PCI Express端口总线驱动支持纳入内核h]h2将PCI Express端口总线驱动支持纳入内核}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjhhhhhKHubjb)}(h包括PCI Express端口总线驱动程序取决于内核配置中是否包含PCI Express支持。当内核 中的PCI Express支持被启用时,内核将自动包含PCI Express端口总线驱动程序作为内核 驱动程序。h]h包括PCI Express端口总线驱动程序取决于内核配置中是否包含PCI Express支持。当内核 中的PCI Express支持被启用时,内核将自动包含PCI Express端口总线驱动程序作为内核 驱动程序。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKJhjhhubeh}(h]id5ah ]h"]2将pci express端口总线驱动支持纳入内核ah$]h&]uh1j+hjhhhhhKHubj,)}(hhh](j1)}(h启用服务驱动支持h]h启用服务驱动支持}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjhhhhhKOubjb)}(hXPCI设备驱动是基于Linux设备驱动模型实现的。所有的服务驱动都是PCI设备驱动。如上所述, 一旦内核加载了PCI Express端口总线驱动程序,就不可能再加载任何服务驱动程序。为了满 足PCI Express端口总线驱动程序模型,需要对现有的服务驱动程序进行一些最小的改变,其 对现有的服务驱动程序的功能没有影响。h]hXPCI设备驱动是基于Linux设备驱动模型实现的。所有的服务驱动都是PCI设备驱动。如上所述, 一旦内核加载了PCI Express端口总线驱动程序,就不可能再加载任何服务驱动程序。为了满 足PCI Express端口总线驱动程序模型,需要对现有的服务驱动程序进行一些最小的改变,其 对现有的服务驱动程序的功能没有影响。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKQhjhhubjb)}(hX服务驱动程序需要使用下面所示的两个API,将其服务注册到PCI Express端口总线驱动程 序中(见第5.2.1和5.2.2节)。在调用这些API之前,服务驱动程序必须初始化头文件 /include/linux/pcieport_if.h中的pcie_port_service_driver数据结构。如果不这 样做,将导致身份不匹配,从而使PCI Express端口总线驱动程序无法加载服务驱动程序。h]hX服务驱动程序需要使用下面所示的两个API,将其服务注册到PCI Express端口总线驱动程 序中(见第5.2.1和5.2.2节)。在调用这些API之前,服务驱动程序必须初始化头文件 /include/linux/pcieport_if.h中的pcie_port_service_driver数据结构。如果不这 样做,将导致身份不匹配,从而使PCI Express端口总线驱动程序无法加载服务驱动程序。}(hj!hhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKVhjhhubj,)}(hhh](j1)}(hpcie_port_service_registerh]hpcie_port_service_register}(hj2hhhNhNubah}(h]h ]h"]h$]h&]uh1j0hj/hhhhhK\ubh literal_block)}(hDint pcie_port_service_register(struct pcie_port_service_driver *new)h]hDint pcie_port_service_register(struct pcie_port_service_driver *new)}hjBsbah}(h]h ]h"]h$]h&]hhuh1j@hhhK_hj/hhubjb)}(hXB这个API取代了Linux驱动模型的 pci_register_driver API。一个服务驱动应该总是在模 块启动时调用 pcie_port_service_register。请注意,在服务驱动被加载后,诸如 pci_enable_device(dev) 和 pci_set_master(dev) 的调用不再需要,因为这些调用由 PCI端口总线驱动执行。h]hXB这个API取代了Linux驱动模型的 pci_register_driver API。一个服务驱动应该总是在模 块启动时调用 pcie_port_service_register。请注意,在服务驱动被加载后,诸如 pci_enable_device(dev) 和 pci_set_master(dev) 的调用不再需要,因为这些调用由 PCI端口总线驱动执行。}(hjPhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKahj/hhubeh}(h]pcie-port-service-registerah ]h"]pcie_port_service_registerah$]h&]uh1j+hjhhhhhK\ubj,)}(hhh](j1)}(hpcie_port_service_unregisterh]hpcie_port_service_unregister}(hjihhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjfhhhhhKgubjA)}(hGvoid pcie_port_service_unregister(struct pcie_port_service_driver *new)h]hGvoid pcie_port_service_unregister(struct pcie_port_service_driver *new)}hjwsbah}(h]h ]h"]h$]h&]hhuh1j@hhhKjhjfhhubjb)}(hpcie_port_service_unregister取代了Linux驱动模型的pci_unregister_driver。当一 个模块退出时,它总是被服务驱动调用。h]hpcie_port_service_unregister取代了Linux驱动模型的pci_unregister_driver。当一 个模块退出时,它总是被服务驱动调用。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKlhjfhhubeh}(h]pcie-port-service-unregisterah ]h"]pcie_port_service_unregisterah$]h&]uh1j+hjhhhhhKgubj,)}(hhh](j1)}(h 示例代码h]h 示例代码}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjhhhhhKpubjb)}(h`下面是服务驱动代码示例,用于初始化端口服务的驱动程序数据结构。 ::h]h]下面是服务驱动代码示例,用于初始化端口服务的驱动程序数据结构。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKrhjhhubjA)}(hXstatic struct pcie_port_service_id service_id[] = { { .vendor = PCI_ANY_ID, .device = PCI_ANY_ID, .port_type = PCIE_RC_PORT, .service_type = PCIE_PORT_SERVICE_AER, }, { /* end: all zeroes */ } }; static struct pcie_port_service_driver root_aerdrv = { .name = (char *)device_name, .id_table = service_id, .probe = aerdrv_load, .remove = aerdrv_unload, .suspend = aerdrv_suspend, .resume = aerdrv_resume, };h]hXstatic struct pcie_port_service_id service_id[] = { { .vendor = PCI_ANY_ID, .device = PCI_ANY_ID, .port_type = PCIE_RC_PORT, .service_type = PCIE_PORT_SERVICE_AER, }, { /* end: all zeroes */ } }; static struct pcie_port_service_driver root_aerdrv = { .name = (char *)device_name, .id_table = service_id, .probe = aerdrv_load, .remove = aerdrv_unload, .suspend = aerdrv_suspend, .resume = aerdrv_resume, };}hjsbah}(h]h ]h"]h$]h&]hhuh1j@hhhKuhjhhubjb)}(hC下面是一个注册/取消注册服务驱动的示例代码。 ::h]h@下面是一个注册/取消注册服务驱动的示例代码。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKhjhhubjA)}(hX]static int __init aerdrv_service_init(void) { int retval = 0; retval = pcie_port_service_register(&root_aerdrv); if (!retval) { /* * FIX ME */ } return retval; } static void __exit aerdrv_service_exit(void) { pcie_port_service_unregister(&root_aerdrv); } module_init(aerdrv_service_init); module_exit(aerdrv_service_exit);h]hX]static int __init aerdrv_service_init(void) { int retval = 0; retval = pcie_port_service_register(&root_aerdrv); if (!retval) { /* * FIX ME */ } return retval; } static void __exit aerdrv_service_exit(void) { pcie_port_service_unregister(&root_aerdrv); } module_init(aerdrv_service_init); module_exit(aerdrv_service_exit);}hjsbah}(h]h ]h"]h$]h&]hhuh1j@hhhKhjhhubeh}(h]id7ah ]h"] 示例代码ah$]h&]uh1j+hjhhhhhKpubeh}(h]id6ah ]h"]启用服务驱动支持ah$]h&]uh1j+hjhhhhhKOubeh}(h]id4ah ]h"]>配置pci express端口总线驱动程序与服务驱动程序ah$]h&]uh1j+hj-hhhhhKEubj,)}(hhh](j1)}(h可能的资源冲突h]h可能的资源冲突}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjhhhhhKubjb)}(h由于PCI-PCI桥接端口设备的所有服务驱动被允许同时运行,下面列出了一些可能的资源冲突和 建议的解决方案。h]h由于PCI-PCI桥接端口设备的所有服务驱动被允许同时运行,下面列出了一些可能的资源冲突和 建议的解决方案。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKhjhhubj,)}(hhh](j1)}(hMSI 和 MSI-X 向量资源h]hMSI 和 MSI-X 向量资源}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1j0hj hhhhhKubjb)}(hX7一旦设备上的MSI或MSI-X中断被启用,它就会一直保持这种模式,直到它们再次被禁用。由于同 一个PCI-PCI桥接端口的服务驱动程序共享同一个物理设备,如果一个单独的服务驱动程序启用或 禁用MSI/MSI-X模式,可能会导致不可预知的行为。h]hX7一旦设备上的MSI或MSI-X中断被启用,它就会一直保持这种模式,直到它们再次被禁用。由于同 一个PCI-PCI桥接端口的服务驱动程序共享同一个物理设备,如果一个单独的服务驱动程序启用或 禁用MSI/MSI-X模式,可能会导致不可预知的行为。}(hj, hhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKhj hhubjb)}(hX7为了避免这种情况,所有的服务驱动程序都不允许在其设备上切换中断模式。PCI Express端口 总线驱动程序负责确定中断模式,这对服务驱动程序来说应该是透明的。服务驱动程序只需要知道 分配给结构体pcie_device的字段irq的向量IRQ,当PCI Express端口总线驱动程序探测每 个服务驱动程序时,它被传入。服务驱动应该使用(struct pcie_device*)dev->irq来调用 request_irq/free_irq。此外,中断模式被存储在struct pcie_device的interrupt_mode 字段中。h]hX7为了避免这种情况,所有的服务驱动程序都不允许在其设备上切换中断模式。PCI Express端口 总线驱动程序负责确定中断模式,这对服务驱动程序来说应该是透明的。服务驱动程序只需要知道 分配给结构体pcie_device的字段irq的向量IRQ,当PCI Express端口总线驱动程序探测每 个服务驱动程序时,它被传入。服务驱动应该使用(struct pcie_device*)dev->irq来调用 request_irq/free_irq。此外,中断模式被存储在struct pcie_device的interrupt_mode 字段中。}(hj: hhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKhj hhubeh}(h] msi-msi-xah ]h"]msi 和 msi-x 向量资源ah$]h&]uh1j+hjhhhhhKubj,)}(hhh](j1)}(hPCI内存/IO映射的区域h]hPCI内存/IO映射的区域}(hjS hhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjP hhhhhKubjb)}(hX`PCI Express电源管理(PME)、高级错误报告(AER)、热插拔(HP)和虚拟通道(VC)的服务 驱动程序访问PCI Express端口的PCI配置空间。在所有情况下,访问的寄存器是相互独立的。这 个补丁假定所有的服务驱动程序都会表现良好,不会覆盖其他服务驱动程序的配置设置。h]hX`PCI Express电源管理(PME)、高级错误报告(AER)、热插拔(HP)和虚拟通道(VC)的服务 驱动程序访问PCI Express端口的PCI配置空间。在所有情况下,访问的寄存器是相互独立的。这 个补丁假定所有的服务驱动程序都会表现良好,不会覆盖其他服务驱动程序的配置设置。}(hja hhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKhjP hhubeh}(h]pci-ioah ]h"]pci内存/io映射的区域ah$]h&]uh1j+hjhhhhhKubj,)}(hhh](j1)}(hPCI配置寄存器h]hPCI配置寄存器}(hjz hhhNhNubah}(h]h ]h"]h$]h&]uh1j0hjw hhhhhKubjb)}(hX*每个服务驱动都在自己的功能结构体上运行PCI配置操作,除了PCI Express功能结构体,其中根控制 寄存器和设备控制寄存器是在PME和AER之间共享。这个补丁假定所有的服务驱动都会表现良好,不会 覆盖其他服务驱动的配置设置。h]hX*每个服务驱动都在自己的功能结构体上运行PCI配置操作,除了PCI Express功能结构体,其中根控制 寄存器和设备控制寄存器是在PME和AER之间共享。这个补丁假定所有的服务驱动都会表现良好,不会 覆盖其他服务驱动的配置设置。}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jahhhKhjw hhubeh}(h]pciah ]h"]pci配置寄存器ah$]h&]uh1j+hjhhhhhKubeh}(h]id8ah ]h"]可能的资源冲突ah$]h&]uh1j+hj-hhhhhKubeh}(h]( pci-expressj*eh ]h"](#pci express端口总线驱动指南cn_pciebus-howtoeh$]h&]uh1j+hhhhhhhKexpect_referenced_by_name}j jsexpect_referenced_by_id}j*jsubeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(j0N generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourcehnj _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}(hhjhjjj jj/j#j>j2jMjAj\jPjkj_jzjnjj}jjjjjjjjjjjjjjjjjjjjj.j"j=j1jLj@j[jOjjj^jyjmjj|jjjjjjjjjjjjjjjjjjjjj-j!j<j0jKj?jZjNjij]jxjljj{jjjjjjjjjjjjjjjjjjjjj,j j;j/jJj>jYjMjhj\jwjkjjzjjjjjjjjjjjjjjjjj jjjj+jj:j.jIj=jXjLusubstitution_names}(amphaposjastjbrvbarj bsolj/centj>colonjMcommaj\commatjkcopyjzcurrenjdarrjdegjdividejdollarjequalsjexcljfrac12jfrac14jfrac18jfrac34jfrac38j.frac58j=frac78jLgtj[halfjjhorbarjyhyphenjiexcljiquestjlaquojlarrjlcubjldquojlowbarjlparjlsqbjlsquojltj-microj<middotjKnbspjZnotjinumjxohmjordfjordmjparajpercntjperiodjplusjplusmnjpoundjquestjquotjraquoj,rarrj;rcubjJrdquojYregjhrparjwrsqbjrsquojsectjsemijshyjsoljsungjsup1jsup2jsup3j timesjtradej+uarrj:verbarjIyenjXurefnames}refids}j*]jasnameids}(j j*j j jjjjjjjjjjjjjcj`jjjjj j jM jJ jt jq j j u nametypes}(j j jjjjjjjcjjj jM jt j uh}(j*j-j j-jjjjjjjjjjjjj`j/jjfjjj jjJ j jq jP j jw u footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}j KsRparse_messages](hsystem_message)}(hhh]jb)}(hfPossible title underline, too short for the title. Treating it as ordinary text because it's so short.h]hhPossible title underline, too short for the title. Treating it as ordinary text because it’s so short.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jahj ubah}(h]h ]h"]h$]h&]levelKtypeINFOlineKssourcehuh1j hjhhhhhKsubj )}(hhh]jb)}(hfPossible title underline, too short for the title. Treating it as ordinary text because it's so short.h]hhPossible title underline, too short for the title. Treating it as ordinary text because it’s so short.}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1jahj ubah}(h]h ]h"]h$]h&]levelKtypej lineKsourcehuh1j hjhhhhhKubetransform_messages]j )}(hhh]jb)}(hhh]h6Hyperlink target "cn-pciebus-howto" is not referenced.}hj sbah}(h]h ]h"]h$]h&]uh1jahj ubah}(h]h ]h"]h$]h&]levelKtypej sourcehnjlineKpuh1j uba transformerN include_log]6Documentation/translations/zh_CN/PCI/pciebus-howto.rst(NNNNta decorationNhhub.