Holtek HT32 MCU टच कुञ्जी पुस्तकालय

परिचय

उत्तम समाधान द्वारा विकसित HT32 टच कुञ्जी पुस्तकालय एउटा पुस्तकालय हो जसले MCU मा सबै टच कुञ्जी अन्तर्निहित चालक पुस्तकालयमा एकीकृत गर्दछ। files पुस्तकालयले टच-सम्बन्धित MCU हार्डवेयर पूर्व-कन्फिगर गरेको छ, र सहज र लचिलो टच कुञ्जी संवेदनशीलता सेटिङहरू प्रदान गर्दछ, जबकि सामान्य प्रकार्यहरू जस्तै कुञ्जी पत्ता लगाउने र पावर-बचत निद्रा मोडहरू एकीकृत गर्दै। HT32 टच कुञ्जी लाइब्रेरीको प्रयोगले MCU टच प्रकार्यहरूको प्रयोगलाई सरल बनाउँछ, प्रयोगकर्ताहरूलाई छिट्टै सुरु गर्न र विकास अवधि घटाउन अनुमति दिन्छ। यस कागजातले वातावरणीय कन्फिगरेसन र पुस्तकालय प्रयोगको विस्तृत वर्णन गर्नेछ।

वातावरणीय कन्फिगरेसन

HT32 टच कुञ्जी पुस्तकालय प्राप्त गर्नुहोस्
उत्तम समाधानको FAE लाई सम्पर्क गर्नुहोस् वा यसको सन्दर्भ गर्नुहोस् webसाइट: http://www.bestsolution.com.tw/EN/
वा Holtek बाट पुस्तकालय डाउनलोड गर्नुहोस् webसाइट: https://www.holtek.com

HT32 फर्मवेयर लाइब्रेरी प्राप्त गर्नुहोस्
फर्मवेयर लाइब्रेरी छिटो प्राप्त गर्न निम्न लिङ्कलाई सन्दर्भ गर्नुहोस्: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
लिङ्क खोल्नुहोस्, चित्र 1 मा देखाइए अनुसार कागजात विकल्प चयन गर्नुहोस्, जहाँ रातो बाकसले HT32 कम्प्रेस गरिएको स्थानलाई संकेत गर्दछ। files नोट गर्नुहोस् कि संस्करण v022 वा माथिको फर्मवेयर लाइब्रेरीले HT32 टच कुञ्जी लाइब्रेरीलाई समर्थन गर्दछ।

Keil परियोजना कन्फिगरेसन 

1. प्रयोगकर्ताको PC मा Keil विकास उपकरण स्थापना गर्न आवश्यक छ।
2. फर्मवेयर लाइब्रेरी अनजिप गर्नुहोस्। द files लाई चित्र 2 मा देखाइए अनुसार सूचीबद्ध गरिएको छ। यसलाई स्थापना गर्न Holtek.HT32_DFP.latest मा क्लिक गर्नुहोस्, त्यसपछि चित्र 3 मा देखाइए अनुसार स्थापना पूरा हुने स्क्रिन देखा पर्नेछ।
3. HT32 टच कुञ्जी लाइब्रेरी अनजिप गर्नुहोस् जसमा दुई फोल्डरहरू समावेश छन्, उदाहरणample र पुस्तकालय।
4. पूर्व प्रतिलिपि गर्नुहोस्ample र लाइब्रेरी फोल्डरहरू HT32_STD_xxxxx_FWLib_v022_XXXX फोल्डरमा।
5. कार्यान्वयन गर्नुहोस् ..\example\TouchKey\TouchKey_LIB\_CreateProject.bat (चित्र 6)।
6. चित्र 7 मा देखाइएको एक इन्टरफेस, देखा पर्नेछ। प्रयोगकर्ताको IDE सँग सम्बन्धित नम्बर इनपुट गर्नुहोस्, त्यसपछि चित्र 8 मा देखाइए अनुसार चयन गरिएको IDE अगाडि "*" चिन्ह देखा पर्नेछ। अर्को चरणमा जान "N" इनपुट गर्नुहोस्।
7. तल देखाइएको अनुसार, सबै IC प्रकारका परियोजनाहरू सिर्जना गर्न "*" इनपुट गर्नुहोस् वा चयन गरिएको IC को लागि परियोजना सिर्जना गर्न IC नाम इनपुट गर्नुहोस्।
8. चरण 1 ~ 7 समाप्त गरेपछि, चित्र 11 मा देखाइए अनुसार, ..\ex बाट Project_54xxx.uvprojx जस्ता इच्छित IC परियोजना चयन गर्नुहोस्।ample\TouchKey\TouchKey_LIB\MDK_ARMv5\ पथ।
   नोट प्रत्येक शृङ्खलामा सबैभन्दा ठूलो स्रोत भएको MCU मात्र परियोजना सिर्जना गर्न प्रयोग गरिन्छ। पूर्वका लागिampले, HT32F54231 प्रयोग गर्न प्रयोगकर्ताहरूले HT32F54241 परियोजना चयन गर्नुपर्छ।

