Skip to content

Commit 4a85d9b

Browse files
author
none
committed
Slight improvements to doc, reduce base DRAM size for cb030
1 parent e4438b9 commit 4a85d9b

File tree

2 files changed

+37
-13
lines changed

2 files changed

+37
-13
lines changed

README.md

+36-12
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,64 @@
11
# py68k
2+
23
M68K emulator based on Musashi, with a Python device model
34

45
## 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.
66

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.
914

1015
## emulations
11-
py68k has a flexible device and target model that makes supporting new targets relatively easy.
1216

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.
1422

1523
### 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`.
1828

1929
### 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:
2133

2234
https://www.retrobrewcomputers.org/doku.php?id=boards:sbc:tiny68k:tiny68k_rev2
2335

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:
2541

2642
`./py68k.py --target tiny68k --diskfile t68k_cpm_disk.bin --eeprom T68kbug_r07.BIN`
2743

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.
3148

3249
https://www.retrobrewcomputers.org/doku.php?id=builderpages:plasmo:p90mb
3350

3451
Fetch the EPROM file with monitor, CP/M and BASIC, and run:
3552

3653
`./py68k --target p90mb --rom loader1_5+EhBasic+CPM.BIN`
3754

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+
3862
## Requirements
3963

4064
Python, with vt102, pyelftools and hexdump modules installed.

targets/cb030.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ def add_arguments(parser):
1111
help='ROM image')
1212
parser.add_argument('--dram-size',
1313
type=int,
14-
default=64,
14+
default=16,
1515
help='DRAM size; boards may have 16, 64 or 128M')
1616
parser.add_argument('--cf-width',
1717
type=int,

0 commit comments

Comments
 (0)