Uart.xdd

From SpareMiNT Wiki

Contents 1 Features 2 Installation 3 Serial port mapping 3.1 Port names on the machines 4 Bugs 5 Thanks

[edit] 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.XDD, RSVX.PRG or other stuff required

[edit] 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:

# hsmodem config
sln u:\dev\hsmodem2 u:\dev\modem2
sln u:\dev\hsserial2 u:\dev\serial2

2.) Remove/outcomment of all MiNT.CNF entries for your tty devices (if installed) like the following lines:

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

3.) Copy the xdd to your MultiTOS or MiNT folder on your boot device

4.) Verify that you have at least FreeMiNT 1.15.6 installed if not the driver simply don't work

5.) Reboot

[edit] Serial port mapping

Every driver support two devices for each port, one HSMODEM device and one Unix terminal device.

HSMODEM devices use the traditional Atari port names. UNIX terminal devices are always called ttyS followed by a number:

[edit] Port names on the machines

HSMODEM Device	Terminal Device	ST	MegaSTE	TT	Falcon	Hades	Milan
modem1	ttyS0	MODEM	MODEM1	MODEM1	-	unknown	MFP port
modem2	ttyS1	-	MODEM2	MODEM2	MODEM2	unknown	UART1 (2f8)
serial1	ttyS2	-	-	SERIAL1	-	unknown	-
serial2	ttyS3	-	SERIAL2	SERIAL2	-	unknown	UART2 (3f8)
lan	ttyS4	-	LAN	LAN	LAN	unknown	-
midi	ttyS5	Midi	Midi	Midi	Midi	unknown	-
NOTE: Serial2 and LAN are mutually exclusive, on the MegaSTE and TT; selecting Serial2 disables LAN and vice-versa, because they both use SCC-A

[edit] Bugs

• 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 informations this problem can be easily solved

[edit] 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
• to Stefan Glaser for intensiv betatesting