WangEmu Quick Start Guide

This is a brief how-to guide in getting up and running quickly with WangEmu. There are many configuration options and two major operating modes; besides, being a faithful emulator, WangEmu is bounded by the complexity that was inherent in the Wang 2200 system itself.

The first two sections, of course, are largely irrelevant if this help is being run from WangEmu's help file itself of course.

Unpacking the .zip file

The WangEmu program and an associated files are distributed as a zip file called something like wangemu_3.0.zip. The files contained in the zip file are all tucked into a directory called WangEmu3.0. Thus when you unpack, the location you specify for saving the zip file contents will receive that folder, not the myriad files contained within. This file can be unzipped to any location as WangEmu doesn't care where it runs from.

The resulting directory structure looks this:

WangEmu3.0/
    disks/          -- wang virtual disk images
        *.wvd
    html/           -- help files
        *.html
    scripts/        -- scripts
        *.w22
    src/            -- source code
        *.cpp
        *.h
        *.rc
    build.txt       -- rough guide to building the emulator from source
    code.txt        -- description of the program structure
    LICENSE         -- the code is provided under an MIT license
    README.md       -- markdown README from github project description
    makefile        -- for building on OSX
    relnotes.txt    -- release notes
    wangemu.sln     -- MS Visual Studio 2017 build file
    wangemu.vcxproj -- MS Visual Studio 2017 build file
    wangemu.exe     -- the application

You don't need to know anything about the source code or the build files. They are there in case you are curious and want to have a look, or if you are ambitious and want to make changes to the emulator.

The folders called disks and scripts contain programs that can be loaded by the emulator to give you something to play with right off the bat.

Launching WangEmu for the first time

The application can be run by double clicking on the executable called "WangEmu" in the folder that was created when the downloaded file was unpacked.

The first time WangEmu is run, an warning message will appear:

placeholder

This is normal and can be ignored. It is simply indicating that the file containing the user's preferences couldn't be found. If this message appears after the emulator is configured, it is an indication that something is amiss, such as the file couldn't be saved after the first run because the user doesn't have write permission.

The default configuration is to have

Every time WangEmu exits, all the users preferences are saved in a file called wangemu.ini. It is an ASCII text file, but it should not be directly edited otherwise the configuration might get corrupted; if so, delete the file and reconfigure the emulator as if it was the first time the emulator was run. This file is located in the same directory as the executable.

Configuring for 2200 VP Mode

The default configuration comes up in 2200T mode, which has Wang BASIC in ROM. The emulator is ready to run programs.

If the user prefers a 2200 VP configuration running Wang BASIC-2, a few more steps are required.

From the Configure menu item, select Configure System.... There is a choice box in the upper left corner that reads "CPU: 2200T". Change that to read "CPU: 2200VP". You can also adjust how much RAM the system is configured for in the pulldown box just below the CPU choice. Click the OK button.

Also, you have the option of picking other CPU types: MVP-C, or MicroVP. One of these is required if you want to run an MVP operating system. If this is the case, you will also need to unmap the 6367 keyboard controller and the 6312A CRT controller. Instead, pick a 2236 MXD terminal controller, at address /000.

Unlike the first generation machines, the VP series didn't have BASIC in ROM. Instead, the BASIC-2 microcode had to be loaded from disk. The same is true for the emulator.

  1. From the Disk menu, select Drive F/310: Insert. A standard dialog box for selecting a file should appear.
  2. Navigate into the "disks" subdirectory of wherever the emulator was installed.
  3. Select the disk vp-boot-2.3.wvd, for example.
  4. Perform a warm reset of the machine, just like a real machine. One way to do it is to open the CPU menu and select the Reset CPU item. Alternately, you can type Shift-Alt-R.
    You should now see a prompt that reads
        KEY SF'?
    This prompt allows triggering a load of one of a handful of microcode images from one of a number of disk drives.
  5. For our purpose, we want Special Function key 0, which can be triggered by hitting the ESC key. After a few seconds you should see
        Loading:  VP BASIC-2 Release 2.3
    then a few seconds later,
        READY  (BASIC-2)
        :_

You are now ready to run some BASIC-2 programs.

Loading a Script

At this point you may type some commands or enter an entire program. WangEmu comes with some program sources to demonstrate some features of Wang BASIC or to simply allow having some fun.

To load a script (which works by reading an ASCII file and having the emulator pretend the user is a really fast typist), follow these steps.

  1. Open the File menu and select the Script... item. A standard file dialog box will appear.
  2. Navigate to the "scripts" subdirectory of wherever the emulator was installed.
  3. Select a program; for example, chose primes.w22. Very rapidly the screen should fill with the text of the program that was just selected.
  4. When the program is done being read in, type RUN and hit ENTER to start running the chosen program.
  5. To halt the program you can reset the machine (from the CPU menu) or you can hit the emulated HALT/STEP key. This is done by pressing the BREAK key, or equivalently, typing Ctrl-S.

You can create your own script files with any text editor that can produce an ASCII file. Simply type in the program and use the File/Script... feature.