Difference between revisions of "Napple1"

From Maryville College CS Wiki
Jump to: navigation, search
(Emulator Commands)
(Emulator Commands)
Line 20: Line 20:
 
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:
 
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:
  
{| sytle="wikitable"
+
{| class="wikitable"
 
! Key !! Command !! Description
 
! Key !! Command !! Description
 
|-
 
|-

Revision as of 09:36, 2 November 2016

Introduction

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.

Setup

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:

 mkdir core

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.

Using napple1

To invoke the emulator, simply run the command:

 napple1

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.

Emulator Commands

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:

Key Command Description
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