| common | ||
| external | ||
| AMI_PFAT_Extract.py | ||
| AMI_UCP_Extract.py | ||
| Dell_PFS_Extract.py | ||
| LICENSE | ||
| README.md | ||
BIOSUtilities [Refactor - WIP]
Various BIOS Utilities for Modding/Research
Dell PFS Update Extractor
Description
Parses Dell PFS Update images and extracts their Firmware (e.g. SPI, BIOS/UEFI, EC, ME etc) and Utilities (e.g. Flasher etc) component sections. It supports all Dell PFS revisions and formats, including those which are originally LZMA compressed in ThinOS packages, ZLIB compressed or Intel BIOS Guard (PFAT) protected. The output comprises only final firmware components which are directly usable by end users.
Usage
You can either Drag & Drop or manually enter Dell PFS Update images(s). Optional arguments:
- -h or --help : show help message and exit
- -v or --version : show utility name and version
- -i or --input-dir : extract from given input directory
- -o or --output-dir : extract in given output directory
- -e or --auto-exit : skip press enter to exit prompts
- --static : use static-built external dependencies
- -a or --advanced : extract signatures and metadata
- -s or --structure : show PFS structure information
Compatibility
Should work at all Windows, Linux or macOS operating systems which have Python 3.8 support.
Prerequisites
Optionally, to decompile the Intel BIOS Guard (PFAT) Scripts, you must have the following 3rd party utility at the "external" project directory:
- BIOS Guard Script Tool (i.e. big_script_tool.py)
Build/Freeze/Compile with PyInstaller
PyInstaller can build/freeze/compile the utility at all three supported platforms, it is simple to run and gets updated often.
- Make sure Python 3.8.0 or newer is installed:
python --version
- Use pip to install PyInstaller:
pip3 install pyinstaller
- Place prerequisites at the "external" project directory:
BIOS Guard Script Tool (optional)
- Build/Freeze/Compile:
pyinstaller --add-data="external/*;external/" --noupx --onefile <path-to-project>/Dell_PFS_Extract.py
You should find the final utility executable at "dist" folder
Anti-Virus False Positives
Some Anti-Virus software may claim that the built/frozen/compiled executable contains viruses. Any such detections are false positives, usually of PyInstaller. You can switch to a better Anti-Virus software, report the false positive to their support, add the executable to the exclusions, build/freeze/compile yourself or use the Python script directly.
Pictures
AMI UCP BIOS Extractor
Description
Parses AMI UCP (Utility Configuration Program) BIOS executables, extracts their firmware components (e.g. SPI/BIOS/UEFI, EC, ME etc) and shows all relevant info. It supports all AMI UCP revisions and formats, including those with nested AMI PFAT, AMI UCP or Insyde SFX structures. The output comprises only final firmware components and utilities which are directly usable by end users.
Usage
You can either Drag & Drop or manually enter AMI UCP BIOS executable file(s). Optional arguments:
- -h or --help : show help message and exit
- -v or --version : show utility name and version
- -i or --input-dir : extract from given input directory
- -o or --output-dir : extract in given output directory
- -e or --auto-exit : skip press enter to exit prompts
- --static : use static-built external dependencies
- -c or --checksum : verify AMI UCP Checksums (slow)
Compatibility
Should work at all Windows, Linux or macOS operating systems which have Python 3.8 support.
Prerequisites
To run the utility, you must have the following 3rd party tools at the "external" project directory:
- TianoCompress (e.g. TianoCompress.exe for Windows or TianoCompress)
- 7-Zip Console (i.e. 7z.exe for Windows or 7zz|7zzs)
Optionally, to decompile the AMI UCP > AMI PFAT > Intel BIOS Guard Scripts (when applicable), you must have the following 3rd party utility at the "external" project directory:
- BIOS Guard Script Tool (i.e. big_script_tool.py)
Build/Freeze/Compile with PyInstaller
PyInstaller can build/freeze/compile the utility at all three supported platforms, it is simple to run and gets updated often.
- Make sure Python 3.8.0 or newer is installed:
python --version
- Use pip to install PyInstaller:
pip3 install pyinstaller
- Place prerequisites at the "external" project directory:
TianoCompress \7-Zip Console BIOS Guard Script Tool (optional)
- Build/Freeze/Compile:
pyinstaller --add-data="external/*;external/" --noupx --onefile <path-to-project>/AMI_UCP_Extract.py
You should find the final utility executable at "dist" folder
Anti-Virus False Positives
Some Anti-Virus software may claim that the built/frozen/compiled executable contains viruses. Any such detections are false positives, usually of PyInstaller. You can switch to a better Anti-Virus software, report the false positive to their support, add the executable to the exclusions, build/freeze/compile yourself or use the Python script directly.
Pictures
AMI BIOS Guard Extractor
Description
Parses AMI BIOS Guard (a.k.a. PFAT, Platform Firmware Armoring Technology) images, extracts their SPI/BIOS/UEFI firmware components and decompiles the Intel BIOS Guard Scripts. It supports all AMI PFAT revisions and formats, including those with Index Information tables or nested AMI PFAT structures. The output comprises only final firmware components which are directly usable by end users.
Note that the AMI PFAT structure may not have an explicit component order. AMI's BIOS Guard Firmware Update Tool (AFUBGT) updates components based on the user/OEM provided Parameters and Options or Index Information table, when applicable. That means that merging all the components together does not usually yield a proper SPI/BIOS/UEFI image. The utility does generate such a merged file with the name "00 -- <filename>_ALL.bin" but it is up to the end user to determine its usefulness. Moreover, any custom OEM data after the AMI PFAT structure are additionally stored in the last file with the name "<n+1> -- _OOB.bin" and it is once again up to the end user to determine its usefulness. In cases where the trailing custom OEM data include a nested AMI PFAT structure, the utility will process and extract it automatically as well.
Usage
You can either Drag & Drop or manually enter AMI BIOS Guard (PFAT) image file(s). Optional arguments:
- -h or --help : show help message and exit
- -v or --version : show utility name and version
- -i or --input-dir : extract from given input directory
- -o or --output-dir : extract in given output directory
- -e or --auto-exit : skip press enter to exit prompts
- --static : use static-built external dependencies
Compatibility
Should work at all Windows, Linux or macOS operating systems which have Python 3.8 support.
Prerequisites
Optionally, to decompile the AMI PFAT > Intel BIOS Guard Scripts, you must have the following 3rd party utility at the "external" project directory:
- BIOS Guard Script Tool (i.e. big_script_tool.py)
Build/Freeze/Compile with PyInstaller
PyInstaller can build/freeze/compile the utility at all three supported platforms, it is simple to run and gets updated often.
- Make sure Python 3.8.0 or newer is installed:
python --version
- Use pip to install PyInstaller:
pip3 install pyinstaller
- Place prerequisites at the "external" project directory:
BIOS Guard Script Tool (optional)
- Build/Freeze/Compile:
pyinstaller --add-data="external/*;external/" --noupx --onefile <path-to-project>/AMI_PFAT_Extract.py
You should find the final utility executable at "dist" folder
Anti-Virus False Positives
Some Anti-Virus software may claim that the built/frozen/compiled executable contains viruses. Any such detections are false positives, usually of PyInstaller. You can switch to a better Anti-Virus software, report the false positive to their support, add the executable to the exclusions, build/freeze/compile yourself or use the Python script directly.