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 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"