Knihovna dotykových kláves Holtek HT32 MCU
Zavedení
Knihovna dotykových kláves HT32 vyvinutá společností Best Solution je knihovna, která integruje do MCU veškerou základní knihovnu ovladačů dotykových kláves. files. Knihovna předkonfigurovala hardware MCU související s dotykem a poskytuje intuitivní a flexibilní nastavení citlivosti dotykové klávesy a zároveň integruje běžné funkce, jako je detekce kláves a úsporné režimy spánku. Použití knihovny dotykových kláves HT32 zjednodušuje používání dotykových funkcí MCU, umožňuje uživatelům rychle začít a zkracuje dobu vývoje. Tento dokument podrobně popisuje konfiguraci prostředí a použití knihovny.
Konfigurace prostředí
Získejte knihovnu dotykových kláves HT32
Kontaktujte FAE společnosti Best Solution nebo se obraťte na její webmísto: http://www.bestsolution.com.tw/EN/
Nebo si stáhněte knihovnu z Holteku webmísto: https://www.holtek.com
Získejte knihovnu firmwaru HT32
Chcete-li rychle získat knihovnu firmwaru, použijte následující odkaz: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Otevřete odkaz, vyberte možnost Dokumenty, jak je znázorněno na obrázku 1, kde červený rámeček označuje umístění komprimovaného souboru HT32 files. Všimněte si, že pouze knihovna firmwaru verze v022 nebo vyšší podporuje knihovnu dotykových kláves HT32.
Konfigurace projektu Keil
- V počítači uživatele musí být nainstalován vývojový nástroj Keil.
- Rozbalte knihovnu firmwaru. The files jsou uvedeny podle obrázku 2. Klepnutím na Holtek.HT32_DFP.latest jej nainstalujete, poté se zobrazí obrazovka dokončení instalace, jak je znázorněno na obrázku 3.
- Rozbalte knihovnu dotykových kláves HT32, která obsahuje dvě složky, napřample a knihovna.
- Zkopírujte example a složky knihovny do složky HT32_STD_xxxxx_FWLib_v022_XXXX.
- Spustit ..\example\TouchKey\TouchKey_LIB\_CreateProject.bat (obrázek 6).
- Zobrazí se rozhraní, jak je znázorněno na obrázku 7. Zadejte číslo odpovídající uživatelskému IDE, po kterém se před vybraným IDE objeví znak „*“, jak je znázorněno na obrázku 8. Zadejte „N“ pro přechod k dalšímu kroku.
- Jak je znázorněno níže, zadejte „*“ pro vytvoření projektů pro všechny typy IC nebo zadejte název IC pro vytvoření projektu pro vybraný IC.
- Po dokončení kroků 1~7, jak je znázorněno na obrázku 11, vyberte požadovaný projekt IC, například Project_54xxx.uvprojx z ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\ cesta.
Poznámka že k vytvoření projektu je použit pouze MCU s největšími zdroji v každé sérii. NapřampAby uživatelé mohli používat HT32F54231, musí vybrat projekt HT32F54241.
Úvahy
Vzhledem k tomu, že program dotykové klávesy může přejít do režimu spánku, je nutné nastavit projekt na resetování při zapnutí, jinak nebude k dispozici pro programování. Kroky nastavení jsou následující.
- Krok 1: Klikněte na tlačítko v nabídce nástroje Keil5, jak je znázorněno níže.
- Krok 2: Vyberte Ladění–> Nastavení.
- Krok 3: Vyberte „pod Reset“ v poli Connect.
Knihovna Files Popis
Použité zdroje knihovny
| Projekt Keil | Použitelný IC | ROM/RAM Zdroje | Použitá IP | Max. Počet klíčů |
| HT32F54241 | HT32F54241 HT32F54231 | 7148B/2256B | Dotyková klávesa
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140B/2528B | Dotykové tlačítko BFTM0
RTC |
28 |
- RTC se používá k probuzení MCU ze stavu spánku a používá se jako časová základna pro zpracování stavu spánku.
- Když je program nahrán do IC, Keil určí, zda byla překročena velikost ROM nebo RAM.
- Konkrétní použití zdrojů naleznete ve skutečné verzi knihovny.
Životní prostředí a File Popis
Knihovna dotykových kláves HT32 se nachází v následující cestě. ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx projekt (obrázek 15). Po otevření projektu knihovny dotykových kláves HT32 se hlavní obrazovka zobrazí jako Obrázek 16.
Relevantní files jsou popsány následovně, mezi které patří ht32_TouchKey_conf.ha system_ht32f5xxxx_09.c files, který je součástí Průvodce konfigurací. Viz obrázek 17.
| File Jméno | Popis |
| hlavní.c | Hlavní program projektu file |
| ht32f5xxxx_01_it.c | Přerušit hlavní program file |
| ht32_TouchKey_Lib_Mx_Keil.lib | Knihovna dotykového ovládání file |
| *ht32_TouchKey_conf.h | Parametr dotykového ovládání file |
| ht32_TouchKey.h | Definice externí deklarace file |
| ht32_TouchKey_BSconf.h | Podkladový hlavní parametr file (nedoporučuje se upravovat) |
| ht32_board_config.h | Definice hardwaru file (nedoporučuje se upravovat) |
| *system_ht32f5xxxx_09.c | Zdroj hodin a parametr systémových hodin file |
Parametry průvodce konfigurací
- ht32_TouchKey_conf.h Parametry průvodce konfigurací:
Jméno Funkce PowerSave Aktivujte výchozí proceduru spánku definovanou v main.c TKL_HighSensitive Nastavení citlivosti dotyku: vysoká nebo nízká citlivost; výchozí na vysokou citlivost po aktivaci TKL_keyDebounce Nastavení doby odskoku kláves TKL_RefCalTime Doba kalibrace. Čím kratší čas, tím účinnější bude odolávat vlivům prostředí, ale bude mít za následek nižší citlivosti klíčů. TKL_MaxOnHoldTime Maximální doba stisknutí tlačítka. Tlačítko se automaticky uvolní po stisknutí na n sekund. KEYn_EN Povolit nebo zakázat KEYn KeynThreshold Prahová hodnota KEYn. Čím menší hodnota, tím citlivější bude klíč. - system_ht32f5xxxx_09.c Parametry průvodce konfigurací:
Jméno Funkce Povolit vysokorychlostní externí krystalový oscilátor – HSE Povolit nebo zakázat HSE (externí vysokorychlostní oscilátor) Povolit nízkorychlostní externí krystalový oscilátor – LSE Povolit nebo zakázat LSE (externí nízkorychlostní oscilátor) Povolit PLL Povolit nebo zakázat PLL Zdroj hodin PLL Vyberte zdroj hodin pro PLL SystemCoreClockConfiguration (CK_AHB) Vyberte zdroj hodin pro systém CK_AHB
Popis funkcí rozhraní Touch Key Lib
Popis funkcí Get
| Položka | Popis |
| Název funkce | TKL_Get_Standby |
| Vstupní parametr | — |
| Návratová hodnota | Hodnota počítání (500~60000) |
| Popis | Slouží k získání hodnoty odpočítávaného čítače |
| Položka | Popis |
| Název funkce | TKL_Get_KeyRCCValue |
| Vstupní parametr | Hodnota klíče (0 ~ max. hodnota klíče), frekvence (0, 1) |
| Návratová hodnota | Hodnota kapacity (0~1023) |
| Popis | Slouží k získání hodnoty kapacity zadaného klíče |
| Položka | Popis |
| Název funkce | TKL_GetKeyRef |
| Vstupní parametr | Hodnota klíče (0 ~ max. hodnota klíče) |
| Návratová hodnota | Referenční hodnota (0~65535) |
| Popis | Slouží k získání referenční hodnoty zadaného klíče |
| Položka | Popis |
| Název funkce | TKL_GetKeyThreshold |
| Vstupní parametr | Hodnota klíče (0 ~ max. hodnota klíče) |
| Návratová hodnota | Prahová hodnota (0~255) |
| Popis | Používá se k získání prahové hodnoty zadaného klíče |
| Položka | Popis |
| Název funkce | TKL_Get_AllKeyState |
| Vstupní parametr | — |
| Návratová hodnota | Stav klíče (32bitový)
BITn znamená stav KEYn Bit0 = 1 znamená, že bylo stisknuto KEY0, Bit0 = 0 znamená, že nebylo stisknuto KEY0 |
| Popis | Používá se k získání všech klíčových stavů |
Popis nastavených funkcí
| Položka | Popis |
| Název funkce | TKL_Set_KeyThreshold |
| Vstupní parametr | Hodnota klíče (0 ~ max. hodnota klíče), prahová hodnota (10~127) |
| Návratová hodnota | — |
| Popis | Slouží k nastavení prahové hodnoty zadaného klíče |
| Položka | Popis |
| Název funkce | TKL_Set_Standby |
| Vstupní parametr | Doba spánku (500~60000) |
| Návratová hodnota | — |
| Popis | Používá se k nastavení odpočítávacího počítadla (nedoporučuje se používat tuto funkci) |
Popis stavových a příkazových funkcí
| Položka | Popis |
| Název funkce | TKL_Is_Time |
| Vstupní parametr | Přednastavená konstanta (kT2mS, kT4mS…kT2048mS) |
| Návratová hodnota | — |
| Popis | Časový příznak pro uživatelskou referenci.
V následujícím example, program vstoupí do funkce každé 2 ms. |
| Položka | Popis |
| Název funkce | TKL_Is_AnyKeyPress |
| Vstupní parametr | — |
| Návratová hodnota | 1 = byla aktivována jedna nebo více kláves; 0 = nebyla spuštěna žádná klávesa |
| Popis | Používá se k získání příznaku stisknutí klávesy |
| Položka | Popis |
| Název funkce | TKL_Is_KeyPress |
| Vstupní parametr | Hodnota klíče (0 ~ max. hodnota klíče) |
| Návratová hodnota | 1 = bylo aktivováno tlačítko; 0 = tlačítko nebylo spuštěno |
| Popis | Slouží k získání státního příznaku zadaného klíče |
| Položka | Popis |
| Název funkce | TKL_Is_Active |
| Vstupní parametr | — |
| Návratová hodnota | 1 = inicializace LIB byla dokončena; 0 = Inicializace LIB nebyla dokončena |
| Popis | Používá se k získání příznaku stavu inicializace LIB |
| Položka | Popis |
| Název funkce | TKL_Is_Standby |
| Vstupní parametr | — |
| Návratová hodnota | 1 = povolen přechod do režimu spánku; 0 = není povolen přechod do režimu spánku |
| Popis | Používá se k získání příznaku stavu spánku.
*Pokud je vrácena hodnota 0, může přechod do režimu spánku vést k neočekávanému stavu. |
| Položka | Popis |
| Název funkce | TKL_Is_KeyScanCycle |
| Vstupní parametr | — |
| Návratová hodnota | 1 = skenování skončilo; 0 = právě probíhá skenování |
| Popis | Slouží k získání příznaku skenování |
| Položka | Popis |
| Název funkce | TKL_Reset |
| Vstupní parametr | — |
| Návratová hodnota | — |
| Popis | Používá se k přinucení LIB k provedení resetovací akce.
*Příznaky používané LIB a RAM budou inicializovány. *Parametry a AFIO jsou vyloučeny. |
Popis funkcí inicializace Touch Key Lib
Tyto funkce jsou umístěny v main.c. Nedoporučuje se upravovat jejich obsah.
| Jméno | Funkce |
| GPIO_Configuration() | Konfigurace I/O portů |
| RTC_Configuration() | Dotykové klávesy probouzí RTC |
| BFTM_Configuration() | Časové základny knihovny dotykových kláves jsou implementovány BFTM |
| TKL_Configuration() | Konfigurace dotykových kláves |
Dotaz na stav klíče
Jak je znázorněno níže, hlavní program obsahuje dotykové tlačítko example, který nebude standardně aktivován. Pro aktivaci této funkce změňte (0) za #if na (1).
Popis režimu spánku
- V ht32_TouchKey_conf.h vyberte PowerSave a povolte režimy spánku.
- Po aktivaci režimů spánku přejdou dotykové klávesy do stavu spánku, pokud po určitou dobu nedojde k žádným dotykovým podmínkám.
- Pro odpočítávání se používá funkce počítání času v pohotovostním režimu, aktuální čas se získává pomocí TKL_Get_Standby a parametr času se nastavuje pomocí TKL_Set_Standby.
- K dispozici jsou tři možnosti režimu spánku.
Režim Popis USE_SLEEP_MODE Vstupte do režimu spánku USE_DEEP_SLEEP1_MODE Vstupte do režimu hlubokého spánku1 USE_DEEP_SLEEP2_MODE Vstupte do režimu hlubokého spánku2 - Jak je uvedeno níže, nastavte požadovaný režim spánku pomocí „#define“ v hlavním okně file.
Závěr
Tento dokument obsahuje pokyny pro nastavení celého vývojového prostředí dotykové klávesy HT32, které uživatelům pomáhají rychle začít. Kromě toho byly podrobně vysvětleny zdroje používané knihovnou, stejně jako různé funkce a parametry, což umožňuje snazší proces vývoje.
Referenční materiál
Další podrobnosti najdete v Holteku webmísto: www.holtek.com nebo se obraťte na Nejlepší řešení webmísto: http://www.bestsolution.com.tw/EN/
Verze a informace o úpravách:
| Datum | Autor | Uvolnění | Popis |
| 2022.03.16 | 谢东霖、梁德浩 | V1.00 | První verze |
Zřeknutí se odpovědnosti
Všechny informace, ochranné známky, loga, grafika, videa, zvukové klipy, odkazy a další položky, které se zde objevují webstránky („Informace“) jsou pouze orientační a mohou se kdykoli změnit bez předchozího upozornění a podle uvážení společnosti Holtek Semiconductor Inc. a jejích spřízněných společností (dále jen „Holtek“, „společnost“, „nás“, „ my" nebo "naše"). Zatímco Holtek se snaží zajistit přesnost těchto informací webSpolečnost Holtek neposkytuje žádnou výslovnou ani předpokládanou záruku na přesnost informací. Holtek nenese žádnou odpovědnost za jakoukoli nesprávnost nebo únik.
Holtek nebude odpovědný za žádné škody (včetně, ale nejen, počítačových virů, systémových problémů nebo ztráty dat), ať už vzniknou při používání nebo v souvislosti s používáním tohoto webstránky jakékoli strany. V této oblasti mohou být odkazy, které vám umožní navštívit webstránky jiných společností. Tyto webstránky nejsou kontrolovány společností Holtek. Holtek nenese žádnou odpovědnost a žádnou záruku za jakékoli informace zobrazené na takových stránkách. Hypertextové odkazy na jiné webstránky jsou na vlastní nebezpečí.
Omezení odpovědnosti
Společnost Holtek Limited v žádném případě nenese odpovědnost vůči žádné jiné straně za jakoukoli ztrátu nebo škodu způsobenou přímo či nepřímo v souvislosti s vaším přístupem k tomuto nebo jeho používáním. webstránky, obsah na nich nebo jakékoli zboží, materiály nebo služby.
Rozhodné právo
Vyloučení odpovědnosti obsažené v webstránky se řídí a vykládají v souladu se zákony Čínské republiky. Uživatelé se podřídí nevýhradní jurisdikci soudů Čínské republiky.
Aktualizace prohlášení o vyloučení odpovědnosti
Holtek si vyhrazuje právo kdykoli aktualizovat prohlášení o vyloučení odpovědnosti s předchozím upozorněním nebo bez něj, všechny změny jsou účinné okamžitě po zveřejnění na webmísto.
Dokumenty / zdroje
 |
Knihovna dotykových kláves Holtek HT32 MCU [pdfUživatelská příručka HT32, Knihovna dotykových kláves MCU, Knihovna dotykových kláves HT32 MCU |
