Intel Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA
ID
683633
Date
12/04/2020
Public
1. About This Document
2. Introduction
3. Getting Started
4. Installing the OPAE Software Package
5. Identifying the Flash Image and BMC Firmware
6. Running FPGA Diagnostics
7. Running the OPAE in a Non-Virtualized Environment
8. Running the OPAE in a Virtualized Environment
9. Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA Archives
10. Document Revision History for Intel® Acceleration Stack Quick Start Guide for Intel® Programmable Acceleration Card with Intel® Arria® 10 GX FPGA
A. Updating the FIM and BMC Firmware
B. Handling Graceful Thermal Shutdown
C. FPGA Device Access Permission
D. Memlock Limit
E. Hugepage Settings
F. Troubleshooting Frequently Asked Questions (FAQ)
G. Documentation Available for the Intel® Acceleration Stack for Intel® Xeon® CPU with FPGAs 1.2.1 Release
F.1. Why do I see a 'No Suitable slots found' message when running fpgaconf on my AFU image?
F.2. How do I flash the FIM or program the AFU in a multicard system?
F.3. Which environment variables are required?
F.4. What actions do I take if I see the error message 'Error enumerating resources: no driver available'?
F.5. Troubleshooting OPAE Installation on RHEL
C. FPGA Device Access Permission
To be able to run AFU samples and other OPAE tools as non-root user, you can run the below command to change file access permissions.
Use file access permissions on the Intel FPGA device file directories, /dev/intel-fpga-fme.* and /dev/intel-fpga-port.* to control access to FPGA accelerators and devices. Use the same file access permissions to control access to the files reachable through /sys/class/fpga/.
The * denotes the respective socket, for example 0 or 1.
Typically, you must change these permissions after every restart. To make the changes permanent, add these permissions to /etc/bashrc as well.
Here are the commands to run:
sudo chmod 666 /dev/intel-fpga-fme.* sudo chmod 666 /dev/intel-fpga-port.* sudo chmod 666 /sys/class/fpga/intel-fpga-dev.*/intel-fpga-port.*\ /userclk_freqcmd sudo chmod 666 /sys/class/fpga/intel-fpga-dev.*/intel-fpga-port.*\ /userclk_freqcntrcmd sudo chmod 666 /sys/class/fpga/intel-fpga-dev.*/intel-fpga-port.*/errors/clear