www.pyramid.tech
FX4
Εγχειρίδιο προγραμματιστή FX4
ID εγγράφου: 2711715845
Έκδοση: v3
Προγραμματιστής FX4
ID εγγράφου: 2711715845
Εγχειρίδιο προγραμματιστή FX4 – FX4
Αναγνωριστικό εγγράφου: 2711650310
| Συγγραφέας | Μάθιου Νίκολς |
| Ιδιοκτήτης | Υπεύθυνος έργου |
| Σκοπός | Εξηγήστε τις έννοιες προγραμματισμού που είναι απαραίτητες για τη χρήση του API και την επέκταση του προϊόντος μέσω εξωτερικών εφαρμογών. |
| Εκταση | Έννοιες προγραμματισμού που σχετίζονται με το FX4. |
| Προοριζόμενο κοινό | Προγραμματιστές λογισμικού που ενδιαφέρονται να χρησιμοποιήσουν το προϊόν. |
| Διαδικασία | https://pyramidtc.atlassian.net/wiki/pages/createpage.action? spaceKey=PQ&title=Standard%20Manual%20Creation%20Process |
| Εκπαίδευση | ΔΕΝ ΕΦΑΡΜΟΖΕΤΑΙ |
Έλεγχος έκδοσης
| Εκδοχή | Περιγραφή | Αποθηκεύτηκε από | Αποθηκεύτηκε στις | Κατάσταση |
| v3 | Προστέθηκε ένα απλό overview και περισσότερο πρώηνamples. | Μάθιου Νίκολς | 6 Μαρ 2025 10:29 | ΕΓΚΕΚΡΙΜΕΝΟ |
| v2 | Προστέθηκαν ψηφιακές διεπαφές IO και αναφορές πίσω στο IGX. | Μάθιου Νίκολς | 3 Μαΐου 2024 7:39 μ.μ | ΕΓΚΕΚΡΙΜΕΝΟ |
| v1 | Η αρχική έκδοση, ακόμη μια εργασία σε εξέλιξη. | Μάθιου Νίκολς | 21 Φεβρουαρίου 2024 11:25 | ΕΓΚΕΚΡΙΜΕΝΟ |
Έλεγχος Εγγράφων Όχι Reviewed
Τρέχουσα έκδοση εγγράφου: v.1
Όχι ρεviewπου έχουν ανατεθεί.
1.1 Υπογραφές
για την πιο πρόσφατη έκδοση εγγράφου
Παρασκευή, 7 Μαρτίου 2025, 10:33 UTC
Ο Matthew Nichols υπέγραψε. που σημαίνει: Review
Αναφορές
| Εγγραφο | Ταυτότητα εγγράφου | Συγγραφέας | Εκδοχή |
| IGX – Εγχειρίδιο προγραμματιστή | 2439249921 | Μάθιου Νίκολς | 1 |
FX4 Προγραμματισμός Πάνωview
Ο επεξεργαστής FX4 λειτουργεί σε ένα περιβάλλον που ονομάζεται IGX, το οποίο είναι χτισμένο στο λειτουργικό σύστημα QNX υψηλής αξιοπιστίας σε πραγματικό χρόνο από την BlackBerry (QNX Webτοποθεσία¹). Το IGX παρέχει μια ευέλικτη και ολοκληρωμένη διεπαφή προγραμματισμού εφαρμογών (API) για χρήστες που θέλουν να γράψουν το δικό τους λογισμικό κεντρικού υπολογιστή.
Το περιβάλλον IGX είναι κοινόχρηστο σε άλλα προϊόντα της Pyramid, επιτρέποντας στις λύσεις λογισμικού που έχουν αναπτυχθεί για ένα προϊόν να μεταφέρονται εύκολα σε άλλα.
Οι προγραμματιστές μπορούν να ανατρέξουν στην πλήρη τεκμηρίωση για το IGX που είναι διαθέσιμη στην Πυραμίδα website στη διεύθυνση: IGX | Σύγχρονο αρθρωτό πλαίσιο συστήματος ελέγχου για Web-Ενεργοποιημένες Εφαρμογές²
Αυτή η ενότητα παρέχει μια εισαγωγή στη δοκιμή δύο από τις μεθόδους API: HTTP χρησιμοποιώντας μορφή JSON και EPICS. Για απλότητα, Python (Πύθων Webτοποθεσία³) χρησιμοποιείται ως πρώηνample host γλώσσα υπολογιστή, η οποία είναι προσβάσιμη και εύκολη στη χρήση για μη επαγγελματίες προγραμματιστές.
3.1 Χρήση Python και HTTP
Ως πρώηνample, υποθέστε ότι θέλετε να διαβάσετε το άθροισμα των μετρούμενων ρευμάτων με την Python. Χρειάζεστε το URL για τη συγκεκριμένη ΙΟ. Το FX4 web Το GUI παρέχει έναν εύκολο τρόπο για να το βρείτε: απλώς κάντε δεξί κλικ στο πεδίο και επιλέξτε «Αντιγραφή HTTP URL' για να αντιγράψετε τη συμβολοσειρά στο πρόχειρο.
Τώρα μπορείτε να χρησιμοποιήσετε την Python για να δοκιμάσετε τη συνδεσιμότητα με το λογισμικό χρήστη μέσω HTTP και JSON. Ίσως χρειαστεί να εισαγάγετε τα αιτήματα και τις βιβλιοθήκες json για να χειριστείτε τα αιτήματα HTTP και την ανάλυση δεδομένων.
1 Απλό Python HTTP Example
3.2 Χρήση EPICS
Η διαδικασία σύνδεσης του FX4 μέσω του EPICS (Πειραματική Φυσική και Σύστημα Βιομηχανικού Ελέγχου) είναι παρόμοια. Το EPICS είναι ένα σύνολο εργαλείων λογισμικού και εφαρμογών που χρησιμοποιούνται για την ανάπτυξη και εφαρμογή κατανεμημένων συστημάτων ελέγχου, που χρησιμοποιούνται ευρέως σε επιστημονικές εγκαταστάσεις.
- Λάβετε το όνομα της μεταβλητής διεργασίας EPICS (PV) για το επιθυμητό IO.
- Εισαγάγετε τη βιβλιοθήκη EPICS και διαβάστε την τιμή.
2 Λήψη ονόματος PV EPICS
3 Simple Python EPICS Example
Επιπλέον, η Pyramid δημιούργησε ένα βοηθητικό πρόγραμμα (EPICS Σύνδεση4) που σας επιτρέπει να παρακολουθείτε τις μεταβλητές της διαδικασίας EPICS σε πραγματικό χρόνο. Αυτό το εργαλείο είναι χρήσιμο για να επιβεβαιώσετε εάν το όνομα PV EPICS είναι σωστό και ότι το FXXNUMX εξυπηρετεί σωστά το ΦΒ στο δίκτυό σας.
4 PTC EPICS Σύνδεση
FX4 Programming API
Οι έννοιες και οι μέθοδοι που περιγράφονται σε αυτό το εγχειρίδιο βασίζονται στις έννοιες που καθορίζονται στο Εγχειρίδιο Προγραμματιστή IGX. Δείτε αυτό το έγγραφο για επεξήγηση και π.χampπληροφορίες για το πώς λειτουργούν οι βασικοί προγραμματισμός και οι διεπαφές IGX. Αυτό το εγχειρίδιο θα καλύπτει μόνο το IO για τη συσκευή και τη λειτουργικότητα που είναι μοναδική για το FX4.
4.1 Αναλογική είσοδος IO
Αυτά τα IO σχετίζονται με τη διαμόρφωση και τη συλλογή δεδομένων στις εισόδους αναλογικού ρεύματος του FX4. Οι μονάδες των εισόδων καναλιού βασίζονται στη ρύθμιση με δυνατότητα διαμόρφωσης από τον χρήστη που ονομάζεται «Sample Units”, οι έγκυρες επιλογές περιλαμβάνουν τα pA, nA, uA, mA και A.
Και τα 4 κανάλια χρησιμοποιούν την ίδια διεπαφή IO και ελέγχονται ανεξάρτητα. Αντικαταστήστε το channel_x με το channel_1 , το channel_2 , το channel_3 ή το channel_4 αντίστοιχα.
| Διαδρομή IO | Περιγραφή |
| /fx4/adc/channel_x | ΑΡΙΘΜΟΣ ΑΝΑΓΝΩΣΗΣ Μετρημένη τρέχουσα είσοδος. |
| /fx4/adc/channel_x/scalar | ΑΡΙΘΜΟΣ Απλή κλίμακα χωρίς μονάδες εφαρμόζεται στο κανάλι, 1 από προεπιλογή. |
| /fx4/adc/channel_x/zero_offset | ΑΡΙΘΜΟΣ Τρέχουσα μετατόπιση σε nA για το κανάλι. |
Οι ακόλουθες IO δεν είναι ανεξάρτητες από κανάλια και εφαρμόζονται σε όλα τα κανάλια ταυτόχρονα.
| Διαδρομή IO | Περιγραφή |
| /fx4/channel_sum | ΑΡΙΘΜΟΣ ΑΝΑΓΝΩΣΗΣ Άθροισμα των τρεχόντων καναλιών εισόδου. |
| /fx4/adc_unit | STRING Ορίζει τις τρέχουσες μονάδες χρήστη για κάθε κανάλι και άθροισμα. Επιλογές: "pa", "na", "ua", "ma", "a" |
| /fx4/εύρος | STRING Ορίζει το τρέχον εύρος εισόδου. Δείτε το GUI για το πώς κάθε κωδικός εύρους αντιστοιχεί στα μέγιστα όρια εισόδου ρεύματος και BW. Επιλογές: "0", "1", "2", "3", "4", "5", "6", "7" |
| /fx4/adc/sample_frequency | ΑΡΙΘΜΟΣ Η συχνότητα σε Hz που sampΤα δεδομένα θα υπολογιστούν κατά μέσο όρο σε. Αυτό ελέγχει την ταχύτητα σήματος προς θόρυβο και δεδομένων για όλα τα κανάλια. |
| /fx4/adc/conversion_frequency | ΑΡΙΘΜΟΣ Η συχνότητα σε Hz στην οποία το ADC θα μετατρέψει τις αναλογικές σε ψηφιακές τιμές. Από προεπιλογή, αυτό είναι 100 kHz και σπάνια θα χρειαστεί να αλλάξετε αυτήν την τιμή. |
| /fx4/adc/offset_correction | ΑΡΙΘΜΟΣ ΑΝΑΓΝΩΣΗΣ Άθροισμα όλων των τρεχουσών μετατοπίσεων του καναλιού. |
4.2 Αναλογική Έξοδος IO
Αυτά τα IO σχετίζονται με τη διαμόρφωση των αναλογικών εξόδων γενικής χρήσης του FX4 που βρίσκονται κάτω από τις αναλογικές εισόδους στον μπροστινό πίνακα. Και τα 4 κανάλια χρησιμοποιούν την ίδια διεπαφή IO και ελέγχονται ανεξάρτητα. Αντικαταστήστε το channel_x με το channel_1 , το channel_2 , το channel_3 ή το channel_4 αντίστοιχα.
| Διαδρομή IO | Περιγραφή |
| /fx4/dac /channel_x | NUMBER Εντολή τόμtage έξοδος. Αυτή η τιμή μπορεί να εγγραφεί μόνο όταν η λειτουργία εξόδου έχει ρυθμιστεί σε χειροκίνητη. |
| /fx4/dac/channel_x/readback | ΑΡΙΘΜΟΣ ΑΝΑΓΝΩΣΗΣ Μετρημένος τόμtagε έξοδο. Αυτό είναι πολύ χρήσιμο όταν χρησιμοποιείτε τη λειτουργία εξόδου έκφρασης. |
| /fx4/dac/channel_x/output_mode | STRING Ρυθμίζει τη λειτουργία εξόδου για το κανάλι. Επιλογές: "manual", "expression", "process_control" |
| /fx4/dac/channel _ x/slew_control_enable | BOOL Ενεργοποιεί ή απενεργοποιεί τον περιορισμό του ρυθμού περιστροφής. |
| /fx4/dac/channel_ x/slew_rate | NUMBER Ρυθμός περιστροφής σε V/s για το κανάλι. |
| /fx4/dac/channel_x/upper_limit | ΑΡΙΘΜΟΣ Η μέγιστη επιτρεπόμενη εντολή voltagε για το κανάλι. Ισχύει για όλους τους τρόπους λειτουργίας. |
| /fx4/dac/channel _ x/lower_limit | ΑΡΙΘΜΟΣ Η ελάχιστη επιτρεπόμενη εντολή voltagε για το κανάλι. Ισχύει για όλους τους τρόπους λειτουργίας. |
| /fx4/dac/channel _ x/ έξοδος _ έκφραση | STRING Ορίζει τη συμβολοσειρά έκφρασης που χρησιμοποιείται από το κανάλι όταν βρίσκεται στη λειτουργία εξόδου έκφρασης. |
| /fx4/dac/channel _ x/reset_button | BUTTON Επαναφέρει την εντολή voltagε έως 0. |
4.3 Ψηφιακές Είσοδοι και Έξοδοι
Αυτά τα IO σχετίζονται με τον έλεγχο των διαφόρων ψηφιακών εισόδων και εξόδων γενικής χρήσης που βρίσκονται στο FX4.
| Διαδρομή IO | Περιγραφή |
| /fx4/fr1 | Δέκτης ινών READONLY BOOL 1. |
| /fx4/ft1 | Πομπός ινών BOOL 1. |
| /fx4/fr2 | Δέκτης ινών READONLY BOOL 2. |
| /fx4/ft2 | Πομπός ινών BOOL 2. |
| /fx4/fr3 | Δέκτης ινών READONLY BOOL 3. |
| /fx4/ft3 | Πομπός ινών BOOL 3. |
| /fx4/digital_expansion/d1 | BOOL D1 αμφίδρομη ψηφιακή επέκταση IO. |
| /fx4/digital_expansion/d2 | BOOL D2 αμφίδρομη ψηφιακή επέκταση IO. |
| /fx4/digital_expansion/d3 | BOOL D3 αμφίδρομη ψηφιακή επέκταση IO. |
| /fx4/digital_expansion/d4 | BOOL D4 αμφίδρομη ψηφιακή επέκταση IO. |
4.3.1 Ψηφιακή διαμόρφωση IO
Όλα τα ψηφιακά διαθέτουν θυγατρικό IO για τη διαμόρφωση της συμπεριφοράς τους, συμπεριλαμβανομένου ενός τρόπου λειτουργίας που ελέγχει τον τρόπο λειτουργίας αυτού του ψηφιακού. Κάθε ψηφιακό θα έχει διαφορετικό σύνολο διαθέσιμων επιλογών. Ανατρέξτε στο GUI για λεπτομέρειες σχετικά με τις διαθέσιμες επιλογές για ποιο IO.
| Child IO Path | Περιγραφή |
| …/τρόπος | STRING Τρόπος λειτουργίας για το ψηφιακό. Επιλογές: "input", "output", "pwm", "timer", "encoder", "capture", "uart_rx", "uart_tx", "can_rx", "can_tx", "pru_input" ή "pru_output" |
| …/process_signal | STRING Το όνομα του σήματος ελέγχου διεργασίας, εάν υπάρχει. |
| …/pull_mode | STRING Λειτουργία έλξης προς τα πάνω/κάτω για ψηφιακή είσοδο. Επιλογές: "πάνω", "κάτω" ή "απενεργοποίηση" |
4.4 Έλεγχος ρελέ
Και τα δύο ρελέ ελέγχονται ανεξάρτητα και μοιράζονται τον ίδιο τύπο διεπαφής. Αντικαταστήστε το relay_x με το relay_a ή το relay_b αντίστοιχα.
| Διαδρομή IO | Περιγραφή |
| Εντολή /fx4/relay _ x/permit / user _ | BOOL Δίνει εντολή στο ρελέ να ανοίξει ή να κλείσει. Μια αληθινή εντολή θα προσπαθήσει να κλείσει το ρελέ εάν χορηγηθούν οι μανδαλώσεις και η ψευδής εντολή θα ανοίγει πάντα το ρελέ. |
| /fx4/ρελέ _ x/κατάσταση | READONLY STRING Η τρέχουσα κατάσταση του ρελέ. Τα κλειδωμένα ρελέ είναι ανοιχτά αλλά δεν μπορούν να κλείσουν λόγω κλειδώματος. Καταστάσεις: "ανοιχτό", "κλειστό" ή "κλειδωμένο" |
| /fx4/ρελέ _ x/αυτόματα _ κλείσιμο | BOOL Όταν ρυθμιστεί σε true, το ρελέ θα κλείσει αυτόματα όταν παραχωρηθούν οι ασφάλειες. False από προεπιλογή. |
| /fx4/relay _ x/ cycle _ count | ΑΡΙΘΜΟΣ ΑΝΑΓΝΩΣΗΣ Ο αριθμός των κύκλων ρελέ από την τελευταία επαναφορά. Χρήσιμο για την παρακολούθηση της διάρκειας ζωής του ρελέ. |
4.5 Υψηλός τόμοςtage Ενότητα
Ανατρέξτε στο IGX – Εγχειρίδιο προγραμματιστή για λεπτομέρειες σχετικά με το FX4 high voltage διεπαφή. Η γονική διαδρομή του στοιχείου είναι /fx4/high_votlage .
4.6 Ελεγκτής δόσης
Ανατρέξτε στο IGX – Εγχειρίδιο προγραμματιστή για λεπτομέρειες σχετικά με τη διεπαφή ελεγκτή δόσης FX4. Η γονική διαδρομή του στοιχείου είναι /fx4/dose_controller.
FX4 Python Examples
5.1 Καταγραφή δεδομένων με χρήση HTTP
Αυτό το πρώηνampΤο le δείχνει πώς να καταγράψετε έναν αριθμό αναγνώσεων και να τις αποθηκεύσετε σε ένα CSV file. Επιλέγοντας μια μεγάλη καθυστέρηση μεταξύ των μετρήσεων, μπορείτε να εκτελέσετε μακροπρόθεσμη καταγραφή δεδομένων ακόμα και αν το FX4 sampΤο ποσοστό ling έχει οριστεί υψηλότερο. Αυτό σας επιτρέπει να συλλέγετε και να αποθηκεύετε συνεχώς μετρήσεις για εκτεταμένες περιόδους χωρίς να κατακλύζετε το σύστημα, διασφαλίζοντας ότι τα δεδομένα καταγράφονται σε διαστήματα κατάλληλα για την ανάλυσή σας. Η καθυστέρηση μεταξύ των μετρήσεων βοηθά στη ρύθμιση του ρυθμού με τον οποίο καταγράφονται τα δεδομένα, επιτρέποντας την αποτελεσματική αποθήκευση και μειώνοντας τον κίνδυνο απώλειας σημείων δεδομένων, ενώ παράλληλα επωφελείται από την υψηλή ταχύτηταampling για μετρήσεις σε πραγματικό χρόνο.
5.2 Απλό γραφικό περιβάλλον Python
Ο δεύτερος πρώηνampΤο le χρησιμοποιεί το εργαλείο Tkinter GUI, το οποίο είναι κατασκευασμένο για την Python, για να δημιουργήσει μια εμφάνιση των μετρούμενων ρευμάτων. Αυτή η διεπαφή σάς επιτρέπει να απεικονίσετε τις τρέχουσες αναγνώσεις σε μια φιλική προς το χρήστη γραφική μορφή. Το μέγεθος της οθόνης μπορεί να αλλάξει ώστε να είναι αρκετά μεγάλη ώστε να μπορεί να διαβάζεται από κάθε δωμάτιο, καθιστώντας την ιδανική για σενάρια όπου απαιτείται παρακολούθηση σε πραγματικό χρόνο σε μεγαλύτερους χώρους. Το Tkinter παρέχει έναν εύκολο τρόπο δημιουργίας διαδραστικών διεπαφών και ενσωματώνοντάς το με το FX4, μπορείτε να δημιουργήσετε γρήγορα μια οπτική απεικόνιση των μετρούμενων ρευμάτων που μπορεί να προσαρμοστεί για να ταιριάζει στις συγκεκριμένες ανάγκες σας.
5.3 Απλό WebΠρίζες Πχample
Αυτό το πρώηνample καταδεικνύει το WebΔιασύνδεση Sockets, η οποία είναι η προτιμώμενη μέθοδος για την ανάγνωση δεδομένων από το FX4 όταν απαιτείται μέγιστο εύρος ζώνης. WebΟι υποδοχές παρέχουν ένα κανάλι επικοινωνίας σε πραγματικό χρόνο, full-duplex, επιτρέποντας ταχύτερη και αποτελεσματικότερη μεταφορά δεδομένων σε σύγκριση με άλλες μεθόδους.
Ο πρώηνample διαβάζει μια σειρά από samples, αναφέρει τον μέσο χρόνο ανά δευτερόλεπτοample και μέγιστη καθυστέρηση και αποθηκεύει τα δεδομένα σε ένα CSV file για μεταγενέστερη ανάλυση. Αυτή η ρύθμιση επιτρέπει την αποτελεσματική παρακολούθηση σε πραγματικό χρόνο και την εύκολη αποθήκευση δεδομένων για μετα-επεξεργασία.
Η συγκεκριμένη απόδοση που μπορεί να επιτευχθεί με WebΤα Sockets εξαρτώνται από την αξιοπιστία της διεπαφής Ethernet και τη σχετική προτεραιότητα της εφαρμογής σας. Για βέλτιστα αποτελέσματα, βεβαιωθείτε ότι το δίκτυό σας είναι σταθερό και ότι η μετάδοση δεδομένων του FX4 έχει προτεραιότητα, εάν είναι απαραίτητο.
Έκδοση: v3
FX4 Python Examples: 21
Έγγραφα / Πόροι
 |
Προγραμματιστής PYRAMID FX4 [pdf] Εγχειρίδιο οδηγιών Προγραμματιστής FX4, FX4, Προγραμματιστής |