Virtuālās ierīces

Virtuālā ierīce ir ierīce HAM platformā bez aparatūras. Tās mērījumi nāk no jūsu sistēmas caur API, nevis no HAM sensora.

Pēc tam virtuālā ierīce darbojas kā visas citas ierīces: diagrammas, vēsture, noteikumi, atskaites un koplietošana.

Kad to izmantot

• Jums ir cita ražotāja sensors vai sistēma, un jūs vēlaties tās vērtības HAM lietotnē.
• Jūs vēlaties noteikumus un paziņojumus vērtībām, ko aprēķina jūsu programmatūra.

Pamati

Elements	Vērtība
Saime	v (Virtual HAM). Sērijas numurs ir, piemēram, v:123.
Mērījumi	Līdz 6, ar kodiem u0, u1, u2, u3, u4, u5
Izejas	Nav
Uzturēšanas signāls	Nav. Ierīce mainās tikai tad, kad jūs sūtāt vērtības.

Lietotnē nav ekrāna, lai izveidotu virtuālo ierīci. Jaunai virtuālajai ierīcei sazinieties ar atbalstu.

Vērtību sūtīšana

Sūtiet POST uz virtual_device_update.php. Jums vajag administratora atļauju ierīcei.

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

Lauks	Saturs
serialno	Virtuālās ierīces sērijas numurs
R	Mērījumi ar kodu kā atslēgu (u0 līdz u5)
untime	Neobligāts. Mērījuma laiks unix sekundēs. Bez tā serveris izmanto pašreizējo laiku.

Serveris saglabā tikai laukus serialno, R un untime. Tas ignorē visus citus laukus.

Atbilde ir JSON ar messages un response.

Kļūdas ziņojums	Cēlonis
Invalid arguments	Trūkst serialno.
Invalid login	Atslēga vai marķieris nav pareizs.
Access denied to device	Jums nav administratora atļaujas ierīcei.

Lasīšana

Jūs lasāt vērtības tāpat kā visām ierīcēm:

• REST API pašreizējam stāvoklim.
• Vēsturisko datu lejupielāde vēsturei.
• WebSocket tiešsaistes izmaiņām.