Urządzenia wirtualne

Urządzenie wirtualne to urządzenie na platformie HAM bez sprzętu. Jego odczyty pochodzą z Twojego systemu przez API, a nie z czujnika HAM.

Potem urządzenie wirtualne działa jak wszystkie inne urządzenia: wykresy, historia, reguły, raporty i udostępnianie.

Kiedy go używać

• Masz czujnik lub system innego producenta i chcesz widzieć jego wartości w aplikacji HAM.
• Chcesz reguły i powiadomienia dla wartości, które oblicza Twoje oprogramowanie.

Podstawy

Element	Wartość
Rodzina	v (Virtual HAM). Numer seryjny to na przykład v:123.
Odczyty	Do 6, z kodami u0, u1, u2, u3, u4, u5
Wyjścia	Brak
Sygnał podtrzymania	Brak. Urządzenie zmienia się tylko wtedy, gdy wysyłasz wartości.

Aplikacja nie ma ekranu do tworzenia urządzenia wirtualnego. Dla nowego urządzenia wirtualnego skontaktuj się ze wsparciem.

Wysyłanie wartości

Wyślij POST do virtual_device_update.php. Potrzebujesz uprawnienia administratora do urządzenia.

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

Pole	Zawartość
serialno	Numer seryjny urządzenia wirtualnego
R	Odczyty, według kodu (u0 do u5)
untime	Opcjonalne. Czas pomiaru w sekundach unix. Bez niego serwer używa bieżącego czasu.

Serwer zachowuje tylko pola serialno, R i untime. Ignoruje wszystkie inne pola.

Odpowiedź to JSON z messages i response.

Komunikat błędu	Przyczyna
Invalid arguments	Brakuje serialno.
Invalid login	Klucz lub token są niepoprawne.
Access denied to device	Nie masz uprawnienia administratora do urządzenia.

Odczyt

Wartości odczytujesz tak samo jak dla wszystkich urządzeń:

• REST API dla bieżącego stanu.
• Pobieranie danych historycznych dla historii.
• WebSocket dla zmian na żywo.