---------------------------------------------------       950724
Info about the Jaguar Server.
Current hardware revision B, software version 1.05.

A | in front of a line means that some new stuff
has been typed in there since the last info file...
---------------------------------------------------

  The Jaguar Server project started out in August '94. The goal
  was to make a cheap developer kit for anyone that wanted to
  program for the Jaguar. Atari's own developer kit was $5500 and
  that was WAY to much if you just wanted to hack and program the
  Jaguar just for the fun of it.

  The very first prototype was built around the Mega ST's 'MegaBus'
  All of it was hand wired together using a total of 21 IC's.
  I can tell you that this board had VERY little empty space on it..
  This prototype was soon scraped, as i begun work on the Rev A
  board, using a different approach this time. It was built for the
  cartridge port and could then be used on all Atari computers not
  just the ones having a 'MegaBus'.
  To keep the cost down, i also decided to use the Jaguar's 2MB
  main memory and not include any expensive RAM chips in the Jaguar
  Server hardware.

  The Rev A board was up and running with very simple software in
  Februari '95. As the Rev A board had some small flaws, i made
  some changes to the layout and came up with the Rev B board.

  More serious work now begun on the Software - The Shell running
  on the Atari and the JagOS - Running on the Jaguar.


---------------------------------------------------
General Info.
---------------------------------------------------

  * Use the Jaguar Server kit to develop Jaguar programs !

  * The Jaguar Server runs on all Atari ST/STE/Falcon/TT computers.

  * The hardware plugs into your computers cartridge port. From the
    cartridge hardware goes a 40 pin ribbon cable into the Jaguar.

  * Uses a slightly modified standard Jaguar. Soldering experience
    is _needed_ to successfully complete the modification.

  * You can change betweeen 'modified' and 'orginal' Jaguar by the
    flick of a switch. A reset button is also installed.
    ABSOLUTELY _NO_ compability problems with Jaguar games.
  
  * No programing restrictions apart from a 2Mb main memory limit
    in the Jaguar. Future software updates will be able to upload
    data at the command of a running Jaguar program.

  * You use the Jaguar Server software to upload programs/data to
    the Jaguar.

  * Software updates to JagOS (Jaguar Operating System) are possible
    without burning a new EPROM chip.

  * Upload transfer rate is currently 65 Kbyte per second on a 8 Mhz
    Atari and 108 Kbyte per second running at 16 Mhz.
  
  * Use the Devpac 3 assembler or any other code generator to write
    programs.
  
  * A remote debugger is under development.

| * Software updates are availible for filerequest by any FidoNet
|   compatible mailer on STacken BBS on FidoNet 2:204/419 under the
|   name JSERVER. Updates are soon availible on the InterNet to...
  
  * The Jaguar Server development kit contains this...

           + Jaguar Server cartridge (hardware)
           + Jaguar Server Shell & JagOS (software)
           + Switches, ribbon cable, connectors and everything else
             that is needed to modifie your Jaguar.
           + A few Jaguar (*.JAG) programs and example source code.

  * IT DOES _NOT_ CONTAIN THE FOLLOWING... You have to get these
    things yourself....

           - No 68000 or Atari RISC assemblers.
           - No Jaguar technical documentation.

  * 'Hacker' experience and good knowledge of assembler programming
    is STRONGLY recommended because of lacking Jaguar technical
    documentation.

  * The Jaguar Server is NOT connected to Atari Corp. in ANY way.

  * _Introduction_ price is :

             1200 Skr
              110 GBP
              170 USD for the complete Jaguar Server developer kit
                      and all parts needed. Soldering needed!

              500 Skr
               45 GBP
               70 USD for the Jaguar modification if you can't do
                      it yourself. You send your Jaguar to us...


---------------------------------------------------
Some technical info.
---------------------------------------------------
  A Jaguar (*.JAG) program is built around a header. There are
| currently four different headers, each with it's own advantages
  and disadvantages depending on the development environment and
  programs.
  For example, one of the headers looks like this (for Devpac 3)

  *-----------------------------------------------------------------*
  * Standard JagOS 3 Upload & Run parameters.                       *
  *  Roine 940420                                                  *
  *-----------------------------------------------------------------*
  * OUTPUT i:\*.JAG           * Output standard Atari Executable.

  down    EQU $5000           * Download adress in Jaguar.
  start   EQU $5000           * Program start adress in Jaguar.
          OPT	D-            * No debugging info.

          dc.b 'JAGR'         * Magic to skip Devpac Header.
          dc.w 3              * JagOS 3 - Recive & Run.
          dc.l down           * Download adress.
          dc.l c_end-c_start  * Lenght of Jaguar Code.
                              * A dc.l 0 are also possible.
          dc.l start          * Start adress.
          ORG  start          * If position dependent code.

  *-----------------------------------------------------------------
  c_start                     * Jaguar code start.....
          NOP                 
          NOP
          ILLEGAL             * Not much of a program...  Hmm...
  c_end                       * Jaguar code end.
  *-----------------------------------------------------------------
          END


---------------------------------------------------
Jaguar Modification
--------------------------------------------------
  * You need ESD soldering equipment that has none static electricity
    at all. If you don't have this stuff, don't even TRY, you CAN
    damage your Jaguar!
  * A 32 pin IC-sockel to be soldered on top of another IC in the
    Jaguar.
  * Two IC-pins cut off, and connected to the switch.
  * Solder a total of 6 wires to the switch, four from the IC-sockel.
  * 4 resitors soldered on the IC-sockel.
  * Solder 2 wires to the motherboard for the reset button.
  * Drill 2 holes at the back of the Jaguar for the Switch and Reset
    button.
  * Cut some plastic and shield to get the ribbon cable out.
  * All this in a _VERY_ tight space, so much soldering experience is
    needed, as well as some other tools for drilling and cutting.

---------------------------------------------------
Misc Info.
---------------------------------------------------
  If you have more specific questions, write me by E-Mail...

  Roine@stacken.ct.se
