high-speed Milan UART Treiber fr FreeMiNT
==========================================

Feedback, Fehlermeldungen, Vorschlge und sonstige konstruktive
Kommentare sind sehr erwnscht. Entweder per e-Mail direkt an mich
oder an die MiNT Mailingliste <mint@fishpool.com>.
Ein Anpassung an den Hades fr serielle 16550 UART Schnittstellen drfte sehr
einfach sein. Wer dahingehend Interesse hat sollte sich bei mir melden.

Dank an dieser Stelle der unermdlichen FreeMiNT Gemeinde.


Version 0.40
------------
- erste ffentliche Version


Features:
---------
- native Treiberroutinen fr FreeMiNT, vollstndig Interruptgesteuert
- minimale Systemlast
- stabile und konstante Datenraten bei 115200 Baud komplett im
  Hintergrund
- installiert sowohl RSVF kompatible als auch MiNT tty devices;
- Support aller Filesharing und -locking Mglichkeiten
- vollstndige Untersttzung durch FreeMiNT
- kein HSMODEM, HSMINST und sonstiger Krempel mehr erforderlich


Installation:
-------------

1. Deinstallation von HSMODEM (soweit vorhanden)
   - entfernen/umbenennen aller HSMODEM Programme aus dem AUTO Ordner
   - entfernen/umbenennen von hsminst.xdd/drvinmnt.xdd
   - entfernen/auskommentieren der HSMODEM Konfiguration in der MiNT.CNF
     wie bspw.:
     --- cut ---
     # hsmodem config
     sln u:\dev\hsmodem2 u:\dev\modem2
     sln u:\dev\hsserial2 u:\dev\serial2
     --- cut ---

2. Entfernen/auskommentieren der MiNT.CNF Eintrge die die tty Devices
   anmelden (soweit vorhanden)
   wie bspw.:
   --- cut ---
   ren u:\dev\modem2  u:\dev\ttyb
   ren u:\dev\serial1 u:\dev\ttyc
   ren u:\dev\serial2 u:\dev\ttyd
   
   sln u:\dev\ttyb u:\dev\modem2
   sln u:\dev\ttyc u:\dev\serial1
   sln u:\dev\ttyd u:\dev\serial2
   --- cut ---

3. Kopieren von uart.xdd in den MultiTOS oder MiNT Ordner auf dem Bootlaufwerk

4. Reboot


Bugs:
-----
- die BIOS Routinen bcon* fr die UARTs arbeiten nach Installation
  des Treibers nicht mehr; also bitte nicht benutzen
- es gibt im Moment leider keine Mglichkeit der Autodetection
  von zustzlich installierten UARTs; der Treiber selbst ist darauf
  aber vorbereitet und man kann sich selbst problemlos eine passende
  Version bersetzen indem man die notwendigen Informatinen einkodiert
  (siehe detect_uart)
  wenn das Milan TOS Informationen ber die installierte Hardware zur
  Verfgung stellt erledigt sich das Problem


Dank:
-----
- an Rainer Mannigel fr die Freigabe der von ihm original
  entwickelten UART Routinen fr dieses Projekt
- an Michael Schwingen fr die Freigabe der von ihm bearbeiteten
  Routinen von Rainer fr das Milan TOS fr dieses Projekt


Copying:
--------
Copyright 1999 Frank Naumann <fnaumann@cs.uni-magdeburg.de>
Portions copyright 1998, 1999 Rainer Mannigel, Michael Schwingen.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2, or (at your option)
any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.


Frank Naumann
<fnaumann@cs.uni-magdeburg.de>

Magdeburg, 22.08.1999
