Zum Hauptinhalt springen

Wearables & IoT-Geräte

Über die Konsole Device Fleet verbinden Sie Wearables für Endverbraucher und registrieren IoT-Geräte am Patientenbett, sehen deren Messwerte ein und legen Alarmregeln fest. Diese Seite erklärt die Funktionen, die Patientenregistrierung, die Speicherung der Messwerte und welche Funktionen noch nicht verfügbar sind.

Hinter der einen Konsole befinden sich zwei separate Rückwände:

FamilieServiceWie Daten ankommen
Wearables für Endverbraucher (Fitbit, WHOOP usw.)Wearables-ServiceDer Dienst greift auf die Cloud-API des Anbieters zu, nachdem der Patient den Zugriff autorisiert hat.
IoT-/BettgeräteConnect (IoT)Das Gerät veröffentlicht Daten über MQTT mithilfe eines mTLS-Zertifikats, das bei der Registrierung ausgestellt wird.

Diese Seite befasst sich hauptsächlich mit dem Wearables-Service. IoT-Registrierung, Alarmregeln und Schwellenwerte gehören zu Connect und sind unter Alarme zusammengefasst.

Öffne die Konsole.​

Gehen Sie zu Tiet · Connect > Device Fleet (Route /iot-wearables). Jeder Tab hat seine eigene Adresse, /iot-wearables/<tab>, sodass Sie ihn als Lesezeichen speichern können.

Sie benötigen mindestens eine der folgenden Berechtigungen, um die Konsole anzuzeigen: read:iot, manage:iot, read:wearables, manage:wearables. Nicht nutzbare Registerkarten sind ausgeblendet.

TabWird angezeigt, wenn Sie haben
Überwachung, Geräte, Vitalfunktioneneine der vier Lese- oder Verwaltungsberechtigungen
Anbieterread:wearables oder manage:wearables
Anmeldung, Benachrichtigungenread:iot oder manage:iot
Automatisierungenmanage:wearables
Einstellungenmanage:iot oder manage:wearables

Die Onboard device Taste (oben rechts) benötigt manage:iot oder manage:wearables.

Anbieter: Was funktioniert wirklich?​

Der Tab „Anbieter“ listet neun Anbieter auf, die durch die Datenbankmigration integriert wurden: Garmin, Apple Health, Samsung Health, Fitbit, Oura Ring, WHOOP, Polar, Suunto und Movesense. Die Auflistung eines Anbieters bedeutet nicht, dass Daten von diesem stammen. Folgendes macht der laufende Dienst, wie im Code nachzulesen ist:

AnbieterVerbindungsmechanismusDatenerfassung im laufenden Dienst
FitbitOAuth 2.0Vom Synchronisierungsmodul abgerufene Daten: Aktivität, Schlaf, Herzfrequenz (1-Minuten-Detail), Körperzusammensetzung, SpO2. Schreibt vital_readings und veröffentlicht die Daten über MQTT.
WHOOPOAuth 2.0Vom Synchronisierungsmodul abgerufene Daten: Erholung, Belastungszyklen, Schlaf, Trainingseinheiten. Ein signierter Webhook mit dem Wert POST /api/v1/webhooks/whoop löst eine zweitägige Resynchronisierung aus; ein Ereignis user.deleted trennt die Verbindung.
GarminOAuthDer Patient kann die Synchronisierung zwar autorisieren, aber die Synchronisierungs-Engine verfügt über keine Garmin-Schnittstelle, daher wird diese bei geplanten und manuellen Synchronisierungen übersprungen. Der Garmin-Webhook-Handler wird nie eingebunden.
Oura Ring, Polar, Suunto, Samsung HealthIm Repository sind Provider-Pakete vorhanden.Keine Verbindung zum laufenden Server: Die OAuth-Client-Factory akzeptiert nur fitbit, garmin und whoop, die Synchronisierungs-Engine nur fitbit und whoop. Oura verfügt über keine Webhooks (laut Integrationshinweis müssen die Daten abgefragt werden).
Apple HealthExportdatei-Import, kein OAuthEs existiert ein Importdienst, der eine exportierte HealthKit-XML-Datei analysiert, aber es gibt keinen HTTP-Endpunkt oder eine Benutzeroberfläche, die ihn aufruft.
MovesenseBluetooth-ForschungssensorenGeplant. Als Zeile mit Synchronisierungsintervall 0 initialisiert; kein Code.

