Holtek HT32 MCU სენსორული კლავიშების ბიბლიოთეკა

შესავალი

Best Solution-ის მიერ შემუშავებული HT32 სენსორული კლავიშების ბიბლიოთეკა არის ბიბლიოთეკა, რომელიც აერთიანებს MCU-ში ყველა სენსორული კლავიშის დრაივერის ბიბლიოთეკას. fileს. ბიბლიოთეკამ წინასწარ დააკონფიგურირა შეხებასთან დაკავშირებული MCU აპარატურა და უზრუნველყოფს შეხების ღილაკების მგრძნობელობის ინტუიციურ და მოქნილ პარამეტრებს, ამავდროულად აერთიანებს საერთო ფუნქციებს, როგორიცაა გასაღების ამოცნობა და ენერგიის დაზოგვის ძილის რეჟიმები. HT32 სენსორული კლავიშების ბიბლიოთეკის გამოყენება ამარტივებს MCU სენსორული ფუნქციების გამოყენებას, რაც მომხმარებლებს საშუალებას აძლევს სწრაფად დაიწყონ და შეამცირონ განვითარების პერიოდი. ეს დოკუმენტი დეტალურად აღწერს გარემოსდაცვით კონფიგურაციას და ბიბლიოთეკის გამოყენებას.

გარემოს კონფიგურაცია

მიიღეთ HT32 Touch Key ბიბლიოთეკა
დაუკავშირდით Best Solution-ის FAE-ს ან მიმართეთ მას webსაიტი: http://www.bestsolution.com.tw/EN/
ან ჩამოტვირთეთ ბიბლიოთეკა Holtek-დან webსაიტი: https://www.holtek.com

მიიღეთ HT32 Firmware Library
გადადით შემდეგ ბმულზე, რომ სწრაფად მიიღოთ firmware ბიბლიოთეკა: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
გახსენით ბმული, აირჩიეთ Documents ოფცია, როგორც ნაჩვენებია სურათზე 1, სადაც წითელი ველი მიუთითებს შეკუმშული HT32-ის მდებარეობას fileს. გაითვალისწინეთ, რომ მხოლოდ v022 ან უფრო მაღალი ვერსიის firmware ბიბლიოთეკას აქვს HT32 სენსორული კლავიშების ბიბლიოთეკის მხარდაჭერა.

Keil პროექტის კონფიგურაცია 

1. მომხმარებლის კომპიუტერს უნდა ჰქონდეს Keil განვითარების ინსტრუმენტი დაინსტალირებული.
2. გახსენით firmware ბიბლიოთეკა. The files არის ჩამოთვლილი, როგორც ნაჩვენებია სურათზე 2. დააწკაპუნეთ Holtek.HT32_DFP.latest-ზე მის დასაყენებლად, რის შემდეგაც გამოჩნდება ინსტალაციის დასრულების ეკრანი, როგორც ნაჩვენებია სურათზე 3.
3. გახსენით HT32 სენსორული კლავიშების ბიბლიოთეკა, რომელიც მოიცავს ორ საქაღალდეს, მაგampლე და ბიბლიოთეკა.
4. დააკოპირეთ ყოფილიample და ბიბლიოთეკის საქაღალდეები HT32_STD_xxxxx_FWLib_v022_XXXX საქაღალდეში.
5. შეასრულე ..\ექსample\TouchKey\TouchKey_LIB\_CreateProject.bat (სურათი 6).
6. გამოჩნდება ინტერფეისი, როგორც ნაჩვენებია სურათზე 7. შეიყვანეთ მომხმარებლის IDE-ის შესაბამისი ნომერი, რის შემდეგაც არჩეული IDE-ის წინ გამოჩნდება „*“ ნიშანი, როგორც ეს ნაჩვენებია სურათზე 8. შემდეგ საფეხურზე გადასასვლელად შეიყვანეთ „N“.
7. როგორც ქვემოთ ნაჩვენებია, შეიყვანეთ „*“ პროექტების შესაქმნელად ყველა IC ტიპისთვის ან შეიყვანეთ IC-ის სახელი არჩეული IC-სთვის პროექტის შესაქმნელად.
8. 1-7 ნაბიჯების დასრულების შემდეგ, როგორც ნაჩვენებია სურათზე 11, აირჩიეთ სასურველი IC პროექტი, როგორიცაა Project_54xxx.uvprojx ..\ex-დან.ample\TouchKey\TouchKey_LIB\MDK_ARMv5\ ბილიკი.
   შენიშვნა რომ პროექტის შესაქმნელად გამოიყენება მხოლოდ MCU, რომელსაც აქვს ყველაზე დიდი რესურსები თითოეულ სერიაში. მაგample, HT32F54231-ის გამოსაყენებლად მომხმარებლებმა უნდა აირჩიონ HT32F54241 პროექტი.

