Sessioni¶

Portare i telegrammi nell'M-Bus Explorer¶

La tabella dice che un contatore chiede una chiave, o che i suoi telegrammi arrivano danneggiati. Non dice che cosa contengono. Quello è il compito dell'M-Bus Explorer, e il banco gli passa i telegrammi.

Explore su una riga apre i telegrammi di quel contatore nell'M-Bus Explorer, in una nuova scheda, già decodificati.
Explore, sopra la tabella, apre tutti i telegrammi della sessione.

I telegrammi viaggiano dentro il link stesso, dopo il #, quindi non finiscono nel log di nessun server. Un link ha un limite di lunghezza. Se una sessione ha sentito più di quanto ci sta, il link porta i telegrammi più recenti e la pagina dice quanti.

Se il browser blocca la nuova scheda, il link compare in un riquadro Link, pronto da copiare.

Explore compare solo se l'M-Bus Explorer ha un indirizzo su questa installazione. Per conservare una cattura, o una troppo lunga per un link, si usa Export, qui sotto.

Esportare una sessione¶

Export offre quattro file. I primi tre sono gli stessi del banco per il bus cablato.


Table	Ogni contatore e ogni grandezza, con il primo valore e l'ultimo, in CSV.
Frames	Ogni telegramma che la sessione tiene, in CSV per l'M-Bus Explorer.
Raw data	Ogni messaggio inviato ai gateway e ricevuto da loro, come testo.
Signal	La mappa del segnale, con una riga per ogni contatore e gateway, in CSV.

Table e Frames compaiono quando è arrivato un telegramma. La tabella ha le colonne del banco per il bus cablato, con gateways dove quel banco ha il convertitore.

Frames è quello da portare nell'M-Bus Explorer: trascinare il file sul suo riquadro dei telegrammi, e ogni telegramma ha la data in cui è arrivato qui. Una sessione tiene i 10.000 telegrammi più recenti.

Raw data serve quando un gateway non fa quello che gli si è chiesto, e la domanda è che cosa ha detto. Una riga per messaggio: l'ora in UTC, il gateway, > per un messaggio inviato dal banco o < per uno ricevuto, il topic, e il messaggio com'era. Tiene i 10.000 messaggi più recenti; se ha dovuto dimenticare i più vecchi, la prima riga dice quanti.

Signal compare dove compare la sezione Signal. Ha gli stessi contatori e gli stessi gateway della mappa, con una riga per ogni contatore e gateway, così se ne può fare una tabella pivot o un grafico. Le colonne:


serial	Il contatore.
receiver	Il gateway, o la matricola di un ripetitore.
kind	`gateway` o `repeater`.
gateway	Il gateway. Per un ripetitore, il gateway a cui appartiene.
rssi	Il segnale del contatore stesso al ricevitore, in dBm. Vuoto se il ricevitore non ha sentito direttamente il contatore.
telegrams	Quanti telegrammi del contatore ha inoltrato il gateway.
relayed	Quanti di questi ha portato un ripetitore.
relayed_rssi	Il segnale dell'ultimo telegramma portato da un ripetitore. È il segnale del ripetitore al gateway, non quello del contatore.
last_at	Quando è arrivato l'ultimo telegramma, in UTC. Per un ripetitore, quando è stata letta la sua lista di scansione.
link_rssi	Per un ripetitore: il suo segnale al gateway.

Un contatore che un gateway non ha sentito ha comunque una riga, con rssi vuoto e telegrams a 0. Un ripetitore ha righe solo dopo che la sua lista di scansione è stata letta, una per ogni contatore della lista. Il file è la mappa nel momento in cui lo si scarica: una finestra svuota la colonna del suo gateway, e con essa le righe di quel gateway.

I file di una sessione si possono ancora scaricare per qualche ora dopo che si è fermata.

Condividere una sessione¶

Share mostra un Watch link e lo copia, dove il browser lo permette. Mandare il link a un collega: vedrà la sessione come la si vede, con i contatori, le letture, il registro, Explore e Export.

