Views

MWI Subscription

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 04:27, 24 September 2010 by Horemu (talk | contribs) (Use of Dialog Event Package (RFC 4245))
Jump to: navigation, search

<accesscontrol>OS-FD</accesscontrol>

Construction.png This article or section is currently under construction. In order to avoid editing conflicts, please wait until this message is removed or contact the author (Horemu 15:33, 23 September 2010 (CEST)).
Systematics
Family: OpenStage
Model: OpenStage 60
OpenStage 80
Relation: Phone related
Release: V1 R5

The phone will send a subscription to a configured MWI server according to the standard RFC 3842. Unsolicited Notify messages containing the message waiting information are also accepted.

The SIP server can be configured under

Administrator Pages -> System -> Features -> Services -> Message waiting server address

MWI-Subscription-1.png

Busy Lamp Field and Directed Call Pickup

The Busy Lamp Field feature in its most basic form provides the phone user the ability to monitor the state of other users/devices. Typically the information provided to the monitored user will allow them to determine whether the monitored user/device is idle, ringing or connected and it may also in some environments be able to indicate call held, line sized and forwarding states.

The monitoring user is informed of the state of the remote device by the LED associated with the BLF FPK and optionally by a alert tone/beep when the remote device receives an incoming call.

Additional functionality may be provided by the monitored users device by having an associated FPK and modifying the action performed when pressing the key depending on the current dialog state. For example when idle pressing the key may initiate a call to the monitored user and when ringing press-ing the key may initiate a pickup of the ringing call. In the HiPath 8000 environment BLF type functionality is provided by the DSS feature.

The Configuration of the BLF Key is done at three different places in the Admin Menu:

BLF Pickup Code

WBM path:

System -> Features -> Services

MWI-Subscription-2.png

BLF Key

WBM path:

System -> Features -> Program keys

MWI-Subscription-3.png

  • Key Label: Name of the FPK displayed on the screen
  • Monitored Phone: Extension of the phone, which monitored by the key
  • Audible Alert: If checked, the phone will do an alert for calling the attention of the user
  • Popup on alert: The phone displays a popup notification at the alert state

BLF alerting

WBM path:

System -> Features -> Configuration

MWI-Subscription-4.png

  • BLF alerting: Beep or Ring

Beep is a short audible indication for the user. Ring is using the selected ringer file for indication.

Some remarks about the SIP implementation

This section provides some guidance on the SIP protocol aspects of susbcribing to the SIP Server for dialog event information and for picking up calls ringing the BLF Destination.

Use of Dialog Event Package (RFC 4245)

On initialisation the OpenStage phone will initiate a subscription to the dialog event package for each FPK configured for the BLF feature. An example of this subscription and a subsequent notify received from an Asterisk server is given below.

A SIP SUBSCRIBE request is generated for a BLF key configured to monitor extension 6001.

SUBSCRIBE sip:6001@137.223.238.41:5060 SIP/2.0
Via: SIP/2.0/UDP 137.223.238.18:5060;branch=z9hG4bK-1-0
From: sipp <sip:6000@137.223.238.18:5060>;tag=1
To: sut <sip:6001@137.223.238.41:5060>
Call-ID: 1-648@137.223.238.18
CSeq: 1 SUBSCRIBE
Contact: sip:6000@137.223.238.18:5060
Max-Forwards: 70
Event: dialog
Accept: application/dialog-info+xml
Expires: 3600
Content-Length: 0

The Asterisk Server responds with a 200 OK.

SIP/2.0 200 OK
Via: SIP/2.0/UDP 137.223.238.18:5060;branch=z9hG4bK-1-0;received=137.223.238.18
From: sipp <sip:6000@137.223.238.18:5060>;tag=1
To: sut <sip:6001@137.223.238.41:5060>;tag=as065f0599
Call-ID: 1-648@137.223.238.18
CSeq: 1 SUBSCRIBE
User-Agent: Asterisk PBX
Allow: INVITE, ACK, CANCEL, OPTIONS, BYE, REFER, SUBSCRIBE, NOTIFY
Supported: replaces
Expires: 3600
Contact: <sip:6001@137.223.238.41>;expires=3600
Content-Length: 0

The Asterisk Server generates an initial NOTIFY for the subscription and indicates that extension 6001 is idle (dialog state = terminated).

NOTIFY sip:6000@137.223.238.18:5060 SIP/2.0
Via: SIP/2.0/UDP 137.223.238.41:5060;branch=z9hG4bK35d158aa;rport
From: sut <sip:6001@137.223.238.41:5060>;tag=as065f0599
To: sipp <sip:6000@137.223.238.18:5060>;tag=1
Contact: <sip:6001@137.223.238.41>
Call-ID: 1-648@137.223.238.18
CSeq: 102 NOTIFY
User-Agent: Asterisk PBX
Max-Forwards: 70
Event: dialog
Content-Type: application/dialog-info+xml
Subscription-State: active
Content-Length: 212
<?xml version="1.0"?>
<dialog-info xmlns="urn:ietf:params:xml:ns:dialog-info" version="0" state="full" enti-ty="sip:6001@137.223.238.41:5060">
<dialog id="6001">
<state>terminated</state>
</dialog>
</dialog-info>

The phone responds to the NOTIFY with a 200OK.

SIP/2.0 200 OK
Via: SIP/2.0/UDP 137.223.238.41:5060;branch=z9hG4bK35d158aa;rport
From: sut <sip:6001@137.223.238.41:5060>;tag=as065f0599
To: sipp <sip:6000@137.223.238.18:5060>;tag=1
Call-ID: 1-648@137.223.238.18
CSeq: 102 NOTIFY
Contact: <sip:137.223.238.18:5060;transport=UDP>
Content-Length: 0

Multiple dialogs reported in a dialog event.

A single SIP NOTIFY may contain information relating to multiple dialogs active at the BLF Destination. For example when the BLF destination receives a call waiting call. In this case the phone must parse all dialogs to determine the state to be reported. The state with the highest priority is used to set the state of the BLF LED and any associated popup.

The priority is as follows:

Priority Dialog State Call State at BLF Destination BLF LED State
1. State = Early,direction=recipient. Incoming call alerting at destination. Flashing (Incoming Call)
2a. State = Early, direc-tion=originator Outgoing call. On (Busy)
2b. State = Confirmed Established Call (Including held) On (Busy)
3. State = Terminated Call has been cleared Off (Idle).

Picking-Up a call ringing a BLF destination.

To pickup a call ringing a BLF destination the procedure followed by the Picking-up OpenStage phone depends on configuration and on the amount of information received in the dialog event as follows.

Picking-Up using a feature access code

If a feature access code is configured for BLF Pickup then the OpenStage phone generates an INVITE using the feature access code (FAC) and the BLF Destination in the Request-URI of the INVITE request. The content of the INVITE would be as followed (Note – Only the significant headers are shown).

INVITE sip:<FAC><BLF Destination>@SIPServerDomain SIP/2.0
From: <sip:6000>;tag=drfgdfdg
To: sip:<FAC><BLF Destination>
Call-ID: gshgshjgsgshjgshjg
CSeq: 1 INVITE
Accept: application/sdp
Content-Type: application/sdp
Content-Length: xxx
…

This method is used whenever a feature access code is configured for BLF Pickup.

Picking-Up using the SIP Replaces Header (RFC 3891)

If no BLF Pickup feature access code is configured and the dialog event received from the SIP Server contains at a minumum the “call-id” and the “local” and “remote” elements then the OpenStage phone shall folllow the Picking-Up UA procedures as specified in the OSCAR SIP Directed Pickup Specification. This involves generating a SIP a SIP INVITE with Replaces header.

Picking-Up using an INVITE to the remote target-URI.

If no BLF Pickup feature access code is configured and the dialog event contains the “local” and “re-mote” elements but no “call-id” then the OpenStage phone using the same procedures as defined in 0 but without including a Replaces header in the INVITE request.

This method relies on the SIP Server setting the remote target-uri to be something that it will recognise as a call pickup request.