Konfigurieren Sie einen Anbieter​

  1. Öffnen Sie Providers und wählen Sie Configure auf der Anbieterkarte.
  2. Geben Sie die Client ID und Client secret ein, die Sie bei diesem Anbieter registriert haben. Im Menü werden außerdem die Redirect URI zur Registrierung, die Synchronisierungsoption Frequency und die Webhook-Einstellung angezeigt.
  3. Wählen Sie Test. Im Ergebnis-Toast wird ok, warning oder error mit einer Nachricht angezeigt.

Auf jeder Karte wird Auth (OAuth 2.0 oder Direct), Credentials (Konfiguriert, Fehlend oder ein Bindestrich), Webhooks (Aktiv oder Aus) und Sync (every <n>m, das Standardintervall des Anbieters) angezeigt.

Einen Patienten anmelden​

Ein Arzt lädt den Patienten ein; der Patient genehmigt den Zugriff auf der Anmeldeseite des Arztes. Tietai Arzt sieht niemals das Passwort des Patienten.

Ablauf der Patienteneinschreibung: Einladung, Einwilligung, Genehmigung durch den Leistungserbringer, Geräteerstellung

  1. Öffne Onboard device und wähle Consumer wearable.
  2. Wählen Sie einen Anbieter. Jeder Anbieter zeigt einen Status an: Bereit, Anmeldeinformationen erforderlich (OAuth aktiviert, aber keine Client-ID und kein Client-Geheimnis gespeichert) oder Deaktiviert. Konfigurieren Sie zuerst einen Anbieter, der Anmeldeinformationen benötigt.
  3. Geben Sie Patient name ein (erforderlich). Fügen Sie Email oder Phone hinzu, wenn Sie die Zustellung per E-Mail oder SMS vornehmen.
  4. Unter Data to sync können Sie die ausgewählten Datentypen beibehalten oder ändern. Zur Auswahl stehen heart_rate, resting_heart_rate, heart_rate_variability, breathing_rate, spo2, activity, sleep. skin_temp weight, temperature und profile. Standardmäßig sind die heart_rate, activity und sleep ausgewählt.
  5. Unter How to deliver wählen Sie Email, SMS, QR code oder Copy link. E-Mail und SMS sind ausgegraut, wenn für den Dienst keine SendGrid- oder Twilio-Zugangsdaten konfiguriert sind.
  6. Wählen Sie Send invitation.

Sie sollten Invitation created mit einem magischen Link (<frontend>/patient-connect/<token>) und einem QR-Code sehen. Wenn Sie E-Mail oder SMS gewählt haben, erhalten Sie eine Bestätigungsnachricht; andernfalls werden Sie aufgefordert, den Link zu teilen.

Der Patient öffnet den Link, prüft die Datentypen und erteilt seine Einwilligung. Anschließend wird er zur Autorisierung an den Anbieter weitergeleitet. Beim Rückruf des Anbieters speichert der Dienst die verschlüsselten Token, erstellt das Gerät, markiert die Einladung Connected und startet im Hintergrund eine 30-tägige Datenaktualisierung.

Einladungen verwalten​

Öffnen Sie Enrollment Im Enrollment invitations Bereich werden Einladungen für Ihre Organisation (bis zu 100) mit einem Statusfilter aufgelistet: Alle, Ausstehend, Zustimmung erteilt, Verbunden, Abgelaufen, Widerrufen.

AktionVerfügbar, wenn der Status
Einladungslink kopierenAusstehend, Zustimmung erteilt
Einladung erneut sendenAusstehend, Abgelaufen
Einladung widerrufen (fragt: "Widerrufen?")Ausstehend, Zustimmung erteilt, Verbunden

Eine Einladung verfällt 7 Tage nach ihrer Erstellung. Ein Hintergrundprozess markiert abgelaufene Einladungen stündlich. Der Patientenlink erlaubt maximal 30 Anfragen pro Stunde und Token.

hinweis

