Λογισμικό DIVUS VISION API

Προδιαγραφές

• Προϊόν: DIVUS VISION API
• Κατασκευαστής: DIVUS GmbH
• Έκδοση: 1.00 REV0 1 – 20240528
• Τοποθεσία: Pillhof 51, Eppan (BZ), Ιταλία

Πληροφορίες προϊόντος

Το DIVUS VISION API είναι ένα εργαλείο λογισμικού σχεδιασμένο για διασύνδεση με συστήματα DIVUS VISION. Επιτρέπει στους χρήστες να έχουν πρόσβαση και να ελέγχουν διάφορα στοιχεία μέσα στο σύστημα χρησιμοποιώντας πρωτόκολλα MQTT.

FAQ

Ε: Μπορώ να χρησιμοποιήσω το DIVUS VISION API χωρίς προηγούμενη γνώση υπολογιστή ή τεχνολογίας αυτοματισμού;

Α: Το εγχειρίδιο είναι προσαρμοσμένο για χρήστες με προηγούμενες γνώσεις σε αυτούς τους τομείς για να διασφαλιστεί η αποτελεσματική χρήση του API.

ΓΕΝΙΚΕΣ ΠΛΗΡΟΦΟΡΙΕΣ

• DIVUS GmbH Pillhof 51 I-39057 Eppan (BZ) – Ιταλία

Οι οδηγίες λειτουργίας, τα εγχειρίδια και το λογισμικό προστατεύονται από πνευματικά δικαιώματα. Ολα τα δικαιώματα διατηρούνται. Δεν επιτρέπεται η αντιγραφή, η αντιγραφή, η μετάφραση, η ολική ή μερική μετάφραση. Μια εξαίρεση ισχύει για τη δημιουργία αντιγράφου ασφαλείας του λογισμικού για προσωπική χρήση.
Το εγχειρίδιο υπόκειται σε αλλαγές χωρίς προειδοποίηση. Δεν μπορούμε να εγγυηθούμε ότι τα δεδομένα που περιέχονται σε αυτό το έγγραφο και στα μέσα αποθήκευσης που παρέχονται είναι χωρίς σφάλματα και είναι σωστά. Προτάσεις για βελτιώσεις καθώς και υποδείξεις για σφάλματα είναι πάντα ευπρόσδεκτες. Οι συμφωνίες ισχύουν επίσης για τα συγκεκριμένα παραρτήματα αυτού του εγχειριδίου. Οι ονομασίες σε αυτό το έγγραφο μπορεί να είναι εμπορικά σήματα των οποίων η χρήση από τρίτους για δικούς τους σκοπούς ενδέχεται να παραβιάζει τα δικαιώματα των κατόχων τους. Οδηγίες χρήστη: Διαβάστε αυτό το εγχειρίδιο πριν το χρησιμοποιήσετε για πρώτη φορά και φυλάξτε το σε ασφαλές μέρος για μελλοντική αναφορά. Ομάδα στόχος: Το εγχειρίδιο είναι γραμμένο για χρήστες με προηγούμενη γνώση της τεχνολογίας Η/Υ και αυτοματισμού.

ΣΥΜΒΑΣΕΙΣ ΠΑΡΟΥΣΙΑΣΗΣ

Εισαγωγή

ΓΕΝΙΚΗ ΕΙΣΑΓΩΓΗ

Αυτό το εγχειρίδιο περιγράφει το VISION API (Application Programming Interface) – μια διεπαφή μέσω της οποίας το VISION μπορεί να αντιμετωπιστεί και να ελεγχθεί από εξωτερικά συστήματα.
Πρακτικά, αυτό σημαίνει ότι μπορείτε να χρησιμοποιήσετε συστήματα όπως π.χ

