Dispositivos virtuais

Um dispositivo virtual é um dispositivo na plataforma HAM sem hardware. As leituras dele vêm do seu próprio sistema através da API, não de um sensor HAM.

Depois disso, o dispositivo virtual funciona como todos os outros dispositivos: gráficos, histórico, regras, relatórios e partilha.

Quando o utilizar

• Tem um sensor ou um sistema de outro fabricante e quer os valores dele na aplicação HAM.
• Quer regras e notificações para valores que o seu próprio software calcula.

Princípios básicos

Item	Valor
Família	v (Virtual HAM). O número de série é, por exemplo, v:123.
Leituras	Até 6, com os códigos u0, u1, u2, u3, u4, u5
Saídas	Nenhuma
Keep-alive	Nenhum. O dispositivo muda apenas quando envia valores.

A aplicação não tem um ecrã para criar um dispositivo virtual. Para um novo dispositivo virtual, contacte o apoio.

Enviar valores

Envie um POST para virtual_device_update.php. Precisa de permissão de administrador no 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	Conteúdo
serialno	O número de série do dispositivo virtual
R	As leituras, com o código como chave (u0 a u5)
untime	Opcional. A hora da medição em segundos unix. Sem ele, o servidor utiliza a hora atual.

O servidor guarda apenas os campos serialno, R e untime. Ignora todos os outros campos.

A resposta é JSON com messages e response.

Mensagem de erro	Causa
Invalid arguments	Falta serialno.
Invalid login	A chave ou o token não está correto.
Access denied to device	Não tem permissão de administrador no dispositivo.

Ler

Lê os valores das mesmas formas que para todos os dispositivos:

• API REST para o estado atual.
• Transferir dados históricos para o histórico.
• WebSocket para as alterações em direto.