Βιβλιοθήκη πλήκτρων αφής Holtek HT32 MCU
Εισαγωγή
Η βιβλιοθήκη πλήκτρων αφής HT32 που αναπτύχθηκε από την Best Solution είναι μια βιβλιοθήκη που ενσωματώνει στο MCU όλο το κλειδί αφής που βρίσκεται κάτω από τη βιβλιοθήκη προγραμμάτων οδήγησης fileμικρό. Η βιβλιοθήκη έχει προδιαμορφώσει το υλικό MCU που σχετίζεται με την αφή και παρέχει εύχρηστες και ευέλικτες ρυθμίσεις ευαισθησίας πλήκτρων αφής, ενώ ενσωματώνει κοινές λειτουργίες όπως ανίχνευση πλήκτρων και λειτουργίες ύπνου εξοικονόμησης ενέργειας. Η χρήση της βιβλιοθήκης πλήκτρων αφής HT32 απλοποιεί τη χρήση των λειτουργιών αφής MCU, επιτρέποντας στους χρήστες να ξεκινήσουν γρήγορα και μειώνοντας την περίοδο ανάπτυξης. Αυτό το έγγραφο θα περιγράψει λεπτομερώς την περιβαλλοντική διαμόρφωση και τη χρήση της βιβλιοθήκης.
Περιβαλλοντική Διαμόρφωση
Αποκτήστε τη βιβλιοθήκη πλήκτρων αφής HT32
Επικοινωνήστε με την FAE της Best Solution ή ανατρέξτε σε αυτήν webτοποθεσία: http://www.bestsolution.com.tw/EN/
Ή κατεβάστε τη βιβλιοθήκη από το Holtek webτοποθεσία: https://www.holtek.com
Αποκτήστε τη βιβλιοθήκη υλικολογισμικού HT32
Ανατρέξτε στον ακόλουθο σύνδεσμο για να αποκτήσετε γρήγορα τη βιβλιοθήκη υλικολογισμικού: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Ανοίξτε τον σύνδεσμο, επιλέξτε Έγγραφα όπως φαίνεται στην Εικόνα 1, όπου το κόκκινο πλαίσιο υποδεικνύει τη θέση του συμπιεσμένου HT32 fileμικρό. Σημειώστε ότι μόνο η βιβλιοθήκη υλικολογισμικού της έκδοσης v022 ή νεότερης υποστηρίζει τη βιβλιοθήκη πλήκτρων αφής HT32.
Διαμόρφωση έργου Keil
- Ο υπολογιστής του χρήστη πρέπει να έχει εγκατεστημένο το εργαλείο ανάπτυξης Keil.
- Αποσυμπιέστε τη βιβλιοθήκη υλικολογισμικού. ο files παρατίθενται όπως φαίνεται στην Εικόνα 2. Κάντε κλικ στο Holtek.HT32_DFP.latest για να το εγκαταστήσετε και μετά θα εμφανιστεί η οθόνη ολοκλήρωσης της εγκατάστασης, όπως φαίνεται στην Εικόνα 3.
- Αποσυμπιέστε τη βιβλιοθήκη πλήκτρων αφής HT32 που περιλαμβάνει δύο φακέλους, π.χample και βιβλιοθήκη.
- Αντιγράψτε το πρώηνample και φακέλους βιβλιοθήκης στο φάκελο HT32_STD_xxxxx_FWLib_v022_XXXX.
- Εκτελέστε ..\π.χample\TouchKey\TouchKey_LIB\_CreateProject.bat (Εικόνα 6).
- Θα εμφανιστεί μια διεπαφή, όπως φαίνεται στην Εικόνα 7. Εισαγάγετε τον αριθμό που αντιστοιχεί στο IDE του χρήστη και μετά θα εμφανιστεί ένα σύμβολο "*" πριν από το επιλεγμένο IDE, όπως φαίνεται στην Εικόνα 8. Εισαγάγετε "N" για να μεταβείτε στο επόμενο βήμα.
- Όπως φαίνεται παρακάτω, πληκτρολογήστε "*" για να δημιουργήσετε έργα για όλους τους τύπους IC ή πληκτρολογήστε το όνομα IC για να δημιουργήσετε ένα έργο για το επιλεγμένο IC.
- Αφού ολοκληρώσετε τα βήματα 1~7, όπως φαίνεται στην Εικόνα 11, επιλέξτε το επιθυμητό έργο IC όπως Project_54xxx.uvprojx από το ..\exampδιαδρομή le\TouchKey\TouchKey_LIB\MDK_ARMv5\.
Σημείωμα ότι μόνο το MCU με τους μεγαλύτερους πόρους σε κάθε σειρά χρησιμοποιείται για τη δημιουργία του έργου. Για π.χample, για να χρησιμοποιήσουν το HT32F54231 οι χρήστες πρέπει να επιλέξουν το έργο HT32F54241.
Θεωρήσεις
Καθώς το πρόγραμμα πλήκτρων αφής μπορεί να εισέλθει σε κατάσταση αδράνειας, απαιτείται να ρυθμίσετε το έργο σε ενεργοποίηση κατά την επαναφορά, διαφορετικά δεν θα είναι διαθέσιμο για προγραμματισμό. Τα βήματα ρύθμισης είναι τα εξής.
- Βήμα 1: Κάντε κλικ στο κουμπί στο μενού εργαλείων Keil5, όπως φαίνεται παρακάτω.
- Βήμα 2: Επιλέξτε Εντοπισμός σφαλμάτων–> Ρυθμίσεις.
- Βήμα 3: Επιλέξτε «υπό Επαναφορά» στο πεδίο Σύνδεση.
Βιβλιοθήκη Files Περιγραφή
Βιβλιοθήκη που χρησιμοποιούνται
| Keil Project | Χρησιμοποιήσιμο IC | ROM/RAM Πόροι | Μεταχειρισμένη IP | Μέγιστη. Αριθμός κλειδιών |
| HT32F54241 | HT32F54241 HT32F54231 | 7148Β/2256Β | Πλήκτρο αφής
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140Β/2528Β | Πλήκτρο αφής BFTM0
RTC |
28 |
- Το RTC χρησιμοποιείται για την αφύπνιση του MCU από την κατάσταση αδράνειας και χρησιμοποιείται ως βάση χρόνου για την επεξεργασία της κατάστασης αδράνειας.
- Όταν το πρόγραμμα φορτωθεί στο IC, το Keil θα καθορίσει εάν έχει γίνει υπέρβαση του μεγέθους ROM ή RAM.
- Για τη συγκεκριμένη χρήση των πόρων, ανατρέξτε στην πραγματική έκδοση της βιβλιοθήκης.
Περιβάλλον και File Περιγραφή
Η βιβλιοθήκη πλήκτρων αφής HT32 βρίσκεται στην παρακάτω διαδρομή. ..\πρώηνample\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx έργο (Εικόνα 15). Αφού ανοίξει το έργο της βιβλιοθήκης πλήκτρων αφής HT32, η κύρια οθόνη εμφανίζεται ως Εικόνα 16.
Το σχετικό files περιγράφονται ως εξής, μεταξύ των οποίων είναι τα ht32_TouchKey_conf.h και system_ht32f5xxxx_09.c files, περιλαμβάνεται στον Οδηγό διαμόρφωσης. Δείτε την Εικόνα 17.
| File Ονομα | Περιγραφή |
| κύρια.γ | Το κύριο πρόγραμμα του έργου file |
| ht32f5xxxx_01_it.c | Διακοπή του κύριου προγράμματος file |
| ht32_TouchKey_Lib_Mx_Keil.lib | Βιβλιοθήκη ελέγχου αφής file |
| *ht32_TouchKey_conf.h | Παράμετρος ελέγχου αφής file |
| ht32_TouchKey.h | Ορισμός εξωτερικής δήλωσης file |
| ht32_TouchKey_BSconf.h | Υποκείμενη κύρια παράμετρος file (δεν συνιστάται η τροποποίηση) |
| ht32_board_config.h | Ορισμός υλικού file (δεν συνιστάται η τροποποίηση) |
| *system_ht32f5xxxx_09.c | Πηγή ρολογιού και παράμετρος ρολογιού συστήματος file |
Παράμετροι οδηγού διαμόρφωσης
- ht32_TouchKey_conf.h Παράμετροι του οδηγού διαμόρφωσης:
Ονομα Λειτουργία Εξοικονόμηση ενέργειας Ενεργοποιήστε την προεπιλεγμένη διαδικασία ύπνου που ορίζεται στο main.c TKL_HighSensitive Ρύθμιση ευαισθησίας αφής: υψηλή ή χαμηλή ευαισθησία. προεπιλογή σε υψηλή ευαισθησία μετά την ενεργοποίηση TKL_keyDebounce Ρύθμιση χρόνου αφαίρεσης κλειδιού TKL_RefCalTime Χρόνος βαθμονόμησης. Όσο μικρότερος είναι ο χρόνος, τόσο πιο αποτελεσματικό θα είναι στην αντίσταση στις περιβαλλοντικές παρεμβολές, ωστόσο θα έχει ως αποτέλεσμα χαμηλότερες βασικές ευαισθησίες. TKL_MaxOnHoldTime Ο μέγιστος χρόνος που πατιέται το πλήκτρο. Το πλήκτρο απελευθερώνεται αυτόματα αφού πατηθεί για n δευτερόλεπτα. KEYn_EN Ενεργοποιήστε ή απενεργοποιήστε το KEYn KeynThreshold KEYn τιμή κατωφλίου. Όσο μικρότερη είναι η τιμή, τόσο πιο ευαίσθητο θα είναι το κλειδί. - system_ht32f5xxxx_09.c Παράμετροι του οδηγού διαμόρφωσης:
Ονομα Λειτουργία Ενεργοποίηση εξωτερικού ταλαντωτή κρυστάλλων υψηλής ταχύτητας – HSE Ενεργοποίηση ή απενεργοποίηση HSE (εξωτερικός ταλαντωτής υψηλής ταχύτητας) Ενεργοποίηση εξωτερικού ταλαντωτή κρυστάλλων χαμηλής ταχύτητας – LSE Ενεργοποίηση ή απενεργοποίηση LSE (εξωτερικός ταλαντωτής χαμηλής ταχύτητας) Ενεργοποίηση PLL Ενεργοποιήστε ή απενεργοποιήστε το PLL Πηγή ρολογιού PLL Επιλέξτε πηγή ρολογιού για PLL SystemCoreClock Configuration (CK_AHB) Επιλέξτε πηγή ρολογιού για το σύστημα CK_AHB
Περιγραφή των λειτουργιών διασύνδεσης πλήκτρων αφής
Περιγραφή των λειτουργιών Get
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_Get_Standby |
| Παράμετρος εισαγωγής | — |
| Επιστρεφόμενη Αξία | Καταμέτρηση αξίας (500~60000) |
| Περιγραφή | Χρησιμοποιείται για τη λήψη της αντίστροφης τιμής του μετρητή |
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_Get_KeyRCCValue |
| Παράμετρος εισαγωγής | Τιμή κλειδιού (0 ~ μέγ. τιμή κλειδιού), συχνότητα (0, 1) |
| Επιστρεφόμενη Αξία | Τιμή χωρητικότητας (0~1023) |
| Περιγραφή | Χρησιμοποιείται για τη λήψη της τιμής χωρητικότητας του καθορισμένου κλειδιού |
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_GetKeyRef |
| Παράμετρος εισαγωγής | Τιμή κλειδιού (0 ~ μέγιστη τιμή κλειδιού) |
| Επιστρεφόμενη Αξία | Τιμή αναφοράς (0~65535) |
| Περιγραφή | Χρησιμοποιείται για τη λήψη της τιμής αναφοράς του καθορισμένου κλειδιού |
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_GetKeyThreshold |
| Παράμετρος εισαγωγής | Τιμή κλειδιού (0 ~ μέγιστη τιμή κλειδιού) |
| Επιστρεφόμενη Αξία | Τιμή κατωφλίου (0~255) |
| Περιγραφή | Χρησιμοποιείται για τη λήψη της τιμής κατωφλίου του καθορισμένου κλειδιού |
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_Get_AllKeyState |
| Παράμετρος εισαγωγής | — |
| Επιστρεφόμενη Αξία | Κατάσταση κλειδιού (32-bit)
Το BITn σημαίνει κατάσταση KEYn Bit0 = 1 σημαίνει ότι πατιέται το KEY0, Bit0 = 0 σημαίνει ότι δεν έχει πατηθεί το KEY0 |
| Περιγραφή | Χρησιμοποιείται για τη λήψη όλων των βασικών καταστάσεων |
Περιγραφή των συναρτήσεων συνόλου
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_Set_KeyThreshold |
| Παράμετρος εισαγωγής | Βασική τιμή (0 ~ μέγ. τιμή κλειδιού), τιμή κατωφλίου (10~127) |
| Επιστρεφόμενη Αξία | — |
| Περιγραφή | Χρησιμοποιείται για τον ορισμό της τιμής κατωφλίου του καθορισμένου κλειδιού |
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_Set_Standby |
| Παράμετρος εισαγωγής | Χρόνος ύπνου (500~60000) |
| Επιστρεφόμενη Αξία | — |
| Περιγραφή | Χρησιμοποιείται για τη ρύθμιση του μετρητή αντίστροφης μέτρησης (δεν συνιστάται η χρήση αυτής της λειτουργίας) |
Περιγραφή των λειτουργιών κράτους και διοίκησης
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_Is_Time |
| Παράμετρος εισαγωγής | Προκαθορισμένη σταθερά (kT2mS, kT4mS…kT2048mS) |
| Επιστρεφόμενη Αξία | — |
| Περιγραφή | Σημαία ώρας για αναφορά χρήστη.
Στο παρακάτω π.χample, το πρόγραμμα μπαίνει στη συνάρτηση κάθε 2 ms. |
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_Is_AnyKeyPress |
| Παράμετρος εισαγωγής | — |
| Επιστρεφόμενη Αξία | 1 = ένα ή περισσότερα κλειδιά έχουν ενεργοποιηθεί. 0 = δεν έχει ενεργοποιηθεί κανένα κλειδί |
| Περιγραφή | Χρησιμοποιείται για να λάβετε τη σημαία πίεσης πλήκτρων |
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_Is_KeyPress |
| Παράμετρος εισαγωγής | Τιμή κλειδιού (0 ~ μέγιστη τιμή κλειδιού) |
| Επιστρεφόμενη Αξία | 1 = το κλειδί έχει ενεργοποιηθεί. 0 = το κλειδί δεν έχει ενεργοποιηθεί |
| Περιγραφή | Χρησιμοποιείται για τη λήψη της σημαίας κατάστασης του καθορισμένου κλειδιού |
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_Is_Active |
| Παράμετρος εισαγωγής | — |
| Επιστρεφόμενη Αξία | 1 = Η προετοιμασία LIB έχει ολοκληρωθεί. 0 = Η προετοιμασία LIB δεν έχει ολοκληρωθεί |
| Περιγραφή | Χρησιμοποιείται για τη λήψη της σημαίας κατάστασης προετοιμασίας LIB |
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_Is_Standby |
| Παράμετρος εισαγωγής | — |
| Επιστρεφόμενη Αξία | 1 = επιτρέπεται να εισέλθει σε κατάσταση ύπνου. 0 = δεν επιτρέπεται η είσοδος σε κατάσταση αδράνειας |
| Περιγραφή | Χρησιμοποιείται για τη λήψη της σημαίας κατάστασης ύπνου.
*Όταν επιστρέφεται μια τιμή 0, τότε η είσοδος σε κατάσταση αναστολής λειτουργίας μπορεί να οδηγήσει σε μια απροσδόκητη κατάσταση. |
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_Is_KeyScanCycle |
| Παράμετρος εισαγωγής | — |
| Επιστρεφόμενη Αξία | 1 = η σάρωση ολοκληρώθηκε. 0 = σάρωση επί του παρόντος |
| Περιγραφή | Χρησιμοποιείται για τη λήψη της σημαίας σάρωσης |
| Είδος | Περιγραφή |
| Όνομα συνάρτησης | TKL_Reset |
| Παράμετρος εισαγωγής | — |
| Επιστρεφόμενη Αξία | — |
| Περιγραφή | Χρησιμοποιείται για να εξαναγκάσει το LIB να εκτελέσει μια ενέργεια επαναφοράς.
*Οι σημαίες που χρησιμοποιούνται από το LIB και τη RAM θα αρχικοποιηθούν. *Οι παράμετροι και το AFIO εξαιρούνται. |
Περιγραφή των λειτουργιών αρχικοποίησης του πλήκτρου αφής
Αυτές οι λειτουργίες βρίσκονται στο main.c. Δεν συνιστάται η τροποποίηση του περιεχομένου τους.
| Ονομα | Λειτουργία |
| GPIO_Configuration() | Διαμορφώσεις θυρών I/O |
| RTC_Configuration() | Τα πλήκτρα αφής ξυπνούν από το RTC |
| BFTM_Configuration() | Οι βάσεις χρόνου της βιβλιοθήκης πλήκτρων αφής υλοποιούνται από το BFTM |
| TKL_Configuration() | Αγγίξτε τις διαμορφώσεις πλήκτρων |
Ερώτημα βασικής κατάστασης
Όπως φαίνεται παρακάτω, το κύριο πρόγραμμα περιλαμβάνει ένα πλήκτρο αφής π.χample που δεν θα ενεργοποιηθεί από προεπιλογή. Για να ενεργοποιήσετε αυτή τη λειτουργία, τροποποιήστε το (0) μετά το #if σε (1).
Περιγραφή κατάστασης ύπνου
- Στο ht32_TouchKey_conf.h, επιλέξτε PowerSave για να ενεργοποιήσετε τις λειτουργίες ύπνου.
- Αφού ενεργοποιηθούν οι λειτουργίες αναστολής λειτουργίας, τα πλήκτρα αφής θα εισέλθουν σε κατάσταση αδράνειας εάν τα πλήκτρα δεν έχουν αντιμετωπίσει συνθήκες αφής για ένα συγκεκριμένο χρονικό διάστημα.
- Χρησιμοποιείται μια λειτουργία καταμέτρησης χρόνου αναμονής για τη μέτρηση προς τα κάτω, η τρέχουσα ώρα λαμβάνεται χρησιμοποιώντας το TKL_Get_Standby και η παράμετρος χρόνου ρυθμίζεται χρησιμοποιώντας το TKL_Set_Standby.
- Υπάρχουν τρεις επιλογές λειτουργίας ύπνου.
Τρόπος Περιγραφή USE_SLEEP_MODE Μπείτε σε κατάσταση αναστολής USE_DEEP_SLEEP1_MODE Μπείτε στη λειτουργία Deep Sleep1 USE_DEEP_SLEEP2_MODE Μπείτε στη λειτουργία Deep Sleep2 - Όπως φαίνεται παρακάτω, ορίστε την απαιτούμενη λειτουργία ύπνου χρησιμοποιώντας το "#define" στο κύριο file.
Σύναψη
Αυτό το έγγραφο παρέχει οδηγίες για τη ρύθμιση ολόκληρου του περιβάλλοντος ανάπτυξης κλειδιού αφής HT32, βοηθώντας τους χρήστες να ξεκινήσουν γρήγορα. Επιπλέον, οι πόροι που χρησιμοποιεί η βιβλιοθήκη, καθώς και διάφορες λειτουργίες και παράμετροι, έχουν επεξηγηθεί λεπτομερώς, επιτρέποντας μια ευκολότερη διαδικασία ανάπτυξης.
Υλικό Αναφοράς
Για περισσότερες λεπτομέρειες, ανατρέξτε στο Holtek webτοποθεσία: www.holtek.com ή συμβουλευτείτε την Καλύτερη Λύση webτοποθεσία: http://www.bestsolution.com.tw/EN/
Πληροφορίες εκδόσεων και τροποποίησης:
| Ημερομηνία | Συγγραφέας | Ελευθέρωση | Περιγραφή |
| 2022.03.16 | 谢东霖、梁德浩 | V1.00 | Πρώτη έκδοση |
Αρνηση
Όλες οι πληροφορίες, εμπορικά σήματα, λογότυπα, γραφικά, βίντεο, ηχητικά κλιπ, σύνδεσμοι και άλλα στοιχεία που εμφανίζονται σε αυτό webο ιστότοπος («Πληροφορίες») είναι μόνο για αναφορά και υπόκειται σε αλλαγές ανά πάσα στιγμή χωρίς προηγούμενη ειδοποίηση και κατά την κρίση της Holtek Semiconductor Inc. και των συνδεδεμένων εταιρειών της (στο εξής «Holtek», «η εταιρεία», «εμάς», « εμείς» ή «μας»). Ενώ η Holtek προσπαθεί να διασφαλίσει την ακρίβεια των πληροφοριών σχετικά με αυτό webιστοσελίδα, καμία ρητή ή σιωπηρή εγγύηση δεν παρέχεται από την Holtek για την ακρίβεια των Πληροφοριών. Η Holtek δεν θα φέρει καμία ευθύνη για οποιαδήποτε ανακρίβεια ή διαρροή.
Η Holtek δεν θα είναι υπεύθυνη για τυχόν ζημιές (συμπεριλαμβανομένων, ενδεικτικά, ιών υπολογιστών, προβλημάτων συστήματος ή απώλειας δεδομένων) οποιασδήποτε μορφής προκύψει κατά τη χρήση ή σε σχέση με τη χρήση αυτού webιστότοπο από οποιοδήποτε μέρος. Ενδέχεται να υπάρχουν σύνδεσμοι σε αυτήν την περιοχή, που σας επιτρέπουν να επισκεφθείτε το webιστοσελίδες άλλων εταιρειών. Αυτά τα webοι ιστότοποι δεν ελέγχονται από την Holtek. Η Holtek δεν θα φέρει καμία ευθύνη και καμία εγγύηση για τις πληροφορίες που εμφανίζονται σε τέτοιους ιστότοπους. Υπερσύνδεσμοι προς άλλα webοι ιστότοποι είναι με δική σας ευθύνη.
Περιορισμός Ευθύνης
Σε καμία περίπτωση η Holtek Limited δεν φέρει ευθύνη έναντι οποιουδήποτε άλλου μέρους για οποιαδήποτε απώλεια ή ζημιά οποιαδήποτε ή με οποιοδήποτε τρόπο προκληθεί άμεσα ή έμμεσα σε σχέση με την πρόσβασή σας ή τη χρήση αυτού webτον ιστότοπο, το περιεχόμενο αυτού ή οποιαδήποτε αγαθά, υλικά ή υπηρεσίες.
Ισχύον Νόμος
Η Αποποίηση ευθυνών που περιέχεται στο webο ιστότοπος διέπεται και ερμηνεύεται σύμφωνα με τους νόμους της Δημοκρατίας της Κίνας. Οι χρήστες θα υποβάλλονται στη μη αποκλειστική δικαιοδοσία των δικαστηρίων της Δημοκρατίας της Κίνας.
Ενημέρωση Αποποίησης Ευθύνης
Η Holtek διατηρεί το δικαίωμα να ενημερώσει την Αποποίηση ευθυνών ανά πάσα στιγμή με ή χωρίς προηγούμενη ειδοποίηση, όλες οι αλλαγές ισχύουν αμέσως μετά τη δημοσίευση στο webτοποθεσία.
Έγγραφα / Πόροι
 |
Βιβλιοθήκη πλήκτρων αφής Holtek HT32 MCU [pdf] Οδηγός χρήστη HT32, MCU Touch Key Library, HT32 MCU Touch Key Library |
