Add the ps2 mouse stuff.

diff --git a/contrib/FAQ/programs/psm/README b/contrib/FAQ/programs/psm/README
new file mode 100644 (file)
index 0000000..8c54700
--- /dev/null
+++ b/contrib/FAQ/programs/psm/README
@@ -0,0 +1,58 @@
+This is a set of instructions and files necessary to get the PS/2 mouse
+working with FreeBSD. 
+
+First, some explanations are in order as to why it doesn't work now.
+
+The PS/2 mouse is an extension of the keyboard controller, so it uses
+the same 'port' as the keyboard.  Even though it uses a different
+interrupt it's possible to have both processes trying to read from the
+same port at the same time, which can cause keyboard and/or mouse
+lockups.  If everything works right nothing bad should happen, but there
+are possibilities for problems due to two different drivers reading from
+the same area in memory.
+
+The bottom line is that it's bad for two drivers to use the same
+interrupt, I/O address (port), memory address, or any part of the system
+that is used for another device driver.  Code was added to
+/sys/i386/isa/isa.c to not allow this to happen.
+
+The real solution to the problem is to integrate the PS/2 mouse driver
+into the keyboard controller so that it can differentiate between
+keyboard and mouse events, but until that happens here is the
+workaround.
+
+Note, this driver is *known* to cause some keyboard lockups with certain
+controllers and is not guaranteed to work all the time, but I will admit
+that I am using this driver on quite a number of machines I support with
+only rare problems which are easily fixed with a reboot.
+
+What is needed is to add the driver to your system and to patch isa.c to
+allow both device drivers to occupy the same I/O address.  Then you need
+to add the device driver line to you kernel configuration file and rebuild
+the kernel.  Finally, you need to make the appropriate /dev entries for
+the ps/2 mouse.
+
+1) Copy the file psm.c to /sys/i386/isa
+
+2) Copy the file mouse.h /sys/i386/include
+
+3) Patch the file /sys/i386/isa/isa.c with the file isa.patch
+
+4) Add this line to your kernel config file:
+
+device          psm0    at isa? port "IO_KBD" tty irq 12 vector psmintr
+
+5) Configure and remake your kernel (Do a make clean before starting to
+   make sure everything gets rebuilt)
+
+6) Make the new /dev entries as 'MAKEDEV psm00' in /dev.
+
+7) Boot the new kernel.  (Do all the necessary steps to make sure you
+   don't hose yourself here)
+
+8) At this point you'll probably want to point X at the new mouse, so
+   modify the mouse line in Xconfig to say something like:
+
+PS/2           "/dev/psm0"
+
+9) Start X and be happy.

