SoLo DTMF Solution. Installation and Configuration Guide

Transcription

1 SoLo DTMF Solution Installation and Configuration Guide

2 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 List of Templates Section 3: Enabling Features Section 4: Personal Features SoLo Client DTMF Installation Installation on BlackBerry devices Installation on Symbian devices Installation on Android devices HTC models Installation on Android devices general procedure Issue Page 2-19

3 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. SoLo Client Send request for outgoingcall via GSM channel GSM Channel PRI BRI T1-E1 GSM PBX PBX phonescalled party PRI BRI T1-E1 GSM SKYPE Called party 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 corporate numbers for free). You can download this manual also from our website at under Resources. Should you need further support, please contact us at support@sosoftware.com. Issue Page 3-19

4 General Installation Requirements DISA Service Check availability of DISA Service (1) on your PABX. If it is not present, please contact your PABX supplier to check if they can activate the service. Take note of the procedure to access the service: telephone 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 v ) - 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: 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) SoLo DTMF Client registration code (4) Issue Page 4-19

5 (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 (4) Registration code is sent via after purchasing SoLo DTMF Client Issue Page 5-19

6 Configuration file (.solo) Introduction When you download SoLo DTMF Client from 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 password, 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 internal services must be set in this file. The file is usually compiled by the system installer. Please find a detailed description of each configuration file line on the following pages. Issue Page 6-19

7 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 below. 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 LOGO_KEY = ; ONE_PERSONAL_NUMBER = ; COMPANY_NAME VERSION = 4.2; TYPE = 2; PABXPIN = 222; DEVICENUMBER = 255; = = SoSoftware; USER_ID = ; 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; CONFERENCE_ON_ANSWER = 0; Issue Page 7-19

8 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 PERSONAL_FUNCTION_2 PERSONAL_FUNCTION_3 PERSONAL_FUNCTION_4 PERSONAL_FUNCTION_5 PERSONAL_FUNCTION_6 PERSONAL_FUNCTION_7 PERSONAL_FUNCTION_8 PERSONAL_FUNCTION_9 PERSONAL_FUNCTION_10 = My Function 1%1024%CALL_HANGUP%; = My Function 2%1025%CALL_FREE_NUMBER%; = My Function 3%1026%CALL_NO_HANGUP%; = My Function 4%0%CALL_TONE_NO_HANGUP% %; = My Function 5%1028%CALL_TONE_HANGUP%2222%; = CALL_HANGUP%0%CALL_HANGUP%; = CALL_FREE_NUMBER%0%CALL_FREE_NUMBER%; = CALL_NO_HANGUP%0%CALL_NO_HANGUP%; = CALL_TONE_NO_HANGUP%0%CALL_TONE_NO_HANGUP%222222%; = CALL_TONE_HANGUP%0%CALL_TONE_HANGUP%7777%; Issue Page 8-19

9 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 to access internal services here you should insert: DID_PREFIX = ; In the file section Template you should insert the rest of the number 200, 201 level with the service. 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 configuration 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 added before the telephone numbers dialled 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 = LOGO_KEY = ; This tag must be set = to load your logo on GSM display when using SoLo DTMF Client. Example: LOGO_KEY = ; Issue Page 9-19

10 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 = ; 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 = ; 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. The ARS code will be automatically inserted before all numbers dialled via SoLo DTMF Client which are longer than the value set here. Example: INTERNAL_NUMBER_LENGTH = 3; Issue Page 10-19

11 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: : If you call it from abroad you dial: If you call it using the local network you must dial: 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 national 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: or This format is not accepted by fixed line networks. SoLo DTMF Client removes this code when dialling numbers from the mobile phone contacts before sending the number to the PABX. If the international 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 = ; Issue Page 11-19

12 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 Client to automatically access services on your PABX. We use letters to ease the compilation of Templates as per table below. Code Description TAG, P Separator between the number you want to call and what is sent via DTMF 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 ,PDS#N In the Template shown above, SoLo DTMF Client calls number 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 # Finally it sends the telephone number dialled by the user or selected from Contacts Issue Page 12-19

13 List of Templates SPEECH_ACCESS_NUMBER = ; Access your voic . ACTIVE_APPEARANCE_SELECT = ; AUTO_CALL_BACK_TOGGLE = ; 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 = ; CALL_PICKUP_DIRECT = ; CALL_PICKUP_GROUP = ; CALL_PICKUP_GROUP _EXTENDED = ; CALL_UNPARK = ; CONFERENCE_ON_ANSWER = ; This optional tag is to enable conference calls on answer. Issue Page 13-19

14 DROP_LAST_ADDED_PARTY = ; This optional tag is used to drop last added party to conference. EXCLUSION = ; HELD_APPEARANCE_SELECT = ; IDLE_APPEARANCE_SELECT = ; This required tag is the idle line for dial tone. IDLE_APPEARANCE_SELECT2 = ; OFF_PBX_DISABLE = ; This tag is used to disable Twinning. OFF_PB_ENABLE = ; This tag is used to enable Twinning. SEND_ALL_CALLS_DISABLE = ; SEND_ALL_CALLS_ENABLE = ; TRANSFER_TO_COVERAGE = ; 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 = ; This tag is used to disable DND (Do Not Disturb). Issue Page 14-19

15 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 = , 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 separated by commas. Example: BLOCKED_NUMBER = , 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 = , 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 Replacement and users can call via SoLo DTMF Client only. By entering the following code, '## *' 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'). Issue Page 15-19

16 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 Features The syntax must be exactly in the format explained below. The length of menu text must be maximum 50 characters. The separator is the symbol % and the line must end with the symbol ;. 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 CALL_HANGUP CALL_FREE_NUMBER CALL_NO_HANGUP CALL_TONE_NO_HANGUP CALL_TONE_HANGUP Description SoLo DTMF Client calls the number, waits for connection and hangs up SoLo DTMF Client calls the number, waits for connection, waits for the user to select a number. SoLo DTMF Client calls the number, waits for connection and does not hang up. SoLo DTMF Client calls the number, waits for connection, sends the tones and does not hang up. SoLo DTMF Client calls the number, waits for connection, sends the tones and hangs up. Issue Page 16-19

17 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. Issue Page 17-19

18 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 > Applications > 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 > Applications > 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. In Load config.file select the.solo file from the folder where you saved it. Issue Page 18-19

19 SoSoftware SA Ch. Renou Lausanne Switzerland info@sosoftware.com Tel. +41.(0) Fax. +41.(0) Issue Page 19-19