Skip to content

Commit 52f9323

Browse files
committed
add README
1 parent e502d57 commit 52f9323

File tree

1 file changed

+32
-0
lines changed

1 file changed

+32
-0
lines changed

README.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
# 6502 Emulator
2+
3+
Yet another 6502 emulator, in typescript.
4+
5+
## How to run
6+
7+
The easiest way is with ts-node
8+
9+
```
10+
> npm install
11+
> npm install -g ts-node
12+
> ts-node index.ts roms/wozmon
13+
```
14+
15+
## Roms
16+
17+
2 Roms are included in `roms/` directory, with their code in `programs/`.
18+
19+
- inc-chars
20+
- echos all characters typed to the screen, incremented by 1, quickly coded during emulator development to test it
21+
- wozmon
22+
- The classic software by Woz, adapted for this emulator
23+
24+
## Memory map
25+
26+
The memory map is currently pretty simple:
27+
28+
| Addresses | Interface | Notes |
29+
| --------- | --------- | --------------------------------------------------------------------------------------------------------------------------- |
30+
| 0-6FFF | Ram | |
31+
| 7000-7FFF | IO | Unrealistically implemented, but read from any address to read from input buffer, write to any address to output to console |
32+
| 8000-FFFF | Rom | loaded from the command line argument |

0 commit comments

Comments
 (0)