Repository navigation
Python UEFI Interpreter release version 3.6.8.1
The Python interpreter for UEFI shell is based on the standard C-Python version 3.6.8. It has been ported to UEFI shell and enhanced with basic capabilities required for interacting with the UEFI platform. This includes the register read/write of various types of registers such as MSR, MMIO, CPUID, PCIe, IO Port registers and etc. Python scripting on UEFI could be used for developing debug, diagnostic tools, validation tools, automation of Silicon, Firmware and platform related tests from UEFI shell. This brings the power of Python scripting on UEFI shell providing a way to leverage some of the existing tools from OS space to run on UEFI with little or no changes. Currently it has been supported for X64 and x86 platforms and the compilation of the source code is supported with VS2019 and the GCC tool chains.
The chipsec - an open source platform security analysis framework written in Python 3.x leverages the Python UEFI capabilities to run on UEFI shell. You may get more details about the project by visiting the link - https://github.com/chipsec/chipsec
Release Summary
This release of the Python UEFI version 3.6.8.2 which is based on the standard C-Python version 3.6.8.
Built using the 64 bit version of VS2022 chian. This has been specifically made to fix the issue #94 faced by the chipsec team.
The last digit in the version will be increased each time we make an updated release of Python UEFI from this repository.
What's Changed
- Add SO_ERROR support for getsockoption() by @dkloper in #12
- Avoid duplicate symbols in edk2 and edk2-libc by @serge-s in #16
- Build SoftFloat with MSVC by @serge-s in #17
- Update my GH username in CODEOWNERS and CONTRIBUTORS.md by @bexcran in #19
- StdLib/ARM: Fix compilation dependencies by @MarsDoge in #18
- Fix for GitHub Actions failing for GCC build tools by @jpshivakavi in #23
- edk2-libc: add github workflow to build app efi with GCC by @MarsDoge in #21
- Create build-python-uefi-ia32-vs.yaml by @EnricoEng in #78
- StdLib: Fix compilation dependencies by @MarsDoge in #81
- edk2-libc/Readme.md: Update to remove reference to bugzilla by @jpshivakavi in #83
- edk2-libc: Add manual dispatch for the Python UEFI build actions by @jpshivakavi in #90
- AppPkg: Make the Python app easier to build by @makubacki in #93
New Contributors
- @dkloper made their first contribution in #12
- @serge-s made their first contribution in #16
- @bexcran made their first contribution in #19
- @MarsDoge made their first contribution in #18
- @jpshivakavi made their first contribution in #23
- @EnricoEng made their first contribution in #78
- @makubacki made their first contribution in #93
Full Changelog: v3.6.8.1...v3.6.8.2
Download Links
The release binaries are available at the below links for downloading:
Artifacts built using VS2022 tool chain : https://github.com/tianocore/edk2-libc/actions/runs/24546761494/artifacts/6488444840
You may use one of these packages for your work from UEFI shell using the Python programming language.
Usage Instructions:
- Download the zipped artifact from one of the above paths.
- Unzip the zip file using any of the standard zip utilities
- Copy the EFI folder from the unzipped folder to a USB thumb drive, ensure that EFI folder is available at the root of the thumb drive.
- Ensure that the thumb drive is formatted with FA32 file system before copying the EFI folder.
- Connect / insert the thumb drive to a system under test (SUT) and boot the SUT to UEFI shell.
- Switch to the right file system such as FS0: or FS1: and so on depending on how your USB thumb drive has been enumerated by the shell.
- Start using the Python interpreter in interactive mode or in command line mode.
Alternatively you could create a FAT32 partition on your system and copy the contents of the EFI folder from the above package to this partition. This partition will be visible to the UEFI shell as a file system such as FS1 / FS2 depending on how the UEFI environment enumerates.