When configuring a phone through the PBX, the MAC of the device is assigned to the extension allowing the creation of a config file which is downloaded to the phone, telling it how to be programmed. There are two methods to configure a phone to the PBX:
This method involves some PBX programming and selections at the phone itself to configure the phone.
- Create an extension in the PBX and set Phone Type to the model of phone you wish to provision; Save and Apply Changes
- Navigate in the PBX to PBX Setup=>General; ensure that Autoprovisioning is Running (click ON if it is currently Stopped)
- At the phone, press Menu
- Select System Settings
- Select Advanced Settings
- Press OK when prompted for a password as there is no password
- Select SIP
- Select Auto Prov
- Navigate to Extension Number and press the softkey for Modify
- Enter the Extension Number
- Press OK
- Press Done
This method involves scanning the network with AutoDiscovery and assigning the extensions to the phones from the PBX.
- Create an extension in the PBX
- Navigate to Destinations=>Extensions
- Select AutoDiscovery=>Scan Network
- Find the MAC of the phone you wish to configure
- Change the Assigned dropdown from None to the extension you want to configure to that phone
- Put a check mark in the box next to this phone
- Select the Commands tab at the top of the page
- Click Assign, Configure, and Restart button
This method involves programming from the phone manually and should be avoided if possible due to the time involved. It is always best to program the phone from the PBX via one of the methods mentioned above.
- Create an extension in the PBX
- Log into the IP address of the phone
- Click Config Guide
- Click Next which takes you to the network page, no changes should be necessary on this page
- Click Next which takes you to the Account page
- Username = Extension Number
- Password = SIP Password
- SIP Server = IP address of the PBX
- Click Finish and the phone will be configured to the PBX in a basic manner
- Navigate to Advanced=>Phone Setting
- Set Called No Answer Time to 99, then uncheck the box
- Set Pickup Code to 99
- Set Message to 923
- Change Set Time Mode to SNTP
- Select Manual for SNTP Time Server and enter the IP address of the PBX or a time server such as time.nist.gov
- Set Daylight Savings, Time Format, and Time Zone accordingly
- Set BLF Light to Off
- Click Submit
- Manually Program keys as per the users desire.
Manually Programming Keys
- speed dial ##700# Account 1
- Park 701-720
- BLF park orbit # Account 1
For any feature codes program the feature code as a speed dial like park button above and set Account to Account 1.
- Provision the phone locally as you would any other phone on the LAN, if programming to a Cloud PBX, skip to step 2
- Configure the PBX Site router with port forwards of 5060 UDP and 10k-20k TCP/UDP. The port forwards should point at the LAN address of the PBX
- Navigate to PBX Setup=>SIP and enter the Public IP address of the PBX under External IP, Save
- Navigate to System=>Access Control=>Access Control List
- Configure so that the IP address for the remote phone can communicate to the PBX in one of two ways:
- Navigate to the PBX Settings for the Extension
- Click the blue Advanced link
- Change the Location from LAN to WAN, Save and Apply Changes
- Navigate to PBX Setup=>Phone Global (Needed for HTTP download of files from remote)
- Ensure that Phone Download Enabled and Phone Auth Enabled are set to Yes (Needed for HTTP download of files from remote)
- Navigate to the Phone Settings for the Extension (click the Pencil w Handset)
- Under Configuration Updates change from TFTP to HTTP (Needed for HTTP download of files from remote) NOTE:The port set must be forwarded to the PBX, typically 8080 or 80.
- Click Save and Configure (wait and the phone will download its new config, with the external IP address for the PBX)
Manual Configuration Settings in Phone for HTTP (required for phones registering to a Cloud PBX)
Sometimes it may be necessary to program a phone for remote operation when it is at the remote site. (You weren't able to do the previous steps while at the PBX location.) Use these steps as a guide:
- Open a browser and navigate to the Phone GUI
- Navigate to Phone Maintenance -> Advanced -> Auto Provision
- Change Protocol to HTTP
- Change Software Server URL: to
http://<pbx public ip>/ippbx/phonecfg/
- Set the Username to admin (default value)
- Set the Password to 1234 (default value)
- Uncheck Auto Download Kernel
- Uncheck Auto Download Personal Phonebook
- Click Submit
- Click Autoprovision Now
NOTE: In order for their to be a config file for the phone to download, the MAC address of the phone must be entered under the extension in the PBX. Also, you must remove the <> as they are not part of the software URL.
For this to work, you must navigate in the PBX to PBX Setup=>General; ensure that Autoprovisioning is Running (click ON if it is currently Stopped)
Upload Custom Ring Tones
You can send and store a music file on the IPitomy HD phone for playback during ringing. To do so the file MUST be formatted properly. IPitomy does not recommend doing this because it requires the phone to no longer pair to the PBX for its config file, and because its difficult to find a file that fits the parameters.
Wave file (*.wav), 711-aLaw, 8KHz, 64kbps, Mono, and less than 300kb size, file name should be small (mine is 8-characters)
- Once the file is created (I like Goldwave Audio Editing software.) Load it onto the telephone:
- Open browser
- Navigate to the phone IP (this operation cannot be done from the PBX)
- Navigate to Phone Maintenance / Auto Provisioning
- Uncheck the box at Auto Download Config File (this will keep the PBX from loading setting that don't include your loaded file)
- Click Submit
- Navigate to Audio
- Click the Browse button
- locate your wav file on your PC and select it (Windows/MAC, command)
- Click Upload
- If it doesn't succeed, fix the problem.
- Navigate to Audio (again)
- Under Audio / Ring / Ring Type select the file which should appear in the list
- Click Submit
- Call the phone - it should play your file as ring tone
A Note on Changing the Global Template
Due to the current implementation of the global template, if you wish to update your configuration file with new parameters provided in a PBX software update, you will need to reset your template and then make your configuration customizations again after the update. Note the template only currently changes on PBX software upgrades, not on phone firmware updates. Be sure to check if your customizations are now supported in a feature in the release notes, as this may effect how your customizations are applied.
It is our goal to support new parameters in the configuration files by supporting ensuring that their absence in the configuration file results in the feature using a default value which should ensure no change in behavior due to the presence of the feature.
Note that omitting a node from a configuration file will result in the default values for settings defined therein being used. If you change these values through the phone and they are not present in the global template, then they should not be changed by downloading a configuration file. However, you cannot delete a setting that is being set specifically by the server as it will simply replace it. (These settings should be obvious like, sip user, proxy, and other settings on the phone configuration page).
Under PBX Setup=>Phone Global you will find buttons that allow you to reset the Global Template for the HD phones to default, or to modify the template itself. The template is what is used to create configuration files for each phone that is provisioned to the PBX. The template itself is in XML format and contains all of the settings available in the phone. Making incorrect changes could cause issues with phones functioning correctly. If you are unsure or have any questions about making changes to the global template, you are encouraged to contact IPitomy Technical Support for assistance. If you feel you have made changes that are incorrect, you can always click the Reset to Default button.
HD Phone WATTS (current draw expressed in WATTS)
|Phone Model||Phone Only||With 1 IPX32||With 2 IPX32||With 3 or more IPX32|
HD Phone FAQ
I have an IP330 on a gigabit switch and I am periodically having issues with connectivity from a PC connected through the phone. Is there anything I can do to resolve the issue?
On some older Network cards we have had reports of trouble when they go to sleep. This is apparently a common problem with an older RealTek network cards.
Here are the things that we have seen work in the field:
- Replace the cable with a gigabit cable. There are greater requirements upon the quality of the cable when supporting gigabit.
- In the hardware properties of the network card in windows, disable sleep. (In Win7 this is under Power Management -> Allow computer to turn off this device to save power).
- Set the speed to a fixed value in the PC, try 1000 or 10/100
How can I download logs from the HD phone?
Sometimes IPitomy will require you to get the logs from your phone so we can investigate an issue more deeply. Steps to accomplish this are:
- Log into the IP address of the phone (username: root/password: root)
- Navigate to Phone Maintenance=>HTTP Upgrade
- Click the Download button next to All Config File:
NOTE:It may take a few minutes to download all of the files, be patient.
How do I configure my my HD Phones to use VLANs?
Setting up VLAN from the PBX
This guide requires a managed switch and knowledge of how to set up VLANs on it, which is outside of the scope of this guide. This is only to show how to set up VLAN on the pbx, and enable it for all phones. This requires your PBX to be on software version 5.1.5-5 or higher. All network switch ports that will have a phone on it should have its port tagged for the appropriate vlan.
WARNING: DO NOT SET VLAN IP ADDRESS ON THE SAME NETWORK AS STANDARD NETWORK INTERFACE! This will lock up the pbx and cause it to become PERMANENTLY inaccessible. Example, if your standard network is 192.168.1.x, your vlan network CANNOT be the same.
- Define the VLAN under System=>VLAN. It must be enabled.
- Set VLAN IP Address to the IP address that you would like to give the PBX on that vlan, which will also hand out DHCP on the vlan to the phones (This MUST be a different IP address from the main IP address set under system=>networking)
- Set the VLAN Subnet mask to define the network just as you would on standard network settings. 255.255.255.0 is generally going to suffice.
- Set the VID to the actual VLAN ID tag. This must match the VLAN in the switch that you are assigning the ports to.
- Set DHCP Start and End addresses as desired
NOTE: If your phones are on a vlan, autodiscovery will not find them with the default settings. To scan the vlan network instead of normal network, go to destinations->auto discovery like normal, choose scan or don't scan as desired, and go under View Settings -> Advanced Scan Settings, and change the Scan Network box to the network (CIDR notation) that you wish to scan for the phones.
- Navigate to PBX Setup=Phone Global
- Set Apply VLAN Config to Phones to Enabled
- Set Phone VLAN Enable to Enabled
- Set Phone VID to match VID from step 4 above
- If needed, set PC VLAN settings according to network.
- Apply changes
- Reboot phones. They should pick up vlan config and be on the vlan network correctly.
This process replaces the need to set vlan in the phone global template. Using the phone global template to assign vlan is no longer necessary as of 5.1.5-5
Warning: Do not follow this guide unless you know for certain you need LLDP. Incorrectly implementing this protocol MAY lead to undesired network functionality.
This guide applies to Cisco switches, and the screenshots are specifically from a SG300 28 port switch. Some options may be named differently, or not exist at all on other brands of network equipment.
In the switch:
LLDP Status: Enabled
TLV Advertise Interval: 60
LLDP MED Network Policy
Create 2 policies as follows
Application Voice, VLAN ID 2, VLAN Tagged
Application Voice Signaling, VLAN ID 2, VLAN Tagged
LLDP MED Port Settings
Add Voice and Voice signaling applications to desired ports
VLAN Management=>Voice VLAN=>Properties
Dynamic Voice VLAN: Disabled
Create VLAN: VlanID 2, name Voice
Port to VLAN
Set desired ports for voice traffic (any port that will have a phone plugged in, plus the port that will handle voice dhcp, if needed), to VLAN 2: Tagged
In the PBX
Ensure all phones have LLDP enabled. You can set this on each phone individually in the menu under Settings=>Advanced=>Network=>LLDP, but we would recommend following the instructions listed at http://wiki.ipitomy.com/wiki/HD_Phone_FAQ#How_do_I_Enabled_LLDP_Globally_for_the_Phones to set LLDP globally if you need it for all phones.
Virtual Local Area Networks (VLANs)
All Credit and Thanks go to networking guru Ed Harmoush at Practical Networking
Routing Between VLANs
All Credit and Thanks go to networking guru Ed Harmoush at Practical Networking
How do I Enabled LLDP Globally for the Phones
In the Global Template (PBX Setup=>Phone Global) you can search for LLDP and will see
LLDP="0", this designates that LLDP is disabled. In order to enable you will need to change the 0 to a 1. You will also need to add the following
When all is set the entry in the Global Template will look like this:
Click this link for general instructions on setting up LLDP in the switch.
How can I set my Phone to use a static IP address?
IPitomy supports configuring phones using DHCP and this is the best option for almost every network. If you would like to statically set IP addresses, we recommend that you use DHCP reservations to do this. In the vast majority of routers and DHCP servers there is an ability to assign a static IP address to a MAC address. While this process of assigning may be tedious, it is no less so than going to each individual phone and manually configuring the IP address (Static IP). In the end it eliminates any difficult modifications that you will need to make to configuration files and is just a way easier method to use for accomplishing the same task.
If having this information, the phone still must be manually set to static IP addresses then you will need to understand the following information. You have several options for performing this configuration:
Configure then Disable Configuration Updates
- Automatically Configure the phones using DHCP
- Go to phone's web page (root/root to log in) Navigate to Phone Maintenance->Auto Provision and uncheck the box that says Auto Download Config File.
- set the IP address to the desired static address
- The phone should keep it's original configuration and any changes made to phone configuration will now have to be done through the phone web interface. The exception to this is that you can change the phone keys in this configuration, just do NOT press Save and Configure. Press Save then Apply changes. The phone will update the keys at night when it downloads it's key configuration.
Change Configuration File Template
Please read the section of the Documentation [Note on Changing the Global Template] to understand the implications of using this method.
The second option is more difficult to initially configure but is easier because you can still change phone settings. You should only do this if you are familiar with XML as you can break the configuration files by making changes here that lead to invalid XML.
- Go to PBXSetup->Phone Global
- Under "HD Phone Configuration Template" click "Reset Template to Default"
- Now click Edit Template. Under Networks - delete the entire Node called "network"
- Now phones should keep whatever you manually set them to.
- Note with this method that when you upgrade the PBX software you should be aware that we may make changes to the default template and you may have to reset the template and remake the changes in order to support additional functionality that is added in future releases.
The final option here is to just manually configure the phone. This works but if you call tech support with an issue they will probably have you default and reconfigure the phone through the PBX as we change a number of options when we provision the phones to the PBX.
Can I use HD Phones with my IP1000?
YES. HD phones will function normally as most other SIP phones with your IP1000.
In order to configure the phone you must use Manual Phone Configuration.
My BLF won’t light on my phone?
If you have a phone where a BLF will not come on when it is supposed to, there are several things you can do. The most important thing is to understand is how a BLF is turned on or off. When a phone goes off hook and connects with a call, it sends out a short status packet to the PBX. The packet simply says that the status has changed from available to busy. The PBX then updates all of the phones that have a subscription to the BLF with a status packet indicating that the status has changed to busy.
The packet ether got there or it didn’t. If it didn’t, the status will not update. The status should update automatically every 30 minutes or so. If the packet was missed, everything should be back to normal the next time the phone re-subscribes (about every 30 minutes automatically).
What can go wrong?
The packet might have been lost. What do I do? Why would the packet get lost in the first place? Is it magic? Is it being controlled by “The Force”? Probably not. The packet may have not arrived due to many factors. Most likely the flow of normal packets was disrupted. In the world of SIP, signaling packets have a very short life. They become stale if they are not delivered on time. The SIP packets are delivered using UDP. This protocol does not ask for a positive acknowledgement when a packet is received. It is assumed that it has been received. There are several things that can cause a packet to be delayed on a LAN. All these things have the same symptom.
Here is a short troubleshooting guide:
- Perhaps you have recently restarted all services or rebooted your PBX. You phones lose their BLF subscriptions when this occurs. The phones will resubscribe automatically in time. If you wish to have the BLFs work immediately then you will need to reboot the effected phones.
- The packet might not be the culprit; maybe your lamp is broken. Test this by going to the button on the phone and select diagnostics. Select the option lights. Did the light come on? If it did, it’s not the light.
- To narrow this down a little further, it is best to remove all doubt. Restore the phone to factory defaults and reprogram it. Test it and see if the problem happens again. If it does, go to the next step.
- Troubleshoot the network. See this guide for assistance Network Troubleshooting
There is no such thing as black magic. The BLF did not turn on for a good reason. If you want to go with the percentages, it breaks down like this:
Less than 1% light is out. Check it anyway in diagnostics. It does not take any time.
Less than 1%The phone is broken. This is very unlikely for a BLF
85%Cabling – Loose connector – bad patch cord
13%QOS not set up or set up wrong
Moral of the story:
Carry a known good patch cable and some tools to re-connect the wall jacks. Rule this out first and you will save a lot of time over the long run.
I am using a Plantronics headset and experience buzzing at my phone.
Dealers have found that installing a PLANTRONICS 70584-01 RFI Filter resolved this issue.
3 Way Conference alternate functionality
Sometimes an end user will want the ability to create a 3-way conference call at a phone, hang up, but have the other parties remain connected. This can be accomplished by modifying the Global Template for the phones, thereby modifying the behavior in each phone:
- Navigate in the PBX to PBX Setup=>Phone Global
- Click the button to Edit Current Template
- Change the 0 to a 1
- Save the Template
- Apply Changes
- The next time the phone downloads it config (either on reboot or at 1am), the phone will have the new functionality.
Alternatively, you could log into a phone on a case by case basis, navigate to Advanced=>Phone Settings, and change the setting for Conference Exit Result: from Disconnect All to Others Remain Connected. You will need to disable AutoDL config if you make this change manually, otherwise at 1am it will get its config from the PBX and undo your manual changes.
Locked up Phone Recovery - Defaulting without a Network Connection
We've found that in some instances a phone may download an improperly formatted config file. This could result in sporadic symptoms of the phone becoming locked or unresponsive, being unable to press any keys, etc. In this state the phone will often display the time but not respond to key presses. If this occurs, try the following to resolve:
- Disconnect the phone entirely from the network
- Power via brick
- Default the phone
- Press Menu
- Choose Settings
- Choose Advanced Settings
- Press OK (no password)
- Select Load Default Settings
- Choose OK
- Reboot phone
- If the phone was supposed to be upgrading to a newer firmware version when the phone entered the locked up state then perform the following operations on the newly defaulted phone.
- Reconnect Phone to Network
- Autodiscover + Configure and Restart Phone
- Wait 5 minutes after phone appears to be registered it is important that you do not make any calls during this time as the phone is repairing the corrupted files. Note that phone may not display upgrading firmware for 1-2 minutes.
- After phone upgrades it's firmware it should reboot automatically and be usable immediately.
The extension name is displaying incorrectly on phones since the name of that extension was changed, the Enterprise Phonebook does not seem to be updating
- Navigate to PBX Setup=>Phone Global and enable Enterprise Phonebook (Download and Generate).
- Go to PBX Setup=>Services and click the blue link TFTP Files.
- Find and delete enterprise_phonebook.xml, then Apply Changes.
- When Apply Changes completes, reboot the phones that are displaying the wrong names. This should resolve your issue.
How do I make the second call ringing to my phone get my Busy VM greeting instead of my NoAnswer greeting?
- One method to do this would be to have the user press the Reject key on their phone when the second call comes in.
- Alternatively, you can log into the IP address of the phone, navigate to Phone Settings=>Basic and set Call Waiting to Off. In this configuration the phone will auto DND a second incoming call while you are on the phone. This causes the busy greeting to play any time a second call is sent to the phone. NOTE: you will need to turn off automatic configuration updates in any phones that you want to have this setting on or change it globally in the phone configuration template.
Side tone is an old TDM feature where you hear yourself back when you speak. We do not advise to enable this, as side tone can cause issues with SIP If your end user insists on having side tone, here is how you add it to the default template instead of having to manually enable it in each phone. Rev 1 phones will not support this at all, so they will need Rev 2 or later phones.
- Edit the Default Phone Template found under PBX Setup=>Phone Global
- Find the section pertaining to SIP DSPs (this should be near the top)
- Add in
SideTone="1"to this section. A setting of 1 means enabled, a setting of 0 means disabled.
- Save, Apply Changes, and then reboot the phones so they can download their updated config.
I accidentally entered http:// in the SIP Server field and now my phone is locked up
If you are manually configuring a phone and have accidentally entered http:// in the SIP server field, followed by an IP address, the phone will lock up. The display will show Xs and you will be unable to access the phone's WebGUI. If this has happened, we have an easily method to recover the phone.
- Disconnect the LAN cable and power up with a power brick. If already on a brick, reboot after removing the cable.
- Once booted, default the phone via the phone menu.
How do I access the Multiple Key Pages on the new IP620
(Does not work on IP620PE)
To program the extra pages, you need to add an Expansion Module through the PBX programming. 32 keys = 4 pages of 8. Once programmed, you will use the left and right directional key on the phone to navigate to the extra pages. An indicator at the bottom of the screen will show you what pages is displaying.
- NOTE:: There is currently a known issue where after the phone has downloaded its config it needs a reboot in order to display the new pages of keys.
How do I use the EHS/Bluetooth Dongle function on the new IP620B and IP320 rev2.3.0
EHS functionality will require an EHS module that plugs into the back of the phone. Once installed, you can use a standard wireless or wireless Bluetooth headset. The following guide will go over installation.
Once installed and paired, calls will ring to the headset. To answer, press the button on the headset once. To hang up, press the button on the headset once.
NOTE: The phones need to be on version 220.127.116.11 or greater for the EHS to work.
If the EHS button does not answer/hang up the phone, you may need to toggle bluetooth on and back off again to engage it. Do so on the phone itself, on menu>phone settings>basic>bluetooth
A note about Bluetooth headsets with a UC Base unit:
Here are some models of headset reported to work by dealers or used here in our office:
- Delton X10
- BackBeat 903
- Plantronics Voyager Pro 510
- Plantronics PLT- D655
- Motorola 537X
- Plantronics M100
- Plantronics Discovery 600
- Inland ProHT Bluetooth Headset
- Jabra 920 (be sure to disable Missed Calls Display on the pbx under Destinations=>Extensions=>Edit PHONE settings=>Display Settings/Call Control or it will play a tone that sounds like ringing when you miss a call) Note: Also enable auto-sleep mode in the headset.
If you encounter any trouble with a headset not triggering the EHS when the "One Touch" button is pressed: use the phone menu and go to System Settings -> Phone Settings and turn bluetooth on, and then turn it off again.
How do I load a new background image on the IP620BG?
You will need to log into the phone via its IP address. Once there, navigate to Phone Settings=>Wallpaper. The standard idle background in the phone is the Standby image, and must be a file that is 272x384.
If you have loaded a bad image file and want to return to the background shipped with the phone, here is the file:
IP290 Wall Mount Solution
If you would like to wall mount your IP290 phone, the following guide will give a functional option. The switch plate needed is available at most big box stores.
- The key to isolating new issues is to change one thing at a time and see what fixes the issue. The possible causes are 1) Hardware defect 2) Configuration defect 3) Network Issue 4) Software defect
- What is the background / history of the issue? For example: This phone is Bob the IT guy's home phone. It has worked for 6 months without an issue, and now we are seeing an issue. Or we have done an install and everything is working except one phone?
- Isolate the Issue. The easiest way to do this is to swap the phone with one that is working fine and has not demonstrated the issue. If the problem follows the phone, it is most likely a configuration or hardware issue. If the problem happens on the other phone in this same location, the problem is probably on the segment of the LAN. After this has been tested, try swapping the ports on the data switch. It could be a bad port on the switch. Another option is to swap cabling, or switch from POE to a power brick for testing.
- Ensure the phone is on current firmware. If you have two phones on the same firmware, and only one experiences the issue, we can fairly confidently rule out a software defect.
- Try defaulting and reprogramming the phone, this should eliminate any configuration issues.
- Once all this is done, we would have found the cause of the problem or eliminated the majority of possible issues. At this time we would investigate the network. Troubleshooting Network
IPitomy phones do not come equipped with a magnetic coupling coil. That may not work with many hearing aids anyway. Ploycom phones are compatible with IPitomy PBX Systems and do have the coil. There are many other analog phones designed for different types of hearing aids and hearing loss. Clarity is a well-established brand that may offer a solution based on the users specific needs. http://shop.clarityproducts.com/ Analog phones require a SIP gateway to connect to IPitomy. Clarity also has a handset amplifier that may solve the problem if extra volume is needed.
IP620 fails to obtain an IP address using Power over Ethernet (PoE)
There is a known issue where an IP620 may fail to obtain an IP address when plugged into PoE. This specific issue can be identified if that same phone successfully obtains an IP address when used in conjunction with an AC power supply (12v 1A). It is caused by a failed capacitor on the main system board of the phone. Aside from our standard return and repair processes, we are now publishing a quick guide on replacing this capacitor for those who are familiar with soldering and circuit boards.