Virtuelle enheter

En virtuell enhet er en enhet på HAM-plattformen uten maskinvare. Avlesningene kommer fra ditt eget system gjennom API-et, ikke fra en HAM-sensor.

Etter det virker den virtuelle enheten som alle andre enheter: grafer, historikk, regler, rapporter og deling.

Når du bruker den

• Du har en sensor eller et system fra en annen produsent, og du vil ha verdiene i HAM-appen.
• Du vil ha regler og varsler for verdier som din egen programvare beregner.

Grunnleggende

Punkt	Verdi
Familie	v (Virtual HAM). Serienummeret er for eksempel v:123.
Avlesninger	Opptil 6, med kodene u0, u1, u2, u3, u4, u5
Utganger	Ingen
Keep-alive	Ingen. Enheten endres bare når du sender verdier.

Appen har ingen skjerm for å lage en virtuell enhet. For en ny virtuell enhet, kontakt kundestøtte.

Send verdier

Send en POST til virtual_device_update.php. Du trenger administratortilgang til 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}}'

Felt	Innhold
serialno	Serienummeret til den virtuelle enheten
R	Avlesningene, med koden som nøkkel (u0 til u5)
untime	Valgfritt. Tiden for målingen i unix-sekunder. Uten den bruker serveren den aktuelle tiden.

Serveren beholder bare feltene serialno, R og untime. Den ignorerer alle andre felt.

Svaret er JSON med messages og response.

Feilmelding	Årsak
Invalid arguments	serialno mangler.
Invalid login	Nøkkelen eller tokenet er ikke riktig.
Access denied to device	Du har ikke administratortilgang til enheten.

Les

Du leser verdiene på de samme måtene som for alle enheter:

• REST API for den aktuelle tilstanden.
• Last ned historiske data for historikken.
• WebSocket for endringer i sanntid.