Holtek-LOGO

Holtek HT32 MCU snertilyklasafn

Holtek-HT32-MCU-Touch-Key-Library-PRO

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ð.Holtek-HT32-MCU-Touch-Key-Library-1

Keil Project Configuration 

  1. Tölva notandans þarf að hafa Keil þróunartólið uppsett.
  2. 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.Holtek-HT32-MCU-Touch-Key-Library-2
  3. Taktu upp HT32 snertilyklasafnið sem inniheldur tvær möppur, tdample og bókasafn.Holtek-HT32-MCU-Touch-Key-Library-3
  4. Afritaðu fyrrverandiample og bókasafnsmöppur í HT32_STD_xxxxx_FWLib_v022_XXXX möppuna.
  5. Framkvæma ..\example\TouchKey\TouchKey_LIB\_CreateProject.bat (Mynd 6).Holtek-HT32-MCU-Touch-Key-Library-4
  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.Holtek-HT32-MCU-Touch-Key-Library-5
  7. 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.Holtek-HT32-MCU-Touch-Key-Library-6
  8. 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óð.Holtek-HT32-MCU-Touch-Key-Library-7
    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.

  1. Skref 1: Smelltu á hnappinn í Keil5 verkfæravalmyndinni, eins og sýnt er hér að neðan.Holtek-HT32-MCU-Touch-Key-Library-8
  2. Skref 2: Veldu Kembi-> Stillingar.Holtek-HT32-MCU-Touch-Key-Library-9
  3. Skref 3: Veldu „undir Endurstilla“ í Tengjast reitnum.Holtek-HT32-MCU-Touch-Key-Library-10

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
  1. RTC er notað til að vekja MCU úr svefnstöðu og notað sem tímagrunnur fyrir vinnslu svefnstöðu.
  2. Þegar forritið er hlaðið inn í IC mun Keil ákvarða hvort farið hafi verið yfir stærð ROM eða RAM.
  3. 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.Holtek-HT32-MCU-Touch-Key-Library-11

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

Holtek-HT32-MCU-Touch-Key-Library-12

Stillingar Wizard Parameters

  1. 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.
  2. 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.Holtek-HT32-MCU-Touch-Key-Library-13

 

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).Holtek-HT32-MCU-Touch-Key-Library-14

Sleep Mode Lýsing

  1. Í ht32_TouchKey_conf.h, veldu PowerSave til að virkja svefnstillingarnar.Holtek-HT32-MCU-Touch-Key-Library-15
  2. Eftir að svefnstillingar hafa verið virkjaðar fara snertihnapparnir í svefnstöðu ef takkarnir hafa ekki upplifað nein snertiskilyrði í ákveðinn tíma.
  3. 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.
  4. Þ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
  5. Eins og sýnt er hér að neðan, stilltu nauðsynlega svefnstillingu með því að nota „#define“ í aðalatriðum file.Holtek-HT32-MCU-Touch-Key-Library-16

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

Heimildir

Skildu eftir athugasemd

Netfangið þitt verður ekki birt. Nauðsynlegir reitir eru merktir *