ACE-MQTT-4G gateway: Systeemfuncties

 

In het menu Gateway > MQTT Configuratie kun je bepaalde MQTT-onderwerpen definiëren voor de systeemfuncties.

De 6 voorgedefinieerde functies

• Certificaat bijwerken: Het SSL/TLS-certificaat op afstand bijwerken
• MQTT_Config_Update: De MQTT-configuratie op afstand bijwerken
• Firmware_Update: De firmware op afstand bijwerken
• ACE_PLC_Update: Werk het ACE PLC programma op afstand bij met het bestand dat is gegenereerd door de vBuilder software
• GTW_Parameter_Update: Een MQTT parameter op afstand bijwerken
• ACE_FTP_Upload: Download een bestand van de GTW naar een FTP-server. Hier gaat het om het logbestand.

Voordat je op afstand gaat upgraden, is het sterk aan te raden om lokaal te testen met dezelfde configuratie, tenzij je Gateway dicht bij je werkplek staat!

Algemeen functioneel principe

De nieuwe bestanden waarop de updatre betrekking heeft moeten geïnstalleerd zijn op een remote http server De trigger om de update te starten is een MQTT PUB van een MQTT client De payload van deze PUB bevat de benodigde elementen om de Gateway zichzelf te laten updaten. Misschien afhankelijk van het type update: de http link naar de http server en/of het wachtwoord om het versleutelde zip-bestand uit te pakken en/of alle parameters die nodig zijn om de update te verwerken

Bijwerkproces(sen) : Volg en lees elke stap zorgvuldig!

Certificaat_bijwerken

Op afstand bijwerken van het SSL/TLS-certificaat (ca.crt-bestand)

Met deze systeemfunctie kunt u het SSL/TLS-certificaat op afstand bijwerken door het bestaande certificaat te vervangen door een nieuw certificaat.

Na de update wordt het MQTT-proces opnieuw opgestart.

Het is belangrijk om dezelfde bestandsnaam te gebruiken om er zeker van te zijn dat deze overeenkomt met de bestandsnaam die gedefinieerd is in de MQTT TLS instellingen

• MQTT_Topic_to_Sub_for_Parameter:
  • Degene die je wilt. Voorbeeld: update/ace-gtw-4g/certificat
  • Let op, de gemeenschappelijke prefix en suffix in het tabblad [MQTT Onderwerpen] voor de Modbus-onderwerpen worden niet toegevoegd voor onderwerpen over systeemfuncties: Voeg ze indien nodig toe.
• Voorgedefinieerde_naam_van_de_functie:
  • Moet zijn: Certificaat_bijwerken
• Certificaat bestand
  • Het ca.crt bestand moet in de remote HTTP directory staan
  • Het ca.crt bestand moet gezipt zijn met een wachtwoord.
    • Je kunt de software 7-Zip gebruiken (zie “Hoe gebruik ik de software 7-Zip” onderaan de pagina)
  • Het resultaat moet een ca.crt.zip bestand zijn met daarin je *.crt bestand
  • In het zip-bestand moet de bestandsnaam hetzelfde zijn als de bestandsnaam in de MQTT Broker configuratie (het pad is altijd /etc/luci-uploads)
    
• MQTT Payload die moet worden verzonden vanaf een andere MQTT-client voor het starten van udpate:
  • HTTP-link naar de bestandsmap (niet naar de bestandsnaam!)
    • Voorbeeld: https://www.support.aceautomation.eu/gtw-mqtt-4g/mqtt-files
    • Geen forward slash ” / ” aan het einde van de URL
  • Spatie ( )
  • Wachtwoord tussen enkele aanhalingstekens (‘)
    • Voorbeeld: '6UnJS%#n!3u632^cEs2mgvq'
  • Volledig voorbeeld:
    • https://www.support.aceautomation.eu/gtw-mqtt-4g/mqtt-files '6UnJS%#n!3u632^cEs2mgvq'

MQTT_Config_Update

Met deze systeemfunctie kun je de MQTT-configuratie (mqtt-bestand) op afstand bijwerken door het bestaande bestand te vervangen door een nieuw.

Na de update wordt het MQTT-proces opnieuw opgestart.

Het is belangrijk om je configuratie te controleren om er zeker van te zijn dat deze overeenkomt met alle parameters op afstand. Controleer deze punten:

• De MQTT client ID moet zeker hetzelfde zijn
• Pad van de functies Topics Modbus en Topics: Ze kunnen de MQTT-client-ID bevatten.
• Gemeenschappelijke tag prefix/suffix voor PUBs en SUBs: Deze kunnen de MQTT-client-ID bevatten.

Verwerk het op afstand bijwerken van de MQTT configuratie (mqtt bestand)

• MQTT_Topic_to_Sub_for_Parameter:
  • Degene die je wilt. Voorbeeld: update/ace-gtw-4g/mqtt
  • Let op, de gemeenschappelijke prefix en suffix in het tabblad [MQTT Onderwerpen] voor de Modbus-onderwerpen worden niet toegevoegd voor onderwerpen over systeemfuncties: Voeg ze indien nodig toe.
    
• Voorgedefinieerde_naam_van_de_functie:
  • Moet zijn: MQTT_Config_Update
• MQTT bestand
  • Het mqtt-bestand moet in de HTTP-directory op afstand staan
  • Het formaat moet hetzelfde zijn als in Gateway > MQTT Config File menu: Tekst formaat.
  • De naam moet altijd mqtt zijn (zonder extensie)
  • Het mqtt-bestand moet gezipt zijn met een wachtwoord.
    • Je kunt de software 7-Zip gebruiken (zie “Hoe gebruik ik de software 7-Zip” onderaan de pagina)
  • Het resultaat moet een mqtt.zip bestand zijn met daarin het mqtt bestand
  • De naam moet altijd“mqtt” zijn
• MQTT Payload die moet worden verzonden vanaf een andere MQTT-cliënt om udpate te starten:
  • HTTP-link naar de bestandsdirectory (niet naar de bestandsnaam!)
    • Voorbeeld: https://www.support.aceautomation.eu/gtw-mqtt-4g/mqtt-files
    • Geen forward slash ” / ” aan het einde van de URL
  • Spatie ( )
  • Wachtwoord tussen enkele aanhalingstekens (‘)
    • Voorbeeld: '6UnJS%#n!3u632^cEs2mgvq'
  • Volledig voorbeeld:
    • https://www.support.aceautomation.eu/gtw-mqtt-4g/mqtt-files '6UnJS%#n!3u632^cEs2mgvq'

Firmware-update

Verwerk de update op afstand van de ACE-GTW-4G firmware (firmware.bin en sha256sums bestanden)

• MQTT_Topic_to_Sub_for_Parameter:
  • Degene die je wilt. Voorbeeld: update/ace-gtw-4g/firmware
  • Opgelet, de gemeenschappelijke prefix en suffix in het tabblad [MQTT Onderwerpen] voor de Modbus-onderwerpen worden niet toegevoegd voor onderwerpen over systeemfuncties: Voeg ze indien nodig toe.
    
• Voorgedefinieerde_naam_van_de_functie:
  • Moet zijn: Firmware_Update
• Firmware bestand
  • De firmware- en sha256sums-bestanden moeten in de HTTP-directory op afstand staan
  • De bestandsnamen moeten altijd firmware.bin en sha256sums zijn
  • firmware.bin moet compatibel zijn met de ACE-GTW-4G Gateway (test het voor de update op afstand!)
  • sha256sums moet deze tekst bevatten:
    • serial-sha-256-key */tmp/firmware.bin
    • Example: d61eeb18eedbfe8ebe56991f3424a9c52c33b0bc0dd0f8e1e05556c3fc541ee1 */tmp/firmware.bin
    • Met een carriage return (CR) aan het einde van de regel ([Enter])
    • Het sleutelnummer is afhankelijk van het firmwarebestand
    • Dit bestand wordt meegeleverd met de firmware (vraag het ons indien nodig)
  • Het resultaat moet firmware.bin en sha256sums bestanden zijn in de HTTP-directory op afstand (niet gezipt)
• MQTT Payload die moet worden verzonden vanaf een andere MQTT-client voor start udpate:
  • HTTP-link naar de bestandsdirectory (niet naar de bestandsnaam!)
    • Voorbeeld: https://www.support.aceautomation.eu/gtw-mqtt-4g/firmware-files
    • Geen forward slash ” / ” aan het einde van de URL

ACE_PLC_Update

Verwerk de update op afstand van het ACE PLC-programma (aceprogram.vCompiled bestand)

• MQTT_Topic_to_Sub_for_Parameter:
  • Degene die je wilt. Voorbeeld: update/ace-gtw-4g/plc-programma
  • Opgelet, de gemeenschappelijke prefix en suffix in het tabblad [MQTT Onderwerpen] voor de Modbus-onderwerpen worden niet toegevoegd voor onderwerpen over systeemfuncties: Voeg ze indien nodig toe.
    
• Voorgedefinieerde_naam_van_de_functie:
  • Moet zijn: ACE_PLC_Update
• ACE programmabestand
  • Het ACE programmabestand moet in de externe HTTP directory staan
  • Het formaat moet zijn:
    • .vCompiled zijn. Zie in vBuilder, menu Extra > Programma naar bestand
    • De naam moet altijd aceprogram.vCompiled zijn
  • Het bestand “aceprogram.vCompiled” moet worden gezipt met een wachtwoord.
    • Je kunt de software 7-Zip gebruiken (zie “Hoe gebruik ik de software 7-Zip” onderaan de pagina)
  • Het resultaat moet altijd een aceprogram.zip bestand zijn met daarin het bestand aceprogram.vCompiled
• MQTT Payload die moet worden verzonden vanaf een andere MQTT-client om udpate te starten:
  • HTTP-link naar de bestandsdirectory (niet naar de bestandsnaam!)
    • Voorbeeld: https://www.support.aceautomation.eu/gtw-mqtt-4g/ace-files
    • Geen forward slash ” / ” aan het einde van de URL
  • Spatie ( )
  • Wachtwoord tussen enkele aanhalingstekens (‘)
    • Voorbeeld: '6UnJS%#n!3u632^cEs2mgvq'
  • Volledig voorbeeld:
    • https://www.support.aceautomation.eu/gtw-mqtt-4g/ace-files '6UnJS%#n!3u632^cEs2mgvq'

Het MQTT-proces wordt gestopt terwijl het ACE-programma wordt bijgewerkt, daarna wordt alles opnieuw gestart (MQTT-proces en ACE PLC-programma)

GTW_parameter_bijwerken

Met deze systeemfunctie kun je op afstand een parameter van de MQTT-configuratie (mqtt-bestand) bijwerken door de bestaande parameter te vervangen door een nieuwe.

Na de update wordt het MQTT-proces opnieuw opgestart.

Het is belangrijk om de parameter die je wilt bijwerken te controleren. Anders kun je met een verkeerde parameter geen toegang meer krijgen tot je gateway

Verwerk de remote update van een MQTT-parameter (mqtt-bestand) MQTT_Topic_to_Sub_for_Parameter: Degene die je wilt. Voorbeeld: update/ace-gtw-4g/parameter Voorgedefinieerde_naam_van_de_functie: Moet zijn: GTW_Parameter_Update Je moet weten : ( 1 ) de naam van de sectie (mqttconfig of topics of systopics of…) De index van deze sectie die begint bij 0. ( 2 ) de naam van de betreffende optie (projectname) ( 3 ) de nieuwe gewenste waarde voor deze parameter MQTT Payload die moet worden verzonden vanaf een andere MQTT-cliënt voor start udpate: De Payload voor het Topics systeem zal worden samengesteld met: mqtt.@section[index].option ‘value‘ Voorbeeld: mqtt.@mqttconfig[0].projectname 'Mijn nieuwe projectnaam' Voor meerdere secties (topics of systopics of…) met dezelfde naam, moet je de juiste index opgeven, wat betekent dat je de positie in het MQTT-bestand moet weten. Voorbeeld voor het wijzigen van de slaveid van de 2e topics, van 1 naar 5: mqtt.@topics[1].slaveid '5'

ACE_FTP_Opladen

Download een bestand van de GTW naar een FTP-server. Hier gaat het om het logbestand.

• MQTT_Topic_to_Sub_for_Parameter:
  • De gewenste. Voorbeeld: update/ace-gtw-4g/ftp-log
  • Let op, het gemeenschappelijke voor- en achtervoegsel in het tabblad [MQTT Onderwerpen] voor de Modbus-onderwerpen worden niet toegevoegd voor onderwerpen over systeemfuncties: Voeg ze indien nodig toe.
    
• Voorgedefinieerde_naam_van_de_functie:
  • Moet zijn: ACE_FTP_Upload
• FTP-server
  
  • Je moet een FTP-server installeren of al beschikbaar hebben, met zijn
    • ftp-adres
    • ftp gebruiker login
    • ftp gebruikerswachtwoord
• MQTT payload te versturen door een andere MQTT client om logbestanden te ontvangen op je FTP server
  • log FTP_file_directory “gebruikersnaam:wachtwoord”
    
    • Voorbeeld: log ftp://ftp.myftplink.eu/ "mylogin:mypassword"

      • Bij elke PUBlicatie stuurt de GTW zijn logbestand naar de FTP-server
      • log betekent logbestand. Andere bestandsnamen zullen later beschikbaar zijn.

Hulp bij het oplossen van problemen

• Als je spatie(s) hebt in je http-link, voeg dan een citaat toe en/of vervang de spatie door
  • 'https://www.support.aceautomation.eu/gtw-mqtt-4g/ace bestanden' '6UnJS%#n!3u632^cEs2mgvq'
  • De quote moet zijn zoals in het voorbeeld hierboven, niet zoals ‘ of ” (knippen/plakken verandert vaak het type quote)
• Wees voorzichtig om de volledige link toe te voegen met http://www… of https://www…
• De namen van de bestanden zijn opgelegd
  • Voor het .zip-bestand
  • en de bestanden in het zipbestand
• Controleer de synthaxe van je Topic naam wanneer je de Payload verstuurt vanuit je MQTT Client
  • Gemeenschappelijke tag voor- en achtervoegsels worden niet toegevoegd voor deze systeemfuncties
• Bestanden moeten worden geïnstalleerd op een HTTP- of HTTPS-server
• Gebruik altijd een wachtwoord voor de zip-bestanden
• Geen forward slash ” / ” aan het einde van de URL (indien aanwezig)

Hoe gebruik je 7-Zip software

• Archief formaat: zip met de juiste bestandsnaam
• Wachtwoord invoeren