विचारहरू
टच कुञ्जी कार्यक्रमले निद्राको स्थितिमा प्रवेश गर्न सक्ने हुनाले, यो प्रोजेक्टलाई रिसेटमा पावरमा सेट गर्न आवश्यक छ, अन्यथा यो प्रोग्रामिङको लागि उपलब्ध हुनेछैन। सेटिङ चरणहरू निम्नानुसार छन्।

1. चरण १: Keil5 उपकरण मेनुमा बटन क्लिक गर्नुहोस्, तल देखाइएको रूपमा।
2. चरण १: डिबग-> सेटिङ्हरू चयन गर्नुहोस्।
3. चरण १: जडान फिल्डमा "रिसेट अन्तर्गत" चयन गर्नुहोस्।

पुस्तकालय Files विवरण

पुस्तकालय प्रयोग गरिएका स्रोतहरू 

केइल परियोजना	प्रयोगयोग्य IC	ROM/RAM स्रोतहरू	प्रयोग गरिएको आईपी	अधिकतम कुञ्जीहरूको संख्या
HT32F54241	HT32F54241 HT32F54231	7148B / 2256B	कुञ्जी छुनुहोस् BFTM0 RTC	24
HT32F54253	HT32F54243 HT32F54253	7140B / 2528B	BFTM0 कुञ्जी छुनुहोस् RTC	28

1. RTC लाई MCU लाई निद्राको अवस्थाबाट जगाउन प्रयोग गरिन्छ र निद्रा अवस्था प्रशोधनका लागि समय आधारको रूपमा प्रयोग गरिन्छ।
2. जब कार्यक्रम IC मा लोड हुन्छ, Keil ले ROM वा RAM को आकार नाघेको छ कि छैन भनेर निर्धारण गर्नेछ।
3. स्रोतहरूको विशिष्ट प्रयोगको लागि, वास्तविक पुस्तकालय संस्करणलाई सन्दर्भ गर्नुहोस्।

वातावरण र File विवरण
HT32 टच कुञ्जी पुस्तकालय निम्न मार्गमा अवस्थित छ। ..\ उदाहरणample\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx परियोजना (चित्र१५)। HT15 टच कुञ्जी पुस्तकालय परियोजना खोलिएपछि, मुख्य स्क्रिन चित्र 32 को रूपमा देखाइएको छ।

सम्बन्धित files लाई निम्नानुसार वर्णन गरिएको छ, जस मध्ये ht32_TouchKey_conf.h र system_ht32f5xxxx_09.c छन् files, कन्फिगरेसन विजार्डमा समावेश छ। चित्र 17 हेर्नुहोस्।

File नाम	विवरण
main.c	परियोजना मुख्य कार्यक्रम file
ht32f5xxxx_01_it.c	मुख्य कार्यक्रम रोक्नुहोस् file
ht32_TouchKey_Lib_Mx_Keil.lib	टच कन्ट्रोल लाइब्रेरी file
*ht32_TouchKey_conf.h	टच नियन्त्रण प्यारामिटर file
ht32_TouchKey.h	बाह्य घोषणा परिभाषा file
ht32_TouchKey_BSconf.h	अन्तर्निहित मुख्य प्यारामिटर file (परिमार्जन गर्न सिफारिस गरिएको छैन)
ht32_board_config.h	हार्डवेयर परिभाषा file (परिमार्जन गर्न सिफारिस गरिएको छैन)
*system_ht32f5xxxx_09.c	घडी स्रोत र प्रणाली घडी प्यारामिटर file