• MQTT Explorer (https://www.microsoft.com/store/… - για δοκιμή),
• Βοηθός σπιτιού (https://www.home-assistant.io/) ή
• Κόμβος-ΚΟΚΚΙΝΟ (https://nodered.org/)

για να ελέγξετε τα στοιχεία που διαχειρίζεται το VISION ή να διαβάσετε την κατάστασή τους. Η πρόσβαση και η επικοινωνία πραγματοποιούνται μέσω του πρωτοκόλλου MQTT, το οποίο χρησιμοποιεί τα λεγόμενα θέματα για να αντιμετωπίσει μεμονωμένες λειτουργίες ή σύνολα λειτουργιών ή για να ενημερωθεί για αλλαγές σε αυτές. Για το σκοπό αυτό χρησιμοποιείται διακομιστής MQTT (μεσίτης), ο οποίος χειρίζεται την ασφάλεια και τη διαχείριση/διανομή των μηνυμάτων στους συμμετέχοντες. Σε αυτήν την περίπτωση, ο διακομιστής MQTT βρίσκεται απευθείας στο DIVUS KNX IQ και είναι ειδικά διαμορφωμένος για αυτό το σκοπό. Αν και το VISION API μπορεί επίσης να χρησιμοποιηθεί χωρίς γνώσεις προγραμματισμού, αυτή η λειτουργία είναι κατάλληλη για προχωρημένους χρήστες.

ΠΡΟΫΠΟΘΕΣΕΙΣ

Όπως εξηγείται στο εγχειρίδιο VISION, ο χρήστης API πρέπει από προεπιλογή να ενεργοποιηθεί πρώτα για να μπορεί να το χρησιμοποιήσει, η πρόσβαση στο API λειτουργεί μόνο χρησιμοποιώντας τα δεδομένα ελέγχου ταυτότητας χρηστών Api. Όσον αφορά τα δικαιώματα χρήστη, η ενεργοποίηση αυτής της λειτουργίας μπορεί στη συνέχεια να διαμορφωθεί είτε σε όλα είτε σε μεμονωμένα στοιχεία. Βλέπε Κεφ.0. Φυσικά, χρειάζεστε επίσης ένα έργο VISION στο οποίο τα στοιχεία που θέλετε να ελέγξετε από έξω είναι πλήρως διαμορφωμένα και η σύνδεση με αυτά έχει δοκιμαστεί με επιτυχία. Για να είναι δυνατή η αντιμετώπιση μεμονωμένων στοιχείων μέσω του API, το αναγνωριστικό στοιχείου τους πρέπει να είναι γνωστό: αυτό εμφανίζεται στο κάτω μέρος της φόρμας ρυθμίσεων του στοιχείου

ΑΣΦΑΛΕΙΑ

Για λόγους ασφαλείας, η πρόσβαση στο API είναι δυνατή μόνο τοπικά (δηλαδή όχι μέσω του cloud). Επομένως, ο κίνδυνος ασφαλείας κατά την ενεργοποίηση της πρόσβασης API είναι χαμηλός. Ωστόσο, τα στοιχεία που σχετίζονται με την ασφάλεια δεν θα πρέπει να ενεργοποιούνται ή να απορρίπτονται ρητά για πρόσβαση στο API.

MQTT ΚΑΙ ΟΙ ΟΡΟΙ ΤΟΥ – ΣΥΝΤΟΜΗ ΕΞΗΓΗΣΗ

• Στο MQTT, ο ρόλος της κεντρικής διαχείρισης και διανομής όλων των μηνυμάτων είναι αυτός του μεσίτη. Παρόλο που ο διακομιστής MQTT και ο μεσίτης MQTT δεν είναι συνώνυμα (ο διακομιστής είναι ένας ευρύτερος όρος για έναν ρόλο που μπορούν επίσης να παίξουν οι πελάτες MQTT), ο μεσίτης εννοείται πάντα σε αυτό το εγχειρίδιο όταν αναφέρεται ο διακομιστής MQTT. Το ίδιο το DIVUS KNX IQ παίζει τον ρόλο του μεσίτη MQTT / διακομιστή MQTT στο πλαίσιο αυτού του εγχειριδίου.
• Ένας διακομιστής MQTT χρησιμοποιεί τα λεγόμενα θέματα: μια ιεραρχική δομή με την οποία τα δεδομένα κατηγοριοποιούνται, διαχειρίζονται και δημοσιεύονται.
• Η δημοσίευση έχει πρωταρχικό στόχο τη διάθεση δεδομένων σε άλλους συμμετέχοντες μέσω θεμάτων. Εάν θέλετε να αλλάξετε μια τιμή, γράφετε στο επιθυμητό θέμα μαζί με την επιθυμητή αλλαγή τιμής, χρησιμοποιώντας επίσης μια ενέργεια δημοσίευσης. Η συσκευή προορισμού ή ο διακομιστής MQTT διαβάζει την επιθυμητή αλλαγή που την επηρεάζει και την υιοθετεί ανάλογα. Για να ελέγξετε ότι η αλλαγή έχει εφαρμοστεί, μπορείτε να ανατρέξετε στο θέμα που έχετε εγγραφεί σε πραγματικό χρόνο για να δείτε εάν η αλλαγή αντικατοπτρίζεται εκεί – εάν όλα έχουν πέσει καλά.
• Οι πελάτες επιλέγουν τα θέματα που τους ενδιαφέρουν: αυτό ονομάζεται συνδρομή. Κάθε φορά που αλλάζει μια τιμή σε/κάτω από ένα θέμα, ενημερώνονται όλοι οι εγγεγραμμένοι πελάτες – δηλαδή χωρίς να χρειάζεται να ρωτήσουν ρητά εάν κάτι έχει αλλάξει ή ποια είναι η τρέχουσα τιμή.
• Μπορείτε να ανοίξετε (ή να διευθύνετε) ένα ξεχωριστό κανάλι επικοινωνίας με τον διακομιστή MQTT εισάγοντας οποιαδήποτε μοναδική συμβολοσειρά που ονομάζεται client_id σε ένα θέμα. Το client_id πρέπει να χρησιμοποιείται στο θέμα για την επεξεργασία τιμών. Αυτό χρησιμεύει στον εντοπισμό της προέλευσης κάθε αλλαγής, βοηθά με τυχόν σφάλματα και δεν επηρεάζει τους άλλους πελάτες, καθώς οι αντίστοιχες απαντήσεις από τον διακομιστή, συμπεριλαμβανομένων τυχόν κωδικών σφαλμάτων και μηνυμάτων, φτάνουν επίσης στο θέμα μόνο με το ίδιο client_id (και επομένως μόνο αυτός ο πελάτης). Το client_id είναι μια μοναδική συμβολοσειρά χαρακτήρων που αποτελείται από οποιονδήποτε συνδυασμό των χαρακτήρων 0-9, az, AZ, "-", "_".
• Γενικά, τα θέματα εγγραφής του διακομιστή MQTT του DIVUS KNX IQ περιέχουν την κατάσταση λέξης-κλειδιού, ενώ τα θέματα δημοσίευσης περιέχουν το αίτημα λέξης-κλειδιού. Αυτά με κατάσταση ενημερώνονται αυτόματα μόλις υπάρξει μια εξωτερική αλλαγή τιμής ή μόλις ζητηθεί μια αλλαγή τιμής από τον ίδιο τον πελάτη μέσω μιας δημοσίευσης και εφαρμοστεί με επιτυχία. Αυτά για δημοσίευση χωρίζονται περαιτέρω σε αυτά του τύπου (request/)get και αυτά του type (request/)set.
• Αλλαγές τιμών και άλλες προαιρετικές παράμετροι προστίθενται στο θέμα με το λεγόμενο ωφέλιμο φορτίο. Οι παράμετροι των επιμέρους στοιχείων (στοιχείο-αναγνωριστικό, όνομα, τύπος, συναρτήσεις)

Η κύρια διαφορά μεταξύ του MQTT και του κλασικού μοντέλου πελάτη-διακομιστή, όπου ο πελάτης ζητά και στη συνέχεια αλλάζει δεδομένα, επικεντρώνεται στις έννοιες της εγγραφής και της δημοσίευσης. Οι συμμετέχοντες μπορούν να δημοσιεύουν δεδομένα, θέτοντας τα διαθέσιμα σε άλλους, οι οποίοι εάν ενδιαφέρονται μπορούν να εγγραφούν σε αυτά. Αυτή η αρχιτεκτονική καθιστά δυνατή την ελαχιστοποίηση της ανταλλαγής δεδομένων και εξακολουθεί να διατηρεί ενημερωμένα όλα τα ενδιαφερόμενα μέρη. Περισσότερα για τις λεπτομέρειες εδώ: και ειδικές παράμετροι (uuid, φίλτρα) πρόκειται να χρησιμοποιηθούν εδώ. Αν και υπάρχουν πολλές επιλογές, το ωφέλιμο φορτίο εμφανίζεται μορφοποιημένο ως JSON σε αυτό το εγχειρίδιο. Το JSON χρησιμοποιεί αγκύλες και κόμματα για να αναπαραστήσει δεδομένα οποιασδήποτε δομής και έτσι ελαχιστοποιεί το μέγεθος των πακέτων δεδομένων που πρόκειται να μεταδοθούν. Περισσότερες λεπτομέρειες σχετικά με τα ωφέλιμα φορτία θα βρείτε αργότερα στο εγχειρίδιο.

• Για ειδικούς σκοπούς, είναι δυνατό να φιλτράρετε ανάλογα με τον τύπο της λειτουργίας, π.χ. να διευθύνετε μόνο on/off, δηλαδή διακόπτες 1 bit. Για το σκοπό αυτό χρησιμοποιείται η παράμετρος φίλτρα στο ωφέλιμο φορτίο. Το φιλτράρισμα είναι προς το παρόν δυνατό μόνο ανά τύπο λειτουργίας.
• Για να είναι δυνατή η αντιμετώπιση μεμονωμένων στοιχείων, απαιτείται το αναγνωριστικό στοιχείου τους. Αυτό μπορεί να βρεθεί στο VISION στο μενού ιδιοτήτων στοιχείων ή μπορεί επίσης να διαβαστεί απευθείας από τα δεδομένα που εμφανίζονται μπροστά από κάθε διαθέσιμο στοιχείο στη γενική συνδρομή του MQTT Explorer (τα στοιχεία παρατίθενται αλφαβητικά κατά το αναγνωριστικό στοιχείου).

Διαμόρφωση για την πρόσβαση στο API

ΔΙΑΜΟΡΦΩΣΗ ΟΡΑΜΑΤΟΣ ΓΙΑ ΠΡΟΣΒΑΣΗ ΧΡΗΣΤΗ API

Στο VISION ως διαχειριστής, μεταβείτε στο Configuration – User/API Access Management, κάντε κλικ στο Users/API Access και κάντε δεξί κλικ στο API User (ή πατήστε παρατεταμένα) για να ανοίξετε το παράθυρο επεξεργασίας. Εκεί θα βρείτε αυτές τις παραμέτρους και δεδομένα

• Ενεργοποίηση (πλαίσιο ελέγχου)
  • Ο χρήστης ενεργοποιείται πρώτα εδώ. Η προεπιλογή είναι απενεργοποιημένη
• Όνομα χρήστη
  • Αυτή η συμβολοσειρά απαιτείται για πρόσβαση μέσω API – αντιγράψτε την από εδώ
• Σύνθημα
  • Αυτή η συμβολοσειρά απαιτείται για πρόσβαση μέσω API – αντιγράψτε την από εδώ
• Άδειες
  • Τα προεπιλεγμένα δικαιώματα ανάγνωσης και εγγραφής των τιμών των στοιχείων VISION μπορούν να οριστούν εδώ, δηλαδή αυτό που ορίζεται εδώ ισχύει για όλα τα υπάρχοντα και μελλοντικά στοιχεία. Εάν θέλετε να επιτρέψετε μόνο την πρόσβαση σε μεμονωμένα στοιχεία, δεν θα πρέπει να αλλάξετε αυτά τα προεπιλεγμένα δικαιώματα

ΑΔΕΙΕΣ ΣΕ ΜΕΜΟΝΩΜΕΝΑ ΣΤΟΙΧΕΙΑ

Συνιστάται να μην παραχωρείτε πρόσβαση στο API σε ολόκληρο το έργο, αλλά μόνο στα επιθυμητά στοιχεία. Προχωρήστε ως εξής

1. συνδεθείτε στο VISION ως διαχειριστής
2. επιλέξτε το επιθυμητό στοιχείο και ανοίξτε το μενού ρυθμίσεών του (κάντε δεξί κλικ ή κρατήστε πατημένο και μετά Ρυθμίσεις)
3. κάτω από την καταχώρηση μενού Γενικά – Δικαιώματα, ενεργοποιήστε το «Παράκαμψη προεπιλεγμένων δικαιωμάτων» και, στη συνέχεια, μεταβείτε στο υποστοιχείο Δικαιώματα, το οποίο εμφανίζει τη μήτρα δικαιωμάτων.
4. ενεργοποιήστε την άδεια ελέγχου εδώ, η οποία επίσης ενεργοποιεί το view άδεια απευθείας. Εάν θέλετε να διαβάσετε δεδομένα μόνο μέσω της πρόσβασης API, αρκεί να το ενεργοποιήσετε view άδεια.
5. επαναλάβετε την ίδια διαδικασία για όλα τα στοιχεία στα οποία θέλετε να αποκτήσετε πρόσβαση

Σύνδεση μέσω MQTT

ΕΙΣΑΓΩΓΗ

Ως πρώηνampΈτσι, θα επιδείξουμε την πρόσβαση μέσω του MQTT API του DIVUS KNX IQ με ένα σχετικά απλό, δωρεάν λογισμικό που ονομάζεται MQTT Explorer (βλ. κεφ. 1.1), το οποίο είναι διαθέσιμο για Windows, Mac και Linux. Υπονοείται μια βασική γνώση και εμπειρία με το MQTT.

ΔΕΔΟΜΕΝΑ ΑΠΑΙΤΟΥΜΕΝΑ ΓΙΑ ΤΗ ΣΥΝΔΕΣΗ

Όπως αναφέρθηκε προηγουμένως (βλ. ενότητα 2.1), απαιτούνται το όνομα χρήστη και ο κωδικός πρόσβασης του χρήστη API. Εδώ είναι ένα τέλοςview όλων των δεδομένων που πρέπει να συλλεχθούν πριν από τη δημιουργία μιας σύνδεσης:

• Όνομα χρήστη Διαβάστε στη σελίδα λεπτομερειών του χρήστη API
• Κωδικός πρόσβασης Διαβάστε στη σελίδα λεπτομερειών του χρήστη API
• Διεύθυνση IP Ανάγνωση στις ρυθμίσεις εκκίνησης στην ενότητα Γενικά – Δίκτυο – Ethernet (ή μέσω Συγχρονιστή)
• Θύρα 8884 (αυτή η θύρα είναι δεσμευμένη για αυτόν τον σκοπό)

ΠΡΩΤΗ ΣΥΝΔΕΣΗ ΜΕ ΤΟ MQTT EXPLORER ΚΑΙ ΓΕΝΙΚΗ ΣΥΝΔΡΟΜΗ

Κανονικά, το MQTT κάνει διάκριση μεταξύ των δραστηριοτήτων που εγγράφονται και δημοσιεύονται. Το MQTT Explorer το απλοποιεί με την αυτόματη εγγραφή σε όλα τα διαθέσιμα θέματα (θέμα #) όταν πραγματοποιηθεί η πρώτη σύνδεση. Ως αποτέλεσμα, το δέντρο που οδηγεί σε όλα τα διαθέσιμα στοιχεία (δηλ. παραχωρήθηκε πρόσβαση χρήστη API) μπορεί να φανεί απευθείας στην αριστερή περιοχή του παραθύρου του MQTT Explorer μετά από μια επιτυχημένη σύνδεση. Για να εισαγάγετε περαιτέρω θέματα συνδρομής ή για να αντικαταστήσετε το # με ένα πιο συγκεκριμένο θέμα, μεταβείτε στην ενότητα Για προχωρημένους στο παράθυρο σύνδεσης. Το θέμα που εμφανίζεται επάνω δεξιά μοιάζει κάπως έτσι:

όπου το 7f4x0607849x444xxx256573x3x9x983 είναι το όνομα χρήστη του API και το objects_list περιέχει όλα τα διαθέσιμα στοιχεία. Αυτό το θέμα διατηρείται πάντα ενημερωμένο, δηλαδή τυχόν αλλαγές τιμών αντικατοπτρίζονται εκεί σε πραγματικό χρόνο. Εάν θέλετε να εγγραφείτε μόνο σε μεμονωμένα στοιχεία, εισαγάγετε το αναγνωριστικό στοιχείου του επιθυμητού στοιχείου μετά το objects_list/.

Σημείωση: Αυτός ο τύπος εγγραφής αντιστοιχεί περίπου στη λογική πίσω από τις διευθύνσεις ανάδρασης KNX. δείχνει την τρέχουσα κατάσταση των στοιχείων και μπορεί να χρησιμοποιηθεί για να ελέγξει εάν οι επιθυμητές αλλαγές έχουν εφαρμοστεί με επιτυχία. Εάν θέλετε μόνο να διαβάσετε δεδομένα αλλά όχι να τα αλλάξετε, αυτός ο τύπος συνδρομής είναι αρκετός.

Ένα απλό στοιχείο μοιάζει κάπως έτσι στη σημειογραφία JSON

Σημείωση: Όλες οι τιμές έχουν τη σύνταξη που φαίνεται παραπάνω, π.χ. { “value”: “1” } ως έξοδο των θεμάτων εγγραφής, ενώ η τιμή γράφεται απευθείας στο ωφέλιμο φορτίο για να αλλάξει μια τιμή (δηλ. για θέματα δημοσίευσης) – οι αγκύλες και Το "value" παραλείπεται π.χ. "onoff": "1".

Προηγμένες εντολές

ΕΙΣΑΓΩΓΗ

Υπάρχουν 3 είδη θεμάτων γενικά:

1. Εγγραφείτε σε θέματα για να δείτε τα διαθέσιμα στοιχεία και να λάβετε αλλαγές αξίας σε πραγματικό χρόνο
2. Εγγραφείτε σε θέματα για να λάβετε τις απαντήσεις σε (τους πελάτες ) δημοσίευση αιτημάτων
3. Δημοσιεύστε θέματα για να λάβετε ή να ορίσετε στοιχεία με τις τιμές τους

Αργότερα θα αναφερθούμε σε αυτά τα είδη χρησιμοποιώντας την αρίθμηση που εμφανίζεται εδώ (π.χ. θέματα τύπου 1, 2, 3). Περισσότερες λεπτομέρειες στις επόμενες ενότητες και στο κεφ. 4.2.

ΕΓΓΡΑΦΕΙΤΕ ΤΑ ΘΕΜΑΤΑ ΓΙΑ ΝΑ ΔΕΙΤΕ ΤΑ ΔΙΑΘΕΣΙΜΕΝΑ ΣΤΟΙΧΕΙΑ ΚΑΙ ΓΙΑ ΝΑ ΛΑΒΕΤΕ ΑΛΛΑΓΕΣ ΑΞΙΑΣ ΣΕ ΠΡΑΓΜΑΤΙΚΟ ΧΡΟΝΟ

Αυτά έχουν ήδη περιγραφεί

ΕΓΓΡΑΦΕΙΤΕ ΤΑ ΘΕΜΑΤΑ ΓΙΑ ΝΑ ΛΑΒΕΤΕ ΤΙΣ ΑΠΑΝΤΗΣΕΙΣ ΣΤΑ ΑΙΤΗΜΑΤΑ ΔΗΜΟΣΙΕΥΣΗΣ ΤΟΥ ΠΕΛΑΤΗ

Αυτού του είδους τα θέματα είναι προαιρετικά. Επιτρέπει να

• ανοίξτε ένα μοναδικό κανάλι επικοινωνίας με τον διακομιστή MQTT χρησιμοποιώντας ένα αυθαίρετο client_id. Περισσότερα για αυτό στο κεφ. 4.2.2
• λάβετε το αποτέλεσμα των αιτημάτων δημοσίευσης στο αντίστοιχο θέμα εγγραφής: επιτυχία ή αποτυχία με κωδικό σφάλματος και μήνυμα.

Υπάρχουν διάφορα θέματα για να λάβετε απαντήσεις για να λάβετε ή να ορίσετε εντολές δημοσίευσης. Η αντίστοιχη διαφορά σε Μόλις λύσετε τα απαραίτητα θέματα για το σύστημά σας, μπορείτε να αποφασίσετε να καταργήσετε αυτό το βήμα και να χρησιμοποιήσετε απευθείας θέματα δημοσίευσης.

 ΔΗΜΟΣΙΕΥΣΤΕ ΘΕΜΑΤΑ ΓΙΑ ΝΑ ΛΑΒΕΤΕ Ή ΝΑ ΟΡΙΣΕΤΕ ΣΤΟΙΧΕΙΑ ΜΕ ΤΙΣ ΤΙΜΕΣ ΤΟΥΣ

Αυτά τα θέματα χρησιμοποιούν μια διαδρομή παρόμοια με αυτή για την εγγραφή - η μόνη αλλαγή είναι η λέξη "αίτημα" στη θέση της "κατάστασης" που χρησιμοποιείται για την εγγραφή. Οι πλήρεις θεματικές διαδρομές εμφανίζονται αργότερα στο κεφάλαιο. 4.2.2\ Ένα θέμα λήψης θα ζητήσει να διαβάσει τα στοιχεία και τις τιμές του διακομιστή MQTT. Το ωφέλιμο φορτίο μπορεί να χρησιμοποιηθεί για φιλτράρισμα με βάση τον τύπο λειτουργίας των στοιχείων. Ένα καθορισμένο θέμα θα ζητήσει την αλλαγή ορισμένων τμημάτων ενός στοιχείου, όπως περιγράφεται στο ωφέλιμο φορτίο του.

ΠΡΟΘΕΜΑ ΓΙΑ ΕΝΤΟΛΕΣ ΚΑΙ ΑΝΤΙΣΤΟΙΧΕΣ ΑΠΑΝΤΗΣΕΙΣ

 ΣΥΝΟΠΤΙΚΗ ΕΞΗΓΗΣΗ

Όλες οι εντολές που αποστέλλονται στον διακομιστή MQTT έχουν ένα κοινό αρχικό μέρος, δηλαδή:

ΛΕΠΤΟΜΕΡΗΣ ΕΞΗΓΗΣΗ

Τα θέματα σε πραγματικό χρόνο (τύπος 1) θα έχουν το γενικό πρόθεμα (βλ. παραπάνω) και στη συνέχεια θα ακολουθούν

or

Για τις εντολές set, το ωφέλιμο φορτίο παίζει προφανώς τον κύριο ρόλο καθώς θα περιέχει τις επιθυμητές αλλαγές (δηλαδή αλλαγμένες τιμές για τις συναρτήσεις του στοιχείου). A Προειδοποίηση: Μην χρησιμοποιείτε ποτέ την επιλογή διατήρησης στις εντολές τύπου 3, καθώς μπορεί να προκαλέσει προβλήματα στην πλευρά του KNX.

EXAMPLE: ΔΗΜΟΣΙΕΥΣΗ ΓΙΑ ΤΗΝ ΑΛΛΑΓΗ ΤΗΣ ΑΞΙΑΣ ΜΟΝΟΥ ΣΤΟΙΧΕΙΟΥ

Η απλούστερη περίπτωση είναι να θέλετε να αλλάξετε την τιμή ενός από τα στοιχεία που εμφανίζονται από τη γενική εγγραφή.
Σε γενικές γραμμές, η αλλαγή/εναλλαγή μιας λειτουργίας του VISION μέσω MQTT αποτελείται από 3 βήματα, τα οποία δεν είναι όλα απολύτως απαραίτητα, αλλά συνιστούμε ωστόσο να τα εκτελέσετε όπως περιγράφεται.

1. Το θέμα που περιέχει τη συνάρτηση που θέλουμε να επεξεργαστούμε έχει εγγραφεί χρησιμοποιώντας ένα προσαρμοσμένο αναγνωριστικό πελάτη
2. Το θέμα για επεξεργασία δημοσιεύεται μαζί με το ωφέλιμο φορτίο με τις επιθυμητές αλλαγές χρησιμοποιώντας το client_id που έχει επιλεγεί στο 1.
3. Για να ελέγξετε, μπορείτε στη συνέχεια να δείτε την απάντηση στο θέμα (1.) – δηλαδή εάν το (2.) λειτούργησε ή όχι
4. Στη γενική συνδρομή, όπου όλες οι τιμές ενημερώνονται όταν γίνονται αλλαγές, μπορείτε να δείτε τις επιθυμητές αλλαγές τιμών, εάν όλα έχουν λειτουργήσει καλά.

Τα βήματα για να γίνει αυτό είναι:

1. επιλέξτε ένα client_id π.χ. "Divus" και εισαγάγετε το στη διαδρομή μετά το όνομα χρήστη API
   Αυτό είναι το πλήρες θέμα για να εγγραφείτε στο δικό σας κανάλι επικοινωνίας με τον διακομιστή MQTT. Αυτό λέει στον διακομιστή πού αναμένετε τις απαντήσεις στις αλλαγές που σκοπεύετε να στείλετε. Παρατηρήστε το τμήμα κατάστασης/συνόλου που ορίζει α. ότι είναι θέμα εγγραφής και β. ότι θα πάρει τις απαντήσεις για να ορίσει εντολές τύπου.
2. Το θέμα δημοσίευσης θα είναι το ίδιο εκτός από την αλλαγή των λέξεων-κλειδιών αιτήματος κατάστασης
3. τι πρέπει να αποτελείται η αλλαγή γράφεται στο ωφέλιμο φορτίο. Εδώ είναι μερικά πρώηνamples.
   • Απενεργοποίηση στοιχείου που έχει τη λειτουργία on/off (1 bit):
   • Ενεργοποίηση στοιχείου που έχει τη λειτουργία on/off (1 bit). Επιπλέον, εάν πολλές τέτοιες εντολές ξεκινούν από τον ίδιο πελάτη, η παράμετρος uuid ("μοναδικό αναγνωριστικό", είναι συνήθως μια συμβολοσειρά 128-bit μορφοποιημένη ως 8-4-4-4-12 ψηφία εξάγωνο) μπορεί να χρησιμοποιηθεί για την εκχώρηση του απάντηση στο αντίστοιχο ερώτημα, καθώς αυτή η παράμετρος – εάν υπάρχει στο ερώτημα – μπορεί επίσης να βρεθεί στην απάντηση.
   • Ενεργοποίηση και ρύθμιση της φωτεινότητας ενός ροοστάτη στο 50%
   • Η απάντηση στο θέμα που εμφανίζεται και εγγράφεται παραπάνω (το ωφέλιμο φορτίο του, για την ακρίβεια) είναι τότε, π.χample.
     Η παραπάνω απάντηση είναι μια πρώηνample στην περίπτωση ενός σωστού ωφέλιμου φορτίου, αν και το στοιχείο δεν έχει λειτουργία dimming. Εάν υπάρχουν πιο σοβαρά προβλήματα με αποτέλεσμα το ωφέλιμο φορτίο να μην ερμηνεύεται σωστά, η απάντηση θα μοιάζει με αυτό (π.χ.):
     για μια επεξήγηση των κωδικών σφαλμάτων και των μηνυμάτων, αλλά γενικά, όπως για το http, 200 κωδικοί είναι θετικές απαντήσεις ενώ 400 είναι αρνητικοί.

EXAMPLE: ΔΗΜΟΣΙΕΥΣΗ ΓΙΑ ΑΛΛΑΓΗ ΑΞΙΩΝ ΠΟΛΛΑΠΛΩΝ ΣΤΟΙΧΕΙΩΝ

Η διαδικασία είναι παρόμοια με αυτή που παρουσιάστηκε πριν για την αλλαγή ενός μεμονωμένου στοιχείου. Η διαφορά είναι ότι παραλείπετε το element_id από τα θέματα και μετά υποδεικνύετε το σύνολο των element_id μπροστά από τα δεδομένα μέσα στο ωφέλιμο φορτίο. Δείτε τη σύνταξη και τη δομή παρακάτω.

Φιλτράρισμα ΚΑΤΑ ΣΥΝΑΡΤΗΣΗ ΤΥΠΟΥ ΣΕ ΕΡΩΤΗΣΕΙΣ

Η παράμετρος φίλτρων στο ωφέλιμο φορτίο επιτρέπει την αντιμετώπιση μόνο των επιθυμητών συναρτήσεων ενός στοιχείου. Η λειτουργία on/off ενός διακόπτη ή dimmer ονομάζεται "onoff", π.χample, και το αντίστοιχο φίλτρο ορίζεται ως εξής:

Τότε η απάντηση μοιάζει με αυτή, π.χample

Η αγκύλη υποδεικνύει ότι μπορείτε επίσης να φιλτράρετε με διάφορες λειτουργίες, π.χ

οδηγεί σε μια απάντηση όπως αυτή:

Παράρτημα

ΚΩΔΙΚΟΙ ΣΦΑΛΜΑΤΟΣ

Τα σφάλματα στην επικοινωνία MQTT έχουν ως αποτέλεσμα έναν αριθμητικό κωδικό. Ο παρακάτω πίνακας βοηθάει στην κατανομή του.

ΠΑΡΑΜΕΤΡΟΙ ΩΦΕΡΟΥ ΦΟΡΤΙΟΥ

Το ωφέλιμο φορτίο υποστηρίζει διαφορετικές παραμέτρους ανάλογα με το περιβάλλον. Ο παρακάτω πίνακας δείχνει ποιες παράμετροι μπορούν να εμφανιστούν σε ποια θέματα

ΣΗΜΕΙΩΣΕΙΣ ΕΚΔΟΣΗΣ

• 1.00 ΕΚΔΟΣΗ

Νέα:

• Πρώτη δημοσίευση

Έγγραφα / Πόροι

	Λογισμικό DIVUS VISION API [pdf] Εγχειρίδιο χρήστη Λογισμικό VISION API, Λογισμικό API, Λογισμικό
	Λογισμικό DIVUS Vision API [pdf] Οδηγός χρήστη Λογισμικό Vision API, Vision, Λογισμικό API, Λογισμικό

Αναφορές

• Εγχειρίδιο χρήστη