Jaguar Server Documentation - For Jaguar Hackers !                   960205
---------------------------------------------------------------------------
All questions should be sent to roine@stacken.ct.se

-------------
Installation.
-------------
Plug in the hardware in the cartridge port and attach the flatcable
connector to the Jaguar Server. Be carefull NOT to touch any components, as 
they are sensetive to static electicity.
The Jaguar server is ON when the switch points towards the back of the 
Jaguar.

When the Jaguar Server is plugged in, you must have your computer ON in 
order to play games with the Jaguar is in 'orginal' mode.
The solution is to unplug the Jaguar from the Jaguar Server hardware. Note 
that the flatcable connector only are garanteed for 200 unplug/plug 
operations.

--------
Booting.
--------
You must have a cartridge inserted in the Jaguar. If you don't, the 
Jaguar will not startup at all. Any cartridge will do.
Start your Jaguar Monitor first, then your computer system and LAST your 
Jaguar. Otherwise the Jaguar may hang.

---------
Software.
---------
The Jaguar Server software takes parameters, so you can install it 
to autoupload *.JAG programs when clicked upon.
An additional parameter is '-Q' when used exits the Jaguar Server Software 
right after uploading the Jaguar Program.

A Devpac3 menu call for Jaguar Server might look like this:

I:\DEVELOP\JAG_SERV.PRG J:\PROGRAM.JAG -Q

It uploads PROGRAM.JAG and exits back to Devpac when finished.

Upload button.
--------------
Brings up a fileselector so you can choose a *.JAG program to upload.

Download button.
----------------
Type in a from and to memory adress and click on 'Download'.
This downloades Jaguar memory to a file on disc.
For example: From $00 to $FF downloades _256_ bytes starting at adress $0.
Uses memory at $1E0000-$1FFFFF as a buffer.
This routine also assumes 32bit wide ROM, but if startadress are $E00000,
8 bit ROM is assumed.

Download EEPROM.
----------------
This downloads the cartridge EEPROM (128 bytes) to a file. It normaly
contain hiscores or saved games. Upload of a file to EEPROM is planed
in a future update.

Version.
--------
Brings up the JagOS version you are running. Should say something 
like 1.xx or similar. If you are running from the bootrom without loading 
the JagOS it should say something like Bxxx where xxx stands for BOOTversion.

Restart.
--------
Tries to establish communication with the Jaguar and uploads 
JAGOS.BIN if needed. Useful after a reset for example. Note that the Jaguar 
can hang badly and it may not always be possible to reset with the 
resetbutton. Then a 2-3 seconds poweroff will do the work.
If that doesn't work, you have to TURN OFF YOUR COMPUTER and boot again!

Poll.
-----
With this button you get the server software to listen to the Jaguar's
requests. This is at the moment limited to keyboard scans.
If you have 'dc.w 10' somewhere in your header, there is no need to
press this button.

-----------------
Writing Software.
-----------------
You must use a valid header (2,3,9,10,12 & 65535).

You must always begin your program with 68000 code.

End your Jaguar program with a 'RTS' to return to the JagOS.

Don't use memory from $400-$4FFF as this is reserved for the JagOS. If you 
use it, you might overwrite JagOS program code.

Your Jaguar program may use main memory from $5000-$1FFFFF.

------------------
Bugs & Limitations
------------------
Sometimes the Jaguar will not respond.
Please give me information on how and when this happens to you.
This will help me improving my routines.
If the Server software locks up, try pressing ALT-HELP to get you
back in control.

You can not upload a bigger Jaguar program than availible free memory in the 
Computer. Will be fixed in a future update.

Always connect the Jaguar to a TV or RGB monitor for reliable performance.
