readme

DC记录卡读取程序

VMULoad 1.0  
(c)2000 Dan Potter                 
  
This program is about as bare bones as you can get and still do what it
does =). This thing reads the first VMU it finds and presents the user
with a list of files. You can cursor up and down with the D-Pad and pick
one with A. It will then be executed. It ought to return but there's very
little chance of it. 

For copying information, please see "COPYING". Yep, this is the first
program I'm releasing under GPL instead of MIT/X11. Future programs will
probably all be released this way (though not libs).

To use VMULoad, you'll need to get a Nexus-style memory card that has a
PC link port. Well, you can load other saved games from your normal VMU
but I _really_ don't recommend trying this =). Nexus knockoffs will work
too, like Pelican. I suppose there is also the possibility of downloading
a binary from the web using PW but I haven't explored this.

After creating your BIN file (same format you'd use for dc-load, or before
running scramble for a 1ST_READ.BIN) you'll want to use dciwrap on it. 
Dciwrap is included with this package in the directoy "dciwrap". It
ought to be fairly standard ANSI C and compile on any platform but I
really don't know =). It works on Linux.

Once you have used dciwrap, you'll have a .dci file. Use dciwrite to
write this to your memory card. Note that this probably can't be done
from VMULoad itself, as it seems like my Maple scanning isn't quite
compatible with the BIOS scanning (where it _does_ work fine). The new
or replaced file should then show up in the VMULoad screen under the
VMU name you assigned it using dciwrap.

Press A on the entry you want to run and the program will be loaded and
executed.

Note that because of the extremely limited size of the VMU, you can only
store about a 90K program (and that will take the whole bank). Of course
that's pretty large for a DC program built with hobbyist tools these days
but unless you burn data files on the VMULoad CDR, you're going to have
to pack them in there too.

Also, you'll want to link your programs just like normal. VMULoad has a
special VMA with a special crt0 that loads it into the space right below
8c010000. So all loaded programs will be loaded and run at VMA 8c010000
like normal.

If you want to recompile VMULoad, again, good luck =). This is setup to
be in a directory on a level with libdream 0.7x, and use my custom libc.
If you're setup like that, then it ought to work alright.

If you want to try it out without having to get a full devel environment
setup, I have included two test DCIs for you ready to upload. These
are ghettoplay.dci and 640x480.dci, two examples from libdream 0.7x.

Hopefully in a future version (or maybe just in KOS) I'd like to 
incorporate the minilzo compressor so you can fit bigger programs on
a VMU.

That should just about do it. Sorry for the really shitty quality of this
program but I've just got too many other things going on to really spend
a lot of time spiffing it up. Look to KOS for a better VMU loader =)

					Dan Potter / Cryptic Allusion
					Nov 3, 2000
					http://www.allusion.net/dcdev/