From nick@zephyr.specialix.com  Mon Mar 16 12:30:51 1998
Received: from zephyr.specialix.com (zephyr.specialix.com [192.65.145.58])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id MAA14293
          for <FreeBSD-gnats-submit@freebsd.org>; Mon, 16 Mar 1998 12:30:49 -0800 (PST)
          (envelope-from nick@zephyr.specialix.com)
Received: (from nick@localhost)
	by zephyr.specialix.com (8.8.5/8.8.5) id MAA08594;
	Mon, 16 Mar 1998 12:30:44 -0800 (PST)
Message-Id: <199803162030.MAA08594@zephyr.specialix.com>
Date: Mon, 16 Mar 1998 12:30:44 -0800 (PST)
From: nsayer@quack.kfu.com
Reply-To: nsayer@quack.kfu.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: New handbook section 10.4.3.4 - si driver config
X-Send-Pr-Version: 3.2

>Number:         6036
>Category:       docs
>Synopsis:       New handbook section 10.4.3.4 - si driver config
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Mar 16 12:40:01 PST 1998
>Closed-Date:    Wed Apr 7 13:49:19 PDT 1999
>Last-Modified:  Wed Apr  7 13:49:33 PDT 1999
>Originator:     Nick Sayer
>Release:        FreeBSD 2.2.2-RELEASE i386
>Organization:
Specialix, Inc.
>Environment:
>Description:

If Cyclades gets one... :-)

>How-To-Repeat:

>Fix:
	

10.4.3.4 Configuring the si driver

The Specialix SI/XIO and SX multiport cards use the si driver. A single
machine can have up to 4 host cards. The following host cards are supported:

	1. ISA SI/XIO host card (2 versions)
	2. EISA SI/XIO host card
	3. PCI SI/XIO host card
	4. ISA SX host card
	5. PCI SX host card

Although the SX and SI/XIO host cards look markedly different, their
functionality are basically the same. The host cards do not use I/O
locations, but instead require a 32K chunk of memory. The factory
configuration for ISA cards places this at 0xd0000-0xd7fff. They
also require an IRQ. PCI cards will, of course, autoconfigure themselves.

You can attach up to 4 external modules to each host card. The external
modules contain either 4 or 8 serial ports. They come in the following
varieties:

	1. SI 4 or 8 port modules. Up to 57600 bps on each port supported.
	2. XIO 8 port modules. Up to 115200 bps on each port supported.
	   One type of XIO module has 7 serial and 1 parallel port.
	3. SXDC 8 port modules. Up to 921600 bps on each port supported.
	   Like XIO, a module is available with one parallel port as well.

To configure an ISA host card, use the following configuration, changing
the numbers as appropriate:

device si0 at isa? tty iomem 0xd0000 irq 11 vector siintr

Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards and
11, 12 and 15 for SI/XIO ISA host cards.

To configure a PCI host card, use this line:

device si0

Rebuild and install your new kernel.

After rebooting with the new kernel, you need to make the devices in
/dev. The MAKEDEV script will take care of this for you. Count how many
total ports you have and type ./MAKEDEV ttyAnn cuaAnn (where nn is the
number of ports).

If you want login prompts to appear on these ports, you will need
to add lines like this to /etc/ttys:

ttyA01	"/usr/libexec/getty std.9600"	vt100	on insecure

Change the terminal type as approprate. For modems, 'dialup' or 'unknown'
is fine.

