fpgainfo¶
SYNOPSIS¶
fpgainfo [-h | --help] [<args>] <command> [<command-args>]
DESCRIPTION¶
fpgainfo displays FPGA information derived from sysfs files. The command
argument is one of the following: errors
, power
, temp
,
port
, fme
, bmc
, or security
. Some commands may also have
other arguments or options that control their behavior.
For systems with multiple FPGA devices, you can specify the BDF to limit the output to the FPGA resource with the corresponding PCIe configuration. If not specified, information displays for all resources for the given command.
FPGAINFO COMMANDS¶
errors
Show/clear errors of an FPGA resource that the first argument specifies.
fpgainfo
displays information in human readable form.
power
Show total the power in watts that the FPGA hardware consumes.
temp
Show FPGA temperature values in degrees Celcius.
port
Show information about the port such as the AFU ID of currently loaded AFU.
fme
Show information about the FPGA platform including the partial reconfiguration (PR) Interface ID, the OPAE version, and the FPGA Interface Manager (FIM) ID.
bmc
Show all Board Management Controller sensor values for the FPGA resource, if available.
security
Show all security-related information available on the FPGA device. This includes root entry hash values, code signing key cancellations, and flash update counters.
COMMON ARGUMENTS¶
The following arguments are common to all commands and are optional.
-B, --bus
PCIe bus number of resource.
-D, --device
PCIe device number of resource.
-F, --function
PCIe function number of resource.
--json
Display information as JSON string.
ERRORS ARGUMENTS¶
The first argument to the errors
command specifies the resource
type. It must be one of the following: fme
,port
,all
fme
Show/clear FME errors.
port
Show/clear PORT errors.
all
Show/clear errors for all resources.
The optional <command-args>
arguments are:
--clear, -c
Clear errors for the given FPGA resource.
EXAMPLES¶
This command shows the current power telemetry:
./fpgainfo power
This command shows the current temperature readings:
./fpgainfo temp
This command shows FME resource errors:
./fpgainfo errors fme
This command clears all errors on all resources:
./fpgainfo errors all -c
This command shows information of the FME on bus 0x5e
./fpgainfo fme -B 0x5e
Revision History¶
Document Version | Intel Acceleration Stack Version | Changes |
---|---|---|
2018.10.15 | 1.2. (Supported with Intel Quartus Prime Pro Edition 17.1.1.) | Added information for the Board Management Controller (BMC). |
2018.05.21 | 1.1 Beta. (Supported with Intel Quartus Prime Pro Edition 17.1.) | Updated
description
of the
fme
command |