Maktaba ya Ufunguo wa Kugusa ya Holtek HT32 MCU

Utangulizi

Maktaba ya ufunguo wa mguso wa HT32 iliyotengenezwa na Suluhisho Bora ni maktaba inayounganisha kwenye MCU vitufe vyote vya kugusa vilivyo msingi wa maktaba ya kiendeshi. files. Maktaba imesanidi awali maunzi ya MCU yanayohusiana na mguso, na hutoa mipangilio angavu na rahisi ya kuhisi vitufe vya mguso, huku ikiunganisha vipengele vya kawaida kama vile ugunduzi wa ufunguo na hali za usingizi za kuokoa nishati. Kutumia maktaba ya HT32 touch key hurahisisha utumiaji wa vitendaji vya kugusa vya MCU, kuruhusu watumiaji kuanza haraka na kupunguza muda wa usanidi. Hati hii itaelezea kwa undani usanidi wa mazingira na matumizi ya maktaba.

Usanidi wa Mazingira

Pata Maktaba ya Ufunguo wa Kugusa wa HT32
Wasiliana na FAE ya Suluhisho Bora au urejelee yake webtovuti: http://www.bestsolution.com.tw/EN/
Au pakua maktaba kutoka kwa Holtek webtovuti: https://www.holtek.com

Pata Maktaba ya Firmware ya HT32
Rejelea kiungo kifuatacho ili kupata kwa haraka maktaba ya programu dhibiti: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Fungua kiungo, chagua chaguo la Hati kama inavyoonyeshwa kwenye Mchoro 1, ambapo kisanduku chekundu kinaonyesha eneo la HT32 iliyobanwa. files. Kumbuka kuwa ni maktaba ya programu dhibiti pekee ya toleo la v022 au toleo jipya zaidi linaloauni maktaba ya ufunguo wa mguso wa HT32.

Usanidi wa Mradi wa Keil 

1. Kompyuta ya mtumiaji inahitaji kusakinishwa zana ya ukuzaji ya Keil.
2. Fungua maktaba ya firmware. The files zimeorodheshwa kama inavyoonyeshwa kwenye Mchoro 2. Bofya kwenye Holtek.HT32_DFP.karibuni ili kusakinisha, baada ya hapo skrini ya kukamilisha usakinishaji, kama inavyoonyeshwa kwenye Mchoro 3, itaonekana.
3. Fungua maktaba ya kitufe cha mguso cha HT32 ambacho kinajumuisha folda mbili, kwa mfanoample na maktaba.
4. Nakili example na folda za maktaba kwenye folda ya HT32_STD_xxxxx_FWLib_v022_XXXX.
5. Tekeleza ..\mfample\TouchKey\TouchKey_LIB\_CreateProject.bat (Mchoro 6).
6. Kiolesura, kama inavyoonyeshwa kwenye Mchoro 7, kitaonekana. Ingiza nambari inayolingana na IDE ya mtumiaji, baada ya hapo ishara "*" itaonekana kabla ya IDE iliyochaguliwa, kama inavyoonyeshwa kwenye Mchoro 8. Ingiza "N" ili kwenda hatua inayofuata.
7. Kama inavyoonyeshwa hapa chini, weka "*" ili kuunda miradi ya aina zote za IC au ingiza jina la IC ili kuunda mradi wa IC iliyochaguliwa.
8. Baada ya kumaliza hatua 1~7, kama inavyoonyeshwa kwenye Mchoro 11, chagua mradi wa IC unaotaka kama vile Project_54xxx.uvprojx kutoka ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\ njia.
   Kumbuka kwamba ni MCU pekee yenye rasilimali kubwa zaidi katika kila mfululizo ndiyo inatumiwa kuunda mradi. Kwa mfanoample, ili kutumia HT32F54231 watumiaji lazima kuchagua mradi HT32F54241.

Mazingatio
Kwa vile programu ya ufunguo wa kugusa inaweza kuingia katika hali ya usingizi, inahitajika kuweka mradi kwa nguvu kwenye upya, vinginevyo hautapatikana kwa programu. Hatua za kuweka ni kama ifuatavyo.

1. Hatua ya 1: Bofya kitufe kwenye menyu ya zana ya Keil5, kama inavyoonyeshwa hapa chini.
2. Hatua ya 2: Chagua Debug–> Mipangilio.
3. Hatua ya 3: Chagua "chini ya Rudisha" katika sehemu ya Unganisha.

Maktaba Files Maelezo

Rasilimali Zinazotumiwa na Maktaba 

Mradi wa Keil	IC inayoweza kutumika	ROM/RAM Rasilimali	Imetumika IP	Max. Idadi ya Funguo
HT32F54241	HT32F54241 HT32F54231	7148B / 2256B	Kitufe cha kugusa BFTM0 RTC	24
HT32F54253	HT32F54243 HT32F54253	7140B / 2528B	Kitufe cha kugusa BFTM0 RTC	28

1. RTC hutumiwa kuamsha MCU kutoka hali ya usingizi na kutumika kama msingi wa wakati wa usindikaji wa hali ya usingizi.
2. Programu inapopakiwa kwenye IC, Keil itaamua ikiwa ROM au ukubwa wa RAM umepitwa.
3. Kwa matumizi mahususi ya rasilimali, rejelea toleo halisi la maktaba.

Mazingira na File Maelezo
Maktaba ya ufunguo wa mguso wa HT32 iko katika njia ifuatayo. ..\mfample\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx mradi (Kielelezo15). Baada ya mradi wa maktaba ya ufunguo wa HT32 kufunguliwa, skrini kuu inaonyeshwa kama Mchoro 16.

Yanayohusika files zimefafanuliwa kama ifuatavyo, kati ya hizo ni ht32_TouchKey_conf.h na system_ht32f5xxxx_09.c files, iliyojumuishwa katika Mchawi wa Usanidi. Tazama Kielelezo 17.

File Jina	Maelezo
kuu.c	Mpango mkuu wa mradi file
ht32f5xxxx_01_it.c	Sitisha programu kuu file
ht32_TouchKey_Lib_Mx_Keil.lib	Maktaba ya udhibiti wa mguso file
*ht32_TouchKey_conf.h	Kigezo cha kudhibiti kugusa file
ht32_TouchKey.h	Ufafanuzi wa tamko la nje file
ht32_TouchKey_BSconf.h	Kigezo kuu cha msingi file (haipendekezwi kurekebisha)
ht32_board_config.h	Ufafanuzi wa vifaa file (haipendekezwi kurekebisha)
*mfumo_ht32f5xxxx_09.c	Chanzo cha saa na kigezo cha saa ya mfumo file

Vigezo vya Mchawi wa Usanidi

1. ht32_TouchKey_conf.h Vigezo vya Mchawi wa Usanidi:
   

   Jina	Kazi
   Hifadhi ya Nguvu	Washa utaratibu chaguomsingi wa kulala uliobainishwa katika main.c
   TKL_Nyenyesikivu	Mpangilio wa unyeti wa kugusa: unyeti wa juu au chini; chaguo-msingi kwa unyeti wa juu baada ya kuwezeshwa
   TKL_keyDebounce	Mpangilio wa wakati wa kutamka muhimu
   TKL_RefCalTime	Wakati wa urekebishaji. Muda mfupi, ufanisi zaidi utakuwa katika kupinga kuingiliwa kwa mazingira, hata hivyo itasababisha hisia za chini za ufunguo.
   TKL_MaxOnHoldTime	Muda wa juu ambao ufunguo unasisitizwa. Kitufe hutolewa kiotomatiki baada ya kushinikizwa kwa sekunde n.
   KEYn_EN	Washa au zima KEYn
   Kizingiti muhimu	thamani ya KEYn. Thamani ndogo, ufunguo utakuwa nyeti zaidi.

2. system_ht32f5xxxx_09.c Vigezo vya Mchawi wa Usanidi:
   

   Jina	Kazi
   Wezesha Oscillator ya Nje ya Kioo cha Kasi ya Juu - HSE	Washa au zima HSE (kiosilata cha kasi ya juu cha nje)
   Wezesha Oscillator ya Nje ya Kioo cha Kasi ya Chini - LSE	Washa au zima LSE (kiosilata cha nje cha kasi ya chini)
   Washa PLL	Washa au uzime PLL
   Chanzo cha Saa ya PLL	Chagua chanzo cha saa cha PLL
   Usanidi wa Saa ya Mfumo (CK_AHB)	Chagua chanzo cha saa cha mfumo CK_AHB

Maelezo ya Kazi za Kiolesura cha Ufunguo wa Kugusa

Maelezo ya Pata Kazi

Kipengee	Maelezo
Jina la Kazi	TKL_Pata_Kusubiri
Pembejeo ya Kuingiza	—
Thamani ya Kurudisha	Thamani ya kuhesabu (500~60000)
Maelezo	Inatumika kupata thamani ya kuhesabia chini

 

Kipengee	Maelezo
Jina la Kazi	TKL_Pata_UfunguoRCCValue
Pembejeo ya Kuingiza	Thamani muhimu (0 ~ max. thamani ya ufunguo), marudio (0, 1)
Thamani ya Kurudisha	Thamani ya uwezo (0~1023)
Maelezo	Inatumika kupata thamani ya uwezo wa ufunguo maalum

 

Kipengee	Maelezo
Jina la Kazi	TKL_GetKeyRef
Pembejeo ya Kuingiza	Thamani muhimu (0 ~ max. thamani muhimu)
Thamani ya Kurudisha	Thamani ya marejeleo (0~65535)
Maelezo	Inatumika kupata thamani ya kumbukumbu ya ufunguo maalum

 

Kipengee	Maelezo
Jina la Kazi	TKL_GetKeyThreshold
Pembejeo ya Kuingiza	Thamani muhimu (0 ~ max. thamani muhimu)
Thamani ya Kurudisha	Thamani ya kiwango cha juu (0~255)
Maelezo	Inatumika kupata thamani ya kizingiti cha ufunguo maalum

 

Kipengee	Maelezo
Jina la Kazi	TKL_Get_AllKeyState
Pembejeo ya Kuingiza	—
Thamani ya Kurudisha	Hali muhimu (32-bit) BITn inawakilisha KEYn hali Bit0 = 1 inamaanisha kuwa KEY0 imebonyezwa, Bit0 = 0 inamaanisha kuwa KEY0 haijashinikizwa.
Maelezo	Inatumika kupata majimbo yote muhimu

Maelezo ya Seti Kazi 

Kipengee	Maelezo
Jina la Kazi	TKL_Set_KeyThreshold
Pembejeo ya Kuingiza	Thamani muhimu (0 ~ max. thamani ya ufunguo), thamani ya kiwango cha juu (10~127)
Thamani ya Kurudisha	—
Maelezo	Inatumika kuweka thamani ya kizingiti cha ufunguo maalum

 

Kipengee	Maelezo
Jina la Kazi	TKL_Weka_Kusubiri
Pembejeo ya Kuingiza	Muda wa kulala (500~60000)
Thamani ya Kurudisha	—
Maelezo	Inatumika kuweka kihesabu kuhesabu chini (haipendekezwi kutumia chaguo hili la kukokotoa)

Maelezo ya Kazi za Jimbo na Amri 

Kipengee	Maelezo
Jina la Kazi	TKL_Ni_Wakati
Pembejeo ya Kuingiza	Seti kila mara (kT2mS, kT4mS...kT2048mS)
Thamani ya Kurudisha	—
Maelezo	Alama ya wakati kwa marejeleo ya mtumiaji. Katika ex ifuatayoampna, programu inaingia kazini kila 2ms.

 

Kipengee	Maelezo
Jina la Kazi	TKL_Is_AnyKeyPress
Pembejeo ya Kuingiza	—
Thamani ya Kurudisha	1 = ufunguo mmoja au zaidi umeanzishwa; 0 = hakuna ufunguo ulioanzishwa
Maelezo	Inatumika kupata alama ya kubonyeza kitufe

 

Kipengee	Maelezo
Jina la Kazi	TKL_Is_KeyPress
Pembejeo ya Kuingiza	Thamani muhimu (0 ~ max. thamani muhimu)
Thamani ya Kurudisha	1 = ufunguo umeanzishwa; 0 = ufunguo haujaanzishwa
Maelezo	Inatumika kupata bendera ya serikali ya ufunguo maalum

 

Kipengee	Maelezo
Jina la Kazi	TKL_Imetumika
Pembejeo ya Kuingiza	—
Thamani ya Kurudisha	1 = Uanzishaji wa LIB umekamilika; 0 = Uanzishaji wa LIB haujakamilika
Maelezo	Inatumika kupata bendera ya hali ya kuanzisha LIB

 

Kipengee	Maelezo
Jina la Kazi	TKL_Ni_Kusubiri
Pembejeo ya Kuingiza	—
Thamani ya Kurudisha	1 = kuruhusiwa kuingia katika hali ya usingizi; 0 = hairuhusiwi kuingia katika hali ya kulala
Maelezo	Inatumika kupata bendera ya hali ya kulala. *Thamani ya 0 inaporudishwa, basi kuingia katika hali ya usingizi kunaweza kusababisha hali isiyotarajiwa.

 

Kipengee	Maelezo
Jina la Kazi	TKL_Is_KeyScanCycle
Pembejeo ya Kuingiza	—
Thamani ya Kurudisha	1 = scan imekamilika; 0 = inachanganua kwa sasa
Maelezo	Inatumika kupata bendera ya skanisho

 

Kipengee	Maelezo
Jina la Kazi	TKL_Weka Upya
Pembejeo ya Kuingiza	—
Thamani ya Kurudisha	—
Maelezo	Inatumika kulazimisha LIB kutekeleza kitendo cha kuweka upya. *Alamisho zinazotumiwa na LIB na RAM zitaanzishwa. *Vigezo na AFIO vimetengwa.

Maelezo ya Majukumu ya Kuanzisha Kiungo cha Kugusa

Kazi hizi ziko katika main.c. Haipendekezi kurekebisha yaliyomo.

Jina	Kazi
GPIO_Configuration()	Mipangilio ya bandari ya I/O
RTC_Configuration()	Vifunguo vya kugusa vinaamshwa na RTC
BFTM_Configuration()	Misingi ya muda ya maktaba ya ufunguo wa kugusa inatekelezwa na BFTM
TKL_Configuration()	Mipangilio ya vitufe vya kugusa

Hoja kuu ya Jimbo
Kama inavyoonyeshwa hapa chini, programu kuu inajumuisha ufunguo wa mguso wa zamaniample ambayo haitaamilishwa kwa chaguo-msingi. Ili kuwezesha chaguo hili la kukokotoa, rekebisha (0) baada ya #kama hadi (1).

Maelezo ya Hali ya Kulala

1. Katika ht32_TouchKey_conf.h, chagua PowerSave ili kuwezesha hali za usingizi.
2. Baada ya njia za usingizi kuwezeshwa, funguo za kugusa zitaingia katika hali ya usingizi ikiwa funguo hazijapata hali yoyote ya kugusa kwa muda fulani.
3. Kitendakazi cha kuhesabu muda wa kusubiri kinatumika kwa kuhesabu chini, muda wa sasa unapatikana kwa kutumia TKL_Get_Standby na kigezo cha muda kinawekwa kwa kutumia TKL_Set_Standby.
4. Kuna chaguzi tatu za hali ya kulala.
   

   Hali	Maelezo
   USE_LALA_MODE	Ingiza Njia ya Kulala
   USE_DEEP_SLEEP1_MODE	Ingiza Hali ya Kulala Kwa Kina1
   USE_DEEP_SLEEP2_MODE	Ingiza Hali ya Kulala Kwa Kina2

5. Kama inavyoonyeshwa hapa chini, weka hali ya kulala inayohitajika kwa kutumia "#define" katika sehemu kuu file.

Hitimisho
Hati hii imetoa maagizo ya kusanidi mazingira yote ya ukuzaji ufunguo wa HT32, kusaidia watumiaji kuanza haraka. Aidha, rasilimali zinazotumiwa na maktaba, pamoja na kazi na vigezo mbalimbali, zimeelezwa kwa undani, na kuruhusu mchakato rahisi wa maendeleo.

Nyenzo za Marejeleo

Kwa maelezo zaidi, rejea Holtek webtovuti: www.holtek.com au wasiliana na Suluhisho Bora webtovuti: http://www.bestsolution.com.tw/EN/

Matoleo na Maelezo ya Marekebisho:

Tarehe	Mwandishi	Kutolewa	Maelezo
2022.03.16	谢东霖、梁德浩	V1.00	Toleo la kwanza

Kanusho

Taarifa zote, alama za biashara, nembo, michoro, video, klipu za sauti, viungo na vitu vingine vinavyoonekana kwenye hii. webtovuti ('Maelezo') ni ya marejeleo pekee na yanaweza kubadilishwa wakati wowote bila taarifa ya awali na kwa uamuzi wa Holtek Semiconductor Inc. na kampuni zake zinazohusiana (hapa 'Holtek', 'kampuni', 'sisi', ' sisi' au 'yetu'). Huku Holtek akijitahidi kuhakikisha usahihi wa Taarifa kuhusu hili webtovuti, hakuna dhamana ya wazi au ya kudokezwa iliyotolewa na Holtek kwa usahihi wa Habari. Holtek haitawajibika kwa makosa yoyote au kuvuja.
Holtek hatawajibika kwa uharibifu wowote (ikiwa ni pamoja na, lakini sio mdogo kwa virusi vya kompyuta, shida za mfumo au upotezaji wa data) wowote utakaotokea katika kutumia au kuhusiana na matumizi ya hii. webtovuti na chama chochote. Kunaweza kuwa na viungo katika eneo hili, vinavyokuwezesha kutembelea webtovuti za makampuni mengine. Haya webtovuti hazidhibitiwi na Holtek. Holtek haitawajibika na hakuna dhamana kwa Taarifa zozote zinazoonyeshwa kwenye tovuti kama hizo. Viungo kwa zingine webtovuti ziko kwa hatari yako mwenyewe.

Ukomo wa Dhima
Kwa hali yoyote, Holtek Limited haitawajibika kwa mhusika mwingine yeyote kwa hasara au uharibifu wowote au namna yoyote iliyosababishwa moja kwa moja au kwa njia isiyo ya moja kwa moja kuhusiana na ufikiaji wako au matumizi ya hii. webtovuti, maudhui yaliyomo au bidhaa yoyote, nyenzo au huduma.

Sheria ya Utawala
Kanusho lililomo katika webtovuti itasimamiwa na kufasiriwa kwa mujibu wa sheria za Jamhuri ya Uchina. Watumiaji watawasilisha kwa mamlaka isiyo ya kipekee ya mahakama za Jamhuri ya Uchina.

Usasishaji wa Kanusho
Holtek inahifadhi haki ya kusasisha Kanusho wakati wowote na au bila ilani ya hapo awali, mabadiliko yote yataanza kutumika mara moja baada ya kuchapishwa kwa webtovuti.

Nyaraka / Rasilimali

Maktaba ya Ufunguo wa Kugusa ya Holtek HT32 MCU [pdf] Mwongozo wa Mtumiaji HT32, Maktaba ya Ufunguo wa Kugusa wa MCU, Maktaba ya Ufunguo wa Kugusa wa HT32 MCU

Marejeleo

• Mwongozo wa Mtumiaji