Die Onboard-Software generiert für jede Einladung eine neue, zufällige Patienten-ID. Dabei wird kein bestehender Patientendatensatz verwendet, sodass die Daten des Wearables mit dieser neuen ID verknüpft werden. Berücksichtigen Sie dies bei der Verknüpfung von Messwerten mit einer Patientenakte.

Geräte, Synchronisierung und der Zeitplan​

Der Tab Devices listet IoT-Geräte und Wearables zusammen auf. Ein Zeilenmenü bietet, abhängig von Ihren Berechtigungen und dem Gerätestatus, folgende Optionen:

  • Edit device
  • Sync now (nur Wearables)
  • Pause syncing / Resume syncing (Wearables) oder Suspend device / Reactivate device (IoT)
  • Delete device

Terminplaner​

Der Wearables-Dienst startet beim ersten Aufruf und anschließend alle SYNC_INTERVAL_MINUTES Minuten (Standardintervall: 30 Minuten; bei einem Wert unter 1 Minute wird das Intervall auf 30 Minuten zurückgesetzt). Bei jedem Durchlauf werden bis zu 50 aktive Geräte ausgewählt, deren next_sync_at fällig ist, und die Daten des letzten Tages synchronisiert. Für Geräte, die über die API erstellt wurden, gilt standardmäßig ein 60-Minuten-Intervall.

Manuelle Synchronisierung​

Sync now ruft POST /api/v1/devices/{id}/sync auf. Der Antworttext ist optional; days (1 bis 90, Standardwert 7) legt den Betrachtungszeitraum fest. Der Aufruf gibt 202 Accepted mit "status": "running" zurück, und die Synchronisierung läuft im Hintergrund. Den Fortschritt können Sie unter Automations verfolgen, wo laufende und kürzlich durchgeführte Synchronisierungsaufträge aufgelistet sind.

Ein Synchronisierungsprotokoll protokolliert den Status success, partial oder failed sowie die abgerufenen Datensätze und die Dauer.

hinweis

Im Anfragetext werden data_types, from_date und to_date akzeptiert, die manuelle Synchronisierung verwendet jedoch nur days.

Wo die Messwerte gespeichert und veröffentlicht werden​

Datenpfad des Wearables vom Anbieter zur Tabelle „vital_readings“ und zu MQTT, mit nicht verifizierten Zwischenschritten (gestrichelt).

Bei Fitbit und WHOOP führt der Dienst bei jeder Messung zwei Aktionen aus:

  1. In der vital_readings für Wearables (Spalten: Patient, Gerät, Organisation, metric, recorded_at, value, unit) Stores it Wert vorhanden. Jeder Messwert ist pro Patient, Metrik und Zeitstempel eindeutig, sodass eine wiederholte Synchronisierung Aktualisierungen und keine Duplikate erzeugt.
  2. Publishes it zu MQTT, wenn ein Broker konfiguriert ist (MQTT_BROKER; ohne ihn protokolliert der Dienst "MQTT deaktiviert" und läuft weiter), bei QoS 1 .
ThemaInhalt
wearables/vitals/{org_id}/{patient_id}/{type}eine wichtige Lektüre
wearables/activity/{org_id}/{patient_id}Aktivität oder Training
wearables/sleep/{org_id}/{patient_id}Schlafsitzung
wearables/device/status/{org_id}/{device_id}Gerätestatus
wearables/sync/{org_id}/{event}Synchronisierung gestartet, abgeschlossen, fehlgeschlagen

Jede wichtige Nachricht enthält source_type: "consumer_wearable", clinical_grade: false und device_class. Behandeln Sie Wearable-Daten als Wellness-Daten und nicht als klinisch relevante Messwerte.

vorsicht

Der Wearables-Dienst enthält keine FHIR- oder LOINC-Zuordnung und speichert keine FHIR-Beobachtungen. Connect verfügt zwar über einen FHIR-Mapper für IoT-Gerätedaten, die LOINC-Codes verwenden, dieser überwacht jedoch die tietai/v1/<org>/devices/... Themen des IoT-Brokers. Für die wearables/... Themen des Wearables-Dienstes wurde kein Abonnent gefunden. Gehen Sie nicht davon aus, dass Wearables-Daten den FHIR-Speicher erreichen.

Vitalwerte ablesen​

