Filter
Top Products
The PHONE ADAPTER also provides a Web Interface with two-level access (user-level and admin-
level) to configuration parameters. For standalone PHONE ADAPTERS (which contain no router or
NAT functionality), an IVR (Interactive Voice Response) interface is also available for configuring
basic networking.
3.1. Configuration Profile Formats
The PHONE ADAPTER configuration profile is an XML or binary file with encoded PHONE
ADAPTER parameter values and optionally user access permissions for those parameters. By
convention, the profile is named with the extension “.cfg” (e.g. pap2.cfg). An administrator can easily
generate the XML format and compress and/or encrypt this file with off-the-shelf tools (e.g. gzip,
openssl).
The XML configuration file always begins with the top-level element <flat-profile>. Within this element
are any number of the configuration elements which are visible in the GUI. The XML tag names are
case-sensitive and are identical to the names in the GUI, except that characters other than hyphen,
period, underscore, and alphanumeric characters from the GUI are replaced with an underscore in
the XML names. For example, User ID(1) becomes <User_ID_1_> .
Empty elements (ex: <element/> ) or missing elements do not change the value already stored in
memory. An opening and closing tag (ex: <element></element>) with no included value, deletes the
value stored in memory. Standard XML comments and arbitrary whitespace can be included in the file
for readability purposes. Note that in XML, less-than ("<") and ampersand ("&") characters within an
element must be escaped (using "<" and "&" respectively). Element names in XML are case-
sensitive.
<flat-profile>
<Profile_Rule>https://config.provider.net/linksys/$MA-cfg.xml
</Profile_Rule>
<Resync_Periodic>86400</Resync_Periodic>
<Admin_Passwd>9b4cef5677a129</Admin_Passwd>
<Proxy_1_>sip.provider.net</Proxy_1_>
<User_ID_1_>1234567890</User_ID_1_>
<Password_1_>YhJ89_Luk4E</Password_1_>
<Display_Name_1_>1234567890</Display_Name_1_>
<Line_Enable_2_>0</Line_Enable_2_>
</flat-profile>
The Linksys Supplementary Profile Compiler tool (SPC) is provided for compiling a plain-text file
containing parameter-value pairs into a binary cfg file which is optionally encrypted. The spc tool is
available from Linksys for the Win32 environment (spc.exe), Linux-i386-elf environment (spc-linux-
i386-static) and for the OpenBSD environment.
The syntax of the plain-text file accepted by the profile compiler is a series of parameter-value pairs,
with the value in double quotes. Each parameter-value pair is followed by a semicolon, e.g.
parameter_name “parameter_value”;. If no quoted value is specified for a parameter (or if a
parameter specification is missing entirely from the plain-text file) the value of the parameter will
remain unchanged in the PHONE ADAPTER.
The SPC syntax also controls the parameter’s user-level access when using the built-in web interface
to the PHONE ADAPTER (PAP2-only). An optional exclamation point or question mark, immediately
following the parameter name, indicates the parameter should be user read-write or read-only,
© 2004 Linksys Proprietary (See Copyright Notice on Page 2)
21