Vous pouvez utiliser des commandes XML au lieu d'un fichier batch. Ces commandes sont écrites dans un fichier au format XML. Elles fournissent des appels plus détaillés et plus lisibles. En outre, certaines commandes ne peuvent être utilisées que dans le format XML (notamment la création d'image avec des équipements Sercos spécifiques).
Le format d'appel à partir de la ligne de commande est le suivant :
[-username <UserName>] [-password <Password>] [-renewalpassword <RenewalPassword>] -xmlcommand <CommandFilePath> [<LogFile>]Pour un accès sécurisé, vous pouvez utiliser des commutateurs de paramètres d'appel supplémentaires.
Le fichier désigné par <CommandFilePath> contient les commandes XML.
Le fichier journal <LogFile> (facultatif) est utilisé pour consigner les résultats et les erreurs détectées. Vous pouvez également définir un fichier journal au sein du document XML.
Le nom de la racine XML est ControllerAssistantCommandLine.
Il contient les éléments suivants :
Libellé de liste nommé Commands
Une ou plusieurs commandes (libellé Command) à exécuter dans l'ordre indiqué
Utilisez la commande suivante pour obtenir le numéro de version de l'application Controller Assistant.
Exemple :
<ControllerAssistantCommandLine xmlns:xsi="http://www.w3.org/2001 XMLSchema-instance" Logfile="c:\log\ca.log">
<Commands>
<Command xsi:type="GetProgramVersion"/>
</Commands>
</ControllerAssistantCommandLine>
Le paramètre Logfile est facultatif. S'il n'est pas précisé, un fichier journal par défaut est utilisé.
Le résultat est consigné dans le fichier journal et écrit sur la console.
Utilisez la commande suivante pour créer l'image de micrologiciel d'un contrôleur
Exemple :
Cet exemple crée une image pour le contrôleur LMC600C avec les paramètres de version et de communication spécifiés. Cette image inclut en outre le micrologiciel des équipements et versions Sercos indiqués.
<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>
Les paramètres ImagePath et Logfile sont facultatifs. S'ils ne sont pas précisés, des valeurs par défaut sont utilisées.
Le résultat est consigné dans le fichier journal et écrit sur la console.
Utilisez la commande suivante pour définir les paramètres de communication du contrôleur au sein de l'image.
Exemple :
<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>
Les paramètres ImagePath et Logfile sont facultatifs. S'ils ne sont pas précisés, des valeurs par défaut sont utilisées.
Le paramètre DeviceName est utilisé avec IPMode dhcp. Sur certains contrôleurs, IPMode et DeviceName sont ignorés.
Le résultat est consigné dans le fichier journal et écrit sur la console.
Utilisez la commande suivante pour ajouter des fichiers spécifiques dans une image de contrôleur.
<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>
Les paramètres ImagePath et Logfile sont facultatifs. S'ils ne sont pas précisés, des valeurs par défaut sont utilisées.
SourcePath désigne un dossier contenant les fichiers à copier dans l'image de contrôleur. Ce chemin peut également comprendre des sous-répertoires. RelativeDestinationPath est facultatif et désigne un sous-dossier de l'image où les fichiers sont stockés. Ce sous-dossier (ou cette structure de sous-dossiers) est rattaché(e) au dossier racine de l'image.
Utilisez la commande suivante pour ajouter une application à une image de contrôleur. Par exemple, pour la famille de contrôleurs LMC•0•C, les fichiers *.app et *.crc correspondants sont copiés dans le dossier d'image et la section CmpApp du fichier de configuration *sysc3.cfg est modifiée.
Exemple :
<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>
Les paramètres ImagePath et Logfile sont facultatifs. S'ils ne sont pas précisés, des valeurs par défaut sont utilisées.
ApplicationPath est le dossier contenant les fichiers *.app et *.crc correspondants. ApplicationName est le nom du fichier *.app (nom de fichier sans extension).