Kompilátor ramena GNU HOLTEK HT32 MCU

Úvod

Existuje mnoho druhov dostupných kompilátorov, niektoré bežne používané sú Keil (MDK-ARM), IAR (EWARM), GNU (GNU ARM) atď. Ak sa „GNU“ porovná s „Keil“ a „IAR“, hlavný rozdiel je v tom, že GNU je voľne použiteľný a Keil aj IAR majú zaplatené licencie, inak bude obmedzená veľkosť programu. Ako je možné vidieť na nasledujúcom obrázku, v porovnaní s Keil MDK-ARM má GNU Arm výhodutage bez obmedzenia veľkosti a jeho použitie je pohodlnejšie. Táto aplikačná poznámka popisuje, ako používať GNU Arm Compiler s HT32 MCU.
Táto poznámka k aplikácii najprv popisuje stiahnutie a prípravu zdroja. Sťahovanie file obsahuje knižnicu firmvéru, ktorá obsahuje examppožadovaný program počas testovacieho procesu. BývalýampProgram môže prenášať správy cez port COM, preto sa na výber funkcie alebo zobrazenie stavu použije softvér terminálu. Inštalácia a používanie GNU Arm Compiler budú predstavené postupne a môžu byť použité s „GNU Make“ alebo „Keil MDKARM uVision“. Nakoniec sa poskytuje pomoc pri riešení bežných problémov počas inštalácie, čo používateľom umožňuje nájsť riešenie, keď sa vyskytnú problémy. Používateľom tiež pomáha rýchlo vytvoriť prostredie, ktoré bude používať kompilátor GNU Arm.

Stiahnutie a príprava zdrojov

Táto kapitola popisuje example programu a požadovaných softvérových nástrojov a vysvetľuje, ako nakonfigurovať adresár a file cesta.

Firmvérová knižnica

Pred použitím example programu, stiahnite si najnovšiu knižnicu firmvéru Holtek HT32 z nasledujúceho odkazu a potom rozbalte stiahnutý file. Uistite sa, že bola vybratá správna knižnica firmvéru HT32. Napríkladample HT32_M0p_Vyyyymmdd.zip je pre sériu MCU HT32F5xxxx a HT32_M3_Vyyyymmdd.zip sa poskytuje pre sériu MCU HT32F1xxxx.
Toto stlačené file obsahuje niekoľko priečinkov, ktoré možno kategorizovať ako Dokument, Knižnica firmvéru, Nástroje atď., ktoré sa nachádzajú v adresári, ako je znázornené na nasledujúcom obrázku. V priečinku Firmware Library je umiestnená komprimovaná knižnica firmvéru HT32 file s názvom HT32_STD_xxxxx_FWLib_Vm.n.r_s.zip, ako je uvedené nižšie.

Odkaz na stiahnutie: https://mcu.holtek.com.tw/ht32/resource/

Program terminálu

Aplikačný kód exampProgram môže prenášať správy cez port COM na výber funkcie alebo zobrazenie stavu. Používatelia si môžu na hostiteľský počítač nainštalovať vhodný komunikačný softvér, ako napríklad Tera Term, čo je bezlicenčný program.

Konfigurácia rozhrania UART v príkladeampTento program má 8-bitový dátový formát. Neexistuje žiadny paritný bit. Má jeden stop bit a prenosovú rýchlosť 115200.

Inštalácia kompilátora GNU Arm

Táto kapitola popisuje inštaláciu GNU Arm Compiler, ktorá je vysvetlená v častiach „Inštalácia GNU Arm“ a „Test“.

Inštalácia ramena GNU

Krok 1. Stiahnite si súbor EXE file pre inštaláciu GNU Arm z nasledujúceho odkazu.

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

Poznámka: Podľa informácií o aktualizácii Arm GNU Toolchain 2022 je predchádzajúca verzia klasifikovaná ako ukončená file. The file názvy použité v tomto článku a najnovšia ukončená verzia sú nasledovné:

The file názov použitý v tomto článku je: „gcc-arm-11.2-2022.02-mingw-w64-i686-arm-none-eabi.exe“.
The file názov najnovšej ukončenej verzie je: „gcc-arm-none-eabi-10.3-2021.10- win32.exe“.

Krok 2. V kroku „Vyberte umiestnenie inštalácie“, ako je znázornené na nasledujúcom obrázku, uložte cestu inštalácie počas inštalácie. Táto cesta bude nakonfigurovaná v Keil v kapitole „Používané s Keil MDK-ARM uVision“.
Napríkladample:
"C:\Program Files (x86)\Arm GNU Toolchain arm-none-eabi\11.2 2022.02“.

Krok 3. Počas posledného kroku inštalácie vyberte „Pridať cestu k premennej prostredia“ a kliknite na „Dokončiť“.

Poznámka: Po dokončení inštalácie reštartujte počítač.

Test

Kompilátor GNU Arm pridáva cestu k premennej prostredia počas inštalácie, ako je znázornené v kroku 3 v časti „Inštalácia GNU Arm“. Táto časť vysvetlí, ako použiť „Príkazový riadok“ na testovanie, či sa inštalácia GNU Arm dokončila.

Krok 1. Povoľte príkazový riadok.
Existuje niekoľko spôsobov aktivácie príkazového riadka, ktoré budú vysvetlené v okne „Spustiť“ a vo výbere „Ponuka“ v nasledujúcej časti.

• Povolenie cez okno „Spustiť“: Najprv stlačte klávesy „Windows + R“ na klávesnici a do vyskakovacieho okna „Spustiť“ zadajte „cmd“, ako je znázornené na nasledujúcom obrázku. Potom stlačte „OK“, aby ste povolili príkazový riadok.
  
• Vyberte z ponuky „Ponuka“: Kliknite na ponuku „Štart“, potom vyhľadajte a otvorte priečinok Systém Windows. Kliknite na „Príkazový riadok“, ako je znázornené na nasledujúcom obrázku.
  

Krok 2. Do aktivovaného príkazového riadka zadajte „arm-none-eabi-gcc -v“ a zobrazí sa nasledujúca obrazovka, ktorá indikuje, že príkaz je platný. To znamená, že inštalácia GNU Arm je dokončená a že je možné skompilovať programový kód Arm. Zároveň je možné potvrdiť cestu inštalácie pomocou výstupu príkazového riadka. Znázorňuje to cesta označená bodkovanou čiarou v červenom bodkovanom rámčeku na obrázku.

Používa sa s GNU Make

Táto kapitola popisuje, ako používať GNU Arm Compiler s GNU Make.

Inštalácia GNU Make

Krok 1. Kliknutím na nasledujúci odkaz stiahnete súbor EXE file pre inštaláciu GNU Make.

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

Poznámka: The file názov je podobný ako „make-3.81.exe

Krok 2. V kroku “Select Destination Location” (Výber cieľového umiestnenia), ako je znázornené na nasledujúcom obrázku, skopírujte a uložte cestu inštalácie počas inštalácie. Cesta bude nakonfigurovaná do premennej prostredia neskôr. Napríkladample:
"C:\Program Files (x86)\GnuWin32”

Krok 3. Pridajte ďalší znak „\bin“ do skopírovanej cesty v kroku 2 a nakonfigurujte ho v premennej prostredia „Path“, aby ste pridali cestu pre nástroj GNU Make. Pozrite si dva nasledujúce obrázky, ktoré znázorňujú, ako povoliť premennú prostredia, a nájdite úpravu „Cesta“ a pridajte cestu.
Poznámka: Celá cesta je podobná ako „C:\Program Files (x86)\GnuWin32\bin“.

Krok 4. Otestujte príkaz „make-v“ pomocou príkazového riadka a zobrazí sa nasledujúca obrazovka, ktorá indikuje, že príkaz je platný. To znamená, že inštalácia GNU Make bola dokončená.
Poznámka: Spôsob aktivácie príkazového riadka nájdete v časti „Povolenie príkazového riadka“ v časti „Test“.

