Knjižnica tipk na dotik Holtek HT32 MCU
Uvod
Knjižnica tipk na dotik HT32, ki jo je razvilo podjetje Best Solution, je knjižnica, ki v MCU integrira vso osnovno knjižnico gonilnikov tipk na dotik. files. Knjižnica ima vnaprej konfigurirano strojno opremo MCU, povezano z dotikom, in zagotavlja intuitivne in prilagodljive nastavitve občutljivosti tipk na dotik, hkrati pa integrira običajne funkcije, kot so zaznavanje tipk in načini mirovanja za varčevanje z energijo. Uporaba knjižnice tipk na dotik HT32 poenostavlja uporabo funkcij MCU na dotik, kar uporabnikom omogoča hiter začetek in skrajša razvojno obdobje. Ta dokument bo podrobno opisal konfiguracijo okolja in uporabo knjižnice.
Konfiguracija okolja
Pridobite knjižnico tipk na dotik HT32
Obrnite se na FAE podjetja Best Solution ali se obrnite nanj webspletno mesto: http://www.bestsolution.com.tw/EN/
Ali pa prenesite knjižnico iz Holteka webspletno mesto: https://www.holtek.com
Pridobite knjižnico vdelane programske opreme HT32
Če želite hitro pridobiti knjižnico vdelane programske opreme, glejte naslednjo povezavo: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Odprite povezavo, izberite možnost Dokumenti, kot je prikazano na sliki 1, kjer rdeče polje označuje lokacijo stisnjenega HT32 files. Upoštevajte, da samo knjižnica vdelane programske opreme različice v022 ali novejše podpira knjižnico tipk na dotik HT32.
Konfiguracija projekta Keil
- Uporabnikov osebni računalnik mora imeti nameščeno razvojno orodje Keil.
- Razpakirajte knjižnico vdelane programske opreme. The files so navedeni, kot je prikazano na sliki 2. Kliknite Holtek.HT32_DFP.latest, da ga namestite, nato pa se prikaže zaslon za dokončanje namestitve, kot je prikazano na sliki 3.
- Razpakirajte knjižnico tipk na dotik HT32, ki vključuje dve mapi, nprample in knjižnica.
- Kopiraj exampdatoteke in knjižnice v mapo HT32_STD_xxxxx_FWLib_v022_XXXX.
- Izvedi ..\example\TouchKey\TouchKey_LIB\_CreateProject.bat (slika 6).
- Pojavil se bo vmesnik, kot je prikazan na sliki 7. Vnesite številko, ki ustreza uporabniškemu IDE, nato pa se bo pred izbranim IDE pojavil znak »*«, kot je prikazano na sliki 8. Vnesite »N« za prehod na naslednji korak.
- Kot je prikazano spodaj, vnesite »*«, da ustvarite projekte za vse vrste IC, ali vnesite ime IC, da ustvarite projekt za izbrani IC.
- Ko končate korake 1–7, kot je prikazano na sliki 11, izberite želeni projekt IC, kot je Project_54xxx.uvprojx iz ..\examppot le\TouchKey\TouchKey_LIB\MDK_ARMv5\.
Opomba da se za ustvarjanje projekta uporablja samo MCU z največjimi viri v vsaki seriji. Na primerample, morajo uporabniki za uporabo HT32F54231 izbrati projekt HT32F54241.
Premisleki
Ker lahko program tipk na dotik preide v stanje mirovanja, je treba projekt nastaviti na ponastavitev ob vklopu, sicer ne bo na voljo za programiranje. Koraki nastavitve so naslednji.
- 1. korak: Kliknite gumb v meniju orodja Keil5, kot je prikazano spodaj.
- 2. korak: Izberite Odpravljanje napak–> Nastavitve.
- 3. korak: V polju Connect izberite »pod Reset«.
Knjižnica Files Opis
Uporabljeni viri knjižnice
| Projekt Keil | Uporaben IC | ROM/RAM Viri | Uporabljen IP | maks. Število ključev |
| HT32F54241 | HT32F54241 HT32F54231 | 7148B / 2256B | Tipka na dotik
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140B / 2528B | Tipka na dotik BFTM0
RTC |
28 |
- RTC se uporablja za prebujanje MCU iz stanja mirovanja in kot časovna osnova za obdelavo stanja mirovanja.
- Ko je program naložen v IC, bo Keil ugotovil, ali je bila velikost ROM ali RAM presežena.
- Za specifično uporabo virov glejte dejansko različico knjižnice.
Okolje in File Opis
Knjižnica tipk na dotik HT32 se nahaja na naslednji poti. ..\nprampprojekt le\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx (slika 15). Ko se odpre projekt knjižnice tipk na dotik HT32, je glavni zaslon prikazan kot slika 16.
Ustrezno fileso opisani kot sledi, med njimi sta ht32_TouchKey_conf.h in system_ht32f5xxxx_09.c files, ki je vključen v čarovnika za konfiguracijo. Glej sliko 17.
| File Ime | Opis |
| glavni.c | Glavni program projekta file |
| ht32f5xxxx_01_it.c | Prekinite glavni program file |
| ht32_TouchKey_Lib_Mx_Keil.lib | Knjižnica za upravljanje na dotik file |
| *ht32_TouchKey_conf.h | Parameter upravljanja na dotik file |
| ht32_TouchKey.h | Definicija zunanje deklaracije file |
| ht32_TouchKey_BSconf.h | Osnovni glavni parameter file (ni priporočljivo spreminjati) |
| ht32_board_config.h | Definicija strojne opreme file (ni priporočljivo spreminjati) |
| *system_ht32f5xxxx_09.c | Vir ure in parameter sistemske ure file |
Parametri čarovnika za konfiguracijo
- ht32_TouchKey_conf.h Parametri čarovnika za konfiguracijo:
Ime funkcija PowerSave Aktivirajte privzeti postopek mirovanja, definiran v main.c TKL_HighSensitive Nastavitev občutljivosti na dotik: visoka ali nizka občutljivost; po omogočenju je privzeto nastavljena na visoko občutljivost TKL_keyDebounce Nastavitev časa odboja ključa TKL_RefCalTime Čas umerjanja. Krajši kot je čas, učinkovitejši bo pri upiranju okoljskim motnjam, vendar bo povzročil manjšo občutljivost tipk. TKL_MaxOnHoldTime Največji čas, ko je tipka pritisnjena. Tipka se samodejno sprosti po pritisku n sekund. KEYn_EN Omogočite ali onemogočite KEYn KeynThreshold KEYn mejna vrednost. Manjša kot je vrednost, bolj občutljiv bo ključ. - system_ht32f5xxxx_09.c Parametri čarovnika za konfiguracijo:
Ime funkcija Omogoči zunanji kristalni oscilator visoke hitrosti – HSE Omogoči ali onemogoči HSE (zunanji oscilator visoke hitrosti) Omogoči nizkohitrostni zunanji kristalni oscilator – LSE Omogoči ali onemogoči LSE (zunanji oscilator nizke hitrosti) Omogoči PLL Omogoči ali onemogoči PLL Vir ure PLL Izberite vir takta za PLL SystemCoreClockConfiguration (CK_AHB) Izberite vir ure za sistem CK_AHB
Opis funkcij vmesnika Touch Key Lib
Opis funkcij Get
| Postavka | Opis |
| Ime funkcije | TKL_Get_Standby |
| Vhodni parameter | — |
| Povratna vrednost | Vrednost štetja (500~60000) |
| Opis | Uporablja se za pridobitev vrednosti odštevalnega števca |
| Postavka | Opis |
| Ime funkcije | TKL_Get_KeyRCCValue |
| Vhodni parameter | Vrednost ključa (0 ~ največja vrednost ključa), frekvenca (0, 1) |
| Povratna vrednost | Vrednost kapacitivnosti (0~1023) |
| Opis | Uporablja se za pridobitev vrednosti kapacitivnosti določenega ključa |
| Postavka | Opis |
| Ime funkcije | TKL_GetKeyRef |
| Vhodni parameter | Vrednost ključa (0 ~ največja vrednost ključa) |
| Povratna vrednost | Referenčna vrednost (0~65535) |
| Opis | Uporablja se za pridobitev referenčne vrednosti podanega ključa |
| Postavka | Opis |
| Ime funkcije | TKL_GetKeyThreshold |
| Vhodni parameter | Vrednost ključa (0 ~ največja vrednost ključa) |
| Povratna vrednost | Mejna vrednost (0~255) |
| Opis | Uporablja se za pridobitev vrednosti praga navedenega ključa |
| Postavka | Opis |
| Ime funkcije | TKL_Get_AllKeyState |
| Vhodni parameter | — |
| Povratna vrednost | Stanje ključa (32-bitno)
BITn pomeni stanje KEYn Bit0 = 1 pomeni, da je KEY0 pritisnjena, Bit0 = 0 pomeni, da KEY0 ni pritisnjena |
| Opis | Uporablja se za pridobitev vseh ključnih stanj |
Opis nabora funkcij
| Postavka | Opis |
| Ime funkcije | TKL_Set_KeyThreshold |
| Vhodni parameter | Vrednost ključa (0 ~ največja vrednost ključa), vrednost praga (10~127) |
| Povratna vrednost | — |
| Opis | Uporablja se za nastavitev vrednosti praga navedenega ključa |
| Postavka | Opis |
| Ime funkcije | TKL_Set_Standby |
| Vhodni parameter | Čas mirovanja (500~60000) |
| Povratna vrednost | — |
| Opis | Uporablja se za nastavitev odštevalnega števca (uporaba te funkcije ni priporočljiva) |
Opis državnih in poveljniških funkcij
| Postavka | Opis |
| Ime funkcije | TKL_Je_Čas |
| Vhodni parameter | Prednastavljena konstanta (kT2mS, kT4mS…kT2048mS) |
| Povratna vrednost | — |
| Opis | Časovna zastavica za uporabniško referenco.
V naslednjem prample, program vstopi v funkcijo vsaki 2 ms. |
| Postavka | Opis |
| Ime funkcije | TKL_Is_AnyKeyPress |
| Vhodni parameter | — |
| Povratna vrednost | 1 = ena ali več tipk je bilo sproženih; 0 = nobena tipka ni bila sprožena |
| Opis | Uporablja se za pridobitev zastavice za pritisk tipke |
| Postavka | Opis |
| Ime funkcije | TKL_Is_KeyPress |
| Vhodni parameter | Vrednost ključa (0 ~ največja vrednost ključa) |
| Povratna vrednost | 1 = tipka je bila sprožena; 0 = tipka ni bila sprožena |
| Opis | Uporablja se za pridobitev zastavice stanja podanega ključa |
| Postavka | Opis |
| Ime funkcije | TKL_Je_aktiven |
| Vhodni parameter | — |
| Povratna vrednost | 1 = inicializacija LIB je končana; 0 = inicializacija LIB ni končana |
| Opis | Uporablja se za pridobitev zastavice stanja inicializacije LIB |
| Postavka | Opis |
| Ime funkcije | TKL_Je_V pripravljenosti |
| Vhodni parameter | — |
| Povratna vrednost | 1 = dovoljen vstop v stanje mirovanja; 0 = vstop v stanje mirovanja ni dovoljen |
| Opis | Uporablja se za pridobitev oznake stanja mirovanja.
*Ko je vrnjena vrednost 0, lahko vstop v stanje mirovanja povzroči nepričakovano stanje. |
| Postavka | Opis |
| Ime funkcije | TKL_Je_KeyScanCycle |
| Vhodni parameter | — |
| Povratna vrednost | 1 = skeniranje je končano; 0 = trenutno skeniranje |
| Opis | Uporablja se za pridobitev zastavice skeniranja |
| Postavka | Opis |
| Ime funkcije | TKL_Ponastavi |
| Vhodni parameter | — |
| Povratna vrednost | — |
| Opis | Uporablja se za prisilo LIB, da izvede dejanje ponastavitve.
*Zastavice, ki jih uporabljata LIB in RAM, bodo inicializirane. *Parametri in AFIO so izključeni. |
Opis funkcij inicializacije Touch Key Lib
Te funkcije se nahajajo v main.c. Njihove vsebine ni priporočljivo spreminjati.
| Ime | funkcija |
| GPIO_Configuration() | Konfiguracije V/I vrat |
| RTC_Configuration() | Tipke na dotik prebudi RTC |
| BFTM_Configuration() | Časovne baze knjižnice tipk na dotik implementira BFTM |
| TKL_Configuration() | Konfiguracije tipk na dotik |
Poizvedba o stanju ključa
Kot je prikazano spodaj, glavni program vključuje tipko na dotik nprampki ne bo privzeto aktiviran. Če želite aktivirati to funkcijo, spremenite (0) za #if v (1).
Opis načina mirovanja
- V ht32_TouchKey_conf.h izberite PowerSave, da omogočite načine mirovanja.
- Ko so načini mirovanja omogočeni, bodo tipke na dotik prešle v stanje mirovanja, če se tipke določen čas niso dotaknile.
- Funkcija štetja časa pripravljenosti se uporablja za štetje navzdol, trenutni čas se pridobi s TKL_Get_Standby in časovni parameter se nastavi s TKL_Set_Standby.
- Na voljo so tri možnosti načina mirovanja.
Način Opis USE_SLEEP_MODE Vstopite v način spanja USE_DEEP_SLEEP1_MODE Vstopite v način Deep Sleep1 USE_DEEP_SLEEP2_MODE Vstopite v način Deep Sleep2 - Kot je prikazano spodaj, nastavite želeni način mirovanja z uporabo »#define« v glavnem file.
Zaključek
Ta dokument vsebuje navodila za nastavitev celotnega razvojnega okolja tipk na dotik HT32, kar uporabnikom pomaga pri hitrem začetku. Poleg tega so podrobno razloženi viri, ki jih uporablja knjižnica, ter različne funkcije in parametri, kar omogoča lažji proces razvoja.
Referenčni material
Za več podrobnosti glejte Holtek webspletno mesto: www.holtek.com ali se posvetujte z najboljšo rešitvijo webspletno mesto: http://www.bestsolution.com.tw/EN/
Različice in informacije o spremembah:
| Datum | Avtor | Sprostitev | Opis |
| 2022.03.16 | 谢东霖、梁德浩 | V1.00 | Prva različica |
Zavrnitev odgovornosti
Vse informacije, blagovne znamke, logotipi, grafike, videi, zvočni posnetki, povezave in drugi elementi, ki se pojavljajo na tem webspletno mesto ('Informacije') so samo za referenco in se lahko kadar koli spremenijo brez predhodnega obvestila in po presoji družbe Holtek Semiconductor Inc. in njenih povezanih družb (v nadaljevanju 'Holtek', 'podjetje', 'nas', ' mi« ali »naš«). Medtem ko si Holtek prizadeva zagotoviti točnost informacij o tem webstrani, Holtek ne daje nobenega izrecnega ali implicitnega jamstva za točnost informacij. Holtek ne prevzema nobene odgovornosti za kakršno koli nepravilnost ali uhajanje.
Holtek ne bo odgovoren za nobeno škodo (vključno, vendar ne omejeno na računalniške viruse, sistemske težave ali izgubo podatkov), ki bi nastala pri uporabi ali v povezavi z uporabo tega webkatero koli stran. Na tem področju so lahko povezave, ki vam omogočajo obisk webstrani drugih podjetij. te webstrani niso pod nadzorom Holteka. Holtek ne prevzema nikakršne odgovornosti in jamstva za kakršne koli informacije, prikazane na takšnih straneh. Hiperpovezave do drugih webspletna mesta so na lastno odgovornost.
Omejitev odgovornosti
Holtek Limited v nobenem primeru ne bo odgovoren nobeni drugi stranki za kakršno koli izgubo ali škodo, ki je nastala neposredno ali posredno v povezavi z vašim dostopom ali uporabo tega webspletnega mesta, vsebine na njem ali katerega koli blaga, materiala ali storitev.
Veljavno pravo
Izjava o omejitvi odgovornosti, vsebovana v webspletno mesto ureja in razlaga v skladu z zakoni Republike Kitajske. Uporabniki se bodo podredili neizključni pristojnosti sodišč Republike Kitajske.
Posodobitev izjave o omejitvi odgovornosti
Holtek si pridržuje pravico, da kadar koli posodobi Izjavo o zavrnitvi odgovornosti s predhodnim obvestilom ali brez njega, vse spremembe začnejo veljati takoj po objavi na webmesto.
Dokumenti / Viri
 |
Knjižnica tipk na dotik Holtek HT32 MCU [pdf] Uporabniški priročnik HT32, knjižnica tipk na dotik MCU, knjižnica tipk na dotik HT32 MCU |
