pcem

PCem

Download: Windows/Linux/vNext (Wise Global Solutions Mirror)

Latest version: v17 Changelog

PCem is licensed under GPL v2.0, see COPYING for more details.

You can submit patches on our forum. Before you do, please note the guidelines for submitting patches.

:exclamation: Note: NO COPYRIGHTED ROM FILES ARE INCLUDED NOR WILL THEY BE. PLEASE DO NOT ASK FOR THEM.

BSD and Linux supplement

You will need the following libraries and buildtools (and their dependencies):

• SDL2
• wxWidgets 3.x
• OpenAL
• CMake
• Ninja (Recommended, but you can use a Makefile generator if you prefer)
• CLang Toolchain

Open a terminal window, navigate to the PCem directory, create a build directory, then enter in that build directory:

Linux/BSD

cmake -G "Ninja" -DCMAKE_BUILD_TYPE=Release ..
ninja

then ./src/pcem to run.

BIOS ROM images, configuration files, and other data are stored in ~/.pcem. You can also create a .pcem folder with the Binary, and run it in a portable mode.

The configure options are specified below. They are in the format of -DOption=Value. Value under here is the default value.

…

If you are using -DCMAKE_BUILD_TYPE=Debug, there are some more debug options you can enable if needed

  -DPCEM_SLIRP_DEBUG=OFF           : Build PCem with SLIRP_DEBUG debug output
  -DPCEM_RECOMPILER_DEBUG=OFF      : Build PCem with RECOMPILER_DEBUG debug output
  -DPCEM_NE2000_DEBUG=OFF          : Build PCem with NE2000_DEBUG debug output
  -DPCEM_EMU8K_DEBUG_REGISTERS=OFF : Build PCem with EMU8K_DEBUG_REGISTERS debug output
  -DPCEM_SB_DSP_RECORD_DEBUG=OFF   : Build PCem with SB_DSP_RECORD_DEBUG debug output
  -DPCEM_MACH64_DEBUG=OFF          : Build PCem with MACH64_DEBUG debug output
  -DPCEM_DEBUG_EXTRA=OFF           : Build PCem with DEBUG_EXTRA debug output

If you are using -DCMAKE_BUILD_TYPE=RelWithDebInfo, there are additional options you can do

  -DPCEM_RELDEB_AS_RELEASE=ON     : Builds RelWithDebInfo with debugging logging enabled when this is off

They are some extra modules you can add if you build with -DUSE_EXPERIMENTAL=ON. These modules are untested. incomplete, and may or may not be in a future build of PCem. We do not provide builds with these enabled as well. It is also possible they may not even build.

  -DUSE_EXPERIMENTAL_PGC=ON       : Build PCem with Professional Graphics Controller support.
  -DUSE_EXPERIMENTAL_PRINTER=ON   : Build PCem with Printer support. Requires freetype.

The menu is a pop-up menu in the Linux/BSD port. Right-click on the main window when mouse is not captured.

CD-ROM support currently only accesses /dev/cdrom. It has not been heavily tested.

On Windows, if you want to use PCAP networking, you will need to install npcap and replace the libpcap.dll in PCem dir using the wpcap.dll installed in C:\Windows\System32

Links

PCem emulates the following hardware:

Software Tested (list)

• DOS
  
• Windows
  
• Windows NT
  
• OS/2
  
• Linux
  
• Applications
  
• Games
  
• Demos
  
• Emulators
  

Systems

8088 based

8086 based

286 based