Skip to content

Latest commit

 

History

History
26 lines (18 loc) · 1.22 KB

VSUserGuide.md

File metadata and controls

26 lines (18 loc) · 1.22 KB
Raw

VS/Emua User Guide

VS/Emua is a basic user-level AOS/VS emulator designed to run Ring 7 user programs to test and aid the enhancement of the bare-metal MV/Emua machine emulator (with which it shares a lot of code).

Build

gprbuild -Pvsemua

Run

./vsemua -pr LOOPS4.PR -root FILESYSTEM -dir :SAMPLES

You must specify...

  • The root of the virtual (AOS/VS) filesystem as a local (eg. Linux) path
  • The AOS/VS working directory as a complete AOS/VS path from the root
  • The absolute or relative AOS/VS name of the program file to run, in AOS/VS format

Note that program names beginning with a colon are considered absolute and must contain a valid AOS/VS path from the virtual root. Conversely, program names without a leading colon are looked for relative to the AOS/VS directory specified via the -dir option. Thus, these two invocations are equivalent:

  1. ./vsemua -pr LOOPS4.PR -root FILESYSTEM -dir :SAMPLES
  2. ./vsemua -pr :SAMPLES:LOOPS4.PR -root FILESYSTEM -dir :SAMPLES

(There is not yet any concept of AOS/VS searchlists implemented.)

After starting the emulated program you must connect a DASHER-compatible terminal emulator to port 10000 (default). DasherG is known to work.