TITLE:  TF2217 - asyc patch to allow serial console at >9600 baud rate

PRODUCT AND VERSION:

UnixWare 2.03

Installation Instructions:  

DATATYPE: datastream

1.  Download the tf2217.Z and tf2217.txt files to the /tmp directory
    on your machine.

2.  Read the release notes contained in this file and follow the 
    instuctions to add the package to your system.

3.  Now become root, uncompress the file and add the package to your 
    system using the following commands:

        $ su
        # uncompress /tmp/tf2217.Z
        # pkgadd -d /tmp/tf2217

Abstract
--------

This patch installs the following updated files:

	/etc/conf/pack.d/asyc/Driver_mp.o
	/etc/conf/pack.d/asyc/Driver_atup.o
	/etc/conf/pack.d/asyc/space.c

Symptom
--------

Currently serial console is only supported at 9600 baud date.
Asyncronous driver (asyc driver) is not flexible enough
to parse the baud rate parameter specified in /stand/boot. 

SOLUTION SPECIFICS
------------------

General Description.
-------------------

This version does not eliminate the above symptom completely.
It provides a workaround such that serial console baud rate
can be set in /etc/conf/pack.d/asyc/space.c (up to 38400)
It is expected a complete solution for the above symptom
will be available in UnixWare 2.11.  The complete solution
will also allow setting of baud rate higher than 38400.
If this ptf is revisioned, the next revision will include
the same complete solution as included in UnixWare 2.11.

New Features.
------------

None

Software Notes and Recommendations.
----------------------------------

This PTF should be applied on UnixWare 2.03 systems.
You will need to modify /etc/conf/pack.d/asyc/space.c
and then run idbuild and reboot the system everytime
you need to change the baud rate for the serial console.

You can specify the use of serial console by adding
the console keyword in /stand/boot (see boot(4)) 
or by changing driver name and minor number on the line starting
with "console" (see Sassign(4)) in /etc/conf/sassign.d/kernel.
During the testing for this ptf, the latter method is used
(as described below).

Before you proceed, please make sure that you have
emergency boot diskettes built for your system and then
follow the following steps:

A. pkgadd tf2217

B. Adjust console_baud_rate variable in /etc/conf/pack.d/asyc/space.c
to set the desired baud rate.  The space.c delivered with this ptf set
baud rate to B38400.

C. Modify the line starting with console in /etc/conf/sassign.d/kernel
to say "console iasy 2" instead of "console kd 0"
Replace 2 with the minor number of your tty device.
I used 2 because I used COM2 (/dev/tty01) as the serial console and
/dev/tty01 has major number of 3 and minor number of 2.

D. Adjust the baud rate for console login.
Modify the line that spawns ttymon for console
in /etc/conf/init.d/kernel to match the desired baud rate.
To use 19200, change "-l console" to "-l console5"
To use 38400, you need to add a new entry (such as console6) in
/etc/gettydefs and use "-l console6" instead. If you
add a new entry to /etc/gettydefs, please make sure that
the new entry created is linked together with other console* entries.
See gettydefs(4).

E. Make iasy and asyc drivers static instead of loadable.
After the $version line add the following line to /etc/conf/sdevice.d/iasy
and /etc/conf/sdevice.d/asyc:
	$static
See system(4) for more info.

F. /etc/conf/bin/idbuild -B

G. Reboot the system.

NOTE:
If you see errors like "init: ERROR: Command is respawning too rapidly."
during first reboot.  You might try the following before the second
reboot:

Modify the major and minor numbers for /dev/console and /dev/syscon
to point to iasy driver.  This step should be done automatically
for you upon subsequent reboots.  As a precaution, it is safer to do
it manually before reboot.  Make sure that /dev/console and /dev/syscon are
valid device files before you reboot. 
Otherwise you will get "UX: init: ERROR" during reboot and
the system will not come up all the way.

	cd /dev
	rm console syscon
	mknod console c 3 2  
	#substitue 3 and 2 with your maj and min for your tty device.
	chmod 620 console
	chgrp tty console
	ln console syscon
	sync;sync;sync
	umountall
	uadmin 2 2 #to reboot

If you want to revert back to the VGA console, please
follow the following steps:

A. optionally remove the ptf (pkgrm tf2217)

B. If console_baud_rate variable is in /etc/conf/pack.d/asyc/space.c,
set it back to 0.

C. Change the line from "console iasy 2" back to "console kd 0"
in /etc/conf/sassign.d/kernel.

D. Adjust the baud rate for console login
as specified in /etc/conf/init.d/kernel.

E. Optionally make iasy and asyc drivers loadable instead of static.
	remove $static from the following two files.
	/etc/conf/sdevice.d/iasy
	/etc/conf/sdevice.d/asyc

G. /etc/conf/bin/idbuild -B

NOTE:  See the NOTE section above.  If you need
to manually make /dev/console and /dev/syscon
device files to point back to kd driver, do the
following:

	cd /dev
	rm console syscon
	mknod console c 5 0  #5 is the major number for kd driver
	mknod syscon c 5 0
	chmod 620 console syscon
	chgrp tty console syscon
	sync;sync;sync
	umountall
	uadmin 2 2 #to reboot


Hardware Notes and Recommendations.
----------------------------------

This PTF is targeted for the i386, i486 and Pentium CPU's.