Virtuális eszközök

A virtuális eszköz egy hardver nélküli eszköz a HAM platformon. A mérései a saját rendszeréből érkeznek az API-n keresztül, nem egy HAM érzékelőtől.

Ezután a virtuális eszköz úgy működik, mint minden más eszköz: diagramok, előzmények, szabályok, jelentések és megosztás.

Mikor használja

• Van egy másik gyártótól származó érzékelője vagy rendszere, és látni szeretné az értékeit a HAM alkalmazásban.
• Szabályokat és értesítéseket szeretne olyan értékekhez, amelyeket a saját szoftvere számít ki.

Alapok

Elem	Érték
Család	v (Virtual HAM). A sorozatszám például v:123.
Mérések	Legfeljebb 6, a u0, u1, u2, u3, u4, u5 kódokkal
Kimenetek	Nincsenek
Kapcsolatfenntartás	Nincs. Az eszköz csak akkor változik, amikor értékeket küld.

Az alkalmazásban nincs képernyő virtuális eszköz létrehozásához. Új virtuális eszközhöz forduljon az ügyfélszolgálathoz.

Értékek küldése

Küldjön POST kérést a virtual_device_update.php végpontra. Rendszergazdai jogosultság kell az eszközhöz.

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}}'

Mező	Tartalom
serialno	A virtuális eszköz sorozatszáma
R	A mérések, kód szerint (u0-tól u5-ig)
untime	Nem kötelező. A mérés időpontja unix másodpercben. Nélküle a szerver az aktuális időt használja.

A szerver csak a serialno, az R és az untime mezőt tartja meg. Minden más mezőt figyelmen kívül hagy.

A válasz JSON, messages és response mezővel.

Hibaüzenet	Ok
Invalid arguments	Hiányzik a serialno.
Invalid login	A kulcs vagy a token nem helyes.
Access denied to device	Nincs rendszergazdai jogosultsága az eszközhöz.

Olvasás

Az értékeket ugyanúgy olvassa, mint minden eszköznél:

• REST API az aktuális állapothoz.
• Előzményadatok letöltése az előzményekhez.
• WebSocket az élő változásokhoz.