diff options
| author | cvs2svn <cvs2svn@FreeBSD.org> | 1997-10-21 01:56:05 +0000 |
|---|---|---|
| committer | cvs2svn <cvs2svn@FreeBSD.org> | 1997-10-21 01:56:05 +0000 |
| commit | 58fda9eaaeb697cef01d825dfe2b6f045659c15c (patch) | |
| tree | 608ad4d5ac4c44174b17ea11f8e0a6958ddbd286 /usr.sbin/stallion | |
| parent | 1d853e02788eb0dda6e3b47520c76e12765922b4 (diff) | |
Diffstat (limited to 'usr.sbin/stallion')
| -rw-r--r-- | usr.sbin/stallion/bootcode/stl.4 | 324 | ||||
| -rw-r--r-- | usr.sbin/stallion/stlload/stlload.8 | 124 | ||||
| -rw-r--r-- | usr.sbin/stallion/stlstats/stlstats.8 | 135 |
3 files changed, 0 insertions, 583 deletions
diff --git a/usr.sbin/stallion/bootcode/stl.4 b/usr.sbin/stallion/bootcode/stl.4 deleted file mode 100644 index 871744997e6b..000000000000 --- a/usr.sbin/stallion/bootcode/stl.4 +++ /dev/null @@ -1,324 +0,0 @@ -.\" Copyright (c) 1996 Greg Ungerer (gerg@stallion.oz.au). -.\" 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. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by Greg Ungerer. -.\" 4. Neither the name of the author nor the names of any co-contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``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 THE AUTHOR OR CONTRIBUTORS 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. -.\" -.Dd December 2, 1996 -.Os FreeBSD -.Dt STL 4 i386 -.Sh NAME -.Nm stl , -.Nm stli -.Nd "drivers for Stallion Technologies multiport serial controllers" -.Sh SYNOPSIS -.Cd "stl0 at isa? port <addr> tty irq <irq> vector stlintr" -.Cd "stli0 at isa? port <io-addr> tty iomem <mem-addr> iosiz <size> flags <type> " -.Cd "stli0 at eisa? port <io-addr> tty iomem <mem-addr> iosiz <size> flags <type> " -.Sh DESCRIPTION -This is a kernel driver for Stallion Technologies multiport serial boards. -There are two drivers, each supporting a different class of boards. -The -.Nm stl -driver supports the EasyIO and EasyConnection 8/32 -boards, while the -.Nm stli -driver supports all other types, including -ONboard, Brumby and EasyConnection 8/64. -.Sh CONFIGURATION -Each board installed in the system needs a configuration entry in the -kernel configuration file. -Slightly different options and parameters are required for each of the -different board types. -Depending on the type of board one of the -.Nm stl -or -.Nm stli -drivers will be used. The -.Nm stl -and -.Nm stli -drivers can support up to 8 boards. -.Pp -Configuration of the hardware - DIP switches, jumpers, etc - varies -from board to board. -Consult documentation supplied with the board for hardware -configuration details. -Alternatively the board documentation is available on Stallion -Technologies WWW site at http://www.stallion.com. -.Pp -The EasyIO and EasyConnection 8/32 families of boards use the -.Nm stl -driver. -ISA board configuration entries for the -.Nm stl -driver take the general form of: -.Pp -.Cd "stlX at isa? port <io-addr> tty irq <irq> vector stlintr" -.Pp -.Ar X -is the unit number assigned to the board. -Any unique value between 0 and 7 is valid. -.Pp -The I/O address used by the board is specified by -.Ar <io-addr> . -Each of the EasyIO and EasyConnection 8/32-AT boards can use -an I/O address in the range from 0 to 0x400. -.Pp -All EasyIO and EasyConnection 8/32 boards require an interrupt, -and this interrupt is specified by -.Ar <irq> . -Legal IRQ values for the ISA boards are 3, 4, 5, 7, 10, 11, 12 and 15. -Interrupts are software programmed on all boards except the EasyIO-8M. -.Pp -The EasyConnection 8/32-AT board uses a secondary I/O address region, -and this is fixed at address 0x280 in the driver code. -All EasyConnection 8/32-AT boards may share the same secondary address -region. -.Pp -EasyConnection 8/32 PCI boards are detected automatically by the -system on boot up. -No configuration information is required in advance for these -board types. -During boot up the -.Nm stl -driver will issue messages to indicate that a EasyConnection 8/32 -PCI board was found, and some information about it. -.Pp -Following are some examples of configuration entries for each of the ISA -boards supported by the -.Nm stl -driver. -Each example also describes some important details about each of the -board types. -.Pp -Each EasyIO board requires 8 bytes of I/O address space and 1 IRQ line. -A configuration entry for an EasyIO board would look like: -.Pp -.Cd "stl0 at isa? port 0x2a8 tty irq 15 vector stlintr" -.Pp -This entry specifies an EasyIO board at I/O address 0x2a8 using IRQ 15. -The I/O and IRQ values can be modified as required. -.Pp -Each EasyConnection 8/32-AT board requires 2 sets of I/O addresses -and 1 IRQ line. -The primary I/O address range is 2 bytes in size, and must be unique -to each EasyConnection 8/32-AT board in the system. -The secondary I/O address range is 32 bytes in size, but can be shared -by multiple EasyConnection 8/32-AT boards. -This secondary I/O address is set at 0x280 in the driver code. -A configuration entry would look like: -.Pp -.Cd "stl0 at isa? port 0x2a0 irq 10 tty vector stlintr" -.Pp -This specifies an EasyConnection 8/32-AT with primary I/O address 0x2a0, -secondary I/O address of 0x280 and IRQ 10. -.Pp -The ONboard, Brumby and EasyConnection 8/64 families of boards use the -.Nm stli -driver. The -.Nm stli -driver supports the ISA and EISA members of these families. -.Pp -ISA board configuration entries for the -.Nm stli -driver take the general form of: -.Pp -.Cd "stliX at isa? port <io-addr> tty iomem <mem-addr> iosiz <size> flags <type>" -.Pp -.Ar X -is the unit number assigned to the board. -Any unique value between 0 and 7 is valid. -.Pp -The I/O address used by the board is specified by -.Ar <io-addr> . -Each of the different supported board types has restrictions on valid -I/O addresses and also the amount of I/O space required varies between -the boards. -.Pp -All boards using the -.Nm stli -driver require a shared memory region to operate. -Depending on the board type the region required varies in size -from 4 kbytes to 64 kbytes. The size of the board region is specified -by field -.Ar <size> -of the configuration entry, and the address of the region is specified by -.Ar <mem-addr> . -.Pp -The flags field specifies the particular board type that this entry -applies to. -Not all board types are distinguishable by the driver at runtime, -so this field is required by the driver. -Valid board types are: -.Bd -literal -offset indent -BOARD NAME TYPE I/O SIZE - -Brumby 2 0x4000 -ONboard 4 0x10000 -ONboard/E 7 0x10000 -EasyConnection 8/64-AT 23 0x1000 -EasyConnection 8/64-EISA 24 0x10000 -.Ed -.Pp -Following are some examples of configuration entries for each of the -boards supported by the -.Nm stli -driver. Each example also describes some important details about -each of the board types. -.Pp -The EasyConnection 8/64-AT board requires 4 bytes of I/O address space and -4 kbytes of memory space. -A configuration entry would look like: -.Pp -.Cd "stli0 at isa? port 0x2a0 tty iomem 0xcc000 iosiz 0x1000 flags 23" -.Pp -The flags field of this entry specifies that this is an -EasyConnection 8/64-AT board. -It is set to I/O address 0x2a0 and memory address 0xcc000. -The -.Ar iosiz -parameter specifies a memory region size -of 4 kbytes. -.Pp -The EasyConnection 8/64-EISA board requires a 64 kbyte region of -memory space. -This region can be anywhere in the 32 bit memory address space. -A configuration entry would be like: -.Pp -.Cd "stli0 at eisa? port 0x2000 tty iomem 0x80000000 iosiz 0x10000 flags 24" -.Pp -The flags field is used to specify that this is an EasyConnection 8/64-EISA -board. -The I/O (port) address resource is derived from the EISA slot that -the board is in. -Each EISA slot is allocated a section of the I/O address space by the -hardware of the system. -That address being 0xX000 where X is the slot number. -The example board is at memory address 0x80000000 which is 2 Gbyte. -The -.Ar iosiz -parameter specifies the size of the memory region, -in this case 64 kbytes. -.Pp -Each ONboard ISA board requires 16 bytes of I/O space and a 64 kbyte -section of memory address space. -Valid ONboard I/O addresses are in the range 0x200 to 0x300. -A configuration entry for an ONboard ISA would look like: -.Pp -.Cd "stli0 at isa? port 0x240 tty iomem 0xd0000 iosiz 0x10000 flags 4" -.Pp -This entry specifies an ONboard ISA by setting flags to 4. -It uses I/O address 0x240 and a memory region of 64 kbytes at memory -address 0xd0000. -.Pp -Each ONboard/E board requires a 64 kbyte memory region, and this -can be anywhere in the 32 bit address space (that is from 0 to 4 Gbyte). -A configuration entry would look like: -.Pp -.Cd "stli0 at eisa? port 0x3000 tty iomem 0xc0000000 iosiz 0x10000 flags 7" -.Pp -The specifies an ONboard/E in slot 3 using a shared memory address -of 0xc0000000 (3 Gbyte). -.Pp -Each Brumby board requires 16 bytes of I/O address space and a 4 kbyte -region of shared memory space. -The valid Brumby I/O addresses are in the range 0x300 to 0x400. -The shared memory region of the Brumby must be in the 0xc0000 to -0xdc000 region of the memory address space. -A configuration entry for a Brumby would be like: -.Pp -.Cd "stli0 at isa? port 0x360 tty iomem 0xc8000 iosiz 0x4000 flags 2" -.Pp -This specifies a Brumby board at I/O address 0x360 using a shared memory -region at address 0xc8000. -.Sh NOTES -When building the device nodes for the ports be sure to use the correct -driver name, -.Nm stl -or -.Nm stli. -Each driver has a separate major number allocated, -so even though the port device names are the same for each driver, -the major number of the device node is different. -Use the -.Xr MAKEDEV 8 -script to create the devices. -Use the ttyE and cue tag for the -.Nm stl -driver, and -the ttyEi and cuei tags for the -.Nm stli -driver. -.Pp -The intelligent board types (ONboard, Brumby and EasyConnection 8/64) -require a firmware download before the ports will be operational. -This is achieved by using the -.Nm stlload -command. -See its manual page for details on usage. -.Sh FILES -.Bl -tag -width "/dev/staliomem?" -compact -.It Pa /dev/ttyE? -standard callin devices -.It Pa /dev/ttyiE? -initial-state callin devices -.It Pa /dev/ttylE? -lock-state callin devices -.It Pa /dev/cue? -standard callout devices -.It Pa /dev/cuie? -initial-state callout devices -.It Pa /dev/cule? -lock-state callout devices -.It Pa /dev/staliomem? -board control device -.El -.sp -Note that the port numbers start at 0 for port 0 of board 0. -Each board has 64 port slots allocated for it. -So the second boards ports start at 64 and go through 127. -Use the -.Xr MAKEDEV 8 -script to create the devices. -Use the ttyE and cue tag for the -.Nm stl -driver, and -the ttyEi and cuei tags for the -.Nm stli -driver. -.Sh SEE ALSO -.Xr stty 1 , -.Xr termios 4 , -.Xr tty 4 , -.Xr comcontrol 8 , -.Xr MAKEDEV 8 , -.Xr stlload 8 , -.Xr stlstats 8 -.Sh HISTORY -This driver was originally developed by -.An Greg Ungerer Aq gerg@stallion.com . diff --git a/usr.sbin/stallion/stlload/stlload.8 b/usr.sbin/stallion/stlload/stlload.8 deleted file mode 100644 index 51e1197ee177..000000000000 --- a/usr.sbin/stallion/stlload/stlload.8 +++ /dev/null @@ -1,124 +0,0 @@ -.\" Copyright (c) 1996 Greg Ungerer (gerg@stallion.oz.au). -.\" 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. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by Greg Ungerer. -.\" 4. Neither the name of the author nor the names of any co-contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``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 THE AUTHOR OR CONTRIBUTORS 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. -.\" -.Dd December 2, 1996 -.Os FreeBSD -.Dt STLLOAD 8 i386 -.Sh NAME -.Nm stlload -.Nd "Stallion Technologies multiport serial board down loader" -.Sh SYNOPSIS -.Nm stlload -.Op Fl vhVR -.Op Fl i Ar image-file -.Op Fl c Ar control-device -.Op Fl r Ar rx-buf-size -.Op Fl t Ar tx-buf-size -.Op Fl B Ar boot-banner -.Op Fl b Ar unit-number -.Sh DESCRIPTION -.Nm Stlload -is used to download the firmware code to Stallion Technologies intelligent -multiport serial boards. -A firmware download is only required for those boards that use the Stallion -.Nm stli -driver. -This includes the EasyConnection 8/64, ONboard and Brumby families of boards. -.Pp -Different board types require different firmware images. -If the wrong firmware is loaded into a board it will fail to operate. -.Pp -The download process is achieved through the Stallion -.Nm stli -driver control device, -.Pa /dev/staliomem? . -This device implements a file type device that can read and write into the -boards shared memory region. -It also implements a number of special -.Em ioctls -that reset and restart the board. -.Pp -The options are: -.Bl -tag -width indent -.It Fl v -Verbose output generation. -Trace is generated at each phase of the download and startup process. -.It Fl h -Output usage information. -.It Fl V -Output version information. -.It Fl R -Reset the board only. -Does not proceed to download firmware to the board. -.It Fl i Ar image-file -Specify the firmware image file to download. -The default firmware image is -.Pa /usr/libdata/stallion/cdk.sys . -.It Fl c Ar control-device -Specify the board control device through which to download the firmware -and start up the board. -The default is -.Pa /dev/staliomem0 . -.It Fl r Ar rx-buf-size -Specify the size of the boards shared memory Receive Data buffer. -By default the buffer is dynamically sized to use the maximum -available shared memory. -.It Fl t Ar tx-buf-size -Specify the size of the boards shared memory Transmit Data buffer. -By default the buffer is dynamically sized to use the maximum -available shared memory. -.It Fl B Ar boot-banner -Enable the slave debug trace flag during download. -This enables debug trace output from the firmware code. -This trace is output on port 0 of the board, -and the port is set to 9600 baud, 8 data bits, no parity and 1 stop bit. -.It Fl b Ar unit-number -Specify the unit (board) number to be downloaded. The default is to -download board 0. -.El -.Pp -.Nm Stlload -would typically be run from -.Pa /etc/rc.serial . -.Sh FILES -.Bl -tag -width /usr/libdata/stallion/2681.sys -.It Pa /usr/libdata/stallion/cdk.sys -firmware code to EasyConnection 8/64 class boards -.It Pa /usr/libdata/stallion/2681.sys -firmware code to ONboard and Brumby class boards -.It Pa /dev/staliomem? -driver board control device -.Sh SEE ALSO -.Xr stl 4 , -.Xr stli 4 , -.Xr stlstats 8 -.Sh HISTORY -This program was originally developed by -.An Greg Ungerer Aq gerg@stallion.com . diff --git a/usr.sbin/stallion/stlstats/stlstats.8 b/usr.sbin/stallion/stlstats/stlstats.8 deleted file mode 100644 index 05dec3c3a0bf..000000000000 --- a/usr.sbin/stallion/stlstats/stlstats.8 +++ /dev/null @@ -1,135 +0,0 @@ -.\" Copyright (c) 1996 Greg Ungerer (gerg@stallion.oz.au). -.\" 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. -.\" 2. Redistributions in binary form must reproduce the above copyright -.\" notice, this list of conditions and the following disclaimer in the -.\" documentation and/or other materials provided with the distribution. -.\" 3. All advertising materials mentioning features or use of this software -.\" must display the following acknowledgement: -.\" This product includes software developed by Greg Ungerer. -.\" 4. Neither the name of the author nor the names of any co-contributors -.\" may be used to endorse or promote products derived from this software -.\" without specific prior written permission. -.\" -.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``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 THE AUTHOR OR CONTRIBUTORS 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. -.\" -.Dd December 2, 1996 -.Os FreeBSD -.Dt STLSTATS 8 i386 -.Sh NAME -.Nm stlstats -.Nd "Stallion Technologies multiport serial statistics display" -.Sh SYNOPSIS -.Nm stlstats -.Op Fl hVi -.Op Fl c Ar control-device -.Op Fl b Ar board-number -.Op Fl p Ar port-number -.Op Fl d Ar port-device -.Sh DESCRIPTION -.Nm Stlstats -is used to display statistical information about the ports on Stallion -Technologies multiport serial boards. -.Pp -.Nm Stlstats -normally runs as a full screen menu driven application. -A help line is displayed at the bottom of each screen with the valid -input keys for this screen. -.Pp -Generally the digit keys ('0' through '9') specify the number of the -device to display statistics for. -Where digits alone are not enough to access all possible devices -(for example on 16 port panels) then the first letters of the alphabet -are used to access the remaining devices. -The letters 'a' through 'f' are used to access devices 10 through 15. -.Pp -The 'q' key is always used to move back to the previous level screen. -The escape key can also be used to move back to the previous screen. -.Pp -The first screen is a display of all ports on panel 0 of board 0. -Values displayed on this screen are a summary of the information for -each port. The statistics displayed are: driver and TTY state flags, -termios flags (cflags, iflags, oflags, lflags), RS-232 signal values -(as per TIOCM signal defines), total transmit and receive character -counts. -.Pp -From this screen you can look at summary information -about each panel and board installed in the system. -Each board is accessed by the digit keys ('0' through '7'), -while panels of each board can be cycled through using the 'n' key. -.Pp -The per port screen displays some detailed information about a -particular port. -This is accessed from the board screen using the 'p' key. -The first port displayed will be port 0. -To display other ports use the digit and alphabetic keys -('0' through '9' and 'a' through 'f'). -This screen displays: driver and TTY state flags, hardware ID, -termios flags (cflags, iflags, oflags, lflags), -total transmitted and received character counts, -current transmit and receive characters buffered, -receiver error counts (overruns, parity, framing, lost), -software flow control characters transmitted and received, -hardware flow control actions taken, -count of transmitted and received breaks, -modem signal transitions and -current RS-232 signal states. -.Pp -The options are: -.Bl -tag -width indent -.It Fl h -Output usage information. -.It Fl V -Output version information. -.It Fl i -Output only the board type information. -This output is useful for scripts or other programs that need to know -a little bit about the board (for example an automated download script). -.Nm Stlstats -will not enter full screen interactive mode. -.It Fl c Ar control-device -Specify the board control device through which to gather port statistics. -The default is -.Pa /dev/staliomem0 . -.It Fl b Ar board-number -Specify the board number to display first. -The default is to display board 0. -.It Fl p Ar port-number -Specify the port number to display first. -.Nm Stlstats -will go straight into the port display screen (bypassing board display) -when this option is used. -.It Fl d Ar port-device -Specify the port special device file (the -.Pa /dev/ttyXXX -file) to -display first. -The board screen is bypassed and the port statistics screen is shown -immediately on start up. -.El -.Sh FILES -.Bl -tag -width /dev/staliomem0 -.It Pa /dev/staliomem0 -driver control device used for statistics collection -.Sh SEE ALSO -.Xr stl 4 , -.Xr stli 4 , -.Xr stlload 8 -.Sh HISTORY -This program was originally developed by -.An Greg Ungerer Aq gerg@stallion.com . |
