NAME

m337ctl − an MVME337 controller utility

SYNOPSIS

m337ctl {-t|-p|-r|-R|-D|-h on|off|info |[-d dlfile {-x sname ]...-l|-e fname }} dev

DESCRIPTION

m337ctl provides a functional control interface to the MVME337 Communications Controller.  The following options and fields are interpreted by m337ctl:

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

-pDump the internal state of the MVME337 download for the device port.  Must be root. 

-rGet firmware and driver version and revision numbers.  Revisions of individual firmware routines is not supported. 

-RGet firmware version number in short format. 

-DDebug mode. 

-h on|off|infoSet/Reset/Get Current Status of hardware flow control handshaking on a per port basis.  Hardware flow control is implemented with the RS232C RTS and CTS handshakes.  The default is disabled. 

-d dlfileDownload a COFF file to the MVME337.  The designated dev can be any MVME337 device port.  Only a super user can use this option. 

-x snameExclude 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 MVME337 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. 

-e fnameInstruct the MVME337 firmware to execute a user function in a downloaded file.  This option must be preceded by the -d option in the command invocation.  Only a super user can use this option. 

devMVME337 serial I/O device.  dev can be any MVME337 device port for the -d, -l, -e, -r, -R, and -x options. 

dlfileCOFF compatible file that is to be linked to the MVME337 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 MVME337 firmware version and revision number, execute the following m337ctl command, x is the controller number in cxd0:

m337ctl -R /dev/port/m337_cxd0

This command issues a message of the form:

V.R

where V and R are the MVME337 firmware version and revision numbers, respectively. For example, firmware version "7080" would be displayed as 70.80. 

The m337ctl command

m337ctl -h on /dev/port/m337_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 MVME337 controller and port device numbers, respectively. 

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

m337ctl -h off /dev/port/m337_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. An MVME337 serial port hardware flow control configuration may be determined with the following m337ctl command. 

m337ctl -h info /dev/port/m337_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 download the COFF file to the MVME337 use the following syntax:

m337ctl -d dlfile /dev/port/m337_cxdy

where dlfile is the COFF file to be downloaded and /dev/port/m337_cxdy is the MVME337 device port name. 

To exclude sections of dlfile during the download operation, use

m337ctl -d dlfile -x sname1 ... -x snamen /dev/port/m337_cxdy

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

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

m337ctl -d dlfile -l /dev/port/m337_cxdy

where dlfile is the download file name and /dev/port/m337_cxdy is the MVME337 device port name, as before.  The downloaded dlfile must contain the following symbols:

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

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

m337ctl -d dlfile -e fname /dev/port/m337_cxdy

where dlfile is the downloaded file, fname is the function to be executed by the MVME337 firmware, and /dev/port/m337_cxdy is the MVME337 port device name.  Refer to mvme337(1M) 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/m337_c∗d∗

SEE ALSO

stty(1), mvme337(1M), ioctl(2), mvme337(7), termio(7), tty(7). 
MVME337 I/O Engine User’sManual. 
MVME337BUG 337Bug Deubugging Package User’s Manual.