Kompilátor ramen GNU HOLTEK HT32 MCU

Zavedení

Existuje mnoho druhů dostupných kompilátorů, některé běžně používané jsou Keil (MDK-ARM), IAR (EWARM), GNU (GNU ARM) a tak dále. Pokud se „GNU“ porovnává s „Keil“ a „IAR“, hlavní rozdíl je v tom, že GNU je zdarma k použití a Keil i IAR mají zaplacené licence, jinak bude omezena velikost programu. Jak je vidět z následujícího obrázku, ve srovnání s Keil MDK-ARM má GNU Arm výhodutage bez omezení velikosti a jeho použití je pohodlnější. Tato aplikační poznámka popisuje, jak používat GNU Arm Compiler s HT32 MCU.
Tato poznámka k aplikaci nejprve popisuje stažení a přípravu zdroje. Stahování file obsahuje knihovnu firmwaru, která obsahuje example program požadovaný během procesu testování. BývalýampProgram může přenášet zprávy přes COM port, proto bude pro výběr funkce nebo zobrazení stavu použit software terminálu. Instalace a použití GNU Arm Compiler bude představeno postupně a může být použito s „GNU Make“ nebo „Keil MDKARM uVision“. Nakonec je poskytována pomoc při řešení běžných problémů během instalace, což uživatelům umožňuje najít řešení, když se setkají s problémy. Pomáhá také uživatelům rychle vytvořit prostředí pro použití GNU Arm Compiler.

Stažení a příprava zdrojů

Tato kapitola popisuje example a požadované softwarové nástroje a vysvětluje, jak nakonfigurovat adresář a file cesta.

Knihovna firmwaru

Před použitím exampprogramu, stáhněte si nejnovější knihovnu firmwaru Holtek HT32 z následujícího odkazu a poté stažené soubory dekomprimujte file. Ujistěte se, že byla vybrána správná knihovna firmwaru HT32. NapřampSoubor HT32_M0p_Vyyyymmdd.zip je určen pro řadu MCU HT32F5xxxx a soubor HT32_M3_Vyyyymmdd.zip je určen pro řadu MCU HT32F1xxxx.
Toto komprimováno file obsahuje několik složek, které lze kategorizovat jako Dokument, Knihovna firmwaru, Nástroje atd., které jsou umístěny v adresáři, jak je znázorněno na následujícím obrázku. Ve složce Firmware Library je umístěna komprimovaná knihovna firmwaru HT32 file s názvem HT32_STD_xxxxx_FWLib_Vm.n.r_s.zip, jak je uvedeno níže.

Odkaz ke stažení: https://mcu.holtek.com.tw/ht32/resource/

Terminálový program

Aplikační kód exampProgram může přenášet zprávy přes COM port pro výběr funkce nebo zobrazení stavu. Uživatelé mohou na hostitelský počítač nainstalovat vhodný komunikační software, jako je Tera Term, což je bezlicenční program.

Konfigurace rozhraní UART v příkladuampprogram má 8bitový datový formát. Neexistuje žádný paritní bit. Má jeden stop bit a přenosovou rychlost 115200.

Instalace kompilátoru GNU Arm

Tato kapitola popisuje instalaci GNU Arm Compiler, která je vysvětlena v částech „Instalace GNU Arm“ a „Test“.

Instalace GNU Arm

Krok 1. Stáhněte si soubor EXE file pro instalaci GNU Arm z následujícího odkazu.

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

Poznámka: Podle informací o aktualizaci Arm GNU Toolchain 2022 je předchozí verze klasifikována jako ukončená file. The file názvy použité v tomto článku a poslední ukončená verze jsou následující:

The file název použitý v tomto článku je: „gcc-arm-11.2-2022.02-mingw-w64-i686-arm-none-eabi.exe“.
The file název poslední ukončené verze je: „gcc-arm-none-eabi-10.3-2021.10-win32.exe“.

Krok 2. V kroku „Vyberte umístění instalace“, jak je znázorněno na následujícím obrázku, uložte během instalace instalační cestu. Tato cesta bude nakonfigurována v Keil v kapitole „Používáno s Keil MDK-ARM uVision“.
Napřampten:
"C:\Program Files (x86)\Arm GNU Toolchain arm-none-eabi\11.2 2022.02“.

Krok 3. Během posledního instalačního kroku vyberte „Přidat cestu k proměnné prostředí“ a klikněte na „Dokončit“.

