Virtuaalilaitteet

Virtuaalilaite on HAM-alustan laite ilman laitteistoa. Sen mittaukset tulevat omasta järjestelmästäsi API:n kautta, eivät HAM-anturista.

Sen jälkeen virtuaalilaite toimii kuten kaikki muut laitteet: kaaviot, historia, säännöt, raportit ja jakaminen.

Milloin käytät sitä

• Sinulla on toisen valmistajan anturi tai järjestelmä, ja haluat sen arvot HAM-sovellukseen.
• Haluat sääntöjä ja ilmoituksia arvoille, jotka oma ohjelmistosi laskee.

Perusteet

Kohde	Arvo
Perhe	v (Virtual HAM). Sarjanumero on esimerkiksi v:123.
Mittaukset	Enintään 6, koodeilla u0, u1, u2, u3, u4, u5
Lähdöt	Ei mitään
Ylläpitoviesti	Ei mitään. Laite muuttuu vain, kun lähetät arvoja.

Sovelluksessa ei ole näyttöä virtuaalilaitteen luomiseen. Uutta virtuaalilaitetta varten ota yhteyttä tukeen.

Lähetä arvoja

Lähetä POST osoitteeseen virtual_device_update.php. Tarvitset laitteen ylläpitäjän oikeuden.

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

Kenttä	Sisältö
serialno	Virtuaalilaitteen sarjanumero
R	Mittaukset, avaimena koodi (u0…u5)
untime	Valinnainen. Mittauksen aika unix-sekunteina. Ilman sitä palvelin käyttää nykyistä aikaa.

Palvelin säilyttää vain kentät serialno, R ja untime. Se ohittaa kaikki muut kentät.

Vastaus on JSON, jossa on messages ja response.

Virheviesti	Syy
Invalid arguments	serialno puuttuu.
Invalid login	Avain tai tunnus ei ole oikea.
Access denied to device	Sinulla ei ole laitteen ylläpitäjän oikeutta.

Lue

Luet arvot samoilla tavoilla kuin kaikista laitteista:

• REST API nykyiselle tilalle.
• Lataa historiatiedot historialle.
• WebSocket reaaliaikaisille muutoksille.