Holtek HT32 MCU мэдрэгчтэй түлхүүрийн номын сан
Танилцуулга
Best Solution-ийн боловсруулсан HT32 мэдрэгчтэй товчлуурын сан нь драйверын үндсэн бүх мэдрэгчтэй товчлуурыг MCU-д нэгтгэсэн номын сан юм. fileс. Номын сан нь мэдрэгчтэй холбоотой MCU техник хангамжийг урьдчилан тохируулсан бөгөөд мэдрэгчтэй товчлуурын мэдрэмжийн мэдрэмжийн тохиргоог хялбар, уян хатан болгож, түлхүүр илрүүлэх, эрчим хүч хэмнэх унтах горим зэрэг нийтлэг функцуудыг нэгтгэдэг. HT32 мэдрэгчтэй товчлуурын санг ашиглах нь MCU мэдрэгчтэй функцүүдийн хэрэглээг хялбарчилж, хэрэглэгчдэд хурдан эхлэх боломжийг олгож, хөгжүүлэлтийн хугацааг багасгадаг. Энэхүү баримт бичигт хүрээлэн буй орчны тохиргоо, номын сангийн ашиглалтыг нарийвчлан тайлбарлах болно.
Байгаль орчны тохиргоо
HT32 мэдрэгчтэй товчлуурын санг авах
Best Solution-ийн FAE-тэй холбоо барина уу эсвэл түүнээс лавлана уу webсайт: http://www.bestsolution.com.tw/EN/
Эсвэл Holtek-ээс номын санг татаж аваарай webсайт: https://www.holtek.com
HT32 Firmware Library авах
Програм хангамжийн санг хурдан авахын тулд дараах холбоосыг үзнэ үү. 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 мэдрэгчтэй товчлуурын санг задлаарай, жишээ ньample болон номын сан.
- Эксийг хуулж авample болон номын сангийн фолдеруудыг HT32_STD_xxxxx_FWLib_v022_XXXX хавтас руу оруулна уу.
- Гүйцэтгэх ..\жишээ ньample\TouchKey\TouchKey_LIB\_CreateProject.bat (Зураг 6).
- Зураг 7-д үзүүлсэн шиг интерфейс гарч ирнэ. Хэрэглэгчийн IDE-д тохирох дугаарыг оруулсны дараа Зураг 8-д үзүүлсэн шиг сонгосон IDE-ийн өмнө “*” тэмдэг гарч ирнэ. Дараагийн алхам руу шилжихийн тулд “N” гэж оруулна.
- Доор үзүүлсэн шиг бүх төрлийн IC-ийн төсөл үүсгэхийн тулд "*"-г оруулна уу эсвэл сонгосон IC-д төсөл үүсгэхийн тулд IC нэрийг оруулна уу.
- Зураг 1-д үзүүлсэн шиг 7~11-р алхамуудыг дуусгасны дараа ..\ex-аас Project_54xxx.uvprojx гэх мэт хүссэн IC төслийг сонго.ample\TouchKey\TouchKey_LIB\MDK_ARMv5\ зам.
Анхаарна уу Төслийг бий болгоход зөвхөн цуврал бүрийн хамгийн их нөөцтэй MCU ашигладаг. Жишээ ньample, HT32F54231-ийг ашиглахын тулд хэрэглэгчид HT32F54241 төслийг сонгох ёстой.
Анхаарах зүйл
Мэдрэгч товчлуурын програм унтах төлөвт орж болзошгүй тул төслийг дахин асаах горимд тохируулах шаардлагатай, эс тэгвээс програмчлалд ашиглах боломжгүй болно. Тохиргооны алхамууд дараах байдалтай байна.
- Алхам 1: Доор үзүүлсэн шиг Keil5 хэрэгслийн цэсний товчлуур дээр дарна уу.
- Алхам 2: Дебаг–> Тохиргоог сонгоно уу.
- Алхам 3: Холболтын талбараас "Дахин тохируулах" хэсгийг сонгоно уу.
Номын сан 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 орно. files, Тохиргооны мастерт багтсан. Зураг 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_Өндөр мэдрэмжтэй Мэдрэгчийн тохиргоо: өндөр эсвэл бага мэдрэмж; идэвхжүүлсний дараа анхдагчаар өндөр мэдрэмжтэй байх болно TKL_keyDebounce Түлхүүр задлах цагийн тохиргоо TKL_RefCalTime Тохируулгын хугацаа. Хугацаа богино байх тусам хүрээлэн буй орчны хөндлөнгийн нөлөөллийг эсэргүүцэх нь илүү үр дүнтэй байх болно, гэхдээ энэ нь үндсэн мэдрэмжийг бууруулдаг. TKL_MaxOnHoldTime Түлхүүрийг дарах хамгийн их хугацаа. Түлхүүрийг n секунд дарсны дараа автоматаар гарна. KEYn_EN KEYn-г идэвхжүүлэх эсвэл идэвхгүй болгох Түлхүүр босго KEYn босго утга. Утга нь бага байх тусам түлхүүр нь илүү мэдрэмжтэй байх болно. - system_ht32f5xxxx_09.c Тохиргооны мастерын параметрүүд:
Нэр Чиг үүрэг Өндөр хурдны гадаад болор осциллятор – HSE-г идэвхжүүлнэ HSE (гадаад өндөр хурдны осциллятор) идэвхжүүлэх эсвэл идэвхгүй болгох Бага хурдны гадаад болор осцилляторыг идэвхжүүлэх – LSE LSE (гадаад бага хурдтай осциллятор) идэвхжүүлэх эсвэл идэвхгүй болгох PLL-г идэвхжүүл PLL-г идэвхжүүлэх эсвэл идэвхгүй болгох PLL цагийн эх сурвалж PLL-ийн цагийн эх сурвалжийг сонгоно уу SystemCoreClockConfiguration (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_Тогтоох_түлхүүр босго |
| Оролтын параметр | Түлхүүр утга (0 ~ хамгийн их түлхүүр утга), босго утга (10~127) |
| Буцах утга | — |
| Тодорхойлолт | Заасан түлхүүрийн босго утгыг тохируулахад ашигладаг |
| Зүйл | Тодорхойлолт |
| Функцийн нэр | TKL_Set_Standby |
| Оролтын параметр | Унтах хугацаа (500~60000) |
| Буцах утга | — |
| Тодорхойлолт | Тоолуурыг тохируулахад ашигладаг (энэ функцийг ашиглахыг зөвлөдөггүй) |
Төрийн болон тушаалын чиг үүргийн тодорхойлолт
| Зүйл | Тодорхойлолт |
| Функцийн нэр | TKL_Цаг |
| Оролтын параметр | Урьдчилан тогтоосон тогтмол (kT2mS, kT4mS…kT2048mS) |
| Буцах утга | — |
| Тодорхойлолт | Хэрэглэгчийн лавлагааны цагийн туг.
Дараах жишээндample, програм нь функцийг 2 мс тутамд оруулдаг. |
| Зүйл | Тодорхойлолт |
| Функцийн нэр | TKL_Is_Any KeyPress |
| Оролтын параметр | — |
| Буцах утга | 1 = нэг буюу хэд хэдэн түлхүүр идэвхжсэн; 0 = ямар ч түлхүүр асаагаагүй байна |
| Тодорхойлолт | Түлхүүрийг дарах тугийг авахад ашигладаг |
| Зүйл | Тодорхойлолт |
| Функцийн нэр | TKL_Түлхүүр дарах |
| Оролтын параметр | Түлхүүр утга (0 ~ хамгийн их түлхүүр утга) |
| Буцах утга | 1 = түлхүүр асаалттай байна; 0 = түлхүүр асаагаагүй байна |
| Тодорхойлолт | Заасан түлхүүрийн төрийн далбааг авахад хэрэглэгддэг |
| Зүйл | Тодорхойлолт |
| Функцийн нэр | TKL_Идэвхтэй |
| Оролтын параметр | — |
| Буцах утга | 1 = LIB эхлүүлэх ажиллагаа дууссан; 0 = LIB эхлүүлэх ажиллагаа дуусаагүй байна |
| Тодорхойлолт | LIB эхлүүлэх төлөвийн тугийг авахад ашигладаг |
| Зүйл | Тодорхойлолт |
| Функцийн нэр | TKL_Standby |
| Оролтын параметр | — |
| Буцах утга | 1 = унтах төлөвт орохыг зөвшөөрсөн; 0 = унтах горимд орохыг зөвшөөрөхгүй |
| Тодорхойлолт | Унтах төлөвийн тугийг авахад ашигладаг.
*0 утгыг буцаах үед унтах төлөвт орох нь гэнэтийн төлөвт хүргэж болзошгүй. |
| Зүйл | Тодорхойлолт |
| Функцийн нэр | TKL_Is_KeyScanCycle |
| Оролтын параметр | — |
| Буцах утга | 1 = скан дууссан; 0 = одоогоор скан хийж байна |
| Тодорхойлолт | Сканнерийн тугийг авахад ашигладаг |
| Зүйл | Тодорхойлолт |
| Функцийн нэр | TKL_Reset |
| Оролтын параметр | — |
| Буцах утга | — |
| Тодорхойлолт | LIB-г дахин тохируулах үйлдлийг гүйцэтгэхийг албадах зорилгоор ашигладаг.
*LIB болон RAM-д ашигладаг тугуудыг эхлүүлэх болно. *Үзүүлэлтүүд болон AFIO-г оруулаагүй болно. |
Touch Key Lib эхлүүлэх функцуудын тодорхойлолт
Эдгээр функцууд нь main.c-д байрладаг. Тэдний агуулгыг өөрчлөхийг зөвлөдөггүй.
| Нэр | Чиг үүрэг |
| GPIO_Тохиргоо() | I/O портын тохиргоо |
| RTC_Тохиргоо() | Мэдрэгч товчлууруудыг RTC-ээр сэрээдэг |
| BFTM_Тохиргоо() | Мэдрэгч товчлуурын номын сангийн цагийн суурийг BFTM хэрэгжүүлдэг |
| TKL_Тохиргоо() | Товчлуурын тохиргоонд хүрнэ үү |
Түлхүүр улсын асуулга
Доор үзүүлсэн шиг үндсэн програм нь мэдрэгчтэй товчлуурыг агуулнаample нь анхдагчаар идэвхжихгүй. Энэ функцийг идэвхжүүлэхийн тулд #if-ийн дараа (0)-ыг (1) болгоно.
Унтах горимын тайлбар
- ht32_TouchKey_conf.h дотор PowerSave-г сонгоод унтдаг горимуудыг идэвхжүүлнэ үү.
- Унтах горимыг идэвхжүүлсний дараа товчлуурууд нь тодорхой хугацаанд мэдрэгчтэй ямар ч нөхцөл байдалд ороогүй тохиолдолд мэдрэгчтэй товчлуурууд унтах төлөвт орно.
- Урьдчилан тоолоход зогсолтын хугацааг тоолох функцийг ашигладаг бөгөөд TKL_Get_Standby ашиглан одоогийн цагийг олж, TKL_Set_Standby ашиглан цагийн параметрийг тохируулна.
- Унтах горимын гурван сонголт байдаг.
Горим Тодорхойлолт USE_SLEEP_MODE Унтах горимыг оруулна уу _DEEP_SLEEP1_MODE АШИГЛАХ Гүн нойрны 1 горимд орно _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сайт, Мэдээллийн үнэн зөв байдалд Холтек ямар ч шууд болон далд баталгаа өгдөггүй. Холтек нь аливаа буруу, гоожсон тохиолдолд хариуцлага хүлээхгүй.
Холтек нь үүнийг ашиглах эсвэл ашиглахтай холбоотой аливаа хохирлыг (компьютерийн вирус, системийн асуудал, өгөгдлийн алдагдал гэх мэт) хариуцахгүй. webаль ч намын сайт. Энэ хэсэгт зочлох боломжтой холбоосууд байж болно webбусад компаниудын сайтууд. Эдгээр webсайтуудыг Holtek хянадаггүй. Холтек нь ийм сайтад үзүүлсэн мэдээллийн талаар ямар ч хариуцлага хүлээхгүй бөгөөд баталгаа өгөхгүй. Бусад руу чиглэсэн гипер холбоосууд webсайтууд таны эрсдэлд орно.
Хариуцлагын хязгаарлалт
Ямар ч тохиолдолд Holtek Limited нь таны нэвтрэх, ашиглахтай холбогдуулан шууд болон шууд бусаар учирсан аливаа алдагдал, хохирлыг бусад талын өмнө хариуцахгүй. webсайт, түүн дээрх контент эсвэл аливаа бараа, материал, үйлчилгээ.
Удирдах хууль
-д агуулагдаж буй татгалзал webсайтыг БНХАУ-ын хууль тогтоомжийн дагуу зохицуулж, тайлбарлана. Хэрэглэгчид БНХАУ-ын шүүхийн онцгой бус харьяалалд хандах болно.
Татгалзах мэдэгдлийн шинэчлэл
Holtek нь Татгалзлын мэдэгдлийг ямар ч үед урьдчилан мэдэгдэлгүйгээр шинэчлэх эрхтэй. webсайт.
Баримт бичиг / нөөц
 |
Holtek HT32 MCU мэдрэгчтэй түлхүүрийн номын сан [pdf] Хэрэглэгчийн гарын авлага HT32, MCU Touch Key Library, HT32 MCU Touch Key Library |
