Difference between revisions of "HiPath TAPI 170 TSP"

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Jump to: navigation, search
(Connection via RS232 and S0 interfaces)
Line 179: Line 179:
==== Connection via RS232 and S0 interfaces ====
==== Connection via RS232 and S0 interfaces ====
Connection via V.24 / S0 interfaces is only released for existing systems. New systems may only be connected to the HiPath platforms via Ethernet LAN using TCP/IP.
Connection via V.24 / S0 interfaces should only be done for existing systems, which are already connected using these interfaces. New systems may only be connected to the HiPath platforms via Ethernet LAN using TCP/IP.

Revision as of 13:59, 14 April 2008

TAPI 170 general configuration

HiPath TAPI 170 is a Telephony Service Provider software, which enables Microsoft TAPI based software applications to control or monitor terminals connected to HiPath platforms.


  • Third party TAPI service provider.
  • Full compatibility with the latest Microsoft TAPI 2.2/3.0 standard.
  • Designed to run on a Microsoft Windows 2000 / 2003 based network server.
  • Telephone functionality available on every client PC via the TAPI 2.2/3.0 client/server architecture.
  • No additional TSP client software required.
  • Support of CSTA III protocol.
  • Support of several physical interfaces.
  • Permanent interface monitoring for high service reliability.
  • Automatic garbage collection releases seized resources after time out.
  • Developer Guide for TAPI implementation available.

HiPath TAPI 170 is a 3rd party TAPI Service Provider.

Software versions

Latest Version (dated November 2007) is:

  • HiPath TAPI 170 V2.0

This Version is fully compatibel with all previous versions. Compatibility comprises also the reuse of licenses.

TAPI 170 general configuration

The CTI Link between the HiPath TAPI 170 Server PC and the HiPath platform is logically done by the CSTA III protocol. No physical connection is required between computer and phone. Hipath Platform and the HiPath TAPI 170 PC are connected to an Ethernet based LAN with TCP/IP protocol. It can be operated in a single system or networked enviroment. For details look here.

For connection of the CTI Server (with TAPI 170) to a HiPpath 3000 platform the HG1500 module is required. HiPath 2000 platforms can be connected directly to LAN without any additional HW. Hipath 5000 PC is connected to the LAN but the CSP SW has to be installed before to offer the the CSTA III protocol.

Prerequisites / Requirements

Platform/Phone Requirements

Supported systems

Supported phones

Not Supported phones

  • Standard H.323 phones


Tested Client operating systems

HiPath platform max. no of TAPI clients

HiPath 3800

HiPath 3700

HiPath 3500

HiPath 3300

HiPath 2000

HiPath 5000 CS

HiPath 5000 RSM







1000 (system-wide)


The maximum value of TAPI clients per platform does not represent the max number of monitor point available within a HiPath platform.

PC Requirements

PC Hardware

In general the PC hardware equipment must meet the requirements of the Windows operating system. For each TAPI line configured 200 KB of additional RAM has to be provided.

PC Software

CTI server operating systems:

  • Microsoft Windows 2000 Server (32 bit)
  • Microsoft Windows 2003 Server (32 bit)
  • Mirosoft Windows 2000 Terminal Server (from SP 4) (32 bit)
  • Citrix Meta Frame (Feature Release 3, SP 3) (32 bit)

Client PC operation systems:

  • Windows 2000 Professional (32 bit)
  • Windows XP Professional (32 bit)

Remarks / Limitations

  • Server PCs with multiple network interface cards or Load Balancing must not be used.
  • Only 32 bit operating systems are allowed.
  • Only Microsoft Windows clients are allowed.
  • All client PCs and the server must be members of one and the same domain.
  • LAN refer to the usage of Ethernet technology.
  • The physical connection to HiPath 3000 is allowed only via HG 1500.
  • The TAPI feature range depends on the underlying CSTA feature set
  • HiPath platform monitor points are not exclusively for HiPath TAPI 170, but are available for all connected applications.
  • Maximum numbers of monitor point depend on HiPath platform model
  • Use of Hipath TAPI 170 in connection with HiPath 5000 CS always requires a HiPath 3000 as gateway.
  • Terminal Server environment
    • Terminal Server / Metaframe Server and HiPath TAPI 170 V2.0 have to be installed on the same server HW so that every user can only monitor his/her own line.
    • In a Terminal Server Farm architecture, every server needs its own HiPath TAPI 170 V2.0.
    • Licensing has to be done on every server separately - every line needs a separate license.
    • The maximum number of HiPath TAPI 170 V2.0 instances is four.
    • Operation with HiPath 5000 RSM and networked HiPath 3000 is not allowed.


The TAPI170 Developers guide is available on the product CD.

Software Delivery

