SoLo DTMF Solution
Installation and Configuration
Guide
Table of Contents
Table of Contents ... 2
Introduction ... 3
General Installation Requirements ... 4
Configuration file (.solo) ... 6
Introduction ... 6
File .solo ... 7
Section 1: General Parameters... 9
Section 2: Templates ... 12
List of Templates ... 13
Section 3: Enabling Features ... 15
Section 4: Personal Features... 16
SoLo Client DTMF Installation ... 17
Installation on BlackBerry devices ... 17
Installation on Symbian devices ... 17
Installation on Android devices – HTC models ... 18
Introduction
SoLo DTMF Client gives You full mobility for Your workforce with FULL PABX features (desk phone features) on Your mobile phone.
Mobile calls are routed through the corporate PABX, transforming mobile calls into fixed line calls. The main advantages of this solution are:
● Drastic cost reductions (up to 80%)
● Visibility of all corporate calls (mobile + fixed), one network to manage ● One Business Number (depending on the operator)
● Possibility of managing the services of desk phones directly from mobile phones
All services are supported by SoLo DTMF Client. The functioning of services is however subject to the functions provided by your PABX.
GSM Channel
SoLo Client Send request for outgoing call via GSM channel
PBX
PBX phones called party
Called party PRI
GSM T1-E1
BRI
PRI
GSM T1-E1
BRI
SKYPE
To achieve further savings on telephony costs, your mobile plan should include free phone calls from your corporate mobile phones to your corporate desk phones, and/or you should install a GSM gateway on your PABX and its SIMs should be included in your Business User Group (i.e. a group of fixed line numbers and mobile numbers within your company that can make calls to cor-porate numbers for free).
You can download this manual also from our website at http://www.sosoftware.com/solo-mobile-dtmf under Resources.
General Installation Requirements
DISA ServiceCheck availability of DISA Service(1) on your PABX.If it is not present, please contact your PABX sup-plier to check if they can activate the service. Take note of the procedure to access the service: tele-phone number of DISA service, password, etc.
GSM Gateway
Should your mobile plan not include free phone calls from your corporate mobile phones to your corporate desk phones, you should install GSM gateways on your PABX. GSM gateways are usually connected to PABXs via ISDN, Analog or SIP lines. You can then configure your PABX by routing calls from GSM Gateways to DISA Service.
Compatibility
Take note of mobile phone firmware version.
- For BlackBerry: Menu Options / About / v….. (e.g.: BlackBerry 8300 v4.5.0.52) - For Nokia: Menu / Tools / About / v…
Check if the Nokia or BlackBerry phone models to be used with SoLo Client are compatible. You can find the list of compatible models on our website: http://www.sosoftware.com.
Installation Check List
Before starting the installation of SoLo DTMF Client, check the following:
PABX:
● Telephone number of DISA service (fixed line number or GSM gateway number) ● Procedure and password to access DISA service
● Extension number to be paired with GSM phone
● Desk phone password (if required to access DISA service)
Mobile phone:
● Mobile phone number
● PIN Code (in case you need to turn the mobile on and off) ● IMEI Code of GSM phone (2)
Software:
● Software to manage mobile phone (Nokia PC Suite / BlackBerry Desktop Manager) ● USB cable to connect PC and GSM phone or Bluetooth
SoLo DTMF Client:
● SoLo DTMF Client Software to be installed into mobile phone (3) ● SoLo DTMF Client Configuration file (3)
(1) Direct Inward System Access (DISA). By using this service, an external caller can access PABX internal services. Access to service usually involves control of Caller’s ID or use of password
(2) For Nokia phones enter *#06# / For BlackBerry see Menu Options/Status
(3) Download from http://www.sosoftware.com
Configuration file (.solo)
Introduction
When you download SoLo DTMF Client from http://www.sosoftware.com, you have the executable file and a text file: Config.solo.
The latter is the configuration file for SoLo DTMF Client where you have to set the parameters to access PABX services.
If the procedure to access DISA service includes dialling user’s extension number or user’s pass-word, you need to create a customized configuration file for each SoLo user.
When you have set the file for the first user, copy and paste it and rename it with the name or the extension numbers of other users, without changing the file extension [.solo].
We recommend the use of Windows Notepad to modify the file. Please follow the rules below when compiling the configuration file:
Do not change any values on the left of the [=] symbol Do not cancel or insert any lines
Modify only values between [=] and [;] symbols Do not change file extension (.solo)
All parameters to enable communication between SoLo DTMF Client and PABX and to access all in-ternal services must be set in this file.
The file is usually compiled by the system installer.
File .solo
The following is an example of .solo file. The file represented here is divided in sections to ease compilation. Features of each file line are explained on the following pages according to the file be-low.
Do not change the lines in the original file. This is only an example.
General Parameters
DID_PREFIX = 19;
USERS_EMERGENCY_NUMBERS = 123,999,911;
USERS_PIN_CODE = 1111;
ARS_CODE = 9;
INTERNATIONAL_DIRECT_DIAL_PREFIX = 00;
URL_UPDATE = http://mobile.sosoftware.com/bb;
LOGO_KEY = 08915012;
ONE_PERSONAL_NUMBER = 12345678;
COMPANY_NAME = SoSoftware;
VERSION = 4.2;
TYPE = 2;
PABXPIN = 222;
DEVICENUMBER = 255;
USER_ID = 1234567;
END_CHAR =;
INTERNAL_NUMBER_LENGTH = 4;
NATIONAL_DIRECT_DIAL_PREFIX =0;
HOME_COUNTRY_DIAL_CODE =+39;
TRANSFER_TYPE = 0;
PHONE_VIRTUAL = 0;
Templates
SPEECH_ACCESS_NUMBER = 0;
ACTIVE_APPEARANCE_SELECT = 0;
AUTO_CALL_BACK_TOGGLE = 0;
CALL_FORWARDING_ALL_ACTIVATION = 0;
CALL_FORWARDING_BUSY_NO_ANSWER_ACTIVATION = 0;
CALL_FORWARDING_DISABLE = 0;
CALLING_PARTY_NUMBER_BLOCK = 0;
CALLING_PARTY_NUMBER_UNBLOCK = 0;
CALL_PARK = 0;
CALL_PICKUP_DIRECTED = 0;
CALL_PICKUP_GROUP = 0;
CALL_PICKUP_GROUP_EXTENDED = 0;
CALL_UNPARK = 0;
DROP_LAST_ADDED_PARTY = 0;
EXCLUSION = 0;
HELD_APPEARANCE_SELECT = 0;
IDLE_APPEARANCE_SELECT = 0;
IDLE_APPEARANCE_SELECT2 = 0;
OFF_PBX_DISABLE = 0;
OFF_PBX_ENABLE = 0;
SEND_ALL_CALLS_DISABLE = 0;
SEND_ALL_CALLS_ENABLE = 0;
TRANSFER_TO_COVERAGE = 0;
TRANSFER_ON_HANGUP = *,#N;
NOT_DISTURB_ENABLE = 0;
NOT_DISTURB_DISABLE = 0;
Enabling Features
SOLO_REGISTRATION_KEY = ;
DIRECT_NUMBERS = 347*,*346,*320*,;
BLOCKED_NUMBERS = 347*,*346,*320*,;
BLOCKED_DTMF_NUMBERS = 347*,*346,*320*,;
REPLACE_PHONE =1;
Personal Features
PERSONAL_FUNCTION_1 = My Function 1%1024%CALL_HANGUP%;
PERSONAL_FUNCTION_2 = My Function 2%1025%CALL_FREE_NUMBER%;
PERSONAL_FUNCTION_3 = My Function 3%1026%CALL_NO_HANGUP%;
PERSONAL_FUNCTION_4 = My Function 4%0%CALL_TONE_NO_HANGUP%11...11...66%;
PERSONAL_FUNCTION_5 = My Function 5%1028%CALL_TONE_HANGUP%2222%;
PERSONAL_FUNCTION_6 = CALL_HANGUP%0%CALL_HANGUP%;
PERSONAL_FUNCTION_7 = CALL_FREE_NUMBER%0%CALL_FREE_NUMBER%;
PERSONAL_FUNCTION_8 = CALL_NO_HANGUP%0%CALL_NO_HANGUP%;
PERSONAL_FUNCTION_9 = CALL_TONE_NO_HANGUP%0%CALL_TONE_NO_HANGUP%222222%;
Section 1: General Parameters
DID_PREFIX = ;
You can insert the root of the DISA number(s) in this tag to simplify compilation of Templates (see Section 2). Compiling this tag is useful when the PABX uses several numbers to access DISA service. Example: If you use the numbers +44846281 202 – 209 to access internal services
here you should insert: DID_PREFIX = +44846281;
In the file section ‘Template’ you should insert the rest of the number 200, 201… level with the ser-vice.
USERS_EMERGENCY_NUMBERS = ;
This is a required tag and it specifies the numbers dialled for emergency. This field accepts multiple numbers separated by commas. These numbers will be dialled directly via GSM network and not via SoLo.
Example: USERS_EMERGENCY_NUMBERS =112,113,115,118; USERS_PIN_CODE = ;
This is an optional tag. When you set a password, the Client will prompt for this PIN to access con-figuration from SoLo DTMF Client (from the mobile phone). This is usually set by installers.
Example: USERS_PIN_CODE = 1111; ARS_CODE = ;
Insert the code used by the PABX to access telephone lines. This number will be automatically add-ed before the telephone numbers dialladd-ed via SoLo Client and longer than extension number length set in tag ‘INTERNAL_NUMBER_LENGTH’.
Example: ARS_CODE = 0;
INTERNATIONAL_DIRECT_DIAL_PREFIX = ;
This required tag specifies the international call prefix for your country. This international code substitutes the [ + ] symbol in the numbers of your telephone contacts. The code for Europe is 00. Example: INTERNATIONAL_DIRECT_DIAL_PREFIX = 00;
URL_UPDATE = ;
Do not change. This required tag is to update SoLo DTMF Client from your mobile phone via data channel.
Example: URL_UPDATE = http://mobile.sosoftware.com; LOGO_KEY = ;
This tag must be set = 08915012 to load your logo on GSM display when using SoLo DTMF Client. Example: LOGO_KEY = 08915012;
ONE_PERSONAL_NUMBER = ;
This is only a descriptive tag. The number inserted here will be shown on GSM display, SoLo DTMF Client Main Menu.
Example: ONE_PERSONAL_NUMBER = 00448452415512; COMPANY_NAME = ;
As per ‘ONE_PERSONAL_NUMBER’
Example: COMPANY_NAME = Alpha Beta Ltd.; VERSION = ;
This is only a descriptive tag. Insert the version of SoLo DTMF Client you have Example: VERSION= 4.2;
TYPE = ;
This required tag is linked to the registration code and must be set = 2. Example: TYPE = 2;
PABXPIN = ;
Code to access the DISA service of your PABX. Ask your PABX supplier if you don’t know it. This value represents the [ S ] variable in the compilation of Templates to access PABX services. Example: PABXPIN = 111;
DEVICENUMBER = ;
Extension number assigned to mobile phone. This is required by the DISA service of some PABXs (e.g.: Siemens).
This value represents the [ D ] variable in the compilation of Templates to access PABX services. Example: DEVICENUMBER = 512;
USER_ID = ;
This tag is for future implementation, not needed at the moment. Example: USER_ID = ;
END_CHAR = ;
Character to set the end of the desired dialling. Some PABXs require the use of the # symbol at the end of the outgoing dialling via DISA.
Example: END_CHAR = #;
INTERNAL_NUMBER_LENGTH = ;
This tag specifies the number of digits for internal number. It sets the dial plan length of the PABX. Should there be several number lengths, insert the longest one here.
NATIONAL_DIRECT_DIAL_PREFIX = ;
Set here the number to be inserted automatically before local network numbers. In some countries, you must insert zero before local network numbers when you phone using the local network. If you call the same number from abroad, you don’t need to put zero.
Example:
Number inserted in mobile phone contacts: + 41 21 6437766: If you call it from abroad you dial: + 41 21 6437766
If you call it using the local network you must dial: 021 6437766. In this case you should put: NATIONAL_DIRECT_DIAL_PREFIX = 0;
Note: In Italy this tag must be empty, because you dial the same number both from international and na-tional networks.
HOME_COUNTRY_DIAL_CODE = ;
This tag is for the international code of your home country. This code is usually set also before numbers in the mobile phone contacts.
Example: +41 021 6437766 or +39 0461 710711.
This format is not accepted by fixed line networks. SoLo DTMF Client removes this code when dial-ling numbers from the mobile phone contacts before sending the number to the PABX. If the inter-national code is different, then it is not removed but the [ + ] symbol will be substituted for [ 00 ], which is taken from [ INTERNATIONAL_DIRECT_DIAL_PREFIX = 00; ]
Example: HOME_COUNTRY_DIAL_CODE = +41; TRANSFER_TYPE = ;
This tag specifies the type of call transfer. Available values are:
0 SoLo transfer; 1 Server transfer; 2 Operator transfer Example: TRANSFER_TYPE = 0;
PHONE_VIRTUAL = ;
Section 2: Templates
INTRODUCTION
Access to DISA service usually requires the following procedure: - Call the number of DISA service
- Send password via DTMF
- Send number to be called or number of service to be enabled / disabled via DTMF
The procedure to access the service may change for different PABXs:
- Some PABXs check Caller’s number and do not require a password (e.g. Avaya) - Some PABXs require the extension number and its password (e.g. Siemens) - Other PABXs require only a password (e.g. Mitel)
Below you can find information about how to set Templates, which will be used by SoLo DTMF Cli-ent to automatically access services on your PABX.
We use letters to ease the compilation of Templates as per table below.
Code Description TAG
, Separator between the number you want to call and what is sent via DTMF
P Pause of 1 second (it is possible to have more than one P if necessary)
S Password to access the service PABXPIN = ;
D Extension number to access the service DEVICENUMBER = ;
N Number you want to call (number dialled by user in SoLo DTMF Client)
General Example
IDLE_APPEARANCE_SELECT+4112345,PDS#N
In the Template shown above, SoLo DTMF Client calls number +4112345. After the comma, you can see what is sent via DTMF:
It waits for 1 second (P)
Then it sends what is set in Tag DEVICENUMBER (D) Then it sends what is set in Tag PABXPIN (S)
After that it sends the symbol #
List of Templates
SPEECH_ACCESS_NUMBER = ; Access your voicemail.ACTIVE_APPEARANCE_SELECT = ;
This tag is for future implementation, not needed at the moment. AUTO_CALL_BACK_TOGGLE = ;
This tag is for future implementation, not needed at the moment. CALL_FORWARDING_ALL_ACTIVATION = ;
This optional tag is to forward all calls.
CALL_FORWARDING_BUSY_NO_ANSWER_ACTIVATION = ; This optional tag is to forward calls in case of busy or no answer. CALL_FORWARDING_DISABLE = ;
This optional tag is to disable forwarding settings. CALLING_PARTY_NUMBER_BLOCK = ;
This optional tag is to hide your personal ID (number). CALLING_PARTY_NUMBER_UNBLOCK = ;
This optional tag is to display your personal ID (number). CALL_PARK = ;
This tag is for future implementation, not needed at the moment. CALL_PICKUP_DIRECT = ;
This tag is for future implementation, not needed at the moment. CALL_PICKUP_GROUP = ;
This tag is for future implementation, not needed at the moment. CALL_PICKUP_GROUP _EXTENDED = ;
This tag is for future implementation, not needed at the moment. CALL_UNPARK = ;
This tag is for future implementation, not needed at the moment. CONFERENCE_ON_ANSWER = ;
DROP_LAST_ADDED_PARTY = ;
This optional tag is used to drop last added party to conference. EXCLUSION = ;
This tag is for future implementation, not needed at the moment. HELD_APPEARANCE_SELECT = ;
This tag is for future implementation, not needed at the moment. IDLE_APPEARANCE_SELECT = ;
This required tag is the idle line for dial tone. IDLE_APPEARANCE_SELECT2 = ;
This tag is for future implementation, not needed at the moment. OFF_PBX_DISABLE = ;
This tag is used to disable Twinning. OFF_PB_ENABLE = ;
This tag is used to enable Twinning. SEND_ALL_CALLS_DISABLE = ;
This tag is for future implementation, not needed at the moment. SEND_ALL_CALLS_ENABLE = ;
This tag is for future implementation, not needed at the moment. TRANSFER_TO_COVERAGE = ;
This tag is for future implementation, not needed at the moment. TRANSFER_ON_HANGUP = ;
This optional tag is to enable call transfer. NOT_DISTURB_ENABLE = ;
This tag is used to enable DND (Do Not Disturb). NOT_DISTURB_DISABLE = ;
Section 3: Enabling Features
SOLO_REGISTRATION_KEY = ;
Code to activate SoLo DTMF (Insert it from mobile phone Menu / Options). DIRECT_NUMBERS = ;
This is an optional tag. Insert here numbers or parts of numbers which you want to call using the SIM and not SoLo DTMF. These numbers are dialled via SoLo but called directly by the SIM. This field accepts multiple numbers separated by commas.
Example: DIRECT_NUMBER = 123456789, 123*, *789, *456*; BLOCKED_NUMBERS = ;
This is an optional tag. Insert here numbers or parts of numbers which you don’t want to call using the SIM. These numbers will be called only via SoLo DTMF. This field accepts multiple numbers se-parated by commas.
Example: BLOCKED_NUMBER = 123456789, 123*, *789, *456*; BLOCKED_DTMF_NUMBERS = ;
This is an optional tag. Insert here numbers or parts of numbers which you don’t want to call using SoLo DTMF. This field accepts multiple numbers separated by commas.
Example: BLOCKED_NUMBER = 123456789, 123*, *789, *456*; Further information about numbers to be blocked:
The wording xxx* means all numbers beginning 'xxx' The wording *xxx means all numbers ending 'xxx' The wording *xxx* means all numbers including 'xxx'
The wording * means all numbers
Example: BLOCKED_NUMBERS =*; you can’t call via SIM. You can call only via SoLo DTMF
Please note: Numbers shall be written exactly as they are written in mobile phone Contacts in order to block also calls from Contacts.
REPLACE_PHONE = ;
This is an optional tag (available values: 0, 1). “1” sets SoLo Client always active (all ‘exit’ functions are disabled and you can’t close the application). ‘Autostart’ is enabled and ‘autostart option’ is hidden, so that it can’t be disabled. This tag together with BLOCKED_NUMBERS allows ‘DECT Re-placement’ and users can call via SoLo DTMF Client only.
By entering the following code, '##21051980*' you can close SoLo application and disable the DECT replacement feature.
The only way to disable this feature is by setting REPLACE_PHONE=0 in the configuration file or by removing the whole line in the configuration file (i.e. ' REPLACE_PHONE = 1').
Section 4: Personal Features
Personal features can be very useful if you want to have some special features on your SoLo DTMF Client. It is possible to have a maximum of ten personal features.
Syntax
● The syntax must be exactly in the format explained below. ● The length of menu text must be maximum 50characters.
● The separator is the symbol “%” and the line must end with the symbol “;”. Features
PERSONAL_FUNCTION_1 = My function 1 % number % CALL_HANGUP %;
PERSONAL_FUNCTION_2 = My function 2 % number % CALL_FREE_NUMBER %;
PERSONAL_FUNCTION_3 = My function 3 % number % CALL_NO_HANGUP %;
PERSONAL_FUNCTION_4 = My function 4 % number % CALL_TONE_NO_HANGUP % tones %;
PERSONAL_FUNCTION_5 = My function 5 ... Menu Label
Substitute labels ‘Myfunction1’, ‘Myfunction2’, …. with the name of the feature you want to see in the SoLo DTMF Client Menu
Dialled numbers
Substitute the parameter ‘number’ with the number to be dialled to access the feature in the PABX. If you have inserted the prefix in DID_PREFIX, here you have to insert only the suffix.
If you have not inserted the prefix in DID_PREFIX, here you have to insert the whole number. Tones
Tones to be sent via DTMF. Type of connection
Type Description
CALL_HANGUP SoLo DTMF Client calls the number, waits for connection and hangs up CALL_FREE_NUMBER SoLo DTMF Client calls the number, waits for connection, waits for the user to
select a number.
CALL_NO_HANGUP SoLo DTMF Client calls the number, waits for connection and does not hang up.
CALL_TONE_NO_HANGUP SoLo DTMF Client calls the number, waits for connection, sends the tones and does not hang up.
CALL_TONE_HANGUP SoLo DTMF Client calls the number, waits for connection, sends the tones and hangs up.
SoLo Client DTMF Installation
Please refer to the user guide of your mobile or smart phones to see how to use desktop software, USB, or Bluetooth.
SoLo DTMF Client requires 20 Mb free memory.
Installation on BlackBerry devices
● Install the BlackBerry Desktop Manager software on your computer. This software is packaged with your mobile device.
● Download SoLo DTMF Client installation package (.alx and .cod) into the PC.
● Before installing the application, stop all programs that are actively running on your mobile phone.
● Launch BlackBerry Desktop Manager and connect your BlackBerry Phone to the PC via Bluetooth or USB cable.
● Select ‘Application Upload’ to install SoLo DTMF Client installation package (.alx). ● Use ‘Media Manager’ to upload SoLo DTMF Client Configuration file (.solo) into the
BlackBerry Phone and take notes of the location of this file.
● Access SoLo DTMF Client on your BlackBerry Phone. If it is not in the main display, search it in the ‘download’ folder. Start SoLo DTMF Client.
● Select Icon and scroll the menu until you see ‘Load config.file’. ● Enter the registration code in ‘Insert Activation Key’.
● Select Menu > Load configuration file and search the configuration file (.solo) in the folder where you saved it. The file installs and configures the SoLo DTMF Client on your BlackBerry Phone.
Installation on Symbian devices
● Install Nokia PC Suite software on your computer. This software is packaged with your mobile device. Install SoLo DTMF Client using the Install Applications menu in the Nokia PC Suite software.
● Copy the executable ‘SoLoMobile.sis’ and ‘.solo’ file into the phone. ● Start the executable ‘SoLoMobile.sis’ from mobile phone.
● Open SoLo DTMF Client on mobile phone under Installations.
● Select Menu > Settings > Load registration code and enter the activation code. ● Select Menu > Settings > Load configuration file and select the ‘.solo’ file.
Installation on Android devices – HTC models
● Launch HTC Sync and connect the device to your PC via USB cable. ● Select option ‘HTC sync’ in your device.● Enable the possibility to install applications from unknown/any source (Settings > Applica-tions > unknown/any source).
● Select ‘Software Installation Program’ to install DTMF Client (.apk).
● In your device, modify the type of USB connection from ‘HTC sync’ to ‘Disk unit’.
● Move the configuration file (.solo) to a folder in the SD card and take notes of the location of this file.
● Start SoLo DTMF Client from your device. ● Select icon .
● Enter the registration code in ‘Insert Activation Key’.
● In ‘Load config.file’ select the ‘.solo’ file from the folder where you saved it.
Installation on Android devices – general procedure
● Connect your device to the PC via USB cable and select ‘USB Mass Storage”.● Enable the possibility to install applications from unknown/any source (Settings > Applica-tions > unknown/any source).
● Move the installation file (.apk) and the configuration file (.solo) to a folder in the SD card and take notes of the location of this file.
● Disable ‘USB Mass storage’ mode in the phone.
● Select ‘Market’ and install the free software ‘ASTRO File Manager’. Launch ASTRO software, select ‘SD card’ folder, then the SoLo installation file, ‘.apk’. Select ‘Open software manager’ and then select ‘Install’.
● Start SoLo DTMF Client from your device. • Select icon .
● Enter the registration code in ‘Insert Activation Key’.
SoSoftware SA
Ch. Renou 2 1005 Lausanne
Switzerland
www.sosoftware.com [email protected]
Tel. +41.(0)216.437.766 Fax. +41.(0)216.437.765
