fpgainfo¶
SYNOPSIS¶
fpgainfo [-h] [-S <segment>] [-B <bus>] [-D <device>] [-F <function>] [PCI_ADDR]
{errors,power,temp,fme,port,bmc,mac,phy,security}
DESCRIPTION¶
fpgainfo displays FPGA information derived from sysfs files. The command argument is one of the following:
errors, power, temp, port, fme, bmc, phy or mac,security,events.
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.
| Error | Description |
|---|---|
| Catfatal Errors | Bit 8 indicates an Injected Fatal error, bit 11 indicates an Injected Catastrophic Error. |
| Inject Errors | [2:0] are mainly writeable bits. Can read back values. |
| (FME) Next Error | [59:0] 60 LSBs are taken from the given error register that was triggered second, [60:61] 0 = FME0 Error, 1 = PCIe0 Error. |
| (FME) First Error | [59:0] 60 LSBs are taken from the given error register that was triggered first, [60:61] 0 = FME0 Error, 1 = PCIe0 Error. |
| FME Errors | Error from Partial Reconfiguration Block reporting a FIFO Parity Error has occurred. |
| Non-fatal Errors | Bit 6 is used to advertise an Injected Warning Error. |
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.
The User1/User2/Factory Image Info lines reflect the information of the image that is present in the Flash.
The Bitstream Id line reflects the information of the image that is programmed in the FPGA.
bmc
Show all Board Management Controller sensor values for the FPGA resource, if available.
phy
Show information about the PHY integrated in the FPGA, if available.
mac
Show information about the MAC address in ROM attached to the FPGA, if available.
security
Show information about the security keys, hashs and flash count, if available.
events
Show information about events and sensors, if available.
OPTIONAL ARGUMENTS¶
--help, -h
Prints help information and exit.
--version, -v
Prints version information and exit.
COMMON ARGUMENTS¶
The following arguments are common to all commands and are optional.
-S, --segment
PCIe segment number of resource.
-B, --bus
PCIe bus number of resource.
-D, --device
PCIe device number of resource.
-F, --function
PCIe function number of resource.
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.
PHY ARGUMENTS¶
The optional <command-args> argument is:
--group, -G
Select which PHY group(s) information to show.
EVENTS ARGUMENTS¶
The optional <command-args> argument is:
--list,-l
List boots (implies --all).
--boot,-b
Boot index to use, i.e: 0 for current boot (default). 1 for previous boot, etc.
--count,-c
Number of events to print.
--all,-a
Print all events.
--sensors,-s
Print sensor data too.
--bits,-i
Print bit values too.
--help,-h
Print this help.
EXAMPLES¶
This command shows the current power telemetry:
This command shows the current temperature readings:
This command shows FME resource errors:
This command clears all errors on all resources: This command shows information of the FME on bus 0x5e This command shows information of the FPGA security on bus 0x5e This command shows all events and sensors information including sensor bits: