Εικονικές συσκευές

Μια εικονική συσκευή είναι μια συσκευή στην πλατφόρμα HAM χωρίς υλικό. Οι μετρήσεις της έρχονται από δικό σας σύστημα μέσω του API, όχι από αισθητήρα HAM.

Μετά η εικονική συσκευή λειτουργεί όπως κάθε άλλη συσκευή: γραφήματα, ιστορικό, κανόνες, αναφορές και διαμοιρασμός.

Πότε τη χρησιμοποιείτε

• Έχετε έναν αισθητήρα ή ένα σύστημα τρίτου κατασκευαστή και θέλετε τις τιμές του στην εφαρμογή HAM.
• Θέλετε κανόνες και ειδοποιήσεις για τιμές που υπολογίζει το δικό σας λογισμικό.

Τα βασικά

Στοιχείο	Τιμή
Οικογένεια	v (Virtual HAM). Ο σειριακός αριθμός είναι π.χ. v:123.
Μετρήσεις	Έως 6, με κωδικούς u0, u1, u2, u3, u4, u5
Έξοδοι	Καμία
Σήμα ζωής	Δεν υπάρχει. Η συσκευή αλλάζει μόνο όταν στέλνετε τιμές.

Η εφαρμογή δεν έχει οθόνη για να δημιουργήσετε εικονική συσκευή. Για μια νέα εικονική συσκευή, επικοινωνήστε με την υποστήριξη.

Αποστολή τιμών

Στείλτε POST στο virtual_device_update.php. Χρειάζεστε δικαίωμα διαχειριστή στη συσκευή.

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

Πεδίο	Περιεχόμενο
serialno	Ο σειριακός αριθμός της εικονικής συσκευής
R	Οι μετρήσεις, με κλειδί τον κωδικό (u0 έως u5)
untime	Προαιρετικό. Ο χρόνος της μέτρησης σε δευτερόλεπτα unix. Χωρίς αυτό ο διακομιστής χρησιμοποιεί την τρέχουσα ώρα.

Ο διακομιστής κρατά μόνο τα πεδία serialno, R και untime. Αγνοεί τα άλλα πεδία.

Η απάντηση είναι JSON με messages και response.

Μήνυμα σφάλματος	Αιτία
Invalid arguments	Λείπει το serialno.
Invalid login	Το κλειδί ή το token δεν είναι σωστό.
Access denied to device	Δεν έχετε δικαίωμα διαχειριστή στη συσκευή.

Ανάγνωση

Διαβάζετε τις τιμές με τους ίδιους τρόπους όπως σε κάθε συσκευή:

• REST API για την τρέχουσα κατάσταση.
• Λήψη ιστορικών δεδομένων για το ιστορικό.
• WebSocket για ζωντανές αλλαγές.