Sanal cihazlar

Sanal cihaz, HAM platformunda donanımı olmayan bir cihazdır. Ölçümleri bir HAM sensöründen değil, API üzerinden kendi sisteminizden gelir.

Bundan sonra sanal cihaz diğer tüm cihazlar gibi çalışır: grafikler, geçmiş, kurallar, raporlar ve paylaşım.

Ne zaman kullanılır

Farklı bir üreticiden bir sensörünüz veya bir sisteminiz var ve onun değerlerini HAM uygulamasında istiyorsunuz.
Kendi yazılımınızın hesapladığı değerler için kurallar ve bildirimler istiyorsunuz.

Temel bilgiler

Öğe	Değer
Aile	`v` (Virtual HAM). Seri numarası örneğin `v:123` şeklindedir.
Ölçümler	`u0`, `u1`, `u2`, `u3`, `u4`, `u5` kodlarıyla en fazla 6
Çıkışlar	Yok
Canlı tutma	Yok. Cihaz yalnızca siz değer gönderdiğinizde değişir.

Uygulamada sanal cihaz oluşturmak için bir ekran yoktur. Yeni bir sanal cihaz için destekle iletişime geçin.

Değer gönderme

virtual_device_update.php adresine bir POST gönderin. Cihaz üzerinde yönetici iznine ihtiyacınız vardır.

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

Alan	İçerik
`serialno`	Sanal cihazın seri numarası
`R`	Koda göre (`u0` ile `u5` arası) ölçümler
`untime`	İsteğe bağlı. Unix saniyesi olarak ölçüm zamanı. Bu alan olmadan sunucu geçerli zamanı kullanır.

Sunucu yalnızca serialno, R ve untime alanlarını tutar. Diğer tüm alanları yok sayar.

Yanıt, messages ve response içeren JSON’dur.

Hata mesajı	Neden
`Invalid arguments`	`serialno` eksik.
`Invalid login`	Anahtar veya token doğru değil.
`Access denied to device`	Cihaz üzerinde yönetici izniniz yok.

Okuma

Değerleri tüm cihazlarda olduğu gibi aynı yollarla okursunuz:

Geçerli durum için REST API.
Geçmiş için Geçmiş verileri indirme.
Canlı değişiklikler için WebSocket.

Destekle sohbet