Dispositivi virtuali

Un dispositivo virtuale è un dispositivo nella piattaforma HAM senza hardware. Le sue misurazioni arrivano dal Suo sistema tramite l’API, non da un sensore HAM.

Dopo questo, il dispositivo virtuale funziona come tutti gli altri dispositivi: grafici, storico, regole, report e condivisione.

Quando usarlo

• Ha un sensore o un sistema di un altro produttore e desidera i suoi valori nell’app HAM.
• Desidera regole e notifiche per valori che il Suo software calcola.

Nozioni di base

Elemento	Valore
Famiglia	v (Virtual HAM). Il numero di serie è, per esempio, v:123.
Misurazioni	Fino a 6, con i codici u0, u1, u2, u3, u4, u5
Uscite	Nessuna
Keep-alive	Nessuno. Il dispositivo cambia solo quando invia valori.

L’app non ha una schermata per creare un dispositivo virtuale. Per un nuovo dispositivo virtuale, contatti l’assistenza.

Inviare valori

Invii un POST a virtual_device_update.php. Ha bisogno del permesso di amministratore sul dispositivo.

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

Campo	Contenuto
serialno	Il numero di serie del dispositivo virtuale
R	Le misurazioni, con il codice come chiave (da u0 a u5)
untime	Facoltativo. L’ora della misurazione in secondi unix. Senza questo campo, il server usa l’ora attuale.

Il server conserva solo i campi serialno, R e untime. Ignora tutti gli altri campi.

La risposta è JSON con messages e response.

Messaggio di errore	Causa
Invalid arguments	serialno manca.
Invalid login	La chiave o il token non è corretto.
Access denied to device	Non ha il permesso di amministratore sul dispositivo.

Leggere

Legge i valori negli stessi modi di tutti i dispositivi:

• API REST per lo stato attuale.
• Scaricare i dati storici per lo storico.
• WebSocket per le variazioni in tempo reale.