Wie können wir helfen?

Print

ACE-MQTT-4G-Gateway: Systemfunktionen

 

Im Menü Gateway > MQTT-Konfiguration können Sie bestimmte MQTT-Themen für die Systemfunktionen definieren.

Die 6 vordefinierten Funktionen

  • Zertifikat_Update: Aktualisieren des SSL/TLS-Zertifikats aus der Ferne
  • MQTT_Config_Update: Aktualisierung der MQTT-Konfiguration aus der Ferne
  • Firmware_Update: Aktualisieren der Firmware aus der Ferne
  • ACE_PLC_Update: Fernaktualisierung des ACE PLC-Programms mit der von der vBuilder-Software erzeugten Datei
  • GTW_Parameter_Update: Aktualisieren eines MQTT-Parameters aus der Ferne
  • ACE_FTP_Hochladen: Herunterladen einer Datei vom GTW auf einen FTP-Server. Hierbei handelt es sich um die Logdatei.

Vor einer Fernaktualisierung wird dringend empfohlen, einen lokalen Test mit der gleichen Konfiguration durchzuführen, es sei denn, Ihr Gateway befindet sich in der Nähe Ihres Arbeitsplatzes!

Allgemeines Funktionsprinzip

  • Die von der Aktualisierung betroffenen neuen Dateien müssen auf einem entfernten http-Server installiert werden
  • Der Auslöser für die Aktualisierung ist ein MQTT-PUB von einem MQTT-Client
  • Die Payload dieses PUBs enthält die notwendigen Elemente, damit das Gateway sich selbst aktualisieren kann. Möglicherweise abhängig von der Art der Aktualisierung:
    • den http-Link zum http-Server
    • und/oder das Passwort zum Dekomprimieren der verschlüsselten Zip-Datei
    • und/oder alle für die Verarbeitung der Aktualisierung erforderlichen Parameter

Aktualisierungsprozess(e) : Befolgen und lesen Sie jeden Schritt sorgfältig!

Zertifikat_Aktualisierung

Fernaktualisierung des SSL/TLS-Zertifikats (ca.crt-Datei)

Mit dieser Systemfunktion können Sie das SSL/TLS-Zertifikat aus der Ferne aktualisieren, indem Sie das vorhandene Zertifikat durch ein neues ersetzen.

Nach der Aktualisierung wird ein Neustart des MQTT-Prozesses durchgeführt.

Es ist wichtig, denselben Dateinamen zu verwenden, um sicherzustellen, dass er mit dem in den MQTT-TLS-Einstellungen definierten Dateinamen übereinstimmt

  • MQTT_Topic_to_Sub_for_Parameter:
    • Derjenige, den Sie wollen. Beispiel: update/ace-gtw-4g/certificat
    • Achtung, das gemeinsame Präfix und Suffix in der Registerkarte [MQTT-Themen] für die Modbus-Themen werden nicht für Systemfunktionsthemen hinzugefügt: Fügen Sie sie bei Bedarf hinzu.
  • Vordefinierter_Name_der_Funktion:
    • Muss sein: Zertifikat_Aktualisierung
  • Zertifikatsdatei
    • Die Datei ca.crt muss sich im HTTP-Verzeichnis der Gegenstelle befinden
    • Die Datei ca.crt muss mit einem Passwort komprimiert sein.
      • Sie können die Software 7-Zip verwenden (siehe „So verwenden Sie die Software 7-Zip“ am Ende der Seite)
    • Das Ergebnis muss die Datei ca.crt.zip sein, in der sich Ihre *.crt-Datei befindet
    • Der Dateiname innerhalb der Zip-Datei muss mit dem in der MQTT-Broker-Konfiguration definierten Dateinamen übereinstimmen (der Pfad ist immer /etc/luci-uploads)
  • MQTT-Payload, der von einem anderen MQTT-Client zum Start von udpate gesendet werden soll:
    • HTTP-Link auf das Dateiverzeichnis (nicht auf den Dateinamen!)
      • Beispiel: https://www.support.aceautomation.eu/gtw-mqtt-4g/mqtt-files
      • Kein Schrägstrich “ / “ am Ende der URL
    • Leerzeichen ( )
    • Passwort mit einfachen Anführungszeichen (‚)
      • Beispiel: '6UnJS%#n!3u632^cEs2mgvq'
    • Vollständiges Beispiel:
      • https://www.support.aceautomation.eu/gtw-mqtt-4g/mqtt-files '6UnJS%#n!3u632^cEs2mgvq'

MQTT_Config_Update

Mit dieser Systemfunktion können Sie die MQTT-Konfiguration (mqtt-Datei) aus der Ferne aktualisieren, indem Sie die vorhandene Datei durch eine neue ersetzen.

Nach der Aktualisierung wird ein Neustart des MQTT-Prozesses durchgeführt.

Es ist wichtig, dass Sie Ihre Konfiguration überprüfen, um sicherzustellen, dass sie mit allen Remote-Parametern übereinstimmt. Überprüfen Sie diese Punkte:

  • Die ID des MQTT-Clients muss unbedingt identisch sein
  • Pfad der Topics Modbus und Topics Funktionen: Sie können die ID des MQTT-Clients enthalten.
  • Gemeinsamer Tag-Präfix/Suffix für PUBs und SUBs: Sie können die ID des MQTT-Clients enthalten.

Verarbeitung der Fernaktualisierung der MQTT-Konfiguration (mqtt-Datei)

  • MQTT_Topic_to_Sub_for_Parameter:
    • Der von Ihnen gewünschte. Beispiel: update/ace-gtw-4g/mqtt
    • Achtung, das gemeinsame Präfix und Suffix auf der Registerkarte [MQTT-Themen] für die Modbus-Themen werden nicht für Systemfunktionsthemen hinzugefügt: Fügen Sie sie bei Bedarf hinzu.
  • Vordefinierter_Name_der_Funktion:
    • Muss sein: MQTT_Config_Update
  • MQTT-Datei
    • Die mqtt-Datei muss sich im entfernten HTTP-Verzeichnis befinden
    • Das Format muss das gleiche sein wie im Menü Gateway > MQTT-Konfigurationsdatei: Textformat.
    • Der Name muss immer mqtt (ohne Erweiterung) lauten
    • Die mqtt-Datei muss mit einem Passwort gepackt sein.
      • Sie können die Software 7-Zip verwenden (siehe „So verwenden Sie die Software 7-Zip“ am Ende der Seite)
    • Das Ergebnis muss eine mqtt.zip-Datei sein, die eine mqtt-Datei enthält
    • Ihr Name muss immer„mqtt“ lauten
  • MQTT-Payload, der von einem anderen MQTT-Client für den Start von udpate gesendet wird :
    • HTTP-Link auf das Dateiverzeichnis (nicht auf den Dateinamen!)
      • Beispiel: https://www.support.aceautomation.eu/gtw-mqtt-4g/mqtt-files
      • Kein Schrägstrich “ / “ am Ende der URL
    • Leerzeichen ( )
    • Passwort mit einfachen Anführungszeichen (‚)
      • Beispiel: '6UnJS%#n!3u632^cEs2mgvq'
    • Vollständiges Beispiel:
      • https://www.support.aceautomation.eu/gtw-mqtt-4g/mqtt-files '6UnJS%#n!3u632^cEs2mgvq'

Firmware_Update

Verarbeitet die Fernaktualisierung der ACE-GTW-4G-Firmware (firmware.bin und sha256sums-Dateien)

  • MQTT_Topic_to_Sub_for_Parameter:
    • Der von Ihnen gewünschte. Beispiel: update/ace-gtw-4g/firmware
    • Achtung, das gemeinsame Präfix und Suffix in der Registerkarte [MQTT-Themen] für die Modbus-Themen werden nicht für Systemfunktionsthemen hinzugefügt: Fügen Sie sie bei Bedarf hinzu.
  • Vordefinierter_Name_der_Funktion:
    • Muss sein: Firmware_Update
  • Firmware-Datei
    • Die Dateien firmware und sha256sums müssen sich im HTTP-Verzeichnis der Gegenstelle befinden
    • Ihre Dateinamen sollten immer firmware.bin und sha256sums lauten
    • firmware.bin muss mit dem ACE-GTW-4G Gateway kompatibel sein (vor der Fernaktualisierung testen!)
    • sha256sums muss diesen Text enthalten:
      • serial-sha-256-key */tmp/firmware.bin
      • Example: d61eeb18eedbfe8ebe56991f3424a9c52c33b0bc0dd0f8e1e05556c3fc541ee1 */tmp/firmware.bin
      • Mit einem Wagenrücklauf (CR) am Ende der Zeile ([Enter])
      • Die Schlüsselnummer hängt von der Firmware-Datei ab
      • Diese Datei wird mit der Firmware geliefert (fragen Sie uns bei Bedarf)
    • Das Ergebnis müssen die Dateien firmware.bin und sha256sums im entfernten HTTP-Verzeichnis sein (nicht gezippt)
  • MQTT-Payload, der von einem anderen MQTT-Client für den Start von udpate gesendet werden muss:
    • HTTP-Link auf das Dateiverzeichnis (nicht auf den Dateinamen!)
      • Beispiel: https://www.support.aceautomation.eu/gtw-mqtt-4g/firmware-files
      • Kein Schrägstrich “ / “ am Ende der URL

ACE_PLC_Update

Verarbeitet die Fernaktualisierung des ACE-SPS-Programms (Datei aceprogram.vCompiled)

  • MQTT_Topic_to_Sub_for_Parameter:
    • Der von Ihnen gewünschte. Beispiel: update/ace-gtw-4g/plc-program
    • Achtung, das gemeinsame Präfix und Suffix in der Registerkarte [MQTT-Themen] für die Modbus-Themen werden nicht für Systemfunktionsthemen hinzugefügt: Fügen Sie sie bei Bedarf hinzu.
  • Vordefinierter_Name_der_Funktion:
    • Muss sein: ACE_PLC_Update
  • ACE-Programmdatei
    • Die ACE-Programmdatei muss sich im entfernten HTTP-Verzeichnis befinden
    • Das Format muss sein:
      • .vCompiled. Siehe in vBuilder, Menü Tools > Program To File
      • Ihr Name muss immer aceprogram.vCompiled lauten
    • Die Datei „aceprogram.vCompiled“ muss mit einem Passwort gezippt werden.
      • Sie können die Software 7-Zip verwenden (siehe „So verwenden Sie die Software 7-Zip“ am Ende der Seite)
    • Das Ergebnis muss immer die Datei aceprogram.zip mit der darin enthaltenen Datei aceprogram.vCompiled sein
  • MQTT-Payload, der von einem anderen MQTT-Client gesendet werden soll, um ein UDP zu starten:
    • HTTP-Link auf das Dateiverzeichnis (nicht auf den Dateinamen!)
      • Beispiel: https://www.support.aceautomation.eu/gtw-mqtt-4g/ace-files
      • Kein Schrägstrich “ / “ am Ende der URL
    • Leerzeichen ( )
    • Passwort mit einfachen Anführungszeichen (‚)
      • Beispiel: '6UnJS%#n!3u632^cEs2mgvq'
    • Vollständiges Beispiel:
      • https://www.support.aceautomation.eu/gtw-mqtt-4g/ace-files '6UnJS%#n!3u632^cEs2mgvq'

Der MQTT-Prozess wird angehalten, während das ACE-Programm aktualisiert wird, dann wird das Ganze neu gestartet (MQTT-Prozess und ACE PLC-Programm)

GTW_Parameter_Aktualisierung

Mit dieser Systemfunktion können Sie einen Parameter der MQTT-Konfiguration (mqtt-Datei) aus der Ferne aktualisieren, indem Sie den vorhandenen Parameter durch einen neuen ersetzen.

Nach der Aktualisierung wird ein Neustart des MQTT-Prozesses durchgeführt.

Es ist wichtig, dass Sie den Parameter, den Sie aktualisieren möchten, überprüfen. Andernfalls können Sie mit einem falschen Parameter keinen Zugang mehr zu Ihrem Gateway haben

Prozess der Fernaktualisierung eines MQTT-Parameters (mqtt-Datei)

  • MQTT_Topic_to_Sub_for_Parameter:
    • Der gewünschte. Beispiel: update/ace-gtw-4g/parameter
  • Vordefinierter_Name_der_Funktion:
    • Muss sein: GTW_Parameter_Aktualisierung
  • Das müssen Sie wissen:
    • ( 1 ) den Namen der Sektion (mqttconfig oder topics oder systopics oder..)
    • Den Index dieses Abschnitts, der bei 0 beginnt.
    • ( 2 ) den Namen der betreffenden Option (projectname)
    • ( 3 ) den neuen gewünschten Wert für diesen Parameter
  • MQTT-Payload, der von einem anderen MQTT-Client für das Start-Udpate gesendet werden soll :
    • Der Payload für das Topics-System wird mit zusammengesetzt:
      • mqtt.@section[index].option ‚value‚
      • Beispiel:
        • mqtt.@mqttconfig[0].projectname 'Mein neuer Projektname'
    • Für mehrere Abschnitte (Topics oder Systopics oder..) mit demselben Namen müssen Sie den richtigen Index angeben, d.h. Sie müssen die Position in der MQTT-Datei kennen.
      • Beispiel für die Änderung der Slaveid des 2. Topics, von 1 bis 5:
        • mqtt.@topics[1].slaveid '5'

ACE_FTP_Hochladen

Download einer Datei vom GTW auf einen FTP-Server. Hierbei handelt es sich um die Logdatei.

  • MQTT_Topic_to_Sub_for_Parameter:
    • Derjenige, den Sie wünschen. Beispiel: update/ace-gtw-4g/ftp-log
    • Achtung, das gemeinsame Präfix und Suffix in der Registerkarte [MQTT-Themen] für die Modbus-Themen werden nicht für Systemfunktionsthemen hinzugefügt: Fügen Sie sie bei Bedarf hinzu.
  • Vordefinierter_Name_der_Funktion:
    • Muss sein: ACE_FTP_Upload
  • FTP-Server

    • Sie müssen einen FTP-Server installieren oder bereits über einen solchen verfügen, mit seinem
      • ftp-Adresse
      • ftp-Benutzer-Login
      • ftp-Benutzer-Passwort
  • MQTT-Nutzdaten, die von einem anderen MQTT-Client gesendet werden, um Protokolldateien auf Ihrem FTP-Server zu empfangen
    • log FTP_file_directory „benutzername:passwort“

      • Beispiel: log ftp://ftp.myftplink.eu/ "mylogin:mypassword"
        • Bei jeder PUBlication sendet der GTW seine Logdatei an den FTP-Server
        • log, bedeutet Protokolldatei. Andere Dateinamen werden zu einem späteren Zeitpunkt verfügbar sein.

Hilfe bei der Lösung aufgetretener Probleme

  • Wenn Sie Leerzeichen in Ihrem http-Link haben, fügen Sie Anführungszeichen ein und/oder ersetzen Sie Leerzeichen durch
    • 'https://www.support.aceautomation.eu/gtw-mqtt-4g/ace Dateien' '6UnJS%#n!3u632^cEs2mgvq'
    • Das Anführungszeichen sollte wie im obigen Beispiel sein, nicht wie ‚ oder “ (Ausschneiden/Einfügen ändert oft die Art des Anführungszeichens)
  • Achten Sie darauf, den vollständigen Link mit http://www… oder https://www… anzugeben.
  • Die Namen der Dateien sind vorgeschrieben
    • Für die .zip-Datei
    • und die Dateien innerhalb der Zip-Datei
  • Überprüfen Sie die Synthaxe Ihres Topic-Namens, wenn Sie die Payload von Ihrem MQTT-Client senden
    • Gemeinsame Tag-Präfixe und Suffixe werden für diese Systemfunktionennicht hinzugefügt
  • Die Dateien müssen auf einem HTTP- oder HTTPS-Server installiert werden
  • Verwenden Sie immer ein Passwort für die Zip-Dateien
  • Kein Schrägstrich “ / “ am Ende der URL (falls vorhanden)

So verwenden Sie die 7-Zip-Software

  • Archivformat: zip mit dem richtigen Dateinamen
  • Ein Passwort eingeben