Host Serial Interfaces¶

The xPico 200 series gateway provides UART and USB (Host mode) ports to enable communication with a connected host microcontroller or another system.

UART¶

The gateway provides one UART interface for asynchronous serial communication with the microcontroller. The UART is used for device control, data communication, and debug logging.

The UART interface maps to Line 1 on the gateway. It supports asynchronous data rate up to 4 Mbps, odd/even parity, 1 and 2 stop bits, software flow control (Xon/Xoff), and hardware flow control (RTS, CTS).

In order to set up the UART serial interface, configure the Line 1 settings.

In Web Manager, go to Line > Line 1 > Configuration.

For CLI, see Config Line Level.

For XML, see configgroup Line.

Line Configuration Settings¶

The following table describes the Web Manager Line configuration settings.

Links to the equivalent settings for the CLI and XML reference are listed below.

CLI settings: See Config Line Level

XML settings: See configgroup Line

Settings	Description
Name	Name or short description for the line, if desired. By default, there is no name specified. A name that contains white space must be surrounded by quotations.
Interface	Serial Interface. Choices are: RS232, RS485 Half Duplex, and RS485 Full Duplex.
Tx to Rx Delay	Entered in milliseconds, the Tx to Rx delay can be specified for the RS485 Half-Duplex (2-wire) mode. This is the delay after sending the last character out the wire, before switching to receive mode.
State	Operational state of the Line. Can be Enabled or Disabled. The default is Enabled.
Protocol	Operational protocol for the Line. Choices are: - Command Line - MQTT - Mux - None - SLIP - Trouble Log - Tunnel See Line Operating Modes
Baud Rate	Baud Rate (bits per second) of the Line. The default is 9600. Any standard speed between 9600 and 4000000 may be selected. You may also select a custom baud rate and enter any value between 9600 and 4000000.
Parity	Parity of the line. The default is None. Note: Serial lines do not support the following Data Bit/Parity combinations: - 7 Data Bits with No Parity and 1 Stop Bit - 8 Data Bits with 2 Stop Bits.
Data Bits	Number of data bits for the Line. The default is 8. Note: Serial lines do not support the following Data Bit/Parity combinations: - 7 Data Bits with No Parity and 1 Stop Bit - 8 Data Bits with 2 Stop Bits.
Stop Bits	Number of stop bits for the Line. The default is 1.
Flow Control	Flow control for the Line. Choices: None, Hardware, Software. The default is None. Hardware flow control is only supported on Line 1.
Xon Char	When Flow Control is set to Software, Xon Character prefix must be set in one of three ways: Prefix decimal with a backslash (\17) Prefix hexadecimal with 0x (0x11) Prefix control character with (Q)
Xoff Char	When Flow Control is set to Software, Xoff Character prefix must be set in one of three ways: Prefix decimal with backslash (\19) Prefix hexadecimal with 0x (0x13) Prefix control character with (S)
Gap Timer	Gap timer is the delay in milliseconds to pass from the last character received, before the driver forwards the received serial bytes. By default, the delay is four character periods at the current baud rate (minimum 1 msec). Gap Timer range is 1 to 5000 milliseconds.
Threshold	Number of threshold bytes which need to be received in order for the driver to forward received characters. Default value is 56 bytes.
Push	If defined, the driver will forward received characters after the Push sequence of characters is received. An example would be <J>

USB¶

The xPico 200 series gateway has one USB 2.0 port that supports Host and Device modes. The USB interface allows connection and communication over USB. The gateway supports USB CDC/ACM communication device class. The xPico 200 must be configured for either USB Device mode or USB Host mode. It cannot be configured in both modes at the same time.

USB Host Mode¶

To enable USB Host mode:

USB Host mode must be enabled via CLI or XML.

1. Pull the USB_H/D_SEL pin low for Host mode as described in the xPico 200 Series Integration Guide. This is done with JP3 on the evaluation board. Pull CP1 and CP2 high as well.
   Note: When using USB Host Mode, CP1 and CP2 control signals have to be enabled for this function and integrated in the design as outlined in the Integration Guide.
2. In the CLI, enable USB Host mode by executing the following commands:
   • config
   • USB Host
   • state enabled
   • write
     For XML, see configgroup USB Host.
3. Enable the Configurable Pin role USB Host Overcurrent, which is set to CP1. See Configurable Pin Manager for more information.
4. Enable the Configurable Pin role USB Host Power Enabled and assign it to a CP. See Configurable Pin Manager for more information.
5. Reboot the device.

When a CDC Serial Device connects to the USB Host port, it will be associated with Line HOST_CDC_ACM. For example, in the Web Manager, the module is displayed as Line HOST_CDC_ACM. It is configured the same as Line 1 and it supports all line protocols that are supported by Line 1.

USB Device Mode¶

To enable USB Device mode:

USB Device mode must be enabled via CLI or XML.

1. Pull the USB_H/D_SEL pin high for Device mode as described in the xPico 200 Series Integration Guide. This is done with JP3 on the evaluation board.
2. In the CLI, enable USB Device mode by executing the following commands:
   • config
   • USB Device
   • state enabled
   • write
     For XML, see configgroup USB Device.
3. Reboot the device.

The gateway will be enumerated as a virtual COM port. For example, in the Web Manager, the module is displayed as Line CDC_ACM. It is configured the same as Line 1 and it supports all line protocols that are supported by Line 1.

Line HOST_CDC_ACM and Line CDC_ACM Configuration Settings¶

The following table describes the Web Manager Line HOST_CDC_ACM and Line CDC_ACM configuration settings.

Links to the equivalent settings for the CLI and XML reference are listed below.

CLI settings: See Config Line Level

XML settings: See configgroup Line

Settings	Description
Name	Name or short description for the line, if desired. By default, there is no name specified. A name that contains white space must be surrounded by quotations.
State	Operational state of the Line. Can be Enabled or Disabled. The default is Enabled.
Protocol	Operational protocol for the Line. Choices are: - Command Line - Percepxion Interface - Modem Emulation - Monitor - Mux - None - Trouble Log - Tunnel See Line Operating Modes
Gap Timer	Gap timer is the delay in milliseconds to pass from the last character received, before the driver forwards the received serial bytes. By default, the delay is four character periods at the current baud rate (minimum 1 msec). Gap Timer range is 1 to 5000 milliseconds.
Threshold	Number of threshold bytes which need to be received in order for the driver to forward received characters. Default value is 56 bytes.
Push	If defined, the driver will forward received characters after the Push sequence of characters is received. An example would be <J>

Virtual Line Interface¶

The virtual line interface sets up a virtual port on the Line 1 serial port. You can configure 2 virtual lines, 1 and 2, and define the protocol and other line settings.

Mux provides commands for sending and receiving data on multiple network connections. Mux offers simultaneous access to virtual lines and each virtual line may operate in any of the gateway's line protocols.

Use the serial terminal to open a virtual connection with Mux commands. The virtual connection establishes the configured Line protocol on the virtual port.

To send and receive data on the configured virtual line:

1. Set the Line 1 protocol to Mux.
2. Configure Line Virtual_1 or Virtual_2 to the desired protocol. For example, this could be Tunnel.
3. Configure any other necessary settings for the protocol assigned to the virtual line. For example, configure Percepxion settings, etc.
4. Use the serial terminal to open a virtual connection. The virtual connection establishes the configured Line protocol on the virtual port. See Mux Reference for details on Mux commands to create a virtual connection.

Virtual Line Configuration Settings¶

The following table describes the Web Manager Line configuration settings.

Links to the equivalent settings for the CLI and XML reference are listed below.

CLI settings: See Config Line Level

XML settings: See configgroup Line

Virtual Line Setting	Description
Name	Name or short description for the line, if desired. By default, there is no name specified. A name that contains white space must be surrounded by quotations. May contain up to 25 characters.
State	Operational state of the serial line. Enabled or Disabled. The default is Enabled.
Protocol	Operational protocol for the Line. Choices are: - Command Line - Percepxion Interface - Modem Emulation - Monitor - Mux - None - Trouble Log - Tunnel. See Line Operating Modes.
Gap Timer	Gap Timer is the delay in milliseconds to pass from the last character received, before the driver forwards the received serial bytes. By default, the delay is four character periods at the current baud rate (minimum 1 msec). Gap Timer range is 1 to 5000 milliseconds.
Threshold	Number of threshold bytes which need to be received in order for the driver to forward received characters. Default value is 56 bytes.
Push	If defined, the driver will forward received characters after the Push sequence of characters is received. An example would be <J>

SPI Slave¶

The gateway provides a SPI (Serial Peripheral Interface) slave interface. SPI is a serial communication interface used to communicate between devices over short distances. It uses a master/slave architecture in which a master device can communicate with multiple slave devices. The SPI Protocol interface implemented on top of the SPI Slave interface is called "gSPI" and provides the framing/data link layer for communication on top of the SPI interface. The host processor will need a port of the provided reference protocol implementation as well as a driver for the SPI master controller of the attached host uC.

Enabling this feature exposes four virtual channels that are configured independently as separate line interfaces - Line gSPI_1, Line gSPI_2, Line gSPI_3, and Line gSPI_4. A different line protocol can be configured on each channel, allowing a host application to drive separate streams to the device.

To use SPI Slave, an SPI Master driver needs to be implemented on the Host/Master MCU. Contact Lantronix Support for the reference SPI Master driver package (to be used under NDA).

To enable SPI Slave:

To enable SPI Slave, the xPico 200 series gateway must be enabled for SPI Slave mode. To do this, pull the SDIO_MODE/SPI_SLAVE_MODE pin low. On the evaluation board, this is done on JP4. See the xPico 200 Series Evaluation Kit User Guide for more information. Integration details are described in the xPico 200 Series Integration Guide.

Line gSPI_x Configuration Settings¶

The following table describes the Web Manager Line gSPI_1, Line gSPI_2, Line gSPI_3, and Line gSPI_4 configuration settings.

Links to the equivalent settings for the CLI and XML reference are listed below.

CLI settings: See Config Line Level

XML settings: See configgroup Line

Settings	Description
Name	Name or short description for the line, if desired. By default, there is no name specified. A name that contains white space must be surrounded by quotations.
State	Operational state of the Line. Can be Enabled or Disabled. The default is Enabled.
Protocol	Operational protocol for the Line. Choices are: - Command Line - Percepxion Interface - Modem Emulation - Monitor - Mux - None - Trouble Log - Tunnel See Line Operating Modes
Gap Timer	Gap timer is the delay in milliseconds to pass from the last character received, before the driver forwards the received serial bytes. By default, the delay is four character periods at the current baud rate (minimum 1 msec). Gap Timer range is 1 to 5000 milliseconds.
Threshold	Number of threshold bytes which need to be received in order for the driver to forward received characters. Default value is 56 bytes.
Push	If defined, the driver will forward received characters after the Push sequence of characters is received. An example would be <J>

SPI Master¶

The gateway provides a Serial Peripheral Interface bus in master mode. SPI is a serial communication interface used to communicate between devices over short distances. It uses a master/slave architecture in which a master device can communicate with multiple slave devices.

In order to set up SPI Master, configure the SPI settings to match your device's configuration. Use the SPI API through the SDK by setting Protocol to None. See the SDK User Guide for more information. Use SPI with the Monitor feature by setting Protocol to Monitor. See Monitor for more information.

In high-speed mode, SPI master will operate at a speed between 1221 Hz and 20 MHz. Otherwise it will operate at a speed between 500 Hz and 50 kHz.

To operate in high-speed mode, SPI must be configured with the following specific settings. If any settings differ, it will not operate in high-speed mode.

High-speed mode configuration:

• CS Active: Low
• Idle Clock Level: Low
• Clock Edge: First

SPI 1 Configuration Settings¶

The following table describes the Web Manager SPI 1 configuration settings. In Web Manager, go to SPI > SPI 1 > Configuration.

Links to the equivalent settings for the CLI and XML reference are listed below.

CLI settings: See Config SPI Level

XML settings: See configgroup SPI

Settings	Description
Name	This setting is for display purposes only and may be up to 25 characters. It sets a user-defined name for the SPI interface.
State	This is the operational state of SPI and can be Enabled or Disabled. The default is Disabled.
Protocol	The protocol can be set to Monitor or None. The default is Monitor. Setting Protocol to Monitor allows you to use the Monitor feature to query information from the SPI interface. Setting it to None will allow you to use the SPI API.
Target Speed	This sets the target clock speed of the SPI. By default, this is set to <Minimum>. If the value is blanked, it will be set to <Minimum>. If SPI master is configured for high-speed mode (CS Active set to Low, Idle Clock Level set to Low, and Clock Edge set to First), then Target Speed can be between 1221 Hz and 20 MHz. If SPI master is not in high-speed mode, then Target Speed can be configured between 500 Hz and 50 kHz.
CS Active	Chip Select Active can be set to Low or High. Low means CS will idle at a high level and be active at a low level. High means CS will idle at a low level and be active at a high level. Default is Low.
Idle Clock Level	Idle Clock Level is also known as Clock Polarity or CPOL. This can be set to Low or High. Low means that the idle clock is at a low level, equivalent to CPOL=0. High means that the idle clock is at a high level, equivalent to CPOL=1. Default is Low.
Clock Edge	Clock Edge is also known as Clock Phase or CPHA and selects the clock edge for latching data. It can be set to First or Second. Default is First. First means each bit is latched on the first edge of the clock, equivalent to CPHA=0. When Idle Clock Level is Low, data is latched on the rising edge. When Idle Clock Level is High, data is latched on the falling edge. Second means each bit is latched on the second edge of the clock, equivalent to CPHA=1. When Idle Clock Level is Low, data is latched on the falling edge. When Idle Clock Level is High, data is latched on the rising edge.
Bits Per Word	Choices are 8 and 16. Default is 8.
First Transfer	Selects the first transfer bit of each word. Choices are Most Significant Bit and Least Significant Bit. Default is Most Significant Bit.

Line Printer Daemon (LPD)¶

Line Printer Daemon (LPD) is not included in the default firmware. To use LPD, use the SDK to create a project including the lpd module. See the Optional Features chapter of the xPico 200 Series SDK User Guide for more information.

Modbus¶

Modbus is not included in the default firmware. To use Modbus, use the SDK to create a project including the modbus module. See the Optional Features chapter of the xPico 200 Series SDK User Guide for more information.

For CLI, see Status Modbus level and Config Modbus level.

For XML, see configgroup Modbus.

Line Operating Modes¶

Host microcontrollers communicate with the embedded gateway through one or more of the interfaces described earlier. The gateway offers various operating modes that can be applied to these interfaces depending on the device's command and control requirements as well as the data communications requirement.

In order to bind one of the following operating modes to a particular interface, set the "line protocol" within the Line interface configuration as defined below:

• Command Line
• MQTT
• Mux
• None
• SLIP
• Trouble Log
• Tunnel

Command Line Mode¶

Command Line is a line protocol option.

Command Line mode, also referred to as CLI or simply command mode, provides an interface through the UART or USB serial port that allows you to configure and control the gateway.

Commands are structured in hierarchical levels that enable you to configure the device, read and write to the file system, view status, scan for Wi-Fi networks, export and import XML configuration, and view trouble logs, help and documentation.

In order to select this operating mode, set the "line protocol" for the selected interface to "Command Line."

In Web Manager, go to Line.

For CLI, see Config Line Level.

For XML, see configgroup Line.

Using the Command Line Interface

See Configuration and Setup for details on accessing and using the command line interface.

See Command Line Reference for details on the commands and command structure.

MQTT¶

MQTT is a line protocol option.

MQTT buffers characters until newline; sends as MQTT publish.

In order to select this operating mode, set the "line protocol" for the selected interface to "MQTT".

In Web Manager, go to Line.

For CLI, see Config Line Level.

For XML, see configgroup Line.

TruPort Socket (Mux)¶

Mux is a line protocol option.

For initial setup and the Mux command reference, see Mux Reference.

TruPort Socket (mux) is a simple command and control interface that provides connected host microcontrollers access to multiple network sockets. It is suitable for use in network co-processor mode where multiple data channels are required with fine-grained control over these data channels.

It supports serial devices connected via UART or USB (CDC-Serial) and the following socket types: UDP, TCP, AES, and TLS.

TruPort Socket accepts multiple inbound connections and initiates multiple outgoing connections and offers the ability to drop into command mode for module configuration and status. Use the Mux commands to control connections, transfer data, and wait for events. You can also access device control through serial commands.

To use Mux:

In Web Manager, go to Line > Line 1 > Configuration.

