NAME    [Toc]    [Back]

     stlload -- Stallion Technologies multiport serial board down loader

SYNOPSIS    [Toc]    [Back]

     stlload [-vhVR] [-i image-file] [-c control-device] [-r rx-buf-size]
	     [-t tx-buf-size] [-B boot-banner] [-b unit-number]

DESCRIPTION    [Toc]    [Back]

     The stlload utility 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 stli driver.	This
     includes the EasyConnection 8/64, ONboard and Brumby families of boards.

     Different board types require different firmware images.  If the wrong
     firmware is loaded into a board it will fail to operate.

     The Stallion EasyConnection 8/64 Host Adapter PCI cards DO NOT require
     firmware to be loaded.

     The download process is achieved through the Stallion stli driver control
     device, /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 ioctls that reset and restart the board.

     The options are:

     -v      Verbose output generation.  Trace is generated at each phase of
	     the download and startup process.

     -h      Output usage information.

     -V      Output version information.

     -R      Reset the board only.  Does not proceed to download firmware to
	     the board.

     -i image-file
	     Specify the firmware image file to download.  The default
	     firmware image is /usr/libdata/stallion/cdk.sys.

     -c control-device
	     Specify the board control device through which to download the
	     firmware and start up the board.  The default is /dev/staliomem0.

     -r 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.

     -t 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.

     -B 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.

     -b unit-number
	     Specify the unit (board) number to be downloaded.	The default is
	     to download board 0.

     The stlload utility would typically be run from /etc/rc.serial.

FILES    [Toc]    [Back]

     /usr/libdata/stallion/cdk.sys   firmware code to EasyConnection 8/64
				     class boards

     /usr/libdata/stallion/2681.sys  firmware code to ONboard and Brumby class
				     boards

     /dev/staliomem?		     driver board control device

SEE ALSO    [Toc]    [Back]

     stl(4), stli(4), stlstats(8)

HISTORY    [Toc]    [Back]

     This program was originally developed by Greg Ungerer
     <gerg@stallion.com>.


FreeBSD 5.2.1		       December 2, 1996 		 FreeBSD 5.2.1