Grandstream Phones

Detailed Information 

Grandstream IP Phones

sipXecs supports the full lineup of Grandstream IP Phones. Grandstream's standards-based desktop IP phones provide many features, excellent sound quality, and offer hands-free full-duplex speakerphone

Certification Status

Grandstream phones are currently in verified status, with full certified status expected to be complete anywhere from March 2013 - May 2013

Currently known issues include:

  • RFC 4235 (aka dialog events) are not currently supported, though this is being actively worked on by Grandstream engineers
  • Improved Grandstream plugin for sipXecs is currently in testing phases.

Currently Verified Models

 

Legacy Desktop Models

Legacy Grandstream phones do not properly support dialog events, which causes certain features, such as BLA/SLA, Call Park, presence monitoring, and Directed Call Pickup to not work properly.

Legacy Grandstream phones do not support Music on Hold

Legacy Desktop Phones

 

The following legacy desktop models are considered unsupported due to the aforementioned firmware deficiencies:

  • Grandstream BudgeTone series
  • Grandstream GXP280/GXP285
  • Grandstream GXP1200
  • Grandstream GXP2000
  • Grandstream GXP2010
  • Grandstream GXP2020
  • Grandstream GXV3000/3005/3006 

 

Known Issues / Configuration Notes

http://www.grandstream.com/support/firmware

Mfg

Model

Recommended
Firmwmare/Bootrom

Tested
sipXecs Verion

Known Issues

Grandstream

GXP1100/1105

1.0.5.15

4.6.0 Update 3

RFC4235 (dialog) support not yet implemented

Grandstream

GXP1160/1165

1.0.5.15

4.6.0 Update 3

RFC4235 (dialog) support not yet implemented

Grandstream

GXP1400/1405

1.0.5.15

4.6.0 Update 3

RFC4235 (dialog) support not yet implemented

Grandstream

GXP1450

1.0.5.15

4.6.0 Update 3

RFC4235 (dialog) support not yet implemented

Grandstream

GXP2100

1.0.5.15

4.6.0 Update 3

RFC4235 (dialog) support not yet implemented

Grandstream

GXP2110

1.0.5.15

4.6.0 Update 3

RFC4235 (dialog) support not yet implemented

Grandstream

GXP2120

1.0.5.15

4.6.0 Update 3

RFC4235 (dialog) support not yet implemented

Grandstream

GXP2124

1.0.5.15

4.6.0 Update 3

RFC4235 (dialog) support not yet implemented

Grandstream

GXP2200

1.0.1.40

4.6.0 Update 3

MoH, RFC4235 (dialog) support not yet implemented

Grandstream

GXV3140

1.0.7.76

4.6.0 Update 3

MoH, RFC4235 (dialog) support not yet implemented

Grandstream

GXV3175

1.0.3.74

4.6.0 Update 3

MoH, RFC4235 (dialog) support not yet implemented

Grandstream

GXV3175v2

1.0.1.38

4.6.0 Update 3

MoH, RFC4235 (dialog) support not yet implemented

Grandstream    

Notes:

Automated Configuration using the sipXecs ConfigServer

Starting with release 3.0 of sipXecs automated plug & play configuration of Grandstream phones is supported by ConfigServer (thanks to Hannu Strang for his valuable contribution).

From the sipXecs ConfigServer administration portal:

  • First add a New User

  • Add a New Phone and select the Grandstream phone model from the drop-down menu.
  • Enter the proper serial number of the phone

  • Assign a line to the phone by selecting the appropriate user
  • Generate profiles (configuration files for the phone). Default parameters should result in a working setup. From within ConfigServer you can change parameters later and re-generate the profile.

  • Reset the phone to factory defaults manually
  • *Manually reconfigure the correct address for the TFTP server.* The phone does not pick it up through DHCP.  Press the "Menu" button, down arrow until you see "[xecsuser:6] tFtP", then enter (menu button on Budgetone) then type in the IP address of the sipXconfig machine.  If your IP address is 10.1.1.22, for example, then enter "010001001022". Alternatively, you can configure the TFTP server address using the Grandstream Web interface.
  • Manually reboot the phone. The phone should now pick up the profile generated by ConfigServer and register with sipXecs
    *Note:* Automated restart of the phone from ConfigServer might not work yet even once the phone registered successfully.