Note that by default DCD must be asserted for the login prompt to appear.
For modems this is correct, but for terminals, this may prevent login prompts
from showing up without special steps. There are a few ways to tackle this:

	1. PR # 5959 adds a flag 'nc' to the gettytab which will make the
	   gettys _not_ wait for carrier before starting. If you apply
	   the patch in that PR, then you can add ':nc:' to your gettytab
	   entries.
	2. You can modify /etc/rc.serial to do a stty clocal on
	   /dev/ttyiAnn and /dev/ttylAnn. This locks 'clocal' on the
	   tty devices, which is basically the same sort of thing as
	   the first option.
	3. You can wire DTR from your terminals to DCD of the ports.
	   This has the added benefit of automatically logging people
	   out when they turn off the terminals (presuming that the
	   terminal properly asserts DTR when it's on).

>Release-Note:
>Audit-Trail:

From: Nick Sayer <nsayer@quack.kfu.com>
To: freebsd-gnats-submit@freebsd.org
Cc:  Subject: Re: docs/6036: New handbook section 10.4.3.4 - si driver config
Date: Thu, 9 Apr 1998 10:20:00 -0700 (PDT)

 I believe this should work:
 
 
 
 Index: Makefile
 ===================================================================
 RCS file: /usr/home/nick/cvs/doc/handbook/Makefile,v
 retrieving revision 1.17.2.6
 diff -u -r1.17.2.6 Makefile
 --- Makefile	1997/05/19 12:54:06	1.17.2.6
 +++ Makefile	1998/03/26 23:03:41
 @@ -11,7 +11,7 @@
  SRCS+= lists.sgml mail.sgml memoryuse.sgml
  SRCS+= mirrors.sgml nfs.sgml nutshell.sgml pgpkeys.sgml policies.sgml
  SRCS+= porting.sgml ports.sgml ppp.sgml printing.sgml 
 -SRCS+= quotas.sgml relnotes.sgml routing.sgml russian.sgml
 +SRCS+= quotas.sgml relnotes.sgml routing.sgml russian.sgml specialix.sgml
  SRCS+= serial.sgml scsi.sgml sections.sgml sio.sgml skey.sgml slipc.sgml 
  SRCS+= slips.sgml stable.sgml submitters.sgml sup.sgml synching.sgml 
  SRCS+= term.sgml userppp.sgml uart.sgml linuxemu.sgml
 Index: authors.sgml
 ===================================================================
 RCS file: /usr/home/nick/cvs/doc/handbook/authors.sgml,v
 retrieving revision 1.37.2.5
 diff -u -r1.37.2.5 authors.sgml
 --- authors.sgml	1997/05/19 12:54:06	1.37.2.5
 +++ authors.sgml	1998/03/26 23:06:20
 @@ -483,3 +483,7 @@
  <!ENTITY a.yokota  "Kazutaka YOKOTA
    <tt><htmlurl url='mailto:yokota@FreeBSD.ORG'
    name='&lt;yokota@FreeBSD.ORG&gt;'></tt>">
 +
 +<!ENTITY a.nsayer  "Nick Sayer
 +  <tt><htmlurl url='mailto:nsayer@quack.kfu.com'
 +  name='&lt;nsayer@quack.kfu.com&gt;'></tt>">
 Index: hw.sgml
 ===================================================================
 RCS file: /usr/home/nick/cvs/doc/handbook/hw.sgml,v
 retrieving revision 1.47.2.6
 diff -u -r1.47.2.6 hw.sgml
 --- hw.sgml	1997/05/19 12:54:11	1.47.2.6
 +++ hw.sgml	1998/03/26 23:17:30
 @@ -395,6 +395,7 @@
  	&uart;
  	&sio;
  	&cy;
 +	&si;
  
  <sect1><heading>* Parallel ports</heading>
  <sect1><heading>* Modems</heading>
 Index: sections.sgml
 ===================================================================
 RCS file: /usr/home/nick/cvs/doc/handbook/sections.sgml,v
 retrieving revision 1.17.2.5
 diff -u -r1.17.2.5 sections.sgml
 --- sections.sgml	1997/05/19 12:54:15	1.17.2.5
 +++ sections.sgml	1998/03/26 23:02:54
 @@ -52,6 +52,7 @@
  <!ENTITY scsi SYSTEM "scsi.sgml">
  <!ENTITY sio SYSTEM "sio.sgml">
  <!ENTITY cy SYSTEM "cyclades.sgml">
 +<!ENTITY si SYSTEM "specialix.sgml">
  <!ENTITY skey SYSTEM "skey.sgml">
  <!ENTITY slipc SYSTEM "slipc.sgml">
  <!ENTITY slips SYSTEM "slips.sgml">
 
 
 next, add this as specialix.sgml:
 ----- cut here -----
 <!-- $Id$ -->
 <!-- The FreeBSD Documentation Project -->
 
 <!--
 <!DOCTYPE linuxdoc PUBLIC "-//FreeBSD//DTD linuxdoc//EN" [
 
 <!ENTITY % authors SYSTEM "authors.sgml">
 %authors;
 
 ]>
 -->
 <sect2><heading>Configuring the <tt>si</tt> driver<label id="si"></heading>
 
 	  <p><em>Contributed by &a.nsayer;.<newline>25 March 1998.</em>
 
 
 The Specialix SI/XIO and SX multiport cards use the si driver. A single
 machine can have up to 4 host cards. The following host cards are supported:
 
 <enum>
 <item>ISA SI/XIO host card (2 versions)</item>
 <item>EISA SI/XIO host card</item>
 <item>PCI SI/XIO host card</item>
 <item>ISA SX host card</item>
 <item>PCI SX host card</item>
 </enum><P>
 
 Although the SX and SI/XIO host cards look markedly different, their
 functionality are basically the same. The host cards do not use I/O
 locations, but instead require a 32K chunk of memory. The factory
 configuration for ISA cards places this at <tt>0xd0000-0xd7fff</tt>. They
 also require an IRQ. PCI cards will, of course, autoconfigure themselves.<P>
 
 You can attach up to 4 external modules to each host card. The external
 modules contain either 4 or 8 serial ports. They come in the following
 varieties:
 <enum>
 <item>SI 4 or 8 port modules. Up to 57600 bps on each port supported.</item>
 <item>XIO 8 port modules. Up to 115200 bps on each port supported. One
 type of XIO module has 7 serial and 1 parallel port.</item>
 <item>SXDC 8 port modules. Up to 921600 bps on each port supported. Like
 XIO, a module is available with one parallel port as well.</item>
 </enum><p>
 To configure an ISA host card, add the following line to your
 <ref id="kernelconfig:config" name="kernel configuration">, changing
 the numbers as appropriate:
 
 <tscreen><verb>
 device si0 at isa? tty iomem 0xd0000 irq 11
 </verb></tscreen>
 
 Valid IRQ numbers are 9, 10, 11, 12 and 15 for SX ISA host cards and
 11, 12 and 15 for SI/XIO ISA host cards.<p>
 
 To configure an EISA or PCI host card, use this line:
 
 <tscreen><verb>
 device si0
 </verb></tscreen>
 
 After adding the configuration entry,
 <ref id="kernelconfig:building" name="rebuild and install"> 
 your new kernel.<P>
 
 After rebooting with the new kernel, you need to make the
 <ref id="kernelconfig:nodes" name="device nodes">
 in /dev. The MAKEDEV script will take care of this for you. Count how many
 total ports you have and type:
 
 <tscreen><verb>
 # cd /dev
 # ./MAKEDEV ttyAnn cuaAnn
 </verb></tscreen>
 (where nn is the number of ports)<P>
 
 If you want login prompts to appear on these ports, you will need
 to add lines like this to <ref id="dialup:ttys" name="/etc/ttys">:
 
 <tscreen><verb>
 ttyA01  "/usr/libexec/getty std.9600"   vt100   on insecure
 </verb></tscreen>
 
 Change the terminal type as approprate. For modems, <tt>dialup</tt> or
 <tt>unknown</tt> is fine.<P>
 
 Note that by default DCD must be asserted for the login prompt to appear.
 There are a few ways to tackle this:
 
 <enum>
 <item>PR # 5959 adds a flag <tt>nc</tt> to the gettytab which will make the
            gettys <em>not</em> wait for carrier before starting. If you
 	   apply the patch in that PR, then you can add <tt>:nc:</tt> to your
 	   <ref id="term:getty" name="/etc/gettytab"> entries.</item>
 <item>You can modify <tt>/etc/rc.serial</tt> to do a <tt>stty clocal</tt> on
            <tt>/dev/ttyiAnn</tt> and <tt>/dev/ttylAnn</tt>. This
 	   locks <tt>clocal</tt> on the tty devices, which is basically
 	   the same sort of thing as the first option.</item>
 <item>You can wire DTR from your terminals to DCD of the ports.
            This has the added benefit of automatically logging people
            out when they turn off the terminals.</item>
 </enum><P>
 
 ----- ereh tuc -----
Responsible-Changed-From-To: freebsd-bugs->freebsd-doc 
Responsible-Changed-By: hoek 
Responsible-Changed-When: Mon Apr 13 08:38:56 PDT 1998 
Responsible-Changed-Why:  
Subj says it all! 
State-Changed-From-To: open->closed 
State-Changed-By: nsayer 
State-Changed-When: Wed Apr 7 13:49:19 PDT 1999 
State-Changed-Why:  
Committed handbook section 
>Unformatted:
