OPAE Intel FPGA Linux Device Driver Architecture Guide

Download PDF
ID 683857
Date 10/02/2017
Public
Document Table of Contents
Document Table of Contents x
1. OPAE Intel® FPGA Linux Device Driver Architecture
1. OPAE Intel® FPGA Linux Device Driver Architecture x
1.1. Hardware Architecture 1.2. sysfs Files 1.3. Revision History
1.1. Hardware Architecture x
1.1.1. FPGA Management Engine (FME) 1.1.2. Port 1.1.3. Accelerator Function (AF) Unit 1.1.4. Partial Reconfiguration 1.1.5. FPGA Virtualization 1.1.6. Driver Organization 1.1.7. Application FPGA Device Enumeration 1.1.8. PCIe Driver Enumeration 1.1.9. FME Platform Device Initialization 1.1.10. Port Platform Device Initialization 1.1.11. FME IOCTLs 1.1.12. Port IOCTLs
1.1.6. Driver Organization x
1.1.6.1. PCIe Module Device Driver 1.1.6.2. PCIe Module Device Driver Functions 1.1.6.3. FME Platform Module Device Driver 1.1.6.4. FME Platform Module Device Driver Functions 1.1.6.5. Port Platform Module Device Driver 1.1.6.6. Port Platform Module Device Driver Functions
1.1.8. PCIe Driver Enumeration x
1.1.8.1. Enumeration Data Structures 1.1.8.2. Enumeration Flow
1.1.9. FME Platform Device Initialization x
1.1.9.1. FME Platform Device Data Structures 1.1.9.2. FME Platform Device Initialization Flow
1.1.10. Port Platform Device Initialization x
1.1.10.1. Port Platform Device Data Structures 1.1.10.2. Port Platform Device Initialization Flow
1.2. sysfs Files x
1.2.1. FME Header sysfs files 1.2.2. FME Thermal Management sysfs files 1.2.3. FME Power Management sysfs files 1.2.4. FME Global Error sysfs files 1.2.5. FME Partial Reconfiguration sysfs files 1.2.6. FME Global Performance sysfs files intel-fpga-dev.i/intel-fpga-fme.j/dperf/clock 1.2.7. Port Header sysfs files 1.2.8. Port AFU Header sysfs files 1.2.9. Port Error sysfs files
1. OPAE Intel® FPGA Linux Device Driver Architecture

1.2.6. FME Global Performance sysfs files

intel-fpga-dev.i/intel-fpga-fme.j/dperf/clock

sysfs file mmio field type access
clock gperf.clk.afu_interf_clock hex uint64_t Read-only
Table 2.   intel-fpga-dev.i/intel-fpga-fme.j/dperf/cache/ (Not valid for Acceleration Stack for Intel® Xeon® CPU with FPGAs)
sysfs file mmio field type access
freeze gperf.ch_ctl.freeze decimal int Read-write
read_hit gperf.CACHE_RD_HIT hex uint64_t Read-only
read_miss gperf.CACHE_RD_MISS hex uint64_t Read-only
write_hit gperf.CACHE_WR_HIT hex uint64_t Read-only
write_miss gperf.CACHE_WR_MISS hex uint64_t Read-only
hold_request gperf.CACHE_HOLD_REQ hex uint64_t Read-only
tx_req_stall gperf.CACHE_TX_REQ_STALL hex uint64_t Read-only
rx_req_stall gperf.CACHE_RX_REQ_STALL hex uint64_t Read-only
data_write_port_contention gperf.CACHE_DATA_WR_PORT_CONTEN hex uint64_t Read-only
tag_write_port_contention gperf.CACHE_TAG_WR_PORT_CONTEN hex uint64_t Read-only
Table 3.   intel-fpga-dev.i/intel-fpga-fme.j/dperf/iommu/ (Not valid for Acceleration Stack for Intel® Xeon® CPU with FPGAs)
sysfs file mmio field type access
freeze gperf.vtd_ctl.freeze decimal int User: Read-only Root: Read-write
Table 4.   intel-fpga-dev.i/intel-fpga-fme.j/dperf/iommu/afuk/ (Not valid for Acceleration Stack for Intel® Xeon® CPU with FPGAs)
sysfs file mmio field type access
read_transaction gperf.VTD_AFU0_MEM_RD_TRANS hex uint64_t Read-only
write_transaction gperf.VTD_AFU0_MEM_WR_TRANS hex uint64_t Read-only
tlb_read_hit gperf.VTD_AFU0_TLB_RD_HIT hex uint64_t Read-only
tlb_write_hit gperf.VTD_AFU0_TLB_WR_HIT hex uint64_t Read-only
Table 5.   intel-fpga-dev.i/intel-fpga-fme.j/dperf/fabric/
sysfs file mmio field type access
enable gperf.fab_ctl.(enabled) decimal int User: Read-only Root: Read-write
freeze gperf.fab_ctl.freeze decimal int User: Read-only Root: Read-write
pcie0_read gperf.FAB_PCIE0_RD hex uint64_t Read-only
pcie0_write gperf.FAB_PCIE0_WR hex uint64_t Read-only
pcie1_read gperf.FAB_PCIE1_RD hex uint64_t Read-only
pcie1_write gperf.FAB_PCIE1_WR hex uint64_t Read-only
upi_read gperf.FAB_UPI_RD hex uint64_t Read-only
upi_write gperf.FAB_UPI_WR hex uint64_t Read-only
Table 6.   intel-fpga-ev.i/intel-fpga/fme.j/dperf/fabric/portk/
sysfs file mmio field type access
pcie0_read gperf.FAB_PCIE0_RD hex uint64_t Read-only
pcie0_write gperf.FAB_PCIE0_WR hex uint64_t Read-only
pcie1_read gperf.FAB_PCIE1_RD hex uint64_t Read-only
pcie1_write gperf.FAB_PCIE1_WR hex uint64_t Read-only
upi_read gperf.FAB_UPI_RD hex uint64_t Read-only
upi_write gperf.FAB_UPI_WR hex uint64_t Read-only
Level Two Title