README

   1
   2
   3                             Virtual Nascom
   4
   5                     A Nascom II emulator/simulator
   6
   7                        Version 1.9, 2009-11-21
   8
   9                             by Tommy Thorn
  10
  11                homepage: http://www.nascomhomepage.com
  12         git repository: http://repo.or.cz/w/virtual-nascom.git
  13
  14
  15
  16 This is a version 1.9 of Virtual Nascom, yet another Nascom II
  17 emulator. There's emulation support for nearly all the standard
  18 hardware and it runs nearly all of the software on the
  19 nascomhomepage.com (see KNOWN ISSUES below).
  20
  21 Version 1.9 switches from a (partially broken) X Window specific
  22 implementation to portable and more more robust SDL implementation. It
  23 also gained basic serial port support in the process.
  24
  25
  26 INSTALLATION
  27
  28 Virtual Nascom should compile on all platform with SDL support, but
  29 has only been tested on Mac OS X 10.5.7, Mac OS X 10.6.2, and Open
  30 SUSE 11.1/AMD64.
  31
  32 To compile you may have to adapt the Makefile with the libraries you
  33 need and their path, but generally it should be enough to simply run
  34
  35   $ make
  36
  37
  38
  39 USAGE
  40
  41 Usage: ./virtualnascom {flags} {commands}
  42            -i <file>       take serial port input from file (when tape led is on)
  43            -m <file>       use <file> as monitor (default is nassys3.nal)
  44            -v              verbose
  45
  46 VirtualNascom expects to find `nassys.nal' (unless you changed the
  47 monitor using the `-m' option) and `basic.nal' upon startup.  You can
  48 add files to be loaded by providing them as arguments at the end of
  49 the line.
  50
  51 For example to run Pac Man, run
  52
  53   $ ./virtualnascom programs/e1000/pacman.nas
  54
  55 and type E1000 in the Nascom II window. Control with arrow keys.
  56
  57
  58 CREDITS
  59
  60 A very crucial part of Virtual Nascom is the excellent Z80 emulator
  61 from Yaze, Copyright (C) 1995,1998  Frank D. Cringle.
  62
  63
  64 TODO
  65
  66 - embed the monitor and basic images into the binary
  67
  68 - rpm and pkg installations
  69
  70 - update sdk to forgo warning on MacOS
  71
  72 - UI:
  73     allow for switching input and output file while running
  74     support pixel doubling
  75
  76 - snapshot and resume complete machine state
  77
  78       vnascom -s <state>
  79
  80     resumes the state in <state> and saves the new state upon exit
  81     (unless explicitly aborted). The previous state is renamed to
  82     <state>~ to keep a backup.
  83
  84     UI: take snapshot, reset, abort, revert
  85
  86 - Precise timings
  87
  88   A rough, but machine independent job should be easily done.
  89
  90 - Complete the keyboard emulation
  91
  92   Currently we try hard to map keys to nascom keys.  This has some
  93   problems as shift goes to shift, e.g. when you press Shift-2 to get
  94   @, Nascom will actually get 'shift' '2' and make the '"'
  95
  96   Doing a more standard emulation will loose the possibility of
  97   emulating shift keys.  Ideally, there should be an invokation flag
  98   to chose between the two ways of doing it as it really depends on
  99   the application.  Most won't need the shift event.
 100
 101 - Use autoconfigure
 102
 103 - Emulate sound
 104
 105   Requires precise timings.
 106
 107 - Complete hardware emulation
 108
 109   Check other ports that require emulation
 110
 111 - Internal structure
 112
 113   The current organisation is a bit of a quick hack, but it works
 114   fairly well.
 115
 116 - Screen: Are Nascom characters really 16 pixels high?
 117
 118 KNOWN ISSUES
 119
 120 - Galaxy Attack doesn't work on Virtual Nascom. As it does work on
 121   Constantin's Nascom emulator it must be an emulation bug.