Date: Thu, 9 Apr 1998 10:30:01 -0700 (PDT) From: Nick Sayer <nsayer@quack.kfu.com> To: freebsd-bugs Subject: Re: docs/6036: New handbook section 10.4.3.4 - si driver config Message-ID: <199804091730.KAA12385@hub.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/6036; it has been noted by GNATS.
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='<yokota@FreeBSD.ORG>'></tt>">
+
+<!ENTITY a.nsayer "Nick Sayer
+ <tt><htmlurl url='mailto:nsayer@quack.kfu.com'
+ name='<nsayer@quack.kfu.com>'></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 -----
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-bugs" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199804091730.KAA12385>