Contents:
The
STALPORT Utility
As part of the driver installation, a utility
called STALPORT.EXE is installed on the system. It may be used
for troubleshooting various serial problems. It should have been installed
into your %System Root% \system32 directory (eg. c:\winnt\system32)
when you installed the driver.
To run Stalport, perform the following:
Step 1. Open a Command Window
via Start > Programs > Command Prompt.
Step 2. Type stalport
and press <enter>.
The stalport command line options are displayed.
Stalport
Messages & Flags
The stalport usage message and its flags are
listed below:
Usage - stalport -c <COM DEVICE NUMBER>
-v - display version numbers
-h - output help screen
[-]draintimeout <N> - set TX drain
timeout to N miliseconds
[-]rxthold <N> - set RX FIFO threshold
to N
[-]fakedsr - enable/disable DSR reported
as always high
[-]writes_waitdrain - enable/disable hold
writes until data drains out
[-]rtslock - enable/disable port locked
into using RTS receive flow control
[-]ctslock - enable/disable port locked
into using CTS transmit flow control
[-]loopback - enable/disable UART into
internal loopback mode
[-]dtrfollow - enable/disable
DTR pin following TX data
[-]rtsfollow - enable/disable RTS pin
following TX data
[-]fakedcd - enable/disable DCD reported
as always high
[-]norxwhentx - enable/disable data reception
when transmitting
[-]rximin <N> - set RX interrupt
buffer min count to N chars
[-]rxitime <N> - set RX interrupt buffer
max wait time
The
flags are detailed below:
draintimeout
Sets the close drain timeout period in miliseconds. This is the amount
of time after a port has been asked to perform a close with data waiting
to drain out that the port will force a real close. After the drain
timeout period has expired all data waiting to drain will be discarded
and the close will be completed.
rxthold
Set the RX FIFO threshold on the raw UART device. Useful values will
depend on the type of port UART this is applied to. On the SC26198
UART (XP panels and later EasyIO models then values from 1 to 16 are
valid. On the CD1400 UART (non-XP panels and earlier model EasyIO) values
from 1 to 12 are valid.
fakedsr
This can be used to force the driver to always report the DSR signal
as high if the signal is present on the Stallion port.
Note that only the EasyConnection 8D4 "Dual Interface" module and EasyIO
boards prior to Revision 3 have the DSR signal. The DSR signal is always
reported as high on Stallion ports with no DSR signal. Use of this flag
may be necessary if an application uses the DSR signal and the signal
is present on the Stallion port but not connected.
writes_waitdrain
This can be used so the driver will only complete a write after the
data has been effectively transmitted.
rtslock
Lock the port into using RTS flow control (this is flow control of the
receiver).
ctslock
Lock the port into using CTS flow control (this is flow control of the
transmitter).
loopback
Sets the UART device of the port into internal loop back mode.
In this state all data transmitted from the device is internally looped
to the devices input. This means that any transmitted data is also received
on this port.
dtrfollow
Enable the DTR pin to follow data transmission. This means that if data
is being transmitted then the DTR line will be asserted, otherwise it
will not be asserted. This is very useful when using the RS-485 EasyConnection
panels - since the DTR signal enables and disables the transmitter.
rtsfollow
Enable the RTS pin to follow data transmission. This means that if data
is being transmitted then the RTS line will be asserted, otherwise it
will not be asserted. This can be very useful when using the RS-485
EasyConnection panels.
fakedcd
The driver will always return DCD as being asserted. This is a useful
way to avoid the usual open actions of waiting for carrier.
norxwhentx
Disables the port receiver whenever data is being transmitted. This
means that no data on the receive line of the port will be received
when the port is actively transmitting data. This is useful when using
the EasyConnection RS-485 panels and the application controlling the
port does not wish to receive its own transmissions.
rximin
Set the RX interrupt buffer minimum character count. This value is a
recommendation to the lowest level hardware driver of how many characters
it should wait for before sending the data to the application.
rxitime
Set the RX interrupt buffer maximum wait time. This value is a recommendation
to the lowest level hardware driver of how long to wait for more data
to arrive before passing that data up to the application.
Port flags modifications will take effect at
the time that the port is next opened. A record of the last modified
values is kept in the Registry so that the modifications will be retained
across re-boots. Port flag modifications might only need to be re-applied
in the case that the driver is removed and re-installed or in the case
that the COM DEVICE NUMBER to board/panel/physical port mapping changes.
Go to Top
of Page
