Polycom Presence Setup

From FreeSWITCH Wiki
Revision as of 20:30, 30 April 2014 by Mario G (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search


This page was converted to Confluence April 30 2014. The new page is located at: https://confluence.freeswitch.org/display/FREESWITCH/Polycom+Presence+Setup



Setting up the Polycom Soundpoint Phones for Presence and BLF

The Polycom Soundpoint IP Series phones (and others) use SIP Notify and Presence to enable BLF (Busy Lamp Field) support. This allows one to monitor the status of other phones on the switch.

Pre Requisites

  • Polycom Firmware 3.1
  • Externally provisioned (tftp/ftp/http all work).


Modify sip.cfg to enable the presence feature.

   <feature feature.1.name="presence" feature.1.enabled="1" ...

Ensure only the first line is registered. Leave the second line unregistered so it is free to act as a BLF. You can verify in the phone's configuration MACADDR-phone.cfg:

  <OVERRIDES ... reg.1.lineKeys="1" ... />

There should be no reg.2.lineKeys="2" in there.

Presence works through Buddies with Polycom. Either add speed dial entries through the phone's Directories feature, or add entries in your remote directory file (000000000000-directory.xml) with the <bw> tag. Busy Lamp Field operates on the principle of Buddy Watch (thus <bw>). You can enable buddy watch on speed dial entries manually through the Directories interface. The <sd> tag affects the order that speed dial contacts occupy your available line keys. sd is unique whereas bw is 1 or 0. For more information see the 3.1 SIP Admin Guide at polycom.com. Below is an example directory file:

<?xml version="1.0" standalone="yes"?>

If setup correctly, the light should be off when the line is not in use, solid when the line is in use, and blinking if there is a problem. You can test the problem state by killing FreeSWITCH™ and waiting for the polycom to notice.

Configuration with productivity license installed - "Enhanced BLF"

The following paragraph was added to this wiki-page in response to findings in this discussion on the mailinglist, reader discretion advised(i.e. please read the discussion):
"Enhanced BLF" configuration as described below is supported on firmware 3.2.0 and newer. Therefore the configuration below does not seem to work on SoundPoint IP 301, 501, 600, 601 and SoundStation IP 4000, which are only supported by firmware up to 3.1.7. See UC_Software_Release_Notes_3_3_1F.pdf page 44 for details.
Enhanced BLF is also not available on IP 320/330, 321/331/335,5000, 6000, 7000 and VVX 1500/-C/-D due to firmware-/hardware-restrictions(See page 3 and 4 of the aforementioned document).

--Peletiah 16:53, 26 April 2011 (UTC)

Enhanced BLF provides ringing indication and directed call pick-up capability.

Once a productivity license has been installed, the BLF configuration can be added to the phone1.cfg(resp. in a phone-specific settings file like "${MAC}-settings.cfg).

The following should be configured at the phone's file (e.g. phone1.cfg or MAC-address-settings.cfg):

<attendant attendant.reg="1" attendant.ringType="1"

and for each user you want to watch:

attendant.resourceList.1.address="8000" attendant.resourceList.1.label="FirstUserName"
attendant.resourceList.2.address="8002" attendant.resourceList.2.label="SecondUserName"

And finally, the following line should be added into local-sip.cfg:

    <call call.directedCallPickupString="**"  />

On a FreeSWITCH installation with a default-dialplan, "intercept-ext" in conf/dialplan/default.xml is configured to catch **${destination_number}. Pressing the line-button on a ringing extension will cause the phone to call intercept-ext with ** and the ringing extension and the phone will be connected to the caller - a perfect setup for an attendant console.