3.7.32 TelnetTerminal

A host interface onto a serial port: exposes the two way serial data channel over a TCP/IP interface, and automatically opens a telnet application connected to the network socket, unless a user application connects first. This model is written in C++.

TelnetTerminal contains the following CADI targets:

  • TelnetTerminal

About TelnetTerminal

When the simulation is started and the TelnetTerminal component is enabled, the component opens a server (listening) socket on a TCP/IP port. This is port 5000 by default.

Data written to the SerialData port is transmitted over the network socket. When data becomes available on the network socket, the TelnetTerminal component buffers the data. The data can then be read from SerialData.

If there is no connection to the network socket when the first data access is made, a host telnet session is automatically started. Prior to this first access, you can connect a client of your choice to the network socket. If the connection between the TelnetTerminal component and the client is broken at any time, the port is re-opened, permitting you to make another client connection.

To set the parameters, the syntax to use in a configuration file or on the command line is:


where x is the terminal identifier and can be 0, 1, 2, or 3.

The mode parameter selects the terminal initialisation mode. You can set it to either of these values:

telnetIn telnet mode, this component supports a subset of the telnet protocol defined in RFC 854.
rawIn raw mode, this component does not interpret or modify the byte stream contents. This permits a debugger connection, for example, to connect a gdb client to a gdbserver running on the target operating system.

The terminal parameter specifies the command line used to launch a terminal application and connect to the opened TCP port. The TelnetTerminal component replaces the keywords %port and %title, if specified, with the opened port number and component name, respectively. After replacing %port and %title, the command line is executed verbatim.

An empty string, which is the default, launches xterm on Linux or telnet.exe on Windows.


If you specify a non-empty string, it must include %port, but %title is optional.

For example:

motherboard.terminal_0.terminal="putty.exe -telnet %port localhost"

Table 3-265 Ports

Name Protocol Type Description
serial SerialData Slave Slave port for connecting to a SerialData master.
Non-ConfidentialPDF file icon PDF version100964_1110_00_en
Copyright © 2014–2020 Arm Limited or its affiliates. All rights reserved.