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 :
-xmlcommand <CommandFilePath> [<LogFile>]
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 libellé de la racine XML est ControllerAssistantCommandLine.
Il contient les éléments suivants :
oLibellé de liste nommé Commands
oUne ou plusieurs commandes (libellé Command) à exécuter dans l'ordre indiqué
Obtention de la version du programme
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.
Création d'un micrologiciel de contrôleur
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=""
>
<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" />
</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.
Définition des paramètres de communication
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.
Ajout de fichiers personnalisés à une image existante
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.
Ajout d'une application à une image existante
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.
NOTE : Cette commande n'est pas prise en charge par certains types de contrôleur.
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).
