OX2 is an OS/2 device driver that directs output written to the AUX device to the monochrome
monitor of a two-monitor system (a colour adapter plus an MDA or Hercules monochrome adapter).
| Field | Details |
|---|---|
| Version | 0.20 (BLDLEVEL @#OS2World:0.20#@) |
| Status | Loads and runs on ArcaOS (writes to AUX are accepted, reads are refused as documented, boot messages follow the standard). The actual output on a monochrome display is untested: the test VM has no monochrome adapter. |
| Tested on | ArcaOS 5.1.1 Dev VM (VirtualBox), 2026-11-17. No real hardware. |
| License | Public domain, see LICENSE. |
| Authors | JWC (OX2, June 1989), parts by Mike Geary (from his DOS driver OX.SYS); OS2World (Open Watcom 2 build, boot messages, 2026) |
| Original source | OX2.ASM, OX2.DEF, OX2.TXT by JWC, 1989-06-21; git history of https://github.com/OS2World/DRV-OX2 (tag upstream-original = the original state) |
| Build tools | Open Watcom 2.0 (wasm, wlink, wmake); build with compile_wat.cmd |
From the project root on ArcaOS:
compile_wat.cmd
It sets the Watcom environment, runs wmake -f Makefile.wat, prints OK: bin\ox2.sys with its size
(or FAILED:) and writes compile.log. compile_wat.cmd clean removes bin\ and the log.
The source is MASM-style 16-bit assembler. It is assembled with Open Watcom's WASM (MASM compatible)
because rewriting it for NASM is not worth the risk for a 450-line driver; the only source change needed
was replacing MASM's RECORD/MASK constructs, which WASM does not support, by equates (see
doc\CHANGES.md). Exact link recipe (the one used by the uniaud16 driver), in Makefile.wat:
wasm -zq -fo=bin\ox2.obj src\ox2.asm
wlink name bin\ox2.sys system os2_dll option quiet,caseexact,map=bin\ox2.map
import DOSWRITE DOSCALLS.138 import DOSREAD DOSCALLS.137 import DOSBEEP DOSCALLS.50
file bin\ox2.obj
- Back up
CONFIG.SYSand know how to restore it: a bad driver can stop the boot. - Copy
ox2.syssomewhere (for exampleC:\OX2) and addDEVICE=C:\OX2\OX2.SYS [parameters]. - Reboot. Write to the
AUXdevice from any program, for exampledir /w > AUXormake > AUX; seedoc\OX2.TXTfor more uses.
Boot messages follow the EDM2 "Suggestion for OS/2 and eComStation Drivers Arguments": quiet by
default (only errors), every line starts with OX2: , errors read
OX2: OX2 could not be loaded. <reason>. All messages are shorter than 79 columns.
| Parameter | Effect |
|---|---|
/V |
print the version (OX2: Version 0.20 (2026-11-17); the date is typed into the source, update it at each release) |
/Q |
no messages at all, not even errors |
/W |
wait for a key after the messages |
/AA |
beep when the driver loaded |
Failure messages: invalid parameter, or the monochrome display memory (physical B0000) could not be mapped.
sample\ and test\ are empty. Test used on the Dev VM: add the DEVICE= line (with /V /W /AA,
then /Z, then /Q), reboot and read the boot screen, then run echo hello > AUX (accepted) and
type AUX (refused: the driver has no input).
- Output on a real monochrome adapter was not tested.
- From the original documentation (
doc\OX2.TXT): OS/2 may crash if a DOS-mode program writes to the device; the driver does its work at task time; it supports no input. /Wand/AAact during driver initialisation only.- The build date shown by
/Vis typed intosrc\ox2.asm(the assembler has no portable__DATE__).
- https://github.com/OS2World/DRV-OX2
doc\OX2.TXT: the original documentation by JWC
Newest first; details in doc/CHANGES.md.
- 0.20: Open Watcom 2 build (
compile_wat.cmd); standard boot messages and parameters; BLDLEVEL. - original: MASM 5.1 driver by JWC (June 1989).