Zum Hauptinhalt springen

Module

Modules sind die Bausteine eines ArmorLink-Netzwerks.

Ein Module repräsentiert ein ESP32-basiertes Subsystem innerhalb des ArmorLink-Ökosystems.

Beispiele:

  • Helmets
  • Arms
  • Arc Reactors
  • Lichtcontroller
  • Audiocontroller
  • Sensormodule
  • Jedes andere ESP32-basierte Gerät

Ein Module kombiniert Anwendungslogik mit ArmorLink-Funktionalität.

Modul erstellen​

Jedes Module beginnt mit einer ArmorLinkModule-Instanz.

Der Modulname identifiziert das Module innerhalb des Netzwerks.

Der Modultyp liefert zusätzliche beschreibende Informationen.

Modulnamen​

Jedes Module besitzt einen Namen.

Modulnamen sollten innerhalb eines Netzwerks eindeutig sein.

Commands werden anhand des Zielnamens geroutet, daher werden eindeutige Namen dringend empfohlen.

Modultypen​

ArmorLink stellt vordefinierte Modultypen bereit.

Modultypen dienen ausschließlich der Beschreibung und beeinflussen weder Kommunikation noch Routing oder Verhalten.

Ihr Hauptzweck besteht darin, Modules in der ArmorLink App besser zu identifizieren und zu organisieren.

Einem Netzwerk beitreten​

Ein Module existiert zunächst unabhängig.

Bevor es Teil eines ArmorLink-Netzwerks werden kann, muss es mit einem Gateway gekoppelt werden.

Nach erfolgreichem Pairing kann es über das Gateway mit anderen Modules kommunizieren.

Ein Module ist mehr als ein Gerät​

Ein Module ist nicht nur ein Kommunikationsendpunkt.

Ein typisches ArmorLink Module besteht aus:

  • Hardware
  • Anwendungslogik
  • Actions
  • Configuration
  • Telemetry
  • Kommunikation

ArmorLink übernimmt Kommunikation und Verwaltung.

Deine Firmware definiert das tatsächliche Verhalten.

Actions​

Modules stellen Funktionalität über Actions bereit.

Actions definieren Funktionen, die über das ArmorLink-Netzwerk ausgeführt werden können.

Die ArmorLink App erkennt verfügbare Actions automatisch.

Configuration​

Modules können Configuration-Werte bereitstellen.

Diese Werte:

  • werden lokal gespeichert
  • bleiben über Neustarts erhalten
  • können über die ArmorLink App geändert werden
  • können Callbacks auslösen

Telemetry​

Modules können Live-Telemetry bereitstellen.

Beispiele:

  • Batteriespannung
  • Temperatur
  • Sensorwerte
  • Systemstatus

Telemetry bleibt immer Verantwortung des erzeugenden Modules.

Commands senden​

Modules können nicht nur Commands empfangen, sondern auch selbst senden.

Das Gateway übernimmt anschließend die Weiterleitung zum Ziel-Module.

Buttons, Sensoren, Timer und Effekte bleiben Teil deiner Anwendungslogik.

ArmorLink übernimmt die Kommunikation.

Deine Firmware definiert das Verhalten.

Zusammenfassung​

Modules sind die zentralen Bausteine eines ArmorLink-Netzwerks.

Ein Module kann:

  • Actions bereitstellen
  • Configuration bereitstellen
  • Telemetry veröffentlichen
  • Commands senden
  • Commands empfangen

ArmorLink liefert die Kommunikations- und Verwaltungsinfrastruktur.