Grandstream GXP2170

[[File:Grandstream_GXP2170.png|300px|thumb|left|Grandstream GXP2170]]
<div style="width:100%;overflow:hidden;clear:both"></div>

The GXP2170 is a powerful High-End IP phone that is ideal for busy users who handle high call volumes. Receptionists, administrators, sales staff and other call-intensive rolls can enjoy efficiency by utilizing the GXP2170’s 12 line keys, 4.3 inch color display LCD and 48 digital, on-screen speed dial/BLF keys.


__TOC__


==Setting up a Grandstream GXP2170 with VOIP.ms==

These are the settings that I used to get the Grandstream GXP2170 working on voip.ms.  I used a combination of guides here on the wiki and other resources.  I am not sure that all these settins are needed, but this combination of settings got the phone working for me.

Note:
* If you want to use the BLF feature, you will need to contact voip.ms support and request that they activate it for the server that you are using.
* If you are going to be using an incoming DID number, you must ensure it's setup in the DID's settings to forward to the server you are going to be connecting to.
* These instructions setup encrypted SIP traffic.  You will want to ensure that this is activated in your sub-account advanced settings.
* I am starting out with a phone running firmware 1.0.9.135 and starting from a clean factory default.


===What you need to get started===
To get started, you will need the following:
* A Grandstream GXP2170 IP Phone
* Valid login credentials for a voip.ms account or sub account
* The server you want to use (I'll be using denver1.voip.ms here)

You will also need to know the IP address if your phone.  The phone by default will pull an IP address via DHCP.  To check the IP address of your phone you:
# Press the center hat button
# Select "Status" (or press 2)
# Select "Network Status"
# Find the IP address the phone us using (I'll be using 10.1.10.137 in my example here)


=== Connecting to the phone===
Connect to the phone via browser of your choice.  If this is the first time you have logged into the phone, you will be prompted to update the password.  The default username/password are both admin.

[[File:GXP2170_Login.png|thumb|none|600px]]

[[File:GXP2170_PasswordUpdate.png|thumb|none|600px]]

==Updating Phone Settings==

The following are the settings that need to be updated.


===General Settings===

Go to Accounts -> Account 1 -> General Settings


These are the settings changed from their default values:
*'''Account Name''' - Name that will be displayed for the account on the phone's screen
*'''SIP Server''' - Network address of the voip.ms SIP server you will connect to
*'''BLF Server''' - Network address of the BLF server you will connect to (This is optional, but if used should be the same as your SIP Server)
*'''SIP User ID''' - Username from your voip.ms Sub Accounts page
*'''Authenticate ID''' - Username from your voip.ms Sub Accounts page (same as SIP User ID)
*'''Authenticate Password''' - Password from your voip.ms Sub Accounts page
*'''Name''' - Caller ID Display Name '''(See the requirements below)''' (Enter it here, but it will likely be overwritten by settings in your account)

 '''IMPORTANT for Name''':
   - We suggest entering your outbound Caller ID Name must be in '''capital letters'''. This will appears more clearly/visible on some devices.
   - You must '''NOT''' use any special characters, they will not be displayed. 
   - '''Enter a max of 15 characters.''' Some of regular Canadian providers will not show more than '''15 characters max'''. We suggest shrinking or adapt your caller ID. 
   - Spaces are allowed in a caller id name.


[[File:GXP2170_GeneralSettingsGetTo.png|thumb|none|600px]]
[[File:GXP2170_GeneralSettings.png|thumb|none|600px]]

===SIP Basic Settings===

Go to Accounts -> Account 1 -> SIP Settings -> Basic Settings

[[File:GXP2170_SipBasicSettingsGetTo.png|thumb|none|600px]]
[[File:GXP2170_SipBasicSettings.png|thumb|none|600px]]

These are the settings changed from their default values:
*'''Register Expiration''' - Set to "5" *minutes)
*'''Enable OPTIONS Keep Alive''' - Select "Yes"
*'''SIP Transport''' - Select "TLS/TCP" (This is important for Secure SIP to work)
*'''SIP Listening Mode''' - Select "Dual(Secured)" (This is important for Secure SIP to work)
*'''Use Actual Ephemeral Port in Contact with TCP/TLS''' - Select "Yes" (This is important for Secure SIP to work)
*'''SUBSCRIBE for MWI''' - Select "Yes"
*'''SUBSCRIBE for Registration''' - Select "Yes"


===SIP Custom Headers===

Go to Accounts -> Account 1 -> SIP Settings -> Custom SIP Headers

[[File:GXP2170_SipCustomHeadersGetTo.png|thumb|none|600px]]
[[File:GXP2170_SipCustomHeaders.png|thumb|none|600px]]

These are the settings changed from their default values:
*'''Use Privacy Header''' - Select "Yes"
*'''Use P-Preferred-Identity Header''' - Select "Yes"
*'''Use X-Grandstream-PBX Header''' - Select "No"
*'''Use P-Access-Network-Info Header''' - Select "No"
*'''Use P-Emergency-Info Header''' - Select "No"


===SIP Audio Settings===

Go to Accounts -> Account 1 -> Audio Settings

[[File:GXP2170_SipAudioSettingsGetTo.png|thumb|none|600px]]

These are the settings changed from their default values:
*'''Preferred Vocoder - choice 1''' - Select "PCMU"
*'''Preferred Vocoder - choices 2 to 8''' - are mostly irrelevant however you can choose g.729a, GSM or G.722. Make sure you only select those enabled on your account or subaccount settings to avoid issues like packet fragmentation.


==Additional Note==

*'''SRTP mode''' - should be disabled if encryption isn't enabled on your account advanced settings and you're not using TLS.


[[File:GXP2170_SipAudioSettings.png|thumb|none|600px]]


*''' Validate Certificate Chain ''' - If you are having issues registering your device, attempt heading into Account 1-> SIP Settings -> Security Settings and setting the option '''Validate Certificate Chain''' to '''No'''.

[[File:GSsolution1.png|thumb|none|600px]]