Prevajalnik HOLTEK HT32 MCU GNU Arm

Prevajalnik HT32 MCU GNU Arm

Uvod

Na voljo je veliko vrst prevajalnikov, nekateri pogosto uporabljeni so Keil (MDK-ARM), IAR (EWARM), GNU (GNU ARM) in tako naprej. Če »GNU« primerjamo z »Keil« in »IAR«, je glavna razlika v tem, da je uporaba GNU brezplačna, Keil in IAR pa sta plačala licence, sicer bo velikost programa omejena. Kot je razvidno iz naslednje slike, ima GNU Arm v primerjavi s Keil MDK-ARM prednosttage ni omejen na velikost in je bolj priročen za uporabo. Ta opomba o aplikaciji opisuje, kako uporabljati prevajalnik GNU Arm z mikrokontrolerji HT32.
Ta opomba o aplikaciji najprej opisuje prenos in pripravo vira. Prenos file vključuje knjižnico vdelane programske opreme, ki vsebuje example program, potreben med postopkom testiranja. Bivšiampprogram lahko prenaša sporočila prek vrat COM, zato bo programska oprema terminala uporabljena za izbiro funkcij ali prikaz stanja. Namestitev in uporaba prevajalnika GNU Arm bosta predstavljeni v zaporedju in se lahko uporabljata z »GNU Make« ali »Keil MDKARM uVision«. Na koncu je zagotovljena pomoč pri reševanju pogostih težav med namestitvijo, kar uporabnikom omogoča, da najdejo rešitev, ko naletijo na težave. Uporabnikom tudi pomaga hitro zgraditi okolje za uporabo prevajalnika GNU Arm.
Uvod

Prenos in priprava virov

To poglavje opisuje prampda program in zahtevana programska orodja ter pojasnjuje, kako konfigurirati imenik in file pot.

Knjižnica vdelane programske opreme

Pred uporabo exampprenesite najnovejšo knjižnico vdelane programske opreme Holtek HT32 z naslednje povezave in nato razpakirajte preneseno file. Prepričajte se, da je bila izbrana pravilna knjižnica vdelane programske opreme HT32. Na primerampLe HT32_M0p_Vyyyymmdd.zip je za serijo MCU HT32F5xxxx, HT32_M3_Vyyyymmdd.zip pa je na voljo za serijo MCU HT32F1xxxx.
Ta stisnjen file vsebuje več map, ki jih je mogoče kategorizirati kot dokument, knjižnica vdelane programske opreme, orodja itd., ki se nahajajo v imeniku, kot je prikazano na naslednji sliki. V mapi Firmware Library je stisnjena knjižnica vdelane programske opreme HT32 file z imenom HT32_STD_xxxxxx_FWLib_Vm.n.r_s.zip, kot je prikazano spodaj.

Povezava za prenos: https://mcu.holtek.com.tw/ht32/resource/

Knjižnica vdelane programske opreme

Terminalski program

Prijavna koda nprampProgram lahko pošilja sporočila prek vrat COM za izbiro funkcije ali prikaz stanja. Uporabniki lahko na gostiteljski računalnik namestijo ustrezno komunikacijsko programsko opremo, kot je Tera Term, ki je program brez licence.

Konfiguracija vmesnika UART v exampprogram ima 8-bitni format podatkov. Paritetnega bita ni. Ima en stop bit in hitrost prenosa 115200 baud.

Namestitev prevajalnika GNU Arm

To poglavje opisuje namestitev prevajalnika GNU Arm, ki je razložena v razdelkih »Namestitev GNU Arm« in »Preizkus«.

Namestitev GNU Arm

Korak 1. Prenesite EXE file za namestitev GNU Arm na naslednji povezavi.

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

Opomba: Glede na informacije o posodobitvi Arm GNU Toolchain 2022 je prejšnja različica razvrščena kot ukinjena file. The file imena, uporabljena v tem članku in zadnji ukinjeni različici, so naslednja:

The file ime, uporabljeno v tem članku, je: »gcc-arm-11.2-2022.02-mingw-w64-i686-arm-none-eabi.exe«.
The file ime za zadnjo ukinjeno različico je: "gcc-arm-none-eabi-10.3-2021.10- win32.exe".

2. korak. V koraku »Izberite lokacijo namestitve«, kot je prikazano na naslednji sliki, shranite namestitveno pot med namestitvijo. Ta pot bo konfigurirana v Keilu v poglavju »Uporaba s Keil MDK-ARM uVision«.
Na primerample:
“C:\Program Files (x86)\Arm GNU Toolchain arm-none-eabi\11.2 2022.02".
Namestitev GNU Arm

Korak 3. Med zadnjim korakom namestitve izberite »Dodaj pot do spremenljivke okolja« in kliknite »Dokončaj«.
Namestitev GNU Arm

Opomba: Ko je namestitev končana, znova zaženite računalnik.

Test

Prevajalnik GNU Arm med namestitvijo doda pot do spremenljivke okolja, kot je prikazano v 3. koraku v razdelku »Namestitev GNU Arm«. V tem razdelku je razloženo, kako uporabiti »ukazni poziv« za preizkus, ali je namestitev GNU Arm končana.

Korak 1. Omogočite ukazni poziv.
Obstaja več načinov za omogočanje ukaznega poziva, ki bodo razloženi v oknu »Zaženi« in izbiri »Meni« v naslednjem razdelku.

  • Omogoči prek okna »Zaženi«: Najprej pritisnite tipki »Windows + R« na tipkovnici in v pojavno okno »Zaženi« vnesite »cmd«, kot je prikazano na naslednji sliki. Nato pritisnite »V redu«, da omogočite ukazni poziv.
    Test
  • Izberite iz »Meni«: kliknite meni »Start«, nato poiščite in odprite sistemsko mapo Windows. Kliknite »Ukazni poziv«, kot je prikazano na naslednji sliki.
    Test

2. korak. V omogočen ukazni poziv vnesite »arm-none-eabi-gcc -v« in prikazal se bo naslednji zaslon, ki označuje, da je ukaz veljaven. To pomeni, da je namestitev GNU Arm končana in da je programsko kodo Arm mogoče prevesti. Istočasno je pot namestitve mogoče potrditi z izhodom ukaznega poziva. To je prikazano s potjo, označeno s pikčasto črto v rdečem pikčastem polju na sliki.

Test

Uporablja se z GNU Make

To poglavje opisuje, kako uporabljati prevajalnik GNU Arm z GNU Make.

Namestitev GNU Make

Korak 1. Kliknite naslednjo povezavo za prenos EXE file za GNU Make namestitev.

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

Opomba: The file ime je podobno "make-3.81.exe

2. korak. V koraku »Izberite ciljno lokacijo«, kot je prikazano na naslednji sliki, kopirajte in shranite namestitveno pot med namestitvijo. Pot bo pozneje konfigurirana v spremenljivko okolja. Na primerample:
“C:\Program Files (x86)\GnuWin32”
Uporablja se z GNU Make

3. korak. Skopirani poti v 2. koraku dodajte dodaten znak »\bin« in jo konfigurirajte v spremenljivki okolja »Pot«, da dodate pot za orodje GNU Make. Glejte naslednji sliki, ki prikazujeta, kako omogočiti spremenljivko okolja, in poiščite urejanje »Pot« ter dodajte pot.
Opomba: celotna pot je podobna »C:\Program Files (x86)\GnuWin32\bin«.
Uporablja se z GNU Make

4. korak. Preizkusite ukaz »make-v« z uporabo ukaznega poziva in prikazal se bo naslednji zaslon, ki nakazuje, da je ukaz veljaven. To pomeni, da je namestitev GNU Make končana.
Opomba: Glejte vsebino »Omogoči ukazni poziv« v razdelku »Preizkus« za način omogočanja ukaznega poziva.
Uporablja se z GNU Make

Prevedi in izpiši

