Serial Line Emulation Notes

Serial Line Emulation Notes

Table of contents

Serial Lines for Emulated Systems

Most models emulated by Charon-PAR have two serial lines (LDev 20 and 21). One of these emulated lines is mapped to the serial console, the other to a second serial port. Some models may have more serial lines. Please refer to Emulated Model Hardware Configuration Details for more information. This section provides an overview of the serial line configuration. Please also refer to the Configuration File Reference.

Configuration Parameters Overview

Each emulated line has a device path denoting bus and slot information in the emulated system (see configuration file template or chapter Emulated Model Hardware Configuration Details) and a configuration path. The configuration path is used to set up the serial line configuration in the emulator configuration file.

The following table shows the device and configuration paths used for the two serial lines:

Serial line

Configuration path

Serial line

Configuration path

Charon-PAR 64-bit models

1 = Console

serial.uart0.device

2

serial.uart2.device

Charon-PAR 32-bit model 7000-720

1 = Console

asp.uart0.device

2

asp.uart1.device

Serial port configuration options are specified using the following syntax:

serial.uartX.device.<option>="<value>"

or (for model 720)

asp.uartX.device.<option>="<value>"

 


If the Super/IO module has been loaded, there are two additional serial lines. In the configuration, they are identified by 

  • superio_001.uart0 and

  • superio_001.uart1.

The basic configuration options are the same as for the default serial lines.

The most important configuration options are listed below. For additional parameters and more detailed information, please refer to the Configuration File Reference.

Serial port option

Description

Serial port option

Description

type

The serial port type determines the protocol used on the serial port. Possible values are:

  • DUMMY: serial interface presented to emulator is not connected.

  • socket: the port is set to TCP raw mode.

  • telnet: the port supports the telnet protocol.

  • pty: indicates that the emulated serial line is connected to a Linux pseudo-terminal.

  • tty: emulated serial line is connected to physical hardware (serial hardware must be supported by Linux).

  • RFC2217: emulatied serial line is connected to a serial line server across the IP network.

port

Each port is mapped to a TCP socket on the emulator host or to a physical line. This parameter defines the TCP port used, the name of the physical device, or the port and address of a serial line server. A port number must be unique among all active port numbers on the host system.

A TCP port is specified as "<where-to-listen>:<portnumber>". It requires a port type of socket or telnet.

Default values (listening on all interfaces):

  • ":30000" for line 1

  • ":30002" for line 2

To restrict console connections to certain host interfaces or host IP addresses, set where-to-listen to the respective interface name or IP address. The settings lo:<portnumber> and <portnumber> (without the colon) are equivalent.

A physical device is specified as "<device-file>". It requires a port type of device.

Example:

  • "/dev/ttyS0"

  • "/dev/ttyUSB0"

A serial line server is specified as "<ip-address>:<port>".

command

This parameter is optional. It can be used to specify a terminal emulation program that is started automatically when the emulated system is started. Charon-PAR provides preconfigured profiles for PuTTY (PAR-Socket PAR-Telnet PAR-Telnet-VT100) that can be used to connect to the emulated system via a serial line.

 

The configuration file templates contain the following default configurations:

Line

Charon-PAR/PA3

Charon-PAR/PA9

Line

Charon-PAR/PA3

Charon-PAR/PA9

 

Emulated serial console on port 30000 using the telnet protocol. PuTTY started automatically with preconfigured profile.

1

serial.uart0.device.type="telnet"
serial.uart0.device.port=":30000"
serial.uart0.device.command="putty -load PAR-Telnet"

PA9-64

serial.uart0.device.type="telnet"
serial.uart0.device.port=":30000"
serial.uart0.device.command="putty -load PAR-Telnet-VT100"

PA9-32

asp.uart0.device.type="telnet"
asp.uart0.device.port=":30000"
asp.uart0.device.command="putty -load PAR-Telnet-VT100"

 

Emulated second serial line in raw mode on port 30002.

2

serial.uart2.device.type="socket"
serial.uart2.device.port=":30002"

 

PA9-64

serial.uart2.device.type="socket"
serial.uart2.device.port=":30002"

PA9-32

asp.uart1.device.type="socket"
asp.uart1.device.port=":30002"



© Stromasys, 1999-2025  - All the information is provided on the best effort basis, and might be changed anytime without notice. Information provided does not mean Stromasys commitment to any features described. 
Need fast, reliable migration? We have done it countless times. Talk to an expert