€•ÿ     Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ/translations/zh_CN/fpga/dfl”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/zh_TW/fpga/dfl”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/it_IT/fpga/dfl”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/ja_JP/fpga/dfl”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/ko_KR/fpga/dfl”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒPortuguese (Brazilian)”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/pt_BR/fpga/dfl”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh–sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ/translations/sp_SP/fpga/dfl”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒ1FPGA Device Feature List (DFL) Framework Overview”h]”hŒ1FPGA Device Feature List (DFL) Framework Overview”…””}”(hh¼h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhh·h²hh³Œ6/var/lib/git/docbuild/linux/Documentation/fpga/dfl.rst”h´KubhŒ	paragraph”“”)”}”(hŒAuthors:”h]”hŒAuthors:”…””}”(hhÍh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubhŒbullet_list”“”)”}”(hhh]”(hŒ	list_item”“”)”}”(hŒ'Enno Luebbers <enno.luebbers@intel.com>”h]”hÌ)”}”(hhäh]”(hŒEnno Luebbers <”…””}”(hhæh²hh³Nh´NubhŒ	reference”“”)”}”(hŒenno.luebbers@intel.com”h]”hŒenno.luebbers@intel.com”…””}”(hhïh²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:enno.luebbers@intel.com”uh1híhhæubhŒ>”…””}”(hhæh²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khhâubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhhÝh²hh³hÊh´Nubhá)”}”(hŒ/Xiao Guangrong <guangrong.xiao@linux.intel.com>”h]”hÌ)”}”(hj  h]”(hŒXiao Guangrong <”…””}”(hj  h²hh³Nh´Nubhî)”}”(hŒguangrong.xiao@linux.intel.com”h]”hŒguangrong.xiao@linux.intel.com”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œ%mailto:guangrong.xiao@linux.intel.com”uh1híhj  ubhŒ>”…””}”(hj  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhhÝh²hh³hÊh´Nubhá)”}”(hŒWu Hao <hao.wu@intel.com>”h]”hÌ)”}”(hj<  h]”(hŒWu Hao <”…””}”(hj>  h²hh³Nh´Nubhî)”}”(hŒhao.wu@intel.com”h]”hŒhao.wu@intel.com”…””}”(hjE  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:hao.wu@intel.com”uh1híhj>  ubhŒ>”…””}”(hj>  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K	hj:  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhhÝh²hh³hÊh´Nubhá)”}”(hŒXu Yilun <yilun.xu@intel.com>
”h]”hÌ)”}”(hŒXu Yilun <yilun.xu@intel.com>”h]”(hŒ
Xu Yilun <”…””}”(hji  h²hh³Nh´Nubhî)”}”(hŒyilun.xu@intel.com”h]”hŒyilun.xu@intel.com”…””}”(hjq  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”Œmailto:yilun.xu@intel.com”uh1híhji  ubhŒ>”…””}”(hji  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K
hje  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhhÝh²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”Œbullet”Œ-”uh1hÛh³hÊh´Khh·h²hubhÌ)”}”(hX·  The Device Feature List (DFL) FPGA framework (and drivers according to
this framework) hides the very details of low layer hardware and provides
unified interfaces to userspace. Applications could use these interfaces to
configure, enumerate, open and access FPGA accelerators on platforms which
implement the DFL in the device memory. Besides this, the DFL framework
enables system level management functions such as FPGA reconfiguration.”h]”hX·  The Device Feature List (DFL) FPGA framework (and drivers according to
this framework) hides the very details of low layer hardware and provides
unified interfaces to userspace. Applications could use these interfaces to
configure, enumerate, open and access FPGA accelerators on platforms which
implement the DFL in the device memory. Besides this, the DFL framework
enables system level management functions such as FPGA reconfiguration.”…””}”(hj™  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khh·h²hubh¶)”}”(hhh]”(h»)”}”(hŒ"Device Feature List (DFL) Overview”h]”hŒ"Device Feature List (DFL) Overview”…””}”(hjª  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj§  h²hh³hÊh´KubhÌ)”}”(hXO  Device Feature List (DFL) defines a linked list of feature headers within the
device MMIO space to provide an extensible way of adding features. Software can
walk through these predefined data structures to enumerate FPGA features:
FPGA Interface Unit (FIU), Accelerated Function Unit (AFU) and Private Features,
as illustrated below::”h]”hXN  Device Feature List (DFL) defines a linked list of feature headers within the
device MMIO space to provide an extensible way of adding features. Software can
walk through these predefined data structures to enumerate FPGA features:
FPGA Interface Unit (FIU), Accelerated Function Unit (AFU) and Private Features,
as illustrated below:”…””}”(hj¸  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khj§  h²hubhŒliteral_block”“”)”}”(hXF     Header            Header            Header            Header
+----------+  +-->+----------+  +-->+----------+  +-->+----------+
|   Type   |  |   |  Type    |  |   |  Type    |  |   |  Type    |
|   FIU    |  |   | Private  |  |   | Private  |  |   | Private  |
+----------+  |   | Feature  |  |   | Feature  |  |   | Feature  |
| Next_DFH |--+   +----------+  |   +----------+  |   +----------+
+----------+      | Next_DFH |--+   | Next_DFH |--+   | Next_DFH |--> NULL
|    ID    |      +----------+      +----------+      +----------+
+----------+      |    ID    |      |    ID    |      |    ID    |
| Next_AFU |--+   +----------+      +----------+      +----------+
+----------+  |   | Feature  |      | Feature  |      | Feature  |
|  Header  |  |   | Register |      | Register |      | Register |
| Register |  |   |   Set    |      |   Set    |      |   Set    |
|   Set    |  |   +----------+      +----------+      +----------+
+----------+  |      Header
              +-->+----------+
                  |   Type   |
                  |   AFU    |
                  +----------+
                  | Next_DFH |--> NULL
                  +----------+
                  |   GUID   |
                  +----------+
                  |  Header  |
                  | Register |
                  |   Set    |
                  +----------+”h]”hXF     Header            Header            Header            Header
