Elenco dei parametri di chiamata

Impostazione dell'indirizzo di destinazione predefinito nella finestra di dialogo Selezione controller

Utilizzare il comando seguente per impostare un valore specifico per l’Indirizzo IP di destinazione nella finestra di dialogo Selezione controller. Fare riferimento anche alla descrizione del parametro <TargetAddressURI>.

Per l'accesso protetto, è possibile utilizzare switch di parametro di chiamata aggiuntivi.

Uso:

ControllerAssistant -connect ip <TargetAddressURI>

Esempi:

ControllerAssistant -connect ip 192.168.1.33

ControllerAssistant -connect ip etcp3://192.168.1.33

ControllerAssistant -connect ip etcp2://192.168.1.33

ControllerAssistant -connect ip "enodename3://MyController (192.168.1.33)"

Impostazione del percorso predefinito delle finestre di dialogo dei file

Utilizzare il comando seguente per impostare un valore specifico come percorso predefinito delle finestre di dialogo Apri e Salva.

Uso:

ControllerAssistant -file <Path>

Esempio:

ControllerAssistant -file C:\Temp\Default.bpd

Caricamento dell'immagine dal controller

Utilizzare il comando seguente per avviare un backup del controller specificato e salvare il backup come immagine. La sequenza dei processi di questo backup viene immessa nel file di registro specificato. Il programma viene eseguito senza interfaccia utente grafica. Fare riferimento anche alla descrizione del parametro <TargetAddressURI>.

Per l'accesso protetto, è possibile utilizzare switch di parametro di chiamata aggiuntivi.

Per leggere la gestione dei diritti utente dispositivo è possibile utilizzare l'argomento opzionale della riga di comando -ReadOnlineUserRightsManagement <ignore|read>. Per leggere la gestione dei diritti utente dispositivo, è necessario aggiungere l'argomento della riga di comando -UserRightsManagementPassword <MyUserRightsManagementPassword>. Per la versione grafica e una spiegazione dettagliata, vedere Gestione dei diritti utente dispositivo.

Uso:

ControllerAssistant [-username <UserName>] [-password <Password>] [-renewalpassword <RenewalPassword>] [-imagedirectory <ImageDirectoryPath>] -loadcontrol <TargetAddressURI> [-ReadOnlineUserRightsManagement <ignore|read> -UserRightsManagementPassword <MyUserRightsManagementPassword>] [<logfile>]

Esempi:

ControllerAssistant 
-loadcontrol ip etcp3://190.201.100.100 C:\Temp\Logfile.log

ControllerAssistant 
-imagedirectory c:\Temp\MyImage 
-loadcontrol ip etcp3://190.201.100.100 C:\Temp\Logfile.log

ControllerAssistant -username MyUserName -password MyPassword -renewalpassword MyRenewalPassword -imagedirectory c:\Temp\MyImage -loadcontrol ip etcp4://190.201.100.100 -ReadOnlineUserRightsManagement read -UserRightsManagementPassword MyUserRightsManagementPassword C:\Temp\Logfile.log

NOTA: se si avvia Controller Assistant con la GUI (Graphical User Interface), è inoltre possibile impostare i tre argomenti - username, -password e -renewalpassword. In questo caso, non viene chiesto di inserire le credenziali, che vengono recuperate dai valori degli argomenti.

NOTA: Per salvare l'immagine attiva in un singolo file di immagine (estensione file *.bdp), chiamare anche -savefile.

NOTA: Tutti file presenti nella cartella di destinazione saranno eliminati.

AVVISO
	PERDITA DI DATI Verificare il percorso della directory fornito dall'argomento `-imagedirectory` della riga di comando prima di eseguire il comando. Il mancato rispetto di queste istruzioni può provocare danni alle apparecchiature.

Salvataggio dell'immagine in un controller

