Modulo smartCORE smartDrive

Descrizione

Il modulo "smartdrive" rappresenta l'interfaccia di smartCORE verso l'hardware owasys dell'edge device smartDrive. Si occupa di

la lettura dei 4 ingressi analogici (AIN0 – AIN3)
il monitoraggio della tensione di alimentazione (V_IN) e della temperatura interna dell'alloggiamento
il comando dei 4 LED di stato sul lato superiore del dispositivo
la verifica ciclica della connessione a Internet (rete mobile o Ethernet/rete) tramite richiesta HTTP HEAD

Il modulo può essere eseguito esclusivamente su dispositivi smartDrive, poiché inizializza internamente i moduli kernel owasys RTU e IO (libRTU / libIOs).

LED di stato

Il modulo comanda tutti i 4 LED di stato dello smartDrive:

LED	Colore	Comando da parte del modulo
RADIO	giallo	è acceso finché l'ultimo controllo ping periodico (vedere sotto) è andato a buon fine, indipendentemente dal fatto che la connessione avvenga tramite il modem mobile o tramite Ethernet/rete
PWR	verde	viene acceso in modo permanente all'avvio del modulo, non appena è stato possibile inizializzare l'interfaccia hardware owasys
STATE	rosso	viene commutato ogni secondo (lampeggio a 1 Hz) finché il modulo è in esecuzione; se il LED resta spento, il modulo ovvero il processo smartCore non è (più) attivo
GPS	arancione	è acceso in modo continuo non appena è presente un fix GNSS valido (presupposto: nella configurazione di smartCore è presente un modulo GPS, vedere sotto)

Verifica della connettività Internet

Ogni 60 secondi viene inviata tramite libcurl una richiesta HTTP HEAD all'pingUrl configurabile. Il risultato (raggiungibile / non raggiungibile) comanda direttamente il LED RADIO.

Verifica dello stato GPS

All'avvio del modulo, questo cerca tra tutti i moduli smartCORE configurati un modulo con factory gps. Se ne è presente uno, ogni 30 secondi viene interrogata la sua chiamata gpsinfo. Il LED GPS si accende se satcount > 0, posfixmode >= 2 e latitudine e longitudine sono diverse da 0. Se non è configurato alcun modulo GPS, il LED GPS resta permanentemente spento e non viene eseguita alcuna interrogazione.

Interfacce e protocolli utilizzati

moduli kernel owasys RTU/IO (libRTU, libIOs) per ingressi analogici, V_IN, temperatura interna e LED
HTTP (richiesta HEAD tramite libcurl) per la verifica della connettività
interfaccia di chiamata smartCORE di un eventuale modulo gps configurato

Configurazione JSON

Configurazione di esempio (minima)

{
    "module": "SmartDrive",
    "factory": "smartdrive",
    "config": {}
}

Senza l'indicazione di ain_channels tutti i 4 ingressi analogici restano disattivati; pingUrl ripiega sul valore di default www.google.com.

Configurazione di esempio (massima)

{
    "module": "SmartDrive",
    "factory": "smartdrive",
    "config": {
        "pingUrl": "www.google.de",
        "ain_channels": {
            "samplingRate": 10,
            "ch1": {
                "active": true,
                "name": "TestChn1",
                "unit": "V",
                "scale": 1000.0,
                "offset": 0.0,
                "adcMaxRange": 30,
                "absTolerance": 0.0,
                "bufferSize": 100
            },
            "ch2": {
                "active": false,
                "name": "Channel2",
                "unit": "mV",
                "scale": 1.0,
                "offset": 0.0,
                "adcMaxRange": 5,
                "absTolerance": 1.0,
                "bufferSize": 100
            },
            "ch3": {
                "active": true,
                "name": "Channel3",
                "unit": "mV",
                "scale": 2.0,
                "offset": 0.5,
                "adcMaxRange": 30,
                "absTolerance": 0.5,
                "bufferSize": 100
            },
            "ch4": {
                "active": true,
                "name": "Channel4",
                "unit": "mV",
                "scale": 1.0,
                "offset": 0.0,
                "adcMaxRange": 5,
                "absTolerance": 0.1,
                "bufferSize": 100
            }
        }
    }
}

