Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: change heading level; small rewording; typo; formatting

...

Table of Contents
excludeTable of contents
stylesquare

Serial

...

Lines for Emulated Systems

All emulated HP3000 and HP9000 models have at least 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.

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.

...

Serial port configuration options are specified using the following syntax:

...

Serial port optionDescription
type

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

  • socket: the port is set to TCP 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.
port

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

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

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"
commandThis parameter is optional. It can be used to specify a terminal emulation program that is started automatically when the emulated system is started. Charon-HPA 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.

...

The configuration file templates are set up with contain the following default configurations:

LineHP3000HP9000

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 HPA-Telnet"

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


Emulated second serial line in raw mode on port 30002.
2 serial.uart2.device.type="socket"
serial.uart2.device.port=":30002"
serial.uart2.device.type="socket"
serial.uart2.device.port=":30002"

Terminal Emulation Considerations

The emulated serial lines can be accessed vial via a terminal emulation program running on the emulator host system or on a remote system. 

...

Stromasys supplies PuTTY profiles with the Charon-HPA kit. However, customers can select another terminal emulation program better suited to their purposes. This is especially true for emulated HP3000 systems , where applications often use block mode terminals. This mode is not supported by PuTTY.

If not done so already during the installation, copy the provided PuTTY profiles to the correct directory on the host system. See Charon-HPA Software Installation.

Accessing Emulated HP3000 Systems via Terminal Emulation

HP3000 guest systems running on Charon-HPA can be accessed directly from the Linux emulator host using either of two freeware terminal emulators listed below, both of which run directly on the Linux host desktop, or by simply using the telnet command. Each has limitations, however. Neither terminal emulator provides a reliable way to paste multiple lines of text into :EDITOR , for example.
Once the HP3000 network is configured, it 's may be preferable to connect to the virtual HP3000 from a networked PC using any of the robust commercially-available terminal emulators.

Using PuTTY

The PuTTY terminal emulator is the preferred method to use as the HP3000 console. It does not, however, support HP terminal escape sequences, so any inverse or highlighted text codes will be ignored, and block mode applications cannot be run. Using PuTTY in telnet mode (as supplied) allows use of the Break key. PuTTY supports copy and paste. To copy text to the clipboard, just select it with the left mouse button (this automatically copies the selection to the clipboard). To paste the clipboard into a PuTTY window, use Shift-Ins . Unfortunately, PuTTY cannot be used to reliably paste large blocks of text (even with MPE type-ahead enabled), as data overruns can easily occur.

...

The image below shows a PuTTY terminal window connected to the emulated HP3000 system console:

Div
classpagebreak



Using xhpterm

The xhpterm terminal emulation (an X Windows version of freevt3k ) does not support many HP terminal escape sequences, but it can be used to run block-mode applications. It must be used on a serial line set up for raw mode.

...

(info) When using xhpterm , avoid resizing the window - it can result in input and output fields in block-mode programs being misaligned. Changing the screen font will change the window size automatically, without causing this problem.

Accessing Emulated HP9000 Systems via Terminal Emulation

Stromasys provides preconfigured PuTTY profiles to access the serial console of an HP-UX system running on Charon-HPA. PuTTY does not support all control characters used by HP-UX, but many utilities (e.g., SAM) will work with some restrictions.

By default, the emulator configuration is set up to start PuTTY on the console port with the command: 
  serial serial.uart0.device.command="putty -load HPA-Telnet-VT100".

...


StepCommand / Action
1Make sure the preconfigured PuTTY profiles are in the directory .putty/sessions or .config/putty/sessions in your home directory.(see Charon-HPA Software Installation)
2Start PuTTY from the command-line. $ putty -load HPA-Telnet-VT100
3Should you get an error that a font was not found, change the font.


Start PuTTY from the command-line.

$ putty

Select and load the required profile.
Select Fonts on the left and select a monospace font.
Select Session on the left and save the profile.

4To connect from a remote host, change localhost in the template to the correct hostname or IP address.

Start PuTTY from the command-line.

$ putty

Select and load the required profile.
Change the hostname to the one of the Charon-HPA host as required.
Connect to the remote Charon-HPA system.

...

Additional configuration steps to improve the behaviour behavior of the terminal emulation:

...

The following image shows a PuTTY window where the locale on the system running PuTTY is something different from C:

Other Terminal Emulation Considerations

Accessing the Emulated System Console from a Remote System

(warning) Please note: intermediate firewalls must allow the ports used.

...

To exit the session, use the telnet escape key sequence CTRL+} and type quit.

Tunneling a Terminal Emulation through an SSH Tunnel

Even though a plain telnet connection can be used to connect to the emulated system's console, this plaintext connection may create security problems. As an alternative, you can tunnel a terminal emulation through an SSH tunnel provided X11 is active on the emulator host and the remote system.

...