Holtek HT32 MCU Touch Key Library

Entwodiksyon

Bibliyotèk kle touche HT32 devlope pa Best Solution se yon bibliyotèk ki entegre nan MCU a tout bibliyotèk kle manyen ki kache. files. Bibliyotèk la te pre-konfigirasyon pyès ki nan konpitè MCU ki gen rapò ak manyen, epi li bay anviwònman sansiblite kle manyen entwisyon ak fleksib, pandan y ap entegre fonksyon komen tankou deteksyon kle ak mòd dòmi ekonomize pouvwa. Sèvi ak bibliyotèk kle manyen HT32 la senplifye itilizasyon fonksyon manyen MCU yo, sa ki pèmèt itilizatè yo kòmanse byen vit epi redwi peryòd devlopman an. Dokiman sa a pral dekri an detay konfigirasyon anviwònman an ak itilizasyon bibliyotèk la.

Konfigirasyon anviwònman an

Jwenn HT32 Touch Key Library
Kontakte FAE Best Solution oswa al gade li websit: http://www.bestsolution.com.tw/EN/
Oswa telechaje bibliyotèk la nan Holtek la websit: https://www.holtek.com

Jwenn Bibliyotèk Firmware HT32
Ale nan lyen sa a pou jwenn byen vit bibliyotèk firmwèr la: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Louvri lyen an, chwazi opsyon Dokiman yo jan yo montre nan Figi 1, kote bwat wouj la endike kote HT32 konprese a. files. Remake byen ke sèlman bibliyotèk firmwèr vèsyon v022 oswa pi wo a sipòte bibliyotèk kle touche HT32 la.

Keil Pwojè Konfigirasyon 

1. PC itilizatè a bezwen gen zouti devlopman Keil enstale.
2. Dekonprime bibliyotèk firmwèr la. La files yo ki nan lis jan yo montre nan Figi 2. Klike sou Holtek.HT32_DFP.latest enstale li, apre sa ekran fini enstalasyon an, jan yo montre nan Figi 3, ap parèt.
3. Dekonprime bibliyotèk kle touche HT32 ki gen de dosye, egzanpample ak bibliyotèk.
4. Kopi ansyen anampdosye ak dosye bibliyotèk yo nan katab HT32_STD_xxxxx_FWLib_v022_XXXX.
5. Egzekite ..\egample\TouchKey\TouchKey_LIB\_CreateProject.bat (Figi 6).
6. Yon koòdone, jan yo montre nan Figi 7, ap parèt. Antre nimewo ki koresponn ak IDE itilizatè a, apre sa yon siy "*" ap parèt anvan IDE chwazi a, jan yo montre nan Figi 8. Antre "N" pou ale nan pwochen etap la.
7. Jan yo montre anba a, antre "*" pou kreye pwojè pou tout kalite IC oswa antre non IC a pou kreye yon pwojè pou IC yo chwazi a.
8. Apre w fin fini etap 1 ~ 7, jan yo montre nan Figi 11, chwazi pwojè IC ou vle a tankou Project_54xxx.uvprojx soti nan ..\ex.ample\TouchKey\TouchKey_LIB\MDK_ARMv5\ chemen.
   Remak ke sèlman MCU a ki gen pi gwo resous nan chak seri yo itilize pou kreye pwojè a. Pou egzanpample, pou itilize HT32F54231 itilizatè yo dwe chwazi pwojè HT32F54241 la.

Konsiderasyon
Kòm pwogram nan touche touche ka antre nan eta a dòmi, li oblije mete pwojè a sou pouvwa sou reset, otreman li pa pral disponib pou pwogramasyon. Etap yo anviwònman yo jan sa a.

1. Etap 1: Klike sou bouton an nan meni zouti Keil5, jan yo montre anba a.
2. Etap 2: Chwazi Debug–> Anviwònman.
3. Etap 3: Chwazi "anba Reyajiste" nan jaden an Konekte.

Bibliyotèk Files Deskripsyon

Resous Bibliyotèk Itilize 

Keil Pwojè	IC ka itilize	ROM/RAM Resous	Itilize IP	Max. Kantite kle
HT32F54241	HT32F54241 HT32F54231	7148B / 2256B	Manyen kle BFTM0 RTC	24
HT32F54253	HT32F54243 HT32F54253	7140B / 2528B	Manyen kle BFTM0 RTC	28