Utilizzare il comando seguente per salvare l'immagine nel controller specificato. La sequenza di salvataggio viene immessa nel file di registro specificato. Il programma viene eseguito senza interfaccia utente grafica. Fare riferimento anche alla descrizione del parametro <TargetAddressURI>.

Per l'accesso protetto, è possibile utilizzare switch di parametro di chiamata aggiuntivi.

Per scrivere la gestione dei diritti utente dispositivo è possibile utilizzare l'argomento opzionale della riga di comando -WriteOnlineUserRightsManagement <keep|overwrite|restore>. Per sovrascrivere la gestione dei diritti utente dispositivo, è necessario aggiungere l'argomento della riga di comando -UserRightsManagementPassword <MyUserRightsManagementPassword>. Per la versione grafica e una spiegazione dettagliata, vedere Gestione dei diritti utente dispositivo.

Uso:

ControllerAssistant [-username <UserName>] [-password <Password>] [-renewalpassword <RenewalPassword>] [-imagedirectory  <ImageDirectoryPath>] -savecontrol <TargetAddressURI> [-WriteOnlineUserRightsManagement <keep|overwrite|restore> -UserRightsManagementPassword <MyUserRightsManagementPassword>] [<logfile>]

Esempi:

ControllerAssistant 
-savecontrol ip etcp3://190.201.100.100 C:\Temp\Logfile.log

ControllerAssistant -imagedirectory c:\Temp\MyImage 
-savecontrol ip etcp3://190.201.100.100 C:\Temp\Logfile.log

ControllerAssistant -username MyUserName -password MyPassword -renewalpassword MyRenewalPassword -imagedirectory c:\Temp\MyImage -savecontrol ip etcp4://190.201.100.100 -WriteOnlineUserRightsManagement overwrite -UserRightsManagementPassword MyUserRightsManagementPassword C:\Temp\Logfile.log

NOTA: per l'argomento della riga di comando -savecontrol, il file system del controller viene sovrascritto senza alcuna richiesta al punto di esecuzione del comando e avviene quindi il ripristino del controller.

AVVERTIMENTO
	PERDITA DI DATI E POSSIBILE FUNZIONAMENTO IMPREVISTO DELL'APPARECCHIATURA Verificare che l'immagine attiva, con relativi programma, configurazione e memoria, corrisponda alla funzione del controller della macchina o del processo. Il mancato rispetto di queste istruzioni può provocare morte, gravi infortuni o danni alle apparecchiature.

Per caricare l'immagine attiva da un file di immagine singolo (con estensione *.bdp), chiamare prima -loadfile.

Caricamento dell'immagine da un file di immagine

Per caricare il file *.bpd specificato come immagine, utilizzare il comando seguente. La sequenza di caricamento viene immessa nel file di registro specificato. Il programma viene eseguito senza interfaccia utente grafica.

Uso:

ControllerAssistant [-imagedirectory <ImageDirectoryPath>]
-loadfile <ImageFilePath> [<logfile>]

Esempi:

ControllerAssistant -loadfile C:\Temp\Default.bpd C:\Temp\Logfile.log

ControllerAssistant -imagedirectory c:\Temp\MyImage
-loadfile C:\Temp\Default.bpd C:\Temp\Logfile.log

Salvataggio dell'immagine in un file di immagine

Per salvare l'immagine nel file *.bpd specificato, utilizzare il comando seguente. La sequenza di salvataggio viene immessa nel file di registro specificato. Il programma viene eseguito senza interfaccia utente grafica.

Uso:

ControllerAssistant [-imagedirectory <ImageDirectoryPath>]
-savefile <ImageFilePath> [<logfile>]

Esempi:

ControllerAssistant -savefile C:\Temp\Default.bpd C:\Temp\Logfile.log

ControllerAssistant -imagedirectory c:\Temp\MyImage
-savefile C:\Temp\Default.bpd C:\Temp\Logfile.log

Come conoscere le versioni firmware installate

