Presence API

Die Presence API ermöglicht es Gateways, die Verfügbarkeit von Modules zu überwachen und auf offline gehende Modules zu reagieren.

Für den konzeptionellen Überblick siehe Module Presence.

setModuleTimeoutHook(...)

Registriert einen Callback, der ausgeführt wird, wenn ein Module das konfigurierte Timeout überschreitet.

ArmorLink.setModuleTimeoutHook(
    [](const ArmorLinkStoredPairedModule& module,
       uint32_t silentMs)
    {
        ArmorLink.warn(
            String(module.name) + " went offline"
        );
    });

Parameter

Parameter	Beschreibung
module	Informationen über das gekoppelte Module
silentMs	Millisekunden seit der letzten Kommunikation

isModuleOnline(...)

Prüft, ob ein Module aktuell als online betrachtet wird.

if (ArmorLink.isModuleOnline(mac))
{
    ArmorLink.info("Module online");
}

Liefert:

true

wenn das Module aktuell online ist.

Liefert:

false

wenn das Module ein Timeout erreicht hat oder unbekannt ist.

Zusammenfassung

Die Presence API bietet:

• Callbacks für Offline-Erkennung
• Abfragen des Online-Status
• Überwachung auf Gateway-Seite
• Integration in das ArmorLink-Presence-Management