Un watch link permette solo di leggere:

Chi lo apre non ha bisogno della password del broker né delle chiavi. Vede le letture dei contatori cifrati, perché le chiavi usate sono le proprie. Mandare il link solo a chi può vedere questo gateway.
Non può chiedere una finestra, fermarla, o chiudere la sessione. La pagina glielo dice.
Watchers, nel riepilogo, dice quante persone hanno il link aperto.

La sessione resta aperta finché qualcuno la guarda, anche dopo aver chiuso la propria pagina. Una finestra chiesta continua per tutta la sua durata. La sessione finisce, e la sua finestra si ferma, quando l'ultima persona smette di leggerla. Disconnect la chiude subito, per tutti.

Una sessione può essere guardata da 10 persone al massimo. Un link a una sessione finita da qualche ora dice che non porta a nessuna sessione.

Una notifica quando un gateway si connette¶

Premete Enable notifications, accanto al titolo Gateways. Il pulsante diventa Disable notifications, e il browser mostra una notifica sul desktop ogni volta che un gateway della sessione si connette. La notifica dice quale gateway e perché si è connesso. Premete di nuovo il pulsante per smettere.

La prima volta il browser chiede se questa pagina può mostrare notifiche. Rispondete di sì. Se avete risposto di no, il pulsante non cambia; consentite le notifiche per questa pagina nelle impostazioni del browser e premetelo di nuovo.
Quando il pulsante diventa Disable notifications, il browser mostra subito una notifica, Notifications are on. Se non la vedete, il sistema nasconde le notifiche: controllate la modalità Full immersion (Focus) e le impostazioni di notifica del browser nelle impostazioni di sistema.
La pagina deve restare aperta in una scheda. La scheda può stare dietro ad altre e la finestra può essere ridotta a icona. Con la pagina chiusa non compare nulla.
Un gateway che è già online quando premete il pulsante non viene notificato. Lo sarà alla prossima connessione.
Il browser ricorda la scelta per la visita successiva.

Tornare a una sessione¶

Ricaricando la pagina si torna alla sessione che era sullo schermo, con o senza account. La pagina tiene la sessione per la propria scheda del browser: non nell'indirizzo, e non per un'altra scheda o un'altra persona. Sparisce quando si chiude la scheda. Dopo ← Back, Disconnect o Sign out, la pagina si apre all'inizio.

Un elenco delle proprie sessioni, solo con l'accesso fatto. Chi non ha account e chiude la scheda ha perso la strada per tornare alla sua sessione, che continua a osservare senza di lui.

Con l'accesso fatto, nella scheda Session compare Sessions, con le sessioni che si possono riprendere. Premere Open it, e la pagina torna a osservare quella sessione, con tutto quello che ha sentito.

Anche una sessione terminata è nell'elenco, dopo quelle attive, per quattro ore dalla fine, oppure per sette giorni se l'ha aperta un amministratore. Aprirla serve a leggere quello che ha sentito: la tabella, il registro ed Explore funzionano, e la pagina dice che la sessione è terminata. Ai suoi gateway non si può inviare nulla. Il cestino rosso accanto all'ora di fine elimina la sessione e quello che ha sentito, dopo una conferma; non si può più leggere.

È anche il punto in cui lascia ← Back: torna alle schede e lascia la sessione aperta, così la riga è lì da premere quando si è finito con le altre schede.

Colonna
Preset	Il nome del preset, se viene dall'elenco. L'indirizzo del broker, se qualcuno lo ha scritto.
Gateway	Il gateway osservato; per più gateway, quanti sono, con gli id nel tooltip; oppure every gateway.
Meters	Quanti contatori ha sentito.
Since	Quando è stata aperta.
Ended	Quando è terminata, oppure running.
Started by	you, oppure il nome di chi l'ha aperta. Per la sessione di un logger, the logger e il suo nome.
Pending	Quanti comandi la sessione deve ancora far arrivare ai suoi gateway: letture, pianificazioni di connessione, tempi di inattività, aggiornamenti firmware e riavvii. Il suggerimento dice quanti di ciascun tipo. Un trattino se non ce ne sono.

