Add applesfot-lite link to README.md
This commit is contained in:
parent
e5bdcbb965
commit
95e03b38b5
25
README.md
25
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).
|
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.
|
The project is based around ATMega328P MCU which operates as half-duplex UART.
|
||||||
|
|
||||||
# Memory map
|
## Memory map
|
||||||
|
|
||||||
| address | function |
|
| 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 |
|
| `$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 |
|
| `$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 |
|
| `$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:
|
entries for programmers:
|
||||||
|
|
||||||
| address | function |
|
| 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 |
|
| `$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 |
|
| `$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 |
|
| `$C23A` | software reset routine - resets the MCU |
|
||||||
|
@ -37,15 +37,15 @@ entries for programmers:
|
||||||
|
|
||||||
The contents of this repository are as following:
|
The contents of this repository are as following:
|
||||||
|
|
||||||
firmware/ - contains source code for the ATMega328 MCU firmware
|
* firmware/ - contains source code for the ATMega328 MCU firmware
|
||||||
mapping/ - contains EQN and JED files for GAL20V8 based address decoder for the board
|
* 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
|
* src/ - contains the 6502 assembly sources for the A1SI onboard ROM routines
|
||||||
|
|
||||||
## Requirements
|
## 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-gcc](https://gcc.gnu.org/wiki/avr-gcc) toolchain
|
||||||
* [avr-libc](https://www.nongnu.org/avr-libc/) set of libraries
|
* [avr-libc](https://www.nongnu.org/avr-libc/) set of libraries
|
||||||
* [AVRDUDE](https://www.nongnu.org/avrdude/) AVR programmer software or equivalent
|
* [AVRDUDE](https://www.nongnu.org/avrdude/) AVR programmer software or equivalent
|
||||||
|
@ -62,8 +62,15 @@ And to clean the build:
|
||||||
|
|
||||||
`make clean`
|
`make clean`
|
||||||
|
|
||||||
# PCB
|
## PCB
|
||||||
|
|
||||||
The KiCad project files with board design and schematics can be found here:
|
The KiCad project files with board design and schematics can be found here:
|
||||||
|
|
||||||
http://github.com/flowenol/Apple1SerialPcb
|
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
|
||||||
|
|
Loading…
Reference in New Issue