Holtek HT32 MCU Touch Key Librerija
Introduzzjoni
Il-librerija tat-touch key HT32 żviluppata minn Best Solution hija librerija li tintegra fl-MCU il-librerija tas-sewwieq sottostanti kollha tat-touch key. files. Il-librerija kkonfigurat minn qabel il-ħardwer MCU relatat mal-mess, u tipprovdi settings intuwittivi u flessibbli tas-sensittività taċ-ċavetta tal-mess, filwaqt li tintegra funzjonijiet komuni bħal sejbien taċ-ċavetta u modi ta 'rqad li jiffrankaw l-enerġija. L-użu tal-librerija tat-touch key HT32 jissimplifika l-użu tal-funzjonijiet tat-touch MCU, li jippermetti lill-utenti jibdew malajr u jnaqqas il-perjodu ta 'żvilupp. Dan id-dokument ser jiddeskrivi fid-dettall il-konfigurazzjoni ambjentali u l-użu tal-librerija.
Konfigurazzjoni Ambjentali
Ikseb HT32 Touch Key Library
Ikkuntattja l-FAE tal-Aħjar Soluzzjoni jew irreferi għaliha websit: http://www.bestsolution.com.tw/EN/
Jew tniżżel il-librerija mill-Holtek websit: https://www.holtek.com
Ikseb HT32 Firmware Librerija
Irreferi għall-link li ġejja biex tikseb malajr il-librerija tal-firmware: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Iftaħ il-link, agħżel l-għażla Dokumenti kif muri fil-Figura 1, fejn il-kaxxa ħamra tindika l-post tal-HT32 kompressat files. Innota li l-librerija tal-firmware tal-verżjoni v022 jew ogħla biss tappoġġja l-librerija tat-touch key HT32.
Konfigurazzjoni tal-Proġett Keil
- Il-PC tal-utent jeħtieġ li jkollu l-għodda tal-iżvilupp Keil installata.
- Unzip il-librerija tal-firmware. Il- files huma elenkati kif muri fil-Figura 2. Ikklikkja fuq Holtek.HT32_DFP.latest biex tinstallah, wara li tidher l-iskrin tat-tlestija tal-installazzjoni, kif muri fil-Figura 3.
- Unzip il-librerija taċ-ċavetta touch HT32 li tinkludi żewġ folders, eżample u librerija.
- Ikkopja l-example u folders tal-librerija għall-folder HT32_STD_xxxxx_FWLib_v022_XXXX.
- Eżegwixxi ..\eżample\TouchKey\TouchKey_LIB\_CreateProject.bat (Figura 6).
- Se tidher interface, kif muri fil-Figura 7. Daħħal in-numru li jikkorrispondi għall-IDE tal-utent, u wara jidher sinjal “*” qabel l-IDE magħżul, kif muri fil-Figura 8. Daħħal “N” biex tmur għall-pass li jmiss.
- Kif muri hawn taħt, daħħal "*" biex toħloq proġetti għat-tipi kollha IC jew daħħal l-isem IC biex toħloq proġett għall-IC magħżul.
- Wara li tlesti l-passi 1~7, kif muri fil-Figura 11, agħżel il-proġett IC mixtieq bħal Project_54xxx.uvprojx mill-..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\ passaġġ.
Nota li l-MCU biss bl-akbar riżorsi f'kull serje jintuża biex jinħoloq il-proġett. Per example, biex tuża l-utenti HT32F54231 għandhom jagħżlu l-proġett HT32F54241.
Konsiderazzjonijiet
Peress li l-programm touch key jista 'jidħol fl-istat ta' rqad, huwa meħtieġ li l-proġett jiġi ssettjat biex jinxtegħel mill-ġdid, inkella ma jkunx disponibbli għall-ipprogrammar. Il-passi tal-issettjar huma kif ġej.
- Pass 1: Ikklikkja l-buttuna fil-menu tal-għodda Keil5, kif muri hawn taħt.
- Pass 2: Agħżel Debug–> Settings.
- Pass 3: Agħżel "taħt Irrisettja" fil-qasam Connect.
Librerija Files Deskrizzjoni
Riżorsi Użati tal-Librerija
| Proġett Keil | IC li jista 'jintuża | ROM/RAM Riżorsi | IP użat | Max. Numru ta' Ċwievet |
| HT32F54241 | HT32F54241 HT32F54231 | 7148B / 2256B | Touch key
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140B / 2528B | Touch key BFTM0
RTC |
28 |
- L-RTC jintuża biex iqajjem l-MCU mill-istat ta 'rqad u jintuża bħala bażi ta' ħin għall-ipproċessar tal-istat ta 'rqad.
- Meta l-programm jitgħabba fl-IC, il-Keil se jiddetermina jekk id-daqs ROM jew RAM inqabeż.
- Għall-użu speċifiku tar-riżorsi, irreferi għall-verżjoni attwali tal-librerija.
Ambjent u File Deskrizzjoni
Il-librerija taċ-ċwievet touch HT32 tinsab fit-triq li ġejja. ..\eżample\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx proġett (Figura15). Wara li jinfetaħ il-proġett tal-librerija tat-touch key HT32, l-iskrin prinċipali jidher bħala Figura 16.
Il rilevanti files huma deskritti kif ġej, fosthom il-ht32_TouchKey_conf.h u system_ht32f5xxxx_09.c files, inklużi fil-Konfigurazzjoni Wizard. Ara l-Figura 17.
| File Isem | Deskrizzjoni |
| prinċipali.c | Programm ewlieni tal-proġett file |
| ht32f5xxxx_01_it.c | Interromp il-programm prinċipali file |
| ht32_TouchKey_Lib_Mx_Keil.lib | Librerija tal-kontroll touch file |
| *ht32_TouchKey_conf.h | Parametru tal-kontroll touch file |
| ht32_TouchKey.h | Definizzjoni ta' dikjarazzjoni esterna file |
| ht32_TouchKey_BSconf.h | Parametru prinċipali sottostanti file (mhux rakkomandat li timmodifika) |
| ht32_board_config.h | Definizzjoni tal-ħardwer file (mhux rakkomandat li timmodifika) |
| *system_ht32f5xxxx_09.c | Sors tal-arloġġ u parametru tal-arloġġ tas-sistema file |
Konfigurazzjoni Wizard Parametri
- ht32_TouchKey_conf.h Parametri tal-Wizard tal-Konfigurazzjoni:
Isem Funzjoni PowerSave Attiva l-proċedura ta' sleep default definita f'main.c TKL_HighSensitive Issettjar tas-sensittività tal-mess: sensittività għolja jew baxxa; default għal sensittività għolja wara li tkun attivata TKL_keyDebounce L-issettjar tal-ħin tad-debounce ewlieni TKL_RefCalTime Ħin tal-kalibrazzjoni. Iktar ma jkun iqsar iż-żmien, iktar ikun effettiv biex jirreżisti l-interferenza ambjentali, madankollu se jirriżulta f'sensittivitajiet ewlenin aktar baxxi. TKL_MaxOnHoldTime Il-ħin massimu li ċ-ċavetta tiġi ppressata. Iċ-ċavetta tiġi rilaxxata awtomatikament wara li tiġi ppressata għal n sekondi. KEYn_MT Ippermetti jew tiddiżattiva KEYn KeynThreshold Valur tal-limitu KEYn. Iktar ma jkun żgħir il-valur, aktar iċ-ċavetta tkun sensittiva. - system_ht32f5xxxx_09.c Parametri tal-Wizard tal-Konfigurazzjoni:
Isem Funzjoni Ippermetti l-Oxxillatur tal-Kristall Estern b'Veloċità Għolja - HSE Ippermetti jew tiddiżattiva HSE (oxxillatur estern b'veloċità għolja) Ippermetti Oxxillatur tal-Kristall Estern b'Veloċità Baxxa - LSE Ippermetti jew tiddiżattiva LSE (oxxillatur estern b'veloċità baxxa) Ippermetti PLL Attiva jew tiddiżattiva PLL Sors tal-Arloġġ PLL Agħżel is-sors tal-arloġġ għal PLL SystemCoreClockConfiguration (CK_AHB) Agħżel is-sors tal-arloġġ għas-sistema CK_AHB
Deskrizzjoni tal-Funzjonijiet tal-Interface Touch Key Lib
Deskrizzjoni tal-Funzjonijiet Ikseb
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_Get_Standby |
| Parametru tal-Input | — |
| Valur tar-Ritorn | Valur tal-għadd (500~60000) |
| Deskrizzjoni | Użat biex jikseb il-valur tal-count-down tal-għadd |
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_Get_KeyRCCValue |
| Parametru tal-Input | Valur taċ-ċavetta (0 ~ valur massimu taċ-ċavetta), frekwenza (0, 1) |
| Valur tar-Ritorn | Valur tal-kapaċità (0~1023) |
| Deskrizzjoni | Użat biex jikseb il-valur tal-kapaċità taċ-ċavetta speċifikata |
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_GetKeyRef |
| Parametru tal-Input | Valur taċ-ċavetta (0 ~ valur massimu taċ-ċavetta) |
| Valur tar-Ritorn | Valur ta' referenza (0~65535) |
| Deskrizzjoni | Użat biex jikseb il-valur ta 'referenza taċ-ċavetta speċifikata |
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_GetKeyThreshold |
| Parametru tal-Input | Valur taċ-ċavetta (0 ~ valur massimu taċ-ċavetta) |
| Valur tar-Ritorn | Valur tal-limitu (0~255) |
| Deskrizzjoni | Użat biex jikseb il-valur tal-limitu taċ-ċavetta speċifikata |
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_Get_AllKeyState |
| Parametru tal-Input | — |
| Valur tar-Ritorn | Stat ewlieni (32-bit)
BITn tirreferi għall-istat KEYn Bit0 = 1 ifisser li KEY0 hija ppressata, Bit0 = 0 tfisser li KEY0 mhix ippressata |
| Deskrizzjoni | Użat biex tikseb l-istati ewlenin kollha |
Deskrizzjoni tal-Funzjonijiet Issettjati
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_Set_KeyThreshold |
| Parametru tal-Input | Valur taċ-ċavetta (0 ~ valur massimu taċ-ċavetta), valur tal-limitu (10 ~ 127) |
| Valur tar-Ritorn | — |
| Deskrizzjoni | Użat biex jiġi stabbilit il-valur tal-limitu taċ-ċavetta speċifikata |
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_Set_Standby |
| Parametru tal-Input | Ħin ta' rqad (500 ~ 60000) |
| Valur tar-Ritorn | — |
| Deskrizzjoni | Użat biex issettja l-count-down counter (mhux rakkomandat li tuża din il-funzjoni) |
Deskrizzjoni tal-Funzjonijiet tal-Istat u tal-Kmand
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_Is_Time |
| Parametru tal-Input | Kostanti ssettjati minn qabel (kT2mS, kT4mS...kT2048mS) |
| Valur tar-Ritorn | — |
| Deskrizzjoni | Bandiera tal-ħin għar-referenza tal-utent.
Fl-eżample, il-programm jidħol fil-funzjoni kull 2ms. |
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_Is_AnyKeyPress |
| Parametru tal-Input | — |
| Valur tar-Ritorn | 1 = ċavetta waħda jew aktar ġiet attivata; 0 = l-ebda ċavetta ma ġiet attivata |
| Deskrizzjoni | Użat biex tikseb il-bandiera tal-istampa taċ-ċavetta |
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_Is_KeyPress |
| Parametru tal-Input | Valur taċ-ċavetta (0 ~ valur massimu taċ-ċavetta) |
| Valur tar-Ritorn | 1 = ċavetta ġiet attivata; 0 = ċavetta ma ġietx attivata |
| Deskrizzjoni | Użat biex tikseb il-bandiera tal-istat taċ-ċavetta speċifikata |
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_Is_Active |
| Parametru tal-Input | — |
| Valur tar-Ritorn | 1 = L-inizjalizzazzjoni tal-LIB intemmet; 0 = L-inizjalizzazzjoni tal-LIB ma spiċċatx |
| Deskrizzjoni | Użat biex tinkiseb il-bandiera tal-istat tal-inizjalizzazzjoni tal-LIB |
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_Is_Standby |
| Parametru tal-Input | — |
| Valur tar-Ritorn | 1 = jitħalla jidħol fl-istat ta' rqad; 0 = mhux permess li jidħol fl-istat ta' rqad |
| Deskrizzjoni | Użat biex tinkiseb il-bandiera tal-istat ta 'rqad.
*Meta valur ta '0 jiġi rritornat, imbagħad id-dħul fl-istat ta' rqad jista 'jirriżulta fi stat mhux mistenni. |
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_Is_KeyScanCycle |
| Parametru tal-Input | — |
| Valur tar-Ritorn | 1 = l-iskan intemm; 0 = bħalissa qed tiskennja |
| Deskrizzjoni | Użat biex tikseb il-bandiera tal-iskan |
| Oġġett | Deskrizzjoni |
| Isem tal-Funzjoni | TKL_Reset |
| Parametru tal-Input | — |
| Valur tar-Ritorn | — |
| Deskrizzjoni | Użat biex iġġiegħel lil LIB tesegwixxi azzjoni ta' reset.
*Bnadar użati minn LIB u RAM se jiġu inizjalizzati. *Il-parametri u l-AFIO huma esklużi. |
Deskrizzjoni tal-Funzjonijiet ta' Inizjalizzazzjoni ta' Touch Key Lib
Dawn il-funzjonijiet jinsabu fil main.c. Mhux rakkomandat li timmodifika l-kontenut tagħhom.
| Isem | Funzjoni |
| GPIO_Configuration() | Konfigurazzjonijiet tal-port I/O |
| RTC_Configuration() | Touch keys jitqajmu mill-RTC |
| BFTM_Configuration() | Il-bażijiet tal-ħin tal-librerija tat-touch ewlenin huma implimentati minn BFTM |
| TKL_Configuration() | Touch konfigurazzjonijiet ewlenin |
Mistoqsija tal-Istat Ewlenin
Kif muri hawn taħt, il-programm prinċipali jinkludi touch key example li mhux se jiġi attivat awtomatikament. Biex tattiva din il-funzjoni, immodifika (0) wara #jekk għal (1).
Deskrizzjoni tal-Modalità Sleep
- F'ht32_TouchKey_conf.h, agħżel PowerSave biex tippermetti l-modi sleep.
- Wara li l-modi ta 'rqad ikunu ġew attivati, it-tasti touch se jidħlu fl-istat ta' rqad jekk iċ-ċwievet ma esperjenzaw l-ebda kundizzjoni ta 'mess għal ċertu perjodu ta' żmien.
- Funzjoni tal-għadd tal-ħin standby tintuża għall-għadd, il-ħin kurrenti jinkiseb bl-użu ta 'TKL_Get_Standby u l-parametru tal-ħin huwa ssettjat bl-użu ta' TKL_Set_Standby.
- Hemm tliet għażliet tal-modalità sleep.
Modalità Deskrizzjoni USE_SLEEP_MODE Daħħal il-Modalità Sleep USE_DEEP_SLEEP1_MODE Idħol fil-Modalità Deep Sleep1 USE_DEEP_SLEEP2_MODE Idħol fil-Modalità Deep Sleep2 - Kif muri hawn taħt, issettja l-mod ta 'rqad meħtieġ billi tuża "#define" fil-prinċipali file.
Konklużjoni
Dan id-dokument ipprovda struzzjonijiet għat-twaqqif tal-ambjent kollu tal-iżvilupp taċ-ċavetta touch HT32, li jgħin lill-utenti biex jibdew malajr. Barra minn hekk, ir-riżorsi użati mil-librerija, kif ukoll diversi funzjonijiet u parametri, ġew spjegati fid-dettall, li jippermettu proċess ta 'żvilupp aktar faċli.
Materjal ta' Referenza
Għal aktar dettalji, irreferi għall-Holtek websit: www.holtek.com jew ikkonsulta l-Aħjar Soluzzjoni websit: http://www.bestsolution.com.tw/EN/
Verżjonijiet u Informazzjoni dwar il-Modifikazzjoni:
| Data | Awtur | Rilaxx | Deskrizzjoni |
| 2022.03.16 | 谢东霖、梁德浩 | V1.00 | L-ewwel verżjoni |
Ċaħda
L-informazzjoni kollha, trademarks, logos, grafika, vidjows, klipps awdjo, links u oġġetti oħra li jidhru fuq dan web('Informazzjoni') huma għal referenza biss u hija soġġetta għal bidla fi kwalunkwe ħin mingħajr avviż minn qabel u fid-diskrezzjoni ta' Holtek Semiconductor Inc. u l-kumpaniji relatati tagħha (minn hawn 'il quddiem 'Holtek', 'il-kumpanija', 'magħna', ' aħna’ jew ‘tagħna’). Filwaqt li Holtek tagħmel ħilitha biex tiżgura l-eżattezza tal-Informazzjoni dwar dan websit, l-ebda garanzija espressa jew impliċita ma tingħata minn Holtek għall-eżattezza tal-Informazzjoni. Holtek ma ġġorr l-ebda responsabbiltà għal xi żball jew tnixxija.
Holtek mhux se tkun responsabbli għal xi ħsarat (inklużi iżda mhux limitati għal virus tal-kompjuter, problemi tas-sistema jew telf ta' dejta) tkun xi tkun li tirriżulta fl-użu jew b'konnessjoni mal-użu ta' dan. websit minn kwalunkwe parti. Jista' jkun hemm links f'dan il-qasam, li jippermettulek iżżur il- websiti ta’ kumpaniji oħra. Dawn websiti mhumiex ikkontrollati minn Holtek. Holtek ma ġġorr l-ebda responsabbiltà u l-ebda garanzija għal kwalunkwe Informazzjoni murija f'dawn is-siti. Hyperlinks għal oħrajn websiti huma għar-riskju tiegħek.
Limitazzjoni ta' Responsabbiltà
Fl-ebda każ Holtek Limited m'għandha tkun responsabbli lejn xi parti oħra għal kwalunkwe telf jew ħsara tkun xi tkun jew tkun xi tkun ikkawżata direttament jew indirettament b'rabta mal-aċċess tiegħek għal jew l-użu ta' dan. websit, il-kontenut fuqu jew kwalunkwe oġġetti, materjali jew servizzi.
Liġi Governattiva
Iċ-Ċaħda li tinsab fil- webis-sit għandu jkun irregolat minn u interpretat skond il-liġijiet tar-Repubblika taċ-Ċina. L-utenti se jissottomettu għall-ġurisdizzjoni mhux esklussiva tal-qrati tar-Repubblika taċ-Ċina.
Aġġornament ta' Ċaħda
Holtek tirriżerva d-dritt li taġġorna ċ-Ċaħda ta’ Responsabilità fi kwalunkwe ħin b’avviż minn qabel jew mingħajru, il-bidliet kollha huma effettivi immedjatament malli jitqiegħdu fuq il- websit.
Dokumenti / Riżorsi
 |
Holtek HT32 MCU Touch Key Librerija [pdfGwida għall-Utent HT32, MCU Touch Key Library, HT32 MCU Touch Key Library |
