HOLTEK HT32 MCU GNU Arm Compiler Pandhuan Panganggo

Ana macem-macem jinis compiler sing kasedhiya, sawetara sing umum digunakake yaiku Keil (MDK-ARM), IAR (EWARM), GNU (GNU ARM) lan liya-liyane. Yen "GNU" dibandhingake karo "Keil" lan "IAR", prabédan utama yaiku GNU bebas digunakake lan Keil lan IAR loro-lorone wis mbayar lisensi, yen ora ana watesan ukuran program. Kaya sing bisa dideleng saka gambar ing ngisor iki, dibandhingake karo Keil MDK-ARM, GNU Arm nduweni advantage ora ana watesan ukuran lan luwih trep kanggo nggunakake. Cathetan aplikasi iki bakal nerangake carane nggunakake GNU Arm Compiler karo HT32 MCU.
Cathetan aplikasi iki pisanan nggambarake download lan persiapan sumber daya. Ngundhuh file kalebu Pustaka Firmware sing ngemot example program dibutuhake sak proses testing. mantanampprogram le bisa ngirim pesen liwat port COM, mulane piranti lunak terminal bakal digunakake kanggo pilihan fungsi utawa tampilan status. Instalasi lan panggunaan GNU Arm Compiler bakal dienal kanthi urutan lan bisa digunakake karo "GNU Make" utawa "Keil MDKARM uVision". Pungkasan, pitulungan diwenehake kanggo ngrampungake masalah umum sajrone instalasi, ngidini pangguna nemokake solusi nalika nemoni masalah. Iku uga mbantu pangguna supaya cepet mbangun lingkungan kanggo GNU Arm Compiler digunakake.

Ngundhuh lan Persiapan Sumber

Bab iki nerangake exampprogram le lan piranti lunak dibutuhake lan nerangake carane ngatur direktori lan file dalan.

Pustaka Firmware

Sadurunge nggunakake mantanampprogram iki, download Holtek HT32 Firmware Library paling anyar saka link ing ngisor iki banjur decompress diundhuh file. Priksa manawa perpustakaan perangkat kukuh HT32 sing bener wis dipilih. Kanggo example HT32_M0p_Vyyyymmdd.zip kanggo seri HT32F5xxxx MCU lan HT32_M3_Vyyyymmdd.zip kasedhiya kanggo seri HT32F1xxxx MCUs.
Iki dikompres file ngemot sawetara folder sing bisa dikategorikaké minangka Document, Firmware Library, Tools, etc, kang dumunung ing direktori minangka ditampilake ing Gambar ngisor iki. Ing folder Firmware Library diselehake ing HT32 Firmware Library teken file jenenge HT32_STD_xxxxx_FWLib_Vm.n.r_s.zip, minangka kapacak ing ngisor iki.

Link download: https://mcu.holtek.com.tw/ht32/resource/

Program Terminal

Kode Aplikasi exampprogram le bisa ngirim pesen liwat port COM kanggo pilihan fungsi utawa tampilan status. Pangguna bisa nginstal piranti lunak komunikasi sing cocog ing PC host, kayata Tera Term, yaiku program gratis lisensi.

Konfigurasi antarmuka UART ing example program wis format data 8-dicokot. Ora ana paritas. Wis siji mandeg bit lan baud rate 115200.

Instalasi GNU Arm Compiler

Bab iki njlèntrèhaké instalasi saka GNU Arm Compiler sing diterangake ing "GNU Arm Installation" lan "Test" bagean.

Instalasi GNU Arm

Langkah 1. Ngundhuh EXE file kanggo instalasi GNU Arm saka link ing ngisor iki.

https://developer.arm.com/open-source/gnu-toolchain/gnu-rm

Cathetan: Miturut informasi nganyari Arm GNU Toolchain 2022, versi sadurunge diklasifikasikake minangka dihentikan. file. Ing file jeneng sing digunakake ing artikel iki lan versi paling anyar sing dihentikan yaiku:

Ing file jeneng digunakake ing artikel iki: "gcc-arm-11.2-2022.02-mingw-w64-i686-arm-none- eabi.exe".
Ing file jeneng kanggo versi mandhap paling anyar punika: "gcc-arm-none-eabi-10.3-2021.10- win32.exe".

Langkah 2. Ing langkah "Pilih Instal Lokasi", kaya sing ditampilake ing gambar ing ngisor iki, simpen jalur instalasi nalika instalasi. Path iki bakal dikonfigurasi ing Keil ing bab "Digunakake karo Keil MDK- ARM uVision".
Kanggo example:
"C:\Program Files (x86)\Arm GNU Toolchain arm-none-eabi\11.2 2022.02”.

Langkah 3. Sajrone langkah instalasi pungkasan, pilih "Tambah path kanggo variabel lingkungan" lan klik "Rampung".

Cathetan: Urip maneh komputer nalika instalasi wis rampung.

Tes

GNU Arm Compiler nambahake path menyang variabel lingkungan sajrone instalasi, kaya sing ditampilake ing Langkah 3 ing bagean "GNU Arm Installation". Bagian iki bakal nerangake carane nggunakake "Command Prompt" kanggo nyoba apa instalasi GNU Arm wis rampung.

Langkah 1. Aktifake Command Prompt.
Ana sawetara cara kanggo ngaktifake command prompt, sing bakal diterangake ing "Run" Window lan pilihan "Menu" ing bagean ngisor iki.

Aktifake liwat "Run" Window: Pisanan pencet tombol "Windows + R" ing keyboard lan ketik "cmd" ing jendhela pop-up "Run" minangka ditampilake ing gambar ing ngisor iki. Banjur pencet "OK" kanggo ngaktifake Command Prompt.
Pilih saka "Menu": Klik menu "Mulai", banjur temokake lan bukak folder Sistem Windows. Klik ing "Command Prompt", minangka ditampilake ing gambar ing ngisor iki.

Langkah 2. Ketik "arm-none-eabi-gcc -v" ing Command Prompt sing diaktifake lan layar ing ngisor iki bakal katon, nuduhake yen printah kasebut bener. Iki tegese instalasi GNU Arm wis rampung lan kode program Arm bisa dikompilasi. Ing wektu sing padha, path instalasi bisa dikonfirmasi nggunakake output Command Prompt. Iki dituduhake dening path ditandhani dening garis burik ing kothak abang burik ing tokoh.

Digunakake karo GNU Make

Bab iki nerangake carane nggunakake GNU Arm Compiler karo GNU Make.

Instalasi GNU Make

Langkah 1. Klik link ing ngisor iki kanggo ngundhuh EXE file kanggo instalasi GNU Make.

http://gnuwin32.sourceforge.net/packages/make.htm

Cathetan: Ing file jeneng padha karo "make-3.81.exe

Langkah 2. Ing langkah "Pilih Lokasi Tujuan", kaya sing ditampilake ing gambar ing ngisor iki, nyalin lan nyimpen path instalasi nalika instalasi. Path kasebut bakal dikonfigurasi dadi variabel lingkungan mengko. Kanggo example:
"C:\Program Files (x86)\GnuWin32”

Langkah 3. Tambah karakter ekstra "\ bin" kanggo path disalin ing Langkah 2 lan ngatur ing variabel lingkungan "Path" kanggo nambah path kanggo alat GNU Make. Waca loro tokoh ing ngisor iki, sing nuduhake carane ngaktifake variabel lingkungan, lan golek "Path" suntingan lan nambah path.
Cathetan: Kabeh path padha karo "C:\Program Files (x86)\GnuWin32\bin”.

Langkah 4. Tes printah "make-v" nggunakake Command Prompt lan layar ing ngisor iki bakal katon, nuduhake yen printah kasebut bener. Iki tegese instalasi GNU Make wis rampung.
Cathetan: Deleng konten "Aktifake Command Prompt" ing bagean "Test" kanggo metode ngaktifake Command Prompt.

Kompilasi lan Output

Bagean iki bakal njlèntrèhaké cara kompilasi lan asil output nggunakake Firmware Library Project Template (...\project template\IP\Example), sing kalebu printah kompilasi, pesen output lan output files lsp.
Langkah 1. Aktifake Command Prompt lan ganti direktori operasi menyang folder "GNU_ARM" ing Firmware Library Project Template.
(\\HT32_STD_5xxxx_FWLib_Vm.n.r_s\project_template\IP\Example\GNU_ARM)

Langkah 2. Ketik printah "make xxxxx" utawa "make -f xxxxx.mk" kanggo mbangun program. Yen kabeh operasi mbangun wis rampung, pesen "BUILD SUCCESSFUL" bakal katon kaya sing ditampilake ing gambar ing ngisor iki.
(xxxxx minangka piranti IC, ing kene digunakake 52352)