+----------+  +-->+----------+  +-->+----------+  +-->+----------+
|   Type   |  |   |  Type    |  |   |  Type    |  |   |  Type    |
|   FIU    |  |   | Private  |  |   | Private  |  |   | Private  |
+----------+  |   | Feature  |  |   | Feature  |  |   | Feature  |
| Next_DFH |--+   +----------+  |   +----------+  |   +----------+
+----------+      | Next_DFH |--+   | Next_DFH |--+   | Next_DFH |--> NULL
|    ID    |      +----------+      +----------+      +----------+
+----------+      |    ID    |      |    ID    |      |    ID    |
| Next_AFU |--+   +----------+      +----------+      +----------+
+----------+  |   | Feature  |      | Feature  |      | Feature  |
|  Header  |  |   | Register |      | Register |      | Register |
| Register |  |   |   Set    |      |   Set    |      |   Set    |
|   Set    |  |   +----------+      +----------+      +----------+
+----------+  |      Header
              +-->+----------+
                  |   Type   |
                  |   AFU    |
                  +----------+
                  | Next_DFH |--> NULL
                  +----------+
                  |   GUID   |
                  +----------+
                  |  Header  |
                  | Register |
                  |   Set    |
                  +----------+”…””}”hjÈ  sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1jÆ  h³hÊh´Khj§  h²hubhÌ)”}”(hŒÂFPGA Interface Unit (FIU) represents a standalone functional unit for the
interface to FPGA, e.g. the FPGA Management Engine (FME) and Port (more
descriptions on FME and Port in later sections).”h]”hŒÂFPGA Interface Unit (FIU) represents a standalone functional unit for the
interface to FPGA, e.g. the FPGA Management Engine (FME) and Port (more
descriptions on FME and Port in later sections).”…””}”(hjØ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K8hj§  h²hubhÌ)”}”(hŒ”Accelerated Function Unit (AFU) represents an FPGA programmable region and
always connects to a FIU (e.g. a Port) as its child as illustrated above.”h]”hŒ”Accelerated Function Unit (AFU) represents an FPGA programmable region and
always connects to a FIU (e.g. a Port) as its child as illustrated above.”…””}”(hjæ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K<hj§  h²hubhÌ)”}”(hX  Private Features represent sub features of the FIU and AFU. They could be
various function blocks with different IDs, but all private features which
belong to the same FIU or AFU, must be linked to one list via the Next Device
Feature Header (Next_DFH) pointer.”h]”hX  Private Features represent sub features of the FIU and AFU. They could be
various function blocks with different IDs, but all private features which
belong to the same FIU or AFU, must be linked to one list via the Next Device
Feature Header (Next_DFH) pointer.”…””}”(hjô  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K?hj§  h²hubhÌ)”}”(hX5  Each FIU, AFU and Private Feature could implement its own functional registers.
The functional register set for FIU and AFU, is named as Header Register Set,
e.g. FME Header Register Set, and the one for Private Feature, is named as
Feature Register Set, e.g. FME Partial Reconfiguration Feature Register Set.”h]”hX5  Each FIU, AFU and Private Feature could implement its own functional registers.
The functional register set for FIU and AFU, is named as Header Register Set,
e.g. FME Header Register Set, and the one for Private Feature, is named as
Feature Register Set, e.g. FME Partial Reconfiguration Feature Register Set.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KDhj§  h²hubhÌ)”}”(hŒÖThis Device Feature List provides a way of linking features together, it's
convenient for software to locate each feature by walking through this list,
and can be implemented in register regions of any FPGA device.”h]”hŒØThis Device Feature List provides a way of linking features together, itâ€™s
convenient for software to locate each feature by walking through this list,
and can be implemented in register regions of any FPGA device.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KIhj§  h²hubeh}”(h]”Œ device-feature-list-dfl-overview”ah ]”h"]”Œ"device feature list (dfl) overview”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kubh¶)”}”(hhh]”(h»)”}”(hŒ!Device Feature Header - Version 0”h]”hŒ!Device Feature Header - Version 0”…””}”(hj)  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj&  h²hh³hÊh´KOubhÌ)”}”(hŒ¢Version 0 (DFHv0) is the original version of the Device Feature Header.
All multi-byte quantities in DFHv0 are little-endian.
The format of DFHv0 is shown below::”h]”hŒ¡Version 0 (DFHv0) is the original version of the Device Feature Header.
All multi-byte quantities in DFHv0 are little-endian.
The format of DFHv0 is shown below:”…””}”(hj7  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KPhj&  h²hubjÇ  )”}”(hX  +-----------------------------------------------------------------------+
|63 Type 60|59 DFH VER 52|51 Rsvd 41|40 EOL|39 Next 16|15 REV 12|11 ID 0| 0x00
+-----------------------------------------------------------------------+
|63                                 GUID_L                             0| 0x08
+-----------------------------------------------------------------------+
|63                                 GUID_H                             0| 0x10
+-----------------------------------------------------------------------+”h]”hX  +-----------------------------------------------------------------------+
|63 Type 60|59 DFH VER 52|51 Rsvd 41|40 EOL|39 Next 16|15 REV 12|11 ID 0| 0x00
+-----------------------------------------------------------------------+
|63                                 GUID_L                             0| 0x08
+-----------------------------------------------------------------------+
|63                                 GUID_H                             0| 0x10
+-----------------------------------------------------------------------+”…””}”hjE  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´KThj&  h²hubhÜ)”}”(hhh]”(há)”}”(hX  Offset 0x00

* Type - The type of DFH (e.g. FME, AFU, or private feature).
* DFH VER - The version of the DFH.
* Rsvd - Currently unused.
* EOL - Set if the DFH is the end of the Device Feature List (DFL).
* Next - The offset in bytes of the next DFH in the DFL from the DFH start,
  and the start of a DFH must be aligned to an 8 byte boundary.
  If EOL is set, Next is the size of MMIO of the last feature in the list.
* REV - The revision of the feature associated with this header.
* ID - The feature ID if Type is private feature.
”h]”(hÌ)”}”(hŒOffset 0x00”h]”hŒOffset 0x00”…””}”(hjZ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K\hjV  ubhÜ)”}”(hhh]”(há)”}”(hŒ;Type - The type of DFH (e.g. FME, AFU, or private feature).”h]”hÌ)”}”(hjm  h]”hŒ;Type - The type of DFH (e.g. FME, AFU, or private feature).”…””}”(hjo  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K^hjk  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjh  ubhá)”}”(hŒ!DFH VER - The version of the DFH.”h]”hÌ)”}”(hj„  h]”hŒ!DFH VER - The version of the DFH.”…””}”(hj†  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K_hj‚  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjh  ubhá)”}”(hŒRsvd - Currently unused.”h]”hÌ)”}”(hj›  h]”hŒRsvd - Currently unused.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K`hj™  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjh  ubhá)”}”(hŒAEOL - Set if the DFH is the end of the Device Feature List (DFL).”h]”hÌ)”}”(hj²  h]”hŒAEOL - Set if the DFH is the end of the Device Feature List (DFL).”…””}”(hj´  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kahj°  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjh  ubhá)”}”(hŒÐNext - The offset in bytes of the next DFH in the DFL from the DFH start,
and the start of a DFH must be aligned to an 8 byte boundary.
If EOL is set, Next is the size of MMIO of the last feature in the list.”h]”hÌ)”}”(hŒÐNext - The offset in bytes of the next DFH in the DFL from the DFH start,
and the start of a DFH must be aligned to an 8 byte boundary.
If EOL is set, Next is the size of MMIO of the last feature in the list.”h]”hŒÐNext - The offset in bytes of the next DFH in the DFL from the DFH start,
and the start of a DFH must be aligned to an 8 byte boundary.
If EOL is set, Next is the size of MMIO of the last feature in the list.”…””}”(hjË  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KbhjÇ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjh  ubhá)”}”(hŒ>REV - The revision of the feature associated with this header.”h]”hÌ)”}”(hjá  h]”hŒ>REV - The revision of the feature associated with this header.”…””}”(hjã  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kehjß  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjh  ubhá)”}”(hŒ0ID - The feature ID if Type is private feature.
”h]”hÌ)”}”(hŒ/ID - The feature ID if Type is private feature.”h]”hŒ/ID - The feature ID if Type is private feature.”…””}”(hjú  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kfhjö  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjh  ubeh}”(h]”h ]”h"]”h$]”h&]”j—  Œ*”uh1hÛh³hÊh´K^hjV  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hàhjS  h²hh³Nh´Nubhá)”}”(hŒ‚Offset 0x08

* GUID_L - Least significant 64 bits of a 128-bit Globally Unique Identifier
  (present only if Type is FME or AFU).
”h]”(hÌ)”}”(hŒOffset 0x08”h]”hŒOffset 0x08”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khhj  ubhÜ)”}”(hhh]”há)”}”(hŒqGUID_L - Least significant 64 bits of a 128-bit Globally Unique Identifier
(present only if Type is FME or AFU).
”h]”hÌ)”}”(hŒpGUID_L - Least significant 64 bits of a 128-bit Globally Unique Identifier
(present only if Type is FME or AFU).”h]”hŒpGUID_L - Least significant 64 bits of a 128-bit Globally Unique Identifier
(present only if Type is FME or AFU).”…””}”(hj4  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kjhj0  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj-  ubah}”(h]”h ]”h"]”h$]”h&]”j—  j  uh1hÛh³hÊh´Kjhj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hàhjS  h²hh³Nh´Nubhá)”}”(hŒ‚Offset 0x10

* GUID_H - Most significant 64 bits of a 128-bit Globally Unique Identifier
  (present only if Type is FME or AFU).

”h]”(hÌ)”}”(hŒOffset 0x10”h]”hŒOffset 0x10”…””}”(hjX  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KmhjT  ubhÜ)”}”(hhh]”há)”}”(hŒqGUID_H - Most significant 64 bits of a 128-bit Globally Unique Identifier
(present only if Type is FME or AFU).

”h]”hÌ)”}”(hŒoGUID_H - Most significant 64 bits of a 128-bit Globally Unique Identifier
(present only if Type is FME or AFU).”h]”hŒoGUID_H - Most significant 64 bits of a 128-bit Globally Unique Identifier
(present only if Type is FME or AFU).”…””}”(hjm  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kohji  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjf  ubah}”(h]”h ]”h"]”h$]”h&]”j—  j  uh1hÛh³hÊh´KohjT  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hàhjS  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j—  j˜  uh1hÛh³hÊh´K\hj&  h²hubeh}”(h]”Œdevice-feature-header-version-0”ah ]”h"]”Œ!device feature header - version 0”ah$]”h&]”uh1hµhh·h²hh³hÊh´KOubh¶)”}”(hhh]”(h»)”}”(hŒ!Device Feature Header - Version 1”h]”hŒ!Device Feature Header - Version 1”…””}”(hjž  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj›  h²hh³hÊh´KtubhÌ)”}”(hŒPVersion 1 (DFHv1) of the Device Feature Header adds the following functionality:”h]”hŒPVersion 1 (DFHv1) of the Device Feature Header adds the following functionality:”…””}”(hj¬  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kuhj›  h²hubhÜ)”}”(hhh]”(há)”}”(hŒ_Provides a standardized mechanism for features to describe
parameters/capabilities to software.”h]”hÌ)”}”(hŒ_Provides a standardized mechanism for features to describe
parameters/capabilities to software.”h]”hŒ_Provides a standardized mechanism for features to describe
parameters/capabilities to software.”…””}”(hjÁ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kwhj½  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjº  h²hh³hÊh´Nubhá)”}”(hŒ2Standardize the use of a GUID for all DFHv1 types.”h]”hÌ)”}”(hj×  h]”hŒ2Standardize the use of a GUID for all DFHv1 types.”…””}”(hjÙ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KyhjÕ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjº  h²hh³hÊh´Nubhá)”}”(hŒJDecouples the DFH location from the register space of the feature itself.
”h]”hÌ)”}”(hŒIDecouples the DFH location from the register space of the feature itself.”h]”hŒIDecouples the DFH location from the register space of the feature itself.”…””}”(hjð  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kzhjì  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjº  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j—  j  uh1hÛh³hÊh´Kwhj›  h²hubhÌ)”}”(hŒAll multi-byte quantities in DFHv1 are little-endian.
The format of Version 1 of the Device Feature Header (DFH) is shown below::”h]”hŒ€All multi-byte quantities in DFHv1 are little-endian.
The format of Version 1 of the Device Feature Header (DFH) is shown below:”…””}”(hj
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K|hj›  h²hubjÇ  )”}”(hX  +-----------------------------------------------------------------------+
|63 Type 60|59 DFH VER 52|51 Rsvd 41|40 EOL|39 Next 16|15 REV 12|11 ID 0| 0x00
+-----------------------------------------------------------------------+
|63                                 GUID_L                             0| 0x08
+-----------------------------------------------------------------------+
|63                                 GUID_H                             0| 0x10
+-----------------------------------------------------------------------+
|63                   Reg Address/Offset                      1|  Rel  0| 0x18
+-----------------------------------------------------------------------+
|63        Reg Size       32|Params 31|30 Group    16|15 Instance      0| 0x20
+-----------------------------------------------------------------------+
|63 Next    35|34RSV33|EOP32|31 Param Version 16|15 Param ID           0| 0x28
+-----------------------------------------------------------------------+
|63                 Parameter Data                                     0| 0x30
+-----------------------------------------------------------------------+

                              ...

+-----------------------------------------------------------------------+
|63 Next    35|34RSV33|EOP32|31 Param Version 16|15 Param ID           0|
+-----------------------------------------------------------------------+
|63                 Parameter Data                                     0|
+-----------------------------------------------------------------------+”h]”hX  +-----------------------------------------------------------------------+
|63 Type 60|59 DFH VER 52|51 Rsvd 41|40 EOL|39 Next 16|15 REV 12|11 ID 0| 0x00
+-----------------------------------------------------------------------+
|63                                 GUID_L                             0| 0x08
+-----------------------------------------------------------------------+
|63                                 GUID_H                             0| 0x10
+-----------------------------------------------------------------------+
|63                   Reg Address/Offset                      1|  Rel  0| 0x18
+-----------------------------------------------------------------------+
|63        Reg Size       32|Params 31|30 Group    16|15 Instance      0| 0x20
+-----------------------------------------------------------------------+
|63 Next    35|34RSV33|EOP32|31 Param Version 16|15 Param ID           0| 0x28
+-----------------------------------------------------------------------+
|63                 Parameter Data                                     0| 0x30
+-----------------------------------------------------------------------+

                              ...

+-----------------------------------------------------------------------+
|63 Next    35|34RSV33|EOP32|31 Param Version 16|15 Param ID           0|
+-----------------------------------------------------------------------+
|63                 Parameter Data                                     0|
+-----------------------------------------------------------------------+”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´Khj›  h²hubhÜ)”}”(hhh]”(há)”}”(hX  Offset 0x00

* Type - The type of DFH (e.g. FME, AFU, or private feature).
* DFH VER - The version of the DFH.
* Rsvd - Currently unused.
* EOL - Set if the DFH is the end of the Device Feature List (DFL).
* Next - The offset in bytes of the next DFH in the DFL from the DFH start,
  and the start of a DFH must be aligned to an 8 byte boundary.
  If EOL is set, Next is the size of MMIO of the last feature in the list.
* REV - The revision of the feature associated with this header.
* ID - The feature ID if Type is private feature.
”h]”(hÌ)”}”(hŒOffset 0x00”h]”hŒOffset 0x00”…””}”(hj-  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K—hj)  ubhÜ)”}”(hhh]”(há)”}”(hŒ;Type - The type of DFH (e.g. FME, AFU, or private feature).”h]”hÌ)”}”(hj@  h]”hŒ;Type - The type of DFH (e.g. FME, AFU, or private feature).”…””}”(hjB  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K™hj>  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj;  ubhá)”}”(hŒ!DFH VER - The version of the DFH.”h]”hÌ)”}”(hjW  h]”hŒ!DFH VER - The version of the DFH.”…””}”(hjY  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KšhjU  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj;  ubhá)”}”(hŒRsvd - Currently unused.”h]”hÌ)”}”(hjn  h]”hŒRsvd - Currently unused.”…””}”(hjp  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K›hjl  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj;  ubhá)”}”(hŒAEOL - Set if the DFH is the end of the Device Feature List (DFL).”h]”hÌ)”}”(hj…  h]”hŒAEOL - Set if the DFH is the end of the Device Feature List (DFL).”…””}”(hj‡  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kœhjƒ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj;  ubhá)”}”(hŒÐNext - The offset in bytes of the next DFH in the DFL from the DFH start,
and the start of a DFH must be aligned to an 8 byte boundary.
If EOL is set, Next is the size of MMIO of the last feature in the list.”h]”hÌ)”}”(hŒÐNext - The offset in bytes of the next DFH in the DFL from the DFH start,
and the start of a DFH must be aligned to an 8 byte boundary.
If EOL is set, Next is the size of MMIO of the last feature in the list.”h]”hŒÐNext - The offset in bytes of the next DFH in the DFL from the DFH start,
and the start of a DFH must be aligned to an 8 byte boundary.
If EOL is set, Next is the size of MMIO of the last feature in the list.”…””}”(hjž  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Khjš  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj;  ubhá)”}”(hŒ>REV - The revision of the feature associated with this header.”h]”hÌ)”}”(hj´  h]”hŒ>REV - The revision of the feature associated with this header.”…””}”(hj¶  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K hj²  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj;  ubhá)”}”(hŒ0ID - The feature ID if Type is private feature.
”h]”hÌ)”}”(hŒ/ID - The feature ID if Type is private feature.”h]”hŒ/ID - The feature ID if Type is private feature.”…””}”(hjÍ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¡hjÉ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj;  ubeh}”(h]”h ]”h"]”h$]”h&]”j—  j  uh1hÛh³hÊh´K™hj)  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hàhj&  h²hh³Nh´Nubhá)”}”(hŒ[Offset 0x08

* GUID_L - Least significant 64 bits of a 128-bit Globally Unique Identifier.
”h]”(hÌ)”}”(hŒOffset 0x08”h]”hŒOffset 0x08”…””}”(hjñ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K£hjí  ubhÜ)”}”(hhh]”há)”}”(hŒLGUID_L - Least significant 64 bits of a 128-bit Globally Unique Identifier.
”h]”hÌ)”}”(hŒKGUID_L - Least significant 64 bits of a 128-bit Globally Unique Identifier.”h]”hŒKGUID_L - Least significant 64 bits of a 128-bit Globally Unique Identifier.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¥hj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjÿ  ubah}”(h]”h ]”h"]”h$]”h&]”j—  j  uh1hÛh³hÊh´K¥hjí  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hàhj&  h²hh³Nh´Nubhá)”}”(hŒZOffset 0x10

* GUID_H - Most significant 64 bits of a 128-bit Globally Unique Identifier.
”h]”(hÌ)”}”(hŒOffset 0x10”h]”hŒOffset 0x10”…””}”(hj*  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K§hj&  ubhÜ)”}”(hhh]”há)”}”(hŒKGUID_H - Most significant 64 bits of a 128-bit Globally Unique Identifier.
”h]”hÌ)”}”(hŒJGUID_H - Most significant 64 bits of a 128-bit Globally Unique Identifier.”h]”hŒJGUID_H - Most significant 64 bits of a 128-bit Globally Unique Identifier.”…””}”(hj?  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K©hj;  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj8  ubah}”(h]”h ]”h"]”h$]”h&]”j—  j  uh1hÛh³hÊh´K©hj&  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hàhj&  h²hh³Nh´Nubhá)”}”(hŒ÷Offset 0x18

* Reg Address/Offset - If Rel bit is set, then the value is the high 63 bits
  of a 16-bit aligned absolute address of the feature's registers. Otherwise
  the value is the offset from the start of the DFH of the feature's registers.
”h]”(hÌ)”}”(hŒOffset 0x18”h]”hŒOffset 0x18”…””}”(hjc  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K«hj_  ubhÜ)”}”(hhh]”há)”}”(hŒäReg Address/Offset - If Rel bit is set, then the value is the high 63 bits
of a 16-bit aligned absolute address of the feature's registers. Otherwise
the value is the offset from the start of the DFH of the feature's registers.
”h]”hÌ)”}”(hŒãReg Address/Offset - If Rel bit is set, then the value is the high 63 bits
of a 16-bit aligned absolute address of the feature's registers. Otherwise
the value is the offset from the start of the DFH of the feature's registers.”h]”hŒçReg Address/Offset - If Rel bit is set, then the value is the high 63 bits
of a 16-bit aligned absolute address of the featureâ€™s registers. Otherwise
the value is the offset from the start of the DFH of the featureâ€™s registers.”…””}”(hjx  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K­hjt  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjq  ubah}”(h]”h ]”h"]”h$]”h&]”j—  j  uh1hÛh³hÊh´K­hj_  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hàhj&  h²hh³Nh´Nubhá)”}”(hŒâOffset 0x20

* Reg Size - Size of feature's register set in bytes.
* Params - Set if DFH has a list of parameter blocks.
* Group - Id of group if feature is part of a group.
* Instance - Id of feature instance within a group.
”h]”(hÌ)”}”(hŒOffset 0x20”h]”hŒOffset 0x20”…””}”(hjœ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K±hj˜  ubhÜ)”}”(hhh]”(há)”}”(hŒ3Reg Size - Size of feature's register set in bytes.”h]”hÌ)”}”(hj¯  h]”hŒ5Reg Size - Size of featureâ€™s register set in bytes.”…””}”(hj±  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K³hj­  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjª  ubhá)”}”(hŒ3Params - Set if DFH has a list of parameter blocks.”h]”hÌ)”}”(hjÆ  h]”hŒ3Params - Set if DFH has a list of parameter blocks.”…””}”(hjÈ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K´hjÄ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjª  ubhá)”}”(hŒ2Group - Id of group if feature is part of a group.”h]”hÌ)”}”(hjÝ  h]”hŒ2Group - Id of group if feature is part of a group.”…””}”(hjß  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KµhjÛ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjª  ubhá)”}”(hŒ2Instance - Id of feature instance within a group.
”h]”hÌ)”}”(hŒ1Instance - Id of feature instance within a group.”h]”hŒ1Instance - Id of feature instance within a group.”…””}”(hjö  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¶hjò  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhjª  ubeh}”(h]”h ]”h"]”h$]”h&]”j—  j  uh1hÛh³hÊh´K³hj˜  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hàhj&  h²hh³Nh´Nubhá)”}”(hŒßOffset 0x28 if feature has parameters

* Next - Offset to the next parameter block in 8 byte words. If EOP set,
  size in 8 byte words of last parameter.
* Param Version - Version of Param ID.
* Param ID - ID of parameter.
”h]”(hÌ)”}”(hŒ%Offset 0x28 if feature has parameters”h]”hŒ%Offset 0x28 if feature has parameters”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¸hj  ubhÜ)”}”(hhh]”(há)”}”(hŒnNext - Offset to the next parameter block in 8 byte words. If EOP set,
size in 8 byte words of last parameter.”h]”hÌ)”}”(hŒnNext - Offset to the next parameter block in 8 byte words. If EOP set,
size in 8 byte words of last parameter.”h]”hŒnNext - Offset to the next parameter block in 8 byte words. If EOP set,
size in 8 byte words of last parameter.”…””}”(hj/  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kºhj+  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj(  ubhá)”}”(hŒ$Param Version - Version of Param ID.”h]”hÌ)”}”(hjE  h]”hŒ$Param Version - Version of Param ID.”…””}”(hjG  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¼hjC  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj(  ubhá)”}”(hŒParam ID - ID of parameter.
”h]”hÌ)”}”(hŒParam ID - ID of parameter.”h]”hŒParam ID - ID of parameter.”…””}”(hj^  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K½hjZ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj(  ubeh}”(h]”h ]”h"]”h$]”h&]”j—  j  uh1hÛh³hÊh´Kºhj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hàhj&  h²hh³Nh´Nubhá)”}”(hŒwOffset 0x30

* Parameter Data - Parameter data whose size and format is defined by
  version and ID of the parameter.

”h]”(hÌ)”}”(hŒOffset 0x30”h]”hŒOffset 0x30”…””}”(hj‚  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K¿hj~  ubhÜ)”}”(hhh]”há)”}”(hŒfParameter Data - Parameter data whose size and format is defined by
version and ID of the parameter.

”h]”hÌ)”}”(hŒdParameter Data - Parameter data whose size and format is defined by
version and ID of the parameter.”h]”hŒdParameter Data - Parameter data whose size and format is defined by
version and ID of the parameter.”…””}”(hj—  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÁhj“  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj  ubah}”(h]”h ]”h"]”h$]”h&]”j—  j  uh1hÛh³hÊh´KÁhj~  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hàhj&  h²hh³Nh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j—  j˜  uh1hÛh³hÊh´K—hj›  h²hubeh}”(h]”Œdevice-feature-header-version-1”ah ]”h"]”Œ!device feature header - version 1”ah$]”h&]”uh1hµhh·h²hh³hÊh´Ktubh¶)”}”(hhh]”(h»)”}”(hŒ"FIU - FME (FPGA Management Engine)”h]”hŒ"FIU - FME (FPGA Management Engine)”…””}”(hjÈ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjÅ  h²hh³hÊh´KÆubhÌ)”}”(hŒzThe FPGA Management Engine performs reconfiguration and other infrastructure
functions. Each FPGA device only has one FME.”h]”hŒzThe FPGA Management Engine performs reconfiguration and other infrastructure
functions. Each FPGA device only has one FME.”…””}”(hjÖ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÇhjÅ  h²hubhÌ)”}”(hŒkUser-space applications can acquire exclusive access to the FME using open(),
and release it using close().”h]”hŒkUser-space applications can acquire exclusive access to the FME using open(),
and release it using close().”…””}”(hjä  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÊhjÅ  h²hubhÌ)”}”(hŒ3The following functions are exposed through ioctls:”h]”hŒ3The following functions are exposed through ioctls:”…””}”(hjò  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÍhjÅ  h²hubhÜ)”}”(hhh]”(há)”}”(hŒ1Get driver API version (DFL_FPGA_GET_API_VERSION)”h]”hÌ)”}”(hj  h]”hŒ1Get driver API version (DFL_FPGA_GET_API_VERSION)”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÏhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj   h²hh³hÊh´Nubhá)”}”(hŒ/Check for extensions (DFL_FPGA_CHECK_EXTENSION)”h]”hÌ)”}”(hj  h]”hŒ/Check for extensions (DFL_FPGA_CHECK_EXTENSION)”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÐhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj   h²hh³hÊh´Nubhá)”}”(hŒ(Program bitstream (DFL_FPGA_FME_PORT_PR)”h]”hÌ)”}”(hj3  h]”hŒ(Program bitstream (DFL_FPGA_FME_PORT_PR)”…””}”(hj5  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÑhj1  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj   h²hh³hÊh´Nubhá)”}”(hŒ,Assign port to PF (DFL_FPGA_FME_PORT_ASSIGN)”h]”hÌ)”}”(hjJ  h]”hŒ,Assign port to PF (DFL_FPGA_FME_PORT_ASSIGN)”…””}”(hjL  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÒhjH  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj   h²hh³hÊh´Nubhá)”}”(hŒ0Release port from PF (DFL_FPGA_FME_PORT_RELEASE)”h]”hÌ)”}”(hja  h]”hŒ0Release port from PF (DFL_FPGA_FME_PORT_RELEASE)”…””}”(hjc  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÓhj_  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj   h²hh³hÊh´Nubhá)”}”(hŒEGet number of irqs of FME global error (DFL_FPGA_FME_ERR_GET_IRQ_NUM)”h]”hÌ)”}”(hjx  h]”hŒEGet number of irqs of FME global error (DFL_FPGA_FME_ERR_GET_IRQ_NUM)”…””}”(hjz  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÔhjv  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj   h²hh³hÊh´Nubhá)”}”(hŒ?Set interrupt trigger for FME error (DFL_FPGA_FME_ERR_SET_IRQ)
”h]”hÌ)”}”(hŒ>Set interrupt trigger for FME error (DFL_FPGA_FME_ERR_SET_IRQ)”h]”hŒ>Set interrupt trigger for FME error (DFL_FPGA_FME_ERR_SET_IRQ)”…””}”(hj‘  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÕhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj   h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j—  j˜  uh1hÛh³hÊh´KÏhjÅ  h²hubhÌ)”}”(hŒUMore functions are exposed through sysfs
(/sys/class/fpga_region/regionX/dfl-fme.n/):”h]”hŒUMore functions are exposed through sysfs
(/sys/class/fpga_region/regionX/dfl-fme.n/):”…””}”(hj«  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´K×hjÅ  h²hubhŒblock_quote”“”)”}”(hX  Read bitstream ID (bitstream_id)
    bitstream_id indicates version of the static FPGA region.

Read bitstream metadata (bitstream_metadata)
    bitstream_metadata includes detailed information of static FPGA region,
    e.g. synthesis date and seed.

Read number of ports (ports_num)
    one FPGA device may have more than one port, this sysfs interface indicates
    how many ports the FPGA device has.

Global error reporting management (errors/)
    error reporting sysfs interfaces allow user to read errors detected by the
    hardware, and clear the logged errors.

Power management (dfl_fme_power hwmon)
    power management hwmon sysfs interfaces allow user to read power management
    information (power consumption, thresholds, threshold status, limits, etc.)
    and configure power thresholds for different throttling levels.

Thermal management (dfl_fme_thermal hwmon)
    thermal management hwmon sysfs interfaces allow user to read thermal
    management information (current temperature, thresholds, threshold status,
    etc.).

Performance reporting
    performance counters are exposed through perf PMU APIs. Standard perf tool
    can be used to monitor all available perf events. Please see performance
    counter section below for more detailed information.

”h]”hŒdefinition_list”“”)”}”(hhh]”(hŒdefinition_list_item”“”)”}”(hŒ[Read bitstream ID (bitstream_id)
bitstream_id indicates version of the static FPGA region.
”h]”(hŒterm”“”)”}”(hŒ Read bitstream ID (bitstream_id)”h]”hŒ Read bitstream ID (bitstream_id)”…””}”(hjÌ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  h³hÊh´KÛhjÆ  ubhŒ
definition”“”)”}”(hhh]”hÌ)”}”(hŒ9bitstream_id indicates version of the static FPGA region.”h]”hŒ9bitstream_id indicates version of the static FPGA region.”…””}”(hjß  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÛhjÜ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÚ  hjÆ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÄ  h³hÊh´KÛhjÁ  ubjÅ  )”}”(hŒ“Read bitstream metadata (bitstream_metadata)
bitstream_metadata includes detailed information of static FPGA region,
e.g. synthesis date and seed.
”h]”(jË  )”}”(hŒ,Read bitstream metadata (bitstream_metadata)”h]”hŒ,Read bitstream metadata (bitstream_metadata)”…””}”(hjý  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  h³hÊh´Kßhjù  ubjÛ  )”}”(hhh]”hÌ)”}”(hŒebitstream_metadata includes detailed information of static FPGA region,
e.g. synthesis date and seed.”h]”hŒebitstream_metadata includes detailed information of static FPGA region,
e.g. synthesis date and seed.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KÞhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÚ  hjù  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÄ  h³hÊh´KßhjÁ  ubjÅ  )”}”(hŒ‘Read number of ports (ports_num)
one FPGA device may have more than one port, this sysfs interface indicates
how many ports the FPGA device has.
”h]”(jË  )”}”(hŒ Read number of ports (ports_num)”h]”hŒ Read number of ports (ports_num)”…””}”(hj,  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  h³hÊh´Kãhj(  ubjÛ  )”}”(hhh]”hÌ)”}”(hŒoone FPGA device may have more than one port, this sysfs interface indicates
how many ports the FPGA device has.”h]”hŒoone FPGA device may have more than one port, this sysfs interface indicates
how many ports the FPGA device has.”…””}”(hj=  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kâhj:  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÚ  hj(  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÄ  h³hÊh´KãhjÁ  ubjÅ  )”}”(hŒžGlobal error reporting management (errors/)
error reporting sysfs interfaces allow user to read errors detected by the
hardware, and clear the logged errors.
”h]”(jË  )”}”(hŒ+Global error reporting management (errors/)”h]”hŒ+Global error reporting management (errors/)”…””}”(hj[  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  h³hÊh´KçhjW  ubjÛ  )”}”(hhh]”hÌ)”}”(hŒqerror reporting sysfs interfaces allow user to read errors detected by the
hardware, and clear the logged errors.”h]”hŒqerror reporting sysfs interfaces allow user to read errors detected by the
hardware, and clear the logged errors.”…””}”(hjl  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kæhji  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÚ  hjW  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÄ  h³hÊh´KçhjÁ  ubjÅ  )”}”(hŒÿPower management (dfl_fme_power hwmon)
power management hwmon sysfs interfaces allow user to read power management
information (power consumption, thresholds, threshold status, limits, etc.)
and configure power thresholds for different throttling levels.
”h]”(jË  )”}”(hŒ&Power management (dfl_fme_power hwmon)”h]”hŒ&Power management (dfl_fme_power hwmon)”…””}”(hjŠ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  h³hÊh´Kìhj†  ubjÛ  )”}”(hhh]”hÌ)”}”(hŒ×power management hwmon sysfs interfaces allow user to read power management
information (power consumption, thresholds, threshold status, limits, etc.)
and configure power thresholds for different throttling levels.”h]”hŒ×power management hwmon sysfs interfaces allow user to read power management
information (power consumption, thresholds, threshold status, limits, etc.)
and configure power thresholds for different throttling levels.”…””}”(hj›  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kêhj˜  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÚ  hj†  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÄ  h³hÊh´KìhjÁ  ubjÅ  )”}”(hŒÂThermal management (dfl_fme_thermal hwmon)
thermal management hwmon sysfs interfaces allow user to read thermal
management information (current temperature, thresholds, threshold status,
etc.).
”h]”(jË  )”}”(hŒ*Thermal management (dfl_fme_thermal hwmon)”h]”hŒ*Thermal management (dfl_fme_thermal hwmon)”…””}”(hj¹  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  h³hÊh´Kñhjµ  ubjÛ  )”}”(hhh]”hÌ)”}”(hŒ–thermal management hwmon sysfs interfaces allow user to read thermal
management information (current temperature, thresholds, threshold status,
etc.).”h]”hŒ–thermal management hwmon sysfs interfaces allow user to read thermal
management information (current temperature, thresholds, threshold status,
etc.).”…””}”(hjÊ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´KïhjÇ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÚ  hjµ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÄ  h³hÊh´KñhjÁ  ubjÅ  )”}”(hŒàPerformance reporting
performance counters are exposed through perf PMU APIs. Standard perf tool
can be used to monitor all available perf events. Please see performance
counter section below for more detailed information.

”h]”(jË  )”}”(hŒPerformance reporting”h]”hŒPerformance reporting”…””}”(hjè  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  h³hÊh´K÷hjä  ubjÛ  )”}”(hhh]”hÌ)”}”(hŒÈperformance counters are exposed through perf PMU APIs. Standard perf tool
can be used to monitor all available perf events. Please see performance
counter section below for more detailed information.”h]”hŒÈperformance counters are exposed through perf PMU APIs. Standard perf tool
can be used to monitor all available perf events. Please see performance
counter section below for more detailed information.”…””}”(hjù  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kôhjö  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÚ  hjä  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÄ  h³hÊh´K÷hjÁ  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j¿  hj»  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¹  h³hÊh´KÚhjÅ  h²hubeh}”(h]”Œfiu-fme-fpga-management-engine”ah ]”h"]”Œ"fiu - fme (fpga management engine)”ah$]”h&]”uh1hµhh·h²hh³hÊh´KÆubh¶)”}”(hhh]”(h»)”}”(hŒ
FIU - PORT”h]”hŒ
FIU - PORT”…””}”(hj*	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj'	  h²hh³hÊh´KúubhÌ)”}”(hX)  A port represents the interface between the static FPGA fabric and a partially
reconfigurable region containing an AFU. It controls the communication from SW
to the accelerator and exposes features such as reset and debug. Each FPGA
device may have more than one port, but always one AFU per port.”h]”hX)  A port represents the interface between the static FPGA fabric and a partially
reconfigurable region containing an AFU. It controls the communication from SW
to the accelerator and exposes features such as reset and debug. Each FPGA
device may have more than one port, but always one AFU per port.”…””}”(hj8	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Kûhj'	  h²hubeh}”(h]”Œfiu-port”ah ]”h"]”Œ
fiu - port”ah$]”h&]”uh1hµhh·h²hh³hÊh´Kúubh¶)”}”(hhh]”(h»)”}”(hŒAFU”h]”hŒAFU”…””}”(hjQ	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjN	  h²hh³hÊh´MubhÌ)”}”(hŒ~An AFU is attached to a port FIU and exposes a fixed length MMIO region to be
used for accelerator-specific control registers.”h]”hŒ~An AFU is attached to a port FIU and exposes a fixed length MMIO region to be
used for accelerator-specific control registers.”…””}”(hj_	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhjN	  h²hubhÌ)”}”(hŒ—User-space applications can acquire exclusive access to an AFU attached to a
port by using open() on the port device node and release it using close().”h]”hŒ—User-space applications can acquire exclusive access to an AFU attached to a
port by using open() on the port device node and release it using close().”…””}”(hjm	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhjN	  h²hubhÌ)”}”(hŒ3The following functions are exposed through ioctls:”h]”hŒ3The following functions are exposed through ioctls:”…””}”(hj{	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M	hjN	  h²hubhÜ)”}”(hhh]”(há)”}”(hŒ1Get driver API version (DFL_FPGA_GET_API_VERSION)”h]”hÌ)”}”(hjŽ	  h]”hŒ1Get driver API version (DFL_FPGA_GET_API_VERSION)”…””}”(hj	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhjŒ	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj‰	  h²hh³hÊh´Nubhá)”}”(hŒ/Check for extensions (DFL_FPGA_CHECK_EXTENSION)”h]”hÌ)”}”(hj¥	  h]”hŒ/Check for extensions (DFL_FPGA_CHECK_EXTENSION)”…””}”(hj§	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj£	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj‰	  h²hh³hÊh´Nubhá)”}”(hŒ&Get port info (DFL_FPGA_PORT_GET_INFO)”h]”hÌ)”}”(hj¼	  h]”hŒ&Get port info (DFL_FPGA_PORT_GET_INFO)”…””}”(hj¾	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjº	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj‰	  h²hh³hÊh´Nubhá)”}”(hŒ4Get MMIO region info (DFL_FPGA_PORT_GET_REGION_INFO)”h]”hÌ)”}”(hjÓ	  h]”hŒ4Get MMIO region info (DFL_FPGA_PORT_GET_REGION_INFO)”…””}”(hjÕ	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhjÑ	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj‰	  h²hh³hÊh´Nubhá)”}”(hŒ&Map DMA buffer (DFL_FPGA_PORT_DMA_MAP)”h]”hÌ)”}”(hjê	  h]”hŒ&Map DMA buffer (DFL_FPGA_PORT_DMA_MAP)”…””}”(hjì	  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjè	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj‰	  h²hh³hÊh´Nubhá)”}”(hŒ*Unmap DMA buffer (DFL_FPGA_PORT_DMA_UNMAP)”h]”hÌ)”}”(hj
  h]”hŒ*Unmap DMA buffer (DFL_FPGA_PORT_DMA_UNMAP)”…””}”(hj
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjÿ	  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj‰	  h²hh³hÊh´Nubhá)”}”(hŒReset AFU (DFL_FPGA_PORT_RESET)”h]”hÌ)”}”(hj
  h]”hŒReset AFU (DFL_FPGA_PORT_RESET)”…””}”(hj
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj‰	  h²hh³hÊh´Nubhá)”}”(hŒ@Get number of irqs of port error (DFL_FPGA_PORT_ERR_GET_IRQ_NUM)”h]”hÌ)”}”(hj/
  h]”hŒ@Get number of irqs of port error (DFL_FPGA_PORT_ERR_GET_IRQ_NUM)”…””}”(hj1
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj-
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj‰	  h²hh³hÊh´Nubhá)”}”(hŒ@Set interrupt trigger for port error (DFL_FPGA_PORT_ERR_SET_IRQ)”h]”hÌ)”}”(hjF
  h]”hŒ@Set interrupt trigger for port error (DFL_FPGA_PORT_ERR_SET_IRQ)”…””}”(hjH
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhjD
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj‰	  h²hh³hÊh´Nubhá)”}”(hŒ;Get number of irqs of UINT (DFL_FPGA_PORT_UINT_GET_IRQ_NUM)”h]”hÌ)”}”(hj]
  h]”hŒ;Get number of irqs of UINT (DFL_FPGA_PORT_UINT_GET_IRQ_NUM)”…””}”(hj_
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj[
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj‰	  h²hh³hÊh´Nubhá)”}”(hŒ<Set interrupt trigger for UINT (DFL_FPGA_PORT_UINT_SET_IRQ)
”h]”hÌ)”}”(hŒ;Set interrupt trigger for UINT (DFL_FPGA_PORT_UINT_SET_IRQ)”h]”hŒ;Set interrupt trigger for UINT (DFL_FPGA_PORT_UINT_SET_IRQ)”…””}”(hjv
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhjr
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj‰	  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j—  j˜  uh1hÛh³hÊh´MhjN	  h²hubjÀ  )”}”(hhh]”jÅ  )”}”(hX  DFL_FPGA_PORT_RESET:
reset the FPGA Port and its AFU. Userspace can do Port
reset at any time, e.g. during DMA or Partial Reconfiguration. But it should
never cause any system level issue, only functional failure (e.g. DMA or PR
operation failure) and be recoverable from the failure.
”h]”(jË  )”}”(hŒDFL_FPGA_PORT_RESET:”h]”hŒDFL_FPGA_PORT_RESET:”…””}”(hj—
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  h³hÊh´Mhj“
  ubjÛ  )”}”(hhh]”hÌ)”}”(hX  reset the FPGA Port and its AFU. Userspace can do Port
reset at any time, e.g. during DMA or Partial Reconfiguration. But it should
never cause any system level issue, only functional failure (e.g. DMA or PR
operation failure) and be recoverable from the failure.”h]”hX  reset the FPGA Port and its AFU. Userspace can do Port
reset at any time, e.g. during DMA or Partial Reconfiguration. But it should
never cause any system level issue, only functional failure (e.g. DMA or PR
operation failure) and be recoverable from the failure.”…””}”(hj¨
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhj¥
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÚ  hj“
  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÄ  h³hÊh´Mhj
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¿  hjN	  h²hh³hÊh´NubhÌ)”}”(hŒAUser-space applications can also mmap() accelerator MMIO regions.”h]”hŒAUser-space applications can also mmap() accelerator MMIO regions.”…””}”(hjÈ
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhjN	  h²hubhÌ)”}”(hŒ[More functions are exposed through sysfs:
(/sys/class/fpga_region/<regionX>/<dfl-port.m>/):”h]”hŒ[More functions are exposed through sysfs:
(/sys/class/fpga_region/<regionX>/<dfl-port.m>/):”…””}”(hjÖ
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhjN	  h²hubjº  )”}”(hX  Read Accelerator GUID (afu_id)
    afu_id indicates which PR bitstream is programmed to this AFU.

Error reporting (errors/)
    error reporting sysfs interfaces allow user to read port/afu errors
    detected by the hardware, and clear the logged errors.

”h]”jÀ  )”}”(hhh]”(jÅ  )”}”(hŒ^Read Accelerator GUID (afu_id)
afu_id indicates which PR bitstream is programmed to this AFU.
”h]”(jË  )”}”(hŒRead Accelerator GUID (afu_id)”h]”hŒRead Accelerator GUID (afu_id)”…””}”(hjï
  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  h³hÊh´M#hjë
  ubjÛ  )”}”(hhh]”hÌ)”}”(hŒ>afu_id indicates which PR bitstream is programmed to this AFU.”h]”hŒ>afu_id indicates which PR bitstream is programmed to this AFU.”…””}”(hj   h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M#hjý
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÚ  hjë
  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÄ  h³hÊh´M#hjè
  ubjÅ  )”}”(hŒ–Error reporting (errors/)
error reporting sysfs interfaces allow user to read port/afu errors
detected by the hardware, and clear the logged errors.

”h]”(jË  )”}”(hŒError reporting (errors/)”h]”hŒError reporting (errors/)”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1jÊ  h³hÊh´M(hj  ubjÛ  )”}”(hhh]”hÌ)”}”(hŒzerror reporting sysfs interfaces allow user to read port/afu errors
detected by the hardware, and clear the logged errors.”h]”hŒzerror reporting sysfs interfaces allow user to read port/afu errors
detected by the hardware, and clear the logged errors.”…””}”(hj/  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M&hj,  ubah}”(h]”h ]”h"]”h$]”h&]”uh1jÚ  hj  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1jÄ  h³hÊh´M(hjè
  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1j¿  hjä
  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¹  h³hÊh´M"hjN	  h²hubeh}”(h]”Œafu”ah ]”h"]”Œafu”ah$]”h&]”uh1hµhh·h²hh³hÊh´Mubh¶)”}”(hhh]”(h»)”}”(hŒDFL Framework Overview”h]”hŒDFL Framework Overview”…””}”(hj`  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj]  h²hh³hÊh´M+ubjÇ  )”}”(hX         +----------+    +--------+ +--------+ +--------+
       |   FME    |    |  AFU   | |  AFU   | |  AFU   |
       |  Module  |    | Module | | Module | | Module |
       +----------+    +--------+ +--------+ +--------+
               +-----------------------+
               | FPGA Container Device |    Device Feature List
               |  (FPGA Base Region)   |         Framework
               +-----------------------+
------------------------------------------------------------------
             +----------------------------+
             |   FPGA DFL Device Module   |
             | (e.g. PCIE/Platform Device)|
             +----------------------------+
               +------------------------+
               |  FPGA Hardware Device  |
               +------------------------+”h]”hX         +----------+    +--------+ +--------+ +--------+
       |   FME    |    |  AFU   | |  AFU   | |  AFU   |
       |  Module  |    | Module | | Module | | Module |
       +----------+    +--------+ +--------+ +--------+
               +-----------------------+
               | FPGA Container Device |    Device Feature List
               |  (FPGA Base Region)   |         Framework
               +-----------------------+
