Китобхонаи калидҳои Holtek HT32 MCU Touch
Муқаддима
Китобхонаи калиди сенсории 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
Китобхонаи Firmware HT32-ро гиред
Барои зуд дастрас кардани китобхонаи нармафзор ба истиноди зерин муроҷиат кунед: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Истинодро кушоед, варианти Ҳуҷҷатҳоро тавре ки дар расми 1 нишон дода шудааст, интихоб кунед, ки дар он қуттии сурх ҷойгиршавии HT32 фишурдашударо нишон медиҳад. fileс. Дар хотир доред, ки танҳо китобхонаи нармафзори версияи v022 ё боло китобхонаи калидҳои сенсории HT32 -ро дастгирӣ мекунад.
Конфигуратсияи лоиҳаи Keil
- Дар компютери корбар бояд асбоби таҳияи Keil насб карда шавад.
- Китобхонаи нармафзорро кушоед. Дар fileҳо тавре ки дар расми 2 нишон дода шудааст, номбар шудаанд. Барои насб кардани он Holtek.HT32_DFP.latest -ро клик кунед, пас аз он экрани анҷоми насб, тавре ки дар расми 3 нишон дода шудааст, пайдо мешавад.
- Китобхонаи калиди сенсории HT32-ро кушоед, ки ду ҷузвдонро дар бар мегирад, масаланampле ва китобхона.
- Собиқро нусхабардорӣ кунедample ва ҷузвдонҳои китобхона ба ҷузвдони HT32_STD_xxxxx_FWLib_v022_XXXX.
- Иҷро кунед ..\масаланample\TouchKey\TouchKey_LIB\_CreateProject.bat (Расми 6).
- Интерфейс, ки дар расми 7 нишон дода шудааст, пайдо мешавад. Рақами мувофиқи IDE-и корбарро ворид кунед, ки пас аз он дар пеши IDE интихобшуда аломати "*" пайдо мешавад, тавре ки дар расми 8 нишон дода шудааст. Барои гузаштан ба қадами оянда "N" -ро ворид кунед.
- Тавре ки дар зер нишон дода шудааст, "*" -ро ворид кунед, то лоиҳаҳо барои ҳама намудҳои IC эҷод кунед ё номи IC-ро ворид кунед, то лоиҳа барои IC интихобшуда эҷод кунед.
- Пас аз анҷоми қадамҳои 1~7, тавре ки дар расми 11 нишон дода шудааст, лоиҳаи IC-и дилхоҳро, аз қабили Project_54xxx.uvprojx аз ..\ex интихоб кунед.ample \ TouchKey \ TouchKey_LIB \ MDK_ARMv5 \ роҳ.
Шарҳ ки барои сохтани лоиха танхо MCU бо захирахои калонтарини хар як серия истифода мешавад. Барои мисолample, барои истифодаи HT32F54231 корбарон бояд лоиҳаи HT32F54241-ро интихоб кунанд.
Мулоҳизаҳо
Азбаски барномаи калиди сенсорӣ метавонад ба ҳолати хоб ворид шавад, зарур аст, ки лоиҳаро барои аз нав оғоз кардан фаъол созад, вагарна он барои барномасозӣ дастрас нест. Қадамҳои танзим чунинанд.
- Қадами 1: Тугмаро дар менюи асбоби Keil5, тавре ки дар зер нишон дода шудааст, клик кунед.
- Қадами 2: Debug–> Танзимотро интихоб кунед.
- Қадами 3: Дар майдони Пайваст "зери Reset" -ро интихоб кунед.
Китобхона Files Тавсифи
Захираҳои истифодашудаи китобхона
| Лоиҳаи Кейл | IC истифодашаванда | ROM/RAM Захираҳо | IP-и истифодашуда | Макс. Шумораи калидҳо |
| HT32F54241 | HT32F54241 HT32F54231 | 7148B / 2256B | Тугмаи ламс кунед
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140B / 2528B | Тугмаи BFTM0 -ро ламс кунед
RTC |
28 |
- RTC барои бедор кардани MCU аз ҳолати хоб истифода мешавад ва ҳамчун заминаи вақт барои коркарди ҳолати хоб истифода мешавад.
- Вақте ки барнома ба IC бор карда мешавад, Keil муайян мекунад, ки оё андозаи ROM ё RAM аз ҳад зиёд шудааст.
- Барои истифодаи мушаххаси захираҳо, ба версияи воқеии китобхона муроҷиат кунед.
Муҳити зист ва File Тавсифи
Китобхонаи калидҳои сенсории HT32 дар роҳи зерин ҷойгир аст. ..\масаланample\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx (Расми 15). Пас аз кушодани лоиҳаи китобхонаи калиди сенсории HT32, экрани асосӣ ҳамчун расми 16 нишон дода шудааст.
дахлдор files ба таври зерин тавсиф карда мешаванд, ки дар байни онҳо ht32_TouchKey_conf.h ва system_ht32f5xxxx_09.c мебошанд. fileс, ки ба Ёвари танзимот дохил карда шудааст. Ба расми 17 нигаред.
| File Ном | Тавсифи |
| асосӣ.c | Барномаи асосии лоиҳа 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 интихоб кунед Конфигуратсияи SystemCoreClock (CK_AHB) Манбаи соатро барои системаи CK_AHB интихоб кунед
Тавсифи Функсияҳои интерфейси Touch Key Lib
Тавсифи функсияҳои Get
| Адад | Тавсифи |
| Номи функсия | TKL_Get_Standby |
| Параметри вуруд | — |
| Арзиши бозгашт | Қимати ҳисоб (500~60000) |
| Тавсифи | Барои ба даст овардани арзиши ҳисобкунак истифода мешавад |
| Адад | Тавсифи |
| Номи функсия | TKL_Get_KeyRCCValue |
| Параметри вуруд | Қимати калидӣ (0 ~ арзиши ҳадди аксар), басомад (0, 1) |
| Арзиши бозгашт | Қимати иқтидор (0~1023) |
| Тавсифи | Барои ба даст овардани арзиши зарфияти калиди муайяншуда истифода мешавад |
| Адад | Тавсифи |
| Номи функсия | TKL_GetKeyRef |
| Параметри вуруд | Қимати калидӣ (0 ~ арзиши ҳадди аксар) |
| Арзиши бозгашт | Арзиши истинод (0~65535) |
| Тавсифи | Барои ба даст овардани арзиши истинод аз калиди муайяншуда истифода мешавад |
| Адад | Тавсифи |
| Номи функсия | TKL_GetKey Threshold |
| Параметри вуруд | Қимати калидӣ (0 ~ арзиши ҳадди аксар) |
| Арзиши бозгашт | Арзиши ҳадди (0~255) |
| Тавсифи | Барои ба даст овардани арзиши ҳадди ниҳоии калиди муайяншуда истифода мешавад |
| Адад | Тавсифи |
| Номи функсия | TKL_Get_AllKeyState |
| Параметри вуруд | — |
| Арзиши бозгашт | Ҳолати калидӣ (32-бит)
BITn маънои давлати KEYnро дорад Bit0 = 1 маънои онро дорад, ки KEY0 пахш карда шудааст, Bit0 = 0 маънои онро дорад, ки KEY0 пахш нашудааст |
| Тавсифи | Барои ба даст овардани ҳама ҳолатҳои асосӣ истифода мешавад |
Тавсифи Функсияҳои муқарраршуда
| Адад | Тавсифи |
| Номи функсия | TKL_Set_Keythreshold |
| Параметри вуруд | Қимати калидӣ (0 ~ арзиши ҳадди аксар), арзиши ҳадди (10~127) |
| Арзиши бозгашт | — |
| Тавсифи | Барои муқаррар кардани арзиши ҳадди калиди муайяншуда истифода мешавад |
| Адад | Тавсифи |
| Номи функсия | TKL_Set_Sandby |
| Параметри вуруд | Вақти хоб (500 ~ 60000) |
| Арзиши бозгашт | — |
| Тавсифи | Барои гузоштани ҳисобкунаки ҳисоб истифода мешавад (истифодаи ин функсия тавсия дода намешавад) |
Тавсифи вазифаҳои давлатӣ ва фармондеҳӣ
| Адад | Тавсифи |
| Номи функсия | TKL_Is_Time |
| Параметри вуруд | Доимии пешакӣ (kT2mS, kT4mS…kT2048mS) |
| Арзиши бозгашт | — |
| Тавсифи | Парчами вақт барои истинод ба корбар.
Дар мисоли зеринample, барнома ба функсия дар ҳар 2ms дохил мешавад. |
| Адад | Тавсифи |
| Номи функсия | TKL_Is_AnyKeyPress |
| Параметри вуруд | — |
| Арзиши бозгашт | 1 = як ё якчанд калид ба кор андохта шудааст; 0 = ягон калид ба кор андохта нашудааст |
| Тавсифи | Барои ба даст овардани парчами пахшкунии тугма истифода мешавад |
| Адад | Тавсифи |
| Номи функсия | TKL_Is_KeyPress |
| Параметри вуруд | Қимати калидӣ (0 ~ арзиши ҳадди аксар) |
| Арзиши бозгашт | 1 = калид ба кор андохта шуд; 0 = калид ба кор андохта нашудааст |
| Тавсифи | Барои гирифтани парчами давлатии калиди муайяншуда истифода мешавад |
| Адад | Тавсифи |
| Номи функсия | TKL_Is_Active |
| Параметри вуруд | — |
| Арзиши бозгашт | 1 = оғозкунии LIB анҷом ёфт; 0 = Оғозсозии LIB ба охир нарасидааст |
| Тавсифи | Барои гирифтани парчами ҳолати ибтидоии LIB истифода мешавад |
| Адад | Тавсифи |
| Номи функсия | TKL_Интизорӣ |
| Параметри вуруд | — |
| Арзиши бозгашт | 1 = иҷозати ворид шудан ба ҳолати хоб; 0 = иҷозат дода намешавад, ки ба ҳолати хоб ворид шавед |
| Тавсифи | Барои гирифтани парчами ҳолати хоб истифода мешавад.
*Вақте ки арзиши 0 баргардонида мешавад, ворид шудан ба ҳолати хоб метавонад ба ҳолати ғайричашмдошт оварда расонад. |
| Адад | Тавсифи |
| Номи функсия | TKL_Is_KeyScanCycle |
| Параметри вуруд | — |
| Арзиши бозгашт | 1 = скан анҷом ёфт; 0 = айни замон скан карда мешавад |
| Тавсифи | Барои ба даст овардани парчами скан истифода мешавад |
| Адад | Тавсифи |
| Номи функсия | TKL_Reset |
| Параметри вуруд | — |
| Арзиши бозгашт | — |
| Тавсифи | Барои маҷбур кардани LIB барои иҷрои амали барқароркунӣ истифода мешавад.
* Парчамҳое, ки аз ҷониби LIB ва RAM истифода мешаванд, оғоз карда мешаванд. * Параметрҳо ва AFIO истисно карда мешаванд. |
Тавсифи Функсияҳои ибтидоии Touch Key Lib
Ин вазифаҳо дар main.c ҷойгир шудаанд. Тавсия дода намешавад, ки мундариҷаи онҳоро тағир диҳед.
| Ном | Функсия |
| GPIO_Configuration() | Конфигуратсияҳои порти I/O |
| 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 Ҳолати хоби амиқ1 ворид шавед USE_DEEP_SLEEP2_MODE Ҳолати хоби амиқ2 ворид шавед - Тавре ки дар зер нишон дода шудааст, режими хоби лозимиро бо истифода аз "#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', 'ширкат', 'мо',' тағир дода шавад. мо" ё "мо"). Дар ҳоле ки Холтек саъй мекунад, ки дурустии маълумотро дар ин бора таъмин кунад webДар сайт, ҳеҷ гуна кафолати мустақим ё дар назар дошташуда аз ҷониби Holtek ба дурустии Маълумот дода намешавад. Holtek барои ҳама гуна хатогӣ ё ихроҷ масъулият надорад.
Holtek барои ҳама гуна хисорот (аз ҷумла, вале бо он маҳдуд намешавад, ки вируси компютерӣ, мушкилоти система ё талафи маълумот) дар вақти истифода ё вобаста ба истифодаи ин масъулият ба дӯш намегирад. webсайт аз ҷониби ягон ҳизб. Шояд дар ин минтақа пайвандҳо вуҷуд дошта бошанд, ки ба шумо имкон медиҳанд, ки ба он боздид кунед webсайтҳои ширкатҳои дигар. Инхо webсайтҳо аз ҷониби Holtek назорат карда намешаванд. Holtek ҳеҷ гуна масъулият ва кафолат намедиҳад, ки ҳеҷ гуна маълумоте, ки дар ин сайтҳо намоиш дода мешавад. Гиперпайвандҳо ба дигарон webсайтҳо ба хатари шумо ҳастанд.
Маҳдудияти масъулият
Ба ҳеҷ ваҷҳ Holtek Limited дар назди ягон тарафи дигар барои талафот ё зараре, ки мустақиман ё ғайримустақим дар робита бо дастрасӣ ё истифодаи шумо ба он расонида шудааст, масъулият надорад. webсайт, мундариҷаи он ё ҳама гуна молҳо, маводҳо ё хидматҳо.
Қонуни идоракунӣ
Радди масъулият дар webсайт мувофиқи қонунгузории Ҷумҳурии Чин танзим ва тафсир карда мешавад. Истифодабарандагон ба салоҳияти ғайри истисноии судҳои Ҷумҳурии Чин пешниҳод хоҳанд кард.
Навсозии Радди Радди
Holtek ҳуқуқ дорад, ки Радди масъулиятро дар вақти дилхоҳ бо огоҳии пешакӣ ё бидуни огоҳии пешакӣ навсозӣ кунад, ҳама тағиротҳо фавран пас аз интишор ба webсайт.
Ҳуҷҷатҳо / Сарчашмаҳо
 |
Китобхонаи калидҳои Holtek HT32 MCU Touch [pdf] Дастури корбар HT32, Китобхонаи калидҳои MCU Touch, Китобхонаи калидҳои HT32 MCU Touch |
