Legacy Desktop Models
Legacy Grandstream phones do not properly support dialog events, which causes certain features, such as Call Park and Directed Call Pickup to not work properly. This might get fixed in a future firmware release of the phone.
Legacy Desktop Phones
Grandstream BudgeTone BT-200/201
http://www.grandstream.com/products/consumerphones.html
Grandstream GXP280 / GXP285
http://www.grandstream.com/products/gxp_series/gxp280/gxp280.html
http://www.grandstream.com/products/gxp_series/gxp285/gxp285.html
Grandstream GXP1200
http://www.grandstream.com/products/gxp_series/gxp1200/gxp1200.html
Grandstream GXP2010
http://www.grandstream.com/products/gxp_series/gxp2010/gxp2010.html
Grandstream GXP2020 / GXP2020EXT
http://www.grandstream.com/products/gxp_series/gxp2020/gxp2020.html
http://www.grandstream.com/products/gxp_series/gxp2020/GXP2020EXT.html
Grandstream GXP2000 / GXP2000EXT
http://www.grandstream.com/products/gxp_series/gxp2000/gxp2000.html
http://www.grandstream.com/products/gxp_series/gxp2000/gxp2000ext.html
Grandstream GXV3000, GXV3005, GXV3006 Video
http://www.grandstream.com/products/gxv_series_phone/gxv3000/gxv3000.html
http://www.grandstream.com/products/gxv_series_phone/gxv3005/gxv3005.html
http://www.grandstream.com/products/gxv_series_phone/gxv3006/gxv3006.html
Grandstream GXV3140
http://www.grandstream.com/products/gxv_series_phone/gxv3140/gxv3140.html
Analog Phone Gateways
Grandstream GXW4004
Supported in the sipXecs 4.2 release.
Grandstream GXW4008
Supported in the sipXecs 4.2 release.
Known Issues / Configuration Notes
sipXecs 4.0.x - Firmware ??
sipXecs 3.10.x - Firmware ??
Mfg | Model | Recommended | Tested | Known Issues |
---|---|---|---|---|
Grandstream | GXV3140 |
|
|
|
Grandstream | GXV3006 |
|
|
|
Grandstream | GXV3005 |
|
|
|
Grandstream | GXV3000 |
|
|
|
Grandstream | GXP2020 |
|
|
|
Grandstream | GXP2020EXT |
|
|
|
Grandstream | GXP2000 |
|
|
|
Grandstream | GXP2000EXT |
|
|
|
Grandstream | GXP1200 |
|
|
|
Grandstream | GXP285 |
|
|
|
Grandstream | GXP280 |
|
|
|
Grandstream | BT200/201 |
|
|
|
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.
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.