]> git.sur5r.net Git - c128-kasse/blob - README.md
README: document that one needs to “run”
[c128-kasse] / README.md
1 ## Emulator
2
3 ### Emulator installation
4
5 On Debian and derivatives, install the `vice` package:
6
7 ```
8 apt install vice
9 ```
10
11 Then, install the (not-included) ROMs:
12 ```
13 wget http://www.zimmers.net/anonftp/pub/cbm/crossplatform/emulators/VICE/vice-3.1.tar.gz
14 tar xf vice-3.1.tar.gz -C ~/.vice/ vice-3.1/data --strip-components=2
15 ```
16
17 ### Emulator configuration
18
19 Enable the following options in x128:
20 * Settings → Drive settings → drive #8 options → enable IEC device
21 * Settings → Printer settings → Printer #4 enable IEC device
22 * Settings → Printer settings → Printer #4 emulation → File system access
23
24 Alternatively, configure the following values in `~/.vice/vicerc` (which you
25 can create by selecting the menu entry “Settings” → “Save settings”):
26 ```
27 [C128]
28 IECDevice4=1
29 IECDevice8=1
30 Printer4=1
31 ```
32
33 ### Compiling the software into an image
34
35 ```
36 make package
37 ```
38
39 ### Running the emulator
40
41 ```
42 x128 -config vicerc -autostart kasse.d71 +go64 -80col
43 ```
44
45 Then, type `run`, followed by enter.
46
47 ## Reading files from the floppy (disk image)
48
49 To view the contents of a file within a disk image (e.g. the logfile), use:
50
51 ```
52 c1541 -attach kasse.d64 -read "log-2" >(petcat -nh) >&-
53 ```