电话接受 XML 格式的配置。

本文档中的示例使用采用 XML 格式 (XML) 语法的配置文件。

有关您的电话的详细信息，请参阅对应的管理指南。 每个指南介绍了可通过管理 web 服务器配置的参数。

配置文件定义电话的参数值。

配置文件 XML 格式使用标准 XML 编写工具编译参数和值。

注	仅支持 UTF-8 字符集。 如果您在编辑器中修改配置文件，不要更改编码格式；否则电话将无法识别文件。

每部电话有不同的功能组合，因此，参数组合也不尽相同。

<flat-profile>
<Resync_On_Reset> Yes </Resync_On_Reset>
<Resync_Periodic> 7200 </Resync_Periodic>
<Profile_Rule> tftp://prov.telco.com:6900/cisco/config/CP_xxxx_MPP.cfg</Profile_Rule>
</flat-profile>

可以压缩开放配置文件以减少设置服务器上的网络负载。 也可以对配置文件加密以保护机密信息。 压缩并非必需，但其必须在加密之前完成。

创建 XML 配置脚本后，必须将其传送给电话以供应用。 要应用配置，您可以使用 Web 浏览器或 cURL 命令行实用程序，从 TFTP、HTTP 或 HTTPS 服务器将配置文件下载到电话。

本节介绍根据功能大致编排的设置参数：

存在以下设置参数类型：

• 一般用途

• 启用

• 触发器

• 可配置的日程表

• 配置文件规则

• 升级规则

这些数据类型与配置文件参数一起使用：

• {a,b,c,…} — 在 a、b、c 之间选择 …

• Bool — 布尔值为“是”或“否”。

• CadScript — 指定信号节律参数的简短说明。 最多 127 个字符。

  语法：S₁[;S₂]，其中：

  • S_i=D_i(on_i,1/off_i,1[,on_i,2/off_i,2[,on_i,3/off_i,3[,on_i,4/off_i,4[,on_i,5/off_i,5[,on_i,6/off_i,6]]]]])，称为区段。

  • on_i,j 和 off_i,j 是片段开/关的持续时间，以秒为单位。i = 1 或 2，j = 1 或 6。

  • D_i 是区段的总持续时间，以秒为单位。

  所有持续时间最多可有三位小数，提供毫秒级分辨率。 通配符“*”表示持续时间无限。 区段中的片段将按顺序重复执行，直至执行时间达到总持续时间。

  示例 1：

  
  60(2/4)
  
  Number of Cadence Sections = 1
  Cadence Section 1: Section Length = 60 s
  Number of Segments = 1
  Segment 1: On=2s, Off=4s
  
  Total Ring Length = 60s
  
  

  示例 2 — 独特振铃（短、短、短、长）：

  
  60(.2/.2,.2/.2,.2/.2,1/4)
  
  Number of Cadence Sections = 1
  Cadence Section 1: Section Length = 60s
  Number of Segments = 4
  Segment 1: On=0.2s, Off=0.2s
  Segment 2: On=0.2s, Off=0.2s
  Segment 3: On=0.2s, Off=0.2s
  Segment 4: On=1.0s, Off=4.0s
  
  Total Ring Length = 60s
  
  

• DialPlanScript — 用于指定线路 1 和线路 2 的拨号方案的脚本语法。

• Float<n>—最多小数点后 n 位的浮点值。

• FQDN — 完全限定域名。它最多可包含 63 个字符。 示例如下：

  • sip.Cisco.com:5060 或 109.12.14.12:12345

  • sip.Cisco.com 或 109.12.14.12

• FreqScript — 指定提示音频率和等级参数的简短说明。 最多可包含 127 个字符。

  语法：F₁@L₁[,F₂@L₂[,F₃@L₃[,F₄@L₄[,F₅@L₅[,F₆@L₆]]]]]，其中：

  • F₁–F₆ 是频率，以赫兹为单位（仅无符号整数）。

  • L₁–L₆ 是相应的等级，以 dBm 为单位（最多一位小数）。

  逗号之前和之后允许使用空格，但不建议这样做。

  示例 1 — 呼叫等待提示音：

  
  440@-10
  
  Number of Frequencies = 1
  Frequency 1 = 440 Hz at –10 dBm
  
  

  示例 2 — 拨号音：

  
  350@-19,440@-19
  
  Number of Frequencies = 2
  Frequency 1 = 350 Hz at –19 dBm
  Frequency 2 = 440 Hz at –19 dBm
  

• IP — 有效的 IPv4 地址，格式为 x.x.x.x，其中 x 介于 0 与 255 之间。示例：10.1.2.100。

• UserID — URL 中出现的用户 ID；最多 63 个字符。

• Phone — 电话号码字符串，例如 14081234567、*69、*72、345678；或者一般 URL，例如 1234@10.10.10.100:5068 或 jsmith@Cisco.com。 字符串最多可以包含 39 个字符。

• PhTmplt — 电话号码模板。 每个模板可包含一个或多个用逗号 (,) 分隔的模式。 每个模式开头处的空格将被忽略。 “?”和“*”表示通配符字符。 要从字面上表示，请使用 %xx。 例如，%2a 表示 *。 模板最多可以包含 39 个字符。 示例：“1408*, 1510*”, “1408123????, 555?1.”。

• Port — TCP/UDP 端口号 (0-65535)。 它可以用十进制或十六进制格式指定。

• ProvisioningRuleSyntax — 用于定义配置重新同步和固件升级规则的脚本语法。

• PwrLevel — 以 dBm 表示的功率级别，含一位小数，例如 –13.5 或 1.5 (dBm)。

• RscTmplt — SIP 响应状态代码的模板，如 “404, 5*”, “61?”, “407, 408, 487, 481”。 最多可包含 39 个字符。

• Sig<n> — 有符号的 n 位值。 它可以用十进制或十六进制格式指定。 负值前面必须添加 - 号。 正值前面可以选择性添加 + 号。

• Star Codes — 补充服务的激活码，如 *69。 代码最多可以包含 7 个字符。

• Str<n> — 最多具有 n 个非保留字符的通用字符串。

• Time<n> — 持续时间，以秒为单位，最多 n 位小数。 额外指定的小数位将被忽略。

• ToneScript — 指定电话进展音的频率、电平和节奏参数的简短说明。 脚本最多可包含 127 个字符。

  语法：FreqScript;Z₁[;Z₂]。

  在 CadScript 中，区段 Z₁ 与区段 S₁ 类似，除每个开/关片段后跟频率要素参数外：Z₁ = D₁(on_i,1/off_i,1/f_i,1[,on_i,2/off_i,2/f_i,2 [,on_i,3/off_i,3/f_i,3 [,on_i,4/off_i,4/f_i,4 [,on_i,5/off_i,5/f_i,5 [,on_i,6/off_i,6/f_i,6]]]]])，其中：

  • f_i,j = n₁[+n₂]+n₃[+n₄[+n₅[+n₆]]]]]。

  • 1 < n_k < 6 指定 FreqScript 中用于该片段的频率要素。

  如果一个片段中使用了多个频率要素，会将所有要素汇总。

  示例 1 — 拨号音：

  
  350@-19,440@-19;10(*/0/1+2)
  
  Number of Frequencies = 2
  Frequency 1 = 350 Hz at –19 dBm
  Frequency 2 = 440 Hz at –19 dBm
  Number of Cadence Sections = 1
  Cadence Section 1: Section Length = 10 s
  Number of Segments = 1
  Segment 1: On=forever, with Frequencies 1 and 2
  
  Total Tone Length = 10s
  
  

  示例 2 — 通信音：

  
  350@-19,440@-19;2(.1/.1/1+2);10(*/0/1+2)
  
  Number of Frequencies = 2
  Frequency 1 = 350 Hz at –19 dBm
  Frequency 2 = 440 Hz at –19 dBm
  Number of Cadence Sections = 2
  Cadence Section 1: Section Length = 2s
  Number of Segments = 1
  Segment 1: On=0.1s, Off=0.1s with Frequencies 1 and 2
  Cadence Section 2: Section Length = 10s
  Number of Segments = 1
  Segment 1: On=forever, with Frequencies 1 and 2
  
  Total Tone Length = 12s
  
  

• Uns<n> — 无符号 n 位值，其中 n = 8、16 或 32。它可以以十进制格式或十六进制格式（例如 12 或 0x18）指定，只要该值可以容纳 n 位。

注	考虑以下因素： <Par Name> 表示配置参数名称。在配置文件中，用下划线“_”替换空格即形成相应标签（如 Par_Name）。 空的缺省值字段表示空字符串 < “” >。 电话将继续为给定配置文件中未出现的标签使用最后一个配置的值。 模板按照给定的顺序进行比较。 首先是 not the closest，选择匹配项。 参数名称必须完全匹配。 如果配置文件中为一个参数给出了多个定义，则电话会采用文件中的最后一个定义。 具有空参数值的参数规范强制参数返回其默认值。 要改为指定空字符串，使用空字符串 "" 作为参数值。

电话支持安全远程设置（配置）和固件升级。 未设置的电话可以接收发往该设备的加密配置文件。 由于使用 SSL 功能的安全首次设置机制，电话不需要显式密钥。

无需用户介入即可启动或结束配置文件更新或者固件升级，或者必须进行中间升级才能从较旧版本达到未来的升级状态。 仅当电话处于空闲状态时才会执行配置文件重新同步，因为重新同步可能触发软件重新启动以及呼叫断开连接。

通用参数管理设置过程。 可配置每部电话定期联系一般设置服务器 (NPS)。 与 NPS 的通信并不要求一定使用安全协议，因为更新的配置文件经共享密钥加密。 NPS 可以是含客户端证书的标准 TFTP、HTTP 或 HTTPS 服务器。

管理员可以使用电话的 Web 用户界面升级、重新引导、重新启动或重新同步电话。 管理员还可以使用 SIP notify 消息执行这些任务。

配置文件通过使用与服务提供商设置系统集成的通用开源工具生成。