Elenco dei parametri

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori consigliato	Default	Descrizione
pingUrl	No	STRING	URL valido	"www.google.com"	URL interrogato ogni 60 s tramite richiesta HTTP HEAD per verificare la connessione a Internet (LED RADIO)
ain_channels	No	Oggetto	vedere sotto	-	Configurazione dei 4 ingressi analogici (AIN0 – AIN3)

Configurazione `ain_channels`

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori consigliato	Default	Descrizione
samplingRate	No	INT	1, 2, 5, 10 [Hz]	1	Frequenza di campionamento di tutti i 4 ingressi analogici
ch1	No	Oggetto	vedere sotto	-	Configurazione di AIN0
ch2	No	Oggetto	vedere sotto	-	Configurazione di AIN1
ch3	No	Oggetto	vedere sotto	-	Configurazione di AIN2
ch4	No	Oggetto	vedere sotto	-	Configurazione di AIN3

Configurazione di un canale di ingresso analogico (`ch1` – `ch4`)

Nome del parametro	Obbligatorio	Tipo di dati	Intervallo di valori consigliato	Default	Descrizione
active	No	BOOL	false, true	true	Attiva il canale; solo i canali attivi vengono creati come smartCHANNEL
name	No	STRING		"SmartDriveAINChannel"	Nome dello smartCHANNEL dell'ingresso analogico
unit	No	STRING		""	Unità fisica dei valori prodotti
scale	No	NUMBER		1.0	Fattore di scala della tensione misurata (valore * scale + offset)
offset	No	NUMBER		0.0	Offset della tensione misurata (valore * scale + offset)
adcMaxRange	No	INT	5, 30 [V]	30	Campo di misura dell'ingresso analogico (0–5,12 V oppure 0–30,72 V)
absTolerance	No	NUMBER		0.01	Tolleranza assoluta del filtro di riduzione dei dati
bufferSize	No	INT	1 -	100	Dimensione del buffer dello smartCHANNEL

Segnali prodotti

Segnale	Tipo di dati	Unità	Descrizione
PowerSupply	float	V	Tensione di alimentazione attuale (V_IN) dello smartDrive
InternalTemperature	int32	°C	Temperatura interna dell'alloggiamento dello smartDrive
AIN0 – AIN3	float	mV (o unità configurata)	Valore grezzo del rispettivo ingresso analogico, scalato tramite `scale`/`offset` (solo se il canale è `active`)

Funzioni dell'interfaccia di chiamata

getStatus

Verifica se l'interfaccia hardware owasys (moduli kernel RTU/IO) è stata inizializzata correttamente.

Valore restituito	Tipo	Descrizione
value	BOOL	`true`, se l'interfaccia hardware owasys è inizializzata

getInternalTemperature

Legge la temperatura interna attuale dell'alloggiamento.

Valore restituito	Tipo	Descrizione
value	INT	Temperatura interna in °C, oppure `-1` se il valore non ha potuto essere letto

getSupplyVoltage

Legge la tensione di alimentazione attuale (V_IN).

Valore restituito	Tipo	Descrizione
value	NUMBER	Tensione di alimentazione in V, oppure `0` se il valore non ha potuto essere letto

Informazioni sul modulo

Informazione	Valore
Autore	optiMEAS GmbH
Tipo di modulo	Producer
Consuma segnali	No
Produce segnali	Sì
Dipendenze	edge device smartDrive (moduli kernel owasys RTU/IO); modulo `gps` configurato facoltativamente per il LED GPS
Sistemi supportati	smartDrive

Descrizione​

LED di stato​

Verifica della connettività Internet​

Verifica dello stato GPS​

Interfacce e protocolli utilizzati​

Configurazione JSON​

Configurazione di esempio (minima)​

Configurazione di esempio (massima)​

Elenco dei parametri​

Configurazione ain_channels​

Configurazione di un canale di ingresso analogico (ch1 – ch4)​

Segnali prodotti​

Funzioni dell'interfaccia di chiamata​

getStatus​

getInternalTemperature​

getSupplyVoltage​

Informazioni sul modulo​