Holtek HT32 MCU snertilyklasafn
Inngangur
HT32 snertilyklasafnið sem er þróað af Best Solution er bókasafn sem fellur inn í MCU allan snertilykilinn sem liggur undir ökumannssafninu files. Bókasafnið hefur forstillt snertitengda MCU vélbúnaðinn og býður upp á leiðandi og sveigjanlegar næmnistillingar fyrir snertilykla, á sama tíma og það samþættir algengar aðgerðir eins og lyklaskynjun og orkusparandi svefnstillingar. Notkun HT32 snertilyklasafnsins einfaldar notkun MCU snertiaðgerðanna, gerir notendum kleift að byrja fljótt og styttir þróunartímann. Þetta skjal mun lýsa ítarlega umhverfisstillingu og notkun bókasafns.
Umhverfisstillingar
Fáðu HT32 Touch Key Library
Hafðu samband við FAE Best Solution eða vísaðu til þess websíða: http://www.bestsolution.com.tw/EN/
Eða hlaðið niður bókasafninu frá Holtekinu websíða: https://www.holtek.com
Fáðu HT32 vélbúnaðarsafn
Skoðaðu eftirfarandi tengil til að fá fljótt vélbúnaðarsafnið: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Opnaðu hlekkinn, veldu Skjöl valkostinn eins og sýnt er á mynd 1, þar sem rauði reiturinn gefur til kynna staðsetningu HT32 þjappaðs files. Athugaðu að aðeins fastbúnaðarsafn útgáfu v022 eða nýrri styður HT32 snertilyklasafnið.
Keil Project Configuration
- Tölva notandans þarf að hafa Keil þróunartólið uppsett.
- Taktu upp vélbúnaðarsafnið. The files eru skráð eins og sýnt er á mynd 2. Smelltu á Holtek.HT32_DFP.latest til að setja það upp, eftir það mun uppsetningarlokunarskjárinn, eins og sýnt er á mynd 3, birtast.
- Taktu upp HT32 snertilyklasafnið sem inniheldur tvær möppur, tdample og bókasafn.
- Afritaðu fyrrverandiample og bókasafnsmöppur í HT32_STD_xxxxx_FWLib_v022_XXXX möppuna.
- Framkvæma ..\example\TouchKey\TouchKey_LIB\_CreateProject.bat (Mynd 6).
- Viðmót, eins og sýnt er á mynd 7, mun birtast. Sláðu inn númerið sem samsvarar IDE notandans, eftir það mun „*“ tákn birtast á undan valda IDE, eins og sýnt er á mynd 8. Sláðu inn „N“ til að fara í næsta skref.
- Eins og sýnt er hér að neðan skaltu slá inn "*" til að búa til verkefni fyrir allar IC gerðir eða slá inn heiti IC til að búa til verkefni fyrir valda IC.
- Eftir að hafa lokið skrefum 1~7, eins og sýnt er á mynd 11, veldu viðkomandi IC verkefni eins og Project_54xxx.uvprojx úr ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\ slóð.
Athugið að einungis MCU með stærstu auðlindirnar í hverri röð er notaður til að búa til verkefnið. Til dæmisample, til að nota HT32F54231 verða notendur að velja HT32F54241 verkefnið.
Hugleiðingar
Þar sem snertihnappaforritið gæti farið í svefnstöðu, er nauðsynlegt að stilla verkefnið á að kveikja á endurstillingu, annars verður það ekki tiltækt fyrir forritun. Stillingarskrefin eru sem hér segir.
- Skref 1: Smelltu á hnappinn í Keil5 verkfæravalmyndinni, eins og sýnt er hér að neðan.
- Skref 2: Veldu Kembi-> Stillingar.
- Skref 3: Veldu „undir Endurstilla“ í Tengjast reitnum.
Bókasafn Files Lýsing
Bókasafn notaðar auðlindir
Keils verkefnið | Nothæft IC | ROM/RAM Auðlindir | Notaði IP | Hámark Fjöldi lykla |
HT32F54241 | HT32F54241 HT32F54231 | 7148B / 2256B | Snertihnappur
BFTM0 RTC |
24 |
HT32F54253 | HT32F54243 HT32F54253 | 7140B / 2528B | Snertið takkann BFTM0
RTC |
28 |
- RTC er notað til að vekja MCU úr svefnstöðu og notað sem tímagrunnur fyrir vinnslu svefnstöðu.
- Þegar forritið er hlaðið inn í IC mun Keil ákvarða hvort farið hafi verið yfir stærð ROM eða RAM.
- Fyrir sérstaka notkun á tilföngum, vísa til raunverulegrar útgáfu bókasafnsins.
Umhverfi og File Lýsing
HT32 snertilyklasafnið er staðsett á eftirfarandi slóð. ..\fyrrverandiample\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx verkefni (Mynd15). Eftir að HT32 snertilyklasafnsverkefnið er opnað er aðalskjárinn sýndur sem mynd 16.
Viðkomandi files eru lýst sem hér segir, þar á meðal eru ht32_TouchKey_conf.h og system_ht32f5xxxx_09.c files, innifalinn í stillingarhjálpinni. Sjá mynd 17.
File Nafn | Lýsing |
aðal.c | Aðaldagskrá verkefnisins file |
ht32f5xxxx_01_it.c | Rjúfa aðalforrit file |
ht32_TouchKey_Lib_Mx_Keil.lib | Snertistjórnunarsafn file |
*ht32_TouchKey_conf.h | Snertistýringarfæribreyta file |
ht32_TouchKey.h | Skilgreining ytri yfirlýsingar file |
ht32_TouchKey_BSconf.h | Undirliggjandi aðalbreyta file (ekki mælt með því að breyta) |
ht32_board_config.h | Skilgreining vélbúnaðar file (ekki mælt með því að breyta) |
*system_ht32f5xxxx_09.c | Klukkugjafi og færibreytur kerfisklukku file |
Stillingar Wizard Parameters
- ht32_TouchKey_conf.h Stillingar Wizard færibreytur:
Nafn Virka Orkusparnaður Virkjaðu sjálfgefna svefnferlið sem skilgreint er í main.c TKL_High Sensitive Snertinæmisstilling: hátt eða lágt næmi; sjálfgefið í háum næmni eftir að hafa verið virkjaður TKL_keyDebounce Stilling lykla fyrir frákaststíma TKL_RefCalTime Kvörðunartími. Því styttri sem tíminn er, því áhrifaríkari mun hann standast umhverfistruflun, en það mun leiða til lægri lykilviðkvæmni. TKL_MaxOnHoldTime Hámarkstími sem ýtt er á takkann. Lykillinn sleppur sjálfkrafa eftir að hafa verið ýtt á hann í n sekúndur. KEYn_EN Virkja eða slökkva á KEYn KeynThreshold KEYn þröskuldsgildi. Því minna sem gildið er, því næmari verður lykillinn. - system_ht32f5xxxx_09.c Stillingar Wizard færibreytur:
Nafn Virka Virkjaðu háhraða ytri kristalsveiflu – HSE Virkja eða slökkva á HSE (ytri háhraða oscillator) Virkjaðu lághraða ytri kristalsveiflu – LSE Virkja eða slökkva á LSE (ytri lághraða oscillator) Virkja PLL Virkja eða slökkva á PLL PLL klukka uppspretta Veldu klukkugjafa fyrir PLL SystemCoreClockConfiguration (CK_AHB) Veldu klukkugjafa fyrir kerfið CK_AHB
Lýsing á aðgerðum Touch Key Lib tengi
Lýsing á Get Functions
Atriði | Lýsing |
Heiti aðgerða | TKL_Fá_Biðstöðu |
Innsláttarstærð | — |
Skilaverðmæti | Talningargildi (500~60000) |
Lýsing | Notað til að fá niðurtalningargildi |
Atriði | Lýsing |
Heiti aðgerða | TKL_Get_KeyRCCValue |
Innsláttarstærð | Lykilgildi (0 ~ hámarks lykilgildi), tíðni (0, 1) |
Skilaverðmæti | Rafmagnsgildi (0~1023) |
Lýsing | Notað til að fá rýmd gildi tilgreinds lykils |
Atriði | Lýsing |
Heiti aðgerða | TKL_GetKeyRef |
Innsláttarstærð | Lykilgildi (0 ~ hámarkslykilgildi) |
Skilaverðmæti | Viðmiðunargildi (0~65535) |
Lýsing | Notað til að fá viðmiðunargildi tilgreinds lykils |
Atriði | Lýsing |
Heiti aðgerða | TKL_GetKeyThreshold |
Innsláttarstærð | Lykilgildi (0 ~ hámarkslykilgildi) |
Skilaverðmæti | Þröskuldsgildi (0~255) |
Lýsing | Notað til að fá viðmiðunargildi tilgreinds lykils |
Atriði | Lýsing |
Heiti aðgerða | TKL_Get_AllKeyState |
Innsláttarstærð | — |
Skilaverðmæti | Lykilstaða (32 bita)
BITn stendur fyrir KEYn state Bit0 = 1 þýðir að ýtt er á KEY0, Bit0 = 0 þýðir að ekki er ýtt á KEY0 |
Lýsing | Notað til að fá öll lykilríki |
Lýsing á stilltum aðgerðum
Atriði | Lýsing |
Heiti aðgerða | TKL_Set_KeyThreshold |
Innsláttarstærð | Lykilgildi (0 ~ hámarkslykilgildi), þröskuldsgildi (10~127) |
Skilaverðmæti | — |
Lýsing | Notað til að stilla þröskuldsgildi tilgreinds lykils |
Atriði | Lýsing |
Heiti aðgerða | TKL_Set_Biðstaða |
Innsláttarstærð | Svefntími (500~60000) |
Skilaverðmæti | — |
Lýsing | Notað til að stilla niðurteljarann (ekki mælt með því að nota þessa aðgerð) |
Lýsing á ríkis- og stjórnunaraðgerðum
Atriði | Lýsing |
Heiti aðgerða | TKL_Is_Time |
Innsláttarstærð | Forstilltur fasti (kT2mS, kT4mS…kT2048mS) |
Skilaverðmæti | — |
Lýsing | Tímafáni til notendaviðmiðunar.
Í eftirfarandi frvample, forritið fer inn í aðgerðina á 2ms fresti. |
Atriði | Lýsing |
Heiti aðgerða | TKL_Is_AnyKeyPress |
Innsláttarstærð | — |
Skilaverðmæti | 1 = einn eða fleiri lyklar hafa verið ræstir; 0 = enginn lykill hefur verið ræstur |
Lýsing | Notað til að fá lyklaþrýstifánann |
Atriði | Lýsing |
Heiti aðgerða | TKL_Is_KeyPress |
Innsláttarstærð | Lykilgildi (0 ~ hámarkslykilgildi) |
Skilaverðmæti | 1 = lykill hefur verið ræstur; 0 = lykill hefur ekki verið ræstur |
Lýsing | Notað til að fá ríkisfánann tilgreinds lykils |
Atriði | Lýsing |
Heiti aðgerða | TKL_Er_virkt |
Innsláttarstærð | — |
Skilaverðmæti | 1 = LIB frumstillingu er lokið; 0 = LIB frumstillingu er ekki lokið |
Lýsing | Notað til að fá LIB upphafsstöðu fána |
Atriði | Lýsing |
Heiti aðgerða | TKL_Is_Biðstaða |
Innsláttarstærð | — |
Skilaverðmæti | 1 = leyfilegt að fara í svefnstöðu; 0 = ekki leyfilegt að fara í svefnstöðu |
Lýsing | Notað til að fá svefnstöðufánann.
*Þegar gildinu 0 er skilað, þá getur það leitt til óvænts ástands að fara í svefnstöðu. |
Atriði | Lýsing |
Heiti aðgerða | TKL_Is_KeyScanCycle |
Innsláttarstærð | — |
Skilaverðmæti | 1 = skönnun er lokið; 0 = er að skanna |
Lýsing | Notað til að fá skannafánann |
Atriði | Lýsing |
Heiti aðgerða | TKL_Endurstilla |
Innsláttarstærð | — |
Skilaverðmæti | — |
Lýsing | Notað til að neyða LIB til að framkvæma endurstillingaraðgerð.
*Fánar notaðir af LIB og vinnsluminni verða frumstilltir. *Fjarbreytur og AFIO eru undanskilin. |
Lýsing á frumstillingaraðgerðum Touch Key Lib
Þessar aðgerðir eru staðsettar í main.c. Ekki er mælt með því að breyta innihaldi þeirra.
Nafn | Virka |
GPIO_Configuration() | Stillingar I/O tengi |
RTC_Configuration() | Snertilyklar eru vaknir af RTC |
BFTM_Configuration() | Tímagrunnar fyrir snertilyklasafn eru útfærðir af BFTM |
TKL_Configuration() | Stillingar snertilykla |
Fyrirspurn um lykilríki
Eins og sýnt er hér að neðan inniheldur aðalforritið snertilykil tdample sem verður ekki virkjað sjálfgefið. Til að virkja þessa aðgerð, breyttu (0) eftir #ef í (1).
Sleep Mode Lýsing
- Í ht32_TouchKey_conf.h, veldu PowerSave til að virkja svefnstillingarnar.
- Eftir að svefnstillingar hafa verið virkjaðar fara snertihnapparnir í svefnstöðu ef takkarnir hafa ekki upplifað nein snertiskilyrði í ákveðinn tíma.
- Tímatalningaraðgerð í biðstöðu er notuð til að telja niður, núverandi tími er fenginn með TKL_Get_Standby og tímabreytan er stillt með TKL_Set_Standby.
- Það eru þrír valkostir fyrir svefnstillingu.
Mode Lýsing NOTA_SLEEP_MODE Farðu í svefnham USE_DEEP_SLEEP1_MODE Farðu í djúpsvefn1 ham USE_DEEP_SLEEP2_MODE Farðu í djúpsvefn2 ham - Eins og sýnt er hér að neðan, stilltu nauðsynlega svefnstillingu með því að nota „#define“ í aðalatriðum file.
Niðurstaða
Þetta skjal hefur veitt leiðbeiningar um uppsetningu á öllu þróunarumhverfi HT32 snertilykla, sem hjálpar notendum að komast fljótt af stað. Að auki hefur verið útskýrt ítarlega auðlindirnar sem bókasafnið notar, svo og ýmsar aðgerðir og færibreytur, sem gerir þróunarferli auðveldara.
Viðmiðunarefni
Fyrir frekari upplýsingar, sjá Holtek websíða: www.holtek.com eða ráðfærðu þig við bestu lausnina websíða: http://www.bestsolution.com.tw/EN/
Upplýsingar um útgáfur og breytingar:
Dagsetning | Höfundur | Gefa út | Lýsing |
2022.03.16 | 谢东霖、梁德浩 | V1.00 | Fyrsta útgáfa |
Fyrirvari
Allar upplýsingar, vörumerki, lógó, grafík, myndbönd, hljóðinnskot, tengla og önnur atriði sem birtast á þessu websíða ('Upplýsingar') eru eingöngu til viðmiðunar og geta breyst hvenær sem er án fyrirvara og að eigin vali Holtek Semiconductor Inc. og tengdra fyrirtækja þess (hér á eftir 'Holtek', 'fyrirtækið', 'okkur', ' við' eða 'okkar'). Þó Holtek reyni að tryggja nákvæmni upplýsinganna um þetta websíðu er engin bein eða óbein ábyrgð veitt af Holtek á nákvæmni upplýsinganna. Holtek ber enga ábyrgð á rangfærslum eða leka.
Holtek er ekki ábyrgt fyrir tjóni (þar á meðal en ekki takmarkað við tölvuvírus, kerfisvandamál eða tap á gögnum) af neinu tagi sem verður við notkun eða í tengslum við notkun þessa websíða af hvaða aðila sem er. Það kunna að vera tenglar á þessu svæði sem gera þér kleift að heimsækja websíður annarra fyrirtækja. Þessar websíður eru ekki undir stjórn Holtek. Holtek ber enga ábyrgð og enga ábyrgð á neinum upplýsingum sem birtar eru á slíkum síðum. Tenglar á annað websíður eru á eigin ábyrgð.
Takmörkun ábyrgðar
Holtek Limited skal í engu tilviki vera ábyrgt gagnvart öðrum aðila vegna taps eða tjóns af neinu tagi eða hvernig sem það verður, beint eða óbeint í tengslum við aðgang þinn að eða notkun þessa. websíðuna, innihaldið á henni eða hvers kyns vörur, efni eða þjónustu.
Stjórnarlög
Fyrirvari sem er að finna í websíða skal stjórnast af og túlka í samræmi við lög lýðveldisins Kína. Notendur munu lúta lögsögu dómstóla Lýðveldisins Kína sem ekki er einkarétt.
Uppfærsla á fyrirvari
Holtek áskilur sér rétt til að uppfæra fyrirvarana hvenær sem er með eða án fyrirvara, allar breytingar taka gildi strax við birtingu á websíða.
Skjöl / auðlindir
![]() |
Holtek HT32 MCU snertilyklasafn [pdfNotendahandbók HT32, MCU Touch Key Library, HT32 MCU Touch Key Library |