Kompilácia a výstup

Táto časť popisuje spôsob kompilácie a výstupné výsledky pomocou šablóny projektu Firmware Library (…\project template\IP\Example), ktorý zahŕňa príkazy na kompiláciu, výstupné správy a výstup files atď.
Krok 1. Zapnite príkazový riadok a zmeňte operačný adresár na priečinok „GNU_ARM“ v šablóne projektu Firmware Library.
(\\HT32_STD_5xxxx_FWLib_Vm.n.r_s\project_template\IP\Example\GNU_ARM)

Krok 2. Zadajte príkaz „make xxxxx“ alebo „make –f xxxxx.mk“ na vytvorenie programu. Po dokončení všetkých operácií zostavenia by sa mala objaviť správa „BUILD SUCCESSFUL“, ako je znázornené na nasledujúcom obrázku.
(xxxxx je IC zariadenie, tu sa používa 52352)

Krok 3. Po dokončení kroku 2, Hex a Binary files nájdete v nasledujúcej ceste. Potom aktualizujte firmvér na Starter Kit pomocou iných programovacích nástrojov, ako sú e-Writer32, HT32 ICP Tool, e-Link32 Pro/Lite, HT32 Flash Programmer a ISP bootloader. Nasledujúca časť predstaví programovanie pomocou e-Link32 Pro / Lite.
„…\GNU_ARM\HT32M\xxxxx\Obj\HT32.bin“
„…\GNU_ARM\HT32M\xxxxx\Obj\HT32.hex“

Programovanie pomocou e-Link32 Pro/Lite

Táto sekcia bude obsahovať HT32F52352 Starter Kit (SK) ako príkladample. Najprv predstavuje operácie prípravy prostredia pre súpravu Starter Kit (SK) a e-Link32 Pro / Lite a potom vysvetľuje, ako v sekvencii použiť „make IC=xxxxx eraseall/program/run“ a príkazový riadok. Nakoniec vysvetľuje, ako sledovať, či je programovanie úspešné alebo nie, prostredníctvom stavu SK.
Operácie prípravy prostredia pre SK a e-Link32 Lite sú nasledovné:
(1) Na doske sú dva porty USB COM. Tu je počítač pripojený k portu e-Link32 Lite na doske pomocou kábla USB, ako je znázornené (a) na nasledujúcom obrázku.
(2) Funkcia VCP (Virtual COM Port) e-Link32 Lite je potrebná na potvrdenie programovania. Uistite sa, že kryt prepojky UART Jumper-J2*1 skratuje kolíky PAx*2 a DAP_Tx. Umiestnenie prepojky je znázornené (b) na nasledujúcom obrázku.
Poznámka: 1. J2 na SK poskytuje dve nastavenia, ktorými sú skratovanie pinov PAx a DAP_Tx alebo skratovanie pinov PAx a RS232_Tx. Podrobnosti nájdete v príručke používateľa Starter Kit.
2. Pin je tu pomenovaný PAx, pretože nastavenie pinu MCU UART RX sa v rôznych SK líši.

Operácie prípravy prostredia pre SK a e-Link32 Pro sú nasledovné: Jedna strana e-Link32 Pro je pripojená k PC pomocou dátového kábla Mini USB a druhá strana je pre rozhranie SWD. e-Link32 Pro sa vyžaduje na pripojenie k SWD-10P na SK pomocou 10-pinového šedého plochého kábla, ako je znázornené na nasledujúcom obrázku (a).

Nasledujúca časť popisuje použitie príkazu „make IC=xxxxx eraseall/program/run“ a výsledky príkazového riadka v poradí.

Krok 1. Zadajte príkaz „make IC=xxxxx eraseall“ alebo „make-f xxxxx.mk eraseall“ v okne „Command Prompt“. Ak bude úspešný, na obrazovke sa zobrazí správa „ERASEALL SUCCESS“, ako je znázornené na nasledujúcom obrázku.
(xxxxx je IC zariadenie, tu sa používa 52352).
Poznámka: Tento príkaz sa používa na vykonanie operácie hromadného vymazania blesku.

