Skip to content

SonnetAmiga and MMU library

togflops edited this page Sep 24, 2017 · 13 revisions

SonnetAmiga and MMU library

While it is not strictly necessary to install Thor's mmu.library, it is highly recommended. This way bugs and misfeatures of hardware vendor-specific 68040.library can be avoided. The mmu.library also provides unified and flexible way of managing 680x0 cache setup (which is very important for proper operation of Sonnet in Amiga).

You can obtain latest release from Aminet: http://aminet.net/util/libs/MMULib.lha

Notes about installation

Installation of MMULib package is not trivial. Please read the accompanying documentation carefully.

Please remember that:

  • MMULib provides both the mmu.library and CPU-specific libraries. For proper operation, correct CPU libraries shipped with MMULib should be installed. If you own a 68060 based CPU board, on AmigaOS3.1 a dummy 68040.library needs to be installed, along with 68060.library from MMULib package. AmigaOS3.9 setpatch only requires a valid 68060.library.
  • It is recommended that you use the 68060.library included in the MMULib
  • After installing the package it is absolutely necessary to generate a MMU-Configuration valid for your system if you have a Phase 5 accelerator (CSMK3 or CSPPC are absolutely required when using the MMUlib 68060.library). Copying this file from someone else's system is not the correct solution. MMULib ships an ARexx script in the MMUlib/Install directory (BuildMMUConfig.rexx) which can build this file. It is recommended that you do this while all Sonnet memory is currently mapped. If you install the MMULib once to set the system up before the Sonnet is initialized, you may need to run it again to create an (MMU-Configuration) file which configures all of your memory properly. Execute the ARexx script with: (rx BuildMMUConfig.rexx ENVARC:MMU-Configuration) This will create the file in ENVARC: which will be in ENV: on reboot.
  • Zorro space used by the Sonnet needs to be marked as CacheInhibit. If it isn't, it will not work correctly.
  • When you run the installer it will ask you if you want to install the 680x0 libraries, it is recommended that you say yes, and it will ask you if you want to replace any "MMU Hacks" with versions contained in the distribution, say yes to this as well.
  • After the install is completed you may want to keep the extracted installation directory around to use the Tools included in the MMULibrary which are not installed by default. MuScan, Muforce, etc.

Someone™️ should roughly describe the whole installation process here.