1. RTC yo itilize pou reveye MCU soti nan eta dòmi epi yo itilize kòm baz tan pou pwosesis eta dòmi.
2. Lè pwogram nan chaje nan IC a, Keil la pral detèmine si gwosè ROM oswa RAM yo te depase.
3. Pou itilizasyon espesifik resous yo, al gade nan vèsyon bibliyotèk aktyèl la.

Anviwònman ak File Deskripsyon
Bibliyotèk kle touche HT32 a sitiye nan chemen sa a. ..\egzample\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx pwojè (Figi15). Apre pwojè bibliyotèk kle touche HT32 la louvri, ekran prensipal la montre kòm Figi 16.

Ki enpòtan an fileyo dekri jan sa a, pami yo se ht32_TouchKey_conf.h ak system_ht32f5xxxx_09.c files, enkli nan Sòsye Konfigirasyon an. Gade figi 17.

File Non	Deskripsyon
prensipal.c	Pwogram prensipal pwojè a file
ht32f5xxxx_01_it.c	Entèwonp pwogram prensipal la file
ht32_TouchKey_Lib_Mx_Keil.lib	Manyen bibliyotèk kontwòl file
*ht32_TouchKey_conf.h	Manyen paramèt kontwòl file
ht32_TouchKey.h	Definisyon deklarasyon ekstèn file
ht32_TouchKey_BSconf.h	Paramèt prensipal ki kache file (pa rekòmande pou modifye)
ht32_board_config.h	Definisyon pyès ki nan konpitè file (pa rekòmande pou modifye)
*system_ht32f5xxxx_09.c	Sous revèy ak paramèt revèy sistèm file

Paramèt Sòsye Konfigirasyon

1. ht32_TouchKey_conf.h Paramèt Sòsye Konfigirasyon:
   

   Non	Fonksyon
   PowerSave	Aktive pwosedi dòmi default defini nan main.c
   TKL_HighSensitive	Anviwònman sansiblite manyen: sansiblite segondè oswa ba; default nan sansiblite segondè apre yo te pèmèt
   TKL_keyDebounce	Kle debouse tan fikse
   TKL_RefCalTime	Tan kalibrasyon. Pi kout tan an, pi efikas li pral nan reziste entèferans anviwònman an, sepandan li pral lakòz pi ba sansiblite kle.
   TKL_MaxOnHoldTime	Tan maksimòm ke kle a peze. Se kle a otomatikman lage apre yo fin peze pou n segonn.
   KEYn_EN	Aktive oswa enfim KEYn
   KeynThreshold	KEYn valè papòt. Pi piti valè a, kle a pi sansib.

2. system_ht32f5xxxx_09.c Paramèt Sòsye Konfigirasyon:
   

   Non	Fonksyon
   Pèmèt gwo vitès ekstèn Crystal osilator - HSE	Aktive oswa enfim HSE (osilateur ekstèn gwo vitès)
   Pèmèt ba vitès ekstèn Crystal osilator - LSE	Aktive oswa enfim LSE (osilateur ekstèn vitès ki ba)
   Pèmèt PLL	Aktive oswa enfim PLL
   PLL Revèy Sous	Chwazi sous revèy pou PLL
   SystemCoreClockConfiguration (CK_AHB)	Chwazi sous revèy pou sistèm CK_AHB

Deskripsyon Fonksyon koòdone Touch Key Lib

Deskripsyon nan Jwenn Fonksyon

Atik	Deskripsyon
Non Fonksyon	TKL_Get_Standby
Antre paramèt	—
Valè retounen	Valè konte (500 ~ 60000)
Deskripsyon	Itilize pou jwenn valè kontwa a

 

Atik	Deskripsyon
Non Fonksyon	TKL_Get_KeyRCCValue
Antre paramèt	Valè kle (0 ~ maksimòm valè kle), frekans (0, 1)
Valè retounen	Valè kapasite (0 ~ 1023)
Deskripsyon	Itilize pou jwenn valè kapasite kle a espesifye

 

Atik	Deskripsyon
Non Fonksyon	TKL_GetKeyRef
Antre paramèt	Valè kle (0 ~ maksimòm valè kle)
Valè retounen	Valè referans (0 ~ 65535)
Deskripsyon	Itilize pou jwenn valè referans kle espesifye a

 

Atik	Deskripsyon
Non Fonksyon	TKL_GetKeyThreshold
Antre paramèt	Valè kle (0 ~ maksimòm valè kle)
Valè retounen	Valè papòt (0 ~ 255)
Deskripsyon	Itilize pou jwenn valè papòt kle espesifye a

 

Atik	Deskripsyon
Non Fonksyon	TKL_Get_AllKeyState
Antre paramèt	—
Valè retounen	Eta kle (32-bit) BITn kanpe pou KEYn eta Bit0 = 1 vle di ke KEY0 ap peze, Bit0 = 0 vle di ke KEY0 pa peze
Deskripsyon	Itilize pou jwenn tout eta kle yo

Deskripsyon Set Fonksyon 

Atik	Deskripsyon
Non Fonksyon	TKL_Set_KeyThreshold
Antre paramèt	Valè kle (0 ~ maksimòm valè kle), valè papòt (10 ~ 127)
Valè retounen	—
Deskripsyon	Itilize pou mete valè papòt kle espesifye a

 

Atik	Deskripsyon
Non Fonksyon	TKL_Set_Standby
Antre paramèt	Tan dòmi (500 ~ 60000)
Valè retounen	—
Deskripsyon	Itilize pou mete kontwa a (pa rekòmande pou itilize fonksyon sa a)

Deskripsyon Fonksyon Leta ak Kòmandman 

Atik	Deskripsyon
Non Fonksyon	TKL_Is_Time
Antre paramèt	Konstan prereglaj (kT2mS, kT4mS...kT2048mS)
Valè retounen	—
Deskripsyon	Tan drapo pou referans itilizatè. Nan egzanp sa aample, pwogram nan antre nan fonksyon an chak 2ms.

 

Atik	Deskripsyon
Non Fonksyon	TKL_Is_AnyKeyPress
Antre paramèt	—
Valè retounen	1 = youn oswa plizyè kle te deklanche; 0 = pa gen okenn kle ki te deklanche
Deskripsyon	Itilize pou jwenn drapo pou laprès kle a

 

Atik	Deskripsyon
Non Fonksyon	TKL_Is_KeyPress
Antre paramèt	Valè kle (0 ~ maksimòm valè kle)
Valè retounen	1 = kle te deklanche; 0 = kle pa te deklanche
Deskripsyon	Itilize pou jwenn drapo eta kle a espesifye

 

Atik	Deskripsyon
Non Fonksyon	TKL_Is_Aktif
Antre paramèt	—
Valè retounen	1 = Inisyalizasyon LIB fini; 0 = Inisyalizasyon LIB pa fini
Deskripsyon	Itilize pou jwenn drapo eta inisyalizasyon LIB la

 

Atik	Deskripsyon
Non Fonksyon	TKL_Is_Standby
Antre paramèt	—
Valè retounen	1 = pèmèt yo antre nan eta dòmi; 0 = pa gen dwa antre nan eta dòmi
Deskripsyon	Itilize pou jwenn drapo eta dòmi an. *Lè yo retounen yon valè 0, lè sa a antre nan eta dòmi an ka lakòz yon eta inatandi.

 

Atik	Deskripsyon
Non Fonksyon	TKL_Is_KeyScanCycle
Antre paramèt	—
Valè retounen	1 = eskanè te fini; 0 = kounye a optik
Deskripsyon	Itilize pou jwenn drapo eskanè a

 

Atik	Deskripsyon
Non Fonksyon	TKL_Reset
Antre paramèt	—
Valè retounen	—
Deskripsyon	Itilize pou fòse LIB egzekite yon aksyon reset. *Y ap inisyalize drapo LIB ak RAM yo itilize. *Paramèt ak AFIO yo eskli.

Deskripsyon Fonksyon Inisyalizasyon Touch Key Lib

Fonksyon sa yo sitiye nan main.c. Li pa rekòmande pou modifye sa yo.

Non	Fonksyon
GPIO_Configuration()	Konfigirasyon pò I/O
RTC_Konfigirasyon ()	RTC a reveye kle manyen yo
BFTM_Konfigirasyon ()	BFTM aplike baz tan bibliyotèk touche kle yo
TKL_Konfigirasyon ()	Manyen konfigirasyon kle yo

Rekèt Eta kle
Kòm montre pi ba a, pwogram prensipal la gen ladan yon kle touche eksample ki pa pral aktive pa default. Pou aktive fonksyon sa a, modifye (0) apre #if pou (1).

Deskripsyon mòd dòmi

