high-speed Milan UART driver for FreeMiNT
=========================================

Feedback, bugreports, suggestions and any other constructive comment
is strongly recommended. Please send it as e-mail to me or the
MiNT mailinglist <mint@fishpool.com>.

Thanks here to the great MiNT community.


Version 0.40
------------
- first public release


Features:
---------
- native driverrotuines for FreeMiNT, completly interrupt controlled
- minimal systemlast
- stable and constant data rates at 115200 Baud in background
- installs RSVF compatible and MiNT tty devices
- supports all filesharing and -locking mechanism
- completly supported by FreeMiNT
- no longer is HSMODEM, HSMINST or other stuff required


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

1. deinstallation of HSMODEM (if installed)
   - remove/rename of all HSMODEM AUTO folder programms
   - remove/rename of hsminst.xdd/drvinmnt.xdd
   - remove/outcomment of the HSMODEM configuration (in your MiNT.CNF)
     like the following lines:
     --- cut ---
     # hsmodem config
     sln u:\dev\hsmodem2 u:\dev\modem2
     sln u:\dev\hsserial2 u:\dev\serial2
     --- cut ---

2. Remove/outcomment of all MiNT.CNF entries for your tty devices
   (if installed)
   like the following lines:
   --- 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. Copy uart.xdd to your MultiTOS or MiNT folder on your boot device

4. Reboot


Bugs:
-----
- the BIOS functions bcon* for the UARTs don't work after installation
  of this driver; please don't use it
- there is at the moment no way to autodetect additional installed
  UART ports; but this driver can handle additional ports and you can
  selfcompile a version if you add the required informations to detect_uart()
  if the Milan TOS provide the required infromations this problem can be
  easily solved


Thanks:
-------
- to Rainer Mannigel for the source he originally developed for his
  own BIOS and the permission to develop a serial driver
- to Michael Schwingen for the reworked source from Rainer for the
  Milan TOS


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
