Grandstream HandyTone FXS Configuration with sipXecs

Grandstream's lineup of terminal adaptors (FXS gateways). Note that the HT-488 includes an FXO PSTN gateway that is able to terminate VoIP calls.

The Grandstream HandyTone terminal adaptors (FXS gateways) are solid products. They work well in a SIP environment and support many important features. Especially the number of codecs supported is impressive.

The Grandstream downloads page offers links to the respective user manuals for the different models.

Note: By default the HandyTone terminal adaptors are configured to receive firmware upgrades from Grandstream's HTTP server at This means that when you first plug in your new HandyTone TA and there is connectivity to the Internet, it will upgrade its firmware if a newer version is available. Do not disconnect power until completed.
When you first plug in the HT 286, it will blink red intermittently every four seconds. This indicates a failure to register to your SIP server.

Automated Configuration using the sipX ConfigServer

Starting with release 3.0 of sipX automated plug & play configuration of Grandstream HandyTone terminal adaptors is supported by ConfigServer. Model HT-286 is fully supported with all of its parameters. Model HT-486 is supported except for the additional parameters that configure the internal router and PSTN pass-through functionality.

From the sipX ConfigServer administration portal:

  1. First add a New User for every FXS line supported by the HandyTone terminal adaptor
  2. Add a New Phone and select the Grandstream HandyTone terminal adaptor from the drop-down menu.
  3. Enter the proper MAC address.
  4. Assign a line to the terminal adaptor by selecting the appropriate user. If the terminal adaptor supports two lines, assign two different users.
  5. Generate profiles (configuration files for the terminal adaptor). Default parameters should result in a working setup. From within ConfigServer you can change parameters later and re-generate the profile.
  6. Manually reconfigure the correct address for the TFTP server. The terminal adaptor does not pick it up through DHCP. You can configure the TFTP server address using the Grandstream Web interface.
    (connect a phone and dial *** to get to voice prompt. You will likely get a E103E code that indicates "Device is not registerd to SIP server". Press * for next menu option, press 02 for IP address, after it finishes reading out the IP, enter this IP in your browser and enter "admin" for password.
    In the web interface, under Advanced Setting 1, enter the SIP Server, SIP User ID (7511), Authenticate ID (7511), and Authenticate Password (the SIP password). Press the Update button, and Reboot.
    In Advanced Settings 2, set the Upgrade Via to TFTP and Configure Server Path to server, and Firmware Server Path to server (serverIP/gs). Update/Reboot.
  7. The terminal adaptor should now pick up the profile generated by ConfigServer and register with sipX.

Note: Automated restart of the terminal adaptor from ConfigServer might not work yet even once the terminal adaptor registered successfully.

Grandstream HandyTone Configuration Management:
ConfigServer provides comprehensive management of all the parameters of the Grandstream HandyTone terminal adaptor. 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.

Blinking Red Button: When the Red Button on your Analog Telephone Adapter stops blinking then you are up and talking.

Firmware Upgrade

To upgrade software, the HandyTone terminal adaptors 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 TA.

The TFTP server can be configured via the TA'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 TA.

The TA 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 TA will attempt to retrieve it. After verification of the checksum, the new code image will be stored into flash memory.

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

Using the sipX TFTP serve

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

sipX TFTP server IP addr: <your sipX server>

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

Copy the Grandstream HandyTone firmware image into the TFTP server's root directory. For example to get (HT-286, HT-486) issue the following commands on your sipX host:

HandyTone HT-286 / HT-486:

cd /var/sipxdata/configserver/phone/profile/tftproot
mkdir gs
unzip -d gs/

Reboot the TA. Use the Web interface to check what firmware release is running after the upgrade.