XML 命令

概述

可以使用 XML 命令来代替批处理文件。命令将写入到 XML 格式的文件中。它们提供了更详细并且更便于阅读的命令调用。此外，特定命令只能由 XML 命令使用（如，使用特定 Sercos 设备创建映像）。

这些命令使用以下格式从命令行中调用自身：

[-username <UserName>] [-password <Password>] [-renewalpassword <RenewalPassword>] -xmlcommand <CommandFilePath> [<LogFile>]

对于安全访问，可以使用额外的调用参数开关。

<CommandFilePath> 中的文件包含 XML 命令。

可选的日志文件 <LogFile> 用于记录检测到的 XML 结果和检测到的错误。还可以在 XML 文档中定义日志文件。

文件格式

根 XML 标记名称的名称是 ControllerAssistantCommandLine。

它包含以下元素：

一个名为 Commands 的列表标记。
要按照已定义顺序执行的一个或多个命令（标记名称 Command）。

获取程序版本

使用以下命令来检索 Controller Assistant 应用程序的版本号。

示例：

<ControllerAssistantCommandLine xmlns:xsi="http://www.w3.org/2001 XMLSchema-instance" Logfile="c:\log\ca.log">
   <Commands>
      <Command xsi:type="GetProgramVersion"/>
   </Commands>
</ControllerAssistantCommandLine>

Logfile 参数是可选的。如果未指定，则使用缺省日志文件。

结果记录到日志文件中，并写入到控制台中。

创建控制器固件

使用以下命令来为控制器创建新的固件映像。

示例：

此示例为具有特定版本和通讯设置的控制器 LMC600C 创建一个映像。此外，映像还包括给定的 Sercos 设备和版本的固件。

<ControllerAssistantCommandLine xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ImagePath="c:\img" Logfile="c:\log\ca.log">
    <Commands>
        <Command xsi:type="CreateImage"
                 ControllerType="LMC600C"
                 FirmwareVersion="1.50.3.4"
                 IPAddress="192.168.15.1"
                 SubnetMask="255.255.255.0"
                 Gateway="192.168.15.100"
                 IPMode="fixed"
                 DeviceName=""
                 UseRecommendedSercosDevices="false"
           >
            <SercosDevices>
              <SercosDevice VisibleName="LXM62" Version="1.50.4.0" />
              <SercosDevice VisibleName="LXM62P" Version="1.50.4.0" />
              <SercosDevice VisibleName="LXM62D" Version="1.50.4.0" />
              <SercosDevice VisibleName="ILM62" Version="1.50.4.0" />
              <SercosDevice VisibleName="LXM52" Version="1.50.4.0" />
              <SercosDevice VisibleName="TM5NS31" Version="1.09" />
              <SercosDevice VisibleName="SLC100" Version="1.10" />
              <SercosDevice VisibleName="SLC200" Version="1.10" />
              <SercosDevice VisibleName="ILM62 Safety Module" Version="1.2.4" DeviceType="Module"/>
              <SercosDevice VisibleName="TM5STI4ATCFS" Version="3.22" DeviceType="Module"/>
              </SercosDevices>
        </Command>
    </Commands>
</ControllerAssistantCommandLine>

ImagePath 和 Logfile 参数是可选。如果未指定，则使用缺省值。

结果记录到日志文件中，并写入到控制台中。

设置通讯参数

使用以下命令来设置映像中控制器的通讯参数。

示例：

<ControllerAssistantCommandLine xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ImagePath="c:\img" Logfile="c:\log\ca.log">
    <Commands>
        <Command xsi:type="UpdateCommunicationSettings"
                 IPAddress="192.168.0.1"
                 SubnetMask="255.255.255.0"
                 Gateway="192.168.0.100"
                 IPMode="fixed"
                 DeviceName="">
        </Command>
    </Commands>
</ControllerAssistantCommandLine>

ImagePath 和 Logfile 参数是可选。如果未指定，则使用缺省值。

DeviceName 与 IPMode dhcp 配合使用。在某些控制器上，将忽略 IPMode 和 DeviceName。

结果记录到日志文件中，并写入到控制台中。

向现有映像中添加自定义文件

使用以下命令向控制器映像中添加特定文件。

<ControllerAssistantCommandLine xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ImagePath="c:\img" Logfile="c:\log\ca.log">
  <Commands>
    <Command xsi:type="AddCustomFiles" SourcePath="c:\additionalFiles"
      RelativeDestinationPath="addons"/>
  </Commands>
</ControllerAssistantCommandLine>

ImagePath 和 Logfile 参数是可选。如果未指定，则使用缺省值。

文件夹 SourcePath 包含复制到控制器映像的文件。此路径还可以包含子目录结构。RelativeDestinationPath 为可选，指定控制器映像中用于存储文件的子文件夹。子文件夹或者子文件夹的结构与映像的根文件夹有关。

向现有映像中添加应用程序

使用以下命令向控制器映像中添加应用程序。例如，对于 LMC•0•C 控制器系列，*.app 以及对应的 *.crc 文件将复制到映像文件夹，并且会修改 *sysc3.cfg 文件的 CmpApp 节。

注：部分控制器类型不支持此命令。

示例：

<ControllerAssistantCommandLine xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ImagePath="c:\img" Logfile="c:\log\ca.log">
<Commands>
  <Command xsi:type="AddApplication" ApplicationPath=""
    ApplicationName="newapp"/>
  </Commands>
</ControllerAssistantCommandLine>

ImagePath 和 Logfile 参数是可选。如果未指定，则使用缺省值。

文件夹 ApplicationPath 包含 *.app 以及对应的 *.crc 文件。ApplicationName 是 *.app 文件的名称（不含扩展名的文件名）。