你可以使用引导文件、配置文件和资源文件来配置设备功能并应用功能设置。可以使用UltraEdit等文本编辑器创建或编辑这些文件。
引导文件
Zoom设备支持引导文件。引导文件最大化灵活性,允许你为多个设备自定义功能和设置。
通过引导文件,你可以指定应下载哪些配置文件。这对于在不同部署场景中配置设备非常有效:
对于所有设备
对于一组设备
对于特定设备型号
对于单个设备
Zoom设备支持两种类型的引导文件:通用引导文件和基于MAC的引导文件。你可以使用默认的引导模板文件“y000000000000.boot”通过复制和重命名来创建基于MAC的引导文件。
你可以根据部署场景选择是否使用引导文件。如果不想使用引导文件,请查看配置文件。
通用引导文件
通用引导文件,名为y000000000000.boot,对所有设备有效。你可以使用通用引导文件将通用功能设置应用于所有设备,而不是单个设备。
基于MAC的引导文件
基于MAC的引导文件名为<MAC>.boot。它仅对特定设备有效。通过这种方式,你可以对每个设备进行逐个控制。
你可以通过复制和重命名引导模板文件(y000000000000.boot)为每个设备创建一个基于MAC的引导文件。例如,如果你的设备MAC地址是00156574B150,将模板文件重命名为00156574b150.boot(小写)。
MAC地址是分配给每个设备的唯一12位序列号。你可以从设备背面的条形码中获取。
引导文件属性
以下表格列出了你在引导模板文件中需要了解的属性。
属性 描述
#!version:1.0.0.1 必须放在第一行。不要编辑和删除。
include:config <xxx.cfg> include:config "xxx.cfg" 每个“include”语句可以指定配置文件的位置。配置文件格式必须是*.cfg。尖括号或双引号中的位置支持两种形式: 相对路径(相对于引导文件):例如sip.cfg, HTTP Directory/sip.cfg 绝对路径(或URL):例如http://10.2.5.258/Zoom.cfg位置必须指向特定的CFG文件。
[$MODEL] [$MODEL]可以添加以指定特定话机型号的设置。$MODEL代表话机型号名称。有效的设备型号名称有:MP58, MP56, MP54, MP52, T58A, T56A, T55A, CP960, CP965和VP59。多个设备型号用逗号分隔。例如,[T58A, T56A]。
overwrite_mode 启用或禁用覆盖模式。覆盖模式适用于引导文件中指定的配置文件。它仅影响通过中央配置预配置的参数。1-(启用) - 如果配置文件中的参数值为空,或配置文件中的非静态参数被删除或注释掉,工厂默认值生效。0-(禁用) - 如果配置文件中的参数值为空,删除或注释掉,预配置值将被保留。 注意 覆盖模式只能在引导文件中使用。如果使用了引导文件,但未配置“overwrite_mode”参数的值,则默认启用覆盖模式。
specific_model.excluded_mode 启用或禁用排除模式。排除模式适用于引导文件中指定的配置文件。0- 禁用(附加模式),设备下载其自身型号特定的配置文件并下载其他型号未指定的配置文件。1- 启用(排除模式),设备尝试下载其自身型号特定的配置文件;如果服务器上未找到自身型号特定的配置文件,则下载型号未指定的配置文件。 注意 排除模式只能在引导文件中使用。如果使用了引导文件,但未配置“specific_model.excluded_mode”参数的值,则默认禁用排除模式。
以“#”开头的行被视为注释。你可以使用“#”在引导文件中添加任何注释。
自定义启动文件
步骤
打开一个启动模板文件。
要添加配置文件,在文件中添加 include:config <> 或 include:config “”。每个配置文件需另起一行。
指定要下载的配置文件。
例如:include:config <configure/Zoom.cfg>,include:config “http://10.2.5.206/configure/account.cfg”
要为特定话机型号指定配置文件,在 include:config <> 或 include:config “” 前加上具体的话机型号。多个话机型号用逗号分隔。
例如:
[T58A, CP960, CP965]include:config <configure/Zoom.cfg> [T56A]include:config “http://10.2.5.206/configure/account.cfg” 文件 Zoom.cfg 仅适用于 T58A 和 CP960 话机,文件 account.cfg 仅适用于 T56A 话机
指定覆盖模式和排除模式。例如:overwrite_mode = 1,specific_model.excluded_mode = 1。
保存启动文件并将其放置在配置服务器上。
配置文件
Yealink 设备支持两种配置模板文件:公共 CFG 文件和 MAC 定向 CFG 文件。这些配置文件包含两种参数:
静态:参数以前缀 “static.” 开头,例如 static.network.lldp.enable。
非静态:参数不以 “static.” 开头,例如 phone_setting.phone_lock.enable。
你可以通过存储在配置服务器上的配置文件自动部署和维护大量设备。
为防止未经授权的访问,你可以加密配置文件。
公共 CFG 文件
公共 CFG 文件,命名为 <y0000000000xx>.cfg,包含影响设备基本操作的参数,如语言和音量。它对同一型号的所有设备有效。每个设备型号的公共 CFG 文件都有固定名称。
下表列出了每个设备型号的公共 CFG 文件名称:
设备型号 公共 CFG 文件
T58A y000000000058.cfg
T56A y000000000056.cfg
T55A y000000000099.cfg
CP960 y000000000073.cfg
CP965 y000000000073.cfg
VP59 y000000000091.cfg
MP58/MP58-WH y000000000135.cfg
MP56 y000000000122.cfg
MP54 y000000000134.cfg
MP52 y000000000145.cfg
MAC CFG 文件
Yealink 设备支持两种 MAC CFG 文件:MAC 定向文件和 MAC 本地 CFG 文件,均以设备的 MAC 地址命名。例如,如果设备的 MAC 地址是 00156574B150,MAC 定向 CFG 文件的名称是 00156574b150.cfg(小写),MAC 本地 CFG 文件的名称是 00156574b150-local.cfg(小写)。
MAC 地址是分配给每个设备的唯一 12 位序列号。你可以从设备背面的条形码获取。
MAC 定向 CFG 文件
MAC 定向 CFG 文件,以设备的 MAC 地址命名。例如,如果设备的 MAC 地址是 00156574B150,MAC 定向 CFG 文件的名称是 00156574b150.cfg(小写)。它包含特定设备的唯一参数,如账户注册。仅对特定 MAC 设备有效。
MAC 本地 CFG 文件
MAC 本地 CFG 文件,命名为 <MAC>-local.cfg,包含你通过网络用户界面或话机用户界面对非静态参数所做的更改(例如,时间和日期格式的更改)。
每次文件更新时,MAC-local.cfg 文件会上传到配置服务器。你可以通过网络用户界面下载该文件。
仅在启用配置优先机制时生成此文件。它存储在设备本地,每次文件更新时,你可以将其上传到配置服务器。即使设备执行自动配置,该文件也允许用户保留其个性化配置设置。
在启用配置优先机制之前所做的非静态更改不会保存在生成的 MAC-local 文件中,但之前的设置仍会在设备上生效。静态更改将永远不会保存到 <MAC>-local.cfg 文件 中。
配置优先机制通过参数 static.auto_provision.custom.protect 启用。
配置 MAC-Local CFG 文件
下表列出了用于生成 MAC-local CFG 文件的参数。
参数 static.auto_provision.custom.protect
描述 启用或禁用设备在自动配置后保留用户的个性化设置。 注意 配置优先机制(话机用户界面/网络用户界面 > 中央配置 > 出厂默认设置)仅在此参数值设置为 1(启用)时生效。如果在启动文件中将 overwrite_mode 设置为 1,此参数值将设置为 1(启用)。
允许值 0- 禁用 1- 启用,生成 <MAC>-local.cfg 文件,通过网络用户界面或话机用户界面配置的个性化非静态设置将在自动配置后保留。
默认值 1
清除 MAC-local CFG 文件
当设备交给新用户使用,但设备上保留了许多上一个用户配置的个性化设置;或当最终用户因错误配置遇到问题时,你可以清除用户的个性化配置设置。
步骤
根据设备选择方法:
通过设备用户界面 通过网络用户界面
对于 VP59/MP58/MP56/MP54/CP965,点击账户头像并进入 设置 > 设备设置 > 调试(默认密码:admin)> 重置用户设置。对于 MP52,进入 image > 设置 > 设备设置 > 调试(默认密码:admin)> 重置用户设置。
进入 设置 > 升级 > 重置用户设置。
仅当你设置 static.auto_provision.custom.protect = 1 时,才会显示 重置用户设置 选项。
自定义配置文件
你可以通过复制并重命名配置模板文件(例如,Zoom.cfg)来创建一些新的 CFG 文件。你可以重新排列配置模板文件中的参数,并创建包含所需参数的自定义配置文件。这种灵活性在你希望对一组设备应用特定设置时特别有用。
自定义配置文件
步骤
复制并重命名配置模板文件。例如,Zoom.cfg。
在 Zoom.cfg 中重新排列参数,并为其设置有效值。
例如:phone_setting.phone_lock.enable= 1
要为特定话机型号指定参数,在相应参数前添加具体的话机型号。不同话机型号的名称用逗号分隔。
例如:
[T58A,CP960]phone_setting.phone_lock.enable= 1
[T58A]features.bluetooth_enable= 1
这些参数仅适用于其特定的话机型号。
保存配置文件并将其放置在配置服务器上。
配置文件属性
下表列出了你在配置模板文件中需要了解的属性。
属性 描述
#!version:1.0.0.1 必须放在第一行。不要编辑或删除。
配置参数=有效值 (screensaver.wait_time =60) 指定参数和值以对设备应用特定设置。 每个配置参数和值用等号分隔 每行只设置一个配置参数 将配置参数和值放在同一行,不要换行
[$MODEL] 可以在配置参数前添加 [$MODEL] 以指定特定设备型号的值。$MODEL 代表话机型号。有效的设备型号名称包括:MP58、MP56、MP54、MP52、T58A、T56A、T55A、CP960、CP965 和 VP59。多个话机型号用逗号分隔。例如,[T58A, CP960]。 注意 设备会更新特定型号的配置和未指定型号的配置。
以 # 开头的行被视为注释。你可以在启动文件中使用 # 添加任何注释。
资源文件
资源文件是可选的,但如果使用特定功能,则需要这些文件。你需要将资源文件放置在配置服务器上。设备在自动配置期间除了请求配置文件外,还会请求资源文件。
如果你希望指定设备使用资源文件,应在 MAC 定向 CFG 文件中指定资源文件的访问 URL。在自动配置期间,设备将请求资源文件以及配置文件。
Yealink 提供了一些资源文件模板,你可以根据需要直接编辑这些文件。下表列出了 Yealink 提供的资源文件:
模板文件 文件名 描述 参考章节
AutoDST 模板 AutoDST.xml 添加或修改时区和 DST 设置。 DST 设置
语言包 例如,000.GUI.English.lang 1.English_note.xml 1.English.js 自定义语言文件以在话机/网络用户界面上显示。 语言自定义
文件下载过程
当你配置设备时,设备将根据以下流程图请求从配置服务器下载启动文件、配置文件和资源文件:
image
新下载的配置文件中的参数将覆盖之前下载文件中的相同参数。
参数 “specific_model.excluded_mode” 决定了启动文件中引用的哪些配置文件将被下载。