V tem razdelku bo opisana metoda prevajanja in izhodni rezultati z uporabo predloge projekta knjižnice vdelane programske opreme (…\projektna predloga\IP\Example), ki vključuje ukaze za prevajanje, izhodna sporočila in izhod files itd.
1. korak. Omogočite ukazni poziv in spremenite operacijski imenik v mapo »GNU_ARM« v predlogi projekta knjižnice vdelane programske opreme.
(\\HT32_STD_5xxxx_FWLib_Vm.n.r_s\project_template\IP\Example\GNU_ARM)
Prevedi in izpiši

2. korak. Vnesite ukaz »make xxxxx« ali »make –f xxxxx.mk« za izdelavo programa. Ko so vse operacije gradnje končane, se mora prikazati sporočilo »BUILD SUCCESSFUL«, kot je prikazano na naslednji sliki.
(xxxxx je naprava IC, tukaj je uporabljen 52352)
Prevedi in izpiši

Korak 3. Po končanem koraku 2, Hex in Binary files lahko najdete na naslednji poti. Nato posodobite vdelano programsko opremo na začetni komplet z drugimi orodji za programiranje, kot so e-Writer32, HT32 ICP Tool, e-Link32 Pro/Lite, HT32 Flash Programmer in ISP bootloader. Naslednji razdelek bo predstavil programiranje z uporabo e-Link32 Pro / Lite.
“…\GNU_ARM\HT32M\xxxxx\Obj\HT32.bin”
“…\GNU_ARM\HT32M\xxxxx\Obj\HT32.hex”
Prevedi in izpiši

Programiranje z uporabo e-Link32 Pro/Lite

Ta razdelek bo kot primer vzel začetni komplet HT32F52352 (SK).ample. Najprej predstavi postopke priprave okolja za začetni komplet (SK) in e-Link32 Pro / Lite, nato pa razloži, kako uporabiti »make IC=xxxxx eraseall/program/run« in rezultate ukaznega poziva v zaporedju. Nazadnje pojasnjuje, kako prek statusa SK opazovati, ali je programiranje uspešno ali ne.
Postopki priprave okolja za SK in e-Link32 Lite so naslednji:
(1) Na plošči sta dve vrati USB COM. Tu je računalnik povezan z vrati e-Link32 Lite na plošči s kablom USB, kot je prikazano (a) na naslednji sliki.
(2) Za potrditev programiranja je potrebna funkcija VCP (Virtual COM Port) naprave e-Link32 Lite. Prepričajte se, da je pokrov mostička UART Jumper-J2*1 v kratkem stiku z nožicama PAx*2 in DAP_Tx. Lokacija mostička je prikazana z (b) na naslednji sliki.
Opomba: 1. J2 na SK ponuja dve nastavitvi, in sicer za kratko sklenitev zatičev PAx in DAP_Tx ali za kratko sklenitev zatičev PAx in RS232_Tx. Za podrobnosti glejte uporabniški priročnik za začetni komplet.
2. Zatič je tukaj poimenovan PAx, ker se nastavitev za zatič MCU UART RX razlikuje v različnih SK.
Programiranje z uporabo e-Link32 Pro/Lite
Postopki priprave okolja za SK in e-Link32 Pro so naslednji: Ena stran e-Link32 Pro je povezana z računalnikom s podatkovnim kablom Mini USB, druga stran pa je za vmesnik SWD. e-Link32 Pro je potreben za povezavo s SWD-10P na SK z 10-polnim sivim ploščatim kablom, kot je prikazano na naslednji sliki (a).
Prevajalnik HT32 MCU GNU Arm

V naslednjem razdelku bo opisana uporaba ukaza »make IC=xxxxx eraseall/program/run« in rezultati ukaznega poziva v zaporedju.

Korak 1. V okno »Ukazni poziv« vnesite ukaz »make IC=xxxxx eraseall« ali »make-f xxxxx.mk eraseall«. Če je uspešen, se na zaslonu prikaže sporočilo »ERASEALL SUCCESS«, kot je prikazano na naslednji sliki.
(xxxxx je naprava IC, tukaj je uporabljen 52352).
Opomba: Ta ukaz se uporablja za izvedbo operacije Flash Mass Erase.
Programiranje z uporabo e-Link32 Pro/Lite