HiPath TAPI 170 software is shipped on a CD labelled "HiPath 3000 TAPI Service Provider Version 2.0" which is included in serveral order positions.

For service purposes the software can also be downloaded from the Software Supply Server of the manufacturer. software patches for dedicated problem corrections can be retrieved from the Knowledge Base within the Partner Portal (SEBA, login required) of the manufacturer (login required). Access to the two methods mentioned above is only granted by the manufacturer to registered partners on a contractual base.


For HiPath TAPI 170 TSP, the number of useable TAPI lines is licensed. Licenses are linked to the MAC addresses on the first Ethernet LAN card on the PC where the HiPath TAPI 170 TSP is installed. In multinode scenarios in connection with HiPath 5000 RSM, the MAC address of the first HiPath node is used to license the TAPI lines.

Central License Server (CLS) of the HiPath License Management (HLM) is used to generate the appropiate license keys in a file. The license file generated by CLS is copied into HiPath TAPI 170 TSP using its configuration menue. Afterwards the licenses can be assigned to the TAPI lines. CLA and CLM components of HLM are not reqiured.

For testing purposes, HiPath TAPI 170 TSP can be operated without a license for two hours. To do this, enter the text "DEMOMODE" instead of a license key. Three freely configurable lines will be available for testing. The testing period can be reset by restarting the PC. You can switch from test version to full version at any time by entering the license key.

License conversion from HiPath TAPI 170 TSP V1.0 to V2.0

HiPath TAPI 170 TSP V1.0 can be upgraded to HiPath TAPI 170 V2.0 and expanded with HiPath TAPI V2.0 licenses. Licenses purchased under V1.0 must be converted to V2.0 (in the central license server) and the latest driver software must be installed. To perform the conversion, the MAC address is entered in the license server under HiPath TAPI 170 V1.0 / "Version conversion" and the corresponding dataset is located using the search function. Users activate “Convert to V2.0” in order to transfer the dataset found to the V2.0 licensing database (license server). After transfer, the dataset can no longer be edited using V1.0. In the following step, the user searches for the new license key under the "Licensing" item in HiPath TAPI 170 V2.0, using the unchanged MAC address. Opening "Upgrade license", HiPath TAPI 170 V2.0 expansion packets and HiPath TAPI 170 V1.0 licenses (which have been converted to HiPath TAPI 170 V2.0) can now be combined in one new overall license.

Backward compatibility

Functions of HiPath TAPI 170 V2.0 are fully backward compatible to previous version incl. the support of the license dongle of CTI TAPI 3P V2.0/V2.1. The compatibility does not apply for the support of "old" Microsoft operating systems.

Connection via RS232 and S0 interfaces

Connection via V.24 / S0 interfaces should only be done for existing systems, which are already connected using these interfaces. New systems may only be connected to the HiPath platforms via Ethernet LAN using TCP/IP.

The following applies to Eicon DIVA S0 cards still used in existing systems. DIVA 2.0/3.0 cards were only released in connection with TAPI 170 TSP. Drivers are still delivered on the TAPI 170 CD and can be run using:

  • Microsoft Windows NT and Windows 2000 for DIVA2.0
  • Microsoft Windows 2000 / XP for DIVA3.0
  • Microsoft Windows 2000 / XP (not 2003!) for DIVA Pro

  • CMD connection via S0 was only authorized with
  • Diva Server BRI-2M Version 1.0, driver 6.3 or newer
  • Diva Server BRI-2M Version 2.0, driver 7.0 or newer

with standard drivers.

Feature description in detail

HiPath TAPI 170 software provides in general the following features of the TAPI interface:

  • Outgoing connection setup, incoming call acceptance, call cleardown
  • Call status/caller ID display
  • Call logging
  • Call pickup (group), consultation hold, toggling, call transfer, conference
  • Speed transfer, call redirect, call hold
  • Tone dialing (DTMF) during call
  • Call charge information
  • Write to display
  • Set/query hookswitch status
  • Volume setting for handset, speaker and headset
  • Lamp mode setting
  • Dynamic line generation by the application
  • Call center features:
    • Query/set/cancel message waiting indicator
    • Query/set/cancel call forwarding and do not disturb
    • Additional information on forwarded/redirected/ transferred calls
    • Playback of music on hold (MOH) and recorded announcements (RCA)
    • Trunk and UCD monitoring
    • Call status timer
    • Unique caller ID (domain-wide)
    • Call data exchange between TAPI applications (domain wide)
  • Central call detail recording (CDR)
  • Support for ACD proxy request handler
  • Telephone data service (TDS)
  • Heartbeat/loopback

Deviations can occur if the underlying CSTA III Interface of the HiPath Platform does not support some features


External Links