diff --git a/README.md b/README.md index ce3f417..6081083 100644 --- a/README.md +++ b/README.md @@ -27,6 +27,49 @@ HELLO WORLD > ``` + +If you want to load cassette storage into memory, you're going to need to uze Woz'z ACI. To do that, run +``` +C100R +``` +to start the cassette interface. Now suppose we wanted to store the contents of memory from address `0xE000` to `0xEFFF`. To do that, you would type afterwards +``` +E000.EFFFW +``` +Hit enter after typing the command. Now, within 10 seconds type the `|` (pipe) character to pause the emulator. The emulator will display the last reads and writes into memory of the previous opcode. Now type +``` +tstart write +resume +``` +which starts the emulated cassette. After waiting a few seconds, you will be greeted with a `\` prompt again, meaning you have returned to the monitor. Type `|` once again, but this time, type the following 2 commands +``` +tstop +tstore SOME_FILE +resume +``` +This stores in the same directory as the executable a file named `SOME_FILE` which can be read from using the cassette interface. + +Suppose we wanted to read that file into the same memory addresses we had stored it from. First, we would enter the ACI again using +``` +C100R +``` +and then type +``` +E000.EFFFR +``` +but DON'T PRESS ENTER. We need to start the cassette tape playing back again before we finish giving this command to the ACI. Type `|` to pause the emulator. Then run +``` +tload SOME_FILE +tstart read +resume +``` +After entering the `resume` command, press enter one more time to finish giving telling the ACI to read to `0xE000`. After a few seconds, you should be greeted by `\`. At this point, press `|` to pause emulation and type +``` +tstop +resume +``` +The contents of addresses `0xE000` to `0xEFFF` should now be the same as the contents originally stored onto the file using the ACI. + It functions exactly like the original Apple 1. To learn how to use Apple 1 basic, go here: https://archive.org/details/apple1_basic_manual/page/n11 Here is a good place to learn more about the Apple 1 computer: https://www.sbprojects.net/projects/apple1/