Langkah 3. Sawise ngrampungake Langkah 2, Hex lan Binary files bisa ditemokaké ing path ing ngisor iki. Banjur nganyari firmware menyang Starter Kit nggunakake piranti pemrograman liyane kayata e-Writer32, HT32 ICP Tool, e-Link32 Pro/Lite, HT32 Flash Programmer lan ISP bootloader. Bagean sabanjure bakal ngenalake pemrograman nggunakake e-Link32 Pro / Lite.
“…\GNU_ARM\HT32M\xxxxx\Obj\HT32.bin”
“…\GNU_ARM\HT32M\xxxxx\Obj\HT32.hex”

Pemrograman nggunakake e-Link32 Pro/Lite

Bagean iki bakal njupuk HT32F52352 Starter Kit (SK) minangka mantanample. Pisanan, ngenalake operasi persiapan lingkungan kanggo Starter Kit (SK) lan e-Link32 Pro / Lite, banjur nerangake carane nggunakake "make IC = xxxxx eraseall / program / run" lan Command Prompt resultsin urutan. Pungkasane nerangake carane ngamati pemrograman kasebut sukses utawa ora liwat status SK.
Operasi persiapan lingkungan kanggo SK lan e-Link32 Lite yaiku:
(1) Ana rong port USB COM ing Papan. Kene PC disambungake menyang port e-Link32 Lite ing Papan nggunakake kabel USB, minangka ditampilake dening (a) ing tokoh ing ngisor iki.
(2) Fungsi VCP (Virtual COM Port) saka e-Link32 Lite dibutuhake kanggo konfirmasi pemrograman. Priksa manawa tutup jumper UART Jumper-J2 * 1 nyepetake PIN PAx * 2 lan DAP_Tx. Lokasi jumper dituduhake dening (b) ing gambar ing ngisor iki.
Wigati: 1. J2 ing SK menehi loro setelan kang kanggo short PAx lan DAP_Tx pin utawa singkat PAx lan RS232_Tx pin. Deleng Manual pangguna Starter Kit kanggo rincian.
2. Pin dijenengi PAx kene amarga setelan kanggo pin MCU UART RX beda-beda ing SK beda.

Operasi persiapan lingkungan kanggo SK lan e-Link32 Pro kaya ing ngisor iki: Siji sisih e-Link32 Pro disambungake menyang PC nggunakake kabel data Mini USB lan sisih liyane kanggo antarmuka SWD. e-Link32 Pro dibutuhake kanggo nyambung menyang SWD-10P ing SK nggunakake kabel flat abu-abu 10-pin, minangka ditampilake ing gambar ing ngisor iki (a).

Bagean ing ngisor iki bakal njlèntrèhaké "make IC = xxxxx eraseall / program / run" panggunaan printah lan asil Command Prompt ing urutan.

Langkah 1. Ketik printah "make IC = xxxxx eraseall" utawa "make-f xxxxx.mk eraseall" ing jendhela "Command Prompt". Yen sukses, pesen "BUPAS SEMUA SUKSES" bakal katon ing layar, kaya sing ditampilake ing gambar ing ngisor iki.
(xxxxx minangka piranti IC, ing kene digunakake 52352).
Cathetan: Printah iki digunakake kanggo nglakokake operasi Flash Mass Erase.

Langkah 2. Ketik printah "make IC = xxxxx" utawa "make-f xxxxx.mk program" ing jendhela "Command Prompt". Yen sukses, pesen "PROGRAM SUCCESS" bakal katon ing layar, kaya sing ditampilake ing gambar ing ngisor iki.
(xxxxx minangka piranti IC, ing kene digunakake 52352).

Langkah 3. Ketik printah "make IC = xxxxx run" utawa "make-f xxxxx.mk run" ing jendhela "Command Prompt". Yen sukses, pesen "RUN SUCCESS" bakal katon ing layar, kaya sing ditampilake ing gambar ing ngisor iki. SK bakal operate miturut mantanampprogram lan statuse nalika diprogram kanthi sukses ditampilake ing Langkah 4.
(xxxxx minangka piranti IC, ing kene digunakake 52352)

