Knižnica dotykových klávesov Holtek HT32 MCU
Úvod
Knižnica dotykových kláves HT32 vyvinutá spoločnosťou Best Solution je knižnica, ktorá integruje do MCU všetky základné knižnice ovládačov dotykových kláves. files. Knižnica má predkonfigurovaný hardvér MCU súvisiaci s dotykom a poskytuje intuitívne a flexibilné nastavenia citlivosti dotykových kláves, pričom integruje bežné funkcie, ako je detekcia klávesov a režimy spánku šetriace energiu. Použitie knižnice dotykových klávesov HT32 zjednodušuje používanie dotykových funkcií MCU, umožňuje používateľom rýchlo začať a skracuje dobu vývoja. Tento dokument podrobne popisuje konfiguráciu prostredia a používanie knižnice.
Konfigurácia prostredia
Získajte knižnicu dotykových klávesov HT32
Obráťte sa na Best Solution's FAE alebo sa obráťte na jeho webmiesto: http://www.bestsolution.com.tw/EN/
Alebo si stiahnite knižnicu z Holteku webmiesto: https://www.holtek.com
Získajte knižnicu firmvéru HT32
Ak chcete rýchlo získať knižnicu firmvéru, použite nasledujúci odkaz: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Otvorte odkaz, vyberte možnosť Dokumenty, ako je znázornené na obrázku 1, kde červený rámček označuje umiestnenie komprimovaného súboru HT32 files. Upozorňujeme, že knižnicu dotykových klávesov HT022 podporuje iba knižnica firmvéru verzie v32 alebo vyššej.
Konfigurácia projektu Keil
- V počítači používateľa musí byť nainštalovaný vývojový nástroj Keil.
- Rozbaľte knižnicu firmvéru. The files sú uvedené ako na obrázku 2. Kliknutím na Holtek.HT32_DFP.latest ho nainštalujete, potom sa zobrazí obrazovka dokončenia inštalácie, ako je znázornené na obrázku 3.
- Rozbaľte knižnicu dotykových klávesov HT32, ktorá obsahuje dva priečinky, naprample a knižnica.
- Skopírujte example a priečinky knižnice do priečinka HT32_STD_xxxxx_FWLib_v022_XXXX.
- Spustiť ..\example\TouchKey\TouchKey_LIB\_CreateProject.bat (obrázok 6).
- Zobrazí sa rozhranie, ako je znázornené na obrázku 7. Zadajte číslo zodpovedajúce IDE používateľa, po ktorom sa pred vybraným IDE zobrazí znak „*“, ako je znázornené na obrázku 8. Zadajte „N“ pre prechod na ďalší krok.
- Ako je uvedené nižšie, zadajte „*“ na vytvorenie projektov pre všetky typy IC alebo zadajte názov IC, aby ste vytvorili projekt pre vybratý IC.
- Po dokončení krokov 1 až 7, ako je znázornené na obrázku 11, vyberte požadovaný projekt IC, ako napríklad Project_54xxx.uvprojx z ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\ cesta.
Poznámka že na vytvorenie projektu sa použije iba MCU s najväčšími zdrojmi v každej sérii. NapríkladampAk chcete použiť HT32F54231, používatelia musia vybrať projekt HT32F54241.
Úvahy
Keďže program dotykového tlačidla môže prejsť do stavu spánku, je potrebné nastaviť projekt na resetovanie pri zapnutí, inak nebude k dispozícii na programovanie. Kroky nastavenia sú nasledovné.
- Krok 1: Kliknite na tlačidlo v ponuke nástrojov Keil5, ako je znázornené nižšie.
- Krok 2: Vyberte Debug–> Settings.
- Krok 3: V poli Pripojiť vyberte „pod Obnoviť“.
Knižnica Files Popis
Použité zdroje knižnice
| Projekt Keil | Použiteľný IC | ROM/RAM Zdroje | Použitá IP | Max. Počet kľúčov |
| HT32F54241 | HT32F54241 HT32F54231 | 7148B/2256B | Dotykové tlačidlo
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140B/2528B | Dotykové tlačidlo BFTM0
RTC |
28 |
- RTC sa používa na prebudenie MCU zo stavu spánku a používa sa ako časová základňa na spracovanie stavu spánku.
- Keď je program načítaný do IC, Keil určí, či bola prekročená veľkosť ROM alebo RAM.
- Konkrétne použitie zdrojov nájdete v aktuálnej verzii knižnice.
Životné prostredie a File Popis
Knižnica dotykových klávesov HT32 sa nachádza na nasledujúcej ceste. ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx projekt (obrázok 15). Po otvorení projektu knižnice dotykových klávesov HT32 sa zobrazí hlavná obrazovka ako na obrázku 16.
Príslušné files sú opísané nasledovne, medzi ktorými sú ht32_TouchKey_conf.ha system_ht32f5xxxx_09.c files, zahrnuté v sprievodcovi konfiguráciou. Pozri obrázok 17.
| File Meno | Popis |
| main.c | Hlavný program projektu file |
| ht32f5xxxx_01_it.c | Prerušiť hlavný program file |
| ht32_TouchKey_Lib_Mx_Keil.lib | Knižnica dotykového ovládania file |
| *ht32_TouchKey_conf.h | Parameter dotykového ovládania file |
| ht32_TouchKey.h | Definícia externého vyhlásenia file |
| ht32_TouchKey_BSconf.h | Základný hlavný parameter file (neodporúča sa upravovať) |
| ht32_board_config.h | Definícia hardvéru file (neodporúča sa upravovať) |
| *system_ht32f5xxxx_09.c | Zdroj hodín a parameter systémových hodín file |
Parametre sprievodcu konfiguráciou
- Parametre sprievodcu konfiguráciou ht32_TouchKey_conf.h:
Meno Funkcia PowerSave Aktivujte predvolenú procedúru spánku definovanú v main.c TKL_HighSensitive Nastavenie citlivosti dotyku: vysoká alebo nízka citlivosť; predvolene na vysokú citlivosť po aktivácii TKL_keyDebounce Nastavenie doby oneskorenia kľúča TKL_RefCalTime Čas kalibrácie. Čím kratší čas, tým účinnejšie bude odolávať rušeniu prostredia, ale výsledkom bude nižšia citlivosť kľúčov. TKL_MaxOnHoldTime Maximálny čas stlačenia klávesu. Tlačidlo sa automaticky uvoľní po stlačení na n sekúnd. KEYn_SK Povoliť alebo zakázať KEYn KeynThreshold Prahová hodnota KEYn. Čím menšia hodnota, tým citlivejší bude kľúč. - system_ht32f5xxxx_09.c Parametre sprievodcu konfiguráciou:
Meno Funkcia Povoliť vysokorýchlostný externý kryštálový oscilátor – HSE Povoliť alebo zakázať HSE (externý vysokorýchlostný oscilátor) Povoliť nízkorýchlostný externý kryštálový oscilátor – LSE Povoliť alebo zakázať LSE (externý nízkorýchlostný oscilátor) Povoliť PLL Povoliť alebo zakázať PLL Zdroj hodín PLL Vyberte zdroj hodín pre PLL SystemCoreClockConfiguration (CK_AHB) Vyberte zdroj hodín pre systém CK_AHB
Popis funkcií rozhrania Touch Key Lib
Popis Get Functions
| Položka | Popis |
| Názov funkcie | TKL_Get_Standby |
| Vstupný parameter | — |
| Návratová hodnota | Hodnota počítania (500~60000) |
| Popis | Používa sa na získanie hodnoty odpočítavaného počítadla |
| Položka | Popis |
| Názov funkcie | TKL_Get_KeyRCCValue |
| Vstupný parameter | Hodnota kľúča (0 ~ max. hodnota kľúča), frekvencia (0, 1) |
| Návratová hodnota | Hodnota kapacity (0~1023) |
| Popis | Používa sa na získanie hodnoty kapacity zadaného kľúča |
| Položka | Popis |
| Názov funkcie | TKL_GetKeyRef |
| Vstupný parameter | Hodnota kľúča (0 ~ max. hodnota kľúča) |
| Návratová hodnota | Referenčná hodnota (0~65535) |
| Popis | Používa sa na získanie referenčnej hodnoty zadaného kľúča |
| Položka | Popis |
| Názov funkcie | TKL_GetKeyThreshold |
| Vstupný parameter | Hodnota kľúča (0 ~ max. hodnota kľúča) |
| Návratová hodnota | Prahová hodnota (0~255) |
| Popis | Používa sa na získanie prahovej hodnoty zadaného kľúča |
| Položka | Popis |
| Názov funkcie | TKL_Get_AllKeyState |
| Vstupný parameter | — |
| Návratová hodnota | Stav kľúča (32-bitový)
BITn znamená stav KEYn Bit0 = 1 znamená, že KEY0 je stlačené, Bit0 = 0 znamená, že KEY0 nie je stlačené |
| Popis | Používa sa na získanie všetkých kľúčových stavov |
Popis nastavených funkcií
| Položka | Popis |
| Názov funkcie | TKL_Set_KeyThreshold |
| Vstupný parameter | Hodnota kľúča (0 ~ max. hodnota kľúča), prahová hodnota (10~127) |
| Návratová hodnota | — |
| Popis | Používa sa na nastavenie prahovej hodnoty zadaného kľúča |
| Položka | Popis |
| Názov funkcie | TKL_Set_Standby |
| Vstupný parameter | Čas spánku (500~60000) |
| Návratová hodnota | — |
| Popis | Používa sa na nastavenie odpočítavacieho počítadla (neodporúča sa používať túto funkciu) |
Popis stavových a príkazových funkcií
| Položka | Popis |
| Názov funkcie | TKL_Is_Time |
| Vstupný parameter | Prednastavená konštanta (kT2mS, kT4mS…kT2048mS) |
| Návratová hodnota | — |
| Popis | Časový príznak pre referenciu používateľa.
V nasledujúcom example, program zadáva funkciu každé 2 ms. |
| Položka | Popis |
| Názov funkcie | TKL_Is_AnyKeyPress |
| Vstupný parameter | — |
| Návratová hodnota | 1 = bol spustený jeden alebo viac kláves; 0 = nebolo spustené žiadne tlačidlo |
| Popis | Používa sa na získanie príznaku stlačenia klávesu |
| Položka | Popis |
| Názov funkcie | TKL_Is_KeyPress |
| Vstupný parameter | Hodnota kľúča (0 ~ max. hodnota kľúča) |
| Návratová hodnota | 1 = tlačidlo bolo stlačené; 0 = tlačidlo nebolo stlačené |
| Popis | Používa sa na získanie štátnej vlajky zadaného kľúča |
| Položka | Popis |
| Názov funkcie | TKL_Is_Active |
| Vstupný parameter | — |
| Návratová hodnota | 1 = Inicializácia LIB je dokončená; 0 = Inicializácia LIB sa neskončila |
| Popis | Používa sa na získanie príznaku stavu inicializácie LIB |
| Položka | Popis |
| Názov funkcie | TKL_Is_Standby |
| Vstupný parameter | — |
| Návratová hodnota | 1 = povolený prechod do režimu spánku; 0 = nie je dovolené prejsť do režimu spánku |
| Popis | Používa sa na získanie príznaku stavu spánku.
*Keď sa vráti hodnota 0, prechod do režimu spánku môže viesť k neočakávanému stavu. |
| Položka | Popis |
| Názov funkcie | TKL_Is_KeyScanCycle |
| Vstupný parameter | — |
| Návratová hodnota | 1 = skenovanie sa skončilo; 0 = práve prebieha skenovanie |
| Popis | Používa sa na získanie príznaku skenovania |
| Položka | Popis |
| Názov funkcie | TKL_Reset |
| Vstupný parameter | — |
| Návratová hodnota | — |
| Popis | Používa sa na prinútenie LIB vykonať akciu resetovania.
* Príznaky používané LIB a RAM budú inicializované. *Parametre a AFIO sú vylúčené. |
Popis funkcií inicializácie dotykovej klávesy Lib
Tieto funkcie sa nachádzajú v main.c. Neodporúča sa upravovať ich obsah.
| Meno | Funkcia |
| GPIO_Configuration() | Konfigurácie I/O portov |
| RTC_Configuration() | Dotykové klávesy zobudí RTC |
| BFTM_Configuration() | Časové základne knižnice dotykových klávesov implementuje BFTM |
| TKL_Configuration() | Konfigurácie dotykových tlačidiel |
Dotaz na kľúčový stav
Ako je uvedené nižšie, hlavný program obsahuje dotykové tlačidlo naprample, ktorý nebude štandardne aktivovaný. Ak chcete aktivovať túto funkciu, zmeňte (0) za #if na (1).
Popis režimu spánku
- V ht32_TouchKey_conf.h vyberte PowerSave, aby ste povolili režimy spánku.
- Po aktivácii režimov spánku prejdú dotykové tlačidlá do režimu spánku, ak počas určitého časového obdobia nezaznamenali žiadne dotykové podmienky.
- Funkcia počítania času v pohotovostnom režime sa používa na odpočítavanie, aktuálny čas sa získava pomocou TKL_Get_Standby a parameter času sa nastavuje pomocou TKL_Set_Standby.
- K dispozícii sú tri možnosti režimu spánku.
Režim Popis USE_SLEEP_MODE Prejdite do režimu spánku USE_DEEP_SLEEP1_MODE Prejdite do režimu hlbokého spánku1 USE_DEEP_SLEEP2_MODE Prejdite do režimu hlbokého spánku2 - Ako je uvedené nižšie, nastavte požadovaný režim spánku pomocou „#define“ v hlavnom file.
Záver
Tento dokument obsahuje pokyny na nastavenie celého vývojového prostredia dotykových klávesov HT32, ktoré používateľom pomáhajú rýchlo začať. Okrem toho boli podrobne vysvetlené zdroje používané knižnicou, ako aj rôzne funkcie a parametre, čo umožňuje jednoduchší proces vývoja.
Referenčný materiál
Ďalšie podrobnosti nájdete v dokumente Holtek webmiesto: www.holtek.com alebo sa poraďte s najlepším riešením webmiesto: http://www.bestsolution.com.tw/EN/
Verzie a informácie o úpravách:
| Dátum | Autor | Uvoľnite | Popis |
| 2022.03.16 | 谢东霖、梁德浩 | V1.00 | Prvá verzia |
Vylúčenie zodpovednosti
Všetky informácie, ochranné známky, logá, grafika, videá, zvukové klipy, odkazy a ďalšie položky, ktoré sa tu objavujú webstránky (ďalej len „informácie“) sú len orientačné a môžu sa kedykoľvek zmeniť bez predchádzajúceho upozornenia a podľa uváženia spoločnosti Holtek Semiconductor Inc. a jej pridružených spoločností (ďalej len „Holtek“, „spoločnosť“, „nás“, „ my“ alebo „naše“). Zatiaľ čo Holtek sa snaží zabezpečiť presnosť informácií o tomto webSpoločnosť Holtek neposkytuje žiadnu výslovnú ani implicitnú záruku na presnosť informácií. Holtek nenesie žiadnu zodpovednosť za akúkoľvek nesprávnosť alebo únik.
Holtek nezodpovedá za žiadne škody (vrátane, ale nie výlučne, počítačového vírusu, systémových problémov alebo straty údajov), bez ohľadu na to, ktoré vzniknú pri používaní alebo v súvislosti s používaním tohto webstránky ktorejkoľvek strany. V tejto oblasti môžu byť odkazy, ktoré vám umožňujú navštíviť stránku webstránky iných spoločností. Títo webstránky nie sú kontrolované spoločnosťou Holtek. Holtek nenesie žiadnu zodpovednosť a žiadnu záruku za akékoľvek informácie zobrazené na takýchto stránkach. Hypertextové odkazy na iné webstránky sú na vlastné riziko.
Obmedzenie zodpovednosti
Holtek Limited v žiadnom prípade nezodpovedá žiadnej inej strane za akúkoľvek stratu alebo škodu spôsobenú priamo alebo nepriamo v súvislosti s vaším prístupom alebo používaním tohto webstránku, jej obsah alebo akýkoľvek tovar, materiály alebo služby.
Rozhodujúce právo
Vyhlásenie uvedené v webstránky sa riadia a interpretujú v súlade so zákonmi Čínskej republiky. Používatelia budú podliehať nevýhradnej jurisdikcii súdov Čínskej republiky.
Aktualizácia Vylúčenia zodpovednosti
Holtek si vyhradzuje právo aktualizovať Vyhlásenie kedykoľvek s predchádzajúcim upozornením alebo bez neho, všetky zmeny sú účinné okamžite po zverejnení na webstránky.
Dokumenty / zdroje
 |
Knižnica dotykových klávesov Holtek HT32 MCU [pdf] Používateľská príručka HT32, Knižnica dotykových tlačidiel MCU, Knižnica dotykových tlačidiel HT32 MCU |
