Virtuelle Geräte

Ein virtuelles Gerät ist ein Gerät auf der HAM Plattform ohne Hardware. Seine Messwerte kommen über die API aus Ihrem eigenen System, nicht von einem HAM Sensor.

Danach funktioniert das virtuelle Gerät wie alle anderen Geräte: Diagramme, Verlauf, Regeln, Berichte und Freigabe.

Wann Sie es verwenden

Sie haben einen Sensor oder ein System eines anderen Herstellers und möchten seine Werte in der HAM App sehen.
Sie möchten Regeln und Benachrichtigungen für Werte, die Ihre eigene Software berechnet.

Grundlagen

Element	Wert
Familie	`v` (Virtual HAM). Die Seriennummer ist zum Beispiel `v:123`.
Messwerte	Bis zu 6, mit den Codes `u0`, `u1`, `u2`, `u3`, `u4`, `u5`
Ausgänge	Keine
Keep-alive	Keines. Das Gerät ändert sich nur, wenn Sie Werte senden.

Die App hat keinen Bildschirm, um ein virtuelles Gerät zu erstellen. Für ein neues virtuelles Gerät kontaktieren Sie den Support.

Werte senden

Senden Sie ein POST an virtual_device_update.php. Sie brauchen Admin-Berechtigung auf dem Gerät.

curl -X POST https://api.hamsystems.eu/virtual_device_update.php \
  -H "Authorization: Bearer-API YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"serialno": "v:123", "R": {"u0": 2150, "u1": 48}}'

Feld	Inhalt
`serialno`	Die Seriennummer des virtuellen Geräts
`R`	Die Messwerte, nach Code geordnet (`u0` bis `u5`)
`untime`	Optional. Der Zeitpunkt der Messung in Unix-Sekunden. Ohne dieses Feld verwendet der Server die aktuelle Zeit.

Der Server behält nur die Felder serialno, R und untime. Er ignoriert alle anderen Felder.

Die Antwort ist JSON mit messages und response.

Fehlermeldung	Ursache
`Invalid arguments`	`serialno` fehlt.
`Invalid login`	Der Schlüssel oder der Token ist nicht korrekt.
`Access denied to device`	Sie haben keine Admin-Berechtigung auf dem Gerät.

Lesen

Sie lesen die Werte auf dieselbe Weise wie bei allen Geräten:

REST-API für den aktuellen Zustand.
Historische Daten herunterladen für den Verlauf.
WebSocket für Live-Änderungen.

Chat mit dem Support