FB_SoEAX5000FirmwareUpdate
Mit dem Funktionsbaustein FB_SoEAX5000FirmwareUpdate kann die Firmware des AX5000 überprüft und automatisch auf eine bestimme Version (Revision und Build) oder auf das aktuellste Build der konfigurierten Revision geändert werden.
Für das Update wird
- der konfigurierte Slavetyp ermittelt, z. B. AX5103-0000-0010
- der aktuelle Slave mit der vorgegebenen Slaveadresse ermittelt, z. B. AX5103-0000-0009
- die aktuelle Slavefirmware ermittelt, z. B. v1.05_b0009
- ein Vergleich der Konfiguration und des gefundenen Slaves auf Anzahl der Kanäle, Strom, Revision und Firmware ausgeführt
- der Name des erforderlichen Firmware-Files ermittelt und die Datei gesucht
- der Firmware-Update (falls erforderlich) ausgeführt
- der aktuelle Slave mit der vorgegebenen Slaveadresse erneut ermittelt
- der Slave in den vorgegebenen EtherCAT-Status geschaltet
Ein erfolgreiches Update endet mit eFwUpdateState = eFwU_FwUpdateDone.
Wenn das Update nicht erforderlich ist, wird dies über eFwUpdateState = eFwU_NoFwUpdateRequired signalisiert.
Das Firmware-Update erfolgt über den angegeben Kanal (A=0 oder B=1) aus stDriveRef. Bei zweikanaligen Geräten kann nur einer der beiden Kanäle verwendet werden. Der andere Kanal signalisiert eFwUpdateState = eFwU_UpdateViaOtherChannelActive bzw. eFwUpdateState = eFwU_UpdateViaOtherChannel.
Während des Firmware-Updates (eFwUpdateState = eFwU_FwUpdateInProgress) signalisiert iLoadProgress den Fortschritt in Prozent.
Hinweis | |
Fehlerhaftes Update durch Unterbrechungen Unterbrechungen während des Updates können dazu führen, dass dieses nicht oder fehlerhaft ausgeführt wird. Die Klemme kann danach ohne die passende Firmware möglicherweise nicht mehr verwendet werden. Während des Updates gilt:
|
Eingänge
VAR_INPUT
sNetId : T_AmsNetId;
bExecute : BOOL;
sFirmwareVersion : STRING(20); (* version string vx.yy_bnnnn, e.g. "v1.05_b0009" for v1.05 Build 0009*)
sFirmwarePath : T_MaxString; (* drive:\path, e.g. "C:\TwinCAT\Io\TcDriveManager\FirmwarePool" *)
iReqEcState : UINT := EC_DEVICE_STATE_OP;
tTimeout : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR
Name | Typ | Beschreibung |
|---|---|---|
sNetId | T_AmsNetId | AMS-NetID der Steuerung (IPC). |
bExecute | BOOL | Über eine positive Flanke an diesem Eingang wird der Baustein aktiviert. |
sFirmwareVersion | STRING(20) | Gibt die gewünschte Firmware-Version in Form von vx.yy_bnnnn an, z. B. „v1.05_b0009“ für Version v1.05 Build 0009. Release-Builds:
Kundenspezifische Firmware-Builds:
...
Debug-Builds:
|
sFirmwarePath | T_MaxString | Gibt den Pfad für den Firmware-Pool an, in dem sich die Firmware-Dateien befinden, z. B. C:\TwinCAT\Io\TcDriveManager\FirmwarePool. |
iReqEcState | UINT | Gewünschter EtherCAT-Status nach dem Update (nur wenn tatsächlich ein Update ausgeführt wird). Die Status sind in der PLC Lib Tc2_EtherCAT als globale Konstanten definiert. |
tTimeout | TIME | Da der Firmware-Update bei großen EtherCAT-Netzwerken länger dauern kann, wird hier nur der Timeout für einzelne interne ADS-Instanzen vorgegeben. |
Ein-/Ausgänge
VAR_IN_OUT
Axis : NCTOPLC_AXIS_REF;(* reference to NC axis *)
END_VAR
Name | Typ | Beschreibung |
|---|---|---|
Axis | Achsdatenstruktur vom Typ NCTOPLC_AXIS_REF |
Ausgänge
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
iAdsErrId : UINT;
iSercosErrId : UINT;
iDiagNumber : UDINT;
eFwUpdateState : E_FwUpdateState;
iLoadProgress : INT;
sSelectedFirmwareFile : STRING(MAX_STRING_LENGTH); (* found firmware file, e.g. "AX5yxx_xxxx_-0010_v1_05_b0009.efw" *)
END_VAR
Name | Typ | Beschreibung |
|---|---|---|
bBusy | BOOL | Dieser Ausgang wird bei der Aktivierung des Funktionsbausteins gesetzt und bleibt gesetzt, bis eine Rückmeldung erfolgt. |
bError | BOOL | Dieser Ausgang wird gesetzt, nachdem der bBusy-Ausgang zurückgesetzt wurde, wenn ein Fehler bei der Übertragung des Kommandos auftritt. |
iAdsErrId | UINT | Liefert bei gesetztem bError-Ausgang den ADS-Fehlercode des zuletzt ausgeführten Befehls. |
iSercosErrId | UINT | Liefert bei gesetztem bError-Ausgang den Sercos-Fehler des zuletzt ausgeführten Befehls. |
iDiagNumber | UDINT | Liefert bei gesetztem bError-Ausgang den Antriebsfehler des letzten Firmware-Updates. |
eFwUpdateState | E_FwUpdateState | Liefert den Status der Firmware-Updates. |
iLoadProgress | INT | Liefert den Fortschritt des eigentlichen Firmware-Updates in Prozent. |
sSelectedFirmwareFile | STRING(MAX_STRING_LENGTH) | Zeigt den Namen der gesuchten Firmware-Datei an. |
Beispiel
VAR CONSTANT
iNumOfDrives : INT := 2;
END_VAR
VAR
fbFirmwareUpdate : ARRAY [1..iNumOfDrives] OF FB_SoEAX5000FirmwareUpdate;
NcToPlc AT %I* : ARRAY [1..iNumOfDrives] OF NCTOPLC_AXIS_REF;
sFirmwareVersion : ARRAY [1..iNumOfDrives] OF STRING(20)(* := 2('v1.04_b0002')*);
eFwUpdateState : ARRAY [1..iNumOfDrives] OF E_FwUpdateState;
sSelectedFirmwareFile: ARRAY [1..iNumOfDrives] OF STRING(MAX_STRING_LENGTH);
iUpdateState : INT;
bExecute : BOOL;
sNetIdIPC : T_AmsNetId := '';
sFirmwarePath : T_MaxString := 'C:\TwinCAT\Io\TcDriveManager\FirmwarePool';
I : INT;
bAnyBusy : BOOL;
bAnyError : BOOL;
END_VAR
CASE iUpdateState OF
0:
IF bExecute THEN
iUpdateState := 1;
END_IF
1:
FOR I := 1 TO iNumOfDrives DO
fbFirmwareUpdate[I](
Axis := NcToPlc[I],
bExecute := TRUE,
tTimeout := T#15s,
sFirmwareVersion := sFirmwareVersion[I],
sFirmwarePath := sFirmwarePath,
sNetId := sNetIdIPC,
iReqEcState := EC_DEVICE_STATE_OP,
eFwUpdateState => eFwUpdateState[I],
);
END_FOR
iUpdateState := 2;
2:
bAnyBusy := FALSE;
bAnyError:= FALSE;
FOR I := 1 TO iNumOfDrives DO
fbFirmwareUpdate[I](
Axis := NcToPlc[I],
eFwUpdateState => eFwUpdateState[I],
sSelectedFirmwareFile => sSelectedFirmwareFile[I],
);
IF NOT fbFirmwareUpdate[I].bBusy THEN
fbFirmwareUpdate[I](bExecute := FALSE, Axis := NcToPlc[I]);
IF fbFirmwareUpdate[I].bError THEN
bAnyError := TRUE;
END_IF
ELSE
bAnyBusy := TRUE;
END_IF
END_FOR
IF NOT bAnyBusy THEN
bExecute := FALSE;
IF NOT bAnyError THEN
iUpdateState := 0; (* OK *)
ELSE
iUpdateState := 0; (* Error *)
END_IF
END_IF
END_CASE