Come possiamo aiutarti?

Print

Gateway ACE-MQTT-4G: Funzioni di sistema

 

Nel menu Gateway > Configurazione MQTT è possibile definire alcuni argomenti MQTT per le funzioni del sistema.

Le 6 funzioni predefinite

  • Certificato_Aggiornamento: Aggiornare da remoto il certificato SSL/TLS
  • MQTT_Config_Update: Aggiorna da remoto la configurazione MQTT
  • Firmware_Update: Aggiornamento remoto del firmware
  • ACE_PLC_Update: Aggiorna da remoto il programma ACE PLC con il file generato dal software vBuilder
  • GTW_Parameter_Update: Aggiornamento remoto di un parametro MQTT
  • ACE_FTP_Upload: Scarica un file dal GTW a un server FTP. In questo caso si tratta del file di log.

Prima di effettuare l’aggiornamento da remoto, si consiglia vivamente di eseguire un test in locale con la stessa configurazione, a meno che il gateway non sia vicino al luogo di lavoro!

Principio funzionale generale

  • I nuovi file interessati dall’aggiornamento devono essere installati su un server http remoto
  • Il trigger per lanciare l’aggiornamento è un PUB MQTT da un client MQTT
  • Il payload di questo PUB contiene gli elementi necessari per consentire al gateway di aggiornarsi. Forse a seconda del tipo di aggiornamento:
    • il link http al server http
    • e/o la password per decomprimere il file zip criptato
    • e/o tutti i parametri necessari per elaborare l’aggiornamento

Processo(i) di aggiornamento: Seguire e leggere attentamente ogni passaggio!

Certificato_Aggiornamento

Aggiornamento remoto del certificato SSL/TLS (file ca.crt)

Questa funzione di sistema consente di aggiornare da remoto il certificato SSL/TLS sostituendo il certificato esistente con uno nuovo.

Dopo l’aggiornamento verrà eseguito un riavvio del processo MQTT.

È importante utilizzare lo stesso nome di file per assicurarsi che corrisponda al nome del file definito nelle impostazioni MQTT TLS

  • MQTT_Topic_to_Sub_for_Parameter:
    • Quello desiderato. Esempio: update/ace-gtw-4g/certificat
    • Attenzione, il prefisso e il suffisso comuni nella scheda [Argomenti MQTT] per gli argomenti Modbus non vengono aggiunti agli argomenti delle funzioni di sistema: Aggiungerli se necessario.
  • Nome_predefinito_della_funzione:
    • Deve essere: Certificato_Aggiornamento
  • File del certificato
    • Il file ca.crt deve trovarsi nella directory HTTP remota
    • Il file ca.crt deve essere zippato con una password.
      • È possibile utilizzare il software 7-Zip (vedere “Come utilizzare il software 7-Zip” in fondo alla pagina)
    • Il risultato deve essere un file ca.crt.zip con all’interno il file *.crt
    • All’interno del file zip, il nome del file deve essere uguale a quello definito nella configurazione del broker MQTT (il percorso è sempre /etc/luci-uploads)
  • Payload MQTT da inviare da un altro client MQTT per l’udpate iniziale:
    • Link HTTP alla directory del file (non al nome del file!)
      • Esempio: https://www.support.aceautomation.eu/gtw-mqtt-4g/mqtt-files
      • Nessuna barra di avanzamento ” / ” alla fine dell’URL
    • Spazio ( )
    • Password con virgolette singole (‘)
      • Esempio: '6UnJS%#n!3u632^cEs2mgvq'
    • Esempio completo:
      • https://www.support.aceautomation.eu/gtw-mqtt-4g/mqtt-files '6UnJS%#n!3u632^cEs2mgvq'

MQTT_Config_Update

Questa funzione di sistema consente di aggiornare da remoto la configurazione MQTT (file mqtt) sostituendo il file esistente con uno nuovo.

Dopo l’aggiornamento verrà eseguito un riavvio del processo MQTT.

È importante controllare la propria configurazione per verificare che corrisponda a tutti i parametri remoti. Controllare questi punti:

  • L’ID del client MQTT deve essere sicuramente lo stesso
  • Percorso delle funzioni Topics Modbus e Topics: Possono includere l’ID del client MQTT.
  • Prefisso/suffisso comune dei tag per PUB e SUB: Possono includere l’ID del client MQTT.

Elaborare l’aggiornamento remoto della configurazione MQTT (file mqtt)

  • MQTT_Topic_to_Sub_for_Parameter:
    • Quello desiderato. Esempio: update/ace-gtw-4g/mqtt
    • Attenzione, il prefisso e il suffisso comuni nella scheda [Argomenti MQTT] per gli argomenti Modbus non vengono aggiunti per gli argomenti delle funzioni di sistema: Aggiungerli se necessario.
  • Nome_predefinito_della_funzione:
    • Deve essere: MQTT_Config_Update
  • File MQTT
    • Il file mqtt deve trovarsi nella directory HTTP remota
    • Il formato deve essere lo stesso del menu Gateway > File di configurazione MQTT: Formato testo.
    • Il suo nome deve essere sempre mqtt (senza estensioni)
    • Il file mqtt deve essere zippato con una password.
      • È possibile utilizzare il software 7-Zip (vedere “Come utilizzare il software 7-Zip” in fondo alla pagina)
    • Il risultato deve essere un file mqtt.zip con all’interno il file mqtt
    • Il suo nome deve essere sempre“mqtt“
  • Payload MQTT da inviare da un altro client MQTT per l’udpate iniziale:
    • Link HTTP alla directory del file (non al nome del file!)
      • Esempio: https://www.support.aceautomation.eu/gtw-mqtt-4g/mqtt-files
      • Nessuna barra di avanzamento ” / ” alla fine dell’URL
    • Spazio ( )
    • Password con virgolette singole (‘)
      • Esempio: '6UnJS%#n!3u632^cEs2mgvq'
    • Esempio completo:
      • https://www.support.aceautomation.eu/gtw-mqtt-4g/mqtt-files '6UnJS%#n!3u632^cEs2mgvq'

Aggiornamento firmware

Elabora l’aggiornamento remoto del firmware di ACE-GTW-4G (file firmware.bin e sha256sums)

  • MQTT_Topic_to_Sub_for_Parameter:
    • Quello desiderato. Esempio: update/ace-gtw-4g/firmware
    • Attenzione, il prefisso e il suffisso comuni nella scheda [Argomenti MQTT] per gli argomenti Modbus non vengono aggiunti per gli argomenti delle funzioni di sistema: Aggiungerli se necessario.
  • Nome_predefinito_della_funzione:
    • Deve essere: Aggiornamento_Firmware
  • File del firmware
    • I file firmware e sha256sums devono trovarsi nella directory HTTP remota
    • I nomi dei file devono essere sempre firmware.bin e sha256sums
    • firmware.bin deve essere compatibile con il gateway ACE-GTW-4G (testarlo prima dell’aggiornamento remoto)
    • sha256sums deve contenere questo testo:
      • serial-sha-256-key */tmp/firmware.bin
      • Example: d61eeb18eedbfe8ebe56991f3424a9c52c33b0bc0dd0f8e1e05556c3fc541ee1 */tmp/firmware.bin
      • Con un ritorno a capo (CR) alla fine della riga ([Invio])
      • Il numero di chiave dipende dal file del firmware
      • Questo file è fornito con il firmware (se necessario, chiedetecelo)
    • Il risultato deve essere costituito dai file firmware.bin e sha256sums all’interno della directory HTTP remota (non zippati)
  • Payload MQTT da inviare da un altro client MQTT per l’udpate iniziale:
    • Link HTTP alla directory dei file (non al nome del file!)
      • Esempio: https://www.support.aceautomation.eu/gtw-mqtt-4g/firmware-files
      • Nessuna barra di avanzamento ” / ” alla fine dell’URL

Aggiornamento ACE_PLC

Elabora l’aggiornamento remoto del programma PLC ACE (file aceprogram.vCompilato)

  • MQTT_Topic_to_Sub_for_Parameter:
    • Quello desiderato. Esempio: update/ace-gtw-4g/plc-programma
    • Attenzione, il prefisso e il suffisso comuni nella scheda [Argomenti MQTT] per gli argomenti Modbus non vengono aggiunti agli argomenti delle funzioni di sistema: Aggiungerli se necessario.
  • Nome_predefinito_della_funzione:
    • Deve essere: ACE_PLC_Update
  • File di programma ACE
    • Il file di programma ACE deve trovarsi nella directory HTTP remota
    • Il formato deve essere:
      • .vCompiled. Vedere in vBuilder, menu Strumenti > Programma su file
      • Il suo nome deve essere sempre aceprogramma.vCompilato
    • Il file “aceprogram.vCompiled” deve essere zippato con una password.
      • È possibile utilizzare il software 7-Zip (vedere “Come utilizzare il software 7-Zip” in fondo alla pagina)
    • Il risultato deve essere sempre un file aceprogram.zip con all’interno il file aceprogram.vCompiled
  • Payload MQTT da inviare da un altro client MQTT per l’udpate iniziale:
    • Link HTTP alla directory del file (non al nome del file!)
      • Esempio: https://www.support.aceautomation.eu/gtw-mqtt-4g/ace-files
      • Nessuna barra di avanzamento ” / ” alla fine dell’URL
    • Spazio ( )
    • Password con virgolette singole (‘)
      • Esempio: '6UnJS%#n!3u632^cEs2mgvq'
    • Esempio completo:
      • https://www.support.aceautomation.eu/gtw-mqtt-4g/ace-files '6UnJS%#n!3u632^cEs2mgvq'

Il processo MQTT viene interrotto durante l’aggiornamento del programma ACE, quindi l’intero processo viene riavviato (processo MQTT e programma PLC ACE)

GTW_Parametro_Aggiornamento

Questa funzione di sistema consente di aggiornare da remoto un parametro della configurazione MQTT (file mqtt) sostituendo il parametro esistente con uno nuovo.

Dopo l’aggiornamento verrà eseguito un riavvio del processo MQTT.

È importante controllare il parametro che si desidera aggiornare. Altrimenti, con un parametro errato, non sarà più possibile accedere al Gateway

Elaborazione dell’aggiornamento remoto di un parametro MQTT (file mqtt)

  • MQTT_Topic_to_Sub_for_Parameter:
    • Quello desiderato. Esempio: update/ace-gtw-4g/parametro
  • Nome_predefinito_della_funzione:
    • Deve essere: GTW_Parameter_Update
  • È necessario sapere :
    • ( 1 ) il nome della sezione (mqttconfig o topics o systopics o..)
    • L’indice della sezione, che parte da 0.
    • ( 2 ) il nome dell’opzione interessata (projectname)
    • ( 3 ) il nuovo valore desiderato per questo parametro
  • Payload MQTT da inviare da un altro client MQTT per l’udpate iniziale:
    • Il Payload per il sistema degli argomenti sarà composto da:
      • mqtt.@sezione[indice].opzione ‘valore‘
      • Esempio:
        • mqtt.@mqttconfig[0].projectname 'Nome del mio nuovo progetto'
    • Per le sezioni multiple (argomenti o systopics o..) con lo stesso nome, è necessario specificare l’indice giusto, il che significa che si deve conoscere la sua posizione nel file MQTT.
      • Esempio di modifica dello slaveid del secondo argomento, da 1 a 5:
        • mqtt.@topics[1].slaveid '5'

ACE_FTP_Upload

Scarica un file dal GTW a un server FTP. In questo caso si tratta del file di log.

  • MQTT_Topic_to_Sub_for_Parameter:
    • Quello desiderato. Esempio: update/ace-gtw-4g/ftp-log
    • Attenzione, il prefisso e il suffisso comuni nella scheda [Argomenti MQTT] per gli argomenti Modbus non vengono aggiunti agli argomenti delle funzioni di sistema: Aggiungerli se necessario.
  • Nome_predefinito_della_funzione:
    • Deve essere: ACE_FTP_Upload
  • Server FTP

    • È necessario installare o avere già a disposizione un server FTP, con il suo
      • indirizzo ftp
      • login utente ftp
      • password dell’utente ftp
  • Payload MQTT da inviare da un altro client MQTT per ricevere i file di log sul proprio server FTP
    • log FTP_file_directory “nomeutente:password”

      • Esempio: log ftp://ftp.myftplink.eu/ "mylogin:mypassword"
        • A ogni attivazione, il GTW invia il proprio file di log al server FTP
        • log, significa file di log. Altri nomi di file saranno disponibili in seguito.

Aiuto nella risoluzione dei problemi incontrati

  • Se ci sono spazi nel link http, aggiungere una citazione e/o sostituire lo spazio con
    • 'https://www.support.aceautomation.eu/gtw-mqtt-4g/ace files' '6UnJS%#n!3u632^cEs2mgvq'
    • Le virgolette devono essere come nell’esempio precedente, non come ‘ o ” (il taglia/incolla spesso cambia il tipo di virgolette)
  • Fare attenzione ad aggiungere il link completo con http://www… o https://www…
  • I nomi dei file sono imposti
    • Per il file .zip
    • e i file all’interno del file zip
  • Controllare la sintassi del nome dell’argomento quando si invia il payload dal client MQTT
    • Il prefisso e il suffisso dei tag comuni non vengono aggiunti per le funzioni di questo sistema
  • I file devono essere installati su un server HTTP o HTTPS
  • Utilizzare sempre una password per i file zip
  • Non utilizzare la barra di avanzamento ” / ” alla fine dell’URL (se presente)

Come utilizzare il software 7-Zip

  • Formato dell’archivio: zip con il giusto nome del file
  • Inserire una password