For CLI, see Config Line Level.

For XML, see configgroup Line.

1. Connect to the device through the UART serial port.
2. Configure the Line 1 operating mode to Mux.
3. Open a terminal or a PC running a terminal emulator to the serial line.
4. Use Mux commands to connect to the device, send or receive data between the device and remote node, wait for events, and terminate the connection.
5. You may also enter command line to control the device.

None¶

None is a line protocol option.

This operating mode allows you to use the Web API.

In order to select this operating mode, set the "line protocol" for the selected interface to "None."

One way to use this operating mode is to set Line 1 to "Mux" and then set Line Virtual_1 or Line Virtual_2 to "None".

In Web Manager, go to Line.

For CLI, see Config Line Level.

For XML, see configgroup Line.

SLIP¶

SLIP is a line protocol option.

SLIP provides a network interface.

In order to select this operating mode, set the "line protocol" for the selected interface to "SLIP".

In Web Manager, go to Line.

For CLI, see Config Line Level.

For XML, see configgroup Line.

Trouble Log Mode¶

Trouble Log is a line protocol option.

This operating mode allows you to display the trouble log in the terminal window.

In order to select this operating mode, set the "line protocol" for the selected interface to "Trouble Log."

One way to use this operating mode is to set Line 1 to "Mux" and then set Line Virtual_1 or Line Virtual_2 to "Trouble Log".

In Web Manager, go to Line > Configuration.

For CLI, see Config Line Level.

For XML, see configgroup Line.

The trouble log displays an output-only message log.

Other methods you can use to view the trouble log for the gateway include the following:

In Web Manager, enter /tlog after the IP address in the browser address bar. For example:

172.20.197.102/tlog

where 172.20.197.102 is the IP address of the gateway connected to the network.

In the CLI, run tlog from the root level.

TruPort Serial (Tunnel)¶

Tunnel is a line protocol option.

Serial over IP tunneling, also referred to as "serial to Ethernet" or "serial to Wi-Fi," allows a serial device to communicate over a network, without being aware of the devices that establish the network connection between them.

TruPort Serial is an essential gateway application that allows a serial device connected through UART or through USB (CDC-Serial) to communicate over the network transparently with one or more remote serial device or networked applications.

It is most suitable when the connected serial device software cannot be modified to add command and control logic for data communication.

By offering various knobs that control session connect, disconnect, and data framing, TruPort Serial offers a diverse set of network protocol connections and reliable data communications to enable transparent pass-through of hundreds of proprietary serial and standard fieldbus protocols across many industries.

In order to select this operating mode, set the "line protocol" for the selected interface to "Tunnel."

In Web Manager, go to Line > Line 1 > Configuration.

For CLI, see Config Line Level.

For XML, see configgroup Line.

Configuring Tunnel Connections¶

TruPort Serial supports the following tunnel connections:

• TCP client
• TCP server
• TCP with AES
• TCP with TLS/SSL
• UDP client
• UDP server
• UDP with AES

The following configuration options are available:

• Make a local connection
• Accept a network connection
• Configure disconnect settings
• Configure the packing mode
• View tunnel status
• View tunnel serial line status

Connection Control¶

Accept (Server mode)

Accept mode defines how the gateway reacts to incoming connections from a client over the network.

In Accept mode, the gateway listens (waits) for incoming connections from the network. A remote node on the network initiates the connection.

Serial data can still be received while waiting for a network connection, up to the serial buffer limit.

Connect (Client mode)

Connect mode defines how the gateway makes a client connection to a remote node on the network.

Disconnect mode

Disconnect mode specifies the optional conditions for disconnecting any connection that may be established. If any of these conditions are selected but do not occur and the network disconnects from the device, a Connect Mode connection will attempt to reconnect. However, if none of these conditions are selected, a closure from the network is perceived as a disconnect.

Data Framing Control¶

Data from the serial Line is queued and sent in segments, when either the timeout or byte threshold is reached or the send character is read on the serial line.

Data framing control, also called Packing mode, applies to both Accept and Connect modes.

Status and Statistics¶

Tunnel statistics display information about each individual connection and an aggregate status of all tunnel connections.

Configuring Tunnel Connect (Client Connection) in TCP Mode¶

