Virtualūs įrenginiai
Virtualus įrenginys yra HAM platformos įrenginys be aparatinės įrangos. Jo rodmenys ateina iš Jūsų sistemos per API, ne iš HAM jutiklio.
Po to virtualus įrenginys veikia kaip visi kiti įrenginiai: grafikai, istorija, taisyklės, ataskaitos ir bendrinimas.
Kada jį naudoti
Skyrius „Kada jį naudoti“- Turite kito gamintojo jutiklį arba sistemą ir norite jos reikšmių HAM programėlėje.
- Norite taisyklių ir pranešimų reikšmėms, kurias apskaičiuoja Jūsų programinė įranga.
Pagrindai
Skyrius „Pagrindai“| Elementas | Reikšmė |
|---|---|
| Šeima | v (Virtual HAM). Serijos numeris yra, pavyzdžiui, v:123. |
| Rodmenys | Iki 6, su kodais u0, u1, u2, u3, u4, u5 |
| Išvestys | Nėra |
| Ryšio palaikymas | Nėra. Įrenginys keičiasi tik tada, kai siunčiate reikšmes. |
Programėlė neturi ekrano virtualiam įrenginiui sukurti. Dėl naujo virtualaus įrenginio kreipkitės į pagalbą.
Reikšmių siuntimas
Skyrius „Reikšmių siuntimas“Siųskite POST į virtual_device_update.php. Jums reikia įrenginio administratoriaus teisės.
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}}'| Laukas | Turinys |
|---|---|
serialno |
Virtualaus įrenginio serijos numeris |
R |
Rodmenys pagal kodą (u0 iki u5) |
untime |
Neprivaloma. Matavimo laikas unix sekundėmis. Be jo serveris naudoja dabartinį laiką. |
Serveris saugo tik laukus serialno, R ir untime. Visus kitus laukus jis ignoruoja.
Atsakymas yra JSON su messages ir response.
| Klaidos pranešimas | Priežastis |
|---|---|
Invalid arguments |
Trūksta serialno. |
Invalid login |
Raktas arba žetonas neteisingas. |
Access denied to device |
Neturite įrenginio administratoriaus teisės. |
Skaitymas
Skyrius „Skaitymas“Reikšmes skaitote tais pačiais būdais kaip visų įrenginių:
- REST API dabartinei būsenai.
- Istorinių duomenų atsisiuntimas istorijai.
- WebSocket tiesioginiams pokyčiams.