La sessione di un logger in funzione è nell'elenco di ogni amministratore. Non ha Disconnect, e non finisce quando nessuno la legge: finisce quando il logger viene fermato.

Un amministratore vede tutte le sessioni del banco. Un utente e un tecnico esterno vedono quelle che hanno aperto loro. La sessione di chi non ha account non è nell'elenco di nessuno, nemmeno di un amministratore: non c'è un account sotto cui metterla.

Una sessione finisce comunque quando nessuno la legge. Per tornare ci sono i 15 minuti di Quando l'osservazione si ferma: abbastanza per raggiungere la colonna montante successiva, non abbastanza per lasciarla lì fino a domani. Una finestra continua a consumare la SIM del gateway finché la sessione vive, ed è per questo che il banco non ne tiene aperta una che nessuno legge.

Quando l'osservazione si ferma¶

Disconnect chiude subito la sessione e ferma la finestra del gateway. La pagina resta dov'è: dice You disconnected from this session. What it heard is still here., e la tabella, il registro, i filtri ed Explore continuano a funzionare, come quando una sessione finisce da sola (più sotto). ← Back riporta alle schede.

Una sessione finisce anche da sola:

quando nessuno la legge per 15 minuti — la scheda è stata chiusa, o il computer è andato in sospensione, e nessuno ha un watch link aperto. Con l'accesso fatto si può riprenderla entro quei minuti: vedere Tornare a una sessione;
dopo dodici ore, qualunque cosa si stia facendo.

Quando cade solo la connessione con la pagina, la pagina dice Trying again e riprende da dove era.

Quando la sessione è davvero finita, la pagina dice This session has ended. What it heard is still here. La tabella, il registro, i filtri ed Explore continuano a funzionare, e un pulsante Connect again apre una nuova sessione. I telegrammi restano disponibili per quattro ore dalla fine, oppure per sette giorni se la sessione è stata aperta da un amministratore. Dopo, Explore risponde che non sono più disponibili.

Quando rifiuta¶

Un rifiuto compare in un riquadro sotto il modulo. I più comuni:

La pagina dice	Che cosa fare
That is not a public address, and this tool connects to brokers on the internet.	Il nome del broker porta a un indirizzo privato. Il banco si connette solo a indirizzi pubblici, e alla propria macchina dove l'installazione lo permette.
Port … is not a port this tool connects on.	Il banco si connette solo sulle porte MQTT che l'installazione permette.
No address could be found for …	Il nome del broker è scritto male, o non esiste.
A key must be 32 hexadecimal characters.	Una delle chiavi è troppo corta, troppo lunga, o non è esadecimale.
"…" is not a gateway id.	Un id di gateway è fatto di lettere e cifre. Separare più id con virgole.
"…" is not a serial number.	In Meters to expect: una matricola ha al massimo otto cifre.
You already have 4 connections open.	Chiuderne una, con Disconnect, prima di aprirne un'altra.
This tool is holding as many connections as it will hold.	Troppe persone stanno usando il banco. Riprovare tra qualche minuto.

Quando è il broker a rifiutare, il modulo sparisce e Connection dice Failed, con sotto il motivo:

The broker did not accept that username and password.
The broker refused those credentials. La password può essere giusta, ma l'account non è ammesso su questo broker.
Nothing is listening on that port.
The broker did not answer. Il banco aspetta dieci secondi.
The broker's certificate could not be checked. Spesso è un broker senza TLS, raggiunto con TLS spuntato.
Connected, but the broker refused the subscription. L'account forse non può leggere quel prefisso di topic.

Una sessione non riuscita conta comunque come una delle quattro finché non si preme Disconnect.