მოსაზრებები
იმის გამო, რომ სენსორული ღილაკის პროგრამა შეიძლება შევიდეს ძილის მდგომარეობაში, საჭიროა პროექტის ჩართვა გადატვირთვის რეჟიმში, წინააღმდეგ შემთხვევაში ის არ იქნება ხელმისაწვდომი პროგრამირებისთვის. დაყენების ნაბიჯები შემდეგია.

1. ნაბიჯი 1: დააჭირეთ ღილაკს Keil5 ინსტრუმენტის მენიუში, როგორც ნაჩვენებია ქვემოთ.
2. ნაბიჯი 2: აირჩიეთ გამართვა -> პარამეტრები.
3. ნაბიჯი 3: დაკავშირების ველში აირჩიეთ "გადატვირთვის ქვეშ".

ბიბლიოთეკა Files აღწერა

ბიბლიოთეკის გამოყენებული რესურსები 

კეილის პროექტი	გამოსაყენებელი IC	ROM/RAM რესურსები	მეორადი IP	მაქს. გასაღებების რაოდენობა
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 პროექტი (სურათი 15). HT32 სენსორული კლავიშების ბიბლიოთეკის პროექტის გახსნის შემდეგ, მთავარი ეკრანი ნაჩვენებია როგორც ნახაზი 16.

შესაბამისი files აღწერილია შემდეგნაირად, რომელთა შორისაა ht32_TouchKey_conf.h და system_ht32f5xxxx_09.c files, შედის კონფიგურაციის ოსტატში. იხილეთ სურათი 17.

File სახელი	აღწერა
მთავარი.გ	პროექტის მთავარი პროგრამა 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 კონფიგურაციის ოსტატის პარამეტრები:
   

   სახელი	ფუნქცია
   PowerSave	გააქტიურეთ ნაგულისხმევი ძილის პროცედურა, რომელიც განსაზღვრულია main.c
   TKL_HighSensitive	შეხების მგრძნობელობის პარამეტრი: მაღალი ან დაბალი მგრძნობელობა; ნაგულისხმევი მაღალი მგრძნობელობა ჩართვის შემდეგ
   TKL_keyDebounce	გასაღების გაშვების დროის პარამეტრი
   TKL_RefCalTime	კალიბრაციის დრო. რაც უფრო მოკლეა დრო, მით უფრო ეფექტური იქნება ის გარემოსდაცვითი ჩარევის წინააღმდეგობის გაწევაში, თუმცა ეს გამოიწვევს საკვანძო სენსიტიურობის შემცირებას.
   TKL_MaxOnHoldTime	კლავიშის დაჭერის მაქსიმალური დრო. ღილაკი ავტომატურად იხსნება n წამის დაჭერის შემდეგ.
   KEYn_EN	ჩართეთ ან გამორთეთ KEYn
   KeynThreshold	KEYn ბარიერის მნიშვნელობა. რაც უფრო მცირეა მნიშვნელობა, მით უფრო მგრძნობიარე იქნება გასაღები.

2. system_ht32f5xxxx_09.c კონფიგურაციის ოსტატის პარამეტრები:
   

   სახელი	ფუნქცია
   ჩართეთ მაღალი სიჩქარის გარე კრისტალური ოსცილატორი - HSE	ჩართეთ ან გამორთეთ HSE (გარე მაღალი სიჩქარის ოსცილატორი)
   ჩართეთ დაბალი სიჩქარის გარე კრისტალური ოსცილატორი – LSE	ჩართეთ ან გამორთეთ LSE (გარე დაბალი სიჩქარის ოსცილატორი)
   ჩართეთ PLL	ჩართეთ ან გამორთეთ PLL
   PLL საათის წყარო	აირჩიეთ საათის წყარო PLL-ისთვის
   SystemCoreClockClock Configuration (CK_AHB)	აირჩიეთ საათის წყარო CK_AHB სისტემისთვის

Touch Key Lib ინტერფეისის ფუნქციების აღწერა

Get ფუნქციების აღწერა

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_Get_Standby
შეყვანის პარამეტრი	—
დაბრუნების ღირებულება	დათვლის ღირებულება (500~60000)
აღწერა	გამოიყენება მთვლელი მრიცხველის მნიშვნელობის მისაღებად

 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_Get_KeyRCCValue
