home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Amiga / Workbench / Patches / QuickROM.lha / QuickROM / QuickROM.text < prev    next >
Text File  |  1998-05-04  |  5KB  |  111 lines
  1. QuickROM
  2.  
  3.  
  4. Synopsis: remaps Kickstart to FAST RAM, using 68060 or 68040 MMU
  5.  
  6.      $VER: QuickROM v36.07 (3-May-1998) by Simon N Goodwin
  7.  
  8. This makes operating system code much faster by making a copy of
  9. Kickstart - the built-in part of the Amiga's operating system -
  10. in fast memory. It does this dynamically and can be activated or
  11. deactivated at any time.
  12.  
  13.  
  14. COMPATIBILITY
  15.  
  16. QuickROM was written and tested on a Mark 2 Cyberstorm 68060, more
  17. than doubling the speed of access to Kickstart code. It has also
  18. been tested on GVP's G-FORCE 68060 (A2000, A3000 or A4000 versions),
  19. Commodore's 3640 A4000/040 card (where it helps a bit, but hampered
  20. by its very slow 'fast' RAM interface) MacroSystem's Warp Engine
  21. 68040/33 and a Cyberstorm Mark 1, which is even faster than the
  22. Mark 2. Nic Wilson's KickSpeed tester (from Set040) reads ROM 2.4
  23. times faster on Mark 1 Cyberstorm hardware after running QuickROM.
  24. The advantage is almost as great on Mark 2, and can be even more
  25. on a Mark 3 (PPC or 060), Warp Engine or GVP accelerator. For the
  26. most advantage - up to 30 times or more in some cofigurations - run
  27. it on a 16 bit Amiga (e.g. A2000) with a Zorro-based 68040 or 68060
  28. accelerator. The relocation will also boost the speed of access to
  29. chip RAM, custom chips and other Zorro cards in this case, as it
  30. eliminates many potentially contentious accesses to slow 16 bit
  31. motherboard resources - eliminating 16 bit ROM accesses leaves
  32. more time for everything else in the 24 bit address space. If you
  33. try it on any system not listed above, or encounter any results
  34. which you do not expect after reading this documentation, please
  35. contact the author with details by email: simon@studio.woden.com
  36.  
  37.  
  38. COMPARISONS
  39.  
  40. QuickROM is not the first such program - it follows in the path of
  41. the shareware Set040, written before Amiga OS made use of the MMU,
  42. and Commodore's developer-only MAPROM (which uses special mapping
  43. hardware) and later commercially-bundled commands like KSREMAP,
  44. WARPKICK and ROM2FAST, but it is free, concise, more compatible
  45. and has features which some others lack.
  46.  
  47.  
  48. ADVANTAGES
  49.  
  50. The advantages of QuickROM over the proprietary versions are:
  51.  
  52. * Freely distributable, with full assembly language source code
  53.   and copious comments explaining its strengths and weaknesses.
  54.   
  55. * Allocates RAM from the top of memory to minimise fragmentation.
  56.  
  57. * Allows de-allocation as well as allocation, freeing 516K memory.
  58.  
  59. * Full diagnostic Exec result codes for cases when it can't work.
  60.  
  61. * Does not use undocumented 68060.library hooks, so it should work
  62.   fine on any other 68060 or 68040 system with an MMU, unlike some.
  63.  
  64. * Works with 1 Mb ROMs as well as Commodore 512K ones, and uses the
  65.   documented method to find the ROM size, so it should suit other
  66.   sizes too, as long as they're in the first 32 Mb of address space
  67.   (likely as the MAGIC_ROM_SIZE needs to be at address 16 Mb - 20).
  68.  
  69.  
  70. LIMITATIONS
  71.  
  72. * Requires an MMU, and won't work with old 68030, 68451 or 68851 ones.
  73.   There are already plenty of Kickstart re-mappers for those systems.
  74.  
  75. * May get confused in the MMU table setup or ROM location is radically
  76.   changed in some future Amiga. This program is inevitably architecture-
  77.   and processor-specific, although I've tried to make it fairly flexible.
  78.  
  79. * No messages. Check the return code to find out EXACTLY what happened.
  80.  
  81.  
  82. ERROR CODES
  83.  
  84.   Type SET after the QuickROM command to see the return code (RC).
  85.  
  86.  0 indicates success. Other values indicate failure and the reason why.
  87.  
  88. 20 indicates that Kickstart has already been remapped by some other
  89.    program. QuickROM takes no action in this case, or others below.
  90.  
  91. 22 signifies that there is not enough fast memory in one piece for the
  92.    ROM image and associated data. QuickROM requires a contiguous 516K.
  93.    
  94. 24 indicates that the MMU is using 8K pages. QuickROM expects 4K pages,
  95.    for compatibility with Setpatch, Enforcer, Cyberguard and other MMU
  96.    programs. The source file includes untested code for 8K page support.
  97.  
  98. 26 indicates that the MMU is not enabled. This may mean that it is not
  99.    available in silicon (e.g. on an EC040 or EC060 processor. These
  100.    configurations have not been supplied as standard in any Amiga to
  101.    date, but they do work (without the MMU_) fr instance I've got a
  102.    C= 3640 with an EC040 on it, having moved the original XC040 to a
  103.    Warp Engine.
  104.  
  105. 28 indicates that the MMU has not been initialised. Normally this is a
  106.    function of SetPatch (except early versions) in conjunction with the
  107.    68040 or 68060 library. Enforcer also sets up MMU tables if they do
  108.    not already exist.
  109.  
  110. 30 indicates that the processor is too old, i.e. not a 68040 or 68060!
  111.