Page Comparison

...

Parameter license_key_id 

Optional parameter. There can be several license_key_id parameters in this section. They define a prioritized list of license keys. The first entry has the highest priority. If no key with this ID is available, the next key in the list will be tried. If a higher priority key becomes available, the emulator will switch to this license at the next periodic license check.

Syntax:

license_key_id "key-id-prio1"

...

Optional parameter. There can be several license_id parameters in this section. They define a prioritized list of product license IDs. The first entry has the highest priority. If no key with this product license ID is available, the next product license ID in the list will be attempted. If a higher priority license becomes available, the emulator will switch to this license at the next periodic license check.

Syntax:

license_id "lic-id-prio1"

...

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

The options available for configuration are described below.

Serial port

...

options

...

type

The

...

type

...

• socket: the port is set to telnet raw mode.
• telnet: the port supports the telnet protocol.
• device: indicates that the emulated serial line is connected to a physical terminal on the host.

...

Each port is mapped to a TCP socket on the emulator host or to a physical line. This parameter defines the TCP port used or the name of the physical device. A TCP port number must be unique on the host system.

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

Possible values for where-to-listen:

• Empty:
  • If the port number is specified without a colon (:), the console will only be accessible on the localhost address. Equivalent lo:<portnumber>.
  • If the port number is specified with a colon, the console process will listen on all host interfaces.
• Interface name: the console process will only listen on the specified host interface.
• IP address: the console process will only listen on host IP address.

Default values:

• ":30000" for line 1
• ":30002" for line 2

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

Example:

• "/dev/ttyS0"
• "/dev/ttyUSB0"

...

option specifies the serial line connection type.

Possible values:

• dummy
  • Default value
  • The serial line is not connected to a port.
  • The line has no input.
  • The output will be discarded but can be logged to a file.
• socket
  • Raw network socket port mode.
  • Data is transmitted as a character stream without UART signals.
  • UART baud rate and parity modes are ignored.
  • If no client is connected, the output will be discarded.
  • Only one client connection is allowed.
• telnet
  • Port is a network socket with telnet protocol support.
  • Data is transmitted as a character stream encapsulated in the telnet protocol.
  • UART baud rate and parity modes are ignored.
  • If no client is connected, the output will be discarded.
  • Only one client connection is allowed.
• pty

  • Linux pseudo terminal device.

  • UART baud rate and parity modes are ignored.
  • Ignores serial port control signals changes.
• tty
  • Linux serial interface device.

  • This port type implements all serial port control signals, baud rate changes, parity modes.

• RFC2217

  • Port is a network telnet client with RFC2217 support.

  • The RFC2217 COM Port Control (a telnet protocol extension) allows sharing modems and other serial devices over a TCP/IP network.

  • The emulated serial interface connects to a serial port server.
  • This port type implements all serial port control signals, baud rate changes, parity modes.

port

The format and values of the port option, depend on the type of the 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 (HPA-Socket HPA-Telnet HPA-Telnet-VT100) that can be used to connect to the emulated system via a serial line.

stop_command

Boolean flag. If true, the command started on the serial line (parameter command) will be stopped when exiting from the emulator.

out_log

File name for logging the output character stream from the CPU to the device. Does not depend on the port being operational (the actual transmission is not logged).

in_log

File name for logging the input character stream from the port to the device.

Console Communication

...