GET /api/v1/patients/{patientId}/vitals (erfordert ein JWT mit einem organization_id Claim). Sowohl die Registerkarte „Vitals“ als auch der Workflow-Knoten device-data-source verwenden es.

ParameterBedeutungStandard
typeEin Metrikname (siehe unten). Ein leerer Wert gibt alle Metriken zurück, für die Daten vorhanden sind.alle
resolutionraw, hourly oder daily. Gilt nur für heart_rate; andere Metriken werden unverändert zurückgegeben.hourly
from, toRFC 3339-Zeitstempel, abgerundet auf den Beginn des UTC-Tages.gestern bis heute Abend (UTC)

Der Zeitraum ist auf 30 Tage begrenzt. Parameter, die die Konsole ebenfalls sendet, wie z. B. limit und metric, werden ignoriert.

Metrische Bezeichnungen: heart_rate (bpm), resting_heart_rate (bpm), spo2 (%), steps, sleep (Stunden), calories (kcal), active_minutes (min), distance (km), breathing_rate (brpm), heart_rate_variability (ms), skin_temp und skin_temperature (Grad C), weight (kg), bmi, recovery_score (Prozent), strain_score.

Die Antwort ist {"vitals": [...]}, ein Eintrag pro Metrik mit Daten:

{
"vitals": [
{
"patient_id": "00000000-0000-4000-8000-000000000001",
"device_id": "00000000-0000-4000-8000-0000000000d1",
"metric": "heart_rate",
"unit": "bpm",
"data_points": [
{"timestamp": "2026-01-01T08:00:00Z", "value": 71.5, "source_device_id": "00000000-0000-4000-8000-0000000000d1"}
],
"summary": {"min": 71.5, "max": 71.5, "avg": 71.5, "count": 1}
}
]
}

Wenn der Patient in Ihrer Organisation kein aktives Gerät hat, erhalten Sie {"vitals": []}, keine Fehlermeldung.

Warnmeldungen​

Benachrichtigungen und Regeln in der Konsole werden vom IoT-Dienst von Connect bereitgestellt, nicht vom Wearables-Dienst. Der Wearables-Dienst verfügt zwar über /alerts und /thresholds Routen, diese liefern jedoch leere Listen und haben keine Auswirkung.

Unter Alerts öffnet Define den Regeleditor:

FeldBedeutung
Regelname, BeschreibungFreitext.
SchwereInfo, Warnung, Hoch, Kritisch.
MessungEiner der folgenden Werte: Herzfrequenz, SpO2, Blutdruck, Temperatur, Glukose, Atmung, EKG, Gewicht, Spirometrie (gespeichert als HEART_RATE, PULSE_OXIMETRY, BLOOD_PRESSURE, BODY_TEMPERATURE, BLOOD_GLUCOSE, RESPIRATORY_RATE, ECG, WEIGHT, SPIROMETRY).
Zustand (CEL-Ausdruck)Bei jeder Messung wird eine Auswertung vorgenommen; die Warnung wird ausgelöst, wenn die Messung zutrifft.
Abklingzeit (Min.)Standardwert 5.
GeltenAlle Geräte, Bestimmte Geräte, Organisationseinheiten.

Vordefinierte Vorlagen für die jeweilige Bedingung: value < 90 (SpO2), value > 120 und value < 50 (Herzfrequenz), systolic > 180 und systolic < 90 (Blutdruck), value > 39.0 (Temperatur), value > 250 und value < 70 (Glukose). Für Blutdruckmessungen können beispielsweise die Vorlagen systolic und diastolic verwendet werden, etwa systolic > 180 || diastolic > 110.

Aktive Benachrichtigungen verfügen über eine Acknowledge Schaltfläche. Regeln können ein- und ausgeschaltet, bearbeitet und gelöscht werden.

Einstellungen und Automatisierungen​

  • Settings verfügt über drei Unterregisterkarten, die alle für die aktuelle Organisation gespeichert sind: Schwellenwerte (Warn- und kritische Vitalzeichen-Schwellenwerte), Ziele (wohin Gerätedaten weitergeleitet werden) und Organisation (Hierarchie der Patientenversorgung).
  • Automations listet die Synchronisierungsfrequenz jedes tragbaren Geräts (Manual, oder Every <n>m, Every <n>h), eine Sync now Aktion, laufende und kürzlich ausgeführte Synchronisierungsaufträge sowie bereitgestellte Pipelines mit ihrem Cron-Zeitplan und eine Run now Aktion auf.