Langkah 4. Yen tumindak Langkah 3 wis rampung, langkah iki bakal diterusake kanggo nemtokake manawa pemrograman wis sukses kanthi mriksa status SK. Iki bisa diverifikasi nggunakake piranti lunak LED utawa terminal. Deleng bagean "Perangkat Lunak Terminal" kanggo setelan piranti lunak terminal. Katrangan status bakal diwenehi ing ngisor iki.
Nalika pesen "RUN SUCCESS" katon ing layar, LED1 lan LED2 bakal kedhip. Posisi kasebut ditampilake ing sisih kiwa ngisor gambar ing ngisor iki. Pesen ing ngisor iki banjur bakal ditampilake "Hello World! 0" ~ "Hello World! 99" ing piranti lunak terminal PC liwat Port COM Virtual, kaya sing ditampilake ing sisih tengen gambar ing ngisor iki. Loro-lorone bisa digunakake kanggo verifikasi manawa lingkungan wis kasil digunakake.

Deskripsi Setelan

Bagian iki njlèntrèhaké sing gegandhengan files ing direktori GNU_ARM, kaya sing ditampilake ing tabel ing ngisor iki.

Folder/File jeneng	Katrangan
\\project_template\IP\Example\GNU_ARM
xxxxx.mk	Gawefile file, xxxxx iku piranti IC
linker.ld	Linker Script
Gawefile	Gawefile file
Project_xxxxx.uvprojx	Proyek, xxxxx minangka piranti IC

Saiki bakal diterangake carane nambah .c file, kalebu path utawa C / S Preprocessor Define dening ngowahi nggawefile file jenenge "xxxxxx.mk".

Cathetan: Bagean iki nggunakake 52352.mk minangka ilustrasi.

Tambah a.c file. Bagian iki digunakake kanggo nyetel proyek .c file, cara ing ngisor iki digunakake.
- Bukak 52352.mk, goleki "Sumber files", setelan sing ditampilake ing ngisor iki katon ing layar,
  sing bisa ditambahake nggunakake "SOURCE_NAME_PATH +=" append ".c file dalan lan jeneng”.
Kalebu Path. Bagean iki digunakake kanggo nambah Include Paths, sing nyedhiyakake macem-macem dalan kanggo nggoleki header file (.h file), cara ing ngisor iki digunakake.
- Mbukak 52352.mk, nelusuri "Kalebu Path", setelan kapacak ing ngisor iki katon ing layar, kang bisa ditambahake nggunakake "INCLUDE_PATH += -I./" nambah "Path".
C/S Preprocessor Define. Bagian iki digunakake kanggo nambah pesen Preprocessor Define, cara ing ngisor iki digunakake.
- Bukak 52352.mk, goleki "Preprocessor Define", setelan sing ditampilake ing ngisor iki katon ing layar. Cara nambah kanggo .c Preprocessor Define rada beda karo .s Preprocessor Define. Iki disusun kaya ing ngisor iki.
  ► c Preprocessor Define: "C_Option += -D" + "Define content" Kanggo example: C_OPTION += -DUSE_HT32_DRIVER.
  ► .h Preprocessor Define: "S_Option = -defsym" + "Define content" Kanggo example: S_OPTION = –defsym USE_HT32_CHIP=4

Digunakake karo Keil MDK-ARM uVision

Bab iki nerangake carane nggunakake GNU Arm Compiler karo Keil MDK-ARM uVision. Cathetan: Bagian iki mbutuhake panggunaan Keil MDK-ARM. Pisanan pindhah menyang pejabat Keil websitus kanggo entuk EXE file kanggo instalasi Keil MDK-ARM lan ngrampungake instalasi. Pejabat Keil weblink instalasi situs minangka nderek.

https://www.keil.com/demo/eval/arm.htm

Cathetan: Ing file jeneng padha karo "MDK537.EXE".

Setelan Proyek

Langkah 1. Bukak proyek Project_xxxxx.uvprojx file saka Pustaka Firmware. Ing kene 52352 digunakake.
\\HT32_STD_5xxxx_FWLib_Vm.n.r_s \project_template\IP\Example\GNU_ARM\Project_xxxxx.uvprojx Wigati: xxxxx iku jeneng piranti.

