Remote serial

RFC 2217 client

Connect to a device server or another RFC 2217 server on a reachable address.

On this page

RFC 2217 client (connect to a remote serial port)

An RFC 2217 client uses a remote serial port as if it were local. Beyond carrying data, it can set the remote baud rate, framing, flow control and DTR/RTS from this end.

The peer can be a device server such as a Moxa NPort or ser2net, or another copy of this application running the RFC 2217 server. A plain TCP socket only carries bytes and cannot negotiate serial parameters.

This machine must be able to reach the peer's IP address and port directly, which usually means the same LAN or an already connected VPN. When the site cannot be reached directly, see Choosing a remote access path.

  1. Pick Remote Serial (RFC 2217) in the Port list.
  2. Enter a LAN or VPN address that the client can reach directly. The port must match the server's listening port.
  3. Connect. After TCP comes up, the status bar should also say The remote port accepted serial parameter control.
  4. Send one known command and verify TX/RX plus the device response before starting the real workflow.
Port set to Remote Serial (RFC 2217) with host 10.127.113.214 and port 4001, with the device response on the right
A direct connection to a ser2net device server; its host and port must be reachable from the client network.

Taking control of the serial parameters

Nothing on the remote changes by default. "Keep the remote port's own configuration" starts ticked, so the parameter fields are disabled. Use this when the device server is already configured.

To take control, clear the tick and set baud rate, data bits, parity, stop bits and flow control. The complete set is sent after agreement; later updates contain only changed fields.

Server replies are recorded but never overwrite the requested values on screen. If the server adjusts a requested baud rate, the status bar reports the rate actually in use.

Client-side checks

  1. The status bar reports a TCP connection and then The remote port accepted serial parameter control. — the first without the second means the peer is not an RFC 2217 server, or its bridge still uses Transparent mode.
  2. After clearing "Keep the remote port's own configuration", change one parameter and confirm the remote physical port follows it.
  3. Send a known command, verify the TX/RX counters change and confirm the device replies.

For garbled data, first verify baud rate, parity and stop bits on the remote physical port. For end-to-end acceptance and layered troubleshooting across both ends, see Connect directly to a remote serial port with RFC 2217.

Gateway mode: join a remote port to a local physical one

To tunnel a remote port to a local physical port, use the bridge's RFC 2217 client protocol. The network end must be a TCP Client aimed at the device server; the other end is the real local serial port.

After agreement, the local port's baud rate, framing, flow control and DTR/RTS are pushed to the remote, keeping both ends on matching parameters.

To operate only the remote port, use the single client connection above instead of this two-ended bridge.

Was this document helpful?