Virtuella enheter

En virtuell enhet är en enhet på HAM-plattformen utan hårdvara. Dess avläsningar kommer från ditt eget system via API, inte från en HAM-givare.

Därefter fungerar den virtuella enheten som alla andra enheter: diagram, historik, regler, rapporter och delning.

När du använder den

• Du har en givare eller ett system från en annan tillverkare och du vill ha dess värden i HAM-appen.
• Du vill ha regler och aviseringar för värden som din egen programvara beräknar.

Grunder

Objekt	Värde
Familj	v (Virtuell HAM). Serienumret är till exempel v:123.
Avläsningar	Upp till 6, med koderna u0, u1, u2, u3, u4, u5
Utgångar	Inga
Keep-alive	Ingen. Enheten ändras bara när du skickar värden.

Appen har ingen skärm för att skapa en virtuell enhet. För en ny virtuell enhet, kontakta support.

Skicka värden

Skicka en POST till virtual_device_update.php. Du behöver administratörsbehörighet på enheten.

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

Fält	Innehåll
serialno	Den virtuella enhetens serienummer
R	Avläsningarna, med koden som nyckel (u0 till u5)
untime	Valfri. Mätningens tid i unix-sekunder. Utan den använder servern den aktuella tiden.

Servern behåller bara fälten serialno, R och untime. Den ignorerar alla andra fält.

Svaret är JSON med messages och response.

Felmeddelande	Orsak
Invalid arguments	serialno saknas.
Invalid login	Nyckeln eller token är inte korrekt.
Access denied to device	Du har inte administratörsbehörighet på enheten.

Läsa

Du läser värdena på samma sätt som för alla enheter:

• REST API för det aktuella tillståndet.
• Ladda ner historiska data för historiken.
• WebSocket för ändringar i realtid.