diff options
author | David Nugent <davidn@FreeBSD.org> | 1997-03-13 04:21:44 +0000 |
---|---|---|
committer | David Nugent <davidn@FreeBSD.org> | 1997-03-13 04:21:44 +0000 |
commit | 3875dc8d63f848c0c090313fb48a347902b387dd (patch) | |
tree | 50fc6ef7c84a652c4639d34b92c917e2e550c96b /usr.sbin/stallion/stlload | |
parent | 4511a3a921c1477e0f3ab48e0d47256903e70a01 (diff) | |
download | src-3875dc8d63f848c0c090313fb48a347902b387dd.tar.gz src-3875dc8d63f848c0c090313fb48a347902b387dd.zip |
Submitted by: Greg Ungerer <gerg@stallion.oz.au>
Add manpages for stl, stli drivers.
Add manpages for stlload, stlstats.
Update stli bootcode.
Update stlload, stlstats to revision 1.0.0 from author.
Notes
Notes:
svn path=/head/; revision=23831
Diffstat (limited to 'usr.sbin/stallion/stlload')
-rw-r--r-- | usr.sbin/stallion/stlload/Makefile | 4 | ||||
-rw-r--r-- | usr.sbin/stallion/stlload/stlload.8 | 121 | ||||
-rw-r--r-- | usr.sbin/stallion/stlload/stlload.c | 4 |
3 files changed, 125 insertions, 4 deletions
diff --git a/usr.sbin/stallion/stlload/Makefile b/usr.sbin/stallion/stlload/Makefile index 99142f234a49..46048a50d477 100644 --- a/usr.sbin/stallion/stlload/Makefile +++ b/usr.sbin/stallion/stlload/Makefile @@ -1,7 +1,7 @@ -# $Id$ +# $Id: Makefile,v 1.3 1997/02/22 16:13:45 peter Exp $ PROG= stlload -NOMAN= #oops +MAN8= stlload.8 CFLAGS+=-DBOOTDIR=\"${BOOTDIR}\" diff --git a/usr.sbin/stallion/stlload/stlload.8 b/usr.sbin/stallion/stlload/stlload.8 new file mode 100644 index 000000000000..6e35ad41fe43 --- /dev/null +++ b/usr.sbin/stallion/stlload/stlload.8 @@ -0,0 +1,121 @@ +.\" 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 +.Pa ioctls +that reset and restart the board. +.Pp +The options are: +.Bl -tag -width xxxxx +.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 /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 /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 Greg Ungerer (gerg@stallion.com). diff --git a/usr.sbin/stallion/stlload/stlload.c b/usr.sbin/stallion/stlload/stlload.c index bbecb656d254..4838ce3a1b56 100644 --- a/usr.sbin/stallion/stlload/stlload.c +++ b/usr.sbin/stallion/stlload/stlload.c @@ -33,7 +33,7 @@ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. * - * $Id$ + * $Id: stlload.c,v 1.5 1997/02/22 16:13:45 peter Exp $ */ /*****************************************************************************/ @@ -51,7 +51,7 @@ /*****************************************************************************/ -char *version = "0.0.5"; +char *version = "1.0.0"; char *defdevice = "/dev/staliomem%d"; char *image = BOOTDIR "/cdk.sys"; char *oldimage = BOOTDIR "/2681.sys"; |