Thursday, March 12, 2026

CSMWrap: Enable Legacy BIOS Support on Modern UEFI PCs

"Do you yearn to run Windows XP, play vintage games, or utilize specialized software designed for older systems on your modern PC?
The transition from Legacy BIOS to UEFI has created a compatibility chasm, leaving many of us stranded.
But fear not, because a brilliant solution has emerged: CSMWrap."

"CSMWrap is an EFI application designed to be a drop-in solution to enable legacy BIOS booting on modern UEFI-only (class 3) systems. It achieves this by wrapping a Compatibility Support Module (CSM) build of the SeaBIOS project as an out-of-firmware EFI application, effectively creating a compatibility layer for traditional PC BIOS operation."

"That means you can boot classic operating like FreeDOS directly on newer EFI-only laptops and 
PCs. The developers "highly recommended that the partition table used is MBR" for compatibility."

Bring Back The BIOS! (To UEFI Systems, That Is): 
"At the dawn of the PC, IBM provided the Basic Input Output System (BIOS). It took care of bringing the machine up, and exposed a series of software hooks for the hardware. Over the years the BIOS and its updated descendants served us well, but as we entered a 64-bit world its limitations began to show.

The replacement was the Unified Extensible Firmware Interface or UEFI, and the chances are you're viewing this on a machine which uses it in some capacity. But what if you only have UEFI and need BIOS to run a piece of older software? Never fear, because here's CSMWrap, which brings it back, just for you.

Under the hood it's a wrapper for the SeaBIOS compatibility support module, doing the work of setting up the memory mapping such that it will load, and ensuring that other services such as the VGA BIOS are loaded. As it stands it can boot FreeDOS and some older Windows versions under UEFI in QEMU, and it's claimed also run on real hardware. We don't often need to run DOS on our 2025 machine, but it's neat to know we can.

Meanwhile if the BIOS interests you, know that there's also an open source BIOS for the earliest of PCs."

CSM wrap 2.0.0:  https://www.bttr-software.de/forum/forum_entry.php?id=23205

" PCI BAR Relocation - Automatically relocate PCI BARs from >4GB to <4GB, eliminating the need to disable "Above 4G Decoding" in UEFI settings.
PCIe Resizable BAR Support - Shrink large BARs (e.g., 4GB GPU VRAM) to 256MB using PCIe ReBAR capability, eliminating the need to disable "Resizable Bar/Smart Access Memory" in UEFI settings.
BIOS Proxy Helper Core - Dedicate an AP for BIOS calls from the BSP. This allows usage of CSMWrap with legacy OSes calling BIOS routines from Virtual 8086 Mode and other improvements.
MP Table Generation - Generate Intel MPS 1.4 tables from ACPI MADT for legacy OSes that don't support ACPI.
SMBIOS 3.0 → 2.x Synthesis - Generate SMBIOS 2.x entry point when only 3.0 is available.
Boot Device Detection - Auto-detect boot drive and build BBS table with correct priority."

No comments: