Configuration of 3rd-party SIP devices using the dialog event package for status signalling (kb3165)
The information in this article applies to:
- SwyxWare v6.00
- Thomson (Model ST2030), Snom (Model 200)
This article describes how to configure the 3rd-party SIP devices of Thomson (Model ST2030) and Snom (Model 200) for status signalling.
To configure a user whose status shall be indicated on a line key, please use the telephone´s web interface as follows.
Before the connection to the web server, the IP phone must be connected to the network and then be powered up. The web menu language is considered to be english.
• Note: it might be possible that the function keys cannot be assigned individually. This may be dependent on the telephone´s firmware. In this case, please contact the manufacturer of the IP phone. If you use an additional extension module which can be connected to the basic device and makes more function keys available, you can try to configure those function keys as line/user keys. Please act as follows.
• Start a web browser session.
• Input the phone´s IP address into the address field with the ending "/admin.html", for example http://10.0.0.1/admin.html. You get the IP address from the context menu of the telephone, if necessary.
• Enter the username (by default: administrator) and the password (by default: 784518). If required, refer to the IP phone´s manual to get the correct login information.
• Choose the "ADVANCED" item in the menu list on the top the start page.
• Choose "Call Feature" in the left menu.
• You now see the settings of the "Phone Operation". Choose the "Function Key Table" on the bottom of the page.
• If you can´t change the type of the function keys on the next page (the fields are grey), switch to the "Extension Module", if available.
• If you now can change the type of the function keys, choose "Supervised Line" in the drop down menu of a function key and enter the SIP URI of the user whose status shall be shown in the appropriate URI field, e.g. <sip:number@IP-address>.
• Save the dialog by pressing the "Change ..." button, depending on whether you are in the ST2030 or in the extension module menu.
• Maybe the parameter change will require the phone to be rebooted. In this case, press the "Restart" button.
• Start a web browser session.
• Input the phone´s IP address into the address field, for example http://10.0.0.1. You get the IP address from the context menu of the telephone, if necessary.
• Choose the "Function Keys" item in the left menu.
You can now see the "Key Settings".
• To configure a function key for a user whose status shall be shown, choose "Destination" in the drop down menu of a function key and enter the user´s SIP URI in the appropriate URI field, e.g. <sip:number@IP-address>.
• Press the "Save" button to save the settings. The SIP URI might be extended automatically with additional parameters.
The line keys are now active and ready for status signalling. The IP phone´s LED signals the following user states:
• "LoggedOn/LoggedOff/Unavailable": LED off
• "Speaking": LED on
SIP SUBSCRIBE messages with event parameter "dialog" (corresponding to RFC 4325 "An INVITE-Initiated Dialog Event Package for the Session Initiation Protocol (SIP)") signal the connection state during a call, e.g. trying, proceeding, early, confirmed oder terminated. They provide information in which state the called user currently is.
Status queries about other users correspond to RFC 3856 "A Presence Event Package for the Session Initiation Protocol (SIP)" and use SIP SUBSCRIBE messages containing the "presence" event parameter. The current state of the observed user is transmitted within a SIP NOTIFY message which includes a XML content, usually in PIDF format according to RFC 3863 "Presence Information Data Format (PIDF)".
To signal a user´s state, the manufacturers Thomson and Snom employ SIP SUBSCRIBE messages with event paramter "dialog". These requests will be handled in the same manner as general presence status queries. The corresponding NOTIFY answers contain the "dialog" event parameter and a dialog XML content according to RFC 4235.
The Thomson ST2030 phone sends one subscription for each configured user, the Snom 200 phone sends additionally one subscription for each called user. This call bound subscription is deleted after the call is established (SIP-SUBSCRIBE message with "Expires: 0" parameter).