कन्फिगरेसन विजार्ड प्यारामिटरहरू

1. ht32_TouchKey_conf.h कन्फिगरेसन विजार्ड प्यारामिटरहरू:
   

   नाम	कार्य
   पावर सेभ	main.c मा परिभाषित पूर्वनिर्धारित निद्रा प्रक्रिया सक्रिय गर्नुहोस्
   TKL_HighSensitive	स्पर्श संवेदनशीलता सेटिङ: उच्च वा कम संवेदनशीलता; सक्षम भएपछि उच्च संवेदनशीलतामा पूर्वनिर्धारित
   TKL_keyDebounce	कुञ्जी debounce समय सेटिङ
   TKL_RefCalTime	क्यालिब्रेसन समय। जति छोटो समय, वातावरणीय हस्तक्षेपको प्रतिरोधमा यो त्यति नै प्रभावकारी हुनेछ, तर यसले मुख्य संवेदनशीलतालाई कम गर्नेछ।
   TKL_MaxOnHoldTime	कुञ्जी थिचिएको अधिकतम समय। n सेकेन्डको लागि थिचेपछि कुञ्जी स्वतः रिलिज हुन्छ।
   KEYn_EN	KEYn सक्षम वा असक्षम गर्नुहोस्
   KeynThreshold	KEYn थ्रेसहोल्ड मान। मूल्य जति सानो हुन्छ, कुञ्जी त्यति नै संवेदनशील हुनेछ।

2. system_ht32f5xxxx_09.c कन्फिगरेसन विजार्ड प्यारामिटरहरू:
   

   नाम	कार्य
   उच्च गति बाह्य क्रिस्टल ओसिलेटर - HSE सक्षम गर्नुहोस्	HSE सक्षम वा असक्षम गर्नुहोस् (बाह्य उच्च गति ओसिलेटर)
   कम गति बाह्य क्रिस्टल ओसिलेटर सक्षम गर्नुहोस् - LSE	LSE सक्षम वा असक्षम गर्नुहोस् (बाह्य कम गति ओसिलेटर)
   PLL सक्षम गर्नुहोस्	PLL सक्षम वा असक्षम गर्नुहोस्
   PLL घडी स्रोत	PLL को लागि घडी स्रोत चयन गर्नुहोस्
   SystemCoreClock कन्फिगरेसन (CK_AHB)	प्रणाली CK_AHB को लागि घडी स्रोत चयन गर्नुहोस्

टच कुञ्जी लिब इन्टरफेस प्रकार्यहरूको विवरण

गेट प्रकार्यहरूको विवरण

वस्तु	विवरण
प्रकार्य नाम	TKL_Get_Standby
इनपुट प्यारामिटर	—
फिर्ता मूल्य	गणना मान (500 ~ 60000)
विवरण	काउन्ट-डाउन काउन्टर मान प्राप्त गर्न प्रयोग गरिन्छ

 

वस्तु	विवरण
प्रकार्य नाम	TKL_Get_KeyRCCValue
इनपुट प्यारामिटर	कुञ्जी मान (० ~ अधिकतम कुञ्जी मान), आवृत्ति (०, १)
फिर्ता मूल्य	क्यापेसिटन्स मान (०~१०२३)
विवरण	निर्दिष्ट कुञ्जीको क्यापेसिटन्स मान प्राप्त गर्न प्रयोग गरिन्छ

 

वस्तु	विवरण
प्रकार्य नाम	TKL_GetKeyRef
इनपुट प्यारामिटर	कुञ्जी मान (० ~ अधिकतम कुञ्जी मान)
फिर्ता मूल्य	सन्दर्भ मान (०~६५५३५)
विवरण	निर्दिष्ट कुञ्जीको सन्दर्भ मान प्राप्त गर्न प्रयोग गरिन्छ

 

