From: Michael Stapelberg <michael@stapelberg.de>
Date: Sun, 24 Sep 2017 13:56:40 +0000 (+0200)
Subject: Add README.md
X-Git-Tag: rgb2rv17~19
X-Git-Url: https://git.sur5r.net/?p=c128-kasse;a=commitdiff_plain;h=7a813b2161441c353ba6e2966d1c88fbb5a1fc6e

Add README.md
---

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..fe5591b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+## Emulator
+
+### Emulator installation
+
+On Debian and derivatives, install the `vice` package:
+
+```
+apt install vice
+```
+
+Install `/usr/lib/vice/C128/kernal*` and `/usr/lib/vice/C128/charg*` (ask contributors for a copy).
+
+### Emulator configuration
+
+Enable the following options in x128:
+* Settings → Drive settings → drive #8 options → enable IEC device
+* Settings → Printer settings → Printer #4 enable IEC device
+* Settings → Printer settings → Printer #4 emulation → File system access
+
+Alternatively, configure the following values in `~/.vice/vicerc` (which you
+can create by selecting the menu entry “Settings” → “Save settings”):
+```
+IECDevice4=1
+IECDevice8=1
+Printer4=1
+```
+
+### Running the emulator
+
+```
+x128 -autostart kasse.d64
+```
+
+## Reading files from the floppy (disk image)
+
+To view the contents of a file within a disk image (e.g. the logfile), use:
+
+```
+c1541 -attach kasse.d64 -read "log-2" >(petcat -nh) >&-
+```