Way2Call Hi-Phone Technical Information

Product Information
    Hi-Phone Desktop RS232
    Hi-Phone Desktop USB
    Hi-Phone Desktop Lite
    Hi-Phone Desktop Pro

Drivers

Firmware
Sample Programs

Technical Notes

Detecting DTMF Tones
Muting the Headset
Disconnecting Immediately After Dialing
DTMF Duration
Detecting FAX machines and Data Modems
PBX Strings

 

ExceleTel and Way2Call have a long history of close cooperation.  We have been working together for nearly a decade to continually advance the Hi-Phone as the premier TAPI desktop CTI device.  This long relationship, extensive technical experience, and world-wide deployment has allowed ExceleTel to establish and maintain our industry leading position for Hi-Phone telephony application development tools, Hi-Phone technical assistance, and Hi-Phone distribution.

Please consider ExceleTel as the source for all your Way2Call Hi-Phone needs.

 

Drivers

Latest Drivers

For legacy Hi-Phone drivers or other technical assistance please contact ExceleTel.

Firmware

Latest Firmware

For legacy Hi-Phone firmware or other technical assistance please contact ExceleTel.

Sample Programs

Click here for a complete list available sample programs provided by ExceleTel.

Here is a list of sample programs written specifically for the Way2CallHi-Phone:

 

Technical Notes

Detecting DTMF Tones

The Hi-Phone only has one decoder for DTMF tones which is shared between the TAPI Line device (etLine) and TAPI Phone device (etPhone). By default it is set to detect DTMF tones from the phone device.

The Hi-Phone defaults to receiving digits from the handset. This can be changed by modifying a registry entry.

Open the registry editor and go to [HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Telephony\Providers].

Look for ScTsp32.tsp and with that filename number check the provider ID (e.g., if the string ProviderFilename2 = "ScTsp32.tsp" then check the dword ProviderID2).

With the provider ID decimal number, look for that corresponding branch (If ProviderID2 = 4123 then look in [HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Telephony\Prov ider4123].

With that provider, look for the dword "DefaultDTMFFromLocal" and change its value to 0.

Muting the Headset

With most telephony devices that support the TAPI Phone device you can set etPhone.Headset.SpeakerOnly to True to mute the headset and etPhone.Headset.MicrophoneAndSpeaker to True to unmute the headset.  

However this feature is not support with the Hi-Phone.  Check the value of the property etPhone.Headset.Modes and you will notice that the bit flag PHONEHOOKSWITCHMODE_SPEAKER is not set indicating that this feature is not available.

However you can achieve the same functionality by using the following TAPI Device Specific extensions.

   ' Mute
   etPhone.DevSpecificString("003B,0000")

   ' Un mute
   etPhone.DevSpecificString("002B,0000")

Disconnecting Immediately After Dialing

There have been occasions where the Hi-Phone immediately disconnected after dialing and where the OnDialtone event fails to fire.  The Way2Call diagnostics will work fine.  Devices on the same line such as fax machines and answering devices can cause this.  It may be that the line ringer equivalence of certain devices pulls too much draw on the line and the hi-phone can't recognize the proper current changes.

DTMF Duration

The Hi-Phone TSP does not utilize the dwDuration in order to change the duration, and therefore the speed of DTMF tones. Instead, The DTMF duration is implemented as device global settings.

It can be changed issuing a write register command thru lineDevSpecific(...)

The register is within group #1, register number is 4.

Value:50 to 255 miliseconds. default is 95ms.

In order to control this feature, you must have the Enterprise Edition of TeleTools. Enterprise Edition is the only edition that supports the Device Specific functionality of TAPI.

ExceleTel's DevSpecific example program, available on the WEB site, can be used to demonstrate modifying the DTMF duration. Run the program, enable the Hi-Phone in the etLine window, click on the call tab and make a call. When you answer the call, click on the Digits sub tab of the call window and enter digits into the first field of the Call.SendDigits field. When you click on the button, the digits will play with the default duration of 95ms.

Enter 00C7,0032 into Form1 and press Button1 to use DevSpecific to change the register in the Hi-Phone. This will set the duration to the minimum 50ms. Press the Call.SendDigits button again in etLine and the tones will play noticeably faster.

You may set the duration to anything from 0032 to 00FF to get durations between 50ms and 255ms. With the Enterprise Edition of TeleTools, you may send this and other device specific commands to your device using the etPhone.DevSpecificString method. The syntax is etPhone1.DevSpecificString("00C7,00FF")

Detecting FAX machines and Data Modems

In order to detect a fax machine, you must monitor the correct media modes.

In TeleScope:

  1. Make the etLine window active

  2. From the top pulldown menus select call, mediamodes, then check INTERACTIVEVOICE, AUTOMATEDVOICE and G3FAX.  Then put a check next to "Active"

  3. From the top pulldown menus select popup and check OnCallMediaModeChange

  4. Make an outbound call to a FAX machine

  5. The OnCallMediaModeChange event will fire and you can check the mediamode property on the call properties tab to see that it is LINEMEDIAMODE_G3FAX

In Code:

VB and VB.Net

etLine.CallMonitorMediaModesMediaModes = LINEMEDIAMODE_G3FAX +    LINEMEDIAMODE_DATAMODEM ' checks for both fax and modem

etLine.CallMonitorMediaModesActive = True

Delphi

etLine.Call.MonitorMediaModes.MediaModes = LINEMEDIAMODE_G3FAX + LINEMEDIAMODE_DATAMODEM // checks for both fax and modem

etLine.Call.MonitorMediaModes.Active = True

Then in the OnCallMediaModeChange event handler put the following code to check the bitflags for what the mediamode has changed to:

if etLine1.CallMediaMode AND LINEMEDIAMODE_G3FAX <> 0 then

     ' we have a fax

elseif etLine.CalMediaMode AND LINEMEDIAMODE_DATAMODEM <> 0 then

    ' we have a voicemodem 

end if

PBX Strings

Here is how to setup the Hi-Phone TSP and test transfer and other "flash-hook" functions from TeleScope:

  • Make sure the Hi-Phone Device is selected, but NOT enabled in the etLine control window

  • From the main menu, click on the DEVICE option at the top

  • Click Configure (this will open the Hi-Phone TAPI TSP configuration)

 


  • Click on ADVANCED in the Phone-line parameters section (if you don't see this, you need the latest drivers. Some of the recent older drivers disabled this option for some reason)  ------------------------->

  • Click on NEW to create a new PBX type and give it a name like "transfer" or the name of your PBX. NOTE: If you don't have a PBX, but have a line with call waiting, you must edit the "none" configuration. You will get the screen below for setting up flash with call waiting:


  • Click on the TRANSFER tab at the top and setup the flash hook commands to do this on your device (in the case of the hi-phone you click on the "flash-hook" button to insert an exclamation point for "setup transfer" and "swap current and held call", then click on the "hangup" button to insert ^H into "cancel transfer", "Cancel after answer", "complete as a transfer", and "blind transfer"

  • Go back and select your new "transfer" profile and click OK through the TSP to save it

  • At this point, you can go back to TeleScope and place an incoming call, answer it by clicking on Answer

  • Put a number in the dial box and then click "transfer"