mirror of
https://github.com/flowenol/apple1cartridge.git
synced 2024-10-31 11:08:37 +00:00
Added bill of materials to README.md
This commit is contained in:
parent
a63abe3a7f
commit
56113b8846
50
README.md
50
README.md
@ -9,25 +9,25 @@ This repository contains firmware and gerber files for the "Apple-1 RAM/ROM Cart
|
||||
This project aims to equip Apple-1 users with a quick way to expand RAM capacity in their systems up to 52 KB and to simultaneously
|
||||
store Apple-1 programs in ~30KB of on-board ROM, which can be banked in and out via software. The on-board ROM also contains a loader
|
||||
program which is capable of loading programs spanning across noncontinuous memory locations. You can either use a default loader
|
||||
program `4000R`, which displays the list of all available program entries, or the fast loader program `4300R`, which loads the
|
||||
specific program entry automatically.
|
||||
program at `4000R`, which displays the list of all available program entries, or the fast loader program at `4300R`, which loads the
|
||||
specific program entry (selected in ZP variable at `$00`) automatically.
|
||||
|
||||
The A1C expansion card allows to completely disable the ROM/loader functionality (which takes up to 2 KB of memory at `$4000-$47FF`)
|
||||
via physical switch and to provide continuous 44KB wide RAM address space instead (`$1000-$BFFF`). This can be done while the
|
||||
system is running, thus after a program is loaded, one can change the switch location disabling ROM banking functionality
|
||||
system is running, thus after a program is loaded, one can change the switch position disabling ROM banking functionality
|
||||
and use the entire memory address space as RAM.
|
||||
|
||||
Loader programs in ROM mode copy bytes sequentially from ROM to RAM locations described in the entries table, banking the ROM
|
||||
Loader programs in ROM mode copy bytes sequentially from ROM to RAM locations, as described in the entries table, banking the ROM
|
||||
in and out. Each entry may consist of several segments that can be loaded to non adjacent memory locations. For obvious reasons
|
||||
the address space between `$4000-$47FF` cannot be utilised at loading time, because it would require the loader program
|
||||
to overwrite itself in ROM.
|
||||
|
||||
The A1C expansion card in RAM mode works great in conjunction with [Apple-1 Serial Interface](http://github.com/flowenol/apple11serial)
|
||||
card or the original ACI, expanding the available address space to load programs.
|
||||
The A1C expansion card in RAM mode works great in conjunction with [Apple-1 Serial Interface](http://github.com/flowenol/apple1serial)
|
||||
card or the original Apple Cassette Interface, expanding the available address space to load programs.
|
||||
|
||||
## Memory map
|
||||
|
||||
With physical switch in ROM mode:
|
||||
With physical switch in ROM position:
|
||||
|
||||
| address | function |
|
||||
| --- | --- |
|
||||
@ -39,7 +39,7 @@ With physical switch in ROM mode:
|
||||
| `$4800-$BFFF` | RAM region #2 when ROM banked out |
|
||||
| `$4800-$BFFF` | ROM with program contents when ROM banked in |
|
||||
|
||||
With physical switch in RAM mode:
|
||||
With physical switch in RAM position:
|
||||
|
||||
| address | function |
|
||||
| --- | --- |
|
||||
@ -50,8 +50,8 @@ With physical switch in RAM mode:
|
||||
The contents of this repository are as following:
|
||||
|
||||
* gerber/ - gerber files needed to manufacture the PCB
|
||||
* inc/ - contains Apple-1 programs in binary format, the package is downloadable [here](https://drive.google.com/file/d/1G0ycKSszlr45RE8Rp6eW-0qxz4MS9qDN/view?usp=sharing)
|
||||
* mapping/ - contains EQN and JED files for GAL22V10 based address decoder
|
||||
* inc/ - contains Apple-1 programs in binary format, the archive is available [here](https://drive.google.com/file/d/1G0ycKSszlr45RE8Rp6eW-0qxz4MS9qDN/view?usp=sharing)
|
||||
* mapping/ - contains .eqn and .jed files for GAL22V10 based address decoder
|
||||
* scripts/ - a bunch of useful python scripts which do the conversion between binary and Woz monitor format and vice versa
|
||||
* src/ - contains the 6502 assembly sources for the on-board ROM loader programs
|
||||
|
||||
@ -60,8 +60,8 @@ The contents of this repository are as following:
|
||||
You need the following to successfully build and install the firmware:
|
||||
|
||||
* [xa](https://www.floodgap.com/retrotech/xa/) cross assembler
|
||||
* Some software capable of translating the EQN files into JED's. I used for this purpose the DOS based EQN2JED from OPALjr PLD Development Package. This is only required if you wish to make some changes to the GAL based address decoder. The default JED file should be fine for most users.
|
||||
* EEPROM programmer. I used [TL866](http://autoelectric.cn/EN/TL866_main.html) programmer for this purpose.
|
||||
* Software capable of translating the .eqn files into .jed's. I used for this purpose the DOS based EQN2JED from OPALjr PLD Development Package. This is only required if you wish to make some changes to the GAL based address decoder. The default .jed file should be fine for most users.
|
||||
* EEPROM programmer to write ROM and GAL. I used [TL866](http://autoelectric.cn/EN/TL866_main.html) programmer for this purpose.
|
||||
|
||||
## How to build?
|
||||
|
||||
@ -78,12 +78,6 @@ And to clean the build:
|
||||
In order to customise your ROM contents you have to edit the `src/rom_content.a65` source file. You can find the entry table structure
|
||||
documentation in the source file. Maximum of 99 entries is allowed, anything above that will be ignored.
|
||||
|
||||
## PCB
|
||||
|
||||
The KiCad project files with board design and schematics can be found here:
|
||||
|
||||
http://github.com/flowenol/Apple1CartridgePcb
|
||||
|
||||
## Applesoft BASIC support
|
||||
|
||||
The onboard ROM loader program can also automatically load your Applesoft BASIC programs thanks to the dedicated branch of the
|
||||
@ -97,3 +91,23 @@ Just put the board in right orientation (as marked on the PCB) in the Apple-1 ex
|
||||
Or you can use the port expander if the expansion slot on the Apple-1 board is already occupied:
|
||||
|
||||
https://github.com/flowenol/Apple1ExpanderPcb
|
||||
|
||||
## PCB
|
||||
|
||||
The KiCad project files with board design and schematics can be found here:
|
||||
|
||||
http://github.com/flowenol/Apple1CartridgePcb
|
||||
|
||||
|
||||
## Bill of materials
|
||||
|
||||
| name | part | quantity |
|
||||
| --- | --- | --- |
|
||||
| C1..C5 | Ceramic 100nF | 5 |
|
||||
| C6 | Electrolytic 22uF | 1 |
|
||||
| R1..R3 | 1K 0.5W | 3 |
|
||||
| BANK1 | 74LS74 dual D flip-flop DIP14 | 1 |
|
||||
| DECODER1 | GAL22V10 SPLD (25ns or less) DIP24 | 1 |
|
||||
| ROM1 | AT28C256 ROM or similar DIP-28 | 1 |
|
||||
| RAM1,RAM2 | 62256 SRAM 100ns or less DIP-28 | 2 |
|
||||
| MODE_SWITCH1 | 9x4mm SPDT switch | 1 |
|
||||
|
Loading…
Reference in New Issue
Block a user