diff --git a/contrib/FAQ/programs/psm/isa.patch b/contrib/FAQ/programs/psm/isa.patch
new file mode 100644 (file)
index 0000000..15cc849
--- /dev/null
+++ b/contrib/FAQ/programs/psm/isa.patch
@@ -0,0 +1,48 @@
+From tinguely@plains.NoDak.edu Thu Feb 24 11:00:29 MST 1994
+Article: 9561 of comp.os.386bsd.questions
+Newsgroups: comp.os.386bsd.questions
+Path: usenet.coe.montana.edu!netnews.nwnet.net!ns1.nodak.edu!plains.NoDak.edu!tinguely
+From: tinguely@plains.NoDak.edu (Mark Tinguely)
+Subject: Re: psm driver - how to install?
+Sender: usenet@ns1.nodak.edu (Usenet login)
+Message-ID: <CLoqGJ.EK8@ns1.nodak.edu>
+Date: Wed, 23 Feb 1994 16:14:43 GMT
+References: <2kclki$su@pilhuhn.pilhuhn.sub.org> <2kdlh6$373@pdq.coe.montana.edu>
+Nntp-Posting-Host: plains.nodak.edu
+Organization: North Dakota State University
+Lines: 32
+
+In article <2kdlh6$373@pdq.coe.montana.edu> nate@bsd.coe.montana.edu (Nate Williams) writes:
+>In article <2kclki$su@pilhuhn.pilhuhn.sub.org>,
+>Patrick M.Hausen <pmh@pilhuhn.sub.org> wrote:
+>This is due to the way the PS/2 mouse works.  You need to comment out the
+>lines in i386/isa.c which don't allow multiple device drivers to exist on
+>the same port.  However, as this implies, you *may* have problems with certain
+>hardware and keyboard lockups due to this.  I have machines that work fine,
+>and others that lockup using that mouse driver.
+
+instead of totally commenting out the conflict check, I just "overlooked"
+the duplicate keyboard/mouse conflict.
+
+*** isa.c.orig Wed Feb 23 10:09:58 1994
+--- isa.c      Wed Feb 23 10:08:51 1994
+***************
+*** 122,128 ****
+               if (tmpdvp->id_alive != -1) {
+                       if ((dvp->id_iobase >= tmpdvp->id_iobase) &&
+                           (dvp->id_iobase <=
+!                                (tmpdvp->id_iobase + tmpdvp->id_alive - 1))) {
+                               conflict(dvp, tmpdvp, dvp->id_iobase,
+                                        "I/O address", "0x%x");
+                               status = 1;
+--- 122,129 ----
+               if (tmpdvp->id_alive != -1) {
+                       if ((dvp->id_iobase >= tmpdvp->id_iobase) &&
+                           (dvp->id_iobase <=
+!                                (tmpdvp->id_iobase + tmpdvp->id_alive - 1))
+! /* for ps/2 mouse */                 && dvp->id_iobase != 0x60 ) {
+                               conflict(dvp, tmpdvp, dvp->id_iobase,
+                                        "I/O address", "0x%x");
+                               status = 1;
+
+

diff --git a/contrib/FAQ/programs/psm/mouse.h b/contrib/FAQ/programs/psm/mouse.h
new file mode 100644 (file)
index 0000000..47720da
--- /dev/null
+++ b/contrib/FAQ/programs/psm/mouse.h
@@ -0,0 +1,44 @@
+/*-
+ * Copyright (c) 1992, 1993 Erik Forsberg.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY ``AS IS'' AND ANY EXPRESS OR IMPLIED
+ * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN
+ * NO EVENT SHALL I BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+ * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+ * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+ * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+ * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+ * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ *     $Id: mouse.h,v 1.2 1993/08/02 17:52:25 mycroft Exp $
+ */
+
+struct mouseinfo {
+       unsigned char status;
+       char xmotion, ymotion;
+};
+
+#define BUTSTATMASK    0x07    /* Any mouse button down if any bit set */
+#define BUTCHNGMASK    0x38    /* Any mouse button changed if any bit set */
+
+#define BUT3STAT       0x01    /* Button 3 down if set */
+#define BUT2STAT       0x02    /* Button 2 down if set */
+#define BUT1STAT       0x04    /* Button 1 down if set */
+#define BUT3CHNG       0x08    /* Button 3 changed if set */
+#define BUT2CHNG       0x10    /* Button 2 changed if set */
+#define BUT1CHNG       0x20    /* Button 1 changed if set */
+#define MOVEMENT       0x40    /* Mouse movement detected */
+
+/* Ioctl definitions */
+
+#define MOUSEIOC        ('M'<<8)
+#define MOUSEIOCREAD   (MOUSEIOC|60)

diff --git a/contrib/FAQ/programs/psm/psm.uue b/contrib/FAQ/programs/psm/psm.uue
new file mode 100644 (file)
index 0000000..2367317
--- /dev/null
+++ b/contrib/FAQ/programs/psm/psm.uue
@@ -0,0 +1,94 @@
+begin 644 psm.c.gz
+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
+CC]A\]WA^,Q?33D&I8EB629&?^$MFIWDGO_5O#/&20DLI``"+
+`
+end

diff --git a/contrib/FAQ/programs/psm/psm0 b/contrib/FAQ/programs/psm/psm0
new file mode 100644 (file)
index 0000000..a0453b2
--- /dev/null
+++ b/contrib/FAQ/programs/psm/psm0
@@ -0,0 +1 @@
+device          psm0    at isa? port "IO_KBD" tty irq 12 vector psmintr