Using the command-line interface Application commands
Digi TransPort® Routers User Guide
146
tcpperm command: establish a permanent serial to IP connection
The tcpperm command is available only as an application command, and has no equivalent web page.
The tcpperm command establishes a permanent “serial to IP” connection between one of the ASY
ports and a remote IP host. After tcpperm executes, the router automatically opens a socket
connection to the remote peer whenever data is received from a terminal attached to the specified
ASY port. When the socket is first opened and the connection is established, the router issues a
CONNECT message to the terminal and subsequently relays data between the socket and the ASY
port. You can modify the format of the CONNECT message using the standard AT commands (such as
ATV, ATE, etc.) or using the web interface page Configuration > Network > Interfaces > Serial >
Serial Port n.
Note Preconfigure the serial port to use the appropriate word format, speed, and flow control.
While the serial-to-IP connection is established, if the attached serial device drops the DTR signal, the
socket connection is terminated, much as with a standard modem or terminal adapter. You can
modify this behavior using the AT&D command or the serial port settings.
The format of the command is:
TCPPERM <[ ASY 0- 1] > <Dest Host > <Dest Por t > [ UDP] [ nodeact ] [ -
l <l i st eni ng por t >] [ - i <i nact _t i meout >] [ - f <f wd_t i me>] [ - e<et h_i p>] [ - d
( deact l i nk) ] [ - k<keepal i ve_t i me>] [ - s<sr c_por t >] [ - ok] [ - t <t el net _
mode>] [ - ho( host onl y) ] [ - ssl ] [ - ao( al ways open) ] [ - m<mhome i dx>]
The tcpperm parameters are as follows:
Parameter Description
ASY
Dest Host
Dest Port
UDP
-ao
-e Use the address of Ethernet port n for the socket connection rather than the
default of the address of the interface over which the socket is opened (that is, ppp
1, ppp 2, etc.)
-d Deactivate link. If non-zero, when the socket is closed and there are no other
sockets using the interface then the interface connection is dropped (switched
connections only).
-f The forwarding time (x10ms) for packetizing data from the serial port.
-ho Host. Indicates that the socket should only accept connections from the specified
host.
-i The inactivity timeout (s) after which the socket will be closed.
-k Keep alive packet timer (s).