# Setup Port

## Enabled

These radio button will activate or deactivate the SETUP PORT.

## Speed

Select 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200 Baud Rate.
Default is 19200 for SETUP port. This should be configured to match the settings of the connected device.

## Data bits

Number of bits making up the data word. Set according to Host configuration. Default is 8. This should be configured to match the settings of the connected device.

## Stop bits

Marks the end of the serial port data byte. Default is 1. This should be configured to match the settings of the connected device.

## Parity

Added to identify the sum of bits as odd or even. Default is none. This should be configured to match the settings of the connected device.

## DCD Control

The DCD (Data Carrier Detect) line can be set for one of the following: Always Asserted, Never Asserted, or Envelope Mode (the DCD will be asserted only when data is present at the serial port).

## Packet Forwarding Threshold

Mark Character time allows the user to change time based on the character length to forward the packet.

## Flow Control

Allows the user to implement RTS/CTS flow control or no flow control. Note: Request to Send and Clear to Send flow control will require a 5 wire connection to the setup port.

## Connection Control

Select "Permanent (3-wire)" when the serial port is always enabled or "Switched (DTR bringup/teardown) when DTR is used to enable/disable the serial connection. This should be configured to match the settings of the connected device.

## IP Gateway Service

CLI Service (Command Line Interface)-RS-232 connection to Host PC
Access to the Command Line Interface command shell is password protected and is reserved for authorized NextGenRF maintenance personnel.

Serial/RF Bridge - DOX mode - 3 wire connection. Data is sent whenever it is present at the port. Flow control is not required. The IP Gateway service will use UDP transport protocol to send and receive messages.

Online Diagnostics - TCP/IP based RF diagnostics.

Custom - Choosing Custom enables the user to specify the IP Gateway Transport configuration.

The defaults is CLI Service for SETUP port.

## IP Gateway Transport

The user can customize the IP settings by selecting "IP Gateway Service -> Custom". Choose the socket connection mode from the drop-down list and configure the IP settings.

| UDP MODE | TCP CLIENT MODE | TCP SERVER MODE | TCP CLIENT/SERVER MODE
Local IP Address | Required Value * 0.0.0.0 (let IP stack decide) OR * IP address of Ethernet or RF interface. | Required Value * 0.0.0.0 (let IP stack decide) OR * IP address of Ethernet of RF interface. | Required Value * 0.0.0.0 (let IP stack decide) OR * IP address of Ethernet of RF interface. | Required Value * 0.0.0.0 (let IP stack decide) OR * IP address of Ethernet or RF interface.
Local Port Number | Required Value * 1 - 65535 Do not use 20,21,23, 123,520,5002 | Unused Value * IP stack decides the value. | Required Value * 1 - 65535 Do not use 20,21,23, 123,520,5002 | Required Value * 1 - 65535 Do not use 20,21,23, 123,520,5002
Remote IP Address | Required Value * Unicast IP address OR * Broadcast IP address OR * Multicast IP address | Required Value * Unicast IP address | Unused Value * N/A | Required Value * Unicast IP address
Remote Port Number | Required Value * 1 - 65535 | Required Value * 1 - 65535 | Unused Value * N/A | Required Value * 1 - 65535
TCP Keepalive | Unused | Optional Value * 0 - 1440 (minutes) (0:TCP Keepalive disabled). | Optional Value * 0 - 1440 (minutes) (0:TCP Keepalive disabled). | Optional Value * 0 - 1440 (minutes) (0:TCP Keepalive disabled).

### UDP Mode

In this mode of operation, all UDP packets addressed to the "local IP address" and to the "local port number" are sent over the serial interface. Any data received from the serial interface is sent (in the form of a UDP packet) to the remote endpoint identified by "remote IP address" and "remote port number".
Local IP Address
Local Port Number
The "local port number" and "local IP address" parameters are used in reception to indicate which UDP packets are to be sent to the serial port.
The "local port number" and "local IP address" parameters are used in transmission to set the source IP address of the IP header and the source port number of the UDP packet.
Remote IP Address
Remote Port Number
The "remote port number" and "remote IP address" parameters are used in transmission to set the destination IP address of the IP header and the destination port number of the UDP packet.

