What can I help you with?
NVIDIA BlueField BSP v4.11.0

BFB FW-bundle Extraction Process

The bfb-tool is a command-line utility used to manage BlueField BFB files (i.e., bf-bundle or bf-fwbundle). It supports two primary actions:

  • Extracting payloads from a BFB

  • Repacking BFBs for a specific PSID or OPN

This page provides comprehensive usage instructions, supported options, and examples.

Copy
Copied!
            

bfb-tool <action> --bfb <BFB> [--psid <PSID> | --opn <OPN> | --all] [-p | --profile <Profile>] [--output-dir <DIR>] [-v | --verbose]

Action

Description

extract

Extracts the firmware payload for the specified PSID, OPN, or all configurations

repack

Extracts and rebuilds a new BFB file tailored to a specific PSID or OPN

Option

Description

--bfb <BFB>

Path to the input BFB file (e.g., bf-fwbundle-*.bfb)

--psid <PSID>

Target PSID (e.g., MT_0000001070) for extraction or repacking

--opn <OPN>

Target OPN (e.g., 900-9D3B6-F2SV-PA0_Ax) for extraction or repacking

--all

Process all PSID/OPN configurations in the BFB

-p, --profile <Profile>

Optional profile to apply during repacking

--output-dir <DIR>

Directory to store the extracted or repacked output files

-v, --verbose

Enable verbose output for detailed execution logs

  • Extract payload for a specific PSID:

    Copy
    Copied!
                

    bfb-tool extract --bfb bf-fwbundle-2.9.2-40_25.02-prod.bfb --psid MT_0000001070

  • Repack BFB for a specific OPN:

    Copy
    Copied!
                

    bfb-tool repack --bfb bf-fwbundle-2.9.2-40_25.02-prod.bfb --opn 900-9D3B6-F2SV-PA0_Ax

  • Extract all configurations:

    Copy
    Copied!
                

    bfb-tool extract --bfb bf-fwbundle-2.9.2-40_25.02-prod.bfb --all

  • Specify a custom output directory:

    Copy
    Copied!
                

    bfb-tool extract --bfb bf-fwbundle-2.9.2-40_25.02-prod.bfb --psid MT_0000001070 --output-dir /path/to/output

  • Enable verbose output:

    Copy
    Copied!
                

    bfb-tool repack --bfb bf-fwbundle-2.9.2-40_25.02-prod.bfb --opn 900-9D3B6-F2SV-PA0_Ax -v

  • Ensure the specified BFB file exists and is accessible

  • Use only one of --psid, --opn, or --all per command

  • Use --profile to apply a specific firmware configuration profile (if applicable)

  • By default, extracted files are saved to /tmp/<bfb-name>/ unless overridden using --output-dir

© Copyright 2025, NVIDIA. Last updated on May 5, 2025.