FB_SoEAX5000FirmwareUpdate

FB_SoEAX5000FirmwareUpdate 1:

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:

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:

  • Die SPS und TwinCAT dürfen nicht gestoppt werden.
  • Die EtherCAT-Verbindung darf nicht unterbrochen werden.
  • Der AX5000 darf nicht ausgeschaltet werden.

FB_SoEAX5000FirmwareUpdate 2: 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

NetId

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:

  • "v1.05_b0009"    für ein spezifisches Build, z. B. v1.05 Build 0009
  • "v1.05_b00??"    aktuellstes Build einer vorgegebenen Version, z. B. v1.05
  • "v1.??_b00??"    aktuellstes Build einer vorgegebenen Hauptversion, z. B. v1
  • "v?.??_b00??"    aktuellstes Build der aktuellsten Version
  • " "            aktuellstes Build der aktuellsten Version

Kundenspezifische Firmware-Builds:

  • "v1.05_b1009"    für ein spezifisches Build, z. B. v1.05 Build 0009
  • "v1.05_b10??"    aktuellstes Build einer vorgegebenen Version, z. B. v1.05
  • "v1.??_b10??"    aktuellstes Build einer vorgegebenen Hauptversion, z. B. v1
  • "v?.??_b10??"    aktuellstes Build der aktuellsten Version

...

  • "v1.05_b8909"    für ein spezifisches Build, z. B. v1.05 Build 8909
  • "v1.05_b89??"    aktuellstes Build einer vorgegebenen Version, z. B. v1.05
  • "v1.??_b89??"    aktuellstes Build einer vorgegebenen Hauptversion, z. B. v1
  • "v?.??_b89??"    aktuellstes Build der aktuellsten Version

Debug-Builds:

  • "v1.05_b9009"    für ein spezifisches Build, z. B. v1.05 Build 9009
  • "v1.05_b90??"    aktuellstes Build einer vorgegebenen Version, z. B. v1.05
  • "v1.??_b90??"    aktuellstes Build einer vorgegebenen Hauptversion, z. B. v1
  • "v?.??_b90??"    aktuellstes Build der aktuellsten Version

 

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 das Firmware-Update bei großen EtherCAT-Netzwerken länger dauern kann, wird hier nur der Timeout für einzelne interne ADS-Instanzen vorgegeben.

FB_SoEAX5000FirmwareUpdate 3: Ein-/Ausgänge

VAR_IN_OUT
   Axis : AXIS_REF;
END_VAR

Name

Typ

Beschreibung

Axis

AXIS_REF

Achsdatenstruktur, welche eine Achse eindeutig im System adressiert. Sie enthält unter anderem den aktuellen Status der Achse, wie Position, Geschwindigkeit oder Fehlerzustand.

FB_SoEAX5000FirmwareUpdate 4: 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

Busy

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;
    Axes                  : ARRAY [1..iNumOfDrives] OF 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             := Axes[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                  := Axes[I],
        eFwUpdateState        => eFwUpdateState[I],
        sSelectedFirmwareFile => sSelectedFirmwareFile[I],
      );
      IF NOT fbFirmwareUpdate[I].bBusy THEN
        fbFirmwareUpdate[I](bExecute := FALSE, Axis := Axes[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

Voraussetzungen

Entwicklungsumgebung

Zielplattformtyp

SPS Bibliotheken

AX5000 Firmware

TwinCAT 3

PC oder CX (x86 oder x64)

Tc2_MC2_Drive

≥v1.00 b0001