Einleitung
Der Thingsboard Frost Adapter überträgt Gerätedaten aus ThingsBoard in einen FROST‑Server und macht sie dort über die standardisierte OGC SensorThings API verfügbar. Dadurch können Telemetriedaten, die bereits in ThingsBoard erfasst werden, ohne zusätzlichen Integrationsaufwand von anderen Systemen genutzt werden, die die SensorThings API sprechen (z. B. Kartenanwendungen, Auswertungswerkzeuge oder andere IoT‑Plattformen).
Ein Mandant, ein FROST‑Server
Der Adapter bedient mehrere Mandanten gleichzeitig. Ein Mandant ist die Zusammenfassung eines ThingsBoard‑Mandanten mit genau einem FROST‑Server: Die Geräte dieses ThingsBoard exportieren ausschließlich dorthin, und dieser FROST‑Server nimmt ausschließlich Daten von dort entgegen. Diese Zuordnung ist strikt eins‑zu‑eins.
Adressiert wird ein Mandant über seinen Slug — eine kurze, unveränderliche Kennung. Sie steht in der URL, an die die Rule Chain im ThingsBoard des Mandanten ihre Nachrichten schickt:
http://thingsboard-frost-adapter:8000/ingest/<slug>/telemetryWeil der Slug damit in einem fremden System steht, lässt er sich nachträglich nicht ändern; siehe Mandanten verwalten.
Die Zuordnungen zwischen Telemetrie und SensorThings‑API‑Begriffen — Units of Measurement und Observed Properties — gelten dagegen mandantenübergreifend: Sie werden einmal gepflegt und gelten für alle Mandanten gleichermaßen.
Wegweiser
Diese Dokumentation richtet sich an drei Leserinnen und Leser:
-
Wer in ThingsBoard Geräte für die Veröffentlichung an FROST vorbereiten und freischalten möchte, findet das unter Gerät an FROST veröffentlichen.
-
Wer die Zuordnungen zwischen ThingsBoard‑Telemetrie und den SensorThings‑API‑Begriffen pflegt, findet das unter Zuordnungen pflegen: ThingsBoard‑Telemetrie → SensorThings API.
-
Wer Mandanten registriert, prüft oder stilllegt, findet das unter Mandanten verwalten.
Technische Hintergründe zur Implementierung, zum Datenmodell und zur SensorThings API selbst finden sich in der technischen Dokumentation. Alles, was einen Shell‑Zugang voraussetzt — eine FROST‑Instanz bereitstellen, die Rule Chain je Mandant verteilen, Wiederherstellung nach Fehlbedienung — steht in den Betriebsanleitungen.