Holtek HT32 MCU Touch Key Library
Uvod
Biblioteka dodirnih tipki HT32 koju je razvio Best Solution je biblioteka koja integrira u MCU svu biblioteku upravljačkih programa za dodirnu tipku. files. Biblioteka je unapred konfigurisala MCU hardver koji se odnosi na dodir i pruža intuitivne i fleksibilne postavke osetljivosti tastera na dodir, dok integriše uobičajene funkcije kao što su detekcija tastera i režimi mirovanja koji štede energiju. Korištenje biblioteke dodirnih tipki HT32 pojednostavljuje korištenje MCU dodirnih funkcija, omogućavajući korisnicima da brzo počnu i smanjujući period razvoja. Ovaj dokument će detaljno opisati konfiguraciju okruženja i korištenje biblioteke.
Environmental Configuration
Nabavite HT32 Touch Key Library
Kontaktirajte Best Solution FAE ili se obratite njegovom webstranica: http://www.bestsolution.com.tw/EN/
Ili preuzmite biblioteku sa Holteka webstranica: https://www.holtek.com
Nabavite HT32 Firmware Library
Pogledajte sljedeću vezu da brzo dobijete biblioteku firmvera: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Otvorite link, odaberite opciju Dokumenti kao što je prikazano na slici 1, gdje crveni okvir označava lokaciju komprimirane HT32 files. Imajte na umu da samo biblioteka firmvera verzije v022 ili novija podržava biblioteku dodirnih tipki HT32.
Konfiguracija projekta Keil
- Računar korisnika mora imati instaliran Keil razvojni alat.
- Raspakujte biblioteku firmvera. The filesu navedeni kao što je prikazano na slici 2. Kliknite na Holtek.HT32_DFP.latest da ga instalirate, nakon čega će se pojaviti ekran za završetak instalacije, kao što je prikazano na slici 3.
- Raspakirajte HT32 biblioteku dodirnih tipki koja uključuje dvije mape, nprample i biblioteku.
- Kopiraj exampdatoteke i foldere biblioteke u fasciklu HT32_STD_xxxxx_FWLib_v022_XXXX.
- Izvrši ..\example\TouchKey\TouchKey_LIB\_CreateProject.bat (slika 6).
- Pojavit će se interfejs, kao što je prikazano na slici 7. Unesite broj koji odgovara korisničkom IDE-u, nakon čega će se ispred odabranog IDE-a pojaviti znak “*”, kao što je prikazano na slici 8. Unesite “N” da biste prešli na sljedeći korak.
- Kao što je prikazano ispod, unesite “*” da kreirate projekte za sve tipove IC-a ili unesite ime IC-a da kreirate projekat za odabrani IC.
- Nakon što završite korake 1~7, kao što je prikazano na slici 11, izaberite željeni IC projekat kao što je Project_54xxx.uvprojx iz ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\ putanja.
Napomena da se samo MCU sa najvećim resursima u svakoj seriji koristi za kreiranje projekta. Za nprampda bi koristili HT32F54231 korisnici moraju odabrati HT32F54241 projekat.
Razmatranja
Kako program dodirne tipke može ući u stanje mirovanja, potrebno je postaviti projekat na resetiranje, inače neće biti dostupan za programiranje. Koraci podešavanja su sljedeći.
- Korak 1: Kliknite na dugme u meniju alata Keil5, kao što je prikazano ispod.
- Korak 2: Odaberite Debug–> Settings.
- Korak 3: Odaberite “pod Reset” u polju Connect.
Biblioteka Files Opis
Bibliotečki korišteni resursi
| Keil Project | Upotrebljiv IC | ROM/RAM Resursi | Koristi IP | Max. Broj ključeva |
| HT32F54241 | HT32F54241 HT32F54231 | 7148B / 2256B | Taster na dodir
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140B / 2528B | Taster na dodir BFTM0
RTC |
28 |
- RTC se koristi za buđenje MCU iz stanja mirovanja i koristi se kao vremenska baza za obradu stanja mirovanja.
- Kada se program učita u IC, Keil će odrediti da li je prekoračena veličina ROM-a ili RAM-a.
- Za konkretnu upotrebu resursa, pogledajte stvarnu verziju biblioteke.
Životna sredina i File Opis
Biblioteka dodirnih tipki HT32 nalazi se na sljedećoj stazi. ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx projekat (Slika 15). Nakon otvaranja projekta biblioteke dodirnih tipki HT32, glavni ekran je prikazan kao Slika 16.
Relevantno filesu opisani na sljedeći način, među kojima su ht32_TouchKey_conf.h i system_ht32f5xxxx_09.c files, uključeno u čarobnjak za konfiguraciju. Pogledajte sliku 17.
| File Ime | Opis |
| main.c | Glavni program projekta file |
| ht32f5xxxx_01_it.c | Prekinite glavni program file |
| ht32_TouchKey_Lib_Mx_Keil.lib | Biblioteka kontrole dodirom file |
| *ht32_TouchKey_conf.h | Parametar kontrole dodirom file |
| ht32_TouchKey.h | Definicija vanjske deklaracije file |
| ht32_TouchKey_BSconf.h | Osnovni glavni parametar file (nije preporučljivo mijenjati) |
| ht32_board_config.h | Definicija hardvera file (nije preporučljivo mijenjati) |
| *system_ht32f5xxxx_09.c | Izvor sata i parametar sistemskog sata file |
Parametri čarobnjaka za konfiguraciju
- ht32_TouchKey_conf.h Parametri čarobnjaka za konfiguraciju:
Ime Funkcija PowerSave Aktivirajte zadanu proceduru mirovanja definiranu u main.c TKL_HighSensitive Postavka osjetljivosti na dodir: visoka ili niska osjetljivost; podrazumevano na visoku osetljivost nakon što je omogućeno TKL_keyDebounce Podešavanje vremena odbijanja ključa TKL_RefCalTime Vrijeme kalibracije. Što je vreme kraće, to će biti efikasnije u odupiranju uticaju okoline, ali će rezultirati nižom osetljivošću ključnih reči. TKL_MaxOnHoldTime Maksimalno vrijeme pritiska na tipku. Tipka se automatski pušta nakon pritiska na n sekundi. KEYn_EN Omogućite ili onemogućite KEYn KeynThreshold KEYn vrijednost praga. Što je manja vrijednost, to će ključ biti osjetljiviji. - system_ht32f5xxxx_09.c Parametri čarobnjaka za konfiguraciju:
Ime Funkcija Omogući eksterni kristalni oscilator velike brzine – HSE Omogućite ili onemogućite HSE (eksterni oscilator velike brzine) Omogući vanjski kristalni oscilator male brzine – LSE Omogućite ili onemogućite LSE (vanjski oscilator male brzine) Omogući PLL Omogućite ili onemogućite PLL PLL izvor takta Odaberite izvor takta za PLL SystemCoreClockConfiguration (CK_AHB) Odaberite izvor takta za sistem CK_AHB
Opis funkcija interfejsa Touch Key Lib
Opis funkcija Get
| Stavka | Opis |
| Naziv funkcije | TKL_Get_Standby |
| Ulazni parametar | — |
| Povratna vrijednost | Vrijednost brojanja (500~60000) |
| Opis | Koristi se za dobivanje vrijednosti brojača za odbrojavanje |
| Stavka | Opis |
| Naziv funkcije | TKL_Get_KeyRCCValue |
| Ulazni parametar | Ključna vrijednost (0 ~ maks. ključna vrijednost), frekvencija (0, 1) |
| Povratna vrijednost | Vrijednost kapacitivnosti (0~1023) |
| Opis | Koristi se za dobivanje vrijednosti kapacitivnosti navedenog ključa |
| Stavka | Opis |
| Naziv funkcije | TKL_GetKeyRef |
| Ulazni parametar | Vrijednost ključa (0 ~ maks. vrijednost ključa) |
| Povratna vrijednost | Referentna vrijednost (0~65535) |
| Opis | Koristi se za dobivanje referentne vrijednosti navedenog ključa |
| Stavka | Opis |
| Naziv funkcije | TKL_GetKeyThreshold |
| Ulazni parametar | Vrijednost ključa (0 ~ maks. vrijednost ključa) |
| Povratna vrijednost | Vrijednost praga (0~255) |
| Opis | Koristi se za dobivanje vrijednosti praga navedenog ključa |
| Stavka | Opis |
| Naziv funkcije | TKL_Get_AllKeyState |
| Ulazni parametar | — |
| Povratna vrijednost | Stanje ključa (32-bit)
BITn je skraćenica za KEYn stanje Bit0 = 1 znači da je KEY0 pritisnut, Bit0 = 0 znači da KEY0 nije pritisnut |
| Opis | Koristi se za dobijanje svih ključnih stanja |
Opis funkcija skupa
| Stavka | Opis |
| Naziv funkcije | TKL_Set_KeyThreshold |
| Ulazni parametar | Ključna vrijednost (0 ~ maks. vrijednost ključa), vrijednost praga (10~127) |
| Povratna vrijednost | — |
| Opis | Koristi se za postavljanje granične vrijednosti navedenog ključa |
| Stavka | Opis |
| Naziv funkcije | TKL_Set_Standby |
| Ulazni parametar | Vrijeme spavanja (500~60000) |
| Povratna vrijednost | — |
| Opis | Koristi se za postavljanje brojača odbrojavanja (ne preporučuje se korištenje ove funkcije) |
Opis funkcija stanja i komande
| Stavka | Opis |
| Naziv funkcije | TKL_Is_Time |
| Ulazni parametar | Unaprijed postavljena konstanta (kT2mS, kT4mS…kT2048mS) |
| Povratna vrijednost | — |
| Opis | Vremenska zastavica za korisničku referencu.
U sljedećem prampNakon toga, program ulazi u funkciju svaka 2 ms. |
| Stavka | Opis |
| Naziv funkcije | TKL_Is_AnyKeyPress |
| Ulazni parametar | — |
| Povratna vrijednost | 1 = jedan ili više ključeva je aktivirano; 0 = nijedan ključ nije aktiviran |
| Opis | Koristi se za dobijanje zastavice za pritisak na taster |
| Stavka | Opis |
| Naziv funkcije | TKL_Is_KeyPress |
| Ulazni parametar | Vrijednost ključa (0 ~ maks. vrijednost ključa) |
| Povratna vrijednost | 1 = ključ je aktiviran; 0 = ključ nije aktiviran |
| Opis | Koristi se za dobivanje zastave stanja navedenog ključa |
| Stavka | Opis |
| Naziv funkcije | TKL_Is_Active |
| Ulazni parametar | — |
| Povratna vrijednost | 1 = Inicijalizacija LIB-a je završena; 0 = Inicijalizacija LIB-a nije završena |
| Opis | Koristi se za dobivanje oznake stanja inicijalizacije LIB-a |
| Stavka | Opis |
| Naziv funkcije | TKL_Is_Standby |
| Ulazni parametar | — |
| Povratna vrijednost | 1 = dozvoljeno da uđe u stanje mirovanja; 0 = nije dozvoljen ulazak u stanje mirovanja |
| Opis | Koristi se za dobijanje zastave stanja mirovanja.
*Kada se vrati vrijednost 0, tada ulazak u stanje mirovanja može dovesti do neočekivanog stanja. |
| Stavka | Opis |
| Naziv funkcije | TKL_Is_KeyScanCycle |
| Ulazni parametar | — |
| Povratna vrijednost | 1 = skeniranje je završeno; 0 = trenutno skeniranje |
| Opis | Koristi se za dobijanje zastavice za skeniranje |
| Stavka | Opis |
| Naziv funkcije | TKL_Reset |
| Ulazni parametar | — |
| Povratna vrijednost | — |
| Opis | Koristi se da prisili LIB da izvrši akciju resetiranja.
*Zastavice koje koriste LIB i RAM bit će inicijalizirane. *Parametri i AFIO su isključeni. |
Opis funkcija inicijalizacije Touch Key Lib
Ove funkcije se nalaze u main.c. Nije preporučljivo mijenjati njihov sadržaj.
| Ime | Funkcija |
| GPIO_Konfiguracija() | Konfiguracije I/O portova |
| RTC_Konfiguracija() | Tastere na dodir budi RTC |
| BFTM_Konfiguracija() | BFTM implementira vremenske baze biblioteka dodirnih ključeva |
| TKL_Konfiguracija() | Konfiguracije dodirnih tipki |
Key State Query
Kao što je prikazano ispod, glavni program uključuje dodirni taster nprample koji neće biti aktiviran prema zadanim postavkama. Da biste aktivirali ovu funkciju, promijenite (0) nakon #if u (1).
Opis načina mirovanja
- U ht32_TouchKey_conf.h izaberite PowerSave da omogućite režime mirovanja.
- Nakon što su režimi mirovanja omogućeni, dodirni tasteri će ući u stanje mirovanja ako tasteri nisu iskusili nikakve uslove dodira tokom određenog vremenskog perioda.
- Funkcija odbrojavanja vremena pripravnosti koristi se za odbrojavanje, trenutno vrijeme se dobiva pomoću TKL_Get_Standby, a parametar vremena se postavlja pomoću TKL_Set_Standby.
- Postoje tri opcije režima mirovanja.
Mode Opis USE_SLEEP_MODE Uđite u način mirovanja USE_DEEP_SLEEP1_MODE Uđite u način dubokog spavanja1 USE_DEEP_SLEEP2_MODE Uđite u način dubokog spavanja2 - Kao što je prikazano ispod, podesite željeni režim mirovanja koristeći “#define” u glavnom file.
Zaključak
Ovaj dokument sadrži upute za postavljanje cjelokupnog razvojnog okruženja HT32 touch key, pomažući korisnicima da brzo počnu. Pored toga, resursi koje biblioteka koristi, kao i različite funkcije i parametri, detaljno su objašnjeni, što omogućava lakši razvojni proces.
Referentni materijal
Za više detalja, pogledajte Holtek webstranica: www.holtek.com ili konsultujte Najbolje rešenje webstranica: http://www.bestsolution.com.tw/EN/
Informacije o verzijama i modifikacijama:
| Datum | Autor | Pusti | Opis |
| 2022.03.16 | 谢东霖、梁德浩 | V1.00 | Prva verzija |
Odricanje od odgovornosti
Sve informacije, zaštitni znakovi, logotipi, grafike, video zapisi, audio isječci, linkovi i druge stavke koje se pojavljuju na ovom webstranica ('Informacije') su samo za referencu i podložne su promjenama u bilo koje vrijeme bez prethodne najave i prema diskreciji Holtek Semiconductor Inc. i s njim povezanih kompanija (u daljem tekstu: "Holtek", "kompanija", "nas", " mi" ili "naši"). Dok Holtek nastoji da osigura tačnost informacija o tome websajtu, Holtek ne daje izričitu ili impliciranu garanciju za tačnost informacija. Holtek neće snositi odgovornost za bilo kakvu neispravnost ili curenje.
Holtek neće biti odgovoran za bilo kakvu štetu (uključujući, ali ne ograničavajući se na kompjuterske viruse, sistemske probleme ili gubitak podataka) bilo kakvu nastalu korištenjem ili u vezi s korištenjem ovog websajt od strane bilo koje strane. Možda postoje veze u ovoj oblasti koje vam omogućavaju da posetite websajtovima drugih kompanija. Ove webstranice nisu pod kontrolom Holteka. Holtek neće snositi nikakvu odgovornost niti garanciju za bilo koju informaciju prikazanu na takvim stranicama. Hiperlinkovi na druge webstranice su na vlastitu odgovornost.
Ograničenje odgovornosti
Holtek Limited ni u kom slučaju neće biti odgovoran bilo kojoj drugoj strani za bilo kakav gubitak ili štetu na bilo koji način ili na bilo koji način uzrokovan direktno ili indirektno u vezi s vašim pristupom ili korištenjem ovog webstranice, sadržaj na njoj ili bilo koju robu, materijal ili uslugu.
Merodavno pravo
Odricanje od odgovornosti sadržano u websajt će se upravljati i tumačiti u skladu sa zakonima Republike Kine. Korisnici će biti podvrgnuti neisključivoj nadležnosti sudova Republike Kine.
Ažuriranje izjave o odricanju odgovornosti
Holtek zadržava pravo ažuriranja Odricanja odgovornosti u bilo koje vrijeme sa ili bez prethodne najave, sve promjene stupaju na snagu odmah nakon objavljivanja na website.
Dokumenti / Resursi
 |
Holtek HT32 MCU Touch Key Library [pdf] Korisnički priručnik HT32, MCU Touch Key Library, HT32 MCU Touch Key Library |
