
MMULib v0.1 beta (c) 2004 Jouni 'Mr.Spiv' Korhonen

What?
        MMULib is an experimental library for arm-elf-gcc (I used 3.3.2), which
        provides a bunch of MMU related functions. The aim is to provide easy
        integration for GP32s with more than 8M RAM. Also custom MMU setups are
        easy to set up with the help of the library.

        The library consists of three parts:
        1) crt0.S - crt0 file that is capable of recognizing 8/32/64M of RAM and
           communicate it to e.g. libc.a
        2) syscalls.c - you need to patch your libc.a in order to enable 32/64M
           RAM support for libc.a malloc() and stuff..
        3) mmulib.a - a collection of routines that you can link against to

        MMULib is designed to be fully backwards compatible with the Gamepark
        SDK and existing programs. The library also provide easy way to patch
        exception handlers without a need to reflash your GP32.

        This is a powerful tool - if used corretly. For your frustration I tell
        in advance that even a small error makes your program to crash in a set
        of new ways you never thought of :)

        Remember: this is v0.1 so there are probably bugs. I have so far used
        this only with one program I made, which remaps BIOS and patches MMU
        tables on fly etc kinky stuff.
        

How to?
        - Check include files for commented prototypes. Start from mem.h
        - Be usre you are familiar with ARM920T MMU..
        
What else?
        - Use the provided crt0.S
        - Use a patched libc
        
How to patch libc?
        - Compile the provided  syscalls.c (in libc directory)
        - Remove old syscalls.o from libc.a using "arm-elf-ar d libc.a syscalls.o"
        - Add new syscalls.o to libc using "arm-elf-ar r libc.a syscalls.o"





Thanks to
        RobBrown in #gp32dev@efnet for his 32M mod, WinterMute & Mr.Mirko
        for patching their gcc tools chains with my libc.a patch.

Greets to
        _mp_, flavor, groepaz, clemmy, ^yado^, don_migue, rlyeh, aj0,
        trapflag, CMOTD, kojote, giffel, mithris, zardozj, ratboi, trans,
        darkfader,Costis,...
