|
1 | 1 | # py68k
|
| 2 | + |
2 | 3 | M68K emulator based on Musashi, with a Python device model
|
3 | 4 |
|
4 | 5 | ## running
|
5 |
| -Launch the console server with `py68k.py --console-server`. This provides vt102 terminal emulation for the console serial port. The console server will stay alive across multiple runs of the emulator. |
6 | 6 |
|
7 |
| -Launch the emulator itself with `py68k.py --target <target-name> [<target-options>]`. You can pass |
8 |
| -`--help` with or without `--target`; if passed with, additional target-specific help may be printed. |
| 7 | +Launch the console server with `py68k.py --console-server`. This provides vt102 |
| 8 | +terminal emulation for the console serial port. The console server will stay |
| 9 | +alive across multiple runs of the emulator. |
| 10 | + |
| 11 | +Launch the emulator itself with `py68k.py --target <target-name> |
| 12 | +[<target-options>]`. You can pass `--help` with or without `--target`; if |
| 13 | +passed with, additional target-specific help may be printed. |
9 | 14 |
|
10 | 15 | ## emulations
|
11 |
| -py68k has a flexible device and target model that makes supporting new targets relatively easy. |
12 | 16 |
|
13 |
| -See `devices/` for some device examples, and `targets/` for corresponding targets. |
| 17 | +py68k has a flexible device and target model that makes supporting new targets |
| 18 | +relatively easy. |
| 19 | + |
| 20 | +See `devices/` for some device examples, and `targets/` for corresponding |
| 21 | +targets. |
14 | 22 |
|
15 | 23 | ### simple
|
16 |
| -The `simple` target is primarily for emulator testing, though being very simple it's also a good |
17 |
| -target for hosting software development. See `devices/simple.py` and `targets/simple.py`. |
| 24 | + |
| 25 | +The `simple` target is primarily for emulator testing, though being very simple |
| 26 | +it's also a good target for hosting software development. See |
| 27 | +`devices/simple.py` and `targets/simple.py`. |
18 | 28 |
|
19 | 29 | ### Tiny68k
|
20 |
| -Bill Shen's Tiny68k is a 68000 board with 16M of RAM and a 68681: |
| 30 | + |
| 31 | +Bill Shen's Tiny68k is a 68000 board with 16M of RAM and a 68681. The emulator |
| 32 | +supports the rev2 board: |
21 | 33 |
|
22 | 34 | https://www.retrobrewcomputers.org/doku.php?id=boards:sbc:tiny68k:tiny68k_rev2
|
23 | 35 |
|
24 |
| -Fetch the Tiny68K monitor / debugger image and CF CP/M image and run: |
| 36 | +Additional resources including CP/M images can be found on the rev1 page: |
| 37 | + |
| 38 | +https://www.retrobrewcomputers.org/doku.php?id=boards:sbc:tiny68k |
| 39 | + |
| 40 | +Fetch the Tiny68K monitor / debugger for v2 and CF CP/M disk image and run: |
25 | 41 |
|
26 | 42 | `./py68k.py --target tiny68k --diskfile t68k_cpm_disk.bin --eeprom T68kbug_r07.BIN`
|
27 | 43 |
|
28 |
| -### P90MB |
29 |
| -Bill Shen's P90MB features a Philips P90CE201 68070-based system-on-chip, 512k of flash, |
30 |
| -512k of RAM, I2C and three RC2014 slots. |
| 44 | +### P90MB (WIP) |
| 45 | + |
| 46 | +Bill Shen's P90MB features a Philips P90CE201 68070-based system-on-chip, 512k |
| 47 | +of flash, 512k of RAM, I2C and three RC2014 slots. |
31 | 48 |
|
32 | 49 | https://www.retrobrewcomputers.org/doku.php?id=builderpages:plasmo:p90mb
|
33 | 50 |
|
34 | 51 | Fetch the EPROM file with monitor, CP/M and BASIC, and run:
|
35 | 52 |
|
36 | 53 | `./py68k --target p90mb --rom loader1_5+EhBasic+CPM.BIN`
|
37 | 54 |
|
| 55 | +### CB030 (WIP) |
| 56 | + |
| 57 | +Another Bill Shen board, CB030 is a minimal 68030 system. |
| 58 | + |
| 59 | +This emulation has some serious issues due to limitations in Musashi's MMU |
| 60 | +emulation. |
| 61 | + |
38 | 62 | ## Requirements
|
39 | 63 |
|
40 | 64 | Python, with vt102, pyelftools and hexdump modules installed.
|
0 commit comments