This tutorial describes how to configure a TCP tunnel in Connect (Client) mode and make a connection.

You will need:

• An xPico 200 series gateway
• A TCP server or listener tool (e.g. BT NetTools)

Follow these steps:

1. Configure the TCP server to listen on a specific port.

2. Set Line 1 protocol to Tunnel.

3. Configure Tunnel 1 Connect. Set Mode to Always.

4. Configure Host 1. Set Address to the IP address of the TCP server and Port to the port the TCP server is listening on. Save your settings and reboot the xPico 200 series gateway.

5. View Tunnel 1 Status to confirm the tunnel is up and see information about active connections.

6. Type characters into serial terminals connected to the serial port of the gateway and the TCP server. The characters are echoed back on the other terminal.

Configuring Tunnel Connect (Client Connection) in TLS Mode¶

You may want to create a secure connection using TLS. You'll need to first create a TLS credential. See TLS Credentials for more details. This tutorial describes how to configure a TLS tunnel in Connect (Client) mode and make a connection.

You will need:

• An xPico 200 series gateway with TLS credential configured
• A TLS server configured with corresponding TLS credential

Follow these steps:

1. Configure the TLS server to listen on a specific port.

2. Set Line 1 protocol to Tunnel.

3. Configure Tunnel 1 Connect. Set Mode to Always.

4. Configure Host 1. Set Address to the IP address of the TLS server and Port to the port the TLS server is listening on. Set Protocol to TLS and Credential to the name of the TLS credential.

5. Save your settings and reboot the gateway.

6. View Tunnel 1 Status to confirm the tunnel is up and see information about active connections.

7. Type characters into serial terminals connected to the serial port of the gateway and the TLS server. The characters are echoed back on the other terminal.

Configuring Tunnel Accept (Server Connection) in TCP Mode¶

This tutorial describes how to configure a TCP tunnel in Accept (Server) mode.

You will need:

• An xPico 200 series gateway (if you want to accept connections on ap0 or wlan0 interface, disable eth0)
• A client device or terminal emulator capable of TCP connections (e.g. Tera Term, PuTTY)

Follow these steps:

1. Set Line 1 protocol to Tunnel.

2. Configure Tunnel 1 Accept. Set Mode to Always, set Local Port to the local listening port, and set Protocol to TCP. Save your settings.

3. View Tunnel 1 Status to confirm the tunnel is up. Status is Waiting.

4. Use the client device or a terminal emulator (e.g. Tera Term, PuTTY) to make a TCP/IP connection to the IP address of the desired connected interface with the listen port.

5. View Tunnel 1 Status to confirm the tunnel is up and see information about active connections.

6. Type characters into serial terminals connected to the serial port of the gateway and the TCP server. The characters are echoed back on the other terminal.

Configuring Tunnel Accept (Server Connection) in TLS Mode¶

As with the client connection, you can create a secure connection using TLS or TCP AES. You'll need to first create a TLS credential. See Data Communication Security (TLS) for more details. This tutorial describes how to configure a TLS tunnel in Accept (Server) mode.

You will need:

• An xPico 200 series gateway with TLS credential configured (if you want to accept connections on ap0 or wlan0 interface, disable eth0)
• A TLS-capable client configured with corresponding TLS credential

Follow these steps:

1. Set Line 1 protocol to Tunnel.

2. Configure Tunnel 1 Accept. Set Mode to Always and set Local Port to the local listening port. Set Protocol to TLS and enter the TLS credential name. Save your settings.

3. View Tunnel 1 Status to confirm the tunnel is up. Status is Waiting.

4. Use a TLS-capable client to make a TCP/IP connection to the IP address of the desired connected interface with the listen port.

5. View Tunnel 1 Status to confirm the tunnel is up and see information about active connections.

6. Type characters into serial terminals connected to the serial port of the gateway and the TLS server. The characters are echoed back on the other terminal.

Tunnel Configuration Settings¶

The following tables describe the Web Manager Tunnel configuration settings.

Links to the equivalent settings for the CLI and XML reference are listed before each table.

For details on how to use the CLI interface, see Configuration and Setup.

For details on how to use the XML interface, see Configuration and Setup.

Tunnel Line Settings¶

The tunnel line settings that are displayed are derived from the serial Line interface.

