home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 6 / AACD06.ISO / AACD / Emulation / ABeeb / Docs / README.original < prev    next >
Text File  |  1996-10-21  |  3KB  |  97 lines
  1. This is the third release of my BBC Micro emulator for UNIX and X11.
  2.  
  3. The code is known to compile and run on Linux (Slackware 2.1) and on
  4. Sparc Solaris 2.5. If it works on any other systems, please let me know.
  5. If you need to make changes to get it to work, please tell me that, too.
  6.  
  7. NOTE:  The trap values used for entry to the emulated file system have
  8. changed since v0.2 to allow the original values to be properly implemented
  9. as on the chip.  The new values used are ones which hang the original
  10. 6502 and so it should not be necessary to change things again.  It does
  11. mean that ROMs patched to work with v0.2 will need to be changed again,
  12. though.  pch/pch.c has been updated to do this.
  13.  
  14. See the files in the doc directory for further information, including
  15. installation instructions.
  16.  
  17.  
  18. What has been implemented
  19. =========================
  20.  
  21. All of the instruction set of a standard 6502 CPU.  Illegal/undocumented
  22. opcodes on the NMOS 6502 and changes for the CMOS R65C02 and R65C12 are
  23. also implemented.
  24.  
  25. The 6522 VIA implementation is almost complete.  The emulation of the
  26. system VIA is sufficient to provide clock interrupts and keyboard handling
  27. for the OS.
  28.  
  29. The CRTC, Serial ULA and display implementation is complete enough to
  30. provide a reasonable emulation of the display.  X11 fonts for all the
  31. teletext characters are provided.
  32.  
  33. The keyboard handling is pretty much there, but not quite perfect as the
  34. Beeb has a somewhat non-standard keyboard layout compared with most I've
  35. used.  See doc/Keyboard for more information on this.
  36.  
  37. There are two disk emulations.  Documentation on the formats are in the
  38. doc/DiskEmulation file.
  39.  
  40. Paged ROMs/RAM are supported.
  41.  
  42. There is a snapshot format for saving the complete machine state.  See
  43. doc/SnapshotFormat for the specification of the snapshot format.  This is
  44. due for a complete rewrite Real Soon Now(tm).
  45.  
  46. A very much alpha sound implementation is included for VoxWare under
  47. Linux.  Support for non-standard shape/size screens is there but not
  48. perfect.
  49.  
  50. All bitmapped graphics MODEs are supported.
  51.  
  52.  
  53. What isn't supported
  54. ====================
  55.  
  56. Serial IO, the ADC, Econet, the FRED and JIM memory-mapped IO pages,
  57. the Tube and User VIA are pretty much all ignored.
  58.  
  59.  
  60. Installation
  61. ============
  62.  
  63. See the doc/Installation file.
  64.  
  65.  
  66. Running xbeeb
  67. =============
  68.  
  69. To start as if from power-up, just :
  70.  
  71.     $ xbeeb
  72.  
  73. or if you want to run a snapshot :
  74.  
  75.     $ xbeeb <snapshot-name>
  76.  
  77. For details of all the command line options, see the doc/Options file.
  78.  
  79.  
  80. General Comments
  81. ================
  82.  
  83. The code is somewhat ugly -- I started out writing clean modular code
  84. and found that there was just no way I could get anything approaching
  85. the performance I wanted, so I gave up.
  86.  
  87. Performance is now roughly the same as that of the original machine
  88. on my 486DX2 Linux machine though it does vary somewhat depending on
  89. the type of program -- possibly the fastest I've seen is about twice
  90. the speed of a Beeb, going down to around two thirds of the speed.
  91.  
  92. I use 4-character tab settings in vi.  If you read the code using
  93. 8-character tab settings, it will look even worse than it already does.
  94.  
  95. Please mail any comments, suggestions, whatever, to
  96. james@hermione.demon.co.uk.
  97.