1. Nan ht32_TouchKey_conf.h, chwazi PowerSave pou pèmèt mòd dòmi yo.
2. Apre mòd dòmi yo te pèmèt, kle yo manyen pral antre nan eta a dòmi si kle yo pa te fè eksperyans nenpòt kondisyon manyen pou yon sèten peryòd tan.
3. Yo itilize yon fonksyon konte tan sibstiti pou konte desann, lè aktyèl la jwenn lè l sèvi avèk TKL_Get_Standby epi yo mete paramèt tan an lè l sèvi avèk TKL_Set_Standby.
4. Gen twa opsyon mòd dòmi.
   

   Mode	Deskripsyon
   USE_SLEEP_MODE	Antre nan mòd dòmi
   USE_DEEP_SLEEP1_MODE	Antre nan Deep Sleep1 Mode
   USE_DEEP_SLEEP2_MODE	Antre nan Deep Sleep2 Mode

5. Jan yo montre anba a, mete mòd dòmi obligatwa lè l sèvi avèk "#define" nan prensipal la file.

Konklizyon
Dokiman sa a te bay enstriksyon pou mete kanpe tout anviwònman devlopman kle HT32 touche, ede itilizatè yo kòmanse byen vit. Anplis de sa, resous bibliyotèk la itilize, ansanm ak plizyè fonksyon ak paramèt, yo te eksplike an detay, sa ki pèmèt yon pwosesis devlopman pi fasil.

Materyèl referans

Pou plis detay, al gade nan Holtek la websit: www.holtek.com oswa konsilte pi bon solisyon an websit: http://www.bestsolution.com.tw/EN/

Vèsyon ak enfòmasyon modifikasyon:

Dat	Otè	Lage	Deskripsyon
2022.03.16	谢东霖、梁德浩	V1.00	Premye vèsyon

Limit responsabilite nou

Tout enfòmasyon, mak, logo, grafik, videyo, klip odyo, lyen ak lòt bagay ki parèt sou sa a. websit ("Enfòmasyon") yo se pou referans sèlman epi yo ka chanje nenpòt ki lè san avètisman alavans ak nan diskresyon Holtek Semiconductor Inc. ak konpayi ki gen rapò ak li yo (ki aprè 'Holtek', 'konpayi an', 'nou', '. nou' oswa 'nou'). Pandan ke Holtek fè efò asire presizyon nan Enfòmasyon sou sa a websit, pa gen okenn garanti eksprime oswa enplisit pa Holtek bay presizyon nan enfòmasyon an. Holtek p ap pote okenn responsablite pou nenpòt ki kòrèk oswa flit.
Holtek pa pral responsab pou nenpòt domaj (ki gen ladan men pa limite a viris òdinatè, pwoblèm sistèm oswa pèt done) kèlkeswa sa ki rive nan itilize oswa an koneksyon avèk itilizasyon sa a. websit pa nenpòt pati. Ka gen lyen nan zòn sa a, ki pèmèt ou vizite a websit lòt konpayi yo. Sa yo websit yo pa kontwole pa Holtek. Holtek p ap pote okenn responsablite ak okenn garanti pou nenpòt enfòmasyon ki parèt nan sit sa yo. Hyperlinks nan lòt websit yo sou pwòp risk ou.

Limitasyon Responsablite
Nan okenn ka Holtek Limited pa ta dwe responsab anvè okenn lòt pati pou nenpòt pèt oswa domaj kèlkeswa sa oswa nenpòt ki jan ki te koze dirèkteman oswa endirèkteman an koneksyon avèk aksè ou a oswa itilizasyon sa a. websit, kontni an oswa nenpòt machandiz, materyèl oswa sèvis.

Lwa k ap dirije
Limit responsabilite nou ki nan la websit la dwe gouvène ak entèprete an akò ak lwa yo nan Repiblik Lachin nan. Itilizatè yo pral soumèt bay jiridiksyon ki pa eksklizif nan tribinal Repiblik Lachin yo.

Mizajou nan Limit responsabilite nou
Holtek rezève dwa pou mete ajou Limit responsabilite nou an nenpòt ki lè avèk oswa san avètisman davans, tout chanjman yo efektif imedyatman apre yo fin poste nan websit.

Dokiman / Resous

Holtek HT32 MCU Touch Key Library [pdfGid Itilizatè HT32, MCU Touch Key Library, HT32 MCU Touch Key Library

Referans

• Manyèl itilizatè