Cisco Systems Linksys PAP2, RT31P2 3.1. Configuration Profile Formats

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,