Gerätedaten in einem Workflow verwenden​

Der Knoten device-data-source (Kategorie Gesundheitswesen) ruft die Messwerte eines Patienten für ein Zeitfenster ab und führt Daten von Wearables und IoT-Geräten zusammen.

KonfigurationsfeldBedeutungStandard
patient_idPatienten-ID; unterstützt {{token}} von den Pipeline-Eingängen, ansonsten wird der Eingangsport patient_id verwendet. Erforderlich.keiner
window{"from": "...", "to": "..."} ISO-8601. Bei leeren Werten werden die Ports window_from und window_to verwendet.leer
metricsMetrische Namen, wie z. B. heart_rate, steps, sleep.["heart_rate"]
sourceswearables, iot oder beides.["wearables"]

Ausgabeport data (json): patient_id, window, sources, metrics (pro Metrik: summary, raw_url, iot_summary), warnings, alerts, devices. Im Code sind alerts und devices immer leere Listen.

Für die Wearables-Quelle ruft der Knoten die Vitals-API mit resolution=daily auf und signiert ein 5-Minuten-Service-JWT, wenn eine org_id. Eingabe und das JWT-Geheimnis vorhanden sind. Die IoT-Quelle ruft Connects /api/analyses/internal/iot-summary auf. Schlägt eine einzelne Metrik fehl, fügt der Knoten eine Warnung hinzu. Schlägt jede Metrik fehl, schlägt der Knoten mit no device data could be read for patient <id>: ... fehl, sodass ein nachgelagerter Agent niemals mit erfundenen Zahlen arbeiten kann. Ein fehlender Patient schlägt mit patient_id is required fehl.

Nicht verfügbar​

  • Schreiben von Messwerten tragbarer Geräte in FHIR als Beobachtungen und LOINC-Codierung von Daten tragbarer Geräte.
  • Datenerfassung von Garmin, Oura, Polar, Suunto, Samsung Health und Apple Health auf dem laufenden Server (der Code ist im Repository vorhanden, aber nicht eingebunden) sowie Movesense.
  • Webhook-basierte Synchronisierung für Fitbit und Garmin (Handler sind vorhanden, aber nicht eingebunden und protokollieren lediglich). Nur WHOOP-Webhooks sind aktiv.
  • Wearables-Dienst-Alarmregeln und Schwellenwerte (Stub-Routen).
  • Eine Datenvorschau für eine verbundene Einladung (preview_unavailable_reason: "not_implemented").

Fehlerbehebung​

SymptomUrsache und Lösung
Eine Registerkarte fehlt.Sie verfügen nicht über die erforderlichen Berechtigungen in der obigen Tabelle. Wenden Sie sich an einen Administrator.
Die Schaltfläche für den E-Mail- oder SMS-Versand ist ausgegraut.SendGrid oder Twilio ist nicht konfiguriert. Verwenden Sie QR code oder Copy link.
invitation not found / expired / This link is no longer valid (Patientenseite)Falsches Token, älter als 7 Tage oder widerrufen. Bitte senden Sie die Einladung erneut oder erstellen Sie eine neue.
too many requestsDer Token wurde innerhalb einer Stunde mehr als 30 Mal geöffnet. Warten Sie eine Stunde.
Garmin- oder Oura-Gerät angeschlossen, keine MesswerteDie Synchronisierungs-Engine unterstützt diese Anbieter nicht. Siehe die Anbietertabelle.
Im Reiter „Vitalwerte“ steht: „Für diesen Patienten liegen keine Messwerte von tragbaren Geräten vor.“Für diesen Patienten ist in Ihrer Organisation kein aktives Gerät vorhanden oder es liegen keine Messwerte im relevanten Bereich vor (der Bereich ist auf 30 Tage begrenzt). Führen Sie Sync now aus und überprüfen Sie das Synchronisierungsprotokoll.
Missing organization context (401)Das Token hat keinen organization_id Claim.

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..