The configuration files for the TAPI driver are not formated as standard INI-files. So it is not easy to edit these files.

To enable auto configuration the TAPI driver supports a "tapi_auto_config.taco" file.


Steps to create an Auto Configuration

Limitations: The auto-configuration is designed to configure a single TAPI line (first line).

1. Create a pre-configured setup
  1. Extract the ZIP file of the Asterisk TAPI Driver.
    • Hint: The extracted folder "workingDir" contains the driver configuration files.
  2. Run the setup.exe.
  3. Configure the access to Asterisk PBX.
  4. Configure parameters for the first TAPI line device.
  5. Set the checkbox "activate auto-configuration-dialog" via [Configure > Tab Settings > Special Adaptations].
  6. Test if the driver is working.
  7. Open the driver's working directory via Button [Configure... > Info-Tab > Working Directory].
  8. Copy the content of the driver's working directory into folder "workingDir" of expanded setup.
  9. Open the file "cfg\ast_lines.ini" in folder "workingDir" and remove not configured TAPI lines.
  10. You can rename or remove some parameter items from "cfg\ast_lines.ini" and "cfg\ast_servers.ini" to anonymize the configuration. e.g.: Rename the Channel and remove the encoded passwords.
2. Configure a "tapi_auto_config.taco" file
  1. Download and save tapi_auto_config.taco to any folder.
  2. Customize the "tapi_auto_config.taco" content for a new installation.
    You can use the text editor (notepad.exe) to edit the file.

Element Description
[ALL] Section [ALL] applies to all Windows logon user names and computer names.
You can also rename the section to [COMPUTERNAME_XXX].
And you can also create multiple sections with different computer names.
LicenseKey=
LicenseeName=
License key
Licensee Name = registered for
AsteriskServer_IP= IP address or DNS name of the Asterisk PBX
AsteriskServer_Username=
AsteriskServer_Pwd=
Loginname and password to access the Asterisk Manager API
AsteriskLine_Channel= e.g. SIP/300
AsteriskLine_PhoneNumber= extension number (e.g. 300)
AsteriskLine_AutoAnswerMode= AutoAnswerMode if [Special Device]=Standard;
predefined modes: 0:disabled; 1:Standard; 2:Mode2; 3:Snom; 4:Aastra; 5:Polycom; 6:Tiptel
AsteriskLine_Username= = User display name
AsteriskLine_Context = Context to execute the AMI Originate command.
= empty if not known
Phone_IP=
Phone_Username=
Phone_Pwd=
If [Special Device] = Snom or Aastra you have to set the phone access parameters.

=> Now the files are prepared for setup.


How to execute Auto Configuration

1. Post-Configuration mode for users
  1. If the driver is not installed, run setup.exe first.
  2. Double-click the "tapi_auto_config.taco" file.
    => The auto-configuration should be executed now.
2. Pre-Configuration mode for administrators
  1. You can copy the "tapi_auto_config.taco" into folder "workingDir\cfg" of expanded setup.
  2. Rename the file "tapi_auto_config.taco" in "auto_config.ini".
  3. Run setup.exe on a new computer.
    During installation the "auto_config.ini" is processed and renamed to "auto_config-done.ini".
3. Post-Configuration mode for administrators
  1. If the driver is not installed, run setup.exe first.
  2. Open the driver's working directory via Button [Configure... > Info-Tab > Working Directory].
  3. Copy the "tapi_auto_config.taco" into sub-folder "cfg".
  4. Rename the file "tapi_auto_config.taco" in "auto_config.ini".
  5. Run a driver reset or restart the computer.
    Hint: You can run "TspReset.exe" to reset the driver.