jwdpmi_test

This repository contains several applications to test and demonstrate the use of libjwdpmi. It also serves as a project template to start developing and debugging DPMI programs in Visual Studio.

Test programs:

hello

A simple "Hello World" application.

game

A basic video game where you control a character using the joystick or keyboard. Demonstrates the use of timers, vectors, remapped DOS memory, keyboard and joystick, etc.

vbe

Displays an animation with real-time alpha-blending, using both integer (MMX) and floating-point (SSE) math. Demonstrates the VBE graphics interface and pixel layout structures.

keys

Application to test keyboard functionality.

ring0

Application to test ring 0 access.

To build:

• Build and install gcc with --target=i686-pc-msdosdjgpp-g++.
• Clone this repo with its submodule:

$ git clone https://github.com/jwt27/jwdpmi_test.git
$ cd jwdpmi_test/
$ git submodule update --init

• Build:

$ make -j all                       # build all subprograms
$ make -j hello                     # build only "Hello World"
$ make -j hello FDD=/media/floppy   # build "Hello World" and copy it to a floppy disk

To build with Visual Studio:

• Install Visual Studio 2019.
• Build and install i686-pc-msdosdjgpp-g++ with mingw64.
• Set up two global environment variables:

> setx MSYS2_ROOT C:\msys64		# Where you installed MSYS2
> setx MSYS2_DJGPP /usr/local/cross	# Where you installed gcc (`--prefix=...`)

• Build and install gcc2vs.
• Open this project in Visual Studio by selecting "Open Folder".
• Select a startup item.
• Press Ctrl-B to build.

To debug with Visual Studio:

• Make sure you have a cross-gdb installed in %MSYS2_DJGPP%/bin/i686-pc-msdosdjgpp-gdb.
• Connect your target machine with a serial null-modem cable on COM1.
• Select hello (remote COM1) as startup item in VS.
• Build and copy hello.exe to the target machine.
• Launch the target with hello.exe --debug.
• Hit F5 in Visual Studio. Have fun.