Skip to content
OS2WorldPublic

About

OX2 is an OS/2 device driver which directs output to the AUX device to the monochrome monitor in a two-monitor system.

Topics

Resources

Stars

1 star

Watchers

2 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OX2

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

Build

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

Install

  1. Back up CONFIG.SYS and know how to restore it: a bad driver can stop the boot.
  2. Copy ox2.sys somewhere (for example C:\OX2) and add DEVICE=C:\OX2\OX2.SYS [parameters].
  3. Reboot. Write to the AUX device from any program, for example dir /w > AUX or make > AUX; see doc\OX2.TXT for more uses.

Parameters and boot messages

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 / test

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).

Known issues

  • 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.
  • /W and /AA act during driver initialisation only.
  • The build date shown by /V is typed into src\ox2.asm (the assembler has no portable __DATE__).

Links

Changelog

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).

About

OX2 is an OS/2 device driver which directs output to the AUX device to the monochrome monitor in a two-monitor system.

Topics

Resources

Stars

1 star

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages