MQTT


Questo gruppo contiene le impostazioni associate al client MQTT.


Q00

Modo

Abilita/disabilita il client MQTT.

0 = disabilitato / 1 = abilitato - Default: disabilitato

Q01

Tempo minimo tra connessioni

Per limitare la quantità di dati su reti a pagamento è possibile forzare un intervallo di tempo minimo tra una connessione e la successiva, raggruppando i trasferimenti in sessioni periodiche intervallate da periodi di pausa.

0 = off / 1 ... 10080 [minuti] - Default: 1

Q02

Intervallo keepalive

è il tempo entro il quale il broker MQTT si aspetta di ricevere una comunicazione dal client, che provvede ad effettuare in modo automatico un invio utile a tenere aperta la connessione.

Il server considera chiusa la connessione se non viene contattato entro 1,5 volte questo tempo.

0 = off / 1 ... 1080 [minuti] - Default: 10

Q03

Indirizzo broker

Indirizzo del server che ospita il broker MQTT.

Deve iniziare con mqtt:// (utilizza la porta TCP 1883)

oppure con mqtts:// (utilizza la porta TCP 8883)

specificare la porta nell'indirizzo se non si intende utilizzare l'impostazione predefinita:
mqtt://miobroker.com:8234

Non è garantito il supporto di mqtts via WiFI.

Q04

Qualità del servizio (QoS)

Qualità del servizio MQTT:

0: al massimo una volta (non garantito)

1: almeno una volta (garantito)

2: esattamente una volta (garantito)

Default: 0

Q05

Username

Nome utente opzionale per la connessione al broker.

0 ... 160 caratteri

Q06

Password

Password opzionale per la connessione al broker.

Per inserire caratteri speciali utilizzare il formato ASCII esadecimale, ad esempio %20 per spazio.

0 ... 160 caratteri

Q07

Client ID

Identificativo con il quale sono pubblicati i topic del dispositivo. Se non è specificato verrà utilizzato il WebId del dispositivo. Se si specifica un identificativo esistente, il dispositivo precedente con stesso identificativo sarà disconnesso.

0 ... 64 caratteri

Q08

Last Will and Testament topic

Nome del topic che il broker conserverà per la pubblicazione nel caso si verifichi una disconnessione indesiderata del dispositivo.

Pubblicato senza ritardo (delay=0, retain=0) utilizzando lo stesso QoS impostato per la pubblicazione degli altri messaggi.

Il contenuto del topic è: Avior <WebId> disconnected

0 ... 64 caratteri

Q09

Sub topic comandi

Nome del topic sottoscritto dal quale il dispositivo preleva gli eventuali comandi inviati.

Il comando deve essere preceduto da un codice di riconciliazione grazie al quale riconoscere l'eventuale risposta.
Il codice deve essere incluso in tra < e > :

<codice>out1=on

Se vengono inviati più comandi ciascuna risposta sarà preceduta dal codice di riconciliazione al quale è aggiunto un indice progressivo:

<code-1>OK

<code-2>OK

<code-3>OK

0 ... 64 caratteri

Q10

Pub topic risposta a comandi

Nome del topic che contiene l'eventuale risposta all'ultimo comando ricevuto dal dispositivo attraverso il topic comandi.

Se il comando conteneva un codice di riconciliazione questo sarà riportato all'inizio della risposta:

<codice>OK

Se sono stati inviati comandi multipli il codice di riconciliazione di ogni risposta sarà identificato da un numero progressivo aggiunto:

<codice-1>OK

<codice-2>OK

<codice-3>OK

0 ... 64 caratteri

Q11

Pub topic cambio mappa

Nome assegnato al topic pubblicato ad ogni modifica di un parametro della mappa. Il topic contiene i parametri modificati rispetto all'ultima pubblicazione. 

0 ... 64 caratteri

Q12

Pub topic cambio log

Nome assegnato al topic pubblicato ad ogni modifica del file di registro. Il topic contiene l'ultimo evento registrato nel file.

0 ... 64 caratteri

Q13

Pub topic cambio utenti

Nome assegnato al topic pubblicato ogni volta che un utente viene aggiunto, rimosso o modificato.

Il topic contiene le informazioni dell'utente interessato.

0 ... 64 caratteri

Q14

Pub topic cambio regole

Nome assegnato al topic pubblicato ogni volta che viene aggiunta, modificat o rimossa una regola.

Il topic contiene la definizione della regola interessata.

0 ... 64 caratteri

Q15

Stato della connessione

0: non connesso

1: connesso al broker MQTT

Se la connessione avviene attraverso la rete cellulare e non vi è scambio di dati per un tempo prolungato l'operatore telefonico può chiudere la connessione al broker ma Avior non avrà modo di capire che è stata interrotta fino ad una successiva trasmissione dati. In tal caso l'indicazione potrebbe essere non corretta.

0 / 1