------------------------------------------------------------------
             +----------------------------+
             |   FPGA DFL Device Module   |
             | (e.g. PCIE/Platform Device)|
             +----------------------------+
               +------------------------+
               |  FPGA Hardware Device  |
               +------------------------+”…””}”hjn  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´M/hj]  h²hubhÌ)”}”(hX  DFL framework in kernel provides common interfaces to create container device
(FPGA base region), discover feature devices and their private features from the
given Device Feature Lists and create platform devices for feature devices
(e.g. FME, Port and AFU) with related resources under the container device. It
also abstracts operations for the private features and exposes common ops to
feature device drivers.”h]”hX  DFL framework in kernel provides common interfaces to create container device
(FPGA base region), discover feature devices and their private features from the
given Device Feature Lists and create platform devices for feature devices
(e.g. FME, Port and AFU) with related resources under the container device. It
also abstracts operations for the private features and exposes common ops to
feature device drivers.”…””}”(hj|  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M@hj]  h²hubhÌ)”}”(hX¾  The FPGA DFL Device could be different hardware, e.g. PCIe device, platform
device and etc. Its driver module is always loaded first once the device is
created by the system. This driver plays an infrastructural role in the
driver architecture. It locates the DFLs in the device memory, handles them
and related resources to common interfaces from DFL framework for enumeration.
(Please refer to drivers/fpga/dfl.c for detailed enumeration APIs).”h]”hX¾  The FPGA DFL Device could be different hardware, e.g. PCIe device, platform
device and etc. Its driver module is always loaded first once the device is
created by the system. This driver plays an infrastructural role in the
driver architecture. It locates the DFLs in the device memory, handles them
and related resources to common interfaces from DFL framework for enumeration.
(Please refer to drivers/fpga/dfl.c for detailed enumeration APIs).”…””}”(hjŠ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MGhj]  h²hubhÌ)”}”(hŒÖThe FPGA Management Engine (FME) driver is a platform driver which is loaded
automatically after FME platform device creation from the DFL device module. It
provides the key features for FPGA management, including:”h]”hŒÖThe FPGA Management Engine (FME) driver is a platform driver which is loaded
automatically after FME platform device creation from the DFL device module. It
provides the key features for FPGA management, including:”…””}”(hj˜  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MNhj]  h²hubjº  )”}”(hXî  a) Expose static FPGA region information, e.g. version and metadata.
   Users can read related information via sysfs interfaces exposed
   by FME driver.