შეყვანის პარამეტრი	საკვანძო მნიშვნელობა (0 ~ მაქს. გასაღების მნიშვნელობა), სიხშირე (0, 1)
დაბრუნების ღირებულება	ტევადობის მნიშვნელობა (0~1023)
აღწერა	გამოიყენება მითითებული გასაღების ტევადობის მნიშვნელობის მისაღებად

 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_GetKeyRef
შეყვანის პარამეტრი	საკვანძო მნიშვნელობა (0 ~ მაქს. გასაღების მნიშვნელობა)
დაბრუნების ღირებულება	საცნობარო მნიშვნელობა (0~65535)
აღწერა	გამოიყენება მითითებული გასაღების საცნობარო მნიშვნელობის მისაღებად

 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_GetKeyThreshold
შეყვანის პარამეტრი	საკვანძო მნიშვნელობა (0 ~ მაქს. გასაღების მნიშვნელობა)
დაბრუნების ღირებულება	ზღვრული მნიშვნელობა (0~255)
აღწერა	გამოიყენება მითითებული გასაღების ზღვრული მნიშვნელობის მისაღებად

 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_Get_AllKeyState
შეყვანის პარამეტრი	—
დაბრუნების ღირებულება	გასაღების მდგომარეობა (32 ბიტიანი) BITn ნიშნავს KEYn მდგომარეობას Bit0 = 1 ნიშნავს, რომ KEY0 დაჭერილია, Bit0 = 0 ნიშნავს, რომ KEY0 არ არის დაჭერილი
აღწერა	გამოიყენება ყველა საკვანძო მდგომარეობის მისაღებად

კომპლექტის ფუნქციების აღწერა 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_Set_KeyThreshold
შეყვანის პარამეტრი	საკვანძო მნიშვნელობა (0 ~ მაქს. გასაღების მნიშვნელობა), ზღვრული მნიშვნელობა (10~127)
დაბრუნების ღირებულება	—
აღწერა	გამოიყენება მითითებული გასაღების ზღვრული მნიშვნელობის დასაყენებლად

 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_Set_Standby
შეყვანის პარამეტრი	ძილის დრო (500-60000)
დაბრუნების ღირებულება	—
აღწერა	გამოიყენება ათვლის მრიცხველის დასაყენებლად (არ არის რეკომენდებული ამ ფუნქციის გამოყენება)

სახელმწიფო და სამეთაურო ფუნქციების აღწერა 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_Is_Time
შეყვანის პარამეტრი	წინასწარ დაყენებული მუდმივი (kT2mS, kT4mS…kT2048mS)
დაბრუნების ღირებულება	—
აღწერა	დროის დროშა მომხმარებლის მითითებისთვის. შემდეგში ეგample, პროგრამა შედის ფუნქციაში ყოველ 2ms.

 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_Is_AnyKeyPress
შეყვანის პარამეტრი	—
დაბრუნების ღირებულება	1 = ამოქმედდა ერთი ან მეტი გასაღები; 0 = გასაღები არ არის გაშვებული
აღწერა	გამოიყენება გასაღების დაჭერის დროშის მისაღებად

 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_Is_KeyPress
შეყვანის პარამეტრი	საკვანძო მნიშვნელობა (0 ~ მაქს. გასაღების მნიშვნელობა)
დაბრუნების ღირებულება	1 = გასაღები გააქტიურებულია; 0 = გასაღები არ ამოქმედდა
აღწერა	გამოიყენება მითითებული გასაღების სახელმწიფო დროშის მისაღებად

 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_Is_Active
შეყვანის პარამეტრი	—
დაბრუნების ღირებულება	1 = LIB ინიციალიზაცია დასრულდა; 0 = LIB ინიციალიზაცია არ დასრულებულა
აღწერა	გამოიყენება LIB ინიციალიზაციის სახელმწიფო დროშის მისაღებად

 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_Is_Standby
შეყვანის პარამეტრი	—
დაბრუნების ღირებულება	1 = ძილის მდგომარეობაში შესვლის უფლება; 0 = დაუშვებელია ძილის მდგომარეობაში შესვლა
აღწერა	გამოიყენება ძილის სახელმწიფო დროშის მისაღებად. *როდესაც დაბრუნდა მნიშვნელობა 0, მაშინ ძილის მდგომარეობაში შესვლამ შეიძლება გამოიწვიოს მოულოდნელი მდგომარეობა.

 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_Is_KeyScanCycle
