Holtek HT32 MCU Touch Key Library
Enkonduko
La HT32-tuŝŝlosila biblioteko evoluigita fare de Best Solution estas biblioteko kiu integras en la MCU ĉion el la tuŝŝlosilo subesta ŝoforbiblioteko. files. La biblioteko antaŭ-agordis la tuŝo-rilatan MCU-aparaton, kaj disponigas intuiciajn kaj flekseblajn tuŝajn klavajn sentemajn agordojn, dum ĝi integras komunajn funkciojn kiel ŝlosila detekto kaj energiŝparaj dormreĝimoj. Uzi la HT32-tuŝŝlosilbibliotekon simpligas la uzon de la MCU-tuŝfunkcioj, permesante al uzantoj komenci rapide kaj reduktante la evoluperiodon. Ĉi tiu dokumento priskribos detale la median agordon kaj bibliotekan uzadon.
Media Agordo
Akiru HT32 Touch Key Library
Kontaktu FAE de Best Solution aŭ referu ĝin webretejo: http://www.bestsolution.com.tw/EN/
Aŭ elŝutu la bibliotekon de la Holtek webretejo: https://www.holtek.com
Akiru HT32 Firmware Library
Vidu al la sekva ligo por rapide akiri la firmware-bibliotekon: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Malfermu la ligilon, elektu la opcion Dokumentoj kiel montrite en Figuro 1, kie la ruĝa skatolo indikas la lokon de la kunpremita HT32. files. Notu, ke nur la firmware-biblioteko de versio v022 aŭ pli subtenas la HT32-tuŝŝlosilbibliotekon.
Keil Projekta Agordo
- La komputilo de la uzanto bezonas instali la disvolvan ilon Keil.
- Malfermu la firmware-bibliotekon. La files estas listigitaj kiel montrite en Figuro 2. Alklaku Holtek.HT32_DFP.latest por instali ĝin, post kio aperos la instalaĵkompletiga ekrano, kiel montrita en Figuro 3.
- Malfermu la HT32-tuŝŝlosilbibliotekon kiu inkluzivas du dosierujojn, ekzample kaj biblioteko.
- Kopiu la eksample kaj bibliotekaj dosierujoj al la dosierujo HT32_STD_xxxxx_FWLib_v022_XXXX.
- Efektivigu ..\ekzample\TouchKey\TouchKey_LIB\_CreateProject.bat (Figuro 6).
- Interfaco, kiel montrita en Figuro 7, aperos. Enigu la numeron respondan al la IDE de la uzanto, post kio aperos signo “*” antaŭ la elektita IDE, kiel montrite en Figuro 8. Enigu “N” por iri al la sekva paŝo.
- Kiel montrite sube, enigu "*" por krei projektojn por ĉiuj IC-tipoj aŭ enigu la IC-nomon por krei projekton por la elektita IC.
- Post fini la paŝojn 1~7, kiel montrite en Figuro 11, elektu la deziratan IC-projekton kiel Project_54xxx.uvprojx el la ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\ vojo.
Notu ke nur la MCU kun la plej grandaj resursoj en ĉiu serio estas uzata por krei la projekton. Por ekzample, por uzi la HT32F54231 uzantoj devas elekti la HT32F54241 projekto.
Konsideroj
Ĉar la tuŝŝlosila programo povas eniri la dorman staton, necesas agordi la projekton por funkciigi rekomencigi, alie ĝi ne estos disponebla por programado. La agordaj paŝoj estas kiel sekvas.
- Paŝo 1: Alklaku la butonon en la ilo-menuo de Keil5, kiel montrite sube.
- Paŝo 2: Elektu Sencimigi–> Agordoj.
- Paŝo 3: Elektu "sub Restarigi" en la kampo Konekti.
Biblioteko Files Priskribo
Biblioteko Uzitaj Rimedoj
| Keil Projekto | Uzebla IC | ROM/RAM Rimedoj | Uzita IP | Maks. Nombro de Ŝlosiloj |
| HT32F54241 | HT32F54241 HT32F54231 | 7148B/2256B | Tuŝklavo
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140B/2528B | Tuŝklavo BFTM0
RTC |
28 |
- La RTC estas uzata por veki MCU de la dorma stato kaj uzata kiel tempobazo por dorma stato-prilaborado.
- Kiam la programo estas ŝarĝita en la IC, la Keil determinos ĉu la grandeco de ROM aŭ RAM estas superita.
- Por la specifa uzo de rimedoj, raportu al la fakta bibliotekversio.
Medio kaj File Priskribo
La biblioteko de tuŝŝlosilo HT32 situas en la sekva vojo. ..\ekzample\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx projekto (Figuro15). Post kiam la HT32-tuŝŝlosila biblioteko projekto estas malfermita, la ĉefa ekrano estas montrita kiel Figuro 16.
La koncerna files estas priskribitaj jene, inter kiuj estas la ht32_TouchKey_conf.h kaj system_ht32f5xxxx_09.c files, inkluzivita en la Agordo de Agordo. Vidu figuron 17.
| File Nomo | Priskribo |
| ĉefa.c | Projekta ĉefa programo file |
| ht32f5xxxx_01_it.c | Interrompi ĉefan programon file |
| ht32_TouchKey_Lib_Mx_Keil.lib | Tuŝkontrola biblioteko file |
| *ht32_TouchKey_conf.h | Tuŝkontrola parametro file |
| ht32_TouchKey.h | Difino de ekstera deklaro file |
| ht32_TouchKey_BSconf.h | Subesta ĉefa parametro file (ne rekomendita modifi) |
| ht32_board_config.h | Difino de aparataro file (ne rekomendita modifi) |
| *system_ht32f5xxxx_09.c | Horloĝfonto kaj sistema horloĝparametro file |
Parametroj de la Sorĉisto de Agordo
- ht32_TouchKey_conf.h Parametroj de la Sorĉisto de Agordo:
Nomo Funkcio Energioŝparo Aktivigu la defaŭltan dormproceduron difinitan en main.c TKL_HighSensitive Agordo de tuŝo-sentemo: alta aŭ malalta sentemo; defaŭlte al alta sentemo post esti ebligita TKL_keyDebounce Ŝlosila debota tempo-agordo TKL_RefCalTime Kalibrado tempo. Ju pli mallonga la tempo, des pli efika ĝi estos por rezisti median interferon, tamen ĝi rezultigos pli malaltajn ŝlosilajn sentemojn. TKL_MaxOnHoldTime La maksimuma tempo, kiam la klavo estas premata. La klavo estas aŭtomate liberigita post premo dum n sekundoj. KEYn_EN Ebligu aŭ malŝalti KEYn KeynThreshold KEYn sojla valoro. Ju pli malgranda la valoro, des pli sentema estos la ŝlosilo. - system_ht32f5xxxx_09.c Parametroj de la Agordisto:
Nomo Funkcio Ebligu Alta Rapidan Eksteran Kristalan Oscilatoron - HSE Ebligu aŭ malŝalti HSE (ekstera altrapida oscilatoro) Ebligu Malaltrapidan Eksteran Kristalan Oscilatoron - LSE Ebligi aŭ malŝalti LSE (ekstera malaltrapida oscilatoro) Ebligu PLL Ebligu aŭ malŝalti PLL PLL Horloĝo Fonto Elektu horloĝan fonton por PLL SystemCoreClockConfiguration (CK_AHB) Elektu horloĝfonton por sistemo CK_AHB
Priskribo de Touch Key Lib Interfaco-Funkcioj
Priskribo de Akiri Funkcioj
| Ero | Priskribo |
| Funkcia Nomo | TKL_Get_Standby |
| Eniga Parametro | — |
| Revena Valoro | Nombra valoro (500~60000) |
| Priskribo | Uzita por akiri la kalkulvaloron de kalkulilo |
| Ero | Priskribo |
| Funkcia Nomo | TKL_Get_KeyRCCValue |
| Eniga Parametro | Ŝlosilvaloro (0 ~ maksimuma ŝlosilvaloro), ofteco (0, 1) |
| Revena Valoro | Kapacitan valoro (0~1023) |
| Priskribo | Uzita por akiri la kapacitan valoron de la specifita ŝlosilo |
| Ero | Priskribo |
| Funkcia Nomo | TKL_GetKeyRef |
| Eniga Parametro | Ŝlosilvaloro (0 ~ maksimuma ŝlosilvaloro) |
| Revena Valoro | Referenca valoro (0~65535) |
| Priskribo | Uzita por akiri la referencan valoron de la specifita ŝlosilo |
| Ero | Priskribo |
| Funkcia Nomo | TKL_GetKeyThreshold |
| Eniga Parametro | Ŝlosilvaloro (0 ~ maksimuma ŝlosilvaloro) |
| Revena Valoro | Sojla valoro (0~255) |
| Priskribo | Uzita por akiri la sojlan valoron de la specifita ŝlosilo |
| Ero | Priskribo |
| Funkcia Nomo | TKL_Get_AllKeyState |
| Eniga Parametro | — |
| Revena Valoro | Ŝlosila stato (32-bita)
BITn signifas KEYn-ŝtato Bit0 = 1 signifas ke KEY0 estas premita, Bit0 = 0 signifas ke KEY0 ne estas premita |
| Priskribo | Uzita por akiri ĉiujn ŝlosilajn ŝtatojn |
Priskribo de Aro-Funkcioj
| Ero | Priskribo |
| Funkcia Nomo | TKL_Set_KeyThreshold |
| Eniga Parametro | Ŝlosilvaloro (0 ~ maksimuma ŝlosilvaloro), sojla valoro (10~127) |
| Revena Valoro | — |
| Priskribo | Uzita por agordi la sojlan valoron de la specifita ŝlosilo |
| Ero | Priskribo |
| Funkcia Nomo | TKL_Set_Standby |
| Eniga Parametro | Dorma tempo (500~60000) |
| Revena Valoro | — |
| Priskribo | Uzita por agordi la retronombradon (ne rekomendita uzi ĉi tiun funkcion) |
Priskribo de Ŝtataj kaj Komandaj Funkcioj
| Ero | Priskribo |
| Funkcia Nomo | TKL_Estas_Tempo |
| Eniga Parametro | Antaŭdifinita konstanto (kT2mS, kT4mS...kT2048mS) |
| Revena Valoro | — |
| Priskribo | Tempoflago por uzantreferenco.
En la sekva ekzample, la programo eniras la funkcion ĉiun 2ms. |
| Ero | Priskribo |
| Funkcia Nomo | TKL_Is_AnyKeyPress |
| Eniga Parametro | — |
| Revena Valoro | 1 = unu aŭ pluraj klavoj estis ekigitaj; 0 = neniu ŝlosilo estis ekigita |
| Priskribo | Uzita por akiri la klavpremflagon |
| Ero | Priskribo |
| Funkcia Nomo | TKL_Is_KeyPress |
| Eniga Parametro | Ŝlosilvaloro (0 ~ maksimuma ŝlosilvaloro) |
| Revena Valoro | 1 = klavo estis ekigita; 0 = ŝlosilo ne estis ekigita |
| Priskribo | Uzita por akiri la ŝtatflagon de la specifita ŝlosilo |
| Ero | Priskribo |
| Funkcia Nomo | TKL_Estas_Aktiva |
| Eniga Parametro | — |
| Revena Valoro | 1 = LIB-komencigo finiĝis; 0 = LIB-komencigo ne finiĝis |
| Priskribo | Uzita por akiri la LIB-pracigan ŝtatflagon |
| Ero | Priskribo |
| Funkcia Nomo | TKL_Is_Standby |
| Eniga Parametro | — |
| Revena Valoro | 1 = permesite eniri dorman staton; 0 = ne rajtas eniri dorman staton |
| Priskribo | Uzita por akiri la dormŝtatan flagon.
*Kiam valoro de 0 estas resendita, tiam eniri la dorman staton povas rezultigi neatenditan staton. |
| Ero | Priskribo |
| Funkcia Nomo | TKL_Is_KeyScanCycle |
| Eniga Parametro | — |
| Revena Valoro | 1 = skanado finiĝis; 0 = nun skananta |
| Priskribo | Uzita por akiri la skanan flagon |
| Ero | Priskribo |
| Funkcia Nomo | TKL_Restarigi |
| Eniga Parametro | — |
| Revena Valoro | — |
| Priskribo | Uzita por devigi LIB efektivigi rekomencigitan agon.
*Flagoj uzataj de LIB kaj RAM estos pravigitaj. *Parametroj kaj AFIO estas ekskluditaj. |
Priskribo de Touch Key Lib Inicialigaj Funkcioj
Tiuj ĉi funkcioj troviĝas en main.c. Ne rekomendas modifi ilian enhavon.
| Nomo | Funkcio |
| GPIO_Agordo() | I/O-pordaj agordoj |
| RTC_Agordo() | Tuŝklavoj estas vekitaj de la RTC |
| BFTM_Agordo() | Tuŝŝlosilbibliotekaj tempobazoj estas efektivigitaj fare de BFTM |
| TKL_Agordo() | Tuŝklavaj agordoj |
Ŝlosila Ŝtata Demando
Kiel montrite sube, la ĉefa programo inkluzivas tuŝklavon ekzample kiu ne estos aktivigita defaŭlte. Por aktivigi ĉi tiun funkcion, modifi (0) post #if al (1).
Priskribo de dormreĝimo
- En ht32_TouchKey_conf.h, elektu PowerSave por ebligi la dormreĝimojn.
- Post kiam la dormreĝimoj estas ebligitaj, la tuŝaj klavoj eniros la dorman staton se la klavoj ne spertis iujn ajn tuŝajn kondiĉojn dum certa tempodaŭro.
- Standby-tempokalkula funkcio estas uzata por malpliigo, la nuna tempo estas akirita per TKL_Get_Standby kaj la tempo-parametro estas agordita per TKL_Set_Standby.
- Estas tri opcioj de dormreĝimo.
Reĝimo Priskribo USE_SLEEP_MODE Eniri Dorman reĝimon USE_DEEP_SLEEP1_MODE Eniru Deep Sleep1 Reĝimon USE_DEEP_SLEEP2_MODE Eniru Deep Sleep2 Reĝimon - Kiel montrite sube, agordu la bezonatan dormreĝimon uzante "#define" en la ĉefa file.
Konkludo
Ĉi tiu dokumento disponigis instrukciojn por agordi la tutan disvolvan medion de tuŝŝlosilo HT32, helpante uzantojn komenci rapide. Krome, la rimedoj uzataj de la biblioteko, same kiel diversaj funkcioj kaj parametroj, estis detale klarigitaj, ebligante pli facilan evoluprocezon.
Referenca Materialo
Por pliaj detaloj, raportu al la Holtek webretejo: www.holtek.com aŭ konsultu la Plej bonan Solvon webretejo: http://www.bestsolution.com.tw/EN/
Informoj pri Versioj kaj Modifoj:
| Dato | Aŭtoro | Liberigu | Priskribo |
| 2022.03.16 | 谢东霖、梁德浩 | V1.00 | Unua versio |
Malgarantio
Ĉiuj informoj, varmarkoj, emblemoj, grafikaĵoj, filmetoj, aŭdklipoj, ligiloj kaj aliaj aĵoj aperantaj sur ĉi tiu webretejo ("Informo") estas nur por referenco kaj estas ŝanĝita en ajna momento sen antaŭa avizo kaj laŭ la bontrovo de Holtek Semiconductor Inc. kaj ĝiaj rilataj kompanioj (ĉi-poste "Holtek", "la kompanio", "ni", "ni"). ni' aŭ 'nia'). Dum Holtek klopodas certigi la precizecon de la Informoj pri ĉi tio webretejo, neniu eksplicita aŭ implicita garantio estas donita de Holtek pri la precizeco de la Informoj. Holtek ne havos respondecon pri ia malĝustaĵo aŭ elfluado.
Holtek ne respondecos pri ajnaj damaĝoj (inkluzive sed ne limigitaj al komputila viruso, sistemaj problemoj aŭ datumperdo) ia ajn okazanta dum uzado aŭ lige kun la uzo de ĉi tiu. webretejo de iu ajn partio. Eble ekzistas ligiloj en ĉi tiu areo, kiuj permesas vin viziti la webretejoj de aliaj kompanioj. Ĉi tiuj webretejoj ne estas kontrolitaj de Holtek. Holtek ne havos respondecon kaj neniun garantion pri ajnaj Informoj montrataj ĉe tiaj retejoj. Hiperligiloj al aliaj webretejoj estas je via propra risko.
Limigo de Respondeco
En neniu okazo Holtek Limited estos respondeca al iu ajn alia partio pro ia ajn perdo aŭ damaĝo aŭ ia ajn kaŭzita rekte aŭ nerekte lige kun via aliro aŭ uzo de ĉi tiu. webretejo, la enhavo sur ĝi aŭ ajnaj varoj, materialoj aŭ servoj.
Reganta Juro
La Malgarantio enhavita en la webretejo estos regata de kaj interpretita laŭ la leĝoj de la Respubliko Ĉinio. Uzantoj submetiĝos al la ne-ekskluziva jurisdikcio de la tribunaloj de la Respubliko Ĉinio.
Ĝisdatigo de Malgarantio
Holtek rezervas la rajton ĝisdatigi la Malgarantion en ajna momento kun aŭ sen antaŭa avizo, ĉiuj ŝanĝoj efektiviĝas tuj post afiŝado al la webretejo.
Dokumentoj/Rimedoj
 |
Holtek HT32 MCU Touch Key Library [pdf] Uzantogvidilo HT32, MCU Touch Key Library, HT32 MCU Touch Key Library |