b) Partial Reconfiguration. The FME driver creates FPGA manager, FPGA
   bridges and FPGA regions during PR sub feature initialization. Once
   it receives a DFL_FPGA_FME_PORT_PR ioctl from user, it invokes the
   common interface function from FPGA Region to complete the partial
   reconfiguration of the PR bitstream to the given port.
”h]”hŒenumerated_list”“”)”}”(hhh]”(há)”}”(hŒ‘Expose static FPGA region information, e.g. version and metadata.
Users can read related information via sysfs interfaces exposed
by FME driver.
”h]”hÌ)”}”(hŒExpose static FPGA region information, e.g. version and metadata.
Users can read related information via sysfs interfaces exposed
by FME driver.”h]”hŒExpose static FPGA region information, e.g. version and metadata.
Users can read related information via sysfs interfaces exposed
by FME driver.”…””}”(hj³  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MRhj¯  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj¬  ubhá)”}”(hXD  Partial Reconfiguration. The FME driver creates FPGA manager, FPGA
bridges and FPGA regions during PR sub feature initialization. Once
it receives a DFL_FPGA_FME_PORT_PR ioctl from user, it invokes the
common interface function from FPGA Region to complete the partial
reconfiguration of the PR bitstream to the given port.
”h]”hÌ)”}”(hXC  Partial Reconfiguration. The FME driver creates FPGA manager, FPGA
bridges and FPGA regions during PR sub feature initialization. Once
it receives a DFL_FPGA_FME_PORT_PR ioctl from user, it invokes the
common interface function from FPGA Region to complete the partial
reconfiguration of the PR bitstream to the given port.”h]”hXC  Partial Reconfiguration. The FME driver creates FPGA manager, FPGA
bridges and FPGA regions during PR sub feature initialization. Once
it receives a DFL_FPGA_FME_PORT_PR ioctl from user, it invokes the
common interface function from FPGA Region to complete the partial
reconfiguration of the PR bitstream to the given port.”…””}”(hjË  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MVhjÇ  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj¬  ubeh}”(h]”h ]”h"]”h$]”h&]”Œenumtype”Œ
loweralpha”Œprefix”hŒsuffix”Œ)”uh1jª  hj¦  ubah}”(h]”h ]”h"]”h$]”h&]”uh1j¹  h³hÊh´MRhj]  h²hubhÌ)”}”(hX`  Similar to the FME driver, the FPGA Accelerated Function Unit (AFU) driver is
probed once the AFU platform device is created. The main function of this module
is to provide an interface for userspace applications to access the individual
accelerators, including basic reset control on port, AFU MMIO region export, dma
buffer mapping service functions.”h]”hX`  Similar to the FME driver, the FPGA Accelerated Function Unit (AFU) driver is
probed once the AFU platform device is created. The main function of this module
is to provide an interface for userspace applications to access the individual
accelerators, including basic reset control on port, AFU MMIO region export, dma
buffer mapping service functions.”…””}”(hjð  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M\hj]  h²hubhÌ)”}”(hX  After feature platform devices creation, matched platform drivers will be loaded
automatically to handle different functionalities. Please refer to next sections
for detailed information on functional units which have been already implemented
under this DFL framework.”h]”hX  After feature platform devices creation, matched platform drivers will be loaded
automatically to handle different functionalities. Please refer to next sections
for detailed information on functional units which have been already implemented
under this DFL framework.”…””}”(hjþ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mbhj]  h²hubeh}”(h]”Œdfl-framework-overview”ah ]”h"]”Œdfl framework overview”ah$]”h&]”uh1hµhh·h²hh³hÊh´M+ubh¶)”}”(hhh]”(h»)”}”(hŒPartial Reconfiguration”h]”hŒPartial Reconfiguration”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj  h²hh³hÊh´MiubhÌ)”}”(hXE  As mentioned above, accelerators can be reconfigured through partial
reconfiguration of a PR bitstream file. The PR bitstream file must have been
generated for the exact static FPGA region and targeted reconfigurable region
(port) of the FPGA, otherwise, the reconfiguration operation will fail and
possibly cause system instability. This compatibility can be checked by
comparing the compatibility ID noted in the header of PR bitstream file against
the compat_id exposed by the target FPGA region. This check is usually done by
userspace before calling the reconfiguration IOCTL.”h]”hXE  As mentioned above, accelerators can be reconfigured through partial
reconfiguration of a PR bitstream file. The PR bitstream file must have been
generated for the exact static FPGA region and targeted reconfigurable region
(port) of the FPGA, otherwise, the reconfiguration operation will fail and
possibly cause system instability. This compatibility can be checked by
comparing the compatibility ID noted in the header of PR bitstream file against
the compat_id exposed by the target FPGA region. This check is usually done by
userspace before calling the reconfiguration IOCTL.”…””}”(hj%  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mjhj  h²hubeh}”(h]”Œpartial-reconfiguration”ah ]”h"]”Œpartial reconfiguration”ah$]”h&]”uh1hµhh·h²hh³hÊh´Miubh¶)”}”(hhh]”(h»)”}”(hŒ FPGA virtualization - PCIe SRIOV”h]”hŒ FPGA virtualization - PCIe SRIOV”…””}”(hj>  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj;  h²hh³hÊh´MuubhÌ)”}”(hŒíThis section describes the virtualization support on DFL based FPGA device to
enable accessing an accelerator from applications running in a virtual machine
(VM). This section only describes the PCIe based FPGA device with SRIOV support.”h]”hŒíThis section describes the virtualization support on DFL based FPGA device to
enable accessing an accelerator from applications running in a virtual machine
(VM). This section only describes the PCIe based FPGA device with SRIOV support.”…””}”(hjL  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mvhj;  h²hubhÌ)”}”(hŒpFeatures supported by the particular FPGA device are exposed through Device
Feature Lists, as illustrated below:”h]”hŒpFeatures supported by the particular FPGA device are exposed through Device
Feature Lists, as illustrated below:”…””}”(hjZ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mzhj;  h²hubjÇ  )”}”(hX¸    +-------------------------------+  +-------------+
  |              PF               |  |     VF      |
  +-------------------------------+  +-------------+
      ^            ^         ^              ^
      |            |         |              |
+-----|------------|---------|--------------|-------+
|     |            |         |              |       |
|  +-----+     +-------+ +-------+      +-------+   |
|  | FME |     | Port0 | | Port1 |      | Port2 |   |
|  +-----+     +-------+ +-------+      +-------+   |
|                  ^         ^              ^       |
|                  |         |              |       |
|              +-------+ +------+       +-------+   |
|              |  AFU  | |  AFU |       |  AFU  |   |
|              +-------+ +------+       +-------+   |
|                                                   |
|            DFL based FPGA PCIe Device             |
+---------------------------------------------------+”h]”hX¸    +-------------------------------+  +-------------+
  |              PF               |  |     VF      |
  +-------------------------------+  +-------------+
      ^            ^         ^              ^
      |            |         |              |
+-----|------------|---------|--------------|-------+
|     |            |         |              |       |
|  +-----+     +-------+ +-------+      +-------+   |
|  | FME |     | Port0 | | Port1 |      | Port2 |   |
|  +-----+     +-------+ +-------+      +-------+   |
|                  ^         ^              ^       |
|                  |         |              |       |
|              +-------+ +------+       +-------+   |
|              |  AFU  | |  AFU |       |  AFU  |   |
|              +-------+ +------+       +-------+   |
|                                                   |
|            DFL based FPGA PCIe Device             |
+---------------------------------------------------+”…””•WŒ      }”hjh  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´Mhj;  h²hubhÌ)”}”(hŒ:FME is always accessed through the physical function (PF).”h]”hŒ:FME is always accessed through the physical function (PF).”…””}”(hjv  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M’hj;  h²hubhÌ)”}”(hX!  Ports (and related AFUs) are accessed via PF by default, but could be exposed
through virtual function (VF) devices via PCIe SRIOV. Each VF only contains
1 Port and 1 AFU for isolation. Users could assign individual VFs (accelerators)
created via PCIe SRIOV interface, to virtual machines.”h]”hX!  Ports (and related AFUs) are accessed via PF by default, but could be exposed
through virtual function (VF) devices via PCIe SRIOV. Each VF only contains
1 Port and 1 AFU for isolation. Users could assign individual VFs (accelerators)
created via PCIe SRIOV interface, to virtual machines.”…””}”(hj„  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M”hj;  h²hubhÌ)”}”(hŒGThe driver organization in virtualization case is illustrated below:
::”h]”hŒDThe driver organization in virtualization case is illustrated below:”…””}”(hj’  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M™hj;  h²hubjÇ  )”}”(hXÖ   +-------++------++------+             |
 | FME   || FME  || FME  |             |
 | FPGA  || FPGA || FPGA |             |
 |Manager||Bridge||Region|             |
 +-------++------++------+             |
 +-----------------------+  +--------+ |             +--------+
 |          FME          |  |  AFU   | |             |  AFU   |
 |         Module        |  | Module | |             | Module |
 +-----------------------+  +--------+ |             +--------+
       +-----------------------+       |       +-----------------------+
       | FPGA Container Device |       |       | FPGA Container Device |
       |  (FPGA Base Region)   |       |       |  (FPGA Base Region)   |
       +-----------------------+       |       +-----------------------+
         +------------------+          |         +------------------+
         | FPGA PCIE Module |          | Virtual | FPGA PCIE Module |
         +------------------+   Host   | Machine +------------------+
-------------------------------------- | ------------------------------
          +---------------+            |          +---------------+
          | PCI PF Device |            |          | PCI VF Device |
          +---------------+            |          +---------------+”h]”hXÖ   +-------++------++------+             |
 | FME   || FME  || FME  |             |
 | FPGA  || FPGA || FPGA |             |
 |Manager||Bridge||Region|             |
 +-------++------++------+             |
 +-----------------------+  +--------+ |             +--------+
 |          FME          |  |  AFU   | |             |  AFU   |
 |         Module        |  | Module | |             | Module |
 +-----------------------+  +--------+ |             +--------+
       +-----------------------+       |       +-----------------------+
       | FPGA Container Device |       |       | FPGA Container Device |
       |  (FPGA Base Region)   |       |       |  (FPGA Base Region)   |
       +-----------------------+       |       +-----------------------+
         +------------------+          |         +------------------+
         | FPGA PCIE Module |          | Virtual | FPGA PCIE Module |
         +------------------+   Host   | Machine +------------------+
-------------------------------------- | ------------------------------
          +---------------+            |          +---------------+
          | PCI PF Device |            |          | PCI VF Device |
          +---------------+            |          +---------------+”…””}”hj   sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´Mœhj;  h²hubhÌ)”}”(hŒaFPGA PCIe device driver is always loaded first once an FPGA PCIe PF or VF device
is detected. It:”h]”hŒaFPGA PCIe device driver is always loaded first once an FPGA PCIe PF or VF device
is detected. It:”…””}”(hj®  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M±hj;  h²hubhÜ)”}”(hhh]”(há)”}”(hŒcFinishes enumeration on both FPGA PCIe PF and VF device using common
interfaces from DFL framework.”h]”hÌ)”}”(hŒcFinishes enumeration on both FPGA PCIe PF and VF device using common
interfaces from DFL framework.”h]”hŒcFinishes enumeration on both FPGA PCIe PF and VF device using common
interfaces from DFL framework.”…””}”(hjÃ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M´hj¿  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj¼  h²hh³hÊh´Nubhá)”}”(hŒSupports SRIOV.
”h]”hÌ)”}”(hŒSupports SRIOV.”h]”hŒSupports SRIOV.”…””}”(hjÛ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M¶hj×  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj¼  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j—  j  uh1hÛh³hÊh´M´hj;  h²hubhÌ)”}”(hŒúThe FME device driver plays a management role in this driver architecture, it
provides ioctls to release Port from PF and assign Port to PF. After release
a port from PF, then it's safe to expose this port through a VF via PCIe SRIOV
sysfs interface.”h]”hŒüThe FME device driver plays a management role in this driver architecture, it
provides ioctls to release Port from PF and assign Port to PF. After release
a port from PF, then itâ€™s safe to expose this port through a VF via PCIe SRIOV
sysfs interface.”…””}”(hjõ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M¸hj;  h²hubhÌ)”}”(hŒ—To enable accessing an accelerator from applications running in a VM, the
respective AFU's port needs to be assigned to a VF using the following steps:”h]”hŒ™To enable accessing an accelerator from applications running in a VM, the
respective AFUâ€™s port needs to be assigned to a VF using the following steps:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M½hj;  h²hubj«  )”}”(hhh]”(há)”}”(hŒ©The PF owns all AFU ports by default. Any port that needs to be
reassigned to a VF must first be released through the
DFL_FPGA_FME_PORT_RELEASE ioctl on the FME device.
”h]”hÌ)”}”(hŒ¨The PF owns all AFU ports by default. Any port that needs to be
reassigned to a VF must first be released through the
DFL_FPGA_FME_PORT_RELEASE ioctl on the FME device.”h]”hŒ¨The PF owns all AFU ports by default. Any port that needs to be
reassigned to a VF must first be released through the
DFL_FPGA_FME_PORT_RELEASE ioctl on the FME device.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÀhj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj  h²hh³hÊh´Nubhá)”}”(hŒ°Once N ports are released from PF, then user can use command below
to enable SRIOV and VFs. Each VF owns only one Port with AFU.

::

   echo N > $PCI_DEVICE_PATH/sriov_numvfs
”h]”(hÌ)”}”(hŒ€Once N ports are released from PF, then user can use command below
to enable SRIOV and VFs. Each VF owns only one Port with AFU.”h]”hŒ€Once N ports are released from PF, then user can use command below
to enable SRIOV and VFs. Each VF owns only one Port with AFU.”…””}”(hj0  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÄhj,  ubjÇ  )”}”(hŒ&echo N > $PCI_DEVICE_PATH/sriov_numvfs”h]”hŒ&echo N > $PCI_DEVICE_PATH/sriov_numvfs”…””}”hj>  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´MÉhj,  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hàhj  h²hh³hÊh´Nubhá)”}”(hŒPass through the VFs to VMs
”h]”hÌ)”}”(hŒPass through the VFs to VMs”h]”hŒPass through the VFs to VMs”…””}”(hjV  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MËhjR  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj  h²hh³hÊh´Nubhá)”}”(hŒ^The AFU under VF is accessible from applications in VM (using the
same driver inside the VF).
”h]”hÌ)”}”(hŒ]The AFU under VF is accessible from applications in VM (using the
same driver inside the VF).”h]”hŒ]The AFU under VF is accessible from applications in VM (using the
same driver inside the VF).”…””}”(hjn  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÍhjj  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”jå  Œarabic”jç  hjè  Œ.”uh1jª  hj;  h²hh³hÊh´MÀubhÌ)”}”(hŒqNote that an FME can't be assigned to a VF, thus PR and other management
functions are only available via the PF.”h]”hŒsNote that an FME canâ€™t be assigned to a VF, thus PR and other management
functions are only available via the PF.”…””}”(hjŠ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÐhj;  h²hubeh}”(h]”Œfpga-virtualization-pcie-sriov”ah ]”h"]”Œ fpga virtualization - pcie sriov”ah$]”h&]”uh1hµhh·h²hh³hÊh´Muubh¶)”}”(hhh]”(h»)”}”(hŒDevice enumeration”h]”hŒDevice enumeration”…””}”(hj£  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj   h²hh³hÊh´MÔubhÌ)”}”(hŒyThis section introduces how applications enumerate the fpga device from
the sysfs hierarchy under /sys/class/fpga_region.”h]”hŒyThis section introduces how applications enumerate the fpga device from
the sysfs hierarchy under /sys/class/fpga_region.”…””}”(hj±  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÕhj   h²hubhÌ)”}”(hŒ~In the example below, two DFL based FPGA devices are installed in the host. Each
fpga device has one FME and two ports (AFUs).”h]”hŒ~In the example below, two DFL based FPGA devices are installed in the host. Each
fpga device has one FME and two ports (AFUs).”…””}”(hj¿  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MØhj   h²hubhÌ)”}”(hŒ8FPGA regions are created under /sys/class/fpga_region/::”h]”hŒ7FPGA regions are created under /sys/class/fpga_region/:”…””}”(hjÍ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MÛhj   h²hubjÇ  )”}”(hŒ`/sys/class/fpga_region/region0
/sys/class/fpga_region/region1
/sys/class/fpga_region/region2
...”h]”hŒ`/sys/class/fpga_region/region0
/sys/class/fpga_region/region1
/sys/class/fpga_region/region2
...”…””}”hjÛ  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´MÝhj   h²hubhÌ)”}”(hŒºApplication needs to search each regionX folder, if feature device is found,
(e.g. "dfl-port.n" or "dfl-fme.m" is found), then it's the base
fpga region which represents the FPGA device.”h]”hŒÄApplication needs to search each regionX folder, if feature device is found,
(e.g. â€œdfl-port.nâ€ or â€œdfl-fme.mâ€ is found), then itâ€™s the base
fpga region which represents the FPGA device.”…””}”(hjé  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mâhj   h²hubhÌ)”}”(hŒDEach base region has one FME and two ports (AFUs) as child devices::”h]”hŒCEach base region has one FME and two ports (AFUs) as child devices:”…””}”(hj÷  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mæhj   h²hubjÇ  )”}”(hX  /sys/class/fpga_region/region0/dfl-fme.0
/sys/class/fpga_region/region0/dfl-port.0
/sys/class/fpga_region/region0/dfl-port.1
...

/sys/class/fpga_region/region3/dfl-fme.1
/sys/class/fpga_region/region3/dfl-port.2
/sys/class/fpga_region/region3/dfl-port.3
...”h]”hX  /sys/class/fpga_region/region0/dfl-fme.0
/sys/class/fpga_region/region0/dfl-port.0
/sys/class/fpga_region/region0/dfl-port.1
...

/sys/class/fpga_region/region3/dfl-fme.1
/sys/class/fpga_region/region3/dfl-port.2
/sys/class/fpga_region/region3/dfl-port.3
...”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´Mèhj   h²hubhÌ)”}”(hŒ?In general, the FME/AFU sysfs interfaces are named as follows::”h]”hŒ>In general, the FME/AFU sysfs interfaces are named as follows:”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mòhj   h²hubjÇ  )”}”(hŒ\/sys/class/fpga_region/<regionX>/<dfl-fme.n>/
/sys/class/fpga_region/<regionX>/<dfl-port.m>/”h]”hŒ\/sys/class/fpga_region/<regionX>/<dfl-fme.n>/
/sys/class/fpga_region/<regionX>/<dfl-port.m>/”…””}”hj!  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´Môhj   h²hubhÌ)”}”(hŒTwith 'n' consecutively numbering all FMEs and 'm' consecutively numbering all
ports.”h]”hŒ\with â€˜nâ€™ consecutively numbering all FMEs and â€˜mâ€™ consecutively numbering all
ports.”…””}”(hj/  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M÷hj   h²hubhÌ)”}”(hŒGThe device nodes used for ioctl() or mmap() can be referenced through::”h]”hŒFThe device nodes used for ioctl() or mmap() can be referenced through:”…””}”(hj=  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Múhj   h²hubjÇ  )”}”(hŒb/sys/class/fpga_region/<regionX>/<dfl-fme.n>/dev
/sys/class/fpga_region/<regionX>/<dfl-port.n>/dev”h]”hŒb/sys/class/fpga_region/<regionX>/<dfl-fme.n>/dev
/sys/class/fpga_region/<regionX>/<dfl-port.n>/dev”…””}”hjK  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´Mühj   h²hubeh}”(h]”Œdevice-enumeration”ah ]”h"]”Œdevice enumeration”ah$]”h&]”uh1hµhh·h²hh³hÊh´MÔubh¶)”}”(hhh]”(h»)”}”(hŒPerformance Counters”h]”hŒPerformance Counters”…””}”(hjd  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhja  h²hh³hÊh´MubhÌ)”}”(hX£  Performance reporting is one private feature implemented in FME. It could
supports several independent, system-wide, device counter sets in hardware to
monitor and count for performance events, including "basic", "cache", "fabric",
"vtd" and "vtd_sip" counters. Users could use standard perf tool to monitor
FPGA cache hit/miss rate, transaction number, interface clock counter of AFU
and other FPGA performance events.”h]”hX·  Performance reporting is one private feature implemented in FME. It could
supports several independent, system-wide, device counter sets in hardware to
monitor and count for performance events, including â€œbasicâ€, â€œcacheâ€, â€œfabricâ€,
â€œvtdâ€ and â€œvtd_sipâ€ counters. Users could use standard perf tool to monitor
FPGA cache hit/miss rate, transaction number, interface clock counter of AFU
and other FPGA performance events.”…””}”(hjr  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhja  h²hubhÌ)”}”(hŒêDifferent FPGA devices may have different counter sets, depending on hardware
implementation. E.g., some discrete FPGA cards don't have any cache. User could
use "perf list" to check which perf events are supported by target hardware.”h]”hŒðDifferent FPGA devices may have different counter sets, depending on hardware
implementation. E.g., some discrete FPGA cards donâ€™t have any cache. User could
use â€œperf listâ€ to check which perf events are supported by target hardware.”…””}”(hj€  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M	hja  h²hubhÌ)”}”(hŒôIn order to allow user to use standard perf API to access these performance
counters, driver creates a perf PMU, and related sysfs interfaces in
/sys/bus/event_source/devices/dfl_fme* to describe available perf events and
configuration options.”h]”hŒôIn order to allow user to use standard perf API to access these performance
counters, driver creates a perf PMU, and related sysfs interfaces in
/sys/bus/event_source/devices/dfl_fme* to describe available perf events and
configuration options.”…””}”(hjŽ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhja  h²hubhÌ)”}”(hXO  The "format" directory describes the format of the config field of struct
perf_event_attr. There are 3 bitfields for config: "evtype" defines which type
the perf event belongs to; "event" is the identity of the event within its
category; "portid" is introduced to decide counters set to monitor on FPGA
overall data or a specific port.”h]”hX_  The â€œformatâ€ directory describes the format of the config field of struct
perf_event_attr. There are 3 bitfields for config: â€œevtypeâ€ defines which type
the perf event belongs to; â€œeventâ€ is the identity of the event within its
category; â€œportidâ€ is introduced to decide counters set to monitor on FPGA
overall data or a specific port.”…””}”(hjœ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhja  h²hubhÌ)”}”(hXX  The "events" directory describes the configuration templates for all available
events which can be used with perf tool directly. For example, fab_mmio_read
has the configuration "event=0x06,evtype=0x02,portid=0xff", which shows this
event belongs to fabric type (0x02), the local event id is 0x06 and it is for
overall monitoring (portid=0xff).”h]”hX`  The â€œeventsâ€ directory describes the configuration templates for all available
events which can be used with perf tool directly. For example, fab_mmio_read
has the configuration â€œevent=0x06,evtype=0x02,portid=0xffâ€, which shows this
event belongs to fabric type (0x02), the local event id is 0x06 and it is for
overall monitoring (portid=0xff).”…””}”(hjª  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhja  h²hubhÌ)”}”(hŒExample usage of perf::”h]”hŒExample usage of perf:”…””}”(hj¸  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mhja  h²hubjÇ  )”}”(hXt  $# perf list |grep dfl_fme

dfl_fme0/fab_mmio_read/                              [Kernel PMU event]
<...>
dfl_fme0/fab_port_mmio_read,portid=?/                [Kernel PMU event]
<...>

$# perf stat -a -e dfl_fme0/fab_mmio_read/ <command>
or
$# perf stat -a -e dfl_fme0/event=0x06,evtype=0x02,portid=0xff/ <command>
or
$# perf stat -a -e dfl_fme0/config=0xff2006/ <command>”h]”hXt  $# perf list |grep dfl_fme

dfl_fme0/fab_mmio_read/                              [Kernel PMU event]
<...>
dfl_fme0/fab_port_mmio_read,portid=?/                [Kernel PMU event]
<...>

$# perf stat -a -e dfl_fme0/fab_mmio_read/ <command>
or
$# perf stat -a -e dfl_fme0/event=0x06,evtype=0x02,portid=0xff/ <command>
or
$# perf stat -a -e dfl_fme0/config=0xff2006/ <command>”…””}”hjÆ  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´M hja  h²hubhÌ)”}”(hŒ³Another example, fab_port_mmio_read monitors mmio read of a specific port. So
its configuration template is "event=0x06,evtype=0x01,portid=?". The portid
should be explicitly set.”h]”hŒ·Another example, fab_port_mmio_read monitors mmio read of a specific port. So
its configuration template is â€œevent=0x06,evtype=0x01,portid=?â€. The portid
should be explicitly set.”…””}”(hjÔ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M-hja  h²hubhÌ)”}”(hŒIts usage of perf::”h]”hŒIts usage of perf:”…””}”(hjâ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M1hja  h²hubjÇ  )”}”(hŒÈ$# perf stat -a -e dfl_fme0/fab_port_mmio_read,portid=0x0/ <command>
or
$# perf stat -a -e dfl_fme0/event=0x06,evtype=0x02,portid=0x0/ <command>
or
$# perf stat -a -e dfl_fme0/config=0x2006/ <command>”h]”hŒÈ$# perf stat -a -e dfl_fme0/fab_port_mmio_read,portid=0x0/ <command>
or
$# perf stat -a -e dfl_fme0/event=0x06,evtype=0x02,portid=0x0/ <command>
or
$# perf stat -a -e dfl_fme0/config=0x2006/ <command>”…””}”hjð  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´M3hja  h²hubhÌ)”}”(hX6  Please note for fabric counters, overall perf events (fab_*) and port perf
events (fab_port_*) actually share one set of counters in hardware, so it can't
monitor both at the same time. If this set of counters is configured to monitor
overall data, then per port perf data is not supported. See below example::”h]”hX7  Please note for fabric counters, overall perf events (fab_*) and port perf
events (fab_port_*) actually share one set of counters in hardware, so it canâ€™t
monitor both at the same time. If this set of counters is configured to monitor
overall data, then per port perf data is not supported. See below example:”…””}”(hjþ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M9hja  h²hubjÇ  )”}”(hXM  $# perf stat -e dfl_fme0/fab_mmio_read/,dfl_fme0/fab_port_mmio_write,\
                                                  portid=0/ sleep 1

Performance counter stats for 'system wide':

               3      dfl_fme0/fab_mmio_read/
 <not supported>      dfl_fme0/fab_port_mmio_write,portid=0x0/

     1.001750904 seconds time elapsed”h]”hXM  $# perf stat -e dfl_fme0/fab_mmio_read/,dfl_fme0/fab_port_mmio_write,\
                                                  portid=0/ sleep 1