### TCP Client Mode

In this mode of operation, the Viper (local endpoint) tries to establish a TCP connection with a TCP server (remote endpoint). Once the TCP connection is established, any data received from the remote endpoint is sent over the serial interface. Any data received from the serial interface is sent to the remote endpoint.
Local Port Number
Local IP Address
These two parameters are used to identify the local endpoint. The IP stack decides automatically the value assigned to the local port number. The user can let the IP stack decide the value of the local IP address (local IP address = 0.0.0.0) or can select a specific local IP address (as long as it is the IP address of one of the interfaces, Ethernet or RF).
Remote Port Number
Remote IP Address
These two parameters are used to identify the remote endpoint (TCP server).

### TCP Server Mode

In this mode of operation, the Viper acts as a TCP server. It can accept up to 256 TCP connections from remote endpoints. Data received from any remote endpoint is sent over the serial port. Data received from the serial port is sent to every remote endpoint connected to the TCP server.
Local Port Number
The user must set the local port number parameter. It identifies the port used by the TCP server when accepting connections from remote endpoints.
Local IP Address
The local IP address parameter can be left to 0.0.0.0 or set to the IP address of one of the interfaces (Ethernet or RF).
If the user sets the local IP address parameter to 0.0.0.0, the TCP client can connect to the TCP server by using either the RF or Ethernet IP address of the Viper.
If the user sets the local IP address parameter to a specific IP address, the TCP client must connect to the TCP server using this IP address when trying to establish the connection.
Remote Port Number
Remote IP Address
In TCP Server Mode, these parameters are unused.

### TCP Client/Server Mode

In this mode of operation, the Viper acts as both a TCP server and a TCP client. Data received from any remote endpoint is sent over the serial port. Data received from the serial port is sent to every remote endpoint connected to the TCP client/server.
Local Port Number
Local IP Address
These parameters are used to define the TCP server.
Remote Port Number
Remote IP Address
These parameters are used to define the TCP client.
The Viper will try to establish a TCP connection to the remote endpoint defined by these two parameters when there is data received on the serial port AND there are no TCP connections already established.

### TCP Keepalive

The TCP Keepalive feature will transmit a short Keepalive message to test the TCP connection if there is no data transferred through an open TCP connection after X number of minutes. If the keepalive message is received successfully by the remote endpoint the TCP connection will remain open. If the keepalive message is not received successfully the Viper will close the existing TCP connection.
To disable this feature, set the TCP Keepalive to "0". With the TCP Keepalive feature disabled, the Viper will leave the TCP connection open indefinitely. An existing TCP connection will only close if the remote endpoint closes the connection, the Viper's serial port is disabled, or if the Viper is unable to successfully communicate with the remote endpoint during a data transmission.

### TCP Server Control

One client:
Limit the amount of TCP clients to 1. If this option is not checked, the limit of TCP clients is 256.
Replace old client:
When the maximum amount of TCP clients is reached, the TCP server can decide to drop an old TCP client in favor of a new TCP client. If this option is selected and there is a new TCP client connecting to the TCP server and the maximum amount of client is already reached, the TCP server will shutdown an old TCP client to make room for the new one (otherwise the new one will fail to connect).

### Limit to interface

Limit the access to the serial port to only a special class of packets.
When this option is selected AND a specific "Local IP Address" is selected, enforce the following rules:
Ingress packets: Destination IP address of packets must be equal to the IP address of the specified interface. If VLAN mode is enabled, the incoming packet must have a VLAN ID matching the interface's PVID.
Egress packets: The source IP address of outgoing packets will be set to the IP address of the specified interface. If the specified interface as a PVID, the VLAN ID set in the packet will be equal to the interface PVID.

Back to Top