Sýndartæki

Sýndartæki er tæki á HAM-kerfinu án vélbúnaðar. Mælingar þess koma úr þínu eigin kerfi í gegnum API, ekki frá HAM-skynjara.

Eftir það virkar sýndartækið eins og öll önnur tæki: gröf, saga, reglur, skýrslur og deiling.

Hvenær þú notar það

• Þú ert með skynjara eða kerfi frá öðrum framleiðanda og þú vilt gildi þess í HAM-appinu.
• Þú vilt reglur og tilkynningar fyrir gildi sem þinn eigin hugbúnaður reiknar.

Grunnatriði

Atriði	Gildi
Fjölskylda	v (Virtual HAM). Raðnúmerið er til dæmis v:123.
Mælingar	Allt að 6, með kóðunum u0, u1, u2, u3, u4, u5
Úttök	Engin
Lífsmerki	Ekkert. Tækið breytist aðeins þegar þú sendir gildi.

Appið hefur engan skjá til að búa til sýndartæki. Fyrir nýtt sýndartæki skaltu hafa samband við þjónustuver.

Senda gildi

Sendu POST til virtual_device_update.php. Þú þarft stjórnandaheimild á tækinu.

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

Reitur	Innihald
serialno	Raðnúmer sýndartækisins
R	Mælingarnar, eftir kóða (u0 til u5)
untime	Valfrjálst. Tími mælingarinnar í Unix-sekúndum. Án hans notar netþjónninn núverandi tíma.

Netþjónninn heldur aðeins reitunum serialno, R og untime. Hann hunsar alla aðra reiti.

Svarið er JSON með messages og response.

Villuboð	Orsök
Invalid arguments	serialno vantar.
Invalid login	Lykillinn eða táknið er ekki rétt.
Access denied to device	Þú hefur ekki stjórnandaheimild á tækinu.

Lesa

Þú lest gildin á sama hátt og fyrir öll tæki:

• REST API fyrir núverandi stöðu.
• Sækja söguleg gögn fyrir söguna.
• WebSocket fyrir breytingar í rauntíma.