smartDrive smartCORE Modul

Beschreibung

Das "smartdrive" Modul stellt die Schnittstelle zur owasys-Hardware des smartDrive Edge Devices zum smartCORE dar. Es übernimmt

das Auslesen der 4 analogen Eingänge (AIN0 – AIN3)
die Überwachung der Versorgungsspannung (V_IN) und der internen Gehäusetemperatur
die Ansteuerung der 4 Status-LEDs auf der Geräteoberseite
die zyklische Prüfung der Internetverbindung (Mobilfunk oder Ethernet/Netzwerk) per HTTP-HEAD-Anfrage

Das Modul ist ausschließlich auf smartDrive Geräten lauffähig, da es intern die owasys RTU- und IO-Kernelmodule (libRTU / libIOs) initialisiert.

Status-LEDs

Das Modul steuert alle 4 Status-LEDs des smartDrive an:

LED	Farbe	Ansteuerung durch das Modul
RADIO	gelb	leuchtet, solange die letzte periodische Ping-Prüfung (siehe unten) erfolgreich war – unabhängig davon, ob die Verbindung über das Mobilfunkmodem oder über Ethernet/Netzwerk besteht
PWR	grün	wird beim Modulstart dauerhaft eingeschaltet, sobald die owasys-Hardwareschnittstelle initialisiert werden konnte
STATE	rot	wird jede Sekunde umgeschaltet (Blinken im 1-Hz-Takt), solange das Modul läuft; bleibt die LED dunkel, ist das Modul bzw. der smartCore-Prozess nicht (mehr) aktiv
GPS	orange	leuchtet durchgehend, sobald ein valides GNSS-Fix vorliegt (Voraussetzung: ein GPS-Modul ist in der smartCore-Konfiguration vorhanden, siehe unten)

Internet-Konnektivitätsprüfung

Alle 60 Sekunden wird per libcurl ein HTTP-HEAD-Request an die konfigurierbare pingUrl gesendet. Das Ergebnis (erreichbar / nicht erreichbar) steuert direkt die RADIO-LED.

GPS-Statusprüfung

Beim Modulstart durchsucht das Modul alle konfigurierten smartCORE-Module nach einem Modul mit Factory gps. Ist eines vorhanden, wird alle 30 Sekunden dessen gpsinfo-Call abgefragt. Die GPS-LED leuchtet, wenn satcount > 0, posfixmode >= 2 sowie Breiten- und Längengrad ungleich 0 sind. Ist kein GPS-Modul konfiguriert, bleibt die GPS-LED dauerhaft aus und es findet keine Abfrage statt.

Verwendete Schnittstellen & Protokolle

owasys RTU-/IO-Kernelmodule (libRTU, libIOs) für Analogeingänge, V_IN, interne Temperatur und LEDs
HTTP (HEAD-Request via libcurl) zur Konnektivitätsprüfung
smartCORE Call-Interface eines ggf. konfigurierten gps Moduls

JSON-Konfiguration

Beispielkonfiguration (minimal)

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

Ohne Angabe von ain_channels bleiben alle 4 Analogeingänge deaktiviert; pingUrl fällt auf den Default www.google.com zurück.

Beispielkonfiguration (maximal)

{
    "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
            }
        }
    }
}

Parameter-Liste

Parametername	Erforderlich	Datentyp	sinnvoller Wertebereich	Default	Beschreibung
pingUrl	Nein	STRING	gültige URL	"www.google.com"	URL, die alle 60s per HTTP-HEAD-Request abgefragt wird, um die Internetverbindung (RADIO-LED) zu prüfen
ain_channels	Nein	Objekt	siehe unten	-	Konfiguration der 4 analogen Eingänge (AIN0 – AIN3)

Konfiguration `ain_channels`

Parametername	Erforderlich	Datentyp	sinnvoller Wertebereich	Default	Beschreibung
samplingRate	Nein	INT	1, 2, 5, 10 [Hz]	1	Abtastrate aller 4 analogen Eingänge
ch1	Nein	Objekt	siehe unten	-	Konfiguration von AIN0
ch2	Nein	Objekt	siehe unten	-	Konfiguration von AIN1
ch3	Nein	Objekt	siehe unten	-	Konfiguration von AIN2
ch4	Nein	Objekt	siehe unten	-	Konfiguration von AIN3

Konfiguration eines Analogeingang-Kanals (`ch1` – `ch4`)

Parametername	Erforderlich	Datentyp	sinnvoller Wertebereich	Default	Beschreibung
active	Nein	BOOL	false, true	true	Kanal aktivieren; nur aktive Kanäle werden als smartCHANNEL angelegt
name	Nein	STRING		"SmartDriveAINChannel"	smartCHANNEL-Name des analogen Eingangs
unit	Nein	STRING		""	Physikalische Einheit der produzierten Werte
scale	Nein	NUMBER		1.0	Skalierungsfaktor der gemessenen Spannung (Wert * scale + offset)
offset	Nein	NUMBER		0.0	Offset der gemessenen Spannung (Wert * scale + offset)
adcMaxRange	Nein	INT	5, 30 [V]	30	Messbereich des Analogeingangs (0–5,12 V oder 0–30,72 V)
absTolerance	Nein	NUMBER		0.01	Absolute Toleranz des Datenreduktionsfilters
bufferSize	Nein	INT	1 -	100	Puffergröße des smartCHANNEL

Produzierte Signale

Signal	Datentyp	Einheit	Beschreibung
PowerSupply	float	V	Aktuelle Versorgungsspannung (V_IN) des smartDrive
InternalTemperature	int32	°C	Interne Gehäusetemperatur des smartDrive
AIN0 – AIN3	float	mV (bzw. konfigurierte Einheit)	Rohwert des jeweiligen Analogeingangs, skaliert über `scale`/`offset` (jeweils nur, wenn der Kanal `active` ist)

Call-Interface Funktionen

getStatus

Prüft, ob die owasys-Hardwareschnittstelle (RTU-/IO-Kernelmodule) erfolgreich initialisiert wurde.

Rückgabewert	Typ	Beschreibung
value	BOOL	`true`, wenn die owasys-Hardwareschnittstelle initialisiert ist

getInternalTemperature

Liest die aktuelle interne Gehäusetemperatur aus.

Rückgabewert	Typ	Beschreibung
value	INT	Interne Temperatur in °C, oder `-1` falls der Wert nicht gelesen werden konnte

getSupplyVoltage

Liest die aktuelle Versorgungsspannung (V_IN) aus.

Rückgabewert	Typ	Beschreibung
value	NUMBER	Versorgungsspannung in V, oder `0` falls der Wert nicht gelesen werden konnte

Modul-Informationen

Information	Wert
Autor	optiMEAS GmbH
Modultyp	Produzent
Konsumiert Signale	Nein
Produziert Signale	Ja
Abhängigkeiten	smartDrive Edge Device (owasys RTU-/IO-Kernelmodule); optional konfiguriertes `gps` Modul für die GPS-LED
Unterstützte Systeme	smartDrive

Beschreibung​

Status-LEDs​

Internet-Konnektivitätsprüfung​

GPS-Statusprüfung​

Verwendete Schnittstellen & Protokolle​

JSON-Konfiguration​

Beispielkonfiguration (minimal)​

Beispielkonfiguration (maximal)​

Parameter-Liste​

Konfiguration ain_channels​

Konfiguration eines Analogeingang-Kanals (ch1 – ch4)​

Produzierte Signale​

Call-Interface Funktionen​

getStatus​

getInternalTemperature​

getSupplyVoltage​

Modul-Informationen​