वस्तु	विवरण
प्रकार्य नाम	TKL_GetKeyThreshold
इनपुट प्यारामिटर	कुञ्जी मान (० ~ अधिकतम कुञ्जी मान)
फिर्ता मूल्य	थ्रेसहोल्ड मान (० ~ २५५)
विवरण	निर्दिष्ट कुञ्जीको थ्रेसहोल्ड मान प्राप्त गर्न प्रयोग गरिन्छ

 

वस्तु	विवरण
प्रकार्य नाम	TKL_Get_AllKeyState
इनपुट प्यारामिटर	—
फिर्ता मूल्य	कुञ्जी अवस्था (३२-बिट) BITn भनेको KEYn राज्य हो Bit0 = 1 भनेको KEY0 थिचिएको हो, Bit0 = 0 को मतलब KEY0 थिचिएको छैन
विवरण	सबै प्रमुख राज्यहरू प्राप्त गर्न प्रयोग गरियो

सेट प्रकार्यहरूको विवरण 

वस्तु	विवरण
प्रकार्य नाम	TKL_Set_KeyThreshold
इनपुट प्यारामिटर	कुञ्जी मान (० ~ अधिकतम कुञ्जी मान), थ्रेसहोल्ड मान (१० ~ १२७)
फिर्ता मूल्य	—
विवरण	निर्दिष्ट कुञ्जीको थ्रेसहोल्ड मान सेट गर्न प्रयोग गरिन्छ

 

वस्तु	विवरण
प्रकार्य नाम	TKL_Set_Standby
इनपुट प्यारामिटर	सुत्ने समय (500~60000)
फिर्ता मूल्य	—
विवरण	काउन्ट-डाउन काउन्टर सेट गर्न प्रयोग गरिन्छ (यस प्रकार्य प्रयोग गर्न सिफारिस गरिएको छैन)

राज्य र आदेश कार्यहरूको विवरण 

वस्तु	विवरण
प्रकार्य नाम	TKL_Is_Time
इनपुट प्यारामिटर	पूर्व निर्धारित स्थिरता (kT2mS, kT4mS…kT2048mS)
फिर्ता मूल्य	—
विवरण	प्रयोगकर्ता सन्दर्भको लागि समय झण्डा। निम्न मा पूर्वample, कार्यक्रम प्रत्येक 2ms मा प्रकार्य प्रविष्ट गर्दछ।

 

वस्तु	विवरण
प्रकार्य नाम	TKL_Is_AnyKeyPress
इनपुट प्यारामिटर	—
फिर्ता मूल्य	१ = एक वा बढी कुञ्जी ट्रिगर गरिएको छ; 1 = कुनै कुञ्जी ट्रिगर गरिएको छैन
विवरण	कुञ्जी प्रेस झण्डा प्राप्त गर्न प्रयोग गरियो

 

वस्तु	विवरण
प्रकार्य नाम	TKL_Is_KeyPress
इनपुट प्यारामिटर	कुञ्जी मान (० ~ अधिकतम कुञ्जी मान)
फिर्ता मूल्य	1 = कुञ्जी ट्रिगर गरिएको छ; 0 = कुञ्जी ट्रिगर गरिएको छैन
विवरण	निर्दिष्ट कुञ्जीको राज्य झण्डा प्राप्त गर्न प्रयोग गरिन्छ

 

वस्तु	विवरण
प्रकार्य नाम	TKL_Is_active
इनपुट प्यारामिटर	—
फिर्ता मूल्य	1 = LIB प्रारम्भ समाप्त भयो; 0 = LIB प्रारम्भिकरण समाप्त भएको छैन
विवरण	LIB प्रारम्भिक राज्य झण्डा प्राप्त गर्न प्रयोग गरियो

 

वस्तु	विवरण
प्रकार्य नाम	TKL_Is_Standby
इनपुट प्यारामिटर	—
फिर्ता मूल्य	1 = निद्रा राज्य प्रवेश गर्न अनुमति दिईयो; ० = निद्राको अवस्थामा प्रवेश गर्न अनुमति छैन
विवरण	निद्रा राज्य झण्डा प्राप्त गर्न प्रयोग गरियो। *जब ० को मान फर्काइन्छ, त्यसपछि निद्राको स्थितिमा प्रवेश गर्दा अप्रत्याशित अवस्था हुन सक्छ।

 