2. korak. Vnesite ukaz »make IC=xxxxx program« ali »make-f xxxxx.mk program« v okno »Command Prompt«. Če je program uspešen, se na zaslonu prikaže sporočilo »PROGRAM SUCCESS«, kot je prikazano na naslednji sliki.
(xxxxx je naprava IC, tukaj je uporabljen 52352).
Programiranje z uporabo e-Link32 Pro/Lite

3. korak. Vnesite ukaz »make IC=xxxxx run« ali »make-f xxxxx.mk run« v okno »Command Prompt«. Če je uspešen, se na zaslonu prikaže sporočilo »RUN SUCCESS«, kot je prikazano na naslednji sliki. SK bo deloval po prampin njegov status ob uspešnem programiranju je prikazan v 4. koraku.
(xxxxx je naprava IC, tukaj je uporabljen 52352)
Programiranje z uporabo e-Link32 Pro/Lite

4. korak. Ko se dejanje 3. koraka konča, se ta korak nadaljuje, da se ugotovi, ali je bilo programiranje uspešno s preverjanjem statusa SK. To je mogoče preveriti z LED ali terminalsko programsko opremo. Glejte razdelek »Programska oprema terminala« za nastavitve programske opreme terminala. Opis stanja bo podan spodaj.
Ko se na zaslonu prikaže sporočilo »RUN SUCCESS«, utripata LED1 in LED2. Njihov položaj je prikazan spodaj levo na naslednji sliki. Nato se prikaže naslednje sporočilo »Hello World! 0” ~ “Pozdravljen svet! 99” v terminalski programski opremi računalnika prek navideznih vrat COM, kot je prikazano na desni strani naslednje slike. Oboje je mogoče uporabiti za preverjanje, ali je bilo okolje uspešno uporabljeno.
Programiranje z uporabo e-Link32 Pro/Lite

Opis nastavitve

Ta razdelek opisuje povezane filev imeniku GNU_ARM, kot je prikazano v naslednji tabeli.

Mapa/File Ime Opis
\\projektna_predloga\IP\Example\GNU_ARM
xxxxx.mk Naredifile file, xxxxx je naprava IC
povezovalec.ld Skript za povezovanje
Naredifile Naredifile file
Projekt_xxxxx.uvprojx Projekt, xxxxx je naprava IC

Zdaj bo razloženo, kako dodati .c file, vključite pot ali predprocesor C/S Definirajte s spreminjanjem znamkefile file z imenom "xxxxx.mk".

Opomba: ta razdelek uporablja 52352.mk kot ilustracijo.

  • Dodajte .c file. Ta del se uporablja za nastavitev projekta .c file, se uporablja naslednja metoda.
    • Odprite 52352.mk, poiščite »Source files«, se na zaslonu prikažejo spodnje nastavitve,
      ki jih je mogoče dodati z uporabo “SOURCE_NAME_PATH +=” append “.c file pot in ime«.
  • Vključi pot. Ta del se uporablja za dodajanje Vključi poti, ki nudi več poti za iskanje glave file (.h file), se uporablja naslednja metoda.
    • Odprite 52352.mk, poiščite »Vključi pot«, na zaslonu se prikažejo nastavitve, prikazane spodaj, ki jih je mogoče dodati z uporabo »INCLUDE_PATH += -I./ « in dodajte »Pot«.
  • Definicija predprocesorja C/S. Ta del se uporablja za dodajanje sporočila Preprocessor Define, uporabljena je naslednja metoda.
    • Odprite 52352.mk, poiščite »Preprocessor Define«, na zaslonu se prikažejo spodnje nastavitve. Metode dodajanja za .c Preprocessor Define se nekoliko razlikujejo od .s Preprocessor Define. To je urejeno na naslednji način.
      ► c Predprocesor Definirajte: “C_Option += -D” + “Definiraj vsebino” Na primerample: C_MOŽNOST += -DUSE_HT32_DRIVER.
      ► .h Predprocesor Definirajte: “S_Option = –defsym” + “Definiraj vsebino” Na primerample: S_OPTION = –defsym USE_HT32_CHIP=4
      Opis nastavitve

