Views

SIP Devices and Asterisk

The Wiki of Unify contains information on clients and devices, communications systems and unified communications. - Unify GmbH & Co. KG is a Trademark Licensee of Siemens AG.

Revision as of 11:59, 24 September 2010 by Harald.saller (talk | contribs) (Service and Troubleshooting)
Jump to: navigation, search

Preparation

Power Supply

Power over Ethernet

The following phone configurations can be operated with PoE, provided that the switch has the appropriate power class:

Model / Configuration Power Class
OpenStage 15 (includes 1 Key Module 15) 1
OpenStage 20 E 1
OpenStage 20 1
OpenStage 20 G 2
OpenStage 40 (includes 1 Key Module) 2
OpenStage 40 + 2nd Key Module 2
OpenStage 40 G 3
OpenStage 40 G + 2nd Key Module 3
OpenStage 60/80 (includes 1 Key Module + USB-Extension with Acoustic Unit) 3
OpenStage 60/80 + 2nd Key Module 3
OpenStage 60/80 G (includes 1 Key Module + USB-Extension with Acoustic Unit) 3


External Power Supply

For an OpenStage 60/80 G with a 2nd Key Module, an external power unit is required. The order no. for the plug-in power supply is region specific:

  • EU: C39280-Z4-C510
  • UK: C39280-Z4-C512
  • USA: C39280-Z4-C511

Energy Saving

OpenStage phones offer an energy saving mode. The display backlight is switched off after a configurable timeout. With OpenStage 40, the main display and key module backlight will be switched off after 90 seconds of inactivity (firmware version V2R0 onwards). Readability even without backlight is ensured by the transflective display. With OpenStage 60 and 80, the timer is configurable by the administrator (Local Functions > Energy saving); the timeout ranges between 2 and 8 hours.

Connecting to an IP Network

802.1x

OpenStage phones support 802.1x EAP-TLS. Certificates for authentication can be downloaded via the WPI.

LLDP-MED

OpenStage SIP phones support the layer 2 protocol LLDP-MED (Link Layer Discovery Protocol-Media Endpoint Discovery). When an OpenStage phone is connected to a switch with LLDP-MED capabilities, the phone is able to

  • advertise and receive a VLAN ID,
  • advertise and receive QoS parameters,
  • advertise the power requirements to the LAN access switch by means of an "Extended Power via MDI" TLV.

LLDEP-MED usage is configured in the administratio menu under Network > IP configuration.

DHCP

The following parameters can be obtained by DHCP:

Basic Configuration

  • IP Address
  • Subnet Mask (option 1)

Extended Configuration

  • Default route (option 3)
  • Static IP routing (option 33)
  • SNTP server (option 42)
  • Timezone offset (option 2)
  • Primary/secondary DNS server (option 6)
  • DNS domain name (option 15)
  • SIP Addresses / SIP Server & Registrar (SIP Server option 120)
  • Vendor unique (option 43)

The vendor specific option (code 43), or alternatively, a vendor class, is used to provide the phone with the location of an optional configuration/provisioning service. By this means, full Plug&Play is possible (see the Plug&Play) section. For further information, including an example configuration for dhcp, please refer to the pdf.png  Administration Manual OpenStage Asterisk.

Plug&Play

A fully automated mass rollout of OpenStage phones can be realized by combining a DHCP server and a provisioning service which uses the WPI. On startup, the phone receives the IP address of the provisioning server from the DHCP server. After that, it contacts the provisioning service. The provisioning service may then request all settings from the phone in order to decide which parameters must be set or updated. When all these parameters have been sent to the phone, it is ready for operation. For further information, please see the WPI article; for a deeper understanding, refer to the pdf.png  OpenStage Provisioning Interface Developer's Guide.

Using OpenStage Phone with Asterisk

For an overview of the features introduced with firmware version V2R1, please refer to pdf.png  ReadMe V2 R1 100907

Feature Table

In this table, you find information on all features which are supported by OpenStage phones connected to an Asterisk PBX.

Phone Applications
Feature Phone with firmware version ≥ Short Description Further Information
Local Phone Book OpenStage 60/80 ≥ V1 R5.6.0
OpenStage 40 ≥ V2R1
Stores names and call numbers locally on the phone. OpenStage_Phone_Book_Application
Copy LDAP results and Call Logging records into Local Address book
LDAP OpenStage 60/80 ≥ V1 R5.6.0
OpenStage 40 ≥ V2R1
The phone can be used to retrieve call numbers or other address data from an LDAP directory. LDAP on OpenStage
Support of LDAP on OpenStage 40
Call Log OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 Stores a list of missed, dialed, received, and forwarded calls. With V2R1 onwards, the call log can be cleared via the WPI. Configurable flag to delete call log contents
MWI OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 Message Waiting Indication. The user is notified of new and old voicemail messages. With V2 onwards, the message indication is configurable. MWI Subscription
Configuration of MWI count names
Help OpenStage 60/80 ≥ V1 R5.6.0 Quick reference which is shown on the phone display when the Help mode key is pressed. -
XML Application Platform OpenStage 60/80 ≥ V1 R5.6.0 XML-based interface to the phone which allows for developing interactive applications. The phone acts as a front-end for a server-side program. XML Application Platform at the SEN Community Portal
CTI Applications OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 Allows a computer to interact with the phone, e.g. in setting up and terminating calls via a PC application. OpenStage phones support 3rd party call control via SIP and uaCSTA. By the use uf uaCSTA, operations like call answering, putting a call on hold, making a call, setting microphone and speaker settings, and many more, can be performed. OpenStage_CTI_Applications
pdf.png  white_paper_uaCSTA_Public_version_2010803
FPK (Free Programmable Keys) OpenStage 15/40/60/80 ≥ V1 R5.6.0 These keys can be associated with special phone functions. OpenStage_Free_Programmable_Keys
Call Related Features
Busy Lamp Field (BLF) OpenStage 15/40/60/80 ≥ V1 R5.6.0 This function offers the possibility to monitor another extension, and to pick up calls for the monitored extension. The LED of the key will indicate the state of the extension monitored. Asterisk Feature Busy Lamp Field (BLF)
Phone Based Conference OpenStage 15/40/60/80 ≥ V1 R5.6.0 The phone establishes and controls a 3-way conference (3pcc, third party call control). -
Voice Mail OpenStage 15/40/60/80 ≥ V1 R5.6.0 The user can contact the Asterisk voice mail service by means of the messages key. -
Call Group OpenStage 15/40/60/80 ≥ V1 R5.6.0 If a phone belongs in a pickup group that matches one of the caller's call groups, that phone may pickup the incoming call by sending the appropriate feature code. -
Call Pickup OpenStage 15/40/60/80 ≥ V1 R5.6.0 The BLF function offers the possibility to pick up calls for a monitored extension. The LED of the key will indicate the state of the extension monitored. Asterisk Feature Busy Lamp Field (BLF)
Call Forward OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 The user can configure local or server based call forwarding to specified destinations. For information about server based call forwarding, see Fix Forwarding Key to send URL to Server.
Call Waiting OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 If allowed, a call from a third party will be indicated acoustically during an active call. -
Do Not Disturb (DND) OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 If this feature is activated, incoming calls will not be indicated to the user. -
Auto Answer - TBD - Automatic call answering can be requested from within the incoming call via the SIP Alert-Info header. -
Call completion (CFBS, CFNR) - TBD - Call completion is a telephony feature which takes action on a failure to complete a call. It allows for notifying the calling user when the called user is available again. CCBS (Call Completion Busy Subscriber) will take effect when the called party is busy; CCNR (Call Completion No Reply) will take effect when the called party does not respond. pdf.png  White_Paper_CC_10090
Call Transfer OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 Blind call transfer and call transfer with consultation are supported. In a blind transfer scenario, user A selects the blind transfer option during a conversation with user B and enters the number of user C. After that, user B is disconnected from user A and rings at user C's phone. In a consultation scenario, user A initiates a consultation call to user C during a conversation with user B. After haveing returned to the conversation with B, he selects the transfer option. User A is disconnected from user B, and B is connected to C. -
Executive/Assistant configuration OpenStage 60/80 ≥ V1 R5.6.0 Complex configurations with multiple executive and assistents which indicate the current status of the relevant persons can be realized using the OpenStage XML application platform. XML Application Platform at the SEN Community Portal
DTMF OpenStage 60/80 ≥ V1 R5.6.0 If control codes are to be sent to the PBX during a call, DTMF (Dual Tone Multi Frequency) tones can be used. -
Alternate Call OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 The user can alternate between the currently active call and another call that is on hold. -
Call Hold OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 The user can put a call on hold in order to switch over to another connected call or to call another party. -
Consultation OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 During an active call, the user can initiate a consultation call to a third party. After that, he can alternate between the two parties. -
CLIP OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 When the call number resp. caller ID is transmitted within an incoming call, the phone displays it when it is in ringing state. -
CLIR OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 Caller ID transmission is suppressed. -
Local Music on Hold OpenStage 15/20/40/60/80 ≥ V1 R5.6.0 If desired, OpenStage phones can be configured to play custom hold music to the user when put on hold. The audio or mp3 file can be uploaded via FTP; the download can be initated via local menu, WBM or WPI. FAQ - Music On Hold for OpenStage
MAA (Multiple Address Appearance) -TBD - The Multiple Address Appearance feature provides the served user with multiple addresses appearing on a single telephone. The served user has the ability to originate, receive and otherwise control calls on each of these address appearances. These address appearances behave independently of each other. pdf.png  White_Paper_MAA

