Skip to content

Nepx's Halfix x86 PC emulator with improvements, supports Android!

License

Notifications You must be signed in to change notification settings

Pixelsuft/halfix

Repository files navigation

Halfix x86 emulator

Halfix is a portable x86 emulator written in C99. It allows you to run legacy operating systems on modern platforms.

Why?

I made this mostly for fun, and because it was a great way to learn about the x86 PC architecture. On a more practical level, it can be used for:

  • Testing out or developing operating systems
  • Running old programs or operating systems that no longer work on modern computers or you wouldn't want to risk running on your personal computer.
  • Simulating other x86-based systems (the CPU component can be isolated relatively easily and used in other projects)
  • Testing web browser performance

Building and Running

This fork is focused only on Windows compatibility for now. You will need a C++20 compatible compiler, zlib, cmake and Visual Studio 2022. Only 64 bit builds are supported.

  1. cd to the directory of halfix
  2. mkdir build && cd build
  3. cmake .. -G "Visual Studio 17 2022" -A x64 -Thost=x64
  4. Build the resulting solution file halfix.sln with Visual Studio

System Specifications

Compatibility

It boots a wide range of operating system software, including all versions of DOS, most versions of Windows (excluding Windows 8), newer versions of OS/2 Warp (3 and 4.5), ReactOS, some varieties of Linux (ISO Linux, Damn Small Linux, Red Star OS 2, Buildroot, Ubuntu), 9Front, NeXTSTEP, several hobby OSes, and probably more.

See Compatibility for more details.

Self-Virtualization

Can you run the emulator inside the emulator?

Yes, but not very quickly.

Halfix in Halfix

Screenshots

MS-DOS

DOS

OS/2 Warp 4.5

OS/2 Warp

Windows Vista

Vista

Windows 7

Windows 7

The same Windows 98 disk image as in the Halfix in Halfix screenshot running in Firefox

Win98

CPU-Z on Windows XP

CPU-Z

Windows 10

Win10

Ubuntu

Ubuntu

Transferring Files

Create a directory with all the files you want to transfer and create an ISO image.

mkisofs -o programs.iso -max-iso9660-filenames -iso-level 4 programs/

Now update the configuration file as follows:

# Note: it does not hae to be ata0-slave. 
# I have not tested it with anything but ata0-slave.
[ata0-slave]
inserted=1
type=cd
file=/tmp/programs.iso
driver=sync

Now boot up your operating system and copy the files from the CD-ROM to the hard drive.

Known Issues

  • SSE3 is not fully supported
  • Performance isn't terrible, but it isn't fantastic either (70-100 MIPS native, 10-30 MIPS browser)
  • Timing is completely off
  • Windows 8 doesn't boot (see this issue)
  • FPU exceptions are probably very incorrect
  • Most devices aren't complete, but enough is implemented to boot modern OSes.
  • The configuration file parser isn't very good

License

GNU General Public License version 3

Similar Projects

Credits

The FPU emulator uses an modified version of Berkeley SoftFloat from the Bochs emulator.

About

Nepx's Halfix x86 PC emulator with improvements, supports Android!

Resources

License

Stars

Watchers

Forks