შეყვანის პარამეტრი	—
დაბრუნების ღირებულება	1 = სკანირება დასრულდა; 0 = ამჟამად მიმდინარეობს სკანირება
აღწერა	გამოიყენება სკანირების დროშის მისაღებად

 

ელემენტი	აღწერა
ფუნქციის სახელი	TKL_გადატვირთვა
შეყვანის პარამეტრი	—
დაბრუნების ღირებულება	—
აღწერა	გამოიყენება LIB-ის გადატვირთვის მოქმედების იძულებისთვის. * LIB და ოპერატიული მეხსიერების მიერ გამოყენებული დროშები ინიცირებული იქნება. *პარამეტრები და AFIO გამორიცხულია.

Touch Key Lib ინიციალიზაციის ფუნქციების აღწერა

ეს ფუნქციები განლაგებულია მთავარ.გ. არ არის რეკომენდებული მათი შინაარსის შეცვლა.

სახელი	ფუნქცია
GPIO_Configuration()	I/O პორტის კონფიგურაციები
RTC_Configuration()	სენსორული ღილაკები აღვიძებს RTC-ს
BFTM_Configuration()	სენსორული კლავიშების ბიბლიოთეკის დროის ბაზები დანერგილია BFTM-ის მიერ
TKL_Configuration()	შეეხეთ კლავიშების კონფიგურაციას

საკვანძო სახელმწიფო შეკითხვა
როგორც ქვემოთ არის ნაჩვენები, მთავარი პროგრამა მოიცავს სენსორულ კლავიშს მაგ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	შედით Deep Sleep1 რეჟიმში
   USE_DEEP_SLEEP2_MODE	შედით Deep Sleep2 რეჟიმში

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-ის მიერ არ არის გაცემული რაიმე გამოხატული ან ნაგულისხმევი გარანტია ინფორმაციის სიზუსტეზე. Holtek არ აგებს პასუხისმგებლობას არასწორად ან გაჟონვაზე.
Holtek არ იქნება პასუხისმგებელი რაიმე ზიანს (მათ შორის, მაგრამ არ შემოიფარგლება კომპიუტერული ვირუსით, სისტემის პრობლემებით ან მონაცემთა დაკარგვით) ნებისმიერი სახის ზარალზე, რომელიც წარმოიქმნება ამ გამოყენებისას ან გამოყენებასთან დაკავშირებით. webსაიტი ნებისმიერი მხარის მიერ. ამ ზონაში შეიძლება იყოს ბმულები, რომლებიც საშუალებას მოგცემთ ეწვიოთ webსხვა კომპანიების საიტები. ესენი webსაიტებს არ აკონტროლებს Holtek. Holtek არ იქნება პასუხისმგებელი და არავითარი გარანტია ასეთ საიტებზე ნაჩვენები ნებისმიერი ინფორმაციის მიმართ. ჰიპერბმულები სხვასთან webსაიტები თქვენი რისკის ქვეშაა.

პასუხისმგებლობის შეზღუდვა
არავითარ შემთხვევაში Holtek Limited არ იქნება პასუხისმგებელი რომელიმე სხვა მხარის წინაშე რაიმე დანაკარგზე ან ზიანზე, რომელიც გამოწვეულია პირდაპირ ან ირიბად თქვენს მიერ ამ წვდომასთან ან გამოყენებასთან დაკავშირებით. webსაიტი, მასში არსებული შინაარსი ან ნებისმიერი საქონელი, მასალა ან მომსახურება.

მარეგულირებელი კანონი
პასუხისმგებლობის შეზღუდვა შეიცავს webსაიტი იმართება და განიმარტება ჩინეთის რესპუბლიკის კანონმდებლობის შესაბამისად. მომხმარებლები წარუდგენენ ჩინეთის რესპუბლიკის სასამართლოების არაექსკლუზიურ იურისდიქციას.

პასუხისმგებლობის შეზღუდვის განახლება
Holtek იტოვებს უფლებას განაახლოს პასუხისმგებლობის შეზღუდვა ნებისმიერ დროს წინასწარი გაფრთხილებით ან მის გარეშე, ყველა ცვლილება ძალაშია გამოქვეყნებისთანავე webსაიტი.

დოკუმენტები / რესურსები

Holtek HT32 MCU სენსორული კლავიშების ბიბლიოთეკა [pdf] მომხმარებლის სახელმძღვანელო HT32, MCU Touch Key Library, HT32 MCU Touch Key Library

ცნობები

• მომხმარებლის სახელმძღვანელო