*Grandstream Budgetone Configuration Management:*
ConfigServer provides comprehensive management of all the parameters of the Grandstream Budgetone phone. When using ConfigServer the built in Web server should not be used for configuration changes in order to maintain consistency as parameters generated by configServer will overwrite manual settings.

Additional Features

Call Hold and Transfer

  • *Hold:* To place a call on hold press "hold". To take the call off hold press "hold" again.
  • *Blind Transfer:* To transfer a call press "transfer", dial the new number and hang up.
  • *Consultative Transfer:* In order to consult the other party before transferring the call press "flash", dial the new number and wait until the new party picks up. Press "transfer" to transfer the call.

Conference

Firmware 1.0.6.7 for the Budgetone phone does not support conference. Firmware release 1.0.7.11 is currently in Beta. It supports conferencing done by the phone.

Call an extension, press conference, call the 2nd extension, press conference again.

Message Waiting Indication (MWI)

Using the standard profile this feature should be enabled by default. The Grandstream Budgetone uses the backlit display as the message waiting indicator. If a message is waiting the whole display flashes blue. To pick up a message press the Message key on the dial pad or dial the voicemail extension (default: 101).

Message Waiting Indication can be configured on the Grandstream Budgetone management screen in ConfigServer under Misc Settings.

Synchroniation with a Time Server

This feature is enabled by default using the standard profile. The default NTP server used is pool.ntp.org. Make sure you configure the correct time zone under Time Settings.

Voice Codec Settings

The default profile defines the following priority list for codec selection:

PCMU, G.726, G.723, PCMA, G.728, G.729, G.726, G.722

This is a good selection if you want to communicate with the media server, which typically requires PCMU, and if you have bandwidth constraints for normal calls. If you often communicate with other Grandstream Budgetone phones we recommend to using the wide-band codec G.722, which means you have to move it up in the list of priority settings.

Password Settings

The default profile leaves a standard admin and user password. You might want to change this in order to secure access to the phone.

Manual Configuration and Troubleshooting

Connect to the phone's built-in Web server

The default behavior is to obtain an IP address using DHCP at power up. Discovering the phone's IP address is done as follows:

  • Connect the BT-101/102 phone to the network and power it up.
  • When the phone is powered up, press the menu button, then press the down arrow to scroll to the IP Address selection; press Menu again to display the IP Address of the phone.

Login to the phone's Web User Interface

Point your browser to

 http://<ip of your phone>

. Default admin password is admin.

Manually Configure the Grandstream phone to register with sipXecs

The BudgeTone BT-101/102 firmware version used in this configuration is 1.0.6.7 / Bootloader 1.0.1 / HTML-1.0.0.49 / VOC-1.0.1.0.

 *Basic configuration information:*
SIP Server:            <your.domain.com> (if not using DNS SRV specify the FQHN of your sipXecs server)
Outbound Proxy:        <your.domain.com> (if not using DNS SRV specify the FQHN of your sipXecs server)
SIP User ID:           <User ID or extension number as specified in Config Server>
Authenticate ID:       <User ID or extension number as specified in Config Server>
Authenticate Password: <password as specified in Config Server>

*Release 3.0* and higher of sipXecs automatically generates a SIP password when a new user is created. This password is *different from the PIN* entered on the "New User" page. In order to see or change the assigned password, click on the "Show Advanced Settings" link.

 *Additionally, configure the following parameters:*
