https://github.com/ams/cadr4
CADR4 -- accurate model of the MIT CADR
https://github.com/ams/cadr4
cadr lisp lisp-machine lispmachine machine mit retrocomputing
Last synced: 2 days ago
JSON representation
CADR4 -- accurate model of the MIT CADR
- Host: GitHub
- URL: https://github.com/ams/cadr4
- Owner: ams
- License: agpl-3.0
- Created: 2023-10-30T16:55:38.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-12-30T12:15:20.000Z (over 1 year ago)
- Last Synced: 2023-12-30T13:26:56.754Z (over 1 year ago)
- Topics: cadr, lisp, lisp-machine, lispmachine, machine, mit, retrocomputing
- Language: VHDL
- Homepage: http://tumbleweed.nu/lm-3
- Size: 57.6 MB
- Stars: 4
- Watchers: 4
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: COPYING
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
# cadr4
Experiments of the third kind... This is an attempt at making a
faithful and accurate HDL implementation of CADR. There will be no
attempt at making this synthesizable!
## Random chit-chat
There is a IRC channel on irc.libera.net, ##lispm for random
chit-chat. Feel free to send bugs directly to [email protected].
## Setup
Prerequisites:
- [Fossil](https://fossil-scm.org)
- Git
- GNU Make
- [GHDL](http://ghdl.free.fr/)
Ideally using the GCC or LLVM code generator, since at some point there will be a simulatd UART to talk to the core.
- [GTKWave](https://gtkwave.sourceforge.net/), [vcd](https://github.com/yne/vcd) or some other VCD viewer.
```
cd ~/
fossil open https://tumbleweed.nu/r/hdlmake.mk
git clone https://github.com/ams/cadr4
cd cadr4
make help
```
If writing or testing CADR microcode, then it is useful to have [usim](https://tumbleweed.nu/r/usim) configured to be able to run [CADRLP](https://tumbleweed.nu/r/lm-3/uv/cadr.html#The-CADRLP-Assembler) or the CADR Console debugger (CC).
## Organization
- ttl (package): contains all the ICs that are used by the CADR.
* sn74: 74xx logic.
* other: other ICs that do not fall into above categories.
* unsorted: contains skeletons directly translated from the
schematics; these are to be deleted / merged at some point.
- cadr4 (package):
* cpu.vhd: contains a exact transliteration of the original CADR
schematics
* cadr4_tb.vhd: with a testbench that is capable of exercising the
CADR.
New documentation should be written in Markdown. At some point this
should be migrated back into the [Lisp Machine
Manual](https://tumbleweed.nu/r/lm-3/uv/chinual.html) or other
suitable places.