Polycom Phones Module for FreePBX - Excalibur Partners, LLC

The Polycom Phones module for FreePBX allows for quick and easy provisioning of phones running the Polycom UC software. With FreePBX module integration it is easy to configure line keys to toggle and provide feedback of features like call forwarding, parking, and time conditions. Additionally network based settings make it possible to automatically use a low bandwidth codec when the phone is used outside the office.

The module is released under the GPLv2 license and distributed without any warranty. Support will only be provided to customers of Excalibur Partners, LLC.

System Requirements

FreePBX 2.11, 12, 13
Asterisk 1.8 (depreciated), 10, or 11
PHP 5.2+

DHCP Configuration

The recommended method is to configure option 160 on your DHCP server to http://yourfreepbxserver/polycom. Alternatively you can manually configure each phone. When the phone is booting select Setup and enter the Provisioning menu. Change the Server Type to HTTP and the Server Address to yourfreepbxserver/polycom.

FreePBX Configuration (Settings -> Advanced Settings)

The module was designed using FreePBX with device and user mode enabled. It is also recommended to change the following settings. If you already have created devices you will need to change the SIP nat and SIP sendrpid on each device.

User & Devices Mode = deviceanduser
SIP nat = yes
SIP sendrpid = pai
Enable Custom Device States = true

Uploading UC Software

Upload the extracted UC software to /var/www/html/polycom on your FreePBX server. The phone will automatically download the new version when rebooted.

Security Concerns

The module exposes the SIP device username and password in the XML config generated by the http://yourfreepbxserver/polycom URL. This does require the MAC address of the phone to be known. It is recommended to require and change the default network provisioning username and password. Additionally for enhanced security an SSL certificate should be installed and the network provisioning require SSL option enabled. Remember to update your DHCP configuration and/or phones accordingly.

Downloads

Polycom Phones and UC Software Tested

SoundPoint IP 335 4.1.0 Rev I PolycomSoundPointIP-SPIP_335-UA/4.1.0.84959
SoundPoint IP 550 4.1.0 Rev I PolycomSoundPointIP-SPIP_550-UA/4.1.0.84959
SoundPoint IP 650 4.1.0 Rev I PolycomSoundPointIP-SPIP_650-UA/4.1.0.84959
SoundStation IP 5000 4.1.0 Rev I PolycomSoundStationIP-SSIP_5000-UA/4.1.0.84959
VVX 300 4.1.5 Rev E PolycomVVX-VVX_300-UA/4.1.5.3284
VVX 400 4.1.5 Rev E PolycomVVX-VVX_400-UA/4.1.5.3284
VVX 300 4.1.6 PolycomVVX-VVX_300-UA/4.1.6.4835
VVX 400 4.1.6 PolycomVVX-VVX_400-UA/4.1.6.4835
VVX 300 4.1.7 PolycomVVX-VVX_300-UA/4.1.7.1210
VVX 400 4.1.7 PolycomVVX-VVX_400-UA/4.1.7.1210
VVX 300 5.5.0 PolycomVVX-VVX_300-UA/5.5.0.20556
VVX 311 5.5.0 PolycomVVX-VVX_311-UA/5.5.0.20556
VVX 400 5.5.0 PolycomVVX-VVX_400-UA/5.5.0.20556

Asterisk Releases Tested

Certified Asterisk 1.8.15-cert3
Certified Asterisk 1.8.15-cert5
Certified Asterisk 11.2-cert2
Certified Asterisk 11.6-cert11
Certified Asterisk 11.6-cert13
Certified Asterisk 13.8-cert3

Polycom Flexible Line Key Assignment

SoundPoint IP requires UC software 4.0.0 or later
VVX requires UC software 4.1.6 or 4.1.7

Changelog

13.0.0 - Adds PJSIP support, improve security, and switch to FreePBX 13 layouts
2.11.0.17 - Adds multiple extension assignment and integration with Kamailio module
2.11.0.16 - Fixed another compatibility issue with FreePBX 13
2.11.0.15 - Adds options to change phone provisioning settings and enhance security
2.11.0.14 - Fixed compatibility issue with FreePBX 13
2.11.0.13 - Adds device password options, support for new Polycom MACs, and compatibility for FreePBX 13
2.11.0.12 - Adds loud ringer option and enables n-way conference
2.11.0.11 - Adds NTP options and phone display update on adhoc login
2.11.0.10 - Adds integration with phone features module
2.11.0.9 - Fixed a bug introduced with flexible line assignment
2.11.0.8 - Adds flexible line key assignment
2.11.0.7 - Adds codec priority options to network settings
2.11.0.6 - Adds additional attendant options and option subheadings
2.11.0.5 - Adds support for phone overrides, additional options and help popups
2.11.0.4 - Adds authentication options to network settings
2.11.0.3 - Adds network settings and additional phone options
2.11.0.2 - Adds power saving settings and additional help popups
2.11.0.1 - Adds alert info, corporate settings and additional phone options
2.11.0.0 - Initial release for UC software

Source Code

It you would like to contribute bug fixes or additional functionality the source code is available on GitHub.

Screenshots

Our Services

Your source for complete IT solutions