PBXDA-xx series PCI serial adapters

Table of Contents

General description

CHARON-AXP supports emulation of PBXDA-xx family PCI serial adapter based on DIGI AccelePort serial adapters via CHARON PCI Pass Through mode (using a specific CHARON PCI Pass Through driver) and by direct virtualization.

CHARON PCI Pass Through mode enables connection between the virtual PBXDA-xx PCI serial adapter and the physical DIGI AccelePort PCI serial adapter plugged into a hosting server PCI bus whether as the direct virtualization may address the host serial port or TCP/IP port.

Virtual PBXDA-xx PCI serial adapter

Loading virtual PBXDA-xx serial lines adapter

Syntax for loading PBXDA (AccelePort 2r 920) serial lines adapter:

load PBXDA/DIGI <name>

Syntax for loading PBXDA_BA (AccelePort 4r 920)  serial lines adapter:

load PBXDA_BA/DIGI <name>

Syntax for loading PBXDA_BB (AccelePort 8r 920) serial lines adapter:

load PBXDA_BB/DIGI <name>

Syntax for loading PBXDA_AC (AccelePort Xem) serial lines adapter:

load PBXDA_AC/DIGI <name>

Example:

load PBXDA/DIGI TXA

The adapter instance name ("TXA" in the example above) is used then for parametrization, for example:

set TXA line[2]="COM1:"

The numbers in the square brackets represent line number on the virtual PBXDA-xx adapter starting from 0.


Controller typeMaximum number of lines
PBXDA 2
PBXDA_BA4
PBXDA_BB8
PBXDA_AC16

All the parameters described in the "Placement of peripheral devices on PCI bus" chapter, such as "bus", "device", "function", "irq", "irq_bus" are applicable for PBXDA-xx controller.

DIGI drivers for OpenVMS and Tru64 are sensitive to PBXDA-xx location on PCI, therefore it is recommended to fix PBXDA-xx location with explicit configuration.

Example:

load PBXDA TXA bus=pci_1 device=4 function=0


Configuration parameters

The PBXDA-xx serial lines adapter emulation has the following configuration parameters:

port

Parameterport
TypeText String
Value

Specifies a local port for incoming telnet connections

By default the "port" configuration option is not specified.

Syntax:

port[line-number]=<local port>

Example:

set TXA port[2]=17060

line

Parameterline
TypeText string
Value

A defined COM port on host system:

Example:

set TXA line[2]="COM2:"


log

Parameterlog
TypeText string
Value

The optional log file or directory name is where the log file for the serial line is stored.

Example:

set TXA log[0]="D:\Charon\txa0.log"

Pass-through mode

Loading PBXDA-xx PCI serial adapter in pass-through mode

(info) Note the model of DIGI AccelePort PCI serial adapter for emullation of a particular model of PBXDA-xx family PCI serial adapter:

DEC PBXDA-xx adapter
Name of the device to map to
Controller
Vendor ID
Device ID
PBXDA-BADIGI AccelePort 4r 920ASIC PCI114Fh0026h
PBXDA-BBDIGI AccelePort 8r 920ASIC PCI114Fh0027h
PBXDA-ACDIGI AccelePort XemASIC PCI114Fh0004h
PBXDA-ACDIGI AccelePort XemASIC PCI114Fh0008h

Syntax for loading PBXDA-xx PCI serial adapter:

load digi <name>

Example:

load digi SERIAL_A

By default PBXDA-xx adapter uses first available PCI slot. If instead some particular slot is needed, refer to this section for details of specific placement of PCI peripherals on CHARON Virtual Machine (VM) PCI bus.

In AlphaStation 400 configuration use the following syntax for PBXDA-xx PCI serial adapter loading:

load digi SERIAL_A irq_bus = isa



Configuration parameters

The PBXDA-xx PCI serial adapter emulation has only one configuration parameter:

host_bus_location

Parameterhost_bus_location
TypeText String
Value

Establish connection between virtual PBXDA-xx PCI serial adapter and physical DIGI AccelePort PCI serial adapter installed on CHARON host (pass through mode)

Syntax:

load digi <controller name> host_bus_location="PCI bus X, device Y, function Z"

where:

  • "PCI bus X" corresponds to the PCI bus number of the host  DIGI AccelePort PCI serial adapter
  • "device Y" corresponds to the PCI bus device number of the host  DIGI AccelePort PCI serial adapter
  • "function Z" corresponds to the "function" parameter of the the host DIGI AccelePort PCI serial adapter

Example:

load digi SERIAL_A host_bus_location="PCI bus 3, device 1, function 0"

Installation of  DIGI AccelePort PCI serial adapter

  1. Install the DIGI AccelePort PCI serial adapter to some spare PCI slot of the host system
  2. Boot a Windows operating system
  3. Open “Computer Management”
  4. Select “Device Manager”
  5. In the right window select the desired physical serial adapter connected to the system, right-click the mouse button, and the corresponding menu will appear.
  6. From the menu select “Update driver…”. Windows will show “Hardware Upgrade Wizard”
  7. Select “No, not this time”, click “Next”
  8. Select “Install from a list or specific location (Advanced)”, click “Next”
  9. Select “Don’t search. I will choose the driver to install”, click “Next”
  10. Click “Have Disk…”. Windows shows dialog “Install From Disk”
  11. Instead of “A:\”, click “Browse” and select path to the folder in which driver’s INF file is located (typically "C:\Program Files\CHARON\Drivers\DIGI_X.X.0.XXXXX"), select “digi_ppt_amd64.inf”, and click “Open”
  12. The “Hardware Upgrade Wizard” should have “CHARON DIGI adapter”. Select it, and click “Next”
  13. There will be one or two more dialogs, but they are usual for device driver installation.
  14. Reboot the host

Upon completion, a new device will appear in the device manager with the CHARON logo on it.


Mapping to host DIGI AccelePort PCI serial adapter

Open “Computer Management” application and select “Device Manager”:


In the right panel select proper physical DIGI adapter:


Open its properties sheet by double-clicking on the selected adapter:


The “Location:” on the above picture gives X, Y, and Z for the "host_bus_location" parameter, for example:

set PBXDA host_bus_location = "PCI bus 1, device 7, function 0"

(warning) Non-US-EN installations of Windows may present “Location:” string in local language, but "host_bus_location" parameter requires English notation, so the words “PCI”, “bus”, “device”, and “function” must be specified in English.



© Stromasys, 1999-2024  - 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.