NAME

m332xctl − a control utility

SYNOPSIS

m332xctl {-t|-r|-R|-D|-h< on|off|info> |-g| -s|[-d<dlfile> {-x<sname> ]...-l|-e<fname> }}dev

DESCRIPTION

m332xctl provides a functional control interface to the MVME332XT Communications Controller.  Note that m332xctl provides no support for the MVME332 hardware and firmware architecture.  The following options and fields are interpreted by m332xctl:

-tTest the existence of the MVME332XT.  Return if it exists, else return ENXIO. 

-rGet firmware and driver version and revision numbers.  The designated dev should be the printer device. 

-RGet firmware version number in short format. The designated dev should be the printer device. 

-DDebug mode. 

-gGet downloadable area information from the MVME332XT controller.  The address and size of the download area is displayed.  The designated dev should be the printer device. 

-sGet symbol table of the MVME332XT firmware and display.  The designated dev should be the printer device. 

-hHardware flow control handshaking can be enabled or disabled, and hardware flow control port status can be queried.  Hardware flow control is implemented with the RS232C RTS and CTS handshakes. The default is disabled. 

-dDownload a coff file to the MVME332XT.  The designated dev should be the printer device. 

-xExclude a section when downloading.  Up to sixteen sections may be excluded for a particular download operation.  This option must be preceded by the -d option in the command invocation. 

-lInstruct the MVME332XT firmware to copy the the download line switch table to its internal data structure.  This option must be preceded by the -d option in the command invocation. 

-eInstruct the MVME332XT firmware to execute a user function in a downloaded file.  This option must be preceded by the -d option in the command invocation. 

devMVME332XT serial I/O or printer device.  dev should be the printer device for the -g, -d, -r, -R, -s, -l, and -x options. 

dlfileCoff compatible file that is to be linked to the MVME332XT symbol table before downloading. 

snameSection names to be excluded when dlfile is downloaded. 

fnameFunction within the dlfile that is to be executed. 

To obtain the MVME332XT firmware version and revision number, execute the following m332xctl command, x is the controller number in cxd8:

m332xctl -R /dev/printer/m332_cxd8

This command issues a message of the form:

VR

where V and R are the MVME332XT firmware version and revision numbers, respectively. For example, "129" would be 12.9. 

The m332xctl command

m332xctl -h on /dev/port/m332_cxdy

enables hardware flow control option for the specified serial I/O port. The I/O device to be set is designated by the cxdy field throughout this document, where x and y refer to the MVME332XT controller and port device numbers, respectively. 

Hardware flow control for any MVME332XT serial port may be disabled by issuing

m332xctl -h off /dev/port/m332_cxdy

Hardware flow control is implemented with the RS-232 RTS/CTS signal pairs. In this mode, a serial port transmitter is disabled when its CTS input negates and a receiver negates its RTS output when the associated receive channel character high water mark has been reached. A MVME332XT serial port hardware flow control configuration may be determined with the following m332xctl command. 

m332xctl -h info /dev/port/m332_cxdy

In this example, if hardware flow control is enabled for the specified port, the following message will be sent to standard output.

hardware handshake is enabled

If hardware flow control is disabled for the specified port, the following message will be sent to standard output:

hardware handshake is disabled

To get the start address and size of the MVME332XT download area, use the following m332xctl command:

m332xctl -g /dev/printer/m332_cxd8

where /dev/printer/m332_cxd8 must be the MVME332XT printer device.  This restricts downloading and download area information access to root. 

The following information is displayed in response to the previous command:

Downloadable area start address = AAAA, size = SSSS

The downloadable coff file should be linked to the displayed start address before downloading to the MVME332XT firmware, using the following syntax:

m332xctl -d dlfile /dev/printer/m332_cxd8

where dlfile is the coff file to be downloaded and /dev/printer/m332_cxd8 is the MVME332XT printer device name, required for security purposes. 

To exclude sections of dlfile during the download operation, use

m332xctl -d dlfile -x sname1 ... -x snamen /dev/printer/m332_cxd8

where sname1, ..., and snamen are the section names that are to be excluded during the download operation.  The m332xctl command supports up to 16 excluded section names using the syntax shown. 

The MVME332XT firmware supports user supplied line disciplines via the m332xctl -d and -l options, which allow the downloaded line switch table to be copied to the MVME332XT firmware data structures, as follows:

m332xctl -d dlfile -l /dev/printer/m332_cxd8

where dlfile is the download file name and /dev/printer/m332_cxd8 is the MVME332XT printer device special file name, as before.  The downloaded dlfile must contain the following symbols:

Refer to mvme332xt(7) for discussion regarding linesw table structure.  Notice that the linesw table structure defined in mvme332xt(7) differs from that described in /usr/include/sys/conf.h.  Intimate familiarity with the MVME332XT firmware architecture is required to successfully port a user developed line discipline. 

To download a coff file, dlfile, to the MVME332XT and execute a downloaded function, fname, use the following syntax:

m332xctl -d dlfile -e fname /dev/printer/m332_cxd8

where dlfile is the downloaded file, fname is the function to be executed by the MVME332XT firmware, and /dev/printer/m332_cxd8 is the MVME332XT printer device name.  Refer to mvme332xt(7) for more information regarding special file naming conventions. 

The -D option enables the debug mode.  Option -DD enables the debug mode at level 2, which results in more comprehensive debug messages.  Either mode is useful for monitoring a downloading operation and for debugging user developed lineswitch and function routines. 

FILES

/dev/port/m332_c∗d∗, /dev/printer/m332_c∗d8

SEE ALSO

stty(1), ioctl(2), mvme332xt(7).  termio(7), tty(7). 
MVME332XT Serial Intelligent Peripheral Controller Firmware User’s Manual.