Holtek HT32 MCU Touch Key Library
Panimula
Ang HT32 touch key library na binuo ng Best Solution ay isang library na isinasama sa MCU ang lahat ng touch key na pinagbabatayan ng driver library files. Ang library ay paunang na-configure ang touch-related MCU hardware, at nagbibigay ng intuitive at flexible touch key sensitivity setting, habang isinasama ang mga karaniwang function gaya ng key detection at power-saving sleep mode. Ang paggamit ng HT32 touch key library ay nagpapasimple sa paggamit ng mga function ng MCU touch, na nagbibigay-daan sa mga user na makapagsimula nang mabilis at bawasan ang panahon ng pag-develop. Ilalarawan ng dokumentong ito nang detalyado ang pagsasaayos ng kapaligiran at paggamit ng library.
Environmental Configuration
Kumuha ng HT32 Touch Key Library
Makipag-ugnayan sa FAE ng Best Solution o sumangguni dito website: http://www.bestsolution.com.tw/EN/
O i-download ang library mula sa Holtek website: https://www.holtek.com
Kumuha ng HT32 Firmware Library
Sumangguni sa sumusunod na link upang mabilis na makuha ang firmware library: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Buksan ang link, piliin ang opsyon na Mga Dokumento tulad ng ipinapakita sa Figure 1, kung saan ang pulang kahon ay nagpapahiwatig ng lokasyon ng naka-compress na HT32 files. Tandaan na ang firmware library lang ng bersyon na v022 o mas mataas ang sumusuporta sa HT32 touch key library.
Configuration ng Proyekto ng Keil
- Ang PC ng user ay kailangang magkaroon ng Keil development tool na naka-install.
- I-unzip ang library ng firmware. Ang files ay nakalista tulad ng ipinapakita sa Figure 2. Mag-click sa Holtek.HT32_DFP.latest upang i-install ito, pagkatapos ay lalabas ang screen ng pagkumpleto ng pag-install, tulad ng ipinapakita sa Figure 3.
- I-unzip ang HT32 touch key library na may kasamang dalawang folder, halample at library.
- Kopyahin ang example at library folder sa HT32_STD_xxxxx_FWLib_v022_XXXX folder.
- Ipatupad ..\example\TouchKey\TouchKey_LIB\_CreateProject.bat (Larawan 6).
- Ang isang interface, tulad ng ipinapakita sa Figure 7, ay lilitaw. Ipasok ang numero na naaayon sa IDE ng user, pagkatapos ay lalabas ang isang “*” sign bago ang napiling IDE, tulad ng ipinapakita sa Figure 8. I-input ang “N” para pumunta sa susunod na hakbang.
- Tulad ng ipinapakita sa ibaba, ipasok ang "*" upang lumikha ng mga proyekto para sa lahat ng mga uri ng IC o ipasok ang pangalan ng IC upang lumikha ng isang proyekto para sa napiling IC.
- Pagkatapos tapusin ang mga hakbang 1~7, tulad ng ipinapakita sa Figure 11, piliin ang gustong IC project gaya ng Project_54xxx.uvprojx mula sa ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\ path.
Tandaan na tanging ang MCU na may pinakamalaking mapagkukunan sa bawat serye ang ginagamit upang likhain ang proyekto. Para kay example, para magamit ang HT32F54231 user ay dapat piliin ang HT32F54241 project.
Mga pagsasaalang-alang
Dahil maaaring pumasok ang touch key program sa sleep state, kinakailangan na itakda ang proyekto sa power on reset, kung hindi, hindi ito magiging available para sa programming. Ang mga hakbang sa pagtatakda ay ang mga sumusunod.
- Hakbang 1: I-click ang button sa Keil5 tool menu, tulad ng ipinapakita sa ibaba.
- Hakbang 2: Piliin ang Debug–> Mga Setting.
- Hakbang 3: Piliin ang "sa ilalim ng I-reset" sa field na Connect.
Library Files Paglalarawan
Mga Mapagkukunan na Ginamit sa Aklatan
| Proyekto ng Keil | Magagamit na IC | ROM/RAM Mga mapagkukunan | Ginamit na IP | Max. Bilang ng mga Susi |
| HT32F54241 | HT32F54241 HT32F54231 | 7148B/2256B | Pindutin ang key
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140B/2528B | Pindutin ang key na BFTM0
RTC |
28 |
- Ang RTC ay ginagamit para gisingin ang MCU mula sa sleep state at ginagamit bilang time base para sa pagpoproseso ng sleep state.
- Kapag na-load ang program sa IC, tutukuyin ng Keil kung nalampasan na ang laki ng ROM o RAM.
- Para sa partikular na paggamit ng mga mapagkukunan, sumangguni sa aktwal na bersyon ng library.
Kapaligiran at File Paglalarawan
Ang HT32 touch key library ay matatagpuan sa sumusunod na landas. ..\halample\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx project (Figure15). Matapos mabuksan ang proyekto ng HT32 touch key library, ang pangunahing screen ay ipinapakita bilang Figure 16.
Ang nauugnay files ay inilarawan bilang mga sumusunod, kabilang dito ang ht32_TouchKey_conf.h at system_ht32f5xxxx_09.c files, kasama sa Configuration Wizard. Tingnan ang Larawan 17.
| File Pangalan | Paglalarawan |
| pangunahing.c | Pangunahing programa ng proyekto file |
| ht32f5xxxx_01_it.c | Makagambala sa pangunahing programa file |
| ht32_TouchKey_Lib_Mx_Keil.lib | Pindutin ang control library file |
| *ht32_TouchKey_conf.h | Pindutin ang control parameter file |
| ht32_TouchKey.h | Depinisyon ng panlabas na deklarasyon file |
| ht32_TouchKey_BSconf.h | Pinagbabatayan ng pangunahing parameter file (hindi inirerekomenda na baguhin) |
| ht32_board_config.h | Depinisyon ng hardware file (hindi inirerekomenda na baguhin) |
| *system_ht32f5xxxx_09.c | Pinagmulan ng orasan at parameter ng orasan ng system file |
Mga Parameter ng Configuration Wizard
- ht32_TouchKey_conf.h Mga parameter ng Configuration Wizard:
Pangalan Function PowerSave I-activate ang default na sleep procedure na tinukoy sa main.c TKL_HighSensitive Setting ng touch sensitivity: mataas o mababang sensitivity; default sa mataas na sensitivity pagkatapos paganahin TKL_keyDebounce Setting ng oras ng key debounce TKL_RefCalTime Oras ng pagkakalibrate. Kung mas maikli ang oras, mas magiging epektibo ito sa paglaban sa panghihimasok sa kapaligiran, gayunpaman, magreresulta ito sa mas mababang mga pangunahing sensitibo. TKL_MaxOnHoldTime Ang maximum na oras na pinindot ang key. Awtomatikong ilalabas ang susi pagkatapos na pinindot ng n segundo. KEYn_EN Paganahin o huwag paganahin ang KEYn KeynThreshold KEYn na halaga ng threshold. Kung mas maliit ang halaga, mas magiging sensitibo ang susi. - system_ht32f5xxxx_09.c Mga parameter ng Configuration Wizard:
Pangalan Function Paganahin ang High Speed External Crystal Oscillator – HSE Paganahin o huwag paganahin ang HSE (external high speed oscillator) Paganahin ang Low Speed External Crystal Oscillator – LSE Paganahin o huwag paganahin ang LSE (external low speed oscillator) Paganahin ang PLL Paganahin o huwag paganahin ang PLL Pinagmulan ng PLL Clock Piliin ang pinagmulan ng orasan para sa PLL SystemCoreClockConfiguration (CK_AHB) Piliin ang pinagmulan ng orasan para sa system na CK_AHB
Paglalarawan ng Touch Key Lib Interface Function
Paglalarawan ng Get Functions
| item | Paglalarawan |
| Pangalan ng Function | TKL_Get_Standby |
| Parameter ng Input | — |
| Ibalik ang Halaga | Nagbibilang ng halaga (500~60000) |
| Paglalarawan | Ginagamit para makuha ang count-down counter value |
| item | Paglalarawan |
| Pangalan ng Function | TKL_Get_KeyRCCValue |
| Parameter ng Input | Key value (0 ~ max. key value), frequency (0, 1) |
| Ibalik ang Halaga | Halaga ng kapasidad (0~1023) |
| Paglalarawan | Ginagamit upang makuha ang halaga ng kapasidad ng tinukoy na susi |
| item | Paglalarawan |
| Pangalan ng Function | TKL_GetKeyRef |
| Parameter ng Input | Key value (0 ~ max. key value) |
| Ibalik ang Halaga | Halaga ng sanggunian (0~65535) |
| Paglalarawan | Ginagamit upang makuha ang reference na halaga ng tinukoy na key |
| item | Paglalarawan |
| Pangalan ng Function | TKL_GetKeyThreshold |
| Parameter ng Input | Key value (0 ~ max. key value) |
| Ibalik ang Halaga | Halaga ng threshold (0~255) |
| Paglalarawan | Ginagamit upang makuha ang halaga ng threshold ng tinukoy na key |
| item | Paglalarawan |
| Pangalan ng Function | TKL_Get_AllKeyState |
| Parameter ng Input | — |
| Ibalik ang Halaga | Key status (32-bit)
Ang BITn ay nangangahulugang KEYn state Bit0 = 1 ay nangangahulugan na ang KEY0 ay pinindot, Bit0 = 0 ay nangangahulugan na ang KEY0 ay hindi pinindot |
| Paglalarawan | Ginagamit upang makuha ang lahat ng pangunahing estado |
Paglalarawan ng Set Functions
| item | Paglalarawan |
| Pangalan ng Function | TKL_Set_KeyThreshold |
| Parameter ng Input | Key value (0 ~ max. key value), threshold value (10~127) |
| Ibalik ang Halaga | — |
| Paglalarawan | Ginagamit upang itakda ang halaga ng threshold ng tinukoy na key |
| item | Paglalarawan |
| Pangalan ng Function | TKL_Set_Standby |
| Parameter ng Input | Oras ng pagtulog (500~60000) |
| Ibalik ang Halaga | — |
| Paglalarawan | Ginagamit para itakda ang count-down counter (hindi inirerekomenda na gamitin ang function na ito) |
Paglalarawan ng State and Command Functions
| item | Paglalarawan |
| Pangalan ng Function | TKL_Is_Time |
| Parameter ng Input | Preset na pare-pareho (kT2mS, kT4mS…kT2048mS) |
| Ibalik ang Halaga | — |
| Paglalarawan | Time flag para sa sanggunian ng user.
Sa sumusunod na example, ang program ay pumapasok sa function tuwing 2ms. |
| item | Paglalarawan |
| Pangalan ng Function | TKL_Is_AnyKeyPress |
| Parameter ng Input | — |
| Ibalik ang Halaga | 1 = isa o higit pang key ang na-trigger; 0 = walang key na na-trigger |
| Paglalarawan | Ginagamit para makuha ang key press flag |
| item | Paglalarawan |
| Pangalan ng Function | TKL_Is_KeyPress |
| Parameter ng Input | Key value (0 ~ max. key value) |
| Ibalik ang Halaga | 1 = key ay na-trigger; 0 = hindi pa na-trigger ang key |
| Paglalarawan | Ginagamit upang makuha ang bandila ng estado ng tinukoy na susi |
| item | Paglalarawan |
| Pangalan ng Function | TKL_Ay_Active |
| Parameter ng Input | — |
| Ibalik ang Halaga | 1 = Ang pagsisimula ng LIB ay tapos na; 0 = LIB initialization ay hindi pa tapos |
| Paglalarawan | Ginamit para makuha ang LIB initialization state flag |
| item | Paglalarawan |
| Pangalan ng Function | TKL_Is_Standby |
| Parameter ng Input | — |
| Ibalik ang Halaga | 1 = pinapayagang pumasok sa estado ng pagtulog; 0 = hindi pinapayagang pumasok sa sleep state |
| Paglalarawan | Ginagamit upang makuha ang flag ng estado ng pagtulog.
*Kapag ibinalik ang value na 0, ang pagpasok sa status ng sleep ay maaaring magresulta sa hindi inaasahang estado. |
| item | Paglalarawan |
| Pangalan ng Function | TKL_Is_KeyScanCycle |
| Parameter ng Input | — |
| Ibalik ang Halaga | 1 = tapos na ang pag-scan; 0 = kasalukuyang nag-scan |
| Paglalarawan | Ginagamit para makuha ang scan flag |
| item | Paglalarawan |
| Pangalan ng Function | TKL_Reset |
| Parameter ng Input | — |
| Ibalik ang Halaga | — |
| Paglalarawan | Ginagamit upang pilitin ang LIB na magsagawa ng isang aksyon sa pag-reset.
*Ang mga flag na ginamit ng LIB at RAM ay pasisimulan. *Ang mga parameter at AFIO ay hindi kasama. |
Paglalarawan ng Touch Key Lib Initialisation Function
Ang mga function na ito ay matatagpuan sa main.c. Hindi inirerekomenda na baguhin ang kanilang mga nilalaman.
| Pangalan | Function |
| GPIO_Configuration() | Mga pagsasaayos ng I/O port |
| RTC_Configuration() | Ang mga touch key ay ginigising ng RTC |
| BFTM_Configuration() | Ang mga touch key library time base ay ipinatupad ng BFTM |
| TKL_Configuration() | Pindutin ang mga key configuration |
Pangunahing Query ng Estado
Gaya ng ipinapakita sa ibaba, ang pangunahing programa ay may kasamang touch key example na hindi maa-activate bilang default. Upang isaaktibo ang function na ito, baguhin ang (0) pagkatapos ng #if sa (1).
Paglalarawan ng Sleep Mode
- Sa ht32_TouchKey_conf.h, piliin ang PowerSave upang paganahin ang mga sleep mode.
- Pagkatapos paganahin ang mga sleep mode, papasok ang mga touch key sa sleep state kung ang mga key ay hindi nakaranas ng anumang mga kondisyon ng pagpindot para sa isang tiyak na tagal ng panahon.
- Ang standby time count function ay ginagamit para sa down-counting, ang kasalukuyang oras ay nakuha gamit ang TKL_Get_Standby at ang parameter ng oras ay nakatakda gamit ang TKL_Set_Standby.
- May tatlong opsyon sa sleep mode.
Mode Paglalarawan USE_SLEEP_MODE Ipasok ang Sleep Mode USE_DEEP_SLEEP1_MODE Ipasok ang Deep Sleep1 Mode USE_DEEP_SLEEP2_MODE Ipasok ang Deep Sleep2 Mode - Gaya ng ipinapakita sa ibaba, itakda ang kinakailangang sleep mode gamit ang “#define” sa pangunahing file.
Konklusyon
Ang dokumentong ito ay nagbigay ng mga tagubilin para sa pag-set up ng buong HT32 touch key development environment, na tumutulong sa mga user na makapagsimula nang mabilis. Bilang karagdagan, ang mga mapagkukunan na ginagamit ng library, pati na rin ang iba't ibang mga function at parameter, ay ipinaliwanag nang detalyado, na nagbibigay-daan para sa isang mas madaling proseso ng pag-unlad.
Sangguniang Materyal
Para sa higit pang mga detalye, sumangguni sa Holtek website: www.holtek.com o kumonsulta sa Pinakamahusay na Solusyon website: http://www.bestsolution.com.tw/EN/
Mga Bersyon at Impormasyon sa Pagbabago:
| Petsa | May-akda | Palayain | Paglalarawan |
| 2022.03.16 | 谢东霖、梁德浩 | V1.00 | Unang bersyon |
Disclaimer
Lahat ng impormasyon, trademark, logo, graphics, video, audio clip, link at iba pang item na lumalabas dito website ('Impormasyon') ay para sa sanggunian lamang at maaaring magbago anumang oras nang walang paunang abiso at sa pagpapasya ng Holtek Semiconductor Inc. at mga kaugnay nitong kumpanya (simula dito 'Holtek', 'ang kumpanya', 'us', ' tayo' o 'atin'). Habang sinisikap ni Holtek na tiyakin ang katumpakan ng Impormasyon tungkol dito website, walang malinaw o ipinahiwatig na warranty ang ibinigay ng Holtek sa katumpakan ng Impormasyon. Walang pananagutan ang Holtek para sa anumang pagkakamali o pagtagas.
Hindi mananagot ang Holtek para sa anumang mga pinsala (kabilang ngunit hindi limitado sa virus ng computer, mga problema sa system o pagkawala ng data) anuman ang mangyari sa paggamit o kaugnay ng paggamit nito website ng anumang partido. Maaaring may mga link sa lugar na ito, na nagpapahintulot sa iyo na bisitahin ang webmga site ng iba pang mga kumpanya. Ang mga ito webAng mga site ay hindi kinokontrol ng Holtek. Walang pananagutan at walang garantiya ang Holtek sa anumang impormasyong ipinapakita sa mga naturang site. Mga hyperlink sa iba webang mga site ay nasa iyong sariling peligro.
Limitasyon ng Pananagutan
Sa anumang pagkakataon ay mananagot ang Holtek Limited sa alinmang ibang partido para sa anumang pagkawala o pinsala anuman o anuman ang sanhi nang direkta o hindi direktang may kaugnayan sa iyong pag-access o paggamit nito. website, ang nilalaman nito o anumang mga produkto, materyales o serbisyo.
Batas na Namamahala
Ang Disclaimer na nakapaloob sa webang lugar ay pamamahalaan at bigyang-kahulugan alinsunod sa mga batas ng Republika ng Tsina. Magsusumite ang mga user sa hindi eksklusibong hurisdiksyon ng mga korte ng Republika ng China.
Update ng Disclaimer
Inilalaan ng Holtek ang karapatang i-update ang Disclaimer anumang oras nang may paunang abiso o walang paunang abiso, lahat ng mga pagbabago ay epektibo kaagad sa pag-post sa website.
Mga Dokumento / Mga Mapagkukunan
 |
Holtek HT32 MCU Touch Key Library [pdf] Gabay sa Gumagamit HT32, MCU Touch Key Library, HT32 MCU Touch Key Library |
