Manuale Utente

Hardware

Descrizione dell'hardware e delle sue principali funzioni.

Il datalogger è composto da moduli a loro volta composti board. Una descrizione con alcune foto si trova a https://doc.rmap.cc/stima_v3/howto_stima_v3/howto_stima_v3.html e https://doc.rmap.cc/stima_v3/doxygen/index.html a cui fare riferimento per maggiori dettagli. I moduli si interconnettono tra loro tramite bus I2C. Le board si interconnettono tramite interfaccia basata sullo standard UPIN-27.

Funzioni svolte dalle Board

RTC

• determina la base dei tempi per il modulo master

• conserva data e ora anche in mancanza di alimentazione tramite la carica accumulata in un supercondensatore per non più di ~24h

Core+

Contiene il microcontrollore in queste due versioni: * 8 MHz 3.3V * 16 MHz 5V

USB

E' una interfaccia USB con la porta seriale del microcontrollore. Permette di: * caricare firmware * effettuare debug

SDcard

Permette di utilizzare una SDcard per effettuare: * aggiornamento firmware * salvataggio dati * debug

I2C

Espone una: * connessione I2C * ponticello per effettuare la configurazione

GSM

E' in realtà composto da due board: * SIM: in cui deve essere inserita la SIM card * vero e proprio modulo GSM: a cui deve essere connessa l'antenna

HUB

• interconnessione

• alimentazione

• separazione BUS I2C e adattamento tensioni

Display

• Diagnostica

Funzioni software

Da scrivere

Accensione e supervisione (supervisor task)

RTC task

Da scrivere

Time task

Da scrivere

GSM task

Da scrivere

Sensors reading task

Da scrivere

Data saving task

Da scrivere

MQTT task

Da scrivere

Messa in opera

Da scrivere

Connessione e disconnessione

Impilamento board

Fare riferimento a:

• https://doc.rmap.cc/stima_v3/howto_stima_v3/howto_stima_v3.html e

• https://doc.rmap.cc/stima_v3/doxygen/index.html

Connessione moduli

Fare riferimento a:

• https://doc.rmap.cc/stima_v3/howto_stima_v3/howto_stima_v3.html e

• https://doc.rmap.cc/stima_v3/doxygen/index.html

Effettuare tutte le operazioni senza alimentazione elettrica.

Per la connessione elettrica tra moduli bisogna quindi conoscere la tensione di funzionamento di ciascun modulo/dispositivo da connettere e verificare la predisposizione corretta del ponticello di configurazione hardware sulla board I2C-hub.

Regolazione Display

Il display dispone di una apposita vite di regolazione (trimmer) del contrasto che deve essere regolato per rendere il display leggibile. Una cattica regolazione del contrasto rende i caratteri sul display completamente invisibili. Dispone inoltre di un pulsante per attivare la retroilluminazione. Accendere la stazione per avere qualche messaggio visualizzato sul display, premere il pulsante di retrilluminazione e procedere alla regolazione fino a una visualizzazione ottimale.

Assemblaggio scatola stazione

I moduli possono essere montati in qualsiasi ordine. Sulla piastra HUB deve verificare se l’alimentazione e’ impostat a 3.3 V o 5 V; Tale tensione si può impostare spostando il ponticello corrispondente. Nei moduli nell board base e’ riportata una piccola saldatura in prossimita’ della del valore stampato 3 V o 5 V che indica a quale tensione funziona il modulo. Il modulo primario ed il display hanno una tensione di funzionamento di 5V. I cavi interni di collegamento tra moduli ed HUB hanno come differenza solo da lunghezza.

Quando si connette un cavo fare attenzione nel momento dell'inserimento a non piegare i pin sulla scheda HUB.

Sostituzione batteria

Per misurare la tensione della batteria a vuoto è necessario staccare un polo per misurare la tensione reale senza il contributo del pannello solare.

Se c'è da cambiare la batteria bisogna staccare il connettore in hub, in modo da non bloccare la stazione. Staccando il connettore non si incorre infatti nel problema di alimentare il datalogger con una tensione sotto i 6 V.

