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:

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

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

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

Example:

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

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

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

Pass-through mode

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

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

Syntax for loading PBXDA-xx PCI serial adapter:

Example:

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.

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:

 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.