Virtuaalsed seadmed

Virtuaalne seade on seade HAM platvormil ilma riistvarata. Selle näidud tulevad teie enda süsteemist API kaudu, mitte HAM andurist.

Pärast seda töötab virtuaalne seade nagu kõik teised seadmed: graafikud, ajalugu, reeglid, aruanded ja jagamine.

Millal seda kasutada

Teil on teise tootja andur või süsteem ja soovite selle väärtusi HAM rakenduses.
Soovite reegleid ja teavitusi väärtuste jaoks, mida teie enda tarkvara arvutab.

Põhitõed

Üksus	Väärtus
Perekond	`v` (Virtual HAM). Seerianumber on näiteks `v:123`.
Näidud	Kuni 6, koodidega `u0`, `u1`, `u2`, `u3`, `u4`, `u5`
Väljundid	Puuduvad
Ühenduse hoidmine	Puudub. Seade muutub ainult siis, kui saadate väärtusi.

Rakenduses ei ole virtuaalse seadme loomise ekraani. Uue virtuaalse seadme jaoks võtke ühendust toega.

Väärtuste saatmine

Saatke POST aadressile virtual_device_update.php. Vajate seadmele administraatori õigust.

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

Väli	Sisu
`serialno`	Virtuaalse seadme seerianumber
`R`	Näidud, võtmeks kood (`u0` kuni `u5`)
`untime`	Valikuline. Mõõtmise aeg unix sekundites. Ilma selleta kasutab server praegust aega.

Server hoiab ainult välju serialno, R ja untime. Kõiki teisi välju see eirab.

Vastus on JSON koos väljadega messages ja response.

Veateade	Põhjus
`Invalid arguments`	`serialno` puudub.
`Invalid login`	Võti või juurdepääsuluba ei ole õige.
`Access denied to device`	Teil ei ole seadmele administraatori õigust.

Lugemine

Väärtusi loete samal viisil nagu kõigi seadmete puhul:

REST API praeguse oleku jaoks.
Ajalooliste andmete allalaadimine ajaloo jaoks.
WebSocket reaalajas muutuste jaoks.

Vestle toega