Performance counter stats for 'system wide':

               3      dfl_fme0/fab_mmio_read/
 <not supported>      dfl_fme0/fab_port_mmio_write,portid=0x0/

     1.001750904 seconds time elapsed”…””}”hj  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´M>hja  h²hubhÌ)”}”(hŒÒThe driver also provides a "cpumask" sysfs attribute, which contains only one
CPU id used to access these perf events. Counting on multiple CPU is not allowed
since they are system-wide counters on FPGA device.”h]”hŒÖThe driver also provides a â€œcpumaskâ€ sysfs attribute, which contains only one
CPU id used to access these perf events. Counting on multiple CPU is not allowed
since they are system-wide counters on FPGA device.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MHhja  h²hubhÌ)”}”(hŒNThe current driver does not support sampling. So "perf record" is unsupported.”h]”hŒRThe current driver does not support sampling. So â€œperf recordâ€ is unsupported.”…””}”(hj(  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MLhja  h²hubeh}”(h]”Œperformance-counters”ah ]”h"]”Œperformance counters”ah$]”h&]”uh1hµhh·h²hh³hÊh´Mubh¶)”}”(hhh]”(h»)”}”(hŒInterrupt support”h]”hŒInterrupt support”…””}”(hjA  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj>  h²hh³hÊh´MPubhÌ)”}”(hX4  Some FME and AFU private features are able to generate interrupts. As mentioned
above, users could call ioctl (DFL_FPGA_*_GET_IRQ_NUM) to know whether or how
many interrupts are supported for this private feature. Drivers also implement
an eventfd based interrupt handling mechanism for users to get notified when
interrupt happens. Users could set eventfds to driver via
ioctl (DFL_FPGA_*_SET_IRQ), and then poll/select on these eventfds waiting for
notification.
In Current DFL, 3 sub features (Port error, FME global error and AFU interrupt)
support interrupts.”h]”hX4  Some FME and AFU private features are able to generate interrupts. As mentioned
above, users could call ioctl (DFL_FPGA_*_GET_IRQ_NUM) to know whether or how
many interrupts are supported for this private feature. Drivers also implement
an eventfd based interrupt handling mechanism for users to get notified when
interrupt happens. Users could set eventfds to driver via
ioctl (DFL_FPGA_*_SET_IRQ), and then poll/select on these eventfds waiting for
notification.
In Current DFL, 3 sub features (Port error, FME global error and AFU interrupt)
support interrupts.”…””}”(hjO  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MQhj>  h²hubeh}”(h]”Œinterrupt-support”ah ]”h"]”Œinterrupt support”ah$]”h&]”uh1hµhh·h²hh³hÊh´MPubh¶)”}”(hhh]”(h»)”}”(hŒAdd new FIUs support”h]”hŒAdd new FIUs support”…””}”(hjh  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhje  h²hh³hÊh´M]ubhÌ)”}”(hX§  It's possible that developers made some new function blocks (FIUs) under this
DFL framework, then new platform device driver needs to be developed for the
new feature dev (FIU) following the same way as existing feature dev drivers
(e.g. FME and Port/AFU platform device driver). Besides that, it requires
modification on DFL framework enumeration code too, for new FIU type detection
and related platform devices creation.”h]”hX©  Itâ€™s possible that developers made some new function blocks (FIUs) under this
DFL framework, then new platform device driver needs to be developed for the
new feature dev (FIU) following the same way as existing feature dev drivers
(e.g. FME and Port/AFU platform device driver). Besides that, it requires
modification on DFL framework enumeration code too, for new FIU type detection
and related platform devices creation.”…””}”(hjv  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M^hje  h²hubeh}”(h]”Œadd-new-fius-support”ah ]”h"]”Œadd new fius support”ah$]”h&]”uh1hµhh·h²hh³hÊh´M]ubh¶)”}”(hhh]”(h»)”}”(hŒ Add new private features support”h]”hŒ Add new private features support”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjŒ  h²hh³hÊh´MgubhÌ)”}”(hXæ  In some cases, we may need to add some new private features to existing FIUs
(e.g. FME or Port). Developers don't need to touch enumeration code in DFL
framework, as each private feature will be parsed automatically and related
mmio resources can be found under FIU platform device created by DFL framework.
Developer only needs to provide a sub feature driver with matched feature id.
FME Partial Reconfiguration Sub Feature driver (see drivers/fpga/dfl-fme-pr.c)
could be a reference.”h]”hXè  In some cases, we may need to add some new private features to existing FIUs
(e.g. FME or Port). Developers donâ€™t need to touch enumeration code in DFL
framework, as each private feature will be parsed automatically and related
mmio resources can be found under FIU platform device created by DFL framework.
Developer only needs to provide a sub feature driver with matched feature id.
FME Partial Reconfiguration Sub Feature driver (see drivers/fpga/dfl-fme-pr.c)
could be a reference.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MhhjŒ  h²hubhÌ)”}”(hŒ‰Please refer to below link to existing feature id table and guide for new feature
ids application.
https://github.com/OPAE/dfl-feature-id”h]”(hŒcPlease refer to below link to existing feature id table and guide for new feature
ids application.
”…””}”(hj«  h²hh³Nh´Nubhî)”}”(hŒ&https://github.com/OPAE/dfl-feature-id”h]”hŒ&https://github.com/OPAE/dfl-feature-id”…””}”(hj³  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jµ  uh1híhj«  ubeh}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MphjŒ  h²hubeh}”(h]”Œ add-new-private-features-support”ah ]”h"]”Œ add new private features support”ah$]”h&]”uh1hµhh·h²hh³hÊh´Mgubh¶)”}”(hhh]”(h»)”}”(hŒ Location of DFLs on a PCI Device”h]”hŒ Location of DFLs on a PCI Device”…””}”(hjÓ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhjÐ  h²hh³hÊh´MvubhÌ)”}”(hXõ  The original method for finding a DFL on a PCI device assumed the start of the
first DFL to offset 0 of bar 0.  If the first node of the DFL is an FME,
then further DFLs in the port(s) are specified in FME header registers.
Alternatively, a PCIe vendor specific capability structure can be used to
specify the location of all the DFLs on the device, providing flexibility
for the type of starting node in the DFL.  Intel has reserved the
VSEC ID of 0x43 for this purpose.  The vendor specific
data begins with a 4 byte vendor specific register for the number of DFLs followed 4 byte
Offset/BIR vendor specific registers for each DFL. Bits 2:0 of Offset/BIR register
indicates the BAR, and bits 31:3 form the 8 byte aligned offset where bits 2:0 are
zero.
::”h]”hXò  The original method for finding a DFL on a PCI device assumed the start of the
first DFL to offset 0 of bar 0.  If the first node of the DFL is an FME,
then further DFLs in the port(s) are specified in FME header registers.
Alternatively, a PCIe vendor specific capability structure can be used to
specify the location of all the DFLs on the device, providing flexibility
for the type of starting node in the DFL.  Intel has reserved the
VSEC ID of 0x43 for this purpose.  The vendor specific
data begins with a 4 byte vendor specific register for the number of DFLs followed 4 byte
Offset/BIR vendor specific registers for each DFL. Bits 2:0 of Offset/BIR register
indicates the BAR, and bits 31:3 form the 8 byte aligned offset where bits 2:0 are
zero.”…””}”(hjá  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MwhjÐ  h²hubjÇ  )”}”(hX  +----------------------------+
|31     Number of DFLS      0|
+----------------------------+
|31     Offset     3|2 BIR  0|
+----------------------------+
              . . .
+----------------------------+
|31     Offset     3|2 BIR  0|
+----------------------------+”h]”hX  +----------------------------+
|31     Number of DFLS      0|
+----------------------------+
|31     Offset     3|2 BIR  0|
+----------------------------+
              . . .