Per il cambio batteria procedere prima staccando il polo nero (-) e poi il rosso (+). Poi connettere prima il polo rosso e poi il nero alla nuova batteria.

Per togliere e ridare tensione alla stazione occorre agire sul regolatore di carica pannello-batteria nel modo seguente:

Facendo riferimento alla figura

• rimuovere il positivo del pannello dal regolatore di carica, individuato dal numero 1

• rimuovere il positivo della batteria dal regolatore di carica, individuato dal numero 3

• aspettare 10 secondi

• ricollegare la batteria attraverso il pin numero 3

• ricollegare la batteria attraverso il pin numero 1

Quindi la sequenza dei collegamenti è 1-3-3-1

Antenna

Di solito l’antenna e’ posizionata internamento della scatola stazione, ma può essere posizionata all'esterno praticando un foro alla base della scatola e facendo uscire il cavo tramite un passacavo. Il connettore e’ standard quindi si può usare anche una antenna esterna di tipo direzionale.

SDcard

Formattazione

La formattazione della SDcard deve essere eseguita in modo corretto per garantire il funzionamento del datalogger. Sono accettati due tipi di formattazione:

• FAT16

• FAT32

Per essere certi di formattare correttamentela card ci sono due possibilità:

• per windows e MAC https://www.sdcard.org/downloads/formatter/

• per tutti i sistemi l'apposito firmware SdFormatter messo a disposizione con Stima V3

Il metodo consigliato è il secondo.

Come formattare l'SDcard con il firmware SdFormatter.

Inserire l'SDcard nel modulo master e collegare solo il modulo master tramite cavo USB. eseguire:

pio run -e 1284p16m -t upload
pio device monitor

e seguire le indicazioni del programma.

Aggiornamento Firmware

(Vedi sotto)

Logging

(vedi sotto in diagnostica)

Recupero dati

(vedi sotto)

Configurazione

Qui vengono descritte le fasi per effettuare la configurazione della stazione necessaria al suo funzionamento.

Creare un nuovo utente RMAP

Tramite interfaccia WEB

Per iscriversi alla piattarforma RMAP bisogna collegarsi al sito: http://rmap.cc/

andare con il mouse sul menù "Il mio RMAP", sulla destra della barra nera, e clickare su "Entra".

Apparirà una maschera che chiede utente e password. Nella seconda riga sotto a questa maschera clickare sul bottone blu "Registrazione" e si verrà inoltrati automaticamente alla maschera di registrazione.

Per registrarsi bisognerà scegliere ed inviare le seguenti informazioni:

• username (una stringa lunga al massimo 9 caratteri che possono essere sia lettere che numeri);

• la propria e-mail

• la password (da inserire due volte per sicurezza).

Quindi bisogna clickare sul quadratino per dichiarare di aver letto le Condizioni di Servizio (descritte nel quadrato sotto riportato). Completate queste operazioni si può procedere a clickare su "Invia". Fatto questo il server RMAP invierà una mail di conferma all'indirizzo indicato nella maschera di registrazione. La registrazione verrà conclusa aprendo il mail e confermando la propria intenzione di iscriversi seguendo il link indicato.

Configurare una nuova stazione

Tramite interfaccia WEB

Tramite interfaccia WEB è possibile definire solo stazioni di modello (tipo e sensori) predefinito. Per modelli di stazione non predefiniti utilizzare la modalità a linea di comando.

In modalità guidata

Per poter registrare una nuova stazione è utile aver configurato un utente RMAP.

Seguire il link: https://rmap.cc/insertdata/newstation

Si può seguire alternativamente una delle due seguenti procedure:

• indicare l'indirizzo esatto della stazione (il sito utilizza il DataBase geografico di OpenStreetMap che riconosce gli indirizzi solo se indicati con precisione, quindi è necessario inserire l'indirizzo con nome completo della via, es: "viale Antonio Silvani 6, Bologna", oppure " via degli Albergati 32, Zola Predosa, Bologna").