Uporablja se s Keil MDK-ARM uVision

V tem poglavju je opisano, kako uporabljati prevajalnik GNU Arm s Keil MDK-ARM uVision. Opomba: Ta del zahteva uporabo Keil MDK-ARM. Najprej pojdi do uradnika Keila webmesto za pridobitev EXE file za namestitev Keil MDK-ARM in dokončajte namestitev. Uradnik Keil webpovezava za namestitev spletnega mesta je naslednja.

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

Opomba: The file ime je podobno »MDK537.EXE«.

Nastavitve projekta

Korak 1. Odprite projekt Project_xxxxxx.uvprojx file iz knjižnice vdelane programske opreme. Tukaj je uporabljen 52352.
\\HT32_STD_5xxxx_FWLib_Vm.n.r_s \projektna_predloga\IP\Example\GNU_ARM\Project_xxxxx.uvprojx Opomba: xxxxx je ime naprave.

Nastavitve projekta

2. korak. Kliknite ikono »Upravljanje elementov projekta« in nato kliknite možnost »Mape/razširitve«. Izberite »Uporabi prevajalnik GCC (GNU) za projekte ARM« in nato kopirajte namestitveno pot GNU Arm v besedilno polje »Mapa«, kot je prikazano na naslednji sliki.
Opomba: Za namestitveno pot GNU Arm glejte pot, kopirano v 2. koraku razdelka »Namestitev GNU Arm« v poglavju »Namestitev prevajalnika GNU Arm«.
Nastavitve projekta

Prevedi in preizkusi

Korak 1. Kliknite »Build (F7)«, da zgradite projekt.
2. korak. Preverite okno »Build Output«, da potrdite, ali je bil program pravilno zgrajen.
Prevedi in preizkusi
3. korak. Povežite vrata COM e-link32 lite USB na kompletu HT32F52352 Starter Kit z osebnim računalnikom, kot je prikazano v rdečem polju na levi strani naslednje slike. Potrdite, da je računalnik normalno zaznal napravo USB, kot je prikazano v rdečem polju na desni strani naslednje slike.
Prevedi in preizkusi
Korak 4. Kliknite »Prenos (F8)«, da prenesete kodo v pomnilnik Flash.
Prevedi in preizkusi
Korak 5. Na zatičih DAP_TX in PA5 se namesti premostitveni pokrovček, ki ju skrajša, kot je prikazano na naslednji sliki. Nato bo programska oprema PC terminala (Tera Term) konfigurirana in vrata COM bodo nastavljena v skladu s 3. korakom. Glejte razdelek »Terminalna programska oprema« za podrobno konfiguracijo Tera Term.
Prevedi in preizkusi
Korak 6. Ko pritisnete tipko “Reset”, bosta tako LED1 kot LED2 utripali, kot je prikazano na levi strani naslednje slike. Sporočila »Hello World! 0” ~ “Pozdravljen svet! 99« se prikaže v oknu »Tera Term« prek navideznih vrat COM, kot je prikazano na desni strani naslednje slike. To se uporablja za preverjanje, ali je bil uspešno uporabljen s prevajalnikom Keil MDK-ARM uVision GNU Arm.
Prevedi in preizkusi

Pogoste težave

To poglavje pomaga pri nekaterih pogostih težavah, na katere lahko naletite.

Sporočila o napakah, ki se lahko pojavijo po gradnji

  • Če izvedete »After Build«, bo ustvarjeno naslednje sporočilo o napaki. Poskusite znova zagnati računalnik ali zagnati Keil MDK-ARM kot skrbnik, da bo operacija »Po gradnji« uspešna.
    Pogoste težave
    Če te težave ni mogoče rešiti z zgornjimi koraki, lahko uporabnik tudi onemogoči možnost »Po izdelavi/ponovni izdelavi«, kot je prikazano na naslednji sliki.
    Opomba: Ko je možnost »Po izdelavi/ponovni izdelavi« onemogočena, Keil ne bo več oddajal sporočil v binarnem formatu in velikosti kode.
    Pogoste težave
