Table of contents

Serial Line Configuration

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.

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

Serial port configuration options specified using the following syntax:

A serial port has three configuration options:

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

Terminal Emulation Considerations

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

Please note: if the terminal emulation program runs on a remote system, any firewall between the remote system and the emulator host system must permit the configured ports.

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 alreay 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

HPA3000 guest systems running on Charon-HPA can be accessed directly from the Linux host using either of two freeware terminal emulators listed below, both of which run directly on the Linux host desktop. 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 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 typeahead enabled), as data overruns can easily occur.

By default, the emulator configuration is set up to start PuTTy on the console port with the command:

serial.uart0.device.command="putty -load HPA-Telnet" (default port 30000). 

To start an terminal emulator manually, perform the following steps:

The image below shows a PuTTY terminal window connected to the emulated HP3000 systems's console:

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.

The following image shows an xhpterm window connected to the second serial line of an emulated HP3000 system (running NMMGR):

Mapping the Block-Mode Enter key

The primary purpose for including this terminal emulator is to allow block-mode applications (like NMMGR ) to be run from the Linux desktop. xhpterm uses the numeric keypad Enter key to simulate block-mode Enter. If your keyboard does not have a numeric key pad, the Enter key can be mapped to another key or key combination using xmodmap on Linux. 

Example mapping the numeric key pad Enter key to Right-Ctrl:

Using Different Fonts

The default command-line to start xhpterm is:  $ xhpterm -port 30000 -clean -font 10x20

If the 10x20 font is not found, you can try -font 6x13 instead.

Additional fonts (e.g. the 9x15 font) can be installed using the command

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.uart0.device.command="putty -load HPA-Telnet-VT100".

To start an terminal emulator manually, perform the following steps:

 Instead of PuTTy, you can also use the standard telnet command on your remote Linux system (telnet <charon-hpa-host> <port>). However, Stromasys does not provide profiles for this.

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

The following image shows a PuTTy window running SAM after the settings above were configured:

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