Pustaka Kunci Tutul Holtek HT32 MCU
Pambuka
Pustaka tombol tutul HT32 sing dikembangake dening Best Solution minangka perpustakaan sing nggabungake menyang MCU kabeh perpustakaan driver sing ndasari tombol tutul. files. Perpustakaan kasebut wis ngonfigurasi hardware MCU sing gegandhengan karo tutul, lan nyedhiyakake setelan sensitivitas tombol tutul sing intuisi lan fleksibel, nalika nggabungake fungsi umum kayata deteksi tombol lan mode turu sing ngirit daya. Nggunakake perpustakaan tombol tutul HT32 nyederhanakake panggunaan fungsi tutul MCU, ngidini pangguna miwiti kanthi cepet lan nyuda wektu pangembangan. Dokumen iki bakal njlèntrèhaké kanthi rinci babagan konfigurasi lingkungan lan panggunaan perpustakaan.
Konfigurasi Lingkungan
Entuk Pustaka Tombol Tutul HT32
Hubungi FAE Best Solution utawa waca sawijining websitus: http://www.bestsolution.com.tw/EN/
Utawa download perpustakaan saka Holtek websitus: https://www.holtek.com
Entuk Pustaka Firmware HT32
Deleng link ing ngisor iki kanggo entuk perpustakaan perangkat kukuh kanthi cepet: https://www.holtek.com/productdetail/-/vg/HT32F54231_41_43_53
Bukak link, pilih opsi Dokumen kaya sing ditampilake ing Gambar 1, ing ngendi kothak abang nuduhake lokasi HT32 sing dikompres. files. Elinga yen mung perpustakaan perangkat kukuh versi v022 utawa ndhuwur ndhukung perpustakaan tombol tutul HT32.
Konfigurasi Proyek Keil
- PC pangguna kudu nginstal alat pangembangan Keil.
- Unzip perpustakaan firmware. Ing files kadhaptar minangka ditampilake ing Figure 2. Klik ing Holtek.HT32_DFP.latest kanggo nginstal, sawise layar completion instalasi, minangka ditampilake ing Figure 3, bakal katon.
- Unzip perpustakaan tombol tutul HT32 sing kalebu rong folder, contoneample lan perpustakaan.
- Copy mantanample lan folder perpustakaan menyang folder HT32_STD_xxxxx_FWLib_v022_XXXX.
- Eksekusi..\example \ TouchKey \ TouchKey_LIB \ _CreateProject.bat (Gambar 6).
- Antarmuka, kaya sing ditampilake ing Gambar 7, bakal katon. Ketik nomer sing cocog karo IDE pangguna, sawise tandha "*" bakal katon sadurunge IDE sing dipilih, kaya sing ditampilake ing Gambar 8. Input "N" kanggo pindhah menyang langkah sabanjure.
- Minangka kapacak ing ngisor iki, ketik "*" kanggo nggawe proyek kanggo kabeh jinis IC utawa ketik jeneng IC kanggo nggawe proyek kanggo IC sing dipilih.
- Sawise ngrampungake langkah 1~7, kaya sing ditampilake ing Gambar 11, pilih proyek IC sing dikarepake kayata Project_54xxx.uvprojx saka ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\ path.
Cathetan yen mung MCU kanthi sumber daya paling gedhe ing saben seri digunakake kanggo nggawe proyek kasebut. Kanggo example, kanggo nggunakake pangguna HT32F54231 kudu milih project HT32F54241.
Pertimbangan
Minangka program tombol tutul bisa mlebu negara turu, iku kudu nyetel project kanggo daya ing reset, yen ora bakal kasedhiya kanggo program. Langkah-langkah setelan kaya ing ngisor iki.
- Langkah 1: Klik tombol ing menu alat Keil5, kaya ing ngisor iki.
- Langkah 2: Pilih Debug-> Setelan.
- Langkah 3: Pilih "ing Reset" ing kolom Sambungake.
Pustaka Files Katrangan
Pustaka Digunakake Sumber Daya
| Proyek Keil | IC sing bisa digunakake | ROM / RAM Sumber daya | IP sing digunakake | Maks. Jumlah Tombol |
| HT32F54241 | HT32F54241 HT32F54231 | 7148B / 2256B | Tutul tombol
BFTM0 RTC |
24 |
| HT32F54253 | HT32F54243 HT32F54253 | 7140B / 2528B | Tombol tutul BFTM0
RTC |
28 |
- RTC digunakake kanggo tangi MCU saka negara turu lan digunakake minangka basis wektu kanggo proses negara turu.
- Nalika program dimuat menyang IC, Keil bakal nemtokake apa ukuran ROM utawa RAM wis ngluwihi.
- Kanggo nggunakake sumber daya tartamtu, deleng versi perpustakaan nyata.
Lingkungan lan File Katrangan
Pustaka tombol tutul HT32 dumunung ing dalan ing ngisor iki. ..\example\TouchKey\TouchKey_LIB\MDK_ARMv5\Project_542xx.uvprojx project (Figure15). Sawise proyek perpustakaan tombol tutul HT32 dibukak, layar utama ditampilake minangka Gambar 16.
Sing relevan files diterangake kaya ing ngisor iki, ing antarane yaiku ht32_TouchKey_conf.h lan system_ht32f5xxxx_09.c files, kalebu ing Wisaya Konfigurasi. Waca Gambar 17.
| File jeneng | Katrangan |
| utama.c | Program utama proyek file |
| ht32f5xxxx_01_it.c | Ngganggu program utama file |
| ht32_TouchKey_Lib_Mx_Keil.lib | Pustaka kontrol tutul file |
| *ht32_TouchKey_conf.h | Parameter kontrol tutul file |
| ht32_TouchKey.h | Dhéfinisi deklarasi njaba file |
| ht32_TouchKey_BSconf.h | Parameter utama sing ndasari file (ora dianjurake kanggo ngowahi) |
| ht32_board_config.h | Definisi hardware file (ora dianjurake kanggo ngowahi) |
| *system_ht32f5xxxx_09.c | Sumber jam lan parameter jam sistem file |
Parameter Wisaya Konfigurasi
- ht32_TouchKey_conf.h Parameter Wisaya Konfigurasi:
jeneng Fungsi Ngirit Daya Aktifake prosedur turu standar ditetepake ing main.c TKL_HighSensitive Setelan sensitivitas tutul: sensitivitas dhuwur utawa kurang; standar kanggo sensitivitas dhuwur sawise diaktifake TKL_keyDebounce Setelan wektu debounce tombol TKL_RefCalTime Wektu kalibrasi. Wektu sing luwih cendhek, luwih efektif kanggo nolak gangguan lingkungan, nanging bakal nyebabake sensitivitas tombol sing luwih murah. TKL_MaxOnHoldTime Wektu maksimal tombol ditekan. Tombol dibebasake kanthi otomatis sawise dipencet sajrone n detik. KEYn_EN Aktifake utawa mateni KEYn KeynThreshold Nilai ambang KEYn. Nilai sing luwih cilik, kunci sing luwih sensitif. - system_ht32f5xxxx_09.c Parameter Wisaya Konfigurasi:
jeneng Fungsi Aktifake High Speed External Crystal Oscillator - HSE Aktifake utawa mateni HSE (osilator kacepetan dhuwur eksternal) Aktifake Low Speed External Crystal Oscillator - LSE Aktifake utawa mateni LSE (osilator kacepetan kurang eksternal) Aktifake PLL Ngaktifake utawa mateni PLL Sumber Jam PLL Pilih sumber jam kanggo PLL SystemCoreClockConfiguration (CK_AHB) Pilih sumber jam kanggo sistem CK_AHB
Katrangan saka Tutul Key Lib Interface Fungsi
Deskripsi Get Functions
| Item | Katrangan |
| Jeneng Fungsi | TKL_Siaga |
| Parameter Input | — |
| Nilai bali | Nilai ngitung (500~60000) |
| Katrangan | Digunakake kanggo entuk nilai counter count-down |
| Item | Katrangan |
| Jeneng Fungsi | TKL_Get_KeyRCCCValue |
| Parameter Input | Nilai kunci (0 ~ nilai kunci maksimal), frekuensi (0, 1) |
| Nilai bali | Nilai kapasitansi (0~1023) |
| Katrangan | Digunakake kanggo entuk nilai kapasitansi tombol sing ditemtokake |
| Item | Katrangan |
| Jeneng Fungsi | TKL_GetKeyRef |
| Parameter Input | Nilai kunci (0 ~ nilai kunci maksimal) |
| Nilai bali | Nilai referensi (0~65535) |
| Katrangan | Digunakake kanggo entuk nilai referensi kunci sing ditemtokake |
| Item | Katrangan |
| Jeneng Fungsi | TKL_GetKeyThreshold |
| Parameter Input | Nilai kunci (0 ~ nilai kunci maksimal) |
| Nilai bali | Nilai ambang (0~255) |
| Katrangan | Digunakake kanggo entuk nilai ambang kunci sing ditemtokake |
| Item | Katrangan |
| Jeneng Fungsi | TKL_Get_AllKeyState |
| Parameter Input | — |
| Nilai bali | Status kunci (32-bit)
BITn singkatan saka negara KEYn Bit0 = 1 tegese KEY0 ditekan, Bit0 = 0 tegese KEY0 ora ditekan |
| Katrangan | Digunakake kanggo entuk kabeh negara kunci |
Deskripsi Fungsi Set
| Item | Katrangan |
| Jeneng Fungsi | TKL_Set_KeyThreshold |
| Parameter Input | Nilai kunci (0 ~ nilai kunci maksimal), nilai ambang (10~127) |
| Nilai bali | — |
| Katrangan | Digunakake kanggo nyetel nilai ambang kunci sing ditemtokake |
| Item | Katrangan |
| Jeneng Fungsi | TKL_Set_Standby |
| Parameter Input | Wektu turu (500~60000) |
| Nilai bali | — |
| Katrangan | Digunakake kanggo nyetel count-down counter (ora dianjurake kanggo nggunakake fungsi iki) |
Deskripsi Fungsi Negara lan Komando
| Item | Katrangan |
| Jeneng Fungsi | TKL_Is_Wektu |
| Parameter Input | Konstanta prasetel (kT2mS, kT4mS…kT2048mS) |
| Nilai bali | — |
| Katrangan | Gendéra wektu kanggo referensi pangguna.
Ing ngisor iki example, program lumebu fungsi saben 2ms. |
| Item | Katrangan |
| Jeneng Fungsi | TKL_Is_AnyKeyPress |
| Parameter Input | — |
| Nilai bali | 1 = siji utawa luwih tombol wis micu; 0 = ora ana tombol sing dipicu |
| Katrangan | Digunakake kanggo njupuk gendéra penet tombol |
| Item | Katrangan |
| Jeneng Fungsi | TKL_Is_KeyPress |
| Parameter Input | Nilai kunci (0 ~ nilai kunci maksimal) |
| Nilai bali | 1 = tombol wis micu; 0 = tombol durung micu |
| Katrangan | Digunakake kanggo njupuk gendéra negara tombol sing ditemtokake |
| Item | Katrangan |
| Jeneng Fungsi | TKL_Is_Aktif |
| Parameter Input | — |
| Nilai bali | 1 = inisialisasi LIB wis rampung; 0 = LIB initialization durung rampung |
| Katrangan | Digunakake kanggo njupuk flag negara initialization LIB |
| Item | Katrangan |
| Jeneng Fungsi | TKL_Is_Stanby |
| Parameter Input | — |
| Nilai bali | 1 = diijini mlebu turu; 0 = ora diijini mlebu negara turu |
| Katrangan | Digunakake kanggo njupuk flag negara turu.
*Yen nilai 0 dibalekake, banjur ngetik status turu bisa nyebabake kahanan sing ora dikarepke. |
| Item | Katrangan |
| Jeneng Fungsi | TKL_Is_KeyScanCycle |
| Parameter Input | — |
| Nilai bali | 1 = scan wis rampung; 0 = saiki mindhai |
| Katrangan | Digunakake kanggo njupuk flag scan |
| Item | Katrangan |
| Jeneng Fungsi | TKL_Reset |
| Parameter Input | — |
| Nilai bali | — |
| Katrangan | Digunakake kanggo meksa LIB nglakokake tumindak reset.
* Gendéra sing digunakake LIB lan RAM bakal diwiwiti. *Parameter lan AFIO ora kalebu. |
Deskripsi Fungsi Inisialisasi Touch Key Lib
Fungsi kasebut dumunung ing utama.c. Ora dianjurake kanggo ngowahi isine.
| jeneng | Fungsi |
| GPIO_Configuration() | Konfigurasi port I/O |
| RTC_Configuration() | Tombol tutul tangi dening RTC |
| BFTM_Konfigurasi() | Basis wektu perpustakaan tombol tutul dileksanakake dening BFTM |
| TKL_Configuration() | Konfigurasi tombol tutul |
Key State Query
Minangka kapacak ing ngisor iki, program utama kalebu ex tombol tutulample sing ora bakal diaktifake kanthi gawan. Kanggo ngaktifake fungsi iki, ngowahi (0) sawise #yen dadi (1).
Katrangan Mode Turu
- Ing ht32_TouchKey_conf.h, pilih PowerSave kanggo ngaktifake mode turu.
- Sawise mode turu diaktifake, tombol tutul bakal mlebu ing status turu yen tombol durung ngalami kahanan tutul kanggo wektu tartamtu.
- Fungsi count wektu siyaga digunakake kanggo ngetung mudhun, wektu saiki dijupuk nggunakake TKL_Get_Standby lan parameter wektu disetel nggunakake TKL_Set_Standby.
- Ana telung opsi mode turu.
Mode Katrangan USE_SLEEP_MODE Ketik Mode Turu USE_DEEP_SLEEP1_MODE Ketik Mode Deep Sleep1 USE_DEEP_SLEEP2_MODE Ketik Mode Deep Sleep2 - Kaya sing dituduhake ing ngisor iki, setel mode turu sing dibutuhake nggunakake "#define" ing sisih utama file.
Kesimpulan
Dokumen iki wis menehi instruksi kanggo nyetel kabeh lingkungan pangembangan tombol tutul HT32, nulung pangguna kanggo miwiti kanthi cepet. Kajaba iku, sumber daya sing digunakake dening perpustakaan, uga macem-macem fungsi lan paramèter, wis diterangake kanthi rinci, saéngga proses pangembangan luwih gampang.
Materi Referensi
Kanggo rincian liyane, waca ing Holtek websitus: www.holtek.com utawa takon Solusi Paling apik websitus: http://www.bestsolution.com.tw/EN/
Versi lan Informasi Modifikasi:
| Tanggal | Pengarang | Ngeculake | Katrangan |
| 2022.03.16 | 谢东霖, 梁德浩 | V1.00 | Versi pisanan |
Penafian
Kabeh informasi, merek dagang, logo, grafis, video, klip audio, pranala lan item liyane katon ing iki websitus ('Informasi') mung kanggo referensi lan bisa diganti sawayah-wayah tanpa kabar sadurunge lan ing discretion saka Holtek Semiconductor Inc. lan perusahaan sing gegandhengan (sabanjuré 'Holtek', 'perusahaan', 'kita', ' kita' utawa 'kita'). Nalika Holtek ngupayakake akurasi Informasi babagan iki websitus, ora babar pisan Express utawa diwenehake dening Holtek kanggo akurasi Informasi. Holtek ora tanggung jawab kanggo kesalahan utawa bocor.
Holtek ora bakal tanggung jawab kanggo karusakan apa wae (kalebu nanging ora winates ing virus komputer, masalah sistem utawa mundhut data) apa wae sing kedadeyan nalika nggunakake utawa gegayutan karo panggunaan iki. websitus dening pihak sembarang. Bisa uga ana pranala ing wilayah iki, sing ngidini sampeyan ngunjungi websitus perusahaan liyane. Iki websitus ora kontrol dening Holtek. Holtek ora tanggung jawab lan ora njamin apa wae Informasi sing ditampilake ing situs kasebut. Hyperlinks menyang liyane websitus ing resiko dhewe.
Watesan Tanggung Jawab
Ing acara apa wae Holtek Limited ora tanggung jawab marang pihak liya kanggo kerugian utawa karusakan apa wae utawa apa wae sing disebabake langsung utawa ora langsung sing ana hubungane karo akses utawa panggunaan iki. websitus, isi ing kono utawa barang, materi utawa layanan.
Hukum Panguwasa
Penafian sing ana ing websitus bakal diatur lan diinterpretasikake miturut hukum Republik China. Pangguna bakal ngirim menyang yurisdiksi non-eksklusif saka pengadilan Republik China.
Nganyari saka Penafian
Holtek nduweni hak kanggo nganyari Penafian sawayah-wayah kanthi utawa tanpa kabar sadurunge, kabeh owah-owahan efektif langsung sawise dikirim menyang websitus.
Dokumen / Sumber Daya
 |
Pustaka Kunci Tutul Holtek HT32 MCU [pdf] Pandhuan pangguna HT32, MCU Touch Key Library, HT32 MCU Touch Key Library |