CLI settings: See Config Tunnel Line Level

XML settings: See configgroup Tunnel Line

Settings	Description
Line	Line Settings information here is display only. Go to the serial line interface to modify the settings.
Protocol	Protocol information here is display only. Go to the serial line interface to modify the settings.
DTR	Select the DTR conditions in which Data Terminal Ready (DTR) control signal on the Serial Line is asserted. Choices: Asserted while connected (Causes DTR to be asserted whenever either a connect or an accept mode tunnel connection is active), Continuously asserted, and Unasserted.

Tunnel Packing Settings¶

CLI settings: See Config Tunnel Packing Level

XML settings: See configgroup Tunnel Packing

Settings	Description
Mode	Configure the Tunnel Packing Mode. Choices are: Disable (data not packed), Timeout (data sent after timeout occurs), and Send Character (data sent when the Send Character is read on the Serial Line).
Timeout	Set the timeout value, in milliseconds, after the first character is received on the serial line, before data is sent on the network. Valid range is 1 to 30000 milliseconds. Default is 1000. This configuration option becomes available when Timeout is the selected Mode.
Threshold	Set the threshold (byte count). If the received serial data reaches this threshold, then the data will be sent on the network. Valid range is 100 to 1450 bytes. Default is 512. This configuration option becomes available when Timeout is the selected Mode.
Flush While Unconnected	May be "Enabled" or "Disabled". "Enabled" keeps the packing buffer empty while there is no network connection. "Disabled" means characters can accumulate in the packing buffer when there is no network connection. This configuration option becomes available when Timeout is the selected Mode.
Send Character	Enter Control Characters in any of the following forms: J, 0xA (hexadecimal), and \10 (decimal). If used, the Send Character is a single printable character or a control character that, when read on the Serial Line, forces the queued data to be sent on the network immediately. This configuration option becomes available when Send Character is the selected Mode.
Flush Send Character	Click to enable or disable.
Trailing Character	Enter Control Characters in any of the following forms: Q, 0x11 (hexadecimal), and \17 (decimal). If used, the Trailing Character is a single printable character or a control character that is injected into the outgoing data stream right after the Send Character. Disable the Trailing Character by blanking the field (setting it to ). The trailing character configuration option becomes available when Send Character is the selected Mode.

Tunnel Accept Settings¶

CLI settings: See Config Tunnel Accept Level

XML settings: See configgroup Tunnel Accept

Settings	Description
Mode	Method used to start a tunnel in Accept mode. Choices: Disable: do not accept an incoming connection. Always: accept an incoming connection (default). Any Character: start waiting for an incoming connection when any character is read on the serial line. Start Character: start waiting for an incoming connection when the start character for the selected tunnel is read on the serial line. Modem Control Asserted: start when the modem control pin is asserted on the serial line.
Local Port	Port number for use as the network local port. The default local port for TCP on Line 1 is 10001.
Multiple Connections	Enabled: allow up to four incoming and four outgoing connections. Disabled: allow up to one incoming and two outgoing connections. Disabled by default.
Protocol	Protocol type for use with Accept Mode. The options are: TCP TCP AES TLS
Credential	Name of the credential associated with the selected protocol. The credential type can be AES or TLS and you configure it before setting up the accept connection. For more details, see AES Credentials or TLS Credentials.
Start Character	Start character that will enable the tunnel to listen for a network connection. The start character may be designated as a single printable character or as a control character. Control characters may be input in any of the following forms: J or 0xA (hexadecimal) or \10 (decimal) This configuration option becomes available when Start Character is the selected Mode.
Flush Start Character	Enabled: prevents forwarding of a start character from the Line into the network. Disabled: the flush start character allows forwarding of a start character from the line into the network. This configuration option becomes available when Start Character is the selected Mode.
Flush Line	Whether the serial line data buffer is flushed upon a new network connection. Choices are: Enabled: serial data buffer is flushed on network connection Disabled: serial data buffer is not flushed on network connection (default)
Block Line	Whether Block Line is enabled for debugging purposes. Choices are: Enabled: if enabled, incoming characters from the serial line will not be forwarded to the network. Instead, they will be buffered and will eventually flow off the serial line if hardware or software flow control is configured. Disabled: this is the default setting; incoming characters from the Serial Line are sent into the network. Any buffered characters are sent first.
Block Network	Whether Block Network is enabled for debugging purposes. Choices are: Enabled: if enabled, incoming characters from the network will not be forwarded to the Serial Line. Instead, they will be buffered and will eventually flow off the network side. Disabled: this is the default setting; incoming characters from the network are sent on the Serial Line. Any buffered characters are sent first.
Password	Password can be up to 31 characters in length and must contain only alphanumeric characters and punctuation. When set, clients must send the correct password string to the unit within 30 seconds from opening network connection in order to enable data transmission. The password sent to the unit must be terminated with one of the following: 0A (Line Feed) 00 (Null) 0D 0A (Carriage Return/Line Feed) 0D 00 (Carriage Return/Null) If Prompt for Password is set to Enabled and a password is provided, the user will be prompted for the password upon connection.