वस्तु	विवरण
प्रकार्य नाम	TKL_Is_KeyScanCycle
इनपुट प्यारामिटर	—
फिर्ता मूल्य	1 = स्क्यान समाप्त भयो; 0 = हाल स्क्यान गर्दै
विवरण	स्क्यान झण्डा प्राप्त गर्न प्रयोग गरियो

 

वस्तु	विवरण
प्रकार्य नाम	TKL_Reset
इनपुट प्यारामिटर	—
फिर्ता मूल्य	—
विवरण	LIB लाई रिसेट कार्य कार्यान्वयन गर्न बाध्य पार्न प्रयोग गरियो। *LIB र RAM द्वारा प्रयोग गरिएका झण्डाहरू प्रारम्भ गरिनेछ। * प्यारामिटरहरू र AFIO बहिष्कृत छन्।

टच कुञ्जी लिब प्रारम्भिक कार्यहरूको विवरण

यी प्रकार्यहरू main.c मा अवस्थित छन्। तिनीहरूको सामग्री परिमार्जन गर्न सिफारिस गरिएको छैन।

नाम	कार्य
GPIO_कन्फिगरेसन()	I/O पोर्ट कन्फिगरेसनहरू
RTC_कन्फिगरेसन()	RTC द्वारा टच कुञ्जीहरू उठाइएको छ
BFTM_कन्फिगरेसन()	टच कुञ्जी पुस्तकालय समय आधारहरू BFTM द्वारा लागू गरिएको छ
TKL_कन्फिगरेसन()	कुञ्जी कन्फिगरेसनहरू छुनुहोस्

कुञ्जी राज्य प्रश्न
तल देखाइए अनुसार, मुख्य कार्यक्रममा टच कुञ्जी समावेश छample जुन पूर्वनिर्धारित रूपमा सक्रिय हुनेछैन। यो प्रकार्य सक्रिय गर्न, परिमार्जन गर्नुहोस् (0) पछि #if मा (1)।

निद्रा मोड विवरण

1. ht32_TouchKey_conf.h मा, निद्रा मोडहरू सक्षम गर्न PowerSave चयन गर्नुहोस्।
2. निद्रा मोडहरू सक्षम गरिसकेपछि, यदि कुञ्जीहरूले निश्चित अवधिको लागि कुनै स्पर्श अवस्थाहरू अनुभव गरेन भने टच कुञ्जीहरूले निद्राको स्थितिमा प्रवेश गर्नेछन्।
3. डाउन-काउन्टिङका ​​लागि स्ट्यान्डबाइ टाइम काउन्ट प्रकार्य प्रयोग गरिन्छ, हालको समय TKL_Get_Standby प्रयोग गरेर प्राप्त गरिन्छ र TKL_Set_Standby प्रयोग गरेर समय प्यारामिटर सेट गरिन्छ।
4. त्यहाँ तीन स्लीप मोड विकल्पहरू छन्।
   

   मोड	विवरण
   USE_SLEEP_MODE	निद्रा मोड प्रविष्ट गर्नुहोस्
   USE_DEEP_SLEEP1_MODE	गहिरो निद्रा 1 मोड प्रविष्ट गर्नुहोस्
   USE_DEEP_SLEEP2_MODE	गहिरो निद्रा 2 मोड प्रविष्ट गर्नुहोस्

5. तल देखाइएको रूपमा, मुख्य मा "#define" प्रयोग गरी आवश्यक निद्रा मोड सेट गर्नुहोस् file.

निष्कर्ष
यो कागजातले सम्पूर्ण HT32 टच कुञ्जी विकास वातावरण सेटअप गर्नका लागि निर्देशनहरू प्रदान गरेको छ, प्रयोगकर्ताहरूलाई छिटो सुरु गर्न मद्दत गर्दै। थप रूपमा, पुस्तकालयद्वारा प्रयोग गरिएका स्रोतहरू, साथै विभिन्न प्रकार्यहरू र मापदण्डहरू, एक सजिलो विकास प्रक्रियाको लागि अनुमति दिँदै, विस्तृत रूपमा व्याख्या गरिएको छ।

