rsu

SYNOPSIS

rsu [-h] [-d] {bmc,bmcimg,retimer,fpga,sdm,fpgadefault} [PCIE_ADDR]

DESCRIPTION

Mode 1: RSU

rsu bmc --page=(user|factory) [PCIE_ADDR]
rsu retimer [PCIE_ADDR]
rsu fpga --page=(user1|user2|factory) [PCIE_ADDR]
rsu sdm --type=(sr|pr|sr_cancel|pr_cancel) [PCIE_ADDR]

Perform RSU (remote system update) operation on PAC device given its PCIe address. An RSU operation sends an instruction to the device to trigger a power cycle of the card only. This will force reconfiguration from flash for either BMC, Retimer, SDM, (on devices that support these) or the FPGA.

Mode 2: Default FPGA Image

rsu fpgadefault --page=(user1|user2|factory) --fallback=<csv> [PCIE_ADDR]

Set the default FPGA boot sequence. The –page option determines the primary FPGA boot image. The –fallback option allows a comma-separated list of values to specify fallback images.

POSITIONAL ARGUMENTS

{bmc,bmcimg,retimer,fpga,sdm,fpgadefault}

type of RSU operation or set Default FPGA Image operation.

PCIE_ADDR PCIe address of device to do rsu (e.g. 04:00.0 or 0000:04:00.0)

OPTIONAL ARGUMENTS

-h, --help show this help message and exit

-d, --debug log debug statements

--force force rsu operation

EXAMPLE

# rsu bmc --page=user 25:00.0

Triggers a boot of the BMC image (user page) for the device with PCIe address 25:00.0.

# rsu bmc --page=factory 25:00.0

Triggers a factory boot of the BMC image for the device with PCIe address 25:00.0.

# rsu fpga --page=user2 25:00.0

Triggers a reconfiguration of the FPGA (user2 page) for the device with PCIe address 25:00.0.

# rsu --force fpga --page=user2 25:00.0

Forces a reconfiguration of the FPGA (user2 page) for the device with PCIe address 25:00.0. Default behavior is to not perform the rsu operation if DPC (downstream port containment) is not supported and AER (advanced error reporting) is also not supported. Using –force changes this behavior to perform rsu operation regardless but may result in a surprise removal of pci devices which may cause the Linux kernel to panic.

# rsu fpga --page=factory 25:00.0

Triggers a factory reconfiguration of the FPGA for the device with PCIe address 25:00.0.

# rsu sdm --type=sr 25:00.0

Triggers Static Region key programming for the device with PCIE address 25:00.0.

# rsu fpgadefault --page=factory --fallback=user1,user2 25:00.0

Sets the FPGA boot sequence to factory with fallbacks user1, user2.