Virtuálne zariadenia

Virtuálne zariadenie je zariadenie na platforme HAM bez hardvéru. Jeho merania prichádzajú z vášho systému cez API, nie zo snímača HAM.

Potom virtuálne zariadenie funguje ako všetky ostatné zariadenia: grafy, história, pravidlá, správy a zdieľanie.

Kedy ho použiť

Máte snímač alebo systém od iného výrobcu a chcete jeho hodnoty v aplikácii HAM.
Chcete pravidlá a upozornenia pre hodnoty, ktoré vypočíta váš softvér.

Základy

Položka	Hodnota
Rodina	`v` (Virtual HAM). Sériové číslo je napríklad `v:123`.
Merania	Najviac 6, s kódmi `u0`, `u1`, `u2`, `u3`, `u4`, `u5`
Výstupy	Žiadne
Keep-alive	Žiadny. Zariadenie sa zmení, iba keď pošlete hodnoty.

Aplikácia nemá obrazovku na vytvorenie virtuálneho zariadenia. Pre nové virtuálne zariadenie kontaktujte podporu.

Odoslanie hodnôt

Pošlite POST na virtual_device_update.php. Potrebujete oprávnenie administrátora k zariadeniu.

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

Pole	Obsah
`serialno`	Sériové číslo virtuálneho zariadenia
`R`	Merania, s kódom (`u0` až `u5`) ako kľúčom
`untime`	Voliteľné. Čas merania v sekundách unix. Bez neho server použije aktuálny čas.

Server ponechá iba polia serialno, R a untime. Všetky ostatné polia ignoruje.

Odpoveď je JSON s messages a response.

Chybová správa	Príčina
`Invalid arguments`	Chýba `serialno`.
`Invalid login`	Kľúč alebo token nie je správny.
`Access denied to device`	Nemáte oprávnenie administrátora k zariadeniu.

Čítanie

Hodnoty čítate rovnakými spôsobmi ako pri všetkých zariadeniach:

REST API pre aktuálny stav.
Stiahnutie historických údajov pre históriu.
WebSocket pre živé zmeny.

Chat s podporou