git.sur5r.net Git - c128-kasse/blob - 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 mkdir -p ~/.vice
  15 tar xf vice-3.1.tar.gz -C ~/.vice/ vice-3.1/data --strip-components=2
  16 ```
  17
  18 ### Emulator configuration
  19
  20 Enable the following options in x128:
  21 * Settings → Drive settings → drive #8 options → enable IEC device
  22 * Settings → Printer settings → Printer #4 enable IEC device
  23 * Settings → Printer settings → Printer #4 emulation → File system access
  24
  25 Alternatively, configure the following values in `~/.vice/vicerc` (which you
  26 can create by selecting the menu entry “Settings” → “Save settings”):
  27 ```
  28 [C128]
  29 IECDevice4=1
  30 IECDevice8=1
  31 Printer4=1
  32 ```
  33
  34 ### Compiling the software into an image
  35
  36 ```
  37 make package
  38 ```
  39
  40 ### Running the emulator
  41
  42 ```
  43 make vice
  44 ```
  45
  46 Then, type `run`, followed by enter.
  47
  48 ## Reading files from the floppy (disk image)
  49
  50 To view the contents of a file within a disk image (e.g. the logfile), use:
  51
  52 ```
  53 c1541 -attach kasse.d64 -read "log-2" >(petcat -nh) >&-
  54 ```