Figure 9: Custom ringtone provisioning
Codec: must be Opus
Frequency: 16K
Audio Channel: Mono
Phone Provisioning
Configuration File Download
Grandstream SIP Devices can be configured via the Web Interface as well as via a Configuration File (binary or XML) through
TFTP, FTP/FTPS, or HTTP/HTTPS. The “Config Server Path” is the TFTP, FTP/FTPS, or HTTP/HTTPS server path for the
configuration file.
It needs to be set to a valid URL, either an FQDN or IP address format. The “Config Server Path” can be the same or different
from the “Firmware Server Path”.
A configuration parameter is associated with each field on the web configuration page. A parameter consists of a Capital letter
P and 2 to 5-digit numeric numbers. i.e., P2 is associated with the “New Password” in the Web GUI🡪System
Settings🡪Security Settings 🡪 User Info Management 🡪 Admin Password. For a detailed parameter list, please refer to
the corresponding configuration template.
When the GRP260x series boots up or reboots, it will issue a request to download an XML file named “cfgxxxxxxxxxxxx.xml”,
where “xxxxxxxxxxxx” is the MAC address of the phone, i.e., “cfg000b820102ab” and “cfg000b820102ab.xml”. If the download
of the “cfgxxxxxxxxxxxx.xml” file is not successful followed by a configuration file named “cfgxxxxxxxxxxxx”, the phone will
issue a request to download a specific model configuration file “cfg<model>.xml”, where <model> is the phone model, i.e.,
“cfggrp2601.xml” for the GRP2601, “cfgrp2602” for the GRP2602, “cfgrp2603” for the GRP2603 and “cfgrp2604” for the
GRP2604. If this file is not available, the phone will issue a request to download the generic “cfg.xml” file. The configuration
file name should be in lower case letters, If not found, the phone will request a file named “dev[MacAddress].cfg” where
“MacAddress” is the MAC address of the device, With this provisioning file, users can provision the device with both P-values
and aliases.
Figure 10: Config File Download
Those P-values are:
Note: (attempt to download the config file again)
When doing provision on the phone, if your first config file contains p-values listed below, phone will try to download the
potential second cfg.xml file and apply the second file without rebooting. Maximum 3 extra attempts.