Holtek HT32 MCU Touch Key Library
Pasiuna
Ang HT32 touch key library nga gihimo sa Best Solution usa ka librarya nga nag-integrate sa MCU sa tanang touch key nga nagpahiping driver library. files. Ang librarya nag-pre-configure na sa touch-related nga MCU hardware, ug naghatag ug intuitive ug flexible touch key sensitivity settings, samtang nag-integrate sa komon nga mga function sama sa key detection ug power-saving sleep modes. Ang paggamit sa HT32 touch key library nagpasimple sa paggamit sa MCU touch functions, nga nagtugot sa mga tiggamit sa pagsugod dayon ug pagkunhod sa panahon sa pag-uswag. Kini nga dokumento maghulagway sa detalye sa environmental configuration ug paggamit sa library.
Konfigurasyon sa Kalikopan
Pagkuha og HT32 Touch Key Library
Kontaka ang FAE sa Best Solution o tan-awa kini website: http://www.bestsolution.com.tw/EN/
O i-download ang librarya gikan sa Holtek website: https://www.holtek.com
Pagkuha HT32 Firmware Library
Tan-awa ang mosunud nga link aron makuha dayon ang librarya sa firmware: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Ablihi ang link, pilia ang opsyon sa Mga Dokumento sama sa gipakita sa Figure 1, diin ang pula nga kahon nagpakita sa nahimutangan sa HT32 compressed files. Timan-i nga ang firmware library lang sa bersyon nga v022 o labaw pa ang nagsuporta sa HT32 touch key library.
Pag-configure sa Proyekto sa Keil
- Ang PC sa user kinahanglan nga adunay Keil development tool nga ma-install.
- Unzip ang firmware library. Ang files gilista ingon sa gipakita sa Figure 2. Pag-klik sa Holtek.HT32_DFP.latest aron ma-install kini, pagkahuman ang screen sa pagkompleto sa pag-install, ingon sa gipakita sa Figure 3, makita.
- Unzip ang HT32 touch key library nga naglakip sa duha ka folder, example ug library.
- Kopyaha ang example ug librarya nga mga folder sa HT32_STD_xxxxx_FWLib_v022_XXXX folder.
- Ipatuman ..\example\TouchKey\TouchKey_LIB\_CreateProject.bat (Figure 6).
- Usa ka interface, sama sa gipakita sa Figure 7, makita. I-input ang numero nga katumbas sa IDE sa user, pagkahuman usa ka timaan nga "*" ang makita sa wala pa ang gipili nga IDE, ingon sa gipakita sa Figure 8. I-input ang "N" aron moadto sa sunod nga lakang.
- Sama sa gipakita sa ubos, i-input ang “*” aron makamugna og mga proyekto para sa tanang matang sa IC o i-input ang ngalan sa IC aron makahimo og proyekto para sa pinili nga IC.
- Human mahuman ang mga lakang 1~7, ingon sa gipakita sa Figure 11, pilia ang gusto nga proyekto sa IC sama sa Project_54xxx.uvprojx gikan sa ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\ nga dalan.
Nota nga ang MCU ra nga adunay labing daghang mga kapanguhaan sa matag serye ang gigamit sa paghimo sa proyekto. Kay example, sa paggamit sa HT32F54231 tiggamit kinahanglan nga mopili sa HT32F54241 proyekto.
Mga konsiderasyon
Ingon nga ang touch key nga programa mahimong mosulod sa kahimtang sa pagkatulog, gikinahanglan nga itakda ang proyekto sa gahum sa pag-reset, kung dili kini magamit alang sa pagprograma. Ang mga lakang sa pag-set mao ang mosunod.
- Lakang 1: I-klik ang buton sa Keil5 tool menu, ingon sa gipakita sa ubos.
- Lakang 2: Pilia ang Debug-> Mga Setting.
- Lakang 3: Pagpili "ubos sa Reset" sa Connect field.
Library Files Deskripsyon
Library nga Gigamit nga mga Kapanguhaan
| Proyekto sa Keil | Magamit nga IC | ROM/RAM Mga kapanguhaan | Gigamit nga IP | Max. Gidaghanon sa mga Yawe |
| HT32F54241 | HT32F54241 HT32F54231 | 7148B / 2256B | Paghikap yawe
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140B / 2528B | Paghikap yawe BFTM0
RTC |
28 |
- Ang RTC gigamit aron pukawon ang MCU gikan sa kahimtang sa pagkatulog ug gigamit isip time base sa pagproseso sa estado sa pagkatulog.
- Kung ang programa gikarga sa IC, ang Keil ang magtino kung ang gidak-on sa ROM o RAM nalapas na.
- Alang sa piho nga paggamit sa mga kapanguhaan, tan-awa ang aktuwal nga bersyon sa librarya.
Kalibutan ug File Deskripsyon
Ang HT32 touch key library nahimutang sa mosunod nga dalan. ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx nga proyekto (Figure15). Human maablihan ang proyekto sa HT32 touch key library, ang main screen gipakita sa Figure 16.
Ang may kalabutan files gihulagway ingon sa mosunod, lakip niini ang ht32_TouchKey_conf.h ug system_ht32f5xxxx_09.c files, gilakip sa Configuration Wizard. Tan-awa ang Figure 17.
| File Ngalan | Deskripsyon |
| panguna.c | Panguna nga programa sa proyekto file |
| ht32f5xxxx_01_it.c | Pagbalda sa panguna nga programa file |
| ht32_TouchKey_Lib_Mx_Keil.lib | Touch control library file |
| *ht32_TouchKey_conf.h | Paghikap control parameter file |
| ht32_TouchKey.h | Eksternal nga deklarasyon nga kahulugan file |
| ht32_TouchKey_BSconf.h | Nag-una nga parameter file (dili girekomenda nga usbon) |
| ht32_board_config.h | Depinisyon sa hardware file (dili girekomenda nga usbon) |
| *system_ht32f5xxxx_09.c | Tinubdan sa orasan ug parameter sa orasan sa sistema file |
Mga Parameter sa Configuration Wizard
- ht32_TouchKey_conf.h Mga parametro sa Configuration Wizard:
Ngalan Kalihokan PowerSave I-aktibo ang default nga pamaagi sa pagkatulog nga gipasabut sa main.c TKL_HighSensitive Setting sa pagkasensitibo sa paghikap: taas o ubos nga pagkasensitibo; default sa taas nga pagkasensitibo human ma-enable TKL_keyDebounce Key setting sa oras sa pag-debounce TKL_RefCalTime Panahon sa pagkakalibrate. Ang mas mubo nga panahon, mas epektibo kini sa pagbatok sa pagpanghilabot sa kalikopan, apan kini moresulta sa mas ubos nga yawe nga pagkasensitibo. TKL_MaxOnHoldTime Ang labing taas nga oras nga ang yawe gipugos. Awtomatiko nga gipagawas ang yawe pagkahuman napugos sa n segundo. KEYn_EN I-enable o i-disable ang KEYn KeynThreshold KEYn threshold nga bili. Kon mas gamay ang bili, mas sensitibo ang yawe. - system_ht32f5xxxx_09.c Mga parametro sa Configuration Wizard:
Ngalan Kalihokan I-enable ang High Speed External Crystal Oscillator - HSE I-enable o i-disable ang HSE (external high speed oscillator) I-enable ang Low Speed External Crystal Oscillator - LSE I-enable o i-disable ang LSE (external low speed oscillator) I-enable ang PLL I-enable o i-disable ang PLL Tinubdan sa Orasan sa PLL Pilia ang tinubdan sa orasan para sa PLL SystemCoreClockConfiguration (CK_AHB) Pilia ang tinubdan sa orasan para sa sistema CK_AHB
Deskripsyon sa Touch Key Lib Interface Functions
Deskripsyon sa Get Functions
| butang | Deskripsyon |
| Ngalan sa Function | TKL_Get_Standby |
| Parameter sa Input | — |
| Ibalik nga Bili | Pag-ihap sa bili (500~60000) |
| Deskripsyon | Gigamit aron makuha ang count-down counter value |
| butang | Deskripsyon |
| Ngalan sa Function | TKL_Get_KeyRCCCValue |
| Parameter sa Input | Key value (0 ~ max. key value), frequency (0, 1) |
| Ibalik nga Bili | Bili sa kapasidad (0~1023) |
| Deskripsyon | Gigamit aron makuha ang kantidad sa kapasidad sa gitakda nga yawe |
| butang | Deskripsyon |
| Ngalan sa Function | TKL_GetKeyRef |
| Parameter sa Input | Key value (0 ~ max. key value) |
| Ibalik nga Bili | Bili sa pakisayran (0~65535) |
| Deskripsyon | Gigamit aron makuha ang reference value sa gipiho nga yawe |
| butang | Deskripsyon |
| Ngalan sa Function | TKL_GetKeyThreshold |
| Parameter sa Input | Key value (0 ~ max. key value) |
| Ibalik nga Bili | Bili sa sukaranan (0~255) |
| Deskripsyon | Gigamit aron makuha ang kantidad sa threshold sa gitakda nga yawe |
| butang | Deskripsyon |
| Ngalan sa Function | TKL_Get_AllKeyState |
| Parameter sa Input | — |
| Ibalik nga Bili | Panguna nga kahimtang (32-bit)
Ang BITn nagpasabot sa KEYn nga estado Ang Bit0 = 1 nagpasabot nga ang KEY0 gipugos, ang Bit0 = 0 nagpasabot nga ang KEY0 wala gipugos |
| Deskripsyon | Gigamit aron makuha ang tanan nga hinungdanon nga estado |
Deskripsyon sa Set Functions
| butang | Deskripsyon |
| Ngalan sa Function | TKL_Set_KeyThreshold |
| Parameter sa Input | Key value (0 ~ max. key value), threshold value (10~127) |
| Ibalik nga Bili | — |
| Deskripsyon | Gigamit sa pagtakda sa threshold value sa gipiho nga yawe |
| butang | Deskripsyon |
| Ngalan sa Function | TKL_Set_Standby |
| Parameter sa Input | Oras sa pagkatulog (500~60000) |
| Ibalik nga Bili | — |
| Deskripsyon | Gigamit aron itakda ang count-down counter (dili girekomenda nga gamiton kini nga function) |
Deskripsyon sa State ug Command Functions
| butang | Deskripsyon |
| Ngalan sa Function | TKL_Is_Time |
| Parameter sa Input | Preset nga makanunayon (kT2mS, kT4mS…kT2048mS) |
| Ibalik nga Bili | — |
| Deskripsyon | Time flag para sa user reference.
Sa mosunod nga example, ang programa mosulod sa function matag 2ms. |
| butang | Deskripsyon |
| Ngalan sa Function | TKL_Is_AnyKeyPress |
| Parameter sa Input | — |
| Ibalik nga Bili | 1 = usa o daghan pa nga yawe ang na-trigger; 0 = walay yawe nga na-trigger |
| Deskripsyon | Gigamit aron makuha ang key press nga bandila |
| butang | Deskripsyon |
| Ngalan sa Function | TKL_Is_KeyPress |
| Parameter sa Input | Key value (0 ~ max. key value) |
| Ibalik nga Bili | 1 = yawe na-triggered; 0 = yawe wala pa ma-trigger |
| Deskripsyon | Gigamit aron makuha ang bandila sa estado sa gitakda nga yawe |
| butang | Deskripsyon |
| Ngalan sa Function | TKL_Is_Active |
| Parameter sa Input | — |
| Ibalik nga Bili | 1 = LIB initialization nahuman na; 0 = LIB initialization wala pa nahuman |
| Deskripsyon | Gigamit sa pagkuha sa LIB initialization state flag |
| butang | Deskripsyon |
| Ngalan sa Function | TKL_Is_Standby |
| Parameter sa Input | — |
| Ibalik nga Bili | 1 = gitugotan nga mosulod sa kahimtang sa pagkatulog; 0 = dili gitugotan nga mosulod sa kahimtang sa pagkatulog |
| Deskripsyon | Gigamit aron makuha ang bandila sa estado sa pagkatulog.
*Kung ang kantidad nga 0 ibalik, unya ang pagsulod sa kahimtang sa pagkatulog mahimong moresulta sa usa ka wala damha nga kahimtang. |
| butang | Deskripsyon |
| Ngalan sa Function | TKL_Is_KeyScanCycle |
| Parameter sa Input | — |
| Ibalik nga Bili | 1 = nahuman na ang pag-scan; 0 = nag-scan karon |
| Deskripsyon | Gigamit aron makuha ang scan nga bandila |
| butang | Deskripsyon |
| Ngalan sa Function | TKL_Reset |
| Parameter sa Input | — |
| Ibalik nga Bili | — |
| Deskripsyon | Gigamit sa pagpugos sa LIB sa pagpatuman sa usa ka reset nga aksyon.
*Ang mga bandera nga gigamit sa LIB ug RAM pagasugdan. * Ang mga parameter ug AFIO wala iapil. |
Deskripsyon sa Touch Key Lib Initialisation Functions
Kini nga mga gimbuhaton nahimutang sa main.c. Dili girekomenda nga usbon ang ilang sulud.
| Ngalan | Kalihokan |
| GPIO_Configuration() | I/O port configurations |
| RTC_Configuration() | Ang mga yawe sa paghikap gipukaw sa RTC |
| BFTM_Configuration() | Ang touch key library time base gipatuman sa BFTM |
| TKL_Configuration() | Pindota ang yawe nga mga configuration |
Panguna nga Pangutana sa Estado
Sama sa gipakita sa ubos, ang nag-unang programa naglakip sa usa ka touch key example nga dili ma-activate pinaagi sa default. Aron ma-activate kini nga function, usba ang (0) pagkahuman sa #if ngadto sa (1).
Deskripsyon sa Mode sa Pagkatulog
- Sa ht32_TouchKey_conf.h, pilia ang PowerSave aron mahimo ang mga mode sa pagkatulog.
- Pagkahuman nga mahimo ang mga mode sa pagkatulog, ang mga yawe sa paghikap mosulod sa kahimtang sa pagkatulog kung ang mga yawe wala makasinati bisan unsang mga kondisyon sa paghikap sa usa ka piho nga yugto sa panahon.
- Usa ka standby time count function ang gigamit alang sa down-counting, ang kasamtangang oras makuha gamit ang TKL_Get_Standby ug ang time parameter gitakda gamit ang TKL_Set_Standby.
- Adunay tulo ka kapilian sa sleep mode.
Mode Deskripsyon USE_SLEEP_MODE Pagsulud sa Sleep Mode USE_DEEP_SLEEP1_MODE Pagsulod sa Deep Sleep1 Mode USE_DEEP_SLEEP2_MODE Pagsulod sa Deep Sleep2 Mode - Sama sa gipakita sa ubos, ibutang ang gikinahanglan nga sleep mode gamit ang "#define" sa main file.
Panapos
Kini nga dokumento naghatag ug mga instruksyon alang sa pag-set up sa tibuok HT32 touch key development environment, pagtabang sa mga tiggamit nga makasugod dayon. Dugang pa, ang mga kapanguhaan nga gigamit sa librarya, ingon man ang lainlaing mga gimbuhaton ug mga parameter, gipatin-aw sa detalye, nga nagtugot alang sa usa ka dali nga proseso sa pag-uswag.
Reperensya nga Materyal
Alang sa dugang nga mga detalye, tan-awa ang Holtek website: www.holtek.com o konsultaha ang Pinakamaayo nga Solusyon website: http://www.bestsolution.com.tw/EN/
Mga Bersyon ug Impormasyon sa Pagbag-o:
| Petsa | Awtor | Ipagawas | Deskripsyon |
| 2022.03.16 | 谢东霖、梁德浩 | V1.00 | Una nga bersyon |
Disclaimer
Ang tanan nga impormasyon, mga marka sa pamatigayon, mga logo, mga graphic, mga video, mga audio clip, mga link ug uban pang mga butang nga makita niini website ('Information') kay alang lamang sa pakisayran ug mahimong usbon sa bisan unsang oras nga walay una nga pahibalo ug sa pagkabuotan sa Holtek Semiconductor Inc. kami' o 'among'). Samtang ang Holtek naningkamot sa pagsiguro sa katukma sa Impormasyon bahin niini website, walay gipahayag o gipasabot nga garantiya nga gihatag sa Holtek sa katukma sa Impormasyon. Ang Holtek walay responsibilidad sa bisan unsang sayup o pagtulo.
Ang Holtek dili manubag sa bisan unsang mga kadaot (lakip na apan dili limitado sa virus sa kompyuter, mga problema sa sistema o pagkawala sa datos) bisan unsa nga motumaw sa paggamit o may kalabotan sa paggamit niini. website sa bisan unsang partido. Mahimong adunay mga link sa niini nga lugar, nga nagtugot kanimo sa pagbisita sa website sa ubang mga kompanya. Kini webAng mga site dili kontrolado sa Holtek. Ang Holtek walay responsibilidad ug walay garantiya sa bisan unsang Impormasyon nga gipakita sa maong mga site. Mga hyperlink sa uban webAng mga site naa sa imong kaugalingon nga peligro.
Limitasyon sa Tulubagon
Sa bisan unsa nga panghitabo nga ang Holtek Limited mahimong manubag sa bisan unsang ubang partido alang sa bisan unsang pagkawala o kadaot bisan unsa o bisan unsang hinungdan direkta o dili direkta nga may kalabotan sa imong pag-access o paggamit niini. website, ang sulod niini o bisan unsang mga butang, materyales o serbisyo.
Nagamandong Balaod
Ang Disclaimer nga anaa sa website pagadumalaon ug hubaron sumala sa mga balaod sa Republika sa China. Ang mga tiggamit mosumite sa dili eksklusibo nga hurisdiksyon sa mga korte sa Republika sa China.
Pag-update sa Disclaimer
Gireserba sa Holtek ang katungod sa pag-update sa Disclaimer sa bisan unsang oras nga adunay o wala’y una nga pahibalo, ang tanan nga mga pagbag-o epektibo dayon sa pag-post sa website.
Mga Dokumento / Mga Kapanguhaan
 |
Holtek HT32 MCU Touch Key Library [pdf] Giya sa Gumagamit HT32, MCU Touch Key Library, HT32 MCU Touch Key Library |