Poznámka: Po dokončení instalace restartujte počítač.

Test

Kompilátor GNU Arm během instalace přidá cestu k proměnné prostředí, jak je znázorněno v kroku 3 v části „Instalace GNU Arm“. Tato část vysvětlí, jak používat „Příkazový řádek“ k testování, zda byla instalace GNU Arm dokončena.

Krok 1. Povolte příkazový řádek.
Existuje několik způsobů, jak povolit příkazový řádek, které budou vysvětleny v okně „Spustit“ a výběru „Nabídka“ v následující části.

• Povolení pomocí okna „Spustit“: Nejprve stiskněte klávesy „Windows + R“ na klávesnici a do vyskakovacího okna „Spustit“ zadejte „cmd“, jak je znázorněno na následujícím obrázku. Poté stisknutím tlačítka „OK“ povolte příkazový řádek.
  
• Vyberte z nabídky „Nabídka“: Klikněte na nabídku „Start“ a poté vyhledejte a otevřete složku Systém Windows. Klikněte na „Příkazový řádek“, jak je znázorněno na následujícím obrázku.
  

Krok 2. Do povoleného příkazového řádku zadejte „arm-none-eabi-gcc -v“ a zobrazí se následující obrazovka indikující, že příkaz je platný. To znamená, že instalace GNU Arm byla dokončena a že lze zkompilovat programový kód Arm. Současně lze cestu instalace potvrdit pomocí výstupu příkazového řádku. To je znázorněno cestou označenou tečkovanou čarou v červeném tečkovaném poli na obrázku.

Používá se s GNU Make

Tato kapitola popisuje, jak používat GNU Arm Compiler s GNU Make.

Instalace GNU Make

Krok 1. Klepnutím na následující odkaz stáhněte soubor EXE file pro instalaci GNU Make.

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

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

Krok 2. V kroku „Select Destination Location“, jak je znázorněno na následujícím obrázku, zkopírujte a uložte instalační cestu během instalace. Cesta bude později nakonfigurována do proměnné prostředí. Napřampten:
"C:\Program Files (x86)\GnuWin32”

Krok 3. Přidejte další znak „\bin“ do zkopírované cesty v kroku 2 a nakonfigurujte jej v proměnné prostředí „Path“ pro přidání cesty pro nástroj GNU Make. Podívejte se na dva následující obrázky, které ukazují, jak povolit proměnnou prostředí, a vyhledejte editaci „Cesta“ a přidejte cestu.
Poznámka: Celá cesta je podobná „C:\Program Files (x86)\GnuWin32\bin“.

Krok 4. Otestujte příkaz „make-v“ pomocí příkazového řádku a zobrazí se následující obrazovka indikující, že příkaz je platný. To znamená, že instalace GNU Make byla dokončena.
Poznámka: Způsob aktivace příkazového řádku naleznete v části „Povolení příkazového řádku“ v části „Test“.

Kompilace a výstup

Tato část popisuje metodu kompilace a výstupní výsledky pomocí šablony projektu Firmware Library (…\project template\IP\Example), který zahrnuje kompilační příkazy, výstupní zprávy a výstup files atd.
Krok 1. Povolte příkazový řádek a změňte operační adresář na složku „GNU_ARM“ v šabloně projektu Firmware Library.
(\\HT32_STD_5xxxx_FWLib_Vm.n.r_s\project_template\IP\Example\GNU_ARM)

Krok 2. Pro vytvoření programu zadejte příkaz „make xxxxx“ nebo „make –f xxxxx.mk“. Po dokončení všech operací sestavení by se měla objevit zpráva „BUILD SUCCESSFUL“, jak je znázorněno na následujícím obrázku.
(xxxxx je IC zařízení, zde se používá 52352)

Krok 3. Po dokončení kroku 2, Hex a Binary files lze nalézt v následující cestě. Poté aktualizujte firmware na Starter Kit pomocí dalších programovacích nástrojů, jako je e-Writer32, HT32 ICP Tool, e-Link32 Pro/Lite, HT32 Flash Programmer a ISP bootloader. Další část představí programování pomocí e-Link32 Pro / Lite.
„…\GNU_ARM\HT32M\xxxxx\Obj\HT32.bin“
„…\GNU_ARM\HT32M\xxxxx\Obj\HT32.hex“

Programování pomocí e-Link32 Pro/Lite

