Skip to content

Latest commit

 

History

History
29 lines (21 loc) · 1.73 KB

README.md

File metadata and controls

29 lines (21 loc) · 1.73 KB

CrScreenshotDxe

UEFI DXE driver to take screenshots from GOP-compatible graphic consoles.

This blog post in Russian explains more, here is just a description and usage.

Description

This DXE driver tries to register keyboard shortcut (F10) handler for all text input devices. The handler tries to find a writable FS preferring OpenCore root if available, finds primary GOP device, takes screenshot from it and saves the result as PNG files on that writable FS.

The main goal is to be able to make BIOS Setup screenshots for systems without serial console redirection support, but it can also be used to take screenshot from UEFI shell, UEFI apps and UEFI bootloaders.

To start the driver, you can either:

  • Install the driver via OpenCore
  • Integrate it into DXE volume of your UEFI firmware using UEFITool or any other suitable software (don't forget a DepEx section to prevent too early start)
  • Add it to an OptionROM of a PCIe device (will try it once I have a device needed)
  • Let BDS dispatcher load it by copying it to ESP and creating a DriverXXXX variable
  • Load it from UEFI Shell with load command

Build

It's a normal EDK2-compatible DXE driver, just add it to your package's DSC file to include in the build process.

Usage

Load the driver, insert FAT32-formatted USB drive and press F10 to take screenshots from primary graphic console available at the moment.

To indicate it's status, the driver shows a small colored rectangle in top-left corner of the screen for half a second.

Rectangle color codes:

  • Yellow - no writable FS found, screenshot is not taken
  • Red - something went wrong, screenshot is not taken
  • Green - screnshot taken and saved to PNG file