+----------------------------+
|31     Offset     3|2 BIR  0|
+----------------------------+”…””}”hjï  sbah}”(h]”h ]”h"]”h$]”h&]”jÖ  j×  uh1jÆ  h³hÊh´M„hjÐ  h²hubhÌ)”}”(hŒâBeing able to specify more than one DFL per BAR has been considered, but it
was determined the use case did not provide value.  Specifying a single DFL
per BAR simplifies the implementation and allows for extra error checking.”h]”hŒâBeing able to specify more than one DFL per BAR has been considered, but it
was determined the use case did not provide value.  Specifying a single DFL
per BAR simplifies the implementation and allows for extra error checking.”…””}”(hjý  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MŽhjÐ  h²hubeh}”(h]”Œ location-of-dfls-on-a-pci-device”ah ]”h"]”Œ location of dfls on a pci device”ah$]”h&]”uh1hµhh·h²hh³hÊh´Mvubh¶)”}”(hhh]”(h»)”}”(hŒ(Userspace driver support for DFL devices”h]”hŒ(Userspace driver support for DFL devices”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj  h²hh³hÊh´M”ubhÌ)”}”(hX  The purpose of an FPGA is to be reprogrammed with newly developed hardware
components. New hardware can instantiate a new private feature in the DFL, and
then present a DFL device in the system. In some cases users may need a
userspace driver for the DFL device:”h]”hX  The purpose of an FPGA is to be reprogrammed with newly developed hardware
components. New hardware can instantiate a new private feature in the DFL, and
then present a DFL device in the system. In some cases users may need a
userspace driver for the DFL device:”…””}”(hj$  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M•hj  h²hubhÜ)”}”(hhh]”(há)”}”(hŒ>Users may need to run some diagnostic test for their hardware.”h]”hÌ)”}”(hj7  h]”hŒ>Users may need to run some diagnostic test for their hardware.”…””}”(hj9  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mšhj5  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj2  h²hh³hÊh´Nubhá)”}”(hŒ4Users may prototype the kernel driver in user space.”h]”hÌ)”}”(hjN  h]”hŒ4Users may prototype the kernel driver in user space.”…””}”(hjP  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M›hjL  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj2  h²hh³hÊh´Nubhá)”}”(hŒmSome hardware is designed for specific purposes and does not fit into one of
the standard kernel subsystems.
”h]”hÌ)”}”(hŒlSome hardware is designed for specific purposes and does not fit into one of
the standard kernel subsystems.”h]”hŒlSome hardware is designed for specific purposes and does not fit into one of
the standard kernel subsystems.”…””}”(hjg  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´Mœhjc  ubah}”(h]”h ]”h"]”h$]”h&]”uh1hàhj2  h²hh³hÊh´Nubeh}”(h]”h ]”h"]”h$]”h&]”j—  j  uh1hÛh³hÊh´Mšhj  h²hubhÌ)”}”(hŒ—This requires direct access to MMIO space and interrupt handling from
userspace. The uio_dfl module exposes the UIO device interfaces for this
purpose.”h]”hŒ—This requires direct access to MMIO space and interrupt handling from
userspace. The uio_dfl module exposes the UIO device interfaces for this
purpose.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´MŸhj  h²hubhÌ)”}”(hŒœCurrently the uio_dfl driver only supports the Ether Group sub feature, which
has no irq in hardware. So the interrupt handling is not added in this driver.”h]”hŒœCurrently the uio_dfl driver only supports the Ether Group sub feature, which
has no irq in hardware. So the interrupt handling is not added in this driver.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M£hj  h²hubhÌ)”}”(hŒ¬UIO_DFL should be selected to enable the uio_dfl module driver. To support a
new DFL feature via UIO direct access, its feature id should be added to the
driver's id_table.”h]”hŒ®UIO_DFL should be selected to enable the uio_dfl module driver. To support a
new DFL feature via UIO direct access, its feature id should be added to the
driverâ€™s id_table.”…””}”(hj  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M¦hj  h²hubeh}”(h]”Œ(userspace-driver-support-for-dfl-devices”ah ]”h"]”Œ(userspace driver support for dfl devices”ah$]”h&]”uh1hµhh·h²hh³hÊh´M”ubh¶)”}”(hhh]”(h»)”}”(hŒOpen discussion”h]”hŒOpen discussion”…””}”(hj¶  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hºhj³  h²hh³hÊh´M¬ubhÌ)”}”(hŒÜFME driver exports one ioctl (DFL_FPGA_FME_PORT_PR) for partial reconfiguration
to user now. In the future, if unified user interfaces for reconfiguration are
added, FME driver should switch to them from ioctl interface.”h]”hŒÜFME driver exports one ioctl (DFL_FPGA_FME_PORT_PR) for partial reconfiguration
to user now. In the future, if unified user interfaces for reconfiguration are
added, FME driver should switch to them from ioctl interface.”…””}”(hjÄ  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËh³hÊh´M­hj³  h²hubeh}”(h]”Œopen-discussion”ah ]”h"]”Œopen discussion”ah$]”h&]”uh1hµhh·h²hh³hÊh´M¬ubeh}”(h]”Œ/fpga-device-feature-list-dfl-framework-overview”ah ]”h"]”Œ1fpga device feature list (dfl) framework overview”ah$]”h&]”uh1hµhhh²hh³hÊh´Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”hÊuh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(hºNŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”hÊŒ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(jß  jÜ  j#  j   j˜  j•  jÂ  j¿  j$	  j!	  jK	  jH	  jZ  jW  j  j  j8  j5  j  jš  j^  j[  j;  j8  jb  j_  j‰  j†  jÍ  jÊ  j  j  j°  j­  j×  jÔ  uŒ	nametypes”}”(jß  ‰j#  ‰j˜  ‰jÂ  ‰j$	  ‰jK	  ‰jZ  ‰j  ‰j8  ‰j  ‰j^  ‰j;  ‰jb  ‰j‰  ‰jÍ  ‰j  ‰j°  ‰j×  ‰uh}”(jÜ  h·j   j§  j•  j&  j¿  j›  j!	  jÅ  jH	  j'	  jW  jN	  j  j]  j5  j  jš  j;  j[  j   j8  ja  j_  j>  j†  je  jÊ  jŒ  j  jÐ  j­  j  jÔ  j³  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”hŒsystem_message”“”)”}”(hhh]”hÌ)”}”(hŒfPossible title underline, too short for the title.
Treating it as ordinary text because it's so short.”h]”hŒhPossible title underline, too short for the title.
Treating it as ordinary text because itâ€™s so short.”…””}”(hjl  h²hh³Nh´Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hËhji  ubah}”(h]”h ]”h"]”h$]”h&]”Œlevel”KŒtype”ŒINFO”Œline”MšŒsource”hÊuh1jg  hj;  h²hh³hÊh´MšubaŒtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nh²hub.