Krok 2. Zadajte príkaz „make IC=xxxxx program“ alebo „make-f xxxxx.mk program“ v okne „Príkazový riadok“. Ak je program úspešný, na obrazovke sa zobrazí správa „PROGRAM SUCCESS“, ako je znázornené na nasledujúcom obrázku.
(xxxxx je IC zariadenie, tu sa používa 52352).

Krok 3. Zadajte príkaz „make IC=xxxxx run“ alebo „make-f xxxxx.mk run“ v okne „Command Prompt“. V prípade úspechu sa na obrazovke zobrazí správa „RUN SUCCESS“, ako je znázornené na nasledujúcom obrázku. SK bude fungovať podľa exampProgram a jeho stav po úspešnom naprogramovaní sa zobrazí v kroku 4.
(xxxxx je IC zariadenie, tu sa používa 52352)

Krok 4. Po dokončení akcie Krok 3 bude tento krok pokračovať, aby sa zistilo, či bolo programovanie úspešné, a to kontrolou stavu SK. Dá sa to overiť pomocou LED alebo terminálového softvéru. Nastavenia softvéru terminálu nájdete v časti „Softvér terminálu“. Popis stavu bude uvedený nižšie.
Keď sa na obrazovke objaví správa „RUN SUCCESS“, LED1 aj LED2 budú blikať. Ich polohy sú znázornené na nasledujúcom obrázku vľavo dole. Potom sa zobrazí nasledujúca správa „Ahoj svet! 0" ~ "Ahoj Svet! 99” na terminálovom softvéri PC cez virtuálny COM port, ako je znázornené na pravej strane nasledujúceho obrázku. Oboje možno použiť na overenie, či bolo prostredie úspešne použité.

Popis nastavenia

Táto časť popisuje súvisiace filev adresári GNU_ARM, ako je uvedené v nasledujúcej tabuľke.

Priečinok/File Meno	Popis
\\project_template\IP\Prample\GNU_ARM
xxxxx.mk	Makefile file, xxxxx je IC zariadenie
linker.ld	Linker Script
Makefile	Makefile file
Project_xxxxx.uvprojx	Project, xxxxx je IC zariadenie

Teraz bude vysvetlené, ako pridať .c file, vrátane cesty alebo C/S Preprocessor Definujte úpravou značkyfile file s názvom „xxxxx.mk“.

Poznámka: Táto časť používa 52352.mk ako ilustráciu.

• Pridať .c file. Táto časť slúži na nastavenie projektu .c file, používa sa nasledujúca metóda.
  • Otvorte 52352.mk, vyhľadajte „Source files“, na obrazovke sa zobrazia nižšie uvedené nastavenia,
    ktoré je možné pridať pomocou „SOURCE_NAME_PATH +=“ pridať „.c file cestu a meno“.
• Zahrnúť cestu. Táto časť sa používa na pridanie Zahrnúť cesty, ktoré poskytujú viacero ciest na vyhľadávanie hlavičky file (.h file), použije sa nasledujúca metóda.
  • Otvorte 52352.mk, vyhľadajte „Include Path“, na obrazovke sa zobrazia nižšie uvedené nastavenia, ktoré je možné pridať pomocou „INCLUDE_PATH += -I./ ” pridania „Cesta“.
• Definícia predprocesora C/S. Táto časť sa používa na pridanie správy Definovanie preprocesora, používa sa nasledujúca metóda.
  • Otvorte 52352.mk, vyhľadajte „Preprocessor Define“, na obrazovke sa zobrazia nižšie uvedené nastavenia. Metódy pridávania pre .c Preprocessor Define sa mierne líšia od .s Preprocessor Define. Toto je usporiadané nasledovne.
    ► c Definícia predprocesora: „C_Option += -D“ + „Definovať obsah“ Napr.ampsúbor: C_OPTION += -DUSE_HT32_DRIVER.
    ► .h Definícia preprocesora: “S_Option = –defsym” + “Definovať obsah” Napr.ampsúbor: S_OPTION = –defsym USE_HT32_CHIP=4
    