V této části bude jako příklad uvedena HT32F52352 Starter Kit (SK).ample. Nejprve představuje operace přípravy prostředí pro Starter Kit (SK) a e-Link32 Pro / Lite a poté vysvětluje, jak v sekvenci použít „make IC=xxxxx eraseall/program/run“ a výsledky příkazového řádku. Nakonec vysvětluje, jak sledovat, zda je programování úspěšné nebo ne, prostřednictvím stavu SK.
Operace přípravy prostředí pro SK a e-Link32 Lite jsou následující:
(1) Na desce jsou dva USB COM porty. Zde je počítač připojen k portu e-Link32 Lite na desce pomocí kabelu USB, jak je znázorněno (a) na následujícím obrázku.
(2) Funkce VCP (Virtual COM Port) e-Link32 Lite je vyžadována pro potvrzení programování. Ujistěte se, že kryt propojky UART Jumper-J2*1 zkratuje piny PAx*2 a DAP_Tx. Umístění propojky je znázorněno (b) na následujícím obrázku.
Poznámka: 1. J2 na SK poskytuje dvě nastavení, kterými jsou zkratování pinů PAx a DAP_Tx nebo zkratování pinů PAx a RS232_Tx. Podrobnosti naleznete v uživatelské příručce Starter Kit.
2. Pin je zde pojmenován PAx, protože nastavení pro pin MCU UART RX se v různých SK liší.

Operace přípravy prostředí pro SK a e-Link32 Pro jsou následující: Jedna strana e-Link32 Pro je připojena k PC pomocí datového kabelu Mini USB a druhá strana je pro rozhraní SWD. e-Link32 Pro je potřeba pro připojení k SWD-10P na SK pomocí 10kolíkového šedého plochého kabelu, jak je znázorněno na následujícím obrázku (a).

Následující část popisuje použití příkazu „make IC=xxxxx eraseall/program/run“ a výsledky příkazového řádku v pořadí.

Krok 1. Zadejte příkaz „make IC=xxxxx eraseall“ nebo „make-f xxxxx.mk eraseall“ v okně „Command Prompt“. V případě úspěchu se na obrazovce objeví zpráva „ERASEALL SUCCESS“, jak je znázorněno na následujícím obrázku.
(xxxxx je IC zařízení, zde se používá 52352).
Poznámka: Tento příkaz se používá k provedení operace hromadného vymazání Flash.

Krok 2. Zadejte příkaz „make IC=xxxxx program“ nebo „make-f xxxxx.mk program“ v okně „Příkazový řádek“. V případě úspěchu se na obrazovce objeví zpráva „PROGRAM SUCCESS“, jak je znázorněno na následujícím obrázku.
(xxxxx je IC zařízení, zde se používá 52352).

Krok 3. Zadejte příkaz „make IC=xxxxx run“ nebo „make-f xxxxx.mk run“ v okně „Command Prompt“. V případě úspěchu se na obrazovce objeví zpráva „RUN SUCCESS“, jak je znázorněno na následujícím obrázku. SK bude fungovat podle exampprogram a jeho stav při úspěšném naprogramování je zobrazen v kroku 4.
(xxxxx je IC zařízení, zde se používá 52352)

Krok 4. Po dokončení akce Krok 3 bude tento krok pokračovat, aby se zjistilo, zda bylo programování úspěšné, a to kontrolou stavu SK. To lze ověřit pomocí LED nebo terminálového softwaru. Nastavení softwaru terminálu naleznete v části „Software terminálu“. Popis stavu bude uveden níže.
Když se na obrazovce objeví zpráva „RUN SUCCESS“, LED1 i LED2 budou blikat. Jejich pozice je znázorněna na následujícím obrázku vlevo dole. Poté se zobrazí následující zpráva: „Ahoj světe! 0" ~ "Ahoj světe! 99” na terminálovém softwaru PC přes virtuální COM port, jak je znázorněno na pravé straně následujícího obrázku. Obojí lze použít k ověření, že prostředí bylo úspěšně použito.

Popis nastavení

Tato část popisuje související fileúčel v adresáři GNU_ARM, jak ukazuje následující tabulka.

Složka/File Jméno	Popis
\\project_template\IP\Příklample\GNU_ARM
xxxxx.mk	Makefile file, xxxxx je IC zařízení
linker.ld	Linker Script
Makefile	Makefile file
Project_xxxxx.uvprojx	Projekt, xxxxx je IC zařízení

Nyní bude vysvětleno, jak přidat .c file, včetně cesty nebo C/S Preprocessor Definujte úpravou značkyfile file s názvem „xxxxx.mk“.

Poznámka: Tato část používá jako ilustrace 52352.mk.

• Přidat .c file. Tato část slouží k nastavení projektu .c file, používá se následující metoda.
  • Otevřete 52352.mk, vyhledejte „Source files“, na obrazovce se objeví níže uvedená nastavení,
    které lze přidat pomocí „SOURCE_NAME_PATH +=“ přidat „.c file cestu a jméno“.
• Zahrnout cestu. Tato část se používá k přidání Zahrnout cesty, které poskytují více cest pro hledání záhlaví file (.h file), používá se následující metoda.
  • Otevřete 52352.mk, vyhledejte „Include Path“, na obrazovce se objeví níže uvedená nastavení, která lze přidat pomocí „INCLUDE_PATH += -I./ ” a „Cesta“.
• Definice C/S preprocesoru. Tato část se používá k přidání zprávy Definice preprocesoru, používá se následující metoda.
  • Otevřete 52352.mk, vyhledejte „Preprocessor Define“, na obrazovce se objeví nastavení uvedená níže. Metody přidávání pro .c Preprocessor Define se mírně liší od .s Preprocessor Define. To je uspořádáno následovně.
    ► c Definice preprocesoru: “C_Option += -D” + “Definování obsahu” Např.ampsoubor: C_OPTION += -DUSE_HT32_DRIVER.
    ► .h Definice preprocesoru: “S_Option = –defsym” + “Definovat obsah” Např.ampsoubor: S_OPTION = –defsym USE_HT32_CHIP=4
    

Používá se s Keil MDK-ARM uVision

Tato kapitola popisuje, jak používat GNU Arm Compiler s Keil MDK-ARM uVision. Poznámka: Tato část vyžaduje použití Keil MDK-ARM. Nejprve jděte za úředníkem Keil webwebu k získání EXE file pro instalaci Keil MDK-ARM a dokončete instalaci. Úředník Keil webodkaz na instalaci webu je následující.

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

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

Nastavení projektu

Krok 1. Otevřete projekt Project_xxxxx.uvprojx file z knihovny firmwaru. Zde se používá 52352.
\\HT32_STD_5xxxx_FWLib_Vm.n.r_s \project_template\IP\Example\GNU_ARM\Project_xxxxx.uvprojx Poznámka: xxxxx je název zařízení.

Krok 2. Klikněte na ikonu „Spravovat položky projektu“ a poté klikněte na možnost „Složky/rozšíření“. Vyberte „Použít kompilátor GCC (GNU) pro projekty ARM“ a poté zkopírujte instalační cestu GNU Arm do textového pole „Složka“, jak je znázorněno na následujícím obrázku.
Poznámka: Instalační cestu GNU Arm naleznete v cestě zkopírované v kroku 2 části „Instalace GNU Arm“ v kapitole „Instalace kompilátoru GNU Arm“.

Kompilace a testování

Krok 1. Klikněte na “Build (F7)” pro vytvoření projektu.
Krok 2. Zkontrolujte okno „Build Output“ a ověřte, zda byl program sestaven správně.

Krok 3. Připojte e-link32 lite USB COM port na HT32F52352 Starter Kit k PC, jak je znázorněno v červeném rámečku na levé straně následujícího obrázku. Ujistěte se, že počítač normálně detekoval zařízení USB, jak je znázorněno v červeném rámečku na pravé straně následujícího obrázku.

Krok 4. Klikněte na „Download (F8)“ pro stažení kódu do paměti Flash.

Krok 5. Na kolíky DAP_TX a PA5 se umístí kryt propojky, aby je zkratoval, jak je znázorněno na následujícím obrázku. Poté bude nakonfigurován software PC terminálu (Tera Term) a COM port bude nastaven podle kroku 3. Podrobnou konfiguraci Tera Term naleznete v části „Terminálový software“.

Krok 6. Po stisknutí tlačítka „Reset“ budou LED1 i LED2 blikat, jak je znázorněno na levé straně následujícího obrázku. Zprávy „Ahoj světe! 0" ~ "Ahoj světe! 99“ se objeví v okně „Tera Term“ prostřednictvím virtuálního COM portu, jak je znázorněno na pravé straně následujícího obrázku. To se používá k ověření, že byl úspěšně použit s kompilátorem Keil MDK-ARM uVision GNU Arm.

Běžné problémy

Tato kapitola pomáhá s některými běžnými problémy, se kterými se můžete setkat.

Chybové zprávy, které se mohou objevit po sestavení

• Při provádění „After Build“ se vygeneruje následující chybová zpráva. Zkuste restartovat počítač nebo spustit Keil MDK-ARM jako správce, aby byla operace „Po sestavení“ úspěšná.
  
  Pokud tento problém nelze vyřešit pomocí výše uvedených kroků, může uživatel také zakázat možnost „Po sestavení/přestavbě“, jak je znázorněno na následujícím obrázku.
  Poznámka: Když je deaktivována možnost „Po sestavení/přestavbě“, Keil již nebude vydávat zprávy v binárním formátu a velikosti kódu.
  

Požadavky na verzi knihovny firmwaru

Pokud se „GNU Arm Compiler“ používá s „GNU Make“ nebo „Keil MDK-ARM uVision“, je třeba poznamenat, že pouze následující verze nebo vyšší verze knihovny firmwaru podporují projekt GNU Arm files.

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

Závěr

Tato aplikační poznámka nejprve poskytla stručný popis GNU Arm. Následovalo vysvětlení, které mělo uživatelům ukázat, jak nainstalovat a otestovat GNU Arm Compiler. Poté bylo popsáno, jak jej používat s „GNU Make“ nebo „Keil MDK-ARM uVision“. Nakonec bylo vysvětlení, jak používat GNU Arm Compiler s MCU HT32.

Referenční materiál

Další informace získáte u úředníka společnosti Holtek webstránky: www.holtek.com.

Informace o revizích a úpravách

Datum	Autor	Problém	Informace o úpravě
2022.05.13	蔡期育	V1.00	První verze

Zřeknutí se odpovědnosti

Všechny informace, ochranné známky, loga, grafika, videa, zvukové klipy, odkazy a další položky, které se zde objevují webstránky („Informace“) jsou pouze orientační a mohou se kdykoli změnit bez předchozího upozornění a podle uvážení společnosti Holtek Semiconductor Inc. a jejích spřízněných společností (dále jen „Holtek“, „společnost“, „nás“, „ my" nebo "naše"). Zatímco Holtek se snaží zajistit přesnost těchto informací webSpolečnost Holtek neposkytuje žádnou výslovnou ani předpokládanou záruku na přesnost informací. Holtek nenese žádnou odpovědnost za jakoukoli nesprávnost nebo únik.

Holtek nebude odpovědný za žádné škody (včetně, ale nejen, počítačových virů, systémových problémů nebo ztráty dat), ať už vzniknou při používání nebo v souvislosti s používáním tohoto webstránky jakékoli strany. V této oblasti mohou být odkazy, které vám umožní navštívit webstránky jiných společností. Tyto webstránky nejsou kontrolovány společností Holtek. Holtek nenese žádnou odpovědnost a žádnou záruku za jakékoli informace zobrazené na takových stránkách. Hypertextové odkazy na jiné webstránky jsou na vlastní nebezpečí.

Omezení odpovědnosti

Společnost Holtek Limited v žádném případě nenese odpovědnost vůči žádné jiné straně za jakoukoli ztrátu nebo škodu způsobenou přímo či nepřímo v souvislosti s vaším přístupem k tomuto nebo jeho používáním. webstránky, obsah na nich nebo jakékoli zboží, materiály nebo služby.

Rozhodné právo

Disclaimer obsažené v webstránky se řídí a vykládají v souladu se zákony Čínské republiky. Uživatelé se podřídí nevýhradní jurisdikci soudů Čínské republiky

Aktualizace prohlášení o vyloučení odpovědnosti

Holtek si vyhrazuje právo kdykoli aktualizovat prohlášení o vyloučení odpovědnosti s předchozím upozorněním nebo bez něj, všechny změny jsou účinné okamžitě po zveřejnění na webmísto.

Dokumenty / zdroje

Kompilátor ramen GNU HOLTEK HT32 MCU [pdfUživatelská příručka HT32 MCU, HT32 MCU GNU Arm Compiler, GNU Arm Compiler, Arm Compiler

Reference

• Uživatelská příručka