Service and Troubleshooting

OpenStage phones provide plenty of tools and options to find the cause of a problem quickly, even if it is not located at the phone.

For a guide to error tracing with OpenStage phones, please refer to .

LAN Port Mirroring

Every OpenStage phone has a built-in Ethernet switch with a LAN port and a PC port. For development and error tracing, the PC port enables network monitoring when configured as a mirror for the LAN port. For this purpose, PC port mode must be set to "mirror". If configured this way, the complete traffic of the LAN port will be passed through to the PC port, just like with a simple network hub. Now, a network tracing tool on the PC can trace all IP traffic, like SIP over UDP, or XML over HTTP, for instance.

Tracing Capabilities within the Phone

Basic Troubleshooting

For tracking network issues, the phone can execute ping and traceroute tests; these can be controlled and viewed online using the WBM.

For elementary troubleshooting, the phone provides an overview about basic issues in the user menu. The admin can ask the user to read that basic information to get a first hint about the possible causes of an issue:

Problem Description Error code
Network Problem No network connection LI1
Not Initialised Waiting for data I1
Unable to use LAN 802.1x error LX1
Unable to use LAN Physical connection missing LP1
Unable to Register Server timeout RT2
Unable to Register Server failed RF2
Unable to Register Authentication failed RA2
Unable to Register No number configured RN2
Unable to Register No server configured RS2
Unable to Register No registrar configured RG2
Unable to Register No DNS domain configured RD2
Unable to Register Rejected by server RR2
Unable to Register No phone IP address set RI2
Survivability Backup route active B8
Survivability Backup timeout RT8
Survivability Backup authentication failed RA8

Local and Remote Tracing

The phone is able to write internal trace files, and to send the trace data to a remote syslog server. The tracing can be configured in a differentiated way by setting discrete trace levels for each service. Please note that, order to preserver phone ressources, it is not recommended to enable all traces to the deepest level.

QoS Data Collection

OpenStage phones generate QoS reports using a HiPath specific format, QDC (QoS Data Collection). The reports created for the last 6 sessions, i. e. conversations, can be viewed on the WBM or are reported to the QCU (QoS data Collection Unit). SEN provides a server application to collect the data. The collected data is sent via SNMP. If an SNMP server is available, the QDC MIBS can be downloaded from our software supply server (SWS). Meanwhile, third party solutions are available which can also deal with the OpenStage QDC data.

HUSIM Phone Tester

This tool enables the service staff to access a defined group of phones remotely.

For each phone, a PC application window shows the current status. Every OpenStage phone model is represented with its complete key layout and display content. The remote visitor can see all user interactions on the phone. Moreover, he can access the phone keys actively and in this way operate the phone by remote control. Please note that, for privacy protection, the user is always informed about the remote interaction.

To get the phone tester up and running, a special dongle key must be uploaded to the phone. The dongle key and the HUSIM software can be downloaded without additional charge from SWS/SEBA. The key can be distributed to the phone using the SEN DLS (Deployment Service) or the phone’s WPI (WorkPoint Interface).