Utilizzare il comando seguente per salvare un file XML con un elenco delle versioni firmware per il tipo di controller specificato presenti sul PC nel percorso risultante. Il risultato offre le stesse informazioni disponibili dall'interfaccia utente grafica.

Se sono impostati gli switch -ProductName e -ProductVersion, il file XML contiene solo i risultati per il nome e la versione del prodotto specificati.

Uso:

ControllerAssistant
-getinstalledfirmwareversionsXml <ControllerType> <ResultPath>  [-ProductName <ProductName>]
[-ProductVersion <ProductVersion>] [<logfile>]

Esempio:

ControllerAssistant
-getinstalledfirmwareversionsXml LMC058 c:\Temp\MyVersions.xml

ControllerAssistant
-getinstalledfirmwareversionsXml M241 c:\Temp\MyVersions.xml -ProductName SoMachineSoftware -ProductVersion V4.3

ControllerAssistant
-getinstalledfirmwareversionsXml M262 c:\Temp\MyVersions.xml -ProductName EcoStruxureMachineExpert

Recupero delle versioni firmware di tutti i dispositivi Sercos di un controller

Utilizzare il comando seguente per salvare un file XML con un elenco di tutte le versioni firmware di tutti i dispositivi Sercos per il tipo di controller specificato presenti sul PC nel percorso risultante. Il risultato offre le stesse informazioni disponibili dall'interfaccia utente grafica.

Uso:

ControllerAssistant
- getinstalledsercosfirmwareversionsXml <ControllerType> <ResultPath>
[<logfile>]

Esempio:

ControllerAssistant
- getinstalledsercosfirmwareversionsXml LMC600C c:\Temp\MyVersions.xml

Creazione di una nuova immagine

La chiamata da riga di comando crea una un'immagine contenente il tipo di controller indicato o la famiglia di controller indicata e la versione. La stessa funzionalità è anche disponibile dall'interfaccia utente grafica.

Uso:

ControllerAssistant -createimage <ControllerType> <FirmwareVersion> [<logfile path>] [imagepath=<image path>]

Esempio:

ControllerAssistant -createimage LMC400C 1.50.1.3 c:\Temp\MyLogfile.log

NOTA: Il comando XML per la creazione del firmware del controller offre delle funzioni aggiuntive.

Aggiornamento della versione firmware dell'immagine attiva

La chiamata da riga di comando aggiorna il firmware dell'immagine attiva in base alla versione specificata. La stessa funzionalità è anche disponibile dall'interfaccia utente grafica. Il tipo di controller e la versione firmware sono date dalla directory immagine esistente. Se viene rilevata una versione compatibile, l'aggiornamento viene eseguito senza rimuovere l'applicazione esistente.

Uso:

ControllerAssistant [-imagedirectory <ImageDirectoryPath>]
-updateimage <FirmwareVersion> [<LogFile>]

Esempi:

ControllerAssistant -updateimage 1.50.1.3 c:\Temp\MyLogfile.log

ControllerAssistant -imagedirectory c:\Temp\MyImage
-updateimage 1.50.1.3 c:\Temp\MyLogfile.log

Aggiornamento delle impostazioni di comunicazione

La chiamata da riga di comando aggiorna le impostazioni di comunicazione di un controller all'interno di un'immagine esistente utilizzando le impostazioni specificate. La stessa funzionalità è anche disponibile dall'interfaccia utente grafica.

Uso:

ControllerAssistant [-imagedirectory <ImageDirectoryPath>]
-updatecommunicationsettings <IPaddress>
<SubnetMask> <Gateway> <IPMode(fixed | bootp | dhcp)> <DeviceName>
[<logfile path>]

DeviceName viene utilizzato con IPMode dhcp. Su alcuni controller, vengono ignorati IPMode e DeviceName.

Esempi:

ControllerAssistant 
-updatecommunicationsettings 10.128.111.222 255.255.255.0 10.128.111.1 fixed "" c:\temp\version.log

ControllerAssistant -imagedirectory "c:\temp\MyImage"
-updatecommunicationsettings 10.128.111.222 255.255.255.0 10.128.111.1 dhcp "MyDeviceName" c:\temp\version.log

Come conoscere la versione del programma

Utilizzare il comando seguente per recuperare il numero di versione dell'applicazione Controller Assistant. Il file di registro opzionale <LogFile> consente di registrare il risultato e gli errori rilevati. Fare riferimento anche alla descrizione dei valori opzionali e predefiniti.

Uso:

ControllerAssistant -getProgramVersion [<logfile>]

Esempio:

ControllerAssistant -getProgramVersion c:\temp\version.log

Creazione di una cartella utente con specifici dati sul disco flash

Utilizzare il comando seguente per aggiungere dei file specifici all'immagine di un controller.

Uso:

ControllerAssistant [-imagedirectory <ImageDirectoryPath>]
-addCustomFiles <sourcePath> [<relativeDestinationPath>]
[logfile=<logfile>]

SourcePath è una cartella contenente i file copiati nell'immagine del controller. Il percorso può contenere anche delle strutture di sottodirectory. RelativeDestinationPath è opzionale e specifica una sottocartella all'interno dell'immagine del controller in cui sono archiviati i file. La sottocartella o struttura di sottocartelle è relativa alla cartella radice di imagepath.

Esempi:

ControllerAssistant -addCustomFiles "c:\temp\MyRecipes"

ControllerAssistant -imagedirectory "c:\Temp\MyImage"
-addCustomFiles "c:\temp\MyRecipes" "MyFiles\MyRecipes" logfile=c:\temp\MyLogfile.log

Copia dei file dell'applicazione e aggiunta di un'applicazione a un file di configurazione del controller

Utilizzare il comando seguente per aggiungere un'applicazione a un'immagine di controller esistente. Ad esempio, per la famiglia di controller LMC•0•C, il file *.app e i file *.crc corrispondenti vengono copiati nella cartella dell'immagine e la sezione CmpApp del file *sysc3.cfg viene modificata.

NOTA: Alcuni tipi di controller non supportano questo comando.

Uso:

ControllerAssistant [-imagedirectory <ImageDirectoryPath>]
-addapplication <ApplicationPath> <ApplicationName>
[logfile=<logfile>]

Esempio:

ControllerAssistant -imagedirectory c:\temp\MyImage
-addapplication c:\temp\MyApplicationFolderPath
MyApplicationName logfile=c:\temp\version.log

ApplicationPath è la cartella contenente il file *.app e i file *.crc corrispondenti. ApplicationName è il nome del file *.app (il nome del file senza estensione).

Visualizzazione dei comandi supportati

Utilizzare il comando seguente per elencare i possibili comandi con gli argomenti sulla console.

Uso:

ControllerAssistant -help

Esempio:

ControllerAssistant -help

Creazione di una connessione remota statica

Utilizzare il comando CreateRemoteConnection per creare una connessione remota statica su un controller specificato dall'indirizzo IP e dalla porta.

Sintassi:

-CreateRemoteConnection <ipAddressAndOptionalPort> [<RetryIfConnectionBreaks>]

Parametro	Descrizione
`<ipAddressAndOptionalPort>`	Indirizzo IP e porta opzionale, separati dal carattere `:` (due punti).
`<RetryIfConnectionBreaks>`	Parametro opzionale che definisce il comportamento in caso di interruzione della connessione: 0 (valore predefinito) Quando la connessione viene interrotta, non viene eseguito alcun tentativo di riconnessione automatica. 1 Quando la connessione viene interrotta,vengono eseguiti tentativi di riconnessione automatica. Il numero di tentativi di riconnessione non è limitato.

Parametro

Descrizione

<ipAddressAndOptionalPort>

Indirizzo IP e porta opzionale, separati dal carattere : (due punti).

<RetryIfConnectionBreaks>

Parametro opzionale che definisce il comportamento in caso di interruzione della connessione:

0 (valore predefinito)

Quando la connessione viene interrotta, non viene eseguito alcun tentativo di riconnessione automatica.
1

Quando la connessione viene interrotta,vengono eseguiti tentativi di riconnessione automatica. Il numero di tentativi di riconnessione non è limitato.

Esempi:

ControllerAssistant -CreateRemoteConnection 192.168.2.50

ControllerAssistant -createremoteconnection 192.168.2.50:1105

ControllerAssistant -createRemoteConnection 192.168.2.50:1105 1

Stato della connessione:

Dopo aver eseguito il comando CreateRemoteConnection, viene visualizzata la finestra di dialogo Connessione remota :

Fornisce informazioni sullo stato della connessione remota.
Consente di terminare la connessione facendo clic su OK.
Se la connessione non può essere stabilita o viene terminata, fornisce ulteriori informazioni sui motivi possibili.
Indica se si è attivato il parametro <RetryIfConnectionBreaks> visualizzando una notifica relativa all'esecuzione dei tentativi automatici di riconnessione.

Esempio di applicazione:

È possibile utilizzare il comando CreateRemoteConnection, ad esempio, con applicazioni server OPC. Questo è utile se il server OPC è installato su un PC e intende stabilire una connessione su un controller residente in un'altra sottorete (connessione remota). In questo caso, stabilire il bridge per la connessione remota con questo comando prima di avviare il server. Il controller remoto può quindi essere analizzato dal gateway locale. Terminare la connessione dopo aver arrestato il server.

Arresto delle applicazioni di un controller specificato

Utilizzare il comando StopAllApplications per arrestare le applicazioni del controller specificato.

Per l'accesso protetto, è possibile utilizzare switch di parametro di chiamata aggiuntivi.

Uso:

ControllerAssistant [-username <UserName>] [-password <Password>] [-renewalpassword <RenewalPassword>] -stopallapplications <TargetAddressURI> [<logfile>]

Esempi:

ControllerAssistant -StopAllApplications etcp3://192.168.2.50

ControllerAssistant -StopAllApplications "enodename3://MyController (192.168.2.50)" "C:\Temp\Logfile.log"

ControllerAssistant -username MyUserName -password MyPassword -renewalpassword MyRenewalPassword -StopAllApplications "enodename3://MyController (192.168.2.50)" "C:\Temp\Logfile.log"

Comportamento dei file CNC

I file CNC sono archiviati nella memoria interna del controller nella cartella <root>/MECNC.

Lo switch del parametro di chiamata cncsettings può essere utilizzato per impostare il comportamento dei file CNC attraverso il processo di creazione o aggiornamento del firmware.

dontcreate (impostazione predefinita): I file nella cartella <root>/MECNC vengono eliminati tramite il processo di creazione o aggiornamento del firmware.
path <PathToZippedFile>: I file del file ZIP (incluse le sottocartelle) vengono copiati nella cartella <root>/MECNC.
preserve: I file nella cartella <root>/MECNC vengono mantenuti tramite il processo di creazione o aggiornamento del firmware.

NOTA: le licenze CNC sono memorizzate nella cartella <root>/MECNC/License e non vengono modificate tramite il processo di creazione o aggiornamento del firmware.

Uso:

ControllerAssistant -cncsettings [dontcreate|path <PathToZippedFile>|preserve]

Esempi:

ControllerAssistant -cncsettings path C:\Temp\CNCfilesUpdate.zip

Identificazione dispositivo

Vedere Parametri di chiamata per l'identificazione dei dispositivi di rete per altre chiamate da riga di comando specifiche per Network Device Identification.

Comandi XML

Vedere Comandi XML per altri comandi definiti in file con formattazione XML.