patch-2.2.16 linux/drivers/char/README.computone

• Lines: 175
• Date: Wed Jun 7 14:26:42 2000
• Orig file: v2.2.15/linux/drivers/char/README.computone
• Orig date: Wed Aug 25 17:29:46 1999

diff -urN v2.2.15/linux/drivers/char/README.computone linux/drivers/char/README.computone
@@ -5,24 +5,30 @@
 Release Notes For Linux Kernel 2.2
 These notes have been tested on Linux kernels 2.0 and 2.2.
 
+Please refer to Documentation/computone.txt for information on the driver
+that is included with the kernel sources.
 
-Version: 1.2.4
-Date: 08/04/99
+
+Version: 1.2.9
+Date: 04/12/2000
 Fixes and Updates: Doug McNash 
 Historical Author: Andrew Manison 
+Kernel Integration: Mike Warfield <mhw@wittsend.com>
 
 1. INTRODUCTION
 
 This driver supports the entire family of Intelliport II/Plus controllers
-with the exception of the MicroChannel controllers.
+with the exception of the MicroChannel controllers. 
 
 This driver was developed on the v2.0.x Linux source tree and has been 
-tested up to v2.2.10; it will probably not work with earlier v1.X kernels, 
+tested up to v2.2.14; it will probably not work with earlier v1.X kernels, 
 and has not yet been tested on the v2.1.x tree. The most likely problems 
 will be in patching the kernel sources to support the driver. For this
 reason there are 2 different patch files for 2.0.XX and 2.2.XX kernels.
 Make sure you use the right one!
-Someday soon it should be included in the 2.3.XX tree.
+Note that a version (1.2.5) is included in the 2.2.12+ kernels so this
+will not be a new install but and upgrade.
+
 
 2. QUICK INSTALLATION
 
@@ -31,10 +37,11 @@
 		   `cat /proc/ioports`.  Set the card dip switches to that free 
 		   address.  You may need to configure your BIOS to reserve the
 		   irq for the ISA card.  PCI and EISA parameters are set
-		   automagically and need no attention.  Insert card into 
-		   computer with the power off before or after driver installation.
+		   automagically and need only be set to nonzero values.
+		   Insert card into computer with the power off before or after
+		   driver installation.
 
-Software -
+Software - New Installation
 
 Module installation:
 
@@ -74,6 +81,11 @@
 j) reboot using this kernel
 k) make and run ip2/mkip2dev
 
+Software - Upgrades
+
+a) Install new sources in proper location, usually /usr/src/linux/drivers/char
+b) Follow steps above to create new kernel or modules
+
 3. INSTALLATION
 
 Previously, the driver sources were packaged with a set of patch files
@@ -82,7 +94,8 @@
 the patches if needed, and build any utilities needed.
 What you recieve may be a single patch file in conventional kernel
 patch format build script. That form can also be applied by
-running patch -p1 < ThePatchFile.  Otherwise run ip2build.
+running patch -p1 < ThePatchFile.  Otherwise the drivers source may be
+a tar file, then untar and run ip2build if a new installation.
  
 The driver can be installed as a module (recommended) or built into the 
 kernel. This is selected as for other drivers through the `make config`
@@ -97,20 +110,28 @@
 where irqnum is one of the valid Intelliport II interrupts (3,4,5,7,10,11,
 12,15) and addr1-4 are the base addresses for up to four controllers. If 
 the irqs are not specified the driver uses the default in ip2/ip2.h (which 
-selects polled mode). If no base addresses are specified the defaults in 
-ip2.h are used. If you are autoloading the driver module with kerneld or
-kmod the base addresses and interrupt number must also be set in ip2/ip2.h
-and recompile or just insert and options line in /etc/modules.conf or both. 
-The options line is equivalent to the command line and takes precidence over 
-what is in ip2.h. 
+selects polled mode). The io addresses are set to io=1 for PCI cards,i
+io=2 for EISA cards or io=[some valid ISA address] for ISA cards.  If no
+base addresses are specified the defaults in ip2.h are used. If you are
+autoloading the driver module with kerneld or kmod the base addresses and
+interrupt number must also be set in ip2/ip2.h and recompile or just insert
+an options line in /etc/modules.conf or both.  The command line takes
+precidence over the options line which takes precidence over the defaults
+in ip2.h. 
+
+command line sample:
+	
+	modprobe ip2 io=1,0x328 irq=1,10
 
 /etc/modules.conf sample:
+
 	options ip2 io=1,0x328 irq=1,10
 	alias char-major-71 ip2
 	alias char-major-72 ip2
 	alias char-major-73 ip2
 
-equivelant ip2.h:
+the equivelant ip2.h:
+
 static ip2config_t ip2config =
 {
 	{1,10,0,0},
@@ -122,15 +143,17 @@
 	}
 };
 
-Specifying an invalid or in-use irq will default the driver into
+Specifying an invalid or in-use ISA irq will default the driver into
 running in polled mode for that card.  If all irq entries are 0 then
-all cards will operate in polled mode.
+all cards will operate in polled mode.  Note that the PCI will be
+assigned it's irq by the BIOS and may not match what you specify.
+It must be non-zero otherwise it will be polled.
 
 Tarball Install:
 
 The whole tarfile should be untarred in the /usr/src/linux/drivers/char/
 directory. Most files required for the driver are placed in the ip2
-subdirectory. Then execute the script 
+subdirectory. Then execute the script (for a new install only)
 
 	ip2build
 
@@ -149,7 +172,7 @@
 If you select the driver as part of the kernel run :
 
 	make depend
-	make zlilo (or whatever you do to create a bootable kernel)
+	make bzImage(,zlilo or whatever you do to create a bootable kernel)
 
 If you selected a module run :
 
@@ -161,7 +184,8 @@
 ports are created. With multiple boards and expansion boxes this will 
 leave gaps in the sequence of device names. ip2mkdev uses Linux tty naming 
 conventions: ttyF0 - ttyF255 for normal devices, and cuf0 - cuf255 for 
-callout devices.
+callout devices.  Note that the callout devices are going away in the
+future and that is what the warning messages are trying to tell you.
 
 4. USING THE DRIVERS
 
@@ -181,7 +205,7 @@
 corresponds to the maximum bit rates those chips are capable.  
 For example if the baud base is 921600 and the baud divisor is 18 then
 the custom rate is 921600/18 = 51200 bps.  See the setserial man page for
-complete details. Of course if stty accepts the higher rates now you can
+complete details. Of course, if stty accepts the higher rates now you can
 use that as well as the standard ioctls().
 
 5. NOTES
@@ -190,6 +214,14 @@
 in all configurations of Linux. If there is any anomalous behaviour that 
 does not match the standard serial port's behaviour please let us know.
 
-Author:  dmcnash@computine.com
+Some installations report that characters fail to echo immediatly at a
+terminal if the kernel/modules are compiled with the CONFIG_M386 and
+the card is run in polling mode on a pentium class machine.  Compiling
+with a more appropriate processor flag or running on interrupt would be
+the fix as well as the wise thing to do.
+
+
+
+Author:  dougm@computone.com
 Testing: larryg@computone.com
-Spport: support@computone.com
+Support: support@computone.com