Бібліятэка сэнсарных клавіш Holtek HT32 MCU
Уводзіны
Бібліятэка сэнсарных клавіш HT32, распрацаваная Best Solution, - гэта бібліятэка, якая аб'ядноўвае ў MCU ўсю базавую бібліятэку драйвераў сэнсарных клавіш fileс. Бібліятэка папярэдне сканфігуравала апаратнае забеспячэнне MCU, звязанае з дакрананнем, і забяспечвае інтуітыўна зразумелыя і гнуткія налады адчувальнасці да сэнсарных клавіш, інтэгруючы агульныя функцыі, такія як выяўленне клавіш і энергазберагальныя рэжымы сну. Выкарыстанне бібліятэкі сэнсарных клавіш HT32 спрашчае выкарыстанне сэнсарных функцый MCU, дазваляючы карыстальнікам хутка пачаць працу і скарачаючы перыяд распрацоўкі. Гэты дакумент будзе падрабязна апісваць канфігурацыю асяроддзя і выкарыстанне бібліятэкі.
Канфігурацыя асяроддзя
Атрымайце бібліятэку сэнсарных клавіш HT32
Звяжыцеся з FAE Best Solution або звярніцеся да яго webсайт: http://www.bestsolution.com.tw/EN/
Ці спампаваць бібліятэку з Holtek webсайт: https://www.holtek.com
Атрымаць бібліятэку прашыўкі HT32
Перайдзіце па наступнай спасылцы, каб хутка атрымаць бібліятэку прашыўкі: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Адкрыйце спасылку, абярыце опцыю "Дакументы", як паказана на малюнку 1, дзе чырвонае поле паказвае месцазнаходжанне сціснутага HT32 fileс. Звярніце ўвагу, што толькі бібліятэка прашыўкі версіі v022 або вышэй падтрымлівае бібліятэку сэнсарных клавіш HT32.
Канфігурацыя праекта Keil
- На ПК карыстальніка павінен быць усталяваны інструмент распрацоўкі Keil.
- Распакуйце бібліятэку прашыўкі. The files пералічаны, як паказана на малюнку 2. Націсніце Holtek.HT32_DFP.latest, каб усталяваць яго, пасля чаго з'явіцца экран завяршэння ўстаноўкі, як паказана на малюнку 3.
- Распакуйце бібліятэку сэнсарных клавіш HT32, якая ўключае дзве папкі, напрampле і бібліятэкі.
- Скапіруйце выклampфайлы і бібліятэкі ў папку HT32_STD_xxxxx_FWLib_v022_XXXX.
- Выканаць ..\example\TouchKey\TouchKey_LIB\_CreateProject.bat (малюнак 6).
- З'явіцца інтэрфейс, як паказана на малюнку 7. Увядзіце нумар, які адпавядае IDE карыстальніка, пасля чаго перад абранай IDE з'явіцца знак «*», як паказана на малюнку 8. Увядзіце «N», каб перайсці да наступнага кроку.
- Як паказана ніжэй, увядзіце «*», каб стварыць праекты для ўсіх тыпаў IC, або ўвядзіце назву IC, каб стварыць праект для абранага IC.
- Пасля завяршэння крокаў 1~7, як паказана на малюнку 11, абярыце жаданы праект IC, напрыклад Project_54xxx.uvprojx з ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\ шлях.
Заўвага што для стварэння праекта выкарыстоўваецца толькі MCU з найбольшымі рэсурсамі ў кожнай серыі. Напрыкладample, каб выкарыстоўваць HT32F54231, карыстальнікі павінны выбраць праект HT32F54241.
Меркаванні
Паколькі праграма з сэнсарнымі клавішамі можа перайсці ў стан сну, неабходна наладзіць праект на скід пры ўключэнні, інакш ён будзе недаступны для праграмавання. Этапы налады наступныя.
- крок 1: Націсніце кнопку ў меню інструментаў Keil5, як паказана ніжэй.
- крок 2: Абярыце Адладка–> Налады.
- крок 3: Абярыце «пад Скід» у полі «Падключыць».
Бібліятэка Files Апісанне
Выкарыстоўваныя рэсурсы бібліятэкі
| Праект Keil | Карысная мікрасхема | ПЗУ/АЗП Рэсурсы | Выкарыстоўваецца IP | Макс. Колькасць ключоў |
| HT32F54241 | HT32F54241 HT32F54231 | 7148B / 2256B | Сэнсарная клавіша
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140B / 2528B | Сэнсарная клавіша BFTM0
RTC |
28 |
- RTC выкарыстоўваецца для выхаду MCU з рэжыму сну і ў якасці часовай базы для апрацоўкі стану сну.
- Калі праграма загружаецца ў мікрасхему, Keil вызначыць, перавышаны памер ПЗУ або АЗП.
- Для канкрэтнага выкарыстання рэсурсаў звярніцеся да актуальнай версіі бібліятэкі.
Навакольнае асяроддзе і File Апісанне
Бібліятэка сэнсарных клавіш HT32 знаходзіцца па наступным шляху. ..\напрampпраект le\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx (малюнак 15). Пасля адкрыцця праекта бібліятэкі сэнсарных клавіш HT32 галоўны экран паказаны на малюнку 16.
Актуальны fileапісаны наступным чынам, сярод якіх ht32_TouchKey_conf.h і system_ht32f5xxxx_09.c files, уключаны ў майстар канфігурацыі. Глядзіце малюнак 17.
| File Імя | Апісанне |
| галоўны.с | Асноўная праграма праекта file |
| ht32f5xxxx_01_it.c | Перапыненне асноўнай праграмы file |
| ht32_TouchKey_Lib_Mx_Keil.lib | Бібліятэка сэнсарнага кіравання file |
| *ht32_TouchKey_conf.h | Параметр сэнсарнага кіравання file |
| ht32_TouchKey.h | Вызначэнне вонкавай дэкларацыі file |
| ht32_TouchKey_BSconf.h | Асноўны асноўны параметр file (не рэкамендуецца змяняць) |
| ht32_board_config.h | Апаратнае вызначэнне file (не рэкамендуецца змяняць) |
| *system_ht32f5xxxx_09.c | Крыніца такта і параметр сістэмнага гадзінніка file |
Параметры майстра канфігурацыі
- Параметры майстра канфігурацыі ht32_TouchKey_conf.h:
Імя Функцыя энергазберажэнне Актывуйце стандартную працэдуру сну, вызначаную ў main.c TKL_HighSensitive Настройка адчувальнасці да дотыку: высокая або нізкая адчувальнасць; пасля ўключэння па змаўчанні ўстаноўлена высокая адчувальнасць TKL_keyDebounce Налада часу адбою ключа TKL_RefCalTime Час каліброўкі. Чым карацейшы час, тым больш эфектыўны ён будзе ў супрацьстаянні ўздзеянню навакольнага асяроддзя, аднак гэта прывядзе да зніжэння адчувальнасці клавіш. TKL_MaxOnHoldTime Максімальны час націскання клавішы. Клавіша аўтаматычна адпускаецца пасля націску на працягу n секунд. KEYn_EN Уключыць або выключыць KEYn KeynThreshold Парогавае значэнне KEYn. Чым меншае значэнне, тым больш адчувальным будзе ключ. - system_ht32f5xxxx_09.c Параметры майстра канфігурацыі:
Імя Функцыя Уключыць высакахуткасны знешні кварцавы генератар – HSE Уключыць або выключыць HSE (вонкавы высакахуткасны асцылятар) Уключыць нізкі хуткасны знешні кварцавы генератар - LSE Уключыць або выключыць LSE (знешні нізкахуткасны асцылятар) Уключыць PLL Уключыць або выключыць PLL Крыніца тактавага сігналу PLL Выберыце крыніцу тактавага сігналу для PLL SystemCoreClockConfiguration (CK_AHB) Выберыце крыніцу тактавага сігналу для сістэмы CK_AHB
Апісанне функцый інтэрфейсу Touch Key Lib
Апісанне функцыі атрымання
| Пункт | Апісанне |
| Назва функцыі | TKL_Get_Standby |
| Параметр ўводу | — |
| Вяртанае значэнне | Значэнне падліку (500~60000) |
| Апісанне | Выкарыстоўваецца для атрымання значэння лічыльніка зваротнага адліку |
| Пункт | Апісанне |
| Назва функцыі | TKL_Get_KeyRCCValue |
| Параметр ўводу | Значэнне ключа (0 ~ макс. значэнне ключа), частата (0, 1) |
| Вяртанае значэнне | Значэнне ёмістасці (0~1023) |
| Апісанне | Выкарыстоўваецца для атрымання значэння ёмістасці вызначанага ключа |
| Пункт | Апісанне |
| Назва функцыі | TKL_GetKeyRef |
| Параметр ўводу | Значэнне ключа (0 ~ макс. значэнне ключа) |
| Вяртанае значэнне | Даведачнае значэнне (0~65535) |
| Апісанне | Выкарыстоўваецца для атрымання эталоннага значэння вызначанага ключа |
| Пункт | Апісанне |
| Назва функцыі | TKL_GetKeyThreshold |
| Параметр ўводу | Значэнне ключа (0 ~ макс. значэнне ключа) |
| Вяртанае значэнне | Парогавае значэнне (0~255) |
| Апісанне | Выкарыстоўваецца для атрымання парогавага значэння вызначанага ключа |
| Пункт | Апісанне |
| Назва функцыі | TKL_Get_AllKeyState |
| Параметр ўводу | — |
| Вяртанае значэнне | Стан ключа (32-разрадны)
BITn азначае стан KEYn Bit0 = 1 азначае, што KEY0 націснута, Bit0 = 0 азначае, што KEY0 не націснута |
| Апісанне | Выкарыстоўваецца для атрымання ўсіх ключавых станаў |
Апісанне функцый набору
| Пункт | Апісанне |
| Назва функцыі | TKL_Set_KeyThreshold |
| Параметр ўводу | Значэнне ключа (0 ~ макс. значэнне ключа), парогавае значэнне (10~127) |
| Вяртанае значэнне | — |
| Апісанне | Выкарыстоўваецца для ўстаноўкі парогавага значэння вызначанага ключа |
| Пункт | Апісанне |
| Назва функцыі | TKL_Set_Standby |
| Параметр ўводу | Час сну (500~60000) |
| Вяртанае значэнне | — |
| Апісанне | Выкарыстоўваецца для ўстаноўкі лічыльніка зваротнага адліку (не рэкамендуецца выкарыстоўваць гэту функцыю) |
Апісанне дзяржаўных і камандных функцый
| Пункт | Апісанне |
| Назва функцыі | TKL_Гэта_Час |
| Параметр ўводу | Прадусталяваная пастаянная (kT2mS, kT4mS…kT2048mS) |
| Вяртанае значэнне | — |
| Апісанне | Сцяг часу для даведкі карыстальніка.
У наступным выпрample, праграма ўводзіць функцыю кожныя 2 мс. |
| Пункт | Апісанне |
| Назва функцыі | TKL_Is_AnyKeyPress |
| Параметр ўводу | — |
| Вяртанае значэнне | 1 = спрацаваў адзін або больш ключоў; 0 = ключ не быў запушчаны |
| Апісанне | Выкарыстоўваецца для атрымання сцяга націску клавішы |
| Пункт | Апісанне |
| Назва функцыі | TKL_Is_KeyPress |
| Параметр ўводу | Значэнне ключа (0 ~ макс. значэнне ключа) |
| Вяртанае значэнне | 1 = ключ быў запушчаны; 0 = ключ не быў запушчаны |
| Апісанне | Выкарыстоўваецца для атрымання сцяга стану вызначанага ключа |
| Пункт | Апісанне |
| Назва функцыі | TKL_Is_Active |
| Параметр ўводу | — |
| Вяртанае значэнне | 1 = ініцыялізацыя LIB скончана; 0 = Ініцыялізацыя LIB не скончана |
| Апісанне | Выкарыстоўваецца для атрымання сцяга стану ініцыялізацыі LIB |
| Пункт | Апісанне |
| Назва функцыі | TKL_Is_Standby |
| Параметр ўводу | — |
| Вяртанае значэнне | 1 = дазволены ўваход у стан сну; 0 = забаронены ўваход у стан сну |
| Апісанне | Выкарыстоўваецца для атрымання сцяга стану сну.
*Калі вяртаецца значэнне 0, то ўваход у рэжым сну можа прывесці да нечаканага стану. |
| Пункт | Апісанне |
| Назва функцыі | TKL_Is_KeyScanCycle |
| Параметр ўводу | — |
| Вяртанае значэнне | 1 = сканаванне скончана; 0 = зараз сканаванне |
| Апісанне | Выкарыстоўваецца для атрымання сцяга сканавання |
| Пункт | Апісанне |
| Назва функцыі | TKL_Скінуць |
| Параметр ўводу | — |
| Вяртанае значэнне | — |
| Апісанне | Выкарыстоўваецца, каб прымусіць LIB выканаць дзеянне скіду.
*Сцягі, якія выкарыстоўваюцца LIB і RAM, будуць ініцыялізаваны. *Параметры і AFIO выключаны. |
Апісанне функцый ініцыялізацыі Touch Key Lib
Гэтыя функцыі знаходзяцца ў main.c. Не рэкамендуецца змяняць іх змест.
| Імя | Функцыя |
| GPIO_Configuration() | Канфігурацыі партоў уводу-вываду |
| RTC_Configuration() | Сэнсарныя клавішы абуджаюцца RTC |
| BFTM_Configuration() | Базы часу бібліятэкі сэнсарных клавіш рэалізаваны BFTM |
| TKL_Configuration() | Канфігурацыі сэнсарных клавіш |
Запыт стану ключа
Як паказана ніжэй, асноўная праграма ўключае сэнсарную клавішу напрample, які не будзе актываваны па змаўчанні. Каб актываваць гэту функцыю, змяніце (0) пасля #if на (1).
Апісанне рэжыму сну
- У ht32_TouchKey_conf.h выберыце PowerSave, каб уключыць рэжымы сну.
- Пасля ўключэння рэжымаў сну сэнсарныя клавішы пяройдуць у стан сну, калі на працягу пэўнага перыяду часу да клавіш не дакраналіся.
- Функцыя падліку часу ў рэжыме чакання выкарыстоўваецца для адліку ўніз, бягучы час атрымліваецца з дапамогай TKL_Get_Standby, а параметр часу задаецца з дапамогай TKL_Set_Standby.
- Ёсць тры варыянты рэжыму сну.
Рэжым Апісанне USE_SLEEP_MODE Увайдзіце ў рэжым сну USE_DEEP_SLEEP1_MODE Увядзіце рэжым Deep Sleep1 USE_DEEP_SLEEP2_MODE Увядзіце рэжым Deep Sleep2 - Як паказана ніжэй, усталюйце неабходны рэжым сну, выкарыстоўваючы «#define» у галоўным file.
Заключэнне
Гэты дакумент змяшчае інструкцыі па наладжванні ўсяго асяроддзя распрацоўкі сэнсарных клавіш HT32, дапамагаючы карыстальнікам хутка пачаць працу. Акрамя таго, рэсурсы, якія выкарыстоўваюцца бібліятэкай, а таксама розныя функцыі і параметры былі падрабязна растлумачаны, што дазваляе палегчыць працэс распрацоўкі.
Даведачны матэрыял
Для атрымання дадатковай інфармацыі звярніцеся да Holtek webсайт: www.holtek.com або пракансультуйцеся з лепшым рашэннем webсайт: http://www.bestsolution.com.tw/EN/
Інфармацыя аб версіях і мадыфікацыях:
| Дата | Аўтар | Вызваленне | Апісанне |
| 2022.03.16 | 谢东霖、梁德浩 | V1.00 | Першая версія |
Адмова ад адказнасці
Уся інфармацыя, гандлёвыя маркі, лагатыпы, графіка, відэа, аўдыёкліпы, спасылкі і іншыя элементы, якія з'яўляюцца на гэтым webсайт ("Інфармацыя") прызначаны толькі для даведкі і могуць быць зменены ў любы час без папярэдняга паведамлення і па меркаванні Holtek Semiconductor Inc. і звязаных з ёй кампаній (далей "Holtek", "кампанія", "нас", " мы" або "наш"). У той час як Holtek імкнецца забяспечыць дакладнасць гэтай інфармацыі webсайта, Holtek не дае відавочных або пэўных гарантый на дакладнасць інфармацыі. Кампанія Holtek не нясе адказнасці за любыя памылкі або ўцечкі.
Holtek не нясе адказнасці ні за якія пашкоджанні (уключаючы, але не абмяжоўваючыся імі, камп'ютэрныя вірусы, сістэмныя праблемы або страту даных), якія б узніклі пры выкарыстанні або ў сувязі з выкарыстаннем гэтага webсайт любым бокам. У гэтай вобласці могуць быць спасылкі, якія дазваляюць наведаць webсайты іншых кампаній. Гэтыя webсайты не кантралююцца Holtek. Holtek не нясе ніякай адказнасці і гарантый за любую інфармацыю, якая адлюстроўваецца на такіх сайтах. Гіперспасылкі на інш webсайты на ваш страх і рызыка.
Абмежаванне адказнасці
Holtek Limited ні ў якім разе не нясе адказнасці перад любым іншым бокам за любыя страты або пашкоджанні, якія б ні былі выкліканыя прама ці ўскосна ў сувязі з вашым доступам да або выкарыстаннем гэтага webсайт, змесціва на ім або любыя тавары, матэрыялы або паслугі.
Прымяняльнае права
Адмова ад адказнасці, якая змяшчаецца ў webсайт рэгулюецца і тлумачыцца ў адпаведнасці з законамі Кітайскай Рэспублікі. Карыстальнікі будуць падпарадкоўвацца невыключнай юрысдыкцыі судоў Кітайскай Рэспублікі.
Абнаўленне адмовы ад адказнасці
Holtek пакідае за сабой права абнаўляць Адмову ад адказнасці ў любы час з папярэднім паведамленнем або без яго, усе змены ўступаюць у сілу неадкладна пасля публікацыі на webсайт.
Дакументы / Рэсурсы
 |
Бібліятэка сэнсарных клавіш Holtek HT32 MCU [pdfКіраўніцтва карыстальніка HT32, бібліятэка сэнсарных клавіш MCU, бібліятэка сэнсарных клавіш HT32 MCU |