Používa sa s Keil MDK-ARM uVision

Táto kapitola popisuje, ako používať kompilátor GNU Arm s Keil MDK-ARM uVision. Poznámka: Táto časť vyžaduje použitie Keil MDK-ARM. Najprv choďte za úradníkom Keil webna získanie súboru EXE file pre inštaláciu Keil MDK-ARM a dokončite inštaláciu. Úradník Keil webodkaz na inštaláciu stránky je nasledujúci.

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

Poznámka: The file názov je podobný ako „MDK537.EXE“.

Nastavenia projektu

Krok 1. Otvorte projekt Project_xxxxx.uvprojx file z knižnice firmvéru. Tu sa používa 52352.
\\HT32_STD_5xxxx_FWLib_Vm.n.r_s \project_template\IP\Example\GNU_ARM\Project_xxxxx.uvprojx Poznámka: xxxxx je názov zariadenia.

Krok 2. Kliknite na ikonu „Spravovať položky projektu“ a potom kliknite na možnosť „Priečinky/Rozšírenia“. Vyberte „Použiť kompilátor GCC (GNU) pre projekty ARM“ a potom skopírujte cestu inštalácie GNU Arm do textového poľa „Priečinok“, ako je znázornené na nasledujúcom obrázku.
Poznámka: Cestu inštalácie GNU Arm nájdete v ceste skopírovanej v kroku 2 časti „Inštalácia GNU Arm“ v kapitole „Inštalácia kompilátora GNU Arm“.

Zostavte a otestujte

Krok 1. Kliknutím na „Vytvoriť (F7)“ vytvoríte projekt.
Krok 2. Skontrolujte okno „Build Output“ a potvrďte, či bol program zostavený správne.

Krok 3. Pripojte e-link32 lite USB COM port na HT32F52352 Starter Kit k PC, ako je znázornené v červenom rámčeku na ľavej strane nasledujúceho obrázku. Skontrolujte, či počítač normálne rozpoznal zariadenie USB, ako je znázornené v červenom poli na pravej strane nasledujúceho obrázku.

Krok 4. Kliknutím na „Stiahnuť (F8)“ stiahnete kód do pamäte Flash.

Krok 5. Na kolíky DAP_TX a PA5 sa umiestni prepojka, ktorá ich skratuje, ako je znázornené na nasledujúcom obrázku. Potom sa nakonfiguruje softvér PC terminálu (Tera Term) a COM port sa nastaví podľa kroku 3. Podrobnú konfiguráciu Tera Term nájdete v časti „Terminálový softvér“.

Krok 6. Po stlačení tlačidla „Reset“ budú LED1 aj LED2 blikať, ako je znázornené na ľavej strane nasledujúceho obrázku. Správy „Ahoj svet! 0" ~ "Ahoj Svet! 99“ sa objaví v okne „Tera Term“ cez virtuálny COM port, ako je znázornené na pravej strane nasledujúceho obrázku. Používa sa na overenie, že bol úspešne použitý s kompilátorom Keil MDK-ARM uVision GNU Arm.

Bežné problémy

Táto kapitola vám pomôže s niektorými bežnými problémami, s ktorými sa môžete stretnúť.

Chybové hlásenia, ktoré sa môžu zobraziť po zostavení

• Ak vykonáte „Po zostavení“, vygeneruje sa nasledujúce chybové hlásenie. Pokúste sa reštartovať počítač alebo spustiť Keil MDK-ARM ako správca, aby bola operácia „After Build“ úspešná.
  
  Ak sa tento problém nedá vyriešiť pomocou vyššie uvedených krokov, používateľ môže tiež zakázať možnosť „Po zostavení/prestavbe“, ako je znázornené na nasledujúcom obrázku.
  Poznámka: Keď je možnosť „Po zostavení/znovu zostavení“ vypnutá, Keil už nebude zobrazovať správy v binárnom formáte a veľkosti kódu.
  