• utilizzare la mappa sottostante, clickare sul segnaposto (quello a forma di goccia, ultimo in basso dei quattro centrali a sinistra della mappa) e posizionarlo sul punto preciso della mappa, con doppio click bottone sinistro del mouse. Se la posizione scelta non è corretta, si potrà cancellare la posizione (selezionare l'ultimo bottone a sinistra nella mappa a forma di bidone e poi clickare sul segnaposto) e riposizionare il marker, oppure spostare il segnaposto nella posizione corretta direttamente sulla mappa (selezionando prima il penultimo bottone a sinistra a forma di matita su foglio "edit layers", spostando il segnaposto e riclickando su "edit layer" per salvare la nuova posizione). Queste funzionalità potrebbero non essere disponibili su Android.

Individuata la posizione bisognerà indicare il nome della nuova stazione ed infine il modello (tipo e template sensori).

La procedura di inserimento della nuova stazione si concluderà quindi clickando su "invia".

In questa modalità non è possibile inserire i dati relativi al nome stazione e altezza dal livello medio del mare, ma poi è possibile integrarli tramite il modulo qui di seguito descritto

Tramite modulo

Per poter registrare una nuova stazione è utile aver configurato un utente RMAP.

Seguire il link: https://rmap.cc/insertdata/newstationdetail e autenticarsi

compilare con i dati e confermare.

A linea di comando

Il tool a linea di comando da utilizzare per configurare le stazioni è:

rmap-configure

Quando si utizzano i tool a linea di comando bisogna sempre considerare che saranno presenti due database:

• database sul server RMAP (persistente)

• database locale (volatile)

Mentre il database sul server RMAP è per definizione persistente quello locale se non già presente va creato utilizzando il comando:

rmapctrl --syncdb

Successivamente sono disponibili due comandi per mantenere i due database sincronizzati:

• upload configuration to server:

  rmap-configure --upload_to_server --station_slug="myslug" --user="myuser" --password="mypassword" --server=rmap.cc
  

• download station configuration from server:

  rmap-configure --download_from_server --station_slug="myslug" --user="myuser" --password="mypassword" --server=rmap.cc
  

Con modello (tipo e template sensori) predefinito

In questa modalità bisogna disporre di:

• myuser: nome utente RMAP

• mypassword: password utente RMAP

• mystationname: nome stazione esteso

• myslug: nome stazione breve

• mystationmodel: modello stazione e template sensori connessi

• mystationname: nome stazione esteso

• myheight: altezza stazione in metri

• mqttsamplerate: ogni quanti secondi deve essere elaborato e inviato un report

• mytcpipntpserver: NTP server da utilizzare per sincronizzare l'ora

• myapn: apn del provider GSM corrispondente alla schda SIM inserita in stazione (default="ibox.tim.it")

Comandi da impartire per configurare la stazione:

rmap-configure --wizard --station_slug="myslug" --height="myheight" --stationname="mystationname" --username="myusername --password="mypassword" --lat="mylat" --lon="mylon"
rmap-configure --addboard --station_slug="myslug" --board_slug=default --user="myuser" --serialactivate --mqttactivate --mqttuser="myuser" --mqttpassword="myuser" --mqttsamplerate="mymqttsamplerate" --tcpipactivate --tcpipntpserver="mytcpipntpserver" --tcpipname=stima --tcpipgsmapn="myapn"
rmap-configure --addsensors_by_template="mystationmodel" --station_slug="myslug" --board_slug=default --user="myuser" --password="mypassword" --upload_to_server

Esempio di configurazione:

rmap-configure --wizard --station_slug=malborghetto --height=2 --stationname="Malborghetto di Boara" --username="myuser" --password="mypassword" --lat=44.85892 --lon=11.65625
rmap-configure --addboard --station_slug=malborghetto --board_slug=default --user="myuser" --serialactivate --mqttactivate --mqttuser="myuser" --mqttpassword="myuser" --mqttsamplerate=900 --tcpipactivate --tcpipntpserver="it.pool.ntp.org" --tcpipname=stima --tcpipgsmapn internet.wind
rmap-configure --addsensors_by_template=stima_report_thpbwr --station_slug=malborghetto --board_slug=default --user="myuser" --password="mypassword"  --upload_to_server

Eseguire:

rmap-configure --help

per avere indicazioni su altri parametri per particolari personalizzazioni.

Con modello (tipo e template sensori) non predefinito

In questa modalità bisogna avere piena padronanza del data model, dei sensori connessi e dei relativi metadati.

Qui un esempio di configurazione:

rmap-configure --wizard --station_slug="myslug" --height="altezzametri" --stationname=""""nome stazione"""" --username="myuser" --password="mypassword" --server=test.rmap.cc --lat="latitudine" --lon="longitudine"  --mqttrootpath=report --mqttmaintpath=maint
rmap-configure --addboard --station_slug="myslug" --board_slug=default --user="myuser" --serialactivate --server=test.rmap.cc --mqttactivate --mqttuser="myuser" --mqttpassword="mypassword" --mqttsamplerate=900 --tcpipactivate --tcpipntpserver="it.pool.ntp.org" --tcpipname=stima --tcpipgsmapn ibox.tim.it --server=test.rmap.cc
rmap-configure --delsensors --station_slug="myslug" --board_slug=default --user="myuser"
rmap-configure --addsensor  --station_slug="myslug" --board_slug=default --user="myuser" --sensorname="temperatura e umidità istantanea" --driver=I2C --type=ITH --address=35 --timerange="254,0,0" --level="103,2000,-,-"
rmap-configure --addsensor  --station_slug="myslug" --board_slug=default --user="myuser" --sensorname="temperatura e umidità minima"     --driver=I2C --type=NTH --address=35 --timerange="3,0,900" --level="103,2000,-,-"
rmap-configure --addsensor  --station_slug="myslug" --board_slug=default --user="myuser" --sensorname="temperatura e umidità media"      --driver=I2C --type=MTH --address=35 --timerange="0,0,900" --level="103,2000,-,-"
rmap-configure --addsensor  --station_slug="myslug" --board_slug=default --user="myuser" --sensorname="temperatura e umidità massima"    --driver=I2C --type=XTH --address=35 --timerange="2,0,900" --level="103,2000,-,-"
rmap-configure --addsensor  --station_slug="myslug" --board_slug=default --user="myuser" --sensorname="pioggia"                          --driver=I2C --type=TBR --address=33 --timerange="1,0,900" --level="1,-,-,-"

rmap-configure  --station_slug="myslug" --board_slug=default --user="myuser" --password="mypassword" --server=test.rmap.cc --upload_to_server
rmap-configure --config_station --station_slug="myslug"  --board_slug=default --username="myuser" --baudrate=115200 --device=/dev/ttyUSB0

Modificare la configurazione di una stazione esistente

Trasferire la configurazione al datalogger

Ecco il comando da impartire per trasferire e salvare la configurazione nel datalogger:

rmap-configure --config_station --station_slug="myslug"  --board_slug=default --username="myuser"  --baudrate=115200 --device=/dev/ttyUSB0

Aggiornamento Firmware

Tramite SDcard

Per l'aggiornamento del firmware è necessario avere a disposizione due file:

• FIRMWARE.BIN

• "majorversion" . "minorversion"

majorversion e minorversion indicano la versione del firmware in oggetto ad esempio:

FIRMWARE.BIN
3.7

I due file andranno posti nella cartella principale della SDcard. Inserire l'SDcard nel modulo che necessita aggiornamento a modulo non alimentato e alimentare il modulo e attendere almeno 30 secondi.

E' possibile verificare se l'aggiornamento ha avuto buon fine con il modulo master tramite il display LCD che all'accensione deve visualizzare la nuova versione del firmware.

Tramite porta USB

Per l'aggiornamento del firmware è necessario avere a disposizione un file:

• FIRMWARE.BIN

che dorà risiedere nella cartella corrente da dove si eseguiranno i comandi.

Collegare il modulo tramite cavo USB e dovrà essere l'unico dispositivo USB collegato in modalità seriale.

Per il modulo master e impartire il comando:

avrdude -v -p atmega1284p -c arduino -b 115200 -D -P /dev/ttyUSB0 -U flash:w:FIRMWARE.BIN:i

Per gli altri moduli impartire il comando:

avrdude -v -p atmega644p -c arduino -b 115200 -D -P /dev/ttyUSB0 -U flash:w:FIRMWARE.BIN:i

Recupero dati

Una volta recuperata la scheda Sdcard dal datalogger i dati possono essere letti con apposito tool linea di comando.

Sono necessari almeno due file:

• AAAA_MM_GG.txt : AAAA = anno ; MM = mese ; GG = giorno

• info.dat : metadati

Eseguire il seguente comando dalla stessa cartella contenete i file con i dati:

mqtt2bufr -i -f AAAA_MM_GG.txt -a info.dat | bufr2mqtt -h rmap.cc -u "myusername" -P "mypassword"

dove:

• myuser: nome utente RMAP

• mypassword: password utente RMAP

Remote Procedure Call

I dati vengono salvati sul modulo master ed è quella SD card che deve essere asportata dopo aver scollegato l'alimentazione.

Le remote procedure call permettono di far eseguire delle operazioni dal datalogger da remoto.

configure

La configurazione da remoto è possibile tramite tool a linea di comando:

rmap-configure --config_station --username="myuser" --station_slug="myslug" --transport=mqtt

Tramite un programma python:

from rmap import jsonrpc

MQTT_HOST = 'rmap.cc'
MQTT_RPCTOPIC = 'rpc/myuser/1112345,4412345/fixed/')
MQTT_USERNAME = 'myuser'
MQTT_PASSWORD = 'mypassword'