Tunnel Connect Settings¶

CLI settings: See Config Tunnel Connect Level

XML settings: See configgroup Tunnel Connect

Settings	Description
Mode	Method to start the Connect Tunnel: Disable: never started. Always: always started Any Character: started when any character is detected on the Serial Line Start Character: started when the Start Character is detected on the Serial Line. Modem Control Asserted: started when the modem control pin is asserted on the serial line.
Host (Edit button)	Lists the information related to connecting to a host. Click Edit beside a particular host to view details. Address: IP address of the remote host. If Protocol is UDP and you want to listen rather than connect, set Address to the interface to which the tunnel should listen, ap0, wlan0, or eth0. Port: the port on the remote host. Can be UDP or TCP port. If Protocol is UDP and you want to listen rather than connect, set to <None>. Default is <None>. Protocol: May be TCP, TCP AES, TLS, UDP. Default is TCP. Initial Send: string up to 32 characters. If present, the initial string is sent out before any other data when the connection is established. Click Submit to save. Up to 2 hosts can be established.
Connections	Select the type of connection. Sequential: connections for tunneling will begin from host 1 and proceed in sequence until a connection is accepted. Simultaneous: all hosts accepting connections will be connected. Round-Robin: the tunnel connection attempts to start with the host after whichever host had previously connected.
Reconnect Time	Enter the reconnection time, which specifies how long the gateway will wait in seconds before trying to reconnect to the remote host after a failed attempt or closed connection. Blank the display field to restore the default.
Flush Line	Select to enable or disable the flush line at the time a connection is established with the network. Enabled: buffered characters from the serial line will be discarded when a connection is established. Disabled: any characters received on the serial line will be buffered and sent after a connection is established.
Block Line	Select to enable or disable the block line, which is used for debugging purposes. Enabled: incoming characters from the serial line will not be forwarded to the network but will be buffered and will eventually flow off the serial line, if hardware or software flow control is configured. Disabled: incoming characters from the serial line are sent to the network. Any buffered characters are sent first. This is the “normal” setting.
Block Network	Select to enable or disable the block network, which is used for debugging purposes. Enabled: incoming characters from the network will not be forwarded to the serial line but will be buffered and eventually flow off the network side. Disabled: incoming characters from the network are sent on into the serial line. Any buffered characters are sent first. This is the “normal” setting.

Tunnel Disconnect Settings¶

CLI settings: See Config Tunnel Disconnect Level

XML settings: See configgroup Tunnel Disconnect

Settings	Description
Stop Character	Enter the Stop Character which when received on the Serial Line, disconnects the tunnel. The Stop Character may be designated as a single printable character or as a control character. Control characters may be input in any of the following forms: J or 0xA (hexadercimal) or \10 (decimal). Disable the Stop Character by blanking the field to set it to .
Modem Control	Select to enable or disable the disconnect when modem control pin is not asserted on the serial line.
Timeout	Enter the number of milliseconds a tunnel may be idle before disconnection. The value of zero disables the idle timeout.
Flush Line	Set whether to flush the Serial Line when the Tunnel is disconnected. Choices are: - Enabled - Disabled (default)
Exclusive	When "Enabled", prevents more than one Tunnel connection at a time. This stops Tunnel Accept from listening while a Tunnel Connect is active. Tunnel Connect will not make a connection while a Tunnel Accept is connected. Choices are: - Enabled - Disabled (default)