Zum Hauptinhalt springen

Commands

Commands sind die Nachrichten, mit denen ArmorLink Actions im Netzwerk auslöst.

Ein Command wird an ein Ziel-Module gesendet und enthält alle Informationen, die benötigt werden, um dort passende Funktionalität auszuführen.

Command-Struktur​

Ein ArmorLink Command besteht aus drei Teilen:

  • Target
  • Entity
  • Command

Das Ziel-Module bestimmt, wohin der Command zugestellt wird.

Entity und Command werden vom empfangenden Module verwendet, um eine passende Action zu finden.

Commands lösen Actions aus​

Ein Command ist die Nachricht, die durch das Netzwerk transportiert wird.

Eine Action definiert, was passiert, wenn ein passender Command empfangen wird.

Command empfangen
      |
      v
Passende Action gefunden
      |
      v
onExecute() wird aufgerufen

Commands werden über das Gateway geroutet​

Commands werden über das Gateway weitergeleitet.

Ein Module sendet einen Command an das Gateway. Das Gateway entscheidet anschließend, ob der Command lokal verarbeitet oder an ein anderes Module weitergeleitet werden muss.

Broadcast Commands​

Commands können auch an alle Modules gesendet werden.

Broadcast Commands sind nützlich, wenn mehrere Modules gleichzeitig auf ein Ereignis reagieren sollen.

Beispiele:

  • Alle Flaps öffnen oder schließen
  • Mehrere Lichtmodule ausschalten
  • Synchronisierte Effekte auslösen
  • Einen globalen Statuswechsel senden

Modules ohne passende Action ignorieren den Command einfach.

Commands aus Anwendungslogik​

Commands werden häufig aus normalem Firmware-Code heraus gesendet.

Die lokale Logik bleibt dabei normale Anwendungslogik. ArmorLink übernimmt lediglich die Kommunikation.

Commands vs. Actions​

Commands werden nicht in der ArmorLink App angezeigt.

Actions werden in der ArmorLink App angezeigt.

Commands sind die internen Nachrichten, die Actions auslösen.

Zusammenfassung​

Commands sind der Transportmechanismus für Actions in einem ArmorLink-Netzwerk.

Ein normaler Command enthält:

  • Target Module
  • Entity
  • Command

Ein Broadcast Command enthält:

  • Entity
  • Command

Commands werden über das Gateway geroutet und an das passende Module zugestellt.