User Manual

mlxburn - FW Image Generator & BurnerRev 1.50
Mellanox Technologies
14
-wrimage <fw-image-file> - Write the generated binary image to the provided file name
-fw <mellanox-fw-file> - Specify the Mellanox firmware file to use (file extension is .mlx)
-format <BINARY|IMAGE> - Specify which image format to use. Can be used only with the -wrimage
flag. Default is BINARY.
-image <fw-image-file> - Use the given firmware image to burn (file extension is .bin or .img)
-conf <parameter-set-file> - Firmware configuration file (.ini). Needed for image generation (not using
the -dev flag) or if auto-detection of configuration fails.
-conf_dir <dir> - Instruct the burn operation to look for auto-detected configuration files
under the specified directory rather than under the firmware file directory.
-fw_dir <dir> - Instruct the burn operation to look for auto-detected firmware files under
the specified directory.
-nofs - When specified, the burn process will not be failsafe. A non-failsafe burn
is required (on the rare occasion) when a new firmware version has modi
-
fications in the Invariant Sector
-nofs_img - When specified, the generated image will not be failsafe. If burning is also
specified, it will not be failsafe either.
-exp_rom <exp-rom-file> - Integrate the given expansion rom file to the FW image. The given file
may be in .img or .bin/.rom (raw binary) format. If the exp-rom-file is set
to "AUTO", expansion rom file is auto detected from the files rom in the
exp_rom_dir (see below).
Note: Exp rom auto detection is done for devices that are already
burned with an exp-rom image. If "-exp_rom AUTO" is specified
for a device with no exp-rom, it would be burnt with no exp rom.
To add exp-rom to a device, manually supply the exp rom file to
use.
-exp_rom_dir <exp_rom_dir> - The directory in which to look for expansion rom file when "-exp_rom
AUTO" is specified. By default, exp-rom files are searched in <fw file
directory>/exp_rom/*
-fwver - When a device is given: Display current loaded firmware version. When a
FW file is given (-fw flag): Display the file FW version.
-force - Run mlxburn in non-interactive mode
-vpd
1
- (on Linux only): Display the Read Only section of the PCI VPD (Vital
Product Data) of the given device
-vpd_rw
1
- (on Linux only): Display the Read Only and Read/Write sections of the
PCI VPD of the given device
-vpd_prog_rw
1
<rw-fields-file> - (on Linux only): Program the VPD-W tag (the writable section of the
VPD) with the data given in the rw-keywords-file.
File lines format: "KEYWORD = VALUE".
In order to set binary data to a keyword, add ":BIN" to the keyword name.
in this case, the data is a hexadecimal string of even length.
Example file:
V1 = MY-ASCII-KEYWORD
1. The VPD query may not be enabled on certain board types. Also, VPD operations are available only for devices with a PCI interface.