Administrator Guide: Musitel or 2N VoiceBlue Lite SIM Box Integration

SOP Configuration

• Define the SIP trunk
  • Add a SIP Trunk Interface. Default values are recommended unless indicated otherwise below. Please consult Escaux for the recommended version.
    • If Consolidated management is used, make sure you assign this SIP interface to 1 SOP and not to all SOP's
  • Description: Simbox
  • Gateway: The Simbox IP address
  • Account Data & Auth User: These values should be identical to the Resource ID.
  • Password: escaux
  • Codecs to select: ulaw & alaw
  • Register: No
  • Advanced parameters
    • Security: Very insecure.
    • Host: This value should be identical to Gateway.
• Define the route(s) to mobile numbers at Communication Routing > Route groups (stable-4: on sop: Communication Routing > Extra-Cluster Routing)
  • Select the latest Goto.INTERFACE action.
    • Default Outgoing Interface : SOA1xxxx (the Simbox)
    • Fallback Interface 1 : Select another interface to make sure outgoing mobile calls are always possible.
    • Number of front digits to strip : Usually 1, depending on the specific configuration.

Simbox Configuration

Prerequisites

• Simboxes are not compatible with 3G-only cards. Not all 3G cards keep the ascending compatibility with 2G.
• Some GSM networks (such as Vodafone) always use roaming to connect their customers. Do not forget to enable it if needed!
• We recommend the Simbox uses firmware version 02.07.34 and bootcode 02.08. These have been extensively tested and have no known issues. Instructions on how to install this firmware can be found on the site of the manufacturer. See here.

Install the VoiceBlue Lite Program

• Insert the included cd and start the VoIP > Utilities > 2N VoiceBlue Lite Software installation.

Connect the Simbox

• Connect the power supply and when the device is completely started (all "GSM" LEDs are red), connect the USB cable to the simbox.
• Once Windows finished the USB driver installation, start the VoiceBlue control program. When a Simbox is reconnected, it is recommended to restart the VoiceBlue control program.
•  Navigate to: Settings > Communication settings
  Select the highest COM port.
• Click on the "connect gateway" button. You'll get "Would you like to load parameters from the gateway".Answer 'yes', then 'ok' to come back to the main window.

Configure Simbox

To configure the DRD_SimboxVoiceBlueLiteIntegration_AdminGuide, please perform the following actions.

Factory reset

Perform a factory reset of the simbox to make sure that the default parameters are set.

Unlock Key

Make sure the simbox is unlocked

• The unlock key is written on a white label ( with EBO handwriting ) on the box or on a Post-It inside the box.
• License status must be "Unlocked". If not, please consult the delivery document. The License Key should be indicated there. Be aware that if you enter a wrong key, the simbox might give the impression that the key is correct by displaying a pop up "The license key has successfully been stored.", but as long as the "License status" still displays the "Gateway unlocked, not needed to unlock" the simbox is not unlocked due to an invalid or missing License Key.

login and password

• Name (login) / password: for resellers: please communicate your login/password to Escaux when done.
• Save to the gate & Ok

Network Parameters.

• Configure IP address, subnet and router (network gateway).
• Pincode for ALL the SIM cards is 1234 . Make sure the client set these pincodes.
• Save to the gate & Ok

Roaming

To enable roaming functionality:

If required by the GSM operator, add the GSM network ID. The GSM network ID should be provided by the GSM network operator. You may also be able to find the GSM network ID on the following unofficial list: http://www.activexperts.com/activsms/networkcodes/ to find a code. If the GSM network operator has no code, check if it's using an other network. Example: If Vodafone uses Omnitel, Vodafone's network ID is 22210 (Omnitel).

SIP Parameters

• SIP registration
  • Registration domain (realm): Indicate the SOP/Communicator's IP address (use the SOP IP in a Gateway+SOP architecture)
  • Username: SOA10001 (or an increased number in case of multiple simbox's)
  • Password: escaux
• IP Addresses
  • Indicate the SOP/Communicator's IP address for SIP proxy (IP->GSM) (use the SOP IP in a Gateway+SOP architecture)
• Codecs priority: G711u - G711a - G729
• Save to the gate & Ok

Hide the CallerID

• Set CLIR as "Enable (CLIP - off)"
• Save to the gate & Ok

Incoming Calls

To allow incoming calls, we make sure that all calls to the simbox are sent to 1 specific extension on the Communicator/SOP. This extension then has a callflow which handles the call.

In the VoiceBlue application:

• IP addresses
  • Indicate the SOP/Communicator's IP address for SIP proxy (GSM->IP) (use the SOP IP in a Gateway+SOP architecture)
  • Save to the gate & Ok

• Mode > Accept incoming calls + dialtone
• Timeout for entering DTMF digit(s) : "0" (guarantees that the extension will be called immediately)
• List of called numbers > Add -> Choose an extension to be used on the SOP/Communicator & Ok, or much better, enter the GSM number (+32...) and use the Incoming Number Mapping table of the SOP.

Repeat the 'GSM Incoming groups' step for group 2->4. Save to the gate & Ok

Outgoing calls

Depending on the model of simbox, up to 4 simcards can be used. These can all belong to the same GSM network operator or they can be of different GSM network operator.

Simcards of one GSM network operator

This setup is the easiest: Calls can be send to a random available simcard.

• The value "Default count of digits" determines the destination number's minimum length in order to be accepted by the Simbox. Default is 9, 3 is recommended to be able to reach almost any destination.

• Define one record (line). Make sure the network ID '1' and Group 'GSM group 1' have been selected.
• Save to gate

Simcards of multiple GSM network operators

If you have simcards of multiple GSM network operators in the Simbox, the called number will usually determine the Simcard to be used.

• The value "Default count of digits" determines the destination number's minimum length in order to be accepted by the Simbox. Default is 9, 3 is recommended to be able to reach almost any destination.

• Define one line for each GSM network operator that will be used.

• Define the prefixes for the different GSM network operators that will be used, each in a different group.

• Assign the GSM group to one or multiple modules. "Module 0" contains the simcard in the first position.
• Verify all used groups have been defined!

Test & Troubleshooting

Network connectivity

• Give your PC an IP address in the same range as the Simbox
• In Voice Blue Control, Click On 'Gate' -> and select the only gateway in the list
• Edit, enter the necessary values to connect to the Simbox, OK
• Comm -> Type of Communication -> LAN -> Connect

You should now be connected to the Simbox.

Simcard placement

If the Simcard is correctly registered to the GSM network, no light should be lit.

Remember to reset the Simbox when a simcard has been added, moved or removed by disconnecting the power or by using the VoiceBlue application (Monitor > Gateway reset).

Useful debugging tools

Through the VoiceBlue application:

•  Navigate to: Gateway control > GSM Diagnostic
  Troubleshooting GSM signal levels, ..
•  Navigate to: Gateway control > Tracing
  Tracing events

Additional resources

Extensive documentation and software can be found on the website of the Simbox manufacturer http://www.2n.cz . Please note that not all features are supported.

Attachments:

• Simbox template: An example configuration for a Simbox that can be loaded in VoiceBlue Lite
• setup_vbl-2.0y.zip: MUSITEL GSM Program for the Simbox configuration.
• Musitel52-53-61.pdf: Musitel SIMBOX User Manual