Codecs:                PCMU, PCMA
Use DNS SRV:           Yes (if using DNS SRV)
SIP Registration:      Yes
NAT Traversal:         No
TFTP Server:           <IP Addr of sipXecs server>
Voicemail User ID:     101
SUBSCRIBE with MWI:    Yes
Send DTMF:             via RTP (RFC 2833)
NTP Server:            pool.ntp.org (Refer to [NTP Pool Time Servers|http://ntp.isc.org/bin/view/Servers/NTPPoolServers])

Open port 123 on your firewall for NTP.

Manually Configure the Grandstream phone to register with Free World Dialup (FWD)

As a little digression, below the configuration to register with FWD.

SIP Server:            fwd.pulver.com
Outbound Proxy:        fwdnat.pulver.com:5082
SIP User ID:           Your FWD number
Authenticate ID:       Your FWD number
Authenticate Password: Your FWD password

 *Additional Settings:*

Codec:                 G.722, PCMU, PCMA, iLBC, G.723, G.729
G,723 rate:            6.3 kbps
iLBC frame size:       20ms
iLBC payload type:     98
Voice Frames per Tx:   2
Layer 3 QoS:           48
SIP registration:      Yes
Register Expiration:   60
Early Dial:            No
NAT Traversal:         No  (we defined an outbound proxy above)
TFTP server:           <ip address of your TFTP server>
Subscribe for MWI:     No
Auto Answer:           No
DTMF payload:          101
NTP server:            pool.ntp.org (Refer to [NTP Pool Time Servers|http://ntp.isc.org/bin/view/Servers/NTPPoolServers])

Open port 123 on your firewall for NTP.

Selecting the Voice Codec

Grandstream BudgeTone VoIP phones and HandyTone analog telephone adaptors support G.711-uLaw, G.711-aLaw, G.722, G.723, G.726, G.728, G.729 and iLBC. The *wideband codec G.722* is only supported by BudgeTone VoIP phones. It has the same bit rate as G.711 but with twice the sampling rate (16KHz vs. 8KHz) and therefore better sound quality (better than toll quality).

By default, PCMU(G.711u) will be used. Both PCMU and PCMA will give you toll quality voice, but their bandwidth consumption is also the highest (64kbps). With G.722 you get wideband audio at the same bitrate. If your network bandwidth is low, you can choose lower bitrate codecs such as G.723 or G.729, which will give you near toll quality at much smaller bandwidth consumption (G.723 consumes 5.3/6.3kbps and G.729 consumes 8kbps).

A good choice is: G.722, PCMU, PCMA, iLBC, G.723, G.729. This will chose the wideband codec G.722 if available by the called party's phone.

*Voice Frames Per TX:* To reduce the overall Ethernet/IP/RTP overhead introduced by the 54 byte header, multiple voice frames can be packed into a single Ethernet frame. In doing so a trade-off has to be made between overall bitrate and delay. Optimizing for network bandwidth constraints, increasing the TX count may improve the overall voice quality.

If RTP packets are sent every 2.5ms (G.728, TX = 1), the total bitrate is 0.432*400 = 172.8kbps. This won't work well over the public Internet. However, if RTP packets are sent every 10ms, the total bitrate is down to 0.432*100 = 43.2kbps. If RTP packets are sent every 20ms, the total bitrate may be further down to 0.432*50=21.6kbps.

Grandstream suggests 30ms packet rate for G.723, 10ms for G.728 and 20ms for the rest of the codecs. Voice_Frames_Per_TX is then set to 1 for G.723, 4 for G.728 and 2 for the rest.

Managing Ring Tones

The Budgetone phones support up to three ring tones. Grandstream made available a tool used for converting music files (mp3, .wav, etc)
to a Grandstream music ring tone format.  The tool converts music files into PCMU (G.711A) format of up to 64KB each. The .zip file contains an executable file for Solaris and one for Linux.

Usage: sox input output.ring

The extension of the output file has to be .ring. Then rename the file output.ring to ring1.bin and the file is ready for download. Place the file in the TFTP server folder containing the firmware. The Budgetone phones will load the ring tones during the next reboot.

Firmware Upgrade

It is recommended that you upgrade to the latest firmware version.

To upgrade software, the BudgeTone-101/102 phone can be configured with a TFTP server on which the new code image is located. It is recommended that the TFTP server has either a public IP address or is on the same LAN segment with the phone.

The TFTP server can be configured via the phone's Web configuration interface. On the configuration screen Advanced Settings enter the TFTP server IP address in the designated field towards the bottom of the configuration screen. Apply changes by selecting update. Once the TFTP server is configured and the image is located in the TFTP server's root directory, reboot the phone.

The phone only contacts the TFTP server during its initial power up or reboot. If the configured TFTP server is found and a new code image is available, the phone will attempt to retrieve it. After verification of the checksum, the new code image will be stored into flash memory.

If TFTP fails for any reason (e.g., TFTP server is not responding, there are no code image files available for upgrade, or
the checksum test fails, etc), the phone will stop the TFTP process and simply boot using the existing code image.

Check successful upgrade by going to the phone's Web interface Status screen.

Using the Grandstream TFTP server

It is recommended to conduct TFTP based firmware upgrade in a controlled LAN environment if possible. For users who do not have a local TFTP server, Grandstream provides a NAT-friendly TFTP server on the public Internet. Make sure your firewall allows TFTP traffic on port 69.

Grandstream TFTP server IP addr: 168.75.215.189

Using the sipXecs TFTP server

It is recommended to use the TFTP server built into your sipXecs server already to distribute firmware updates to your Grandstream phones in a controlled and reliable way.The sipXecs TFTP server is used to manage Polycom and other phones and can be used for this purpose.

sipXecs TFTP server IP addr: <your sipXecs server>

TFTP root directory: /var/sipxdata/configserver/phone/profile/tftproot on your sipXecs server

Copy the Grandstream BudgeTone firmware image into the TFTP server's root directory. For example to get Release 1.0.6.7 issue the following commands on your sipXecs host:

cd /var/sipxdata/configserver/phone/profile/tftproot
wget [http://www.grandstream.com/DOWNLOAD/FIRMWARE/BT100_HT286_HT486/Release_1.0.6.7.zip] .   (don't forget the dot)
unzip Release_1.0.6.7.zip

BETA release 1.0.7.11:

cd /var/sipxdata/configserver/phone/profile/tftproot
wget [http://www.grandstream.com/BETATEST/BT100_HT286_HT486/Release-1.0.7.11.zip] .   (don't forget the dot)
unzip Release_1.0.7.11.zip

Reboot the phone. The phone does not display any messages on the display during upgrading. Use the Web interface to check what firmware release is running.

Using the sipXecs HTTP Configuration Server and Auto-Provisioning

Although it may be preferable to use the TFTP for phone configurations, some network environments do not work well with the TFTP protocol.   Specifically, when crossing network address translators (NATs) or traversing the Internet, TFTP performance can be problematic.

To address these requirements, Grandstream and SipXecs also support phone provisioning via HTTP protocol.  To use this capability (with SipXecs 4.6+) simply access the web based Grandstream Multimedia Phone Administration Interface (GXV3140 and GXV3175);  go to the Maintenance tab; and the Upgrade section and  set the following:

HTTP/HTTPS User Name :  PlcmSpIp

HTTP/HTTPS Password : PlcmSpIp

Upgrade Via : HTTP

Firmware Server Path : <SIPXSERVER>/phoneprov

Config Server Path :  <SIPXSERVER>/phoneprov

 Then save the configuration and reboot the phone.  The phone will reboot and download any firmware upgrade you have stored at the server as well as any configuration created for it at the configuration server.  If the phone was not previously provisioned in SipXecs, it will be automatically provisioned with a temporary ID.  You can then go back into the configuration and assign lines to the phone device and send the updated profiles to the phone.  The phone will restart after the new configuration has been downloaded and should render the new configuration accordingly.

Resetting to Factory Defaults

The phone can be reset to factory defaults as follows. This will erase all configuraton information.

* Find the MAC address of your phone (printed on the label on the back of the phone)
* Encode the MAC address (enter hex numbers using the keypad

A -> "22"
B -> "222"
C -> "2222"
D -> "33"
E -> "333"
F -> "3333"

e.g.   MAC: 00b8200e395  ->  0002228200333395

* Press menu on the phone and scroll down using the arrow keys to RESET-
-
* Type the encoded MAC address and hit menu to complete

The phone should now reboot.

Configuration via a Configuration Server

The Budgetone phones can be automatically configured at startup using a TFTP server.

* Configuration tool and configuration template file

The configuration file has the format cfg<mac> and its has to be in *binary* format. Grandstream provides a utility tool (Windows and Linux versions) that allows the encoding of a text based file into binary format.

Using GSUtil to Backup / Restore Budgetone Configuration

Charles Howes created a simple Linux tool called GSUtil that allows backup and restore of Grandstream Budgetone phones. It should work for the BT-101/102 Budgetone phones, as well as the HandyTone models HT-286 and HT-486, which use the same firmware as the phones.