Το uFR Shell είναι μια διεπαφή λογισμικού γραμμής εντολών για την εκτέλεση εντολών υλικού της σειράς μFR σε πολλαπλά λειτουργικά συστήματα. Όπως υποδηλώνει ο τίτλος του λογισμικού, πρόκειται για ένα περιβάλλον κελύφους με ένα σύνολο μεταβλητών που ορίζονται από τις βιβλιοθήκες ανάγνωσης μFR.
Docs & Software Download
Επισκόπηση λογισμικού
Λειτουργίες λογισμικού:
- Ένα σύνολο συναρτήσεων που ορίζονται από τις βιβλιοθήκες της σειράς μFR και το API (Διεπαφή προγραμματισμού εφαρμογών).
Διαθέσιμες γλώσσες προγραμματισμού:
- Εκτελέσιμο λογισμικό
Υποστηριζόμενα λειτουργικά συστήματα, πλατφόρμες και περιβάλλοντα:
- Λειτουργικό σύστημα Windows
- Λειτουργικό σύστημα Linux
- ΜΑΚ ΟΣ
- Βατόμουρο Pi
Υποστηριζόμενες ετικέτες, ετικέτες, κάρτες:
- ΜΙΦΑΡΕ Μίνι®
- ΜΙΦΑΡΕ Κλασικό® (1K, 4K, EV1)
- ΜΙΦΑΡΕ Υπερελαφρό®
- ΜΙΦΑΡΕ Υπερελαφρό C®
- ΜΙΦΑΡΕ Συν® (2Κ, 4Κ)
- ΜΙΦΑΡΕ ΝΤΕΦΙΡ® (Ελαφρύ, 2Κ, 4Κ, 8Κ, ΕΒ1, ΕΒ2)
- NXP NTAG® 21x (210, 213, 215, 216, Παραβίαση ετικετών)
- NXP NTAG® 4xx DNA (413, 424)
Συνιστώμενο υλικό:
- μFR Νάνο
- μFR Νανο σε απευθείας σύνδεση
- μFR Κλασικό
- μFR Κλασικό CS
- μFR Προκαταβολή
- μFR XL
- Βασική HD (λειτουργία συμβατότητας μFR)
Λήψη λογισμικού
Περιγραφή
Το εκτελέσιμο λογισμικό uFR Shell επιτρέπει την εκτέλεση γραμμής εντολών για συσκευές της σειράς μFR σε λειτουργία κονσόλας.
Εγχειρίδιο λογισμικού
1. Κέλυφος uFR – Εγκατάσταση και εκτέλεση
Λήψη: ufr-κέλυφος
Κατεβάστε και αποσυσκευάστε το αρχείο λογισμικού.
Ο φάκελος ρίζας του αρχείου που εξάγεται περιέχει τους υποφακέλους με εκτελεστικά αρχεία λογισμικού uFR Shell για υποστηριζόμενα λειτουργικά συστήματα.
Ο ριζικός φάκελος περιέχει επίσης τη λίστα λειτουργιών λογισμικού και πρόσθετες οδηγίες.
Εάν έχετε εγκαταστήσει σωστά το υλικό σας και τα σχετικά προγράμματα οδήγησης , μπορείτε τώρα να επιλέξετε και να εκτελέσετε το εκτελέσιμο αρχείο για το τρέχον λειτουργικό σας σύστημα.
2. Κέλυφος uFR – Διεπαφή γραμμής εντολών
Ανεξάρτητα από το λειτουργικό σύστημα, το λογισμικό uFR Shell εκτελείται ως τερματικό εντολών. Η έκδοση λογισμικού εμφανίζεται στην πρώτη γραμμή της οθόνης.
3. Κέλυφος uFR – Λειτουργίες λογισμικού
Για να χρησιμοποιήσετε το λογισμικό uFR Shell για την εκτέλεση των εντολών στη συσκευή uFR, πρέπει να έχετε πληροφορίες για όλες τις διαθέσιμες λειτουργίες. Μπορείτε να βρείτε τη λίστα λειτουργιών στον ριζικό φάκελο του λογισμικού, το αρχείο UFR-Shell_list-of-functions.txt.
Βρείτε περισσότερες λεπτομέρειες, καθώς και οδηγίες για την υλοποίηση λειτουργιών και την εφαρμογή στα έγγραφα API.
3.1 – Κέλυφος uFR – Εκτέλεση γραμμής εντολών
Για να επιλέξετε τη σωστή συνάρτηση για τη γραμμή εντολών σας, σας συνιστούμε να μελετήσετε πρώτα τη Βοήθεια συνάρτησης με όλη την περιγραφή των συναρτήσεων.
3.2 – Κέλυφος uFR – Παραδείγματα εκτέλεσης γραμμής εντολών
Τώρα, ας δούμε πώς λειτουργεί.
Πρώτον, πρέπει να δημιουργήσουμε επικοινωνία με τον συνδεδεμένο αναγνώστη μFR. Έτσι, η πρώτη μας εντολή θα είναι το ReaderOpen.
Πληκτρολογήστε την εντολή:
- ΑναγνώστηςΆνοιγμα
Εάν η κατάσταση του αναγνώστη είναι εντάξει, μπορούμε να προχωρήσουμε. Διαφορετικά, ελέγξτε αν έχετε εγκαταστήσει σωστά το υλικό σας.
EXAMPLE 1
Για να λάβετε τον σειριακό αριθμό υλικού, χρησιμοποιήστε την εντολή:
- GetReaderSerialΑριθμός
Εάν η εντολή δεν έχει καθορισμένες πρόσθετες παραμέτρους, η προεπιλεγμένη έξοδος έχει μορφή HEX.
EXAMPLE 2
Για να λάβετε την έξοδο δεδομένων σε κάποια άλλη μορφή, πρέπει να καθορίσετε τη λειτουργία μορφής εξόδου μεταξύ των διαθέσιμων:
- Δεκαεξαδικό (παράμετρος h),
- Συμβολοσειρά (παράμετρος s)
- Δεκαδικό (παράμετρος d).
Η γραμμή εντολών για την καθορισμένη μορφή εξόδου θα έχει τώρα δύο στοιχεία:
- 'Λειτουργία' ' λειτουργία παραμέτρων'.
EXAMPLE 3
Όπως και με τον σειριακό αριθμό αναγνώστη, για να λάβετε την προεπιλεγμένη έξοδο id κάρτας, απλώς χρησιμοποιήστε την εντολή:
- Αποκτήστε την ΚάρταIdEx
Για αυτήν τη γραμμή εντολών, η κονσόλα θα εμφανίσει τον τύπο κάρτας, το UID και την έξοδο UID σε προεπιλεγμένη μορφή HEX.
EXAMPLE 4
Η έξοδος card ID έχει τιμές εξόδου δέντρου. Το προηγούμενο παράδειγμα δείχνει την έξοδο Card ID χωρίς καθορισμένη λειτουργία παραμέτρου στη γραμμή
εντολώνΑυτό το παράδειγμα εξηγεί πώς να αποκτήσετε μια μικτή μορφή εξόδου.
Η γραμμή εντολών θα πρέπει να μοιάζει κάπως έτσι:
-
- «Λειτουργία» «1. λειτουργία παραμέτρου» «2. λειτουργία παραμέτρου» «3. κατάσταση παραμέτρων"
EXAMPLE 5
Εάν δεν ορίσετε όλες τις παραμέτρους στη γραμμή εντολών σας, η μορφή όγκου εξόδου χωρίς την εκχωρημένη λειτουργία παραμέτρων θα διατηρήσει τη μορφή HEX (προεπιλογή).
Η γραμμή εντολών για αναμενόμενες τιμές δέντρου και προκαθορισμένες λειτουργίες δύο παραμέτρων έχει την ακόλουθη δομή:
- «Λειτουργία» «1. λειτουργία παραμέτρου» «2. κατάσταση παραμέτρων"
Η ενότητα 3.2 εξηγεί τον τρόπο ορισμού της μορφής τιμής εξόδου για μια καθορισμένη παράμετρο. Ωστόσο, εάν πρέπει να λαμβάνετε συχνά την έξοδο σε μη δεκαεξαδική μορφή, μπορείτε να αλλάξετε την προεπιλεγμένη μορφή για όλες τις τιμές εξόδου αντί να ορίσετε κάθε παράμετρο ξεχωριστά.
Για τη μόνιμη αλλαγή μορφής εξόδου (μέχρι να κλείσει η τρέχουσα κονσόλα), εκτελέστε τη γραμμή εντολών:
- Ρύθμιση εξόδου 'λειτουργία νέων παραμέτρων'
Το παραπάνω στιγμιότυπο οθόνης δείχνει την προεπιλεγμένη προκαθορισμένη μορφή τιμής εισόδου σε Συμβολοσειρά (παράμετροι s).
EXAMPLE 1
Ας εκτελέσουμε τώρα τη δοκιμή με την απλή γραμμή εντολών:
- Αποκτήστε την ΚάρταIdEx
Τώρα τα αποτελέσματα εξόδου είναι τιμές συμβολοσειράς, παρόλο που η γραμμή εντολών δεν έχει καθορισμένη πρόσθετη λειτουργία παραμέτρων.
Όπως μπορείτε να δείτε, όλες οι τιμές εξόδου είναι τιμές συμβολοσειράς με το χαρακτήρα ανάστροφης καθέτου () στη θέση του πρώτου χαρακτήρα τους. Το λογισμικό προσθέτει αυτόματα αυτόν τον χαρακτήρα στις τιμές εξόδου που περιέχουν τους μη εκτυπώσιμους χαρακτήρες.
EXAMPLE 2
Το επόμενο παράδειγμα παρουσιάζει την έξοδο συμβολοσειράς όταν η τιμή είναι εκτυπώσιμη.
Ας γράψουμε το περιεχόμενο στην κάρτα μόνο με εκτυπώσιμους χαρακτήρες.
Το παράδειγμα γραμμής εντολών είναι:
- WriteUserData "Παράδειγμα-Δοκιμή"
Σημείωση: Το περιεχόμενο συμβολοσειράς που θα εγγραφεί είναι γραμμένο σε εισαγωγικά στη γραμμή εντολών.
Τώρα, διαβάστε την έξοδο περιεχομένου. Η γραμμή εντολών είναι:
-
- ΑνάγνωσηΧρήστηςΔεδομένα
Σε αυτήν την περίπτωση, η έξοδος δεν έχει χαρακτήρα ανάστροφης καθέτου στην αρχή. Το υπόλοιπο περιεχόμενο εξόδου (ακολουθώντας το περιεχόμενο που καταγράφηκε προηγουμένως) είναι προεπιλεγμένες τιμές- αχρησιμοποίητα byte που εμφανίζονται ως τιμές xFF.
4. Κέλυφος uFR – Διαφορές υλοποίησης σε υποστηριζόμενα περιβάλλοντα λειτουργικού συστήματος
- Λειτουργικό σύστημα Windows – Η υλοποίηση στο σύστημα των Windows δεν απαιτεί πρόσθετα δικαιώματα για την εργασία με λειτουργίες κελύφους uFR. Αρκεί να εγκαταστήσετε σωστά τον αναγνώστη ufr και τις βιβλιοθήκες του.
- Λειτουργικό σύστημα Linux – Ως συνήθως στο σύστημα Linux, η πλήρης λειτουργικότητα του λογισμικού uFR Shell σε επικοινωνία με τη συσκευή απαιτεί την κατάλληλη άδεια χρήστη.
- MacOS – Για να διασφαλίσετε την άμεση λειτουργικότητα του λογισμικού σε αυτό το λειτουργικό σύστημα, αντιγράψτε τη βιβλιοθήκη libuRCoder.dylib στο φάκελο βιβλιοθηκών συστημάτων.
Αυτό το εγχειρίδιο παρουσιάζει παραδείγματα λογισμικού με πολλές βασικές λειτουργίες. Μια λίστα με όλες τις υποστηριζόμενες λειτουργίες περιλαμβάνεται στο πακέτο λήψης λογισμικού.