Langkah 2. Klik "Ngatur Project Items" lambang banjur klik "Folder / Ekstensi" pilihan. Pilih "Gunakake GCC Compiler (GNU) kanggo proyek ARM" banjur salin path instalasi GNU Arm menyang kothak teks "Folder", kaya sing ditampilake ing gambar ing ngisor iki.
Cathetan: Kanggo jalur instalasi GNU Arm, deleng jalur sing disalin ing Langkah 2 saka bagean "GNU Arm Installation" ing bab "GNU Arm Compiler Installation".

Compile lan Test

Langkah 1. Klik "Mbangun (F7)" kanggo mbangun proyek.
Langkah 2. Priksa jendhela "Mbangun Output" kanggo konfirmasi apa program wis dibangun bener.

langkah 3. Sambungake e-link32 lite USB COM port ing HT32F52352 Starter Kit kanggo PC, minangka ditampilake ing kothak abang ing sisih kiwa tokoh ing ngisor iki. Konfirmasi yen PC wis ndeteksi piranti USB kanthi normal, kaya sing ditampilake ing kothak abang ing sisih tengen gambar ing ngisor iki.

Langkah 4. Klik "Download (F8)" kanggo ngundhuh kode menyang memori Flash.

langkah 5. A tutup jumper diselehake ing DAP_TX lan PA5 pin kanggo short, minangka ditampilake ing tokoh ing ngisor iki. Banjur piranti lunak terminal PC (Tera Term) bakal dikonfigurasi lan Port COM bakal disetel miturut Step3. Deleng bagean "Perangkat Lunak Terminal" kanggo konfigurasi Term Tera sing rinci.

Langkah 6. Nalika tombol "Reset" wis dipencet, loro LED1 lan LED2 bakal kedhip minangka ditampilake ing sisih kiwa tokoh ing ngisor iki. Pesen "Hello World! 0" ~ "Hello World! 99" bakal katon ing jendhela "Tera Term" liwat Virtual COM Port, minangka ditampilake ing sisih tengen tokoh ing ngisor iki. Iki digunakake kanggo verifikasi manawa wis kasil digunakake karo Keil MDK-ARM uVision GNU Arm Compiler.

Masalah Umum

Bab iki mbantu sawetara masalah umum sing bisa ditemoni.

Pesen kesalahan sing bisa uga katon Sawise Dibangun

Yen nglakokake "Sawise Mbangun", pesen kesalahan ing ngisor iki bakal digawe. Coba urip maneh komputer utawa mbukak Keil MDK-ARM minangka administrator kanggo nggawe operasi "Sawise Mbangun" sukses.

Yen masalah iki ora bisa ditanggulangi kanthi nggunakake langkah-langkah ing ndhuwur, pangguna uga bisa mateni pilihan "Sawise Mbangun / Mbangun maneh" kaya sing ditampilake ing gambar ing ngisor iki.
Cathetan: Nalika opsi "Sawise Mbangun / Mbangun maneh" dipateni, Keil ora bakal ngasilake format binar lan pesen ukuran Kode.

Persyaratan Versi Pustaka Firmware

Yen "GNU Arm Compiler" digunakake karo "GNU Make" utawa "Keil MDK-ARM uVision", kudu dicathet yen mung versi ing ngisor iki utawa versi Firmware Library sing luwih dhuwur sing ndhukung proyek GNU Arm. files.

HT32_STD_5xxxx_FWLib_V1.0.26_nnnn.zip

HT32_STD_1xxxx_FWLib_V1.0.11_nnnn.zip

Kesimpulan

Cathetan aplikasi iki pisanan menehi katrangan singkat babagan GNU Arm. Iki diterusake karo panjelasan kanggo nuduhake pangguna carane nginstal lan nyoba GNU Arm Compiler. Banjur diterangake carane nggunakake karo "GNU Make" utawa "Keil MDK-ARM uVision". Pungkasan, ana panjelasan babagan cara nggunakake GNU Arm Compiler karo MCU HT32.

Materi Referensi

Kanggo informasi luwih lengkap, takon menyang resmi Holtek websitus web: www.holtek.com.

Informasi Revisi lan Modifikasi

Tanggal	Pengarang	Jeksa Agung bisa ngetokake	Informasi Modifikasi
2022.05.13	蔡期育	V1.00	Versi Pertama

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

The Disclaimer 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

HOLTEK HT32 MCU GNU Arm Compiler [pdf] Pandhuan pangguna
HT32 MCU, HT32 MCU GNU Arm Compiler, GNU Arm Compiler, Arm Compiler

Referensi

Manual pangguna

Pambuka