Zum Hauptinhalt springen

Konfiguration

Configuration ermöglicht es Modules, persistente Einstellungen bereitzustellen, die über die ArmorLink App angezeigt und geändert werden können.

Configuration gehört immer zu dem Module, das sie bereitstellt.

Das Gateway speichert keine Configuration anderer Modules.

Warum Configuration?​

Viele ESP32-Projekte benötigen Werte, die ohne Firmware-Änderung angepasst werden können.

Beispiele:

  • Lautstärke
  • Servo-Positionen
  • LED-Helligkeit
  • Animationszeiten
  • Sensor-Schwellwerte

ArmorLink stellt dafür ein einheitliches Configuration-System bereit.

Verantwortung für Configuration​

Configuration-Werte werden lokal auf dem Module gespeichert und bleiben über Neustarts hinweg erhalten.

Änderungen werden sofort wirksam. Ein Neustart ist nicht erforderlich.

Das Gateway fungiert lediglich als Kommunikationsbrücke zwischen App und Module.

Unterstützte Typen​

  • Int
  • Float
  • Bool
  • Readonly

Die ArmorLink App erkennt Configuration-Felder automatisch.

Das Module beschreibt seine Felder und die App erzeugt daraus automatisch eine passende Benutzeroberfläche.

Readonly-Felder​

Readonly-Felder liefern Informationen, die angezeigt, aber nicht verändert werden können.

Beispiele:

  • Firmware-Version
  • Hardware-Revision
  • Geräteinformationen
  • Kalibrierungsstatus

Zusammenfassung​

Configuration bietet eine einfache Möglichkeit, persistente Einstellungen bereitzustellen.

Configuration-Werte:

  • Gehören dem jeweiligen Module
  • Werden automatisch gespeichert
  • Werden automatisch in der ArmorLink App angezeigt
  • Unterstützen Validierung
  • Können Änderungs-Callbacks auslösen
  • Sind sofort nach einer Änderung verfügbar