diff --git a/README.md b/README.md index eb15fe7..95d62be 100644 --- a/README.md +++ b/README.md @@ -7,7 +7,7 @@ This repository contains firmware files for the Apple-1 Serial Interface expansi This project aims to provide alternative to the ACI for the Apple-1 replica or original boards owners via use of the serial communication (9600/8-N-1). The project is based around ATMega328P MCU which operates as half-duplex UART. -# Memory map +## Memory map | address | function | | --- | --- | @@ -15,13 +15,13 @@ The project is based around ATMega328P MCU which operates as half-duplex UART. | `$C300` | "teletype on apple-1" test program - the data from remote terminal appears on Apple-1 screen | | `$C400` | "teletype on remote" test program - the data from Apple-1 appears on remote terminal | | `$C500` | 0-255 repeating counter - all possible bytes are repeatedly sent to remote terminal | -| `$C600` | serialmonitor - the well known Woz Monitor, but now you type on the remote terminal | +| `$C600` | serialmonitor - the well known Woz Monitor, but now on the remote terminal | entries for programmers: | address | function | | --- | --- | -| `$C000` | ready flag - contains 0x00 if the device is ready to write/read byte | +| `$C000` | ready flag - contains 0x01 if the device is ready to write/read byte, 0x00 otherwise | | `$C080` | read address - the location for data read from the interface, first read of this address switches the device to read mode | | `$C081` | write address - the location for data to be written via the interface, first write to this address switches the device to read mode | | `$C23A` | software reset routine - resets the MCU | @@ -37,15 +37,15 @@ entries for programmers: The contents of this repository are as following: -firmware/ - contains source code for the ATMega328 MCU firmware -mapping/ - contains EQN and JED files for GAL20V8 based address decoder for the board -src/ - contains the 6502 assembly sources for the A1SI onboard ROM routines +* firmware/ - contains source code for the ATMega328 MCU firmware +* mapping/ - contains EQN and JED files for GAL20V8 based address decoder for the board +* src/ - contains the 6502 assembly sources for the A1SI onboard ROM routines ## Requirements -You need the following to sucessfully build the firmware: +You need the following to successfully build the firmware: -* [xa](https://www.floodgap.com/retrotech/xa/) cross assembler software +* [xa](https://www.floodgap.com/retrotech/xa/) cross assembler * [avr-gcc](https://gcc.gnu.org/wiki/avr-gcc) toolchain * [avr-libc](https://www.nongnu.org/avr-libc/) set of libraries * [AVRDUDE](https://www.nongnu.org/avrdude/) AVR programmer software or equivalent @@ -62,8 +62,15 @@ And to clean the build: `make clean` -# PCB +## PCB The KiCad project files with board design and schematics can be found here: http://github.com/flowenol/Apple1SerialPcb + +## Applesoft BASIC support + +You can also `LOAD` and `SAVE` your Applesoft BASIC programs thanks to the branch of the +applesoft-lite project which has been modified to make use of the A1SI expansion card: + +http://github.com/flowenol/applesoft-lite