Dispositivos virtuales

Un dispositivo virtual es un dispositivo de la plataforma HAM sin hardware. Sus lecturas vienen de su propio sistema mediante la API, no de un sensor HAM.

Después, el dispositivo virtual funciona como todos los demás dispositivos: gráficos, historial, reglas, informes y uso compartido.

Cuándo usarlo

Tiene un sensor o un sistema de otro fabricante y quiere sus valores en la app HAM.
Quiere reglas y notificaciones para valores que calcula su propio software.

Conceptos básicos

Elemento	Valor
Familia	`v` (Virtual HAM). El número de serie es, por ejemplo, `v:123`.
Lecturas	Hasta 6, con los códigos `u0`, `u1`, `u2`, `u3`, `u4`, `u5`
Salidas	Ninguna
Mantenimiento de conexión	Ninguno. El dispositivo cambia solo cuando usted envía valores.

La app no tiene una pantalla para crear un dispositivo virtual. Para un dispositivo virtual nuevo, contacte con soporte.

Enviar valores

Envíe un POST a virtual_device_update.php. Necesita permiso de administrador en el 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	Contenido
`serialno`	El número de serie del dispositivo virtual
`R`	Las lecturas, con el código como clave (`u0` a `u5`)
`untime`	Opcional. La hora de la medición en segundos unix. Sin él, el servidor usa la hora actual.

El servidor conserva solo los campos serialno, R y untime. Ignora todos los demás campos.

La respuesta es JSON con messages y response.

Mensaje de error	Causa
`Invalid arguments`	Falta `serialno`.
`Invalid login`	La clave o el token no son correctos.
`Access denied to device`	No tiene permiso de administrador en el dispositivo.

Leer

Usted lee los valores de las mismas maneras que en todos los dispositivos:

API REST para el estado actual.
Descargar datos históricos para el historial.
WebSocket para los cambios en directo.

Chat con soporte