सन्दर्भ सामग्री

थप विवरणहरूको लागि, Holtek सन्दर्भ गर्नुहोस् webसाइट: www.holtek.com वा उत्तम समाधान परामर्श गर्नुहोस् webसाइट: http://www.bestsolution.com.tw/EN/

संस्करण र परिमार्जन जानकारी:

मिति	लेखक	रिलीज	विवरण
2022.03.16	谢东霖、梁德浩	V1.00	पहिलो संस्करण

अस्वीकरण

यसमा देखिने सबै जानकारी, ट्रेडमार्क, लोगो, ग्राफिक्स, भिडियो, अडियो क्लिप, लिङ्क र अन्य वस्तुहरू webसाइट ('सूचना') केवल सन्दर्भको लागि हो र कुनै पनि समय पूर्व सूचना बिना र Holtek Semiconductor Inc. र यससँग सम्बन्धित कम्पनीहरूको विवेकमा परिवर्तनको विषय हो (यसपछि 'Holtek', 'कंपनी', 'हामी', ' हामी' वा 'हाम्रो')। जबकि Holtek यस मा जानकारी को शुद्धता सुनिश्चित गर्न को लागी प्रयास गर्दछ webसाइट, जानकारी को शुद्धता को लागी Holtek द्वारा कुनै एक्सप्रेस वा निहित वारेन्टी दिइएको छैन। कुनै पनि त्रुटि वा चुहावटको लागि होल्टेक कुनै जिम्मेवारी वहन गर्नेछैन।
यो प्रयोग गर्दा वा यसको प्रयोगको सम्बन्धमा उत्पन्न हुने कुनै पनि क्षति (कम्प्यूटर भाइरस, प्रणाली समस्या वा डेटा हानि सहित) को लागि होल्टेक उत्तरदायी हुनेछैन। webकुनै पनि पार्टी द्वारा साइट। यस क्षेत्रमा लिङ्कहरू हुन सक्छन्, जसले तपाईंलाई भ्रमण गर्न अनुमति दिन्छ webअन्य कम्पनीहरूको साइटहरू। यी webसाइटहरू Holtek द्वारा नियन्त्रित छैनन्। Holtek ले कुनै जिम्मेवारी वहन गर्नेछैन र त्यस्ता साइटहरूमा देखाइएका कुनै पनि जानकारीको कुनै ग्यारेन्टी हुनेछैन। अन्यमा हाइपरलिङ्कहरू webसाइटहरू तपाईंको आफ्नै जोखिममा छन्।

दायित्वको सीमा
कुनै पनि हालतमा होल्टेक लिमिटेडले तपाइँको पहुँच वा प्रयोगको सम्बन्धमा प्रत्यक्ष वा अप्रत्यक्ष रूपमा कुनै पनि हानि वा क्षतिको लागि कुनै पनि अन्य पक्षलाई उत्तरदायी हुनेछैन। webसाइट, त्यसमा रहेको सामग्री वा कुनै पनि वस्तु, सामग्री वा सेवाहरू।

शासित कानून
मा समावेश अस्वीकरण webसाइट गणतन्त्र चीन को कानून अनुसार शासित र व्याख्या गरिनेछ। प्रयोगकर्ताहरूले गणतन्त्र चीनको अदालतको गैर-विशेष क्षेत्राधिकारमा पेश गर्नेछन्।

अस्वीकरणको अपडेट
Holtek ले कुनै पनि समयमा पूर्व सूचना बिना वा बिना अस्वीकरण अपडेट गर्ने अधिकार सुरक्षित राख्छ, सबै परिवर्तनहरू तुरुन्तै पोस्ट गर्दा प्रभावकारी हुन्छन्। webसाइट।

कागजातहरू / स्रोतहरू

Holtek HT32 MCU टच कुञ्जी पुस्तकालय [pdf] प्रयोगकर्ता गाइड HT32, MCU टच कुञ्जी पुस्तकालय, HT32 MCU टच कुञ्जी पुस्तकालय

सन्दर्भहरू

• प्रयोगकर्ता पुस्तिका