Požiadavky na verziu knižnice firmvéru

Ak sa „GNU Arm Compiler“ používa s „GNU Make“ alebo „Keil MDK-ARM uVision“, treba poznamenať, že iba nasledujúca verzia alebo vyššie verzie knižnice firmvéru podporujú projekt GNU Arm files.

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

Záver

Táto aplikačná poznámka najprv poskytla stručný popis GNU Arm. Nasledovalo vysvetlenie, ktoré malo používateľom ukázať, ako nainštalovať a otestovať GNU Arm Compiler. Potom bolo opísané, ako ho používať s „GNU Make“ alebo „Keil MDK-ARM uVision“. Nakoniec bolo vysvetlené, ako používať GNU Arm Compiler s HT32 MCU.

Referenčný materiál

Ďalšie informácie získate od úradníka spoločnosti Holtek webstránka: www.holtek.com.

Informácie o revízii a úpravách

Dátum	Autor	Vydanie	Informácie o úprave
2022.05.13	蔡期育	V1.00	Prvá verzia

Vylúčenie zodpovednosti

Všetky informácie, ochranné známky, logá, grafika, videá, zvukové klipy, odkazy a ďalšie položky, ktoré sa tu objavujú webstránky (ďalej len „informácie“) sú len orientačné a môžu sa kedykoľvek zmeniť bez predchádzajúceho upozornenia a podľa uváženia spoločnosti Holtek Semiconductor Inc. a jej pridružených spoločností (ďalej len „Holtek“, „spoločnosť“, „nás“, „ my“ alebo „naše“). Zatiaľ čo Holtek sa snaží zabezpečiť presnosť informácií o tomto webSpoločnosť Holtek neposkytuje žiadnu výslovnú ani implicitnú záruku na presnosť informácií. Holtek nenesie žiadnu zodpovednosť za akúkoľvek nesprávnosť alebo únik.

Holtek nezodpovedá za žiadne škody (vrátane, ale nie výlučne, počítačového vírusu, systémových problémov alebo straty údajov), bez ohľadu na to, ktoré vzniknú pri používaní alebo v súvislosti s používaním tohto webstránky ktorejkoľvek strany. V tejto oblasti môžu byť odkazy, ktoré vám umožňujú navštíviť stránku webstránky iných spoločností. Títo webstránky nie sú kontrolované spoločnosťou Holtek. Holtek nenesie žiadnu zodpovednosť a žiadnu záruku za akékoľvek informácie zobrazené na takýchto stránkach. Hypertextové odkazy na iné webstránky sú na vlastné riziko.

Obmedzenie zodpovednosti

Holtek Limited v žiadnom prípade nezodpovedá žiadnej inej strane za akúkoľvek stratu alebo škodu spôsobenú priamo alebo nepriamo v súvislosti s vaším prístupom alebo používaním tohto webstránku, jej obsah alebo akýkoľvek tovar, materiály alebo služby.

Rozhodujúce právo

Vyhlásenie obsiahnuté v webstránky sa riadia a interpretujú v súlade so zákonmi Čínskej republiky. Používatelia budú podliehať nevýhradnej jurisdikcii súdov Čínskej republiky

Aktualizácia Vylúčenia zodpovednosti

Holtek si vyhradzuje právo aktualizovať Vyhlásenie kedykoľvek s predchádzajúcim upozornením alebo bez neho, všetky zmeny sú účinné okamžite po zverejnení na webstránky.

Dokumenty / zdroje

Kompilátor ramena GNU HOLTEK HT32 MCU [pdf] Používateľská príručka HT32 MCU, HT32 MCU GNU Arm Compiler, GNU Arm Compiler, Arm Compiler

Referencie

• Používateľská príručka