with jsonrpc.ServerProxy( jsonrpc.JsonRpc20(),\
          jsonrpc.TransportMQTT(
              host=MQTT_HOST, user=MQTT_USERNAME,password=MQTT_PASSWORD,
              rpctopic=MQTT_RPCTOPIC,
              logfunc=jsonrpc.log_stdout,timeout=1000)) as rpcproxy :

          rpcproxy.configure()
          time.sleep(20)
          #rpcproxy.configure(mqttrootpath='report/myuser/1112345,4412345/fixed/')
          #rpcproxy.configure(mqttmaintpath='maint/myuser/1112345,4412345/fixed/')
          #rpcproxy.configure(mqttrpcpath='rpc/myuser/1165625,4485892/fixed/')
          rpcproxy.configure(mqttsampletime=180)
          rpcproxy.configure(save=True)
          rpcproxy.reboot()

reboot

Il reboot del modulo master è possibile tramite tool a linea di comando:

rmap-configure --rpc_mqtt_reboot --username="myuser" --station_slug="myslug"

oppure tramite un programma python:

from rmap import jsonrpc

MQTT_HOST = 'rmap.cc'
MQTT_RPCTOPIC = 'rpc/myuser/1112345,4412345/fixed/')
MQTT_USERNAME = 'myuser'
MQTT_PASSWORD = 'mypassword'

