Virtualni uređaji

Virtualni uređaj je uređaj na HAM platformi bez hardvera. Njegova mjerenja dolaze iz vašeg vlastitog sustava putem API-ja, a ne iz HAM senzora.

Nakon toga virtualni uređaj radi kao svi ostali uređaji: grafikoni, povijest, pravila, izvješća i dijeljenje.

Kada ga koristiti

• Imate senzor ili sustav drugog proizvođača i želite njegove vrijednosti u HAM aplikaciji.
• Želite pravila i obavijesti za vrijednosti koje izračunava vaš vlastiti softver.

Osnove

Stavka	Vrijednost
Obitelj	v (Virtual HAM). Serijski broj je, na primjer, v:123.
Mjerenja	Do 6, s kodovima u0, u1, u2, u3, u4, u5
Izlazi	Nema
Održavanje veze	Nema. Uređaj se mijenja samo kada pošaljete vrijednosti.

Aplikacija nema zaslon za izradu virtualnog uređaja. Za novi virtualni uređaj obratite se podršci.

Slanje vrijednosti

Pošaljite POST na virtual_device_update.php. Trebate administratorsko dopuštenje na uređaju.

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

Polje	Sadržaj
serialno	Serijski broj virtualnog uređaja
R	Mjerenja, po kodu (u0 do u5)
untime	Neobavezno. Vrijeme mjerenja u unix sekundama. Bez njega poslužitelj koristi trenutačno vrijeme.

Poslužitelj zadržava samo polja serialno, R i untime. Sva ostala polja zanemaruje.

Odgovor je JSON s messages i response.

Poruka o grešci	Uzrok
Invalid arguments	serialno nedostaje.
Invalid login	Ključ ili token nisu ispravni.
Access denied to device	Nemate administratorsko dopuštenje na uređaju.

Čitanje

Vrijednosti čitate na iste načine kao za sve uređaje:

• REST API za trenutačno stanje.
• Preuzimanje povijesnih podataka za povijest.
• WebSocket za promjene uživo.