# VPX + AWE32 devices — DOSBox-X integration

Our original source for the emulated pod hardware. Kept here under
version control because the DOSBox-X source tree itself
(`emulator/src/`, ~490 MB) is git-ignored.

- **`vpxlog.cpp`** — the Division VPX link adapter (INMOS C012 at I/O base
  `0x150`), grown through Phase 3: iserver handshake responder, FIFO scene
  decode, GL Division renderer (gallery shading model), VDB video-head
  splitter windows.
- **`vweawe.cpp`** — the dual-AWE32 sound device: two vendored EMU8000
  cores at 0x620/0x640 (+0x400/+0x800 triplets), rear-card DSP/mixer stub
  at 0x240, autonomous render thread with direct winmm output. Needs the
  GM ROM (`emulator/roms/awe32.raw`) via `VWE_AWE_ROM` or SoundFont
  uploads are refused (banks declare `irom=1MGM`). See
  `emulator/SOUND-NOTES.md`.
- **`emu8k.cpp` / `emu8k.h` / `emu8k_shim.h`** — EMU8000 wavetable core
  vendored from 86Box (GPL-2.0-or-later, same license as DOSBox-X), with
  a minimal shim; local changes are listed in the emu8k.cpp header.
- **`serialnamedpipe.cpp` / `serialnamedpipe.h`** — `serial<n>=namedpipe
  pipe:<name>` backend (2026-07-12): serial-over-named-pipe for vRIO/vPLASMA,
  replacing com0com. DOSBox is the pipe CLIENT with 500ms background retry;
  typed frames carry data (`0x00 len bytes`) and DTR/RTS line state (`0x01
  bits`); the full wire contract is in the header comment (pinned with the
  vRIO session). Supports the directserial `rxpollus`/`rxburst`/`rxdelay`
  low-latency knobs. Smoke-tested end-to-end 2026-07-12.

## Applying to a DOSBox-X source checkout

Tested against DOSBox-X `v2026.06.02`, MSYS2 mingw64.

1. Copy the devices in:
   ```
   cp emulator/vpx-device/vpxlog.cpp   emulator/src/src/hardware/
   cp emulator/vpx-device/emu8k.cpp    emulator/src/src/hardware/
   cp emulator/vpx-device/emu8k.h      emulator/src/src/hardware/
   cp emulator/vpx-device/emu8k_shim.h emulator/src/src/hardware/
   cp emulator/vpx-device/vweawe.cpp   emulator/src/src/hardware/
   ```
2. Add them to the hardware build — in `src/src/hardware/Makefile.am`, append
   `vpxlog.cpp emu8k.cpp vweawe.cpp` to `libhardware_a_SOURCES` (we inserted
   them after `glide.cpp`; if you edit the generated `Makefile`/`Makefile.in`
   by hand instead of re-running automake, also mirror the `$(OBJEXT)` list,
   the `.Po` depfile list, and the depfile include markers — grep for how
   `vpxlog` appears and copy the pattern).
3. Call the inits — in `src/src/gui/sdlmain.cpp`, declare `void VPXLOG_Init();`
   and `void VWEAWE_Init();` next to the other `*_Init()` prototypes; call
   `VPXLOG_Init();` right after `GLIDE_Init();` and `VWEAWE_Init();` right
   after `SBLASTER_Init();` (it needs the mixer initialized).
3b. The namedpipe serial backend:
   ```
   cp emulator/vpx-device/serialnamedpipe.cpp emulator/src/src/hardware/serialport/
   cp emulator/vpx-device/serialnamedpipe.h   emulator/src/src/hardware/serialport/
   ```
   plus four small stock edits:
   - `src/src/hardware/serialport/Makefile.am`: append
     `serialnamedpipe.cpp serialnamedpipe.h` to `libserial_a_SOURCES`
     (same generated-Makefile caveat as step 2).
   - `src/include/serialport.h`: add `SERIAL_TYPE_NAMED_PIPE` to
     `SerialTypesE` under `#if defined(WIN32)` (before
     `SERIAL_TYPE_DIRECT_SERIAL`).
   - `src/src/hardware/serialport/serialport.cpp`: `#include
     "serialnamedpipe.h"`; add the `type=="namedpipe"` case to BOTH dispatch
     switches (SERIALPORTS ctor + the SERIAL command) and `"namedpipe"` to
     the `serialTypes[]` string table — grep for how `"file"` appears and
     copy the pattern.
   - `src/src/dosbox.cpp`: add `"namedpipe"` to the `serials[]` allowed-values
     list (without this the config parser silently falls back to `dummy`).
4. Build:
   ```
   cd emulator/src
   ./build-mingw-sdl2 --enable-debug=heavy
   ```
   Output: `src/src/dosbox-x.exe`.

## Running

```
set VPXLOG=C:\VWE\TeslaRel410\emulator\vpxlog.txt
emulator\src\src\dosbox-x.exe -conf emulator\capture.conf
python emulator\analyze_capture.py
```

With `VPXLOG` unset the device is inert and the build behaves like stock
DOSBox-X.