/*
 * FILE
 *  readme
 *
 *  Copyright(c) 1995, FMI, Fujitsu Microelectronics, Inc.
 *  All rights reserved.
 *
 *  This software (including any documentation) is untested, has not been
 *  fully tested for viruses and has been provided to you without charge.
 *  ACCORDINGLY, IT IS DELIVERED "AS IS" WITH NO WARRANTIES EXPRESS OR
 *  IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY,
 *  FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT.  You bear all 
 *  risk of nonperformance, loss of data and other problems and Fujitsu
 *  Microelectronics, Inc. and Fujitsu Limited will not be liable under any
 *  contract, negligence, strict liability or other theory for any damages
 *  including, without limitation, direct, consequential or incidental nor
 *  be required to provide substitute goods, services or technology.
 *
 */

/*
 *  1996.9
 *  Updated to add the MB8683x-EB by FUJITSU Limited.
 */

Root Directory:

    readme      - this file (in Unix compatible format)
    readme.txt  - this file (in DOS compatible format)
    gnu     - makefiles for Cygnus GNU compiler and tools
    sun     - makefiles for SUN4 compiler and tools
    src     - common source for SPARClite eval board EPROM
    mri     - src and makefiles for MRI compiler and tools
    cksum       - directory for Cygnus and MRI checksum caculation
    tools/uisun - serial user interface on SUN4
    tools/uipc  - serial user interface on DOS
    tools/uieth - Ethernet user interface on SUN4
    exmri       - example program using MRI tools (Uni compatible)
    exmripc     - example program using MRI tools (DOS compatible)
    exsun       - example program using SUN4 tools
    exgnu       - example program using Cygnus Gnu tools

File format

    All source and text files are in Unix compatible text format (each
    line ends with a newline character), except for files in the exmripc
    directory, the tools/uipc directory and the readme.txt file in the
    root directory which are in DOS compatible text format (each line
    ends with a carriage return followed by a newline).  The Cygnus
    tools allow Unix format files to be used for the DOS version of
    the tools, so these files are provided only in Unix format.
    Most DOS editors accept DOS and Unix format files.  To convert
    the files under Unix, use the dos2unix and unix2dos commands.

Example programs

    Example program source code for MRI Sun tools, MRI PC tools, Sun tools,
    and Cygnus tools are provided under directories exmri, exmripc
    exsun, and exgnu respectively.

    The example executable program in a.out format generated by
    Sun tools are provided as follows:
        exsun/ex933H.out    for MB86933H-EB
        exsun/ex934.out     for MB86936-EB
        exsun/ex936.out     for MB86936-EB
        exsun/ex831.out     for MB8683x-EB
    They can be found in the exsun directory.


To download example programs through SUN4 serial port:

    - Change directory to 'tools/uisun'  
    - Type 'sun4uih' to enter SUN4 serial interface
    - Enter interface command 'a' to download a program in Srecord format
    - Enter path '../../exsun/ex933H.out'
    - Enter address 40010000.  (If 83x, enter address 04010000)
    - Enter interface command 'e' to execute the program


To download example programs through PC serial port:

    - Change directory to 'tools/uipc'  
    - Type 'pcuih' to enter PC serial interface
    - Enter interface command 'a' to download a program in Srecord format
    - Enter path '../../example/ex933H.out'
    - Enter address 40010000.  (If 83x, enter address 04010000)
    - Enter interface command 'e' to execute the program


To download example programs through SUN4 Ethernet interface:

    Install Ethernet interface for SPARClite Eval Board on your
    workstation.  Please read readme file under directory uieth.
    After successfully connect the host workstation and the
    SPARClite Eval Board through Ethernet, follow:

    - Change directory to 'tools/uieth'  
    - Type 'uieth' to enter SUN4 serial interface
    - Enter interface command 'a' to download a program in Srecord format
    - Enter path '../../example/ex933H.out'
    - Enter address 40010000.  (If 83x, enter address 04010000)
    - Enter interface command 'e' to execute the program


Memory allocation

    DRAM 0x40000000 - 0x4000ffff is reserved 
    Any user program in DRAM should start from 0x40010000.

    SRAM 0x30000000 - 0x30003fff is reserved for FMI trap handlers.
    Any user program in SRAM should start from 0x30004000.

    <MB8683x-EB only>

    DRAM 0x04000000 - 0x0400FFFF is reserved.
    Any user program in DRAM or EDO RAM should start from 0x04010000.
