This is a guide to using the apple 1 emulator installed on smc.cs.maryvillecollege.edu. This could also be used as a general guide to using napple1, but some of the information contained in here is specific to our installation. The emulator that we have installed is napple1. This is a port of the pom1 emulator (which is available for linux, windows, and android. Pom1 uses SDL to paint a graphical window which it uses to simulate the terminal screen of the Apple 1 computer. napple1, on the other hand, uses ncurses, which allows it to be executed from a linux terminal. Or, more importantly for our installation, it can be executed from within sage math cloud.
By default napple1 is meant to be installed in a user's home directory. We have a patched version which is installed system wide. What this means is that you don't have to copy the executable or roms to your home directory to use napple1.
You do need to do just a little bit of setup in your account to use napple1. Basically, all you need to do is create a directory called "core" in your home directory (or in whatever directory you wish to execute napple1 from.) To do this, simply execute the command:
This directory is used to store dumps of the napple1 memory, and without this you won't be able to store and retrieve your programs.
To invoke the emulator, simply run the command:
This will start the emulated apple 1 environment. One thing you may notice right away is that you can only type upper case letters. This is because the original apple 1 only allowed upper case input. Because you have no need of your shift key while typing, shift is napple1's special command character. So when you type without the shift key, you are providing input to the virtual apple 1 computer, and when you type a shifted character you are giving a command to the emulator.
The emulator commands allow you to do things like reset the emulator, and save and run RAM images. These aren't apple 1 commands, and really there for your convenience. The commands are:
|Shift + B||Basic Load||Load the BASIC ROM into RAM|
|Shift + D||Dump Core||Saves an image of the RAM/ROM to core/filename|
|Shift + L||Load Core||Loads an image of the RAM/ROM from core/filename|
|Shift + R||Reset||Resets the emulated CPU|
|Shift + Q||Quit||Quits the emulator|
|Shift + M||Mode||Change between 8KB and 32KB RAM Mode|