NavCom Sapphire Rev.J - Manual (Page 102)

Sapphire Technical Reference Manual Rev. J
102
1.51 ETHVCOM (ASCII)
SF-3050 Sapphire SF-3040
This command enables or disables the Ethernet Virtual COM port server application, and may
also establish an EVCOM connection with a specific remote user or terminate an existing
connection.
An Ethernet Virtual Com port (EVCOM) is similar to an ASYNC serial com port and supports the
same set of commands/responses as a serial COM port. It operates in a server/client mode to
provide this service to remote clients.
The data stream is encapsulated in IP packets and can be configured to use either the UDP or
TCP transport protocol. An IP packet may contain one or more complete message(s) or
response(s), a fragment of a message, or any combination of these. It is simply a stream of data
that is arbitrarily segmented into one or more UDP or TCP packets.
There are four logical ports that may be used by the EVCOM application (ETH1 – ETH4) for
scheduling messages or sending responses to received input commands. Each of the logical
ports can be individually configured for operation mode (TCP or UDP), IP port number,
scheduled messages, and remote endpoints (client applications), providing four independent
data streams.
ETHVCOM is a system command, and the setting is stored in system NVRAM.
Command:
[ETHVCOM] on_off, remote IP address, remote UDP/TCP port, mode, local
UDP/TCP port, logical port
Parameter Definition
on_off
Keyword that enables (ON) or disables (OFF) the virtual COM port functionality on
the logical port
Remote IP
address
In UDP2 mode, this specifies the IP address of the remote user the unit will respond
to. In a status message, this specifies which user the unit is connected to. If the
command is entered with an IP address of 0.0.0.0, the unit breaks any current
connection and listens for a new connection from any remote user.
Remote port
In UDP2 mode, this specifies the port number of the remote user the unit will respond
to. In a status message, this specifies which user the unit is connected to. If the
remote IP address is non-zero, the remote port must also be non-zero.
Range: 0
– 65535. Normally, the remote port is determined by the incoming
UDP/TCP header source port. When configuring the port manually, keep in mind the
IANA has reserved ports 0
– 1023, and these ports should be avoided.
Local port
If non-zero, specifies the local UDP/TCP port number the ETHVCOM task will listen
on (range: 0
– 65535). The IANA has reserved ports 0 – 1023 for specific purposes
(e.g., FTP, telnet, Web servers) and these ports should be avoided.
Logical port
ETH1, ETH2, ETH3, or ETH4. This is the logical port to be used by ETHVCOM for
requesting or scheduling messages.
Mode Identifies the ETHVCOM task transport protocol (see Table 63)