BusinessPhone Communication Platform 7.0

##

## Virtual Com (VCom)

Overview
Software Requirements
Hardware Requirements
Installation Procedure
Control Panel
User Interface
Add a virtual serial interface
Remove a virtual serial interface
Configure a virtual serial interface
Tracer

## Overview

The Virtual Com (VCom) is a virtual com interface which presents towards the IPU an IP interface and towards the software application(s) a standard PC COMx. With the VCom, software applications which are not yet comopatible to LAN / IPU connectivity can be connected over the LAN to the IPU board. The VCom must be installed on the host running the software application.

System Overview:

[1] |  | software applications using Mulitchannel protocol (BusinessLink) |
[2] |  | software applications using Computer communication TYPE1...TYPE6 protocol (CIL, MIS applications) |
[a] |  | The interface between VCom and the software application, from software application point of view, is compatible to the serial interface provided by the operating system. In the software application (or in BusinessLink) the virtual com interface from VCom must be configured instead of the physical COM of the operating system. |
[b] |  | The interface between VCom and IPU is a proprietary protocol. |

*) This document covers only the installation, configuration and maintenance of the VCom software.

For more information about the other software products (e.g. BusinessLink, CCS,...) please refer to their corresponding product documentation.

## Software Requirements

VCom is able to interface all defined I/O interfaces protocols of the BusinessPhone exchange:

- Computer Communication TYPE1...TYPE6 protocol
- MULTICHANNEL

It is multiple instants compliant, which means that it can run multiple times on a server in parallel.

Following operating systems are supported:

- Microsoft Windows 98 SE
- Microsoft Windows XP
- Microsoft Windows NT
- Microsoft Windows ME
- Microsoft Windows 2000
- Microsoft Windows 2000 server

## Hardware Requirements

There are no specific hardware requirements for VCom.

## Installation Procedure

VCom will be distributed on the BusinessPhone Management Suite CD-ROM (FAS BS 102 213/xxx). Make sure that the Setup program is located on a server (host/PC) before starting the installation wizard.

Note

For Windows NT and Windows 2000 local administrator rights are required.

1. Locate the file setup.exe
2. Click on setup.exe to start the installation wizard.

The Welcome dialog will be displayed.

1. Click on Next.
2. Accept the terms and conditions in the license agreement by clicking Yes.
3. Click on Install to start the installation procedure.

Setup is now copying the files.

1. Click Finish to end the installation procedure.

### Control Panel

To add/remove/configure a virtual serial interface there will be a control panel applet.

### User Interface

The user interface will consist of a simple dialog showing the current virtual serial interfaces and buttons to add/remove/configure a virtual serial interface. In addition there is an option to list the “Trace-Ports” which will be described later in this document.

### Add a virtual serial interface

#### WindowsNT 4.0 & Windows2000

To add a virtual serial interface a popup dialog will list the currently available port numbers.

#### Windows98

Due to the different OS architecture of Win98 there is another approach to add a virtual serial interface. To add a virtual serial port start “Add new Hardware” from Control Panel and let Windows search for PNP devices.

Select “No, I want to select the hardware from a list” and click “Next” to proceed.

Select “Ports (COM & LPT)” for hardware types list and click “Next” to proceed.

Select “Ericsson” as manufacturer, “Virtual Communications Port (Port ?)” as model and press “Next” to complete the installation.

It is possible to add 5 virtual communication ports (A – E) which will automatically be enumerated which means that the OS (Windows98) will assign the next free serial port identifier. e.g.: if “COM2” is the last known serial port, the new virtual port will be named “COM3”.

It is possible to add all virtual ports at one stage.

After adding virtual port(s) you have to restart your PC to ensure proper operation.

### Remove a virtual serial interface

#### WindowsNT 4.0 & Windows2000

To remove a virtual serial interface, select the serial port and press “Remove”.

#### Windows98

To remove a virtual serial interface, select the serial port (Device Manager) and press ”Remove”.

### Configure a virtual serial interface

To configure a virtual serial interface a popup dialog allows to tune all relevant parameters.

##### Parameters:

Host |  | The IP-Address (or corresponding hostname) of the IPU-Board. |
Port |  | The assigned Port-Number on the IPU-Board. |
Protocol |  | The type of protocol which should be used for this virtual serial interface. |

### Tracer

For each virtual serial port there is a special “Trace-Port” available which will allow to trace internal communication/states and the communication with the IPU-Board.

To bypass the need for a tracer-application it is possible to use telnet for tracing.

#### Example (Trace on “COM2”):

Enter on command line:

telnet localhost 2100

Revision: B © Ericsson Enterprise 2005