Zahteve za različico knjižnice vdelane programske opreme

Če se »GNU Arm Compiler« uporablja z »GNU Make« ali »Keil MDK-ARM uVision«, je treba upoštevati, da samo naslednja različica ali višje različice knjižnice vdelane programske opreme podpirajo projekt GNU Arm files.

  • HT32_STD_5xxxx_FWLib_V1.0.26_nnnn.zip
  • HT32_STD_1xxxx_FWLib_V1.0.11_nnnn.zip

Zaključek

Ta opomba o aplikaciji je najprej podala kratek opis GNU Arm. Temu je sledila razlaga, ki je uporabnikom pokazala, kako namestiti in preizkusiti prevajalnik GNU Arm. Nato je opisano, kako ga uporabljati z »GNU Make« ali »Keil MDK-ARM uVision«. Nazadnje je sledila razlaga, kako uporabljati prevajalnik GNU Arm z mikrokontrolerji HT32.

Referenčni material

Za več informacij se obrnite na uradnega Holteka webspletno mesto: www.holtek.com.

Informacije o revizijah in spremembah

Datum Avtor Izdaja Informacije o spremembah
2022.05.13 蔡期育 V1.00 Prva različica

Zavrnitev odgovornosti

Vse informacije, blagovne znamke, logotipi, grafike, videi, zvočni posnetki, povezave in drugi elementi, ki se pojavljajo na tem webspletno mesto ('Informacije') so samo za referenco in se lahko kadar koli spremenijo brez predhodnega obvestila in po presoji družbe Holtek Semiconductor Inc. in njenih povezanih družb (v nadaljevanju 'Holtek', 'podjetje', 'nas', ' mi« ali »naš«). Medtem ko si Holtek prizadeva zagotoviti točnost informacij o tem webstrani, Holtek ne daje nobenega izrecnega ali implicitnega jamstva za točnost informacij. Holtek ne prevzema nobene odgovornosti za kakršno koli nepravilnost ali uhajanje.

Holtek ne bo odgovoren za nobeno škodo (vključno, vendar ne omejeno na računalniške viruse, sistemske težave ali izgubo podatkov), ki bi nastala pri uporabi ali v povezavi z uporabo tega webkatero koli stran. Na tem področju so lahko povezave, ki vam omogočajo obisk webstrani drugih podjetij. te webstrani niso pod nadzorom Holteka. Holtek ne prevzema nikakršne odgovornosti in jamstva za kakršne koli informacije, prikazane na takšnih straneh. Hiperpovezave do drugih webspletna mesta so na lastno odgovornost.

Omejitev odgovornosti

Holtek Limited v nobenem primeru ne bo odgovoren nobeni drugi stranki za kakršno koli izgubo ali škodo, ki je nastala neposredno ali posredno v povezavi z vašim dostopom ali uporabo tega webspletnega mesta, vsebine na njem ali katerega koli blaga, materiala ali storitev.

Veljavno pravo

Zavrnitev odgovornosti, ki jo vsebuje webspletno mesto ureja in razlaga v skladu z zakoni Republike Kitajske. Uporabniki se bodo podredili neizključni pristojnosti sodišč Republike Kitajske

Posodobitev izjave o omejitvi odgovornosti

Holtek si pridržuje pravico, da kadar koli posodobi Izjavo o zavrnitvi odgovornosti s predhodnim obvestilom ali brez njega, vse spremembe začnejo veljati takoj po objavi na webmesto.

Logotip HOLTEK

Dokumenti / Viri

Prevajalnik HOLTEK HT32 MCU GNU Arm [pdf] Uporabniški priročnik
HT32 MCU, HT32 MCU GNU Arm prevajalnik, GNU Arm prevajalnik, Arm prevajalnik

Reference

Pustite komentar

Vaš elektronski naslov ne bo objavljen. Obvezna polja so označena *