with jsonrpc.ServerProxy( jsonrpc.JsonRpc20(),\
          jsonrpc.TransportMQTT(
              host=MQTT_HOST, user=MQTT_USERNAME,password=MQTT_PASSWORD,
              rpctopic=MQTT_RPCTOPIC,
              logfunc=jsonrpc.log_stdout,timeout=1000)) as rpcproxy :

          rpcproxy.reboot()

recovery

Il recupero dei dati salvati su SDcard è possibile tramite tool a linea di comando specificando la data iniziale dei dati da recuperare (fino a data e ora corrente):

rmap-configure --rpc_mqtt_recovery --username="myuser" --station_slug="myslug" --datetime="2022-02-16T12:00"

oppure tramite un programma python:

from rmap import jsonrpc

MQTT_HOST = 'rmap.cc'
MQTT_RPCTOPIC = 'rpc/myuser/1112345,4412345/fixed/')
MQTT_USERNAME = 'myuser'
MQTT_PASSWORD = 'mypassword'
DATETIMESTART=[2021,12,22,12,0,0]

with jsonrpc.ServerProxy( jsonrpc.JsonRpc20(),\
          jsonrpc.TransportMQTT(
              host=MQTT_HOST, user=MQTT_USERNAME,password=MQTT_PASSWORD,
              rpctopic=MQTT_RPCTOPIC,
              logfunc=jsonrpc.log_stdout,timeout=1000)) as rpcproxy :

          rpcproxy.recovery(dts=DATETIMESTART)

Temporizzazioni

Da scrivere

Salvataggio e invio dati

Da scrivere

Diagnostica

tramite DISPLAY

Messaggi all'accensione

Prima schermata attesa configurazione:

Wait configuration

E' stato inserito il ponticello per la configurazione e la stazione rimane in attesa; Per attivare la stazioen bisogna rimuovere il ponticello.

Prima schermata, tipo e versioni:

---- www.rmap.cc ----

Stima station

<station type> V: <firmware version>

Configuration V: <configuration version>

• station type: tipo di stazione definito a tempo compilazione

• firmware version: versione del firmware

• configuration version: versione della configurazione per compatibilità

Seconda schermata, dati costanti di stazione:

<bcode1>: <constant station data 1>

<bcode2>: <constant station data 2>

• bcode1: codice della prima variabile come da tabella B; Get the full table from: https://github.com/ARPA-SIMC/dballe/blob/master/tables/dballe.txt

• constant station data 1: value 1

• bcode2: codice della secondavariabile come da tabella B; Get the full table from: https://github.com/ARPA-SIMC/dballe/blob/master/tables/dballe.txt

• constant station data 2: value 2

Terza schermata, stato sensori e metadati di configurazione:

Sensor:	<sensor ok>/<sensor total> <OKKO>
user	<user>
station	<station>
board	<board>

• sensor ok: numero sensori rilevati

• sensor total: numero tolale sensori previsti

• OKKO: stato riassuntivo dei sensori ( OK: tutto bene; KO: malfunzionamento)

• user: mqtt username

• station: station slug

• board: board slug

Quarta schermata, stato sensori e metadati di configurazione:

Sensor:	<sensor ok>/<sensor total> <OKKO>
server	<mqtt server>
ntp	<ntp server>
board	<board>

• sensor ok: numero sensori rilevati

• sensor total: numero tolale sensori previsti

• OKKO: stato riassuntivo dei sensori ( OK: tutto bene; KO: malfunzionamento)

• server: mqtt server name

• ntp: ntp server name

• board: board slug

Messaggi visualizzati nella quarta riga del display:

• SD Card: KO: c'è un problema nell'utilizzo dell'SDcard

• NEW Firmware loaded: è stato appena affettuato un aggiornamento del firmware e il firmware è stato rinominato sull'SDcard

Messaggi durante il funzionamento

<SN>:	<h>:<m>:<s>	rf:<rssi>/<ber> <LCD: KO>
<RT>	temp	humidity	precipitation
battery		charge	solar panel
SD<SN><SOKKO>		MQ<MN><MOKKO>	FA<FN><FOKKO>

• SN: orario prossima elaborazione: S inizio periodo report; N fine periodo report

• h: ora GMT

• m: minuti

• s: secondi

• rssi: qualità segnale radio; vedi tabella sotto (oppure KO in caso di errore)

• ber: qualità segnale radio; vedi tabella sotto (oppure KO in caso di errore)

• LCD: KO: messaggio se l'LCD ha avuto errori ed è stato reinizializzato

ultimi dati acquisiti:

• RT: i dati visualizzati si riferiscono a: T test; R report

• temp: temperatura e unità di misura

• humidity: umidità e unità di misura

• precipitation: precipitazione e unità di misura

• battery: tensione batteria e unità di misura

• charge: carica batteria e unità di misura

• solar panel: tensione pannello solare e unità di misura

ultime oprazioni eseguite:

• SN: numero di dati scritti su SDcard

• SOKKO: stato riassuntivo scrittura SDcard ( OK: tutto bene; KO: malfunzionamento)

• MN: numero di dati inviati al broker MQTT

• MOKKO: stato riassuntivo invio dati MQTT ( OK: tutto bene; KO: malfunzionamento)

• FN: numero di dati con acquisizione fallita dai sensori

• FOKKO: stato riassuntivo acquisizione dati dai sensori ( OK: tutto bene; KO: malfunzionamento)

rssi:

RSI	value
0	-115 dBm or less
1	-111 dBm
2 to 30	-110 dBm to -54 dBm
31	-52 dBm or greater
99	not known or not detectable

dBm is short for decibel per milliwatt and is a common unit for signal strength. -115 dbm is the lowest signal strength value and would typically mean that the station is on a network blind spot. -111 dBm is also a bad number for signal reception. I was able to connect to a network at -70 dBm. Here is a handy list of dBm levels and what they mean:

RSSI Condition:

dBm	mean
-109	Marginal
-107	Marginal
-105	Marginal
-103	Marginal
-101	Marginal
-99	Marginal
-97	Marginal
-95	Marginal
-93	OK
-91	OK
-89	OK
-87	OK
-85	OK
-83	Good
-81	Good
-79	Good
-77	Good
-75	Good
-73	Excellent
-71	Excellent
-69	Excellent
-67	Excellent
-65	Excellent
-63	Excellent
-61	Excellent
-59	Excellent
-57	Excellent
-55	Excellent
-53	Excellent

If you will compare this to smartphones, marginal is one bar, OK is two bars, good is three bars and excellent is four bars.

ber (bit error rate):

In digital transmission, the number of bit errors is the number of received bits of a data stream over a communication channel that have been altered due to noise, interference, distortion or bit synchronization errors.

The bit error rate (BER) is the number of bit errors per unit time. The bit error ratio (also BER) is the number of bit errors divided by the total number of transferred bits during a studied time interval. Bit error ratio is a unitless performance measure, often expressed as a percentage

bear	mean
0	BER < 0.2%
1	0.2% < BER < 0.4%
2	0.4% < BER < 0.8%
3	0.8% < BER < 1.6%
4	1.6% < BER < 3.2%
5	3.2% < BER < 6.4%
6	6.4% < BER < 12.8%
7	12.8% < BER
99	not known or not detectable

Tramite monitoraggio MQTT

Questo monitoraggio permette di visualizzare tutti i messaggi che la stazione invia al server e che il server ha ricevuto correttamente:

rmap-configure --mqtt_monitor --station_slug="myslug" --user="myuser"

i dati vengo visualizzati così come pubblicati e anche decodificati e interpretati.

Tramite porta seriale

Questo monitoraggio permette di visualizzare tutti i messaggi di logging che la stazione invia sulla porta seriale tramite il connettore USB:

rmap-configure --serial_monitor --station_slug="myslug" --user="myuser"

Ogni messaggio è composto da:

data

importanza del messaggio

messaggio

La data e ora sono in GMT.

La importanza del messaggio è rappresentata da una lettera da interpretare come da legenda:

F	fatal errors
E	all errors
W	errors, and warnings
N	errors, warnings and notices
T	errors, warnings, notices & traces
V	all

Tramite SDcard

Per effettuare questo monitoraggio occorre utilizzare un firmware appositamente compilato con questa funzione inclusa; il firmware utilizzati normalmente in produzione non lo permettono.

Avviata la stazione la stessa messaggistica ottenuta dal monitoraggio tramite porta seriale verrà scritta in un file sulla SDcard con postfisso ".log". Il file sarà leggibile da PC una volta recuperata la SDcard.