配置文件

概述

可使用 XML 格式的外部配置文件对 Controller Assistant 进行参数设置。该特定于用户的配置文件可在启动程序时载入。此后，便可使用这些设置。该文件由 Controller Assistant 读取但不会写入其中。

如果配置文件位于 Controller Assistant 的执行目录中，则在程序启动时会采用其设置。这些设置将影响 Controller Assistant 的行为和操作。这些设置用于整合到 HMI 中。

Structure（结构）

该文件采用 XML 格式 (http://www.xml.org) 的结构且必须包含编码 ISO-8859-1。这可让您在任何时候使用文本编辑器输入特殊字符（例如，ä, ö 和 ü 等变音符号）。

根节点具有名称 <config>. 有关其他子节点的描述，请参阅本章中的参数部分。

下面是一个典型的配置文件，包含了 2 个条目， autofilesavefilename 和 defaultfilesavedirectory. 这两个条目都作为组在父节点 fileoptions 下。

具有 2 个条目的典型配置文件的示例：

<?xml version="1.0" encoding="ISO-8859-1" ?>
<config>
  <fileoptions>
    <autofilesavefilename>
      <![CDATA[Backup_<date>_<counter>.pdi]]
    <autofilesavefilename>
    <defaultfilesavedirectory>
       c:\temp\PD-BackUp
    <defaultfilesavedirectory>
  <fileoptions>
</config>>

对文件的更改必须兼容 XML。否则，将无法加载文件。在启动 Controller Assistant 时，将用说明错误行和列的诊断消息对此进行指示。然后会启动程序，并忽略配置文件。

调用

有 2 种方法可用于加载所需的配置文件：

自动

如果在 Controller Assistant 的启动目录中有具有名称为 Controller assistant.config.xml 的文件，则会在启动时自动将其载入。然后，程序会在运行时使用这些设置。
手动

您也可使用命令行从文件系统中的另一个位置显式地载入配置文件。该操作的优先级高于自动调用。为此，可通过命令行使用以下语法：

-userconfigfile <file name>

在此情况下，将载入在 <file name> 下输入的配置文件。

参数

在配置文件 Controller assistant.config.xml 中各个参数的出现位置会有这些参数的描述。您将在此找到应用程序示例。由于该文件位于程序目录中，您可将其用作模板。

而且将详细描述参数。参数将作为 XML 路径列出，这些路径描述了各参数在 XML 文件中的不同位置。

config/fileoptions/autofilesavefilename

在保存文件后，会自动生成文件名。文件名可由常量名称元素、值（例如日期或控制器类型）以及计数组成。然后会提议自动生成的名称，例如在另存为对话框中。

可通过文本和占位符描述自动生成的名称。

示例

BackUp_date=<date>.bpd 可获取文件名 BackUp_date=2006-03-12.bpd

使用了当前日期。占位符必须为小写形式。这意味着 <date> 有效，但 <Date> 无法被识别。

新生成的文件名可能包含文件系统不支持的字符（例如文件 My?File）。此时，将用小写的 x 来替换这些字符。

示例

My?File.bpd 将由 MyxFile.bpd 替代。

以下 8 个字符是会被替代的字符：

\/:*?"<>|

将要生成的名称的描述（带占位符）包含无法直接写入 XML 文件的特殊 XML 字符。因此，描述必须括在 CDATA 部分中。

示例

BackUp_<date>.bpd 必须更改为 <!CDATA[BackUp_<date>.bpd]]，才能插入 XML 文件。

由于要自动生成的文件名的描述可能包含特殊字符，因此必须括在 CDATA 部分中。

<?xml version="1.0" encoding="ISO-8859-1" ?>
<config>
  <fileoptions>
    <autofilesavefilename>
      <![CDATA[Backup_<date>_<counter>.pdi]]
    <autofilesavefilename>
    <defaultfilesavedirectory>
       c:\temp\PD-BackUp
    <defaultfilesavedirectory>
  <fileoptions>
</config>>

占位符位于尖括号中。必须手动输入它们。下面的列表提供了可用占位符的概览。

<date>

当前日期：

格式：yyyy-MM-dd

示例

1999-12-01 2006-03-21
<time>

24 小时格式的当前时间：

格式：HH-mm-ss

示例

07-41-29 19-41-29
<counter>

计数器属于例外。首先，它会在文件名中用从 1 开始的数字替代占位符 <counter>。例如，由此得到文件名 PD-BackUp_1.bpd。然后，它会验证同一目录中是否已存在该文件名。如果已存在，则会将计数增加 1 并重复此过程，直到没有同名文件为止。
<controllertype>

该占位符会以缩写形式插入控制器类型。

示例

LMC 300 C400600
<firmwareversion>

按照格式 Major.Minor.Build.Revision 设置固件版本

示例

1.30.0.0 1.31.201.2。

具有可能结果的调用示例

<controllertype>_<firmwareversion>.bpd
--> MAX4_0.22.6.0.bpd
<controllertype>_<firmwareversion>_<date>_<counter>.bpd
--> C400600_2206_2006-03-22_1.bpd

config/fileoptions/defaultfilesavedirectory

该参数定义打开另存为对话框时首先显示的默认目录。您可以更改目录并保存文件。在下次打开另存为对话框时，将会再次提议 <defaultfilesavedirectory> 中定义的目录。

以下示例将 c:\temp\PD-BackUp 定义为默认目录。

<?xml version="1.0" encoding="ISO-8859-1" ?>
<config>
  <fileoptions>
    <autofilesavefilename>
      <![CDATA[Backup_<date>_<counter>.pdi]]
    <autofilesavefilename>
    <defaultfilesavedirectory>
       c:\temp\PD-BackUp
    <defaultfilesavedirectory>
  <fileoptions>
</config>>

该条目将 c:\temp\PD-BackUp 定义为默认目录

config/fileoptions/defaultfileopendirectory

该参数定义在打开打开对话框时首先显示的默认目录。您可以更改目录并打开文件。在下次打开打开对话框时，将会再次提议 <defaultfileopendirectory> 中定义的目录。

config/application/usermode

通过用户模式，可将 Controller Assistant 进一步参数化。用户模式专门用于 HMI 应用程序。它定义哪些功能可用。

可用的模式如下：

模式	描述
`Default`	缺省设置（与无活动用户模式对应）
`NoFirmwareChange`	已禁用固件更换的对话框。
`DontEditImage`	已禁用编辑映像时所用的菜单。
`NoExplorer`	已禁用手动编辑映像时所用的 Controller Assistant 的映像管理器对话框。

config/application/quicktransfermode

如果是对控制器具有高级别要求的资源密集型编程，尤其是对于固件过期的控制器，可能会超过循环时间。如果 <quicktransfermode> 设置为 FALSE，则会缓慢进行传输（因数最大为 15）。这有助于最大程度降低循环时间溢出以及因此而发生监视狗超时的风险。

注： <quicktransfermode> 的缺省值为 TRUE。