Uživatelská příručka k nástroji HOLTEK HT32F52367 GUI Builder

Softwarové rozhraní se skládá z plátna pro návrh
uživatelská rozhraní, panel nástrojů pro výběr widgetů a atribut
panel pro úpravu vlastností widgetu.

Často kladené otázky (FAQ)

Otázka: Mohu ve svém projektu použít vlastní písma?

A: Ano, nástroj pro tvorbu grafického rozhraní HT32 obsahuje převodník písem LVGL pro
pomocí vlastních písem. Další informace naleznete v kapitole Převodník písem
informace.

“`

View Fullscreen

Uživatelská příručka pro HT32 GUI-Builder
Revize: V1.00 Datum: 13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
Obsah
1. Přesview…… ... 3 2. Systémové požadavky ……………………………………………………………………………………….. 3 3. Hardwarová podpora………………………………………………………………………………………………… 3 4. Pokyny k instalaci ………………………………………………………………………………….. 3 5. Funkční shrnutí ……………………………………………………………………………………………. 4 6. Rychlý start…………………………………………………………………………………………… 4 7. Podrobný funkční úvod……………………………………………………………………… 5
7.1 Nabídka …… ...
8. Převodník písem ………………………………………………………………………………………… 10 9. Nastavení… ... 12 10. File Struktura…………………………………………………………………………………………. 14 11. Př.ampPopis ………………………………………………………………………………… 15 12. Často kladené otázky …………………………………………………………………………………………………………. 19
Q1: Jak vylepšit problém se zpožděním při obnovování obrazovky? ………………………………………………………………………………………………………………..20 Q3: Jak zvětšit paměťový prostor pro přidání dalších widgetů na obrazovku?…………………………………………. 20 Q4: Vygenerovaný kód neběží správně?……………………………………………………………………………………………… 21 Q5: Proč je šířka dat EBI čipu HT32F52367 8bitová? …………………………………………………………………………. 21 Q6: Jak přidat ovladač displeje nebo vstupní zařízení?……………………………………………………………………………………………21

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
1. Přesview
HT32 GUI-Builder je nástroj pro tvorbu grafických rozhraní určený pro 32bitové mikrokontroléry Holtek, který pomáhá vývojářům rychle navrhovat a nasazovat aplikace s rozhraním člověk-stroj. Díky intuitivním operacím drag-and-drop mohou uživatelé snadno konfigurovat vizuální prvky, jako jsou tlačítka, textové popisky, ikony atd., a dokončovat složité návrhy grafického rozhraní, aniž by museli psát velké množství kódu rozhraní. Tento software podporuje 32bitovou řadu mikrokontrolérů Holtek a dokonale se kombinuje s LVGL (Light and Versatile Graphics Library) a poskytuje tak bohaté grafické widgety a efektivní renderovací engine. HT32 GUI-Builder dokáže automaticky generovat projekty. filekteré splňují rámec LVGL. Uživatelé mohou jednoduše importovat vygenerovaný projekt do vývojového prostředí, poté jej zkompilovat, stáhnout a spustit, což výrazně zkracuje dobu vývoje.
2. Systémové požadavky
· Mikrokontrolér HT32: Flash paměť 256K a vyšší / SRAM 32K a vyšší · Operační systém: Windows 64-bit OS · Vývojové prostředí: Keil Vision / HT32-IDE
3. Hardwarová podpora
Nástroj HT32 GUI-Builder podporuje následující mikrokontroléry Holtek: · HT32F52367: 256K Flash / 32K RAM · HT32F12365: 256K Flash / 64K RAM · HT32F12366: 256K Flash / 128K RAM · HT32F42386: 512K Flash / 196K RAM · HT32F49395: 1024K Flash / 224K RAM Podporované LCD displeje: · ESK32-A2A31: 2.8palcový (320×240) TFT-LCD · ESK32-A4A31: 5palcový (800×480) TFT-LCD · ESK32-A4A32: 4.3palcový (480×272) TFT-LCD
4. Pokyny k instalaci
· Instalace na operační systém Microsoft WIN7/WIN8/WIN10/WIN11. · Systém vyžaduje instalaci .NET Frameworku 3.5. Pokud ještě není nainstalován, stáhněte si jej.
a nainstalujte si ho z oficiálního webu společnosti Microsoft webweb: https://www.microsoft.com/zh-tw/download/details.aspx?id=21 · Během instalace postupujte podle pokynů a opakovaným kliknutím na tlačítko „Další“ dokončete instalaci.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder

5. Funkční shrnutí
Nástroj HT32 GUI-Builder obsahuje následující hlavní funkce: · Widgety s funkcí Drag-and-Drop: Podporuje širokou škálu widgetů s funkcí Drag-and-Drop, což usnadňuje
uživatelům rychle navrhnout rozhraní. · Podpora více obrazovek: Podporuje přepínání mezi více obrazovkami. · Správa obrázků a písem: Obrázky lze ukládat do interní flash paměti nebo na SD kartu.
Fonty lze přizpůsobit pomocí Převodníku fontů. · Simulátor viewUživatelé si mohou předemview efekt návrhu uživatelského rozhraní v reálném čase prostřednictvím simulátoru.
Nabídka příkazů

Použité widgety
Dostupné widgety

Obrazovka

Společné atributy widgetu
Speciální atributy widgetu
Styl widgetu

Informační displej a oblast zdrojů

Událost widgetu

6. Rychlý start
(1) Otevřete HT32 GUI-Builder pro vstup do hlavního rozhraní. (2) Klikněte na [Nový] a poté vyberte číslo dílu vývojové desky / obrazovku a další parametry v
vyskakovací okno Nastavení pro vytvoření projektu. (3) Vyberte požadované widgety (např. tlačítko, popisek, ukazatel průběhu atd.) z levého panelu nástrojů a přetáhněte je
je do oblasti plátna.
(4) Přidejte zdroje obrázků/písem. (5) Vyberte libovolný widget na plátně a upravte jeho atributy, jako je poloha, velikost, barva, vzorek atd.
písmo atd. na panelu atributů na pravé straně softwarového rozhraní. (6) Klikněte na [Přehrát] pro view návrh v okně simulátoru a interagovat s obrazovkou pomocí
klávesnice a myš.
(7) Klikněte na [Kód] pro vygenerování kompletního programu, použijte jej s knihovnou firmwaru Holtek, zkompilujte program ve vývojovém prostředí a stáhněte jej do vývojové desky pro testování.
(8) Pokud je obrazovka částečně změněna, podporuje se generování pouze kódu uživatelského rozhraní, aby se zabránilo přepsání kódu již napsaného uživatelem.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder

7. Podrobný funkční úvod

7.1 Nabídka

Funkce

[Nové] [Nedávné]

Popis Vytvoření nové konfigurace obrazovky.
Nedávno otevřeno files.

[Otevřít] Otevření projektu konfigurace obrazovky (.hgb). Zdroj fileSoubory [projekt].Assets a [projekt].Fonts musí být ve stejném adresáři.
[Import] Tvůrce grafického rozhraní HT32 má integrované funkceamplů dokončeného zpracování událostí. Projekty generované funkcí Import mohou generovat zpracování událostí. filesynchronně při generování kódu, čímž se funkční vývoj rychle dokončí.
[Uložit] Uložit projekt konfigurace obrazovky (.hgb). Obrázek a písmo filePrvky v oblasti zdrojů budou uloženy současně do adresářů [project].Assets a [project].Fonts. [+Scrn] Vytvořte novou obrazovku. Hlavní program načte první obrazovku a uživatelé se musí v kódu sami přepínat na další obrazovky.

Rev. 1.00

13. června 2025

Funkce [-Scrn] [Kopírovat] [Vložit] [Vyjmout] [Smazat]

Uživatelská příručka pro HT32 GUI-Builder
Popis Smazat vybranou obrazovku. Zkopírovat vybraný widget. Vložit zkopírovaný widget. Vyjmout vybraný widget. Smazat vybraný widget.

[Písmo] Převodník písem LVGL. Viz kapitola „Převodník písem“. [Kód] Vygenerujte projekt Keil. Vygenerovanou složku zkopírujte do aplikace {Holtek Standard Peripheral Firmware Library}aplikace{libovolná složka} a poté v této složce spusťte soubor _CreateProject.bat.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
Funkce
[Kód uživatelského rozhraní] Znovu vygenerujte kód související s obrazovkou.

Popis
Relevantní fileMezi ně patří: lvgl_ui.c lvgl_ui.h lvgl_screen_n.c lvgl_screen_n.h A fileve složkách Obrázky/Písma
Nepřidávejte k nim vlastní kód files, aby se zabránilo přepsání kódu nástrojem pro tvorbu grafického rozhraní HT32.
Obrazovka konfigurace

[Přehrát] Simuluje aktuálně vybranou obrazovku. Po vstupu na simulační obrazovku můžete k aktivaci události widgetu použít myš nebo můžete k přímému zadání obsahu použít fyzickou klávesnici.

Obrazovka simulace

[Nastavení] Nastavení parametrů souvisejících s hardwarem. Další podrobnosti naleznete v kapitole „Nastavení“.

Rev. 1.00

13. června 2025

7.2 Softwarové rozhraní
Funkce

Uživatelská příručka pro HT32 GUI-Builder
Popis

Základní/Ovladač [Widget] Přetáhněte požadované widgety na LCD obrazovku.

Nadřazený/podřízený widget [Skupina] a řazení widgetů Seskupování se provádí přetažením podřízeného widgetu na nadřazený widget v oblasti [Použité widgety]. Když se nadřazený widget přesune, bude se s ním pohybovat i podřízený widget. Kromě možnosti [Skupina] můžete také změnit pořadí objektů jejich přetažením.
Oblast [Data]/[Písma] Klikněte na [Přidat obrázek] Files] pro přidání obrázků do oblasti [Data] před jejich použitím ve widgetu. Výchozí formát převodu pro obrázky přidané do oblasti [Data] je 16bitová hloubka barev. Uživatelé mohou kliknout pravým tlačítkem myši na obrázek a vybrat 1/2/4/8bitový indexovaný barevný formát, čímž se zmenší prostor potřebný pro obrázek. Tyto formáty lze vybrat pro použití s nízkými požadavky na barvy, například pro ikony. Písma se do oblasti [Písma] přidávají pomocí Převodníku písem, další podrobnosti naleznete v kapitole „Převodník písem“.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
Funkce
Oblast widgetu [Společné atributy]/[Speciální atributy] Tato oblast obsahuje polohu/velikost widgetu, příznaky a stavy. Další popisy položek [Příznaky] a [Státy] naleznete v oficiálních dokumentech LVGL. webwebu. Kromě toho mají různé widgety své vlastní atributy, obrázek vpravo ukazuje atributy Label. Podrobné atributy každého widgetu naleznete také v dokumentu LVGL.
Oblast widgetu [Styl] Vzhled a barvu widgetů atd. lze změnit pomocí Nastavení stylu. Žlutý rámeček zobrazuje společná nastavení stylu pro všechny widgety, zatímco ostatní se pro každý widget liší. Widget se skládá z několika částí. NapříkladampNapříklad přepínač se skládá z hlavního přepínače, indikátoru a knoflíku, z nichž každý lze nastavit nezávisle. Widget lze také nakonfigurovat tak, aby měl různé styly pro různé stavy. NapříkladampStavy Zakázáno nebo Stisknuto mohou mít různá nastavení stylu.
Oblast widgetu [Událost] Po výběru požadovaných událostí se v souboru lvgl_event.c vygeneruje pouze rámec pro příjem událostí. Uživatelé mohou po přijetí události widgetem provádět různé úkoly. Více informací naleznete v části „Příklad…“ampkapitola „Popis“.

Popis

[Obrazovka] Přiblížení/oddálení oblasti Přesuňte kurzor myši na oblast LCD obrazovky, podržte stisknutou klávesu Ctrl a otáčením prostředního tlačítka myši nahoru přiblížíte obrazovku, otáčením dolů ji oddálíte.

Obrazovka

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
8. Převodník písem
LVGL používá kódování UTF-8 k zobrazení znaků Unicode pro všechny jazyky. Uživatelé mohou pomocí převodníku písem vytvářet kód v jazyce C nebo binární kód z libovolných písem TTF nebo WOFF. Můžete vybrat rozsah znaků Unicode a zadat BPP (bity na pixel) pro vytvoření nových písem pro vaše projekty s grafickým uživatelským rozhraním.

Procházet složku s písmy Vyberte složku, kde se písmo nachází files lokalizovat.
Vyberte zdroj písma V rozbalovací nabídce vyberte písmo uvedené ve složce Písmo.
Velikost Definuje velikost písma.
Název Název použitý k nastavení písma v programu.
BPP Určuje rozmazání hran písmen. Čím menší počet bitů, tím rozmazanější jsou okraje písmen.
Rozsah Upravte rozsah písmen, tj. rozsah a/nebo znaky, které chcete zahrnout, např. 0x20-0x7F.
Symboly Seznam znaků, které se mají zahrnout. NapříkladampDobrý den, Holtek ABC0123ÁÉ.
Převést Po úspěšném vytvoření písem se zobrazí informace o písmu file (.fnt), a .c file a .bin file budou vygenerovány ve složce [Fonts] a písma se zobrazí v oblasti [Fonts] současně. Pokud vybrané písmo file neobsahuje písmo vstupního symbolu, zobrazí se chyba. Soubor .fnt file zaznamenává informace o písmu. Uživatelé si to mohou otevřít file upravit příslušné parametry a poté znovu vygenerovat soubor .c file a .bin fileTvůrce grafického rozhraní HT32 bude obsahovat soubor .c. file nastavit písma, pokud chcete použít soubor .bin file, obraťte se prosím na úředníka LVGL webmísto.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
Oblast [Písma] Uživatelé mohou písmo odstranit kliknutím pravým tlačítkem myši v oblasti [Písma].
Poznámka: Fonty jsou založeny na projektu a vytvořené vlastní písmo file se ukládá při ukládání projektu. Pokud se neuloží, bude při otevření nového projektu vymazán.
Otevřít Otevřít informace o písmu file (.fnt). Nastavení písma Pokud widget vyžaduje nastavení atributu písma, zobrazí se v oblasti [Styl widgetu] nastavení [Text]. Kromě vlastních písem v rozevíracím seznamu jsou k dispozici také písma Montserrat poskytovaná společností LVGL, ze kterých si můžete vybrat.
Všimněte si, že HT32 GUI-Builder generuje zdrojový kód file v UTF-8 se značkou pořadí bajtů (BOM) a Keil bude ignorovat volby –locale a –[no_] multibyte_chars a interpretovat file jako UTF-8 nebo UTF-16. Pokud však file Pokud je upraven a uložen v editoru Keil, bude uložen jako režim kódování nastavený v konfiguračním rozhraní, jak je znázorněno níže. I když byl režim kódování nastaven na UTF8, není možné kompilovat UTF-8, protože neexistuje žádný kusovník (BOM).

Rev. 1.00

13. června 2025

9. Nastavení

Uživatelská příručka pro HT32 GUI-Builder

Šířka/Výška Nastavte délku a šířku obrazovky, která musí odpovídat hardwaru.
Hloubka Nastavte barevnou hloubku, která musí odpovídat hardwaru.
Otočení Nastavení směru LCD displeje.
Režim motivu Nastavte základní motiv LVGL na tmavý nebo světlý režim.
LVGL Vyberte verzi LVGL. Aktuálně jsou k dispozici verze 8.3.8 a 9.2.2.
Deska Vyberte aktuálně podporovaný hardware a ovladač displeje.
Soubory SD FatF Pokud je povolena možnost [SD FatF], můžete zaškrtnutím možnosti [FAT] zvolit, zda se má obrázek widgetu načíst z karty SD. Pokud se rozhodnete načíst obrázek z karty SD, je třeba zkopírovat soubor .bin. file ze složky [Obrázky] na SD kartu před spuštěním firmwaru. Písmeno diskové jednotky pro SD kartu je S.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder

Složka obrázků Pokud je povolena možnost [SD FatFs] a je zaškrtnuto políčko [Složka obrázků] a je vybrán obrázek widgetu k načtení z SD karty, cesta se změní na S:/[Složka obrázků], například S:/EX5/Image.bin Pokud není zaškrtnuto políčko [Složka obrázků], obrázek file by měl být umístěn v kořenovém adresáři S:.
Externí úložiště · ESK32-A4A10(m4)+ESK32-A4A31(16bitové) jádro: HT32F42386 · ESK32-A4A10(m4)+ESK32-A4A32(16bitové) jádro: HT32F42386 Po výběru výše uvedených demo desek můžete zvolit Externí SRAM. Vygenerovaný program nakonfiguruje vyrovnávací paměť pro zobrazení na celou obrazovku v externí SRAM pro zrychlení zobrazení. · ESK32-A4A11(m4)+ESK32-A4A31(16bitové) jádro: HT32F49395 · ESK32-A4A11(m4)+ESK32-A4A32(16bitové) jádro: HT32F49395 Při výběru výše uvedených demo desek si uživatelé mohou zvolit Externí SRAM i Externí Flash. Pokud je vybrána možnost Externí blesk, všechna vygenerovaná obrazová data budou uložena do externího blesku.
Přidat vstupní zařízení Různé desky podporují různá vstupní zařízení. · ESK32-2x001A(m0)+ESK32-A2A31(8bitové) jádro: HT32F52367 · ESK32-2x001A(m3)+ESK32-A2A31(16bitové) jádro: HT32F12366 · ESK32-2x001A(m4)+ESK32-A2A31(16bitové) jádro: HT32F42386 Napříkladampnapř. vyberte výše uvedené demo desky a použijte Wakeup/Key1/Key2 k implementaci funkcí klávesnice a tlačítek.
Klávesnice: Probuzení = klávesa Enter Klávesa 1 = klávesa Předchozí Klávesa 2 = klávesa Další
Tlačítko: V souboru lv_port_indev.c file, upravte btn_points v lv_port_indev_init tak, aby nastavovaly pozici na obrazovce, kde dojde k události po stisknutí klávesy.
Poznámka: Pokud je vybrána deska ESK32-2x001A(m0)+ESK32-A2A31(8bitová), bude z důvodu hardwaru použita 8bitová datová šířka EBI. Podrobnosti naleznete v otázce 4 v kapitole Často kladené otázky.
· ESK32-A4A10(m4)+ESK32-A4A31(16bitové) jádro: HT32F42386 · ESK32-A4A10(m4)+ESK32-A4A32(16bitové) jádro: HT32F42386 · ESK32-A4A11(m4)+ESK32-A4A31(16bitové) jádro: HT32F49395 · ESK32-A4A11(m4)+ESK32-A4A32(16bitové) jádro: HT32F49395 Při výběru výše uvedených demo desek použijte Button0~2 pro implementaci funkcí klávesnice a tlačítek a GT911 pro implementaci funkcí touchpadu a myši. Klávesnice:
Button0 = klávesa Enter Button1 = předchozí klávesa Button2 = další klávesa · ESK32-31401(m4)+ESK32-A4A31(16bitové) jádro: HT32F49395 · ESK32-31401(m4)+ESK32-A4A32(16bitové) jádro: HT32F49395

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
Při výběru výše uvedených zobrazovacích desek jsou funkce touchpadu a myši implementovány u GT911. Pro vstupní zařízení, která nejsou hardwarem podporována, jsou generovány pouze frameworky. Podrobné pokyny naleznete v části „ExampKapitola „Popis le“. Generované barevné formáty Nástroj HT32 GUI-Builder podporuje pět barevných formátů obrazu: True Color, Indexed 8 Bits, Indexed 4 Bits, Indexed 2 Bits a Indexed 1 Bit. Uživatelé si mohou vybrat jeden z barevných formátů, které se použijí na obrazovku. Při generování kódu si však uživatelé mohou vybrat: (1) Výstup pouze použitého barevného formátu
(2) Výstup vybraných barevných formátů
Díky tomu je snazší upravit barvy displeje během vývoje firmwaru.
10. File Struktura
Pokud chcete přidat vlastní ovladač zobrazení nebo vstupní zařízení, musíte nejprve porozumět projektu. file struktura generovaná nástrojem HT32 GUI-Builder.

· main.c: Hlavní program file · lvgl_ui.c/lvgl_screen.c: Související s widgety obrazovky file

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
· lvgl_event.c: Zpracování událostí · [deska]: Ovladače související s hardwarem · [FatFs]: File systém files · [Obrázky]: Obrázek files · [Fonty]: Písmo files · [lvgl-master]: Knihovna LVGL · Přizpůsobitelné ovladače:
gpio.h: Definice pinů displeje/dotykového ovládání a kláves ht32_board_config.h: Definice pinů rozhraní SD karty lcd_driver.h: Definice funkcí ovladače displeje, včetně délky/šířky a rozlišení. file
zahrnuje také .c filezdrojového kódu ovladače displeje a zdrojového kódu dotykové funkce. i2c1_gt911.c: Zdrojový kód dotykové funkce, který je součástí souboru lcd_driver.h. file. icd_drvier_ssd1963: Zdrojový kód ovladače displeje, který je součástí souboru lcd_driver.h. file. lv_port_indev.c: Vstupní ovladač lv_port_disp.c: Ovladač displeje sdio_sd.c: Ovladač rozhraní SD karty Uživatelé, kteří chtějí definovat svá vlastní hardwarová rozhraní, musí upravit výše uvedené files a dokončete související funkce v souboru .c fileLVGL používá kódování UTF-8 k zobrazení znaků Unicode pro všechny jazyky, takže HT32 GUIBuilder generuje zdrojový kód. file v kódování UTF-8 se značkou pořadí bajtů (BOM). Při regeneraci kódu uživatelského rozhraní se použije následující files jsou také regenerovány: lvgl_ui.c lvgl_ui.h lvgl_screen_n.c lvgl_screen_n.h A fileve složkách Obrázky/Písma. Do těchto složek nepřidávejte vlastní kód. files, aby se zabránilo přepsání kódu nástrojem pro tvorbu grafického rozhraní HT32.
11. Přample Popis
Tato kapitola bere jako příklad 2x001a-1.hgb (klávesnice).amppro popis.
štítek_0

obrázek_0

přepínač_0

tlačítko_0 a štítek_2

Rev. 1.00

štítek_1
tlačítko_1 a štítek_3
13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
(1) label_0: Nastavte atribut label na možnost Scroll Circular (Kruhové rolování), aby se postavy pohybovaly.
(2) Vytvořit písmo files. Pokud štítek obsahuje čínské znaky, je třeba nastavit čínské písmo. Pomocí nástroje pro převod písem vytvořte písmo pro pět čínských znaků „ “. Jak je znázorněno na obrázku, bude vygenerováno písmo NotoSansTC_Regular_14.

(3) V části Písmo textu v části Styl nastavte písmo popisku na NotoSansTC_Regular_14. (4) label_1: Nastavte atribut popisku na Kruhové posouvání, aby se znaky posouvaly.
Nastavte styl textu v části Styl na red/center/underline/montserrat 28.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
(5) image_0: Existují dva způsoby, jak přidat obrázek na obrazovku. Jedním z nich je přetáhnout obrázek přímo z oblasti [Prostředky] na obrazovku. Druhým způsobem je nejprve přidat widget Obrázek pomocí operace drag-and-drop a poté vybrat obrázek, který byl přidán do projektu, v oblasti Widget Special Attributes [Obrázek]. Pokud má projekt povolenou možnost SD FatFs, můžete si také zvolit, zda se má obrázek načíst z file systém. Pokud je zaškrtnuta možnost FAT, soubor .bin file Soubory ze složky [Images] je třeba před spuštěním firmwaru zkopírovat na SD kartu.

(6) Pomocí operace přetažení nastavte label_2 jako podřízenou položku button_0 a label_3 jako podřízenou položku button_1. (7) Vyberte button_0 a zaškrtněte možnost CLICKED v části UDÁLOST, stejně jako u button_1.
(8) Vyberte Tmavý režim a v nastavení [Nastavení] zaškrtněte políčko Klávesnice.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
(9) Klikněte na [Uložit] pro uložení projektu a poté klikněte na [Kód] pro vygenerování kódu. (10) Zkopírujte vygenerovanou složku do aplikace {Holtek Standard Peripheral Firmware Library}any
složka} a spusťte _CreateProject.bat pro generování projektu Keil uVision IDE. (11) lv_port_indev.c je framework file vstupních zařízení a lze je upravit podle
hardwarová konfigurace. V tomto exampTvůrce grafického uživatelského rozhraní HT32 používá klávesy Key1/Key2/Wakeup na demo desce ESK32-2x001A k automatickému vygenerování následujícího kódu pro klávesnici:

Klávesa 1 je klávesa Předchozí a stisknutím klávesy 1 se přesunete zpět a vyberete jiný widget. Klávesa 2 je klávesa Další a stisknutím klávesy 2 se přesunete na další widget. Probuzení je klávesa Enter a stisknutím klávesy Probuzení se spustí událost Click.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
(12) lvgl_event.c je framework file Pro widget, který přijímá událost, může uživatel přidat kód do červených políček, jak je znázorněno níže. Pokud je stisknuto tlačítko button_0, přepínač se přepne do polohy Zapnuto, pokud je stisknuto tlačítko button_1, přepínač se přepne zpět do polohy Vypnuto.

Poznámka: 2x001a-1 Example: Zpracování událostí naleznete v souboru lvgl_event.c ve složce. 2x001a-2 Příkladample: Informace o rotaci ukazatele hodin naleznete v souboru main.c ve složce. a4a10 Příkladample: Nastavení barvy textu a rozestupů naleznete v souboru lvgl_event.c ve složce.

12. Nejčastější dotazy
Q1: Jak vylepšit problém se zpožděním při obnovování obrazovky?
(1) Upravte velikost vyrovnávací paměti displeje · Čím větší je vyrovnávací paměť displeje, tím efektivnější je jednorázové obnovení, ale zabírá více místa v paměti RAM. · Nastavte velikost vyrovnávací paměti v lv_port_disp_init(lv_port_disp.c): static lv_disp_draw_buf_t draw_buf_dsc_1; static lv_color_t buf_1[DISP_HOR_RES * 10]; lv_disp_draw_buf_init(&draw_buf_dsc_1, buf_1, NULL, DISP_HOR_RES * 10); disp_drv.flush_cb = disp_flush; disp_drv.draw_buf = &draw_buf_dsc_1; · Nastavte velikost vyrovnávací paměti alespoň na počet bitů pro řádek obrazovky (šířka* 1). · Pokud je RAM dostatečná, nastavte ji na 1/4 nebo více velikosti obrazovky.
(2) Snižte obnovovací frekvenci · Snižte obnovovací frekvenci LVGL, abyste minimalizovali zbytečné překreslování. · Upravte LV_DISP_DEF_REFR_PERIOD(V8) nebo LV_DEF_REFR_PERIOD(V9) v souboru lv_conf.h file.
(3) Snižte počet vrstev objektů · Čím více vrstev widgetů v LVGL, tím složitější je proces vykreslování. · Minimalizujte vnořené widgety.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder

(4) Správně používejte průhlednost a styl · Snižte zbytečnou průhlednost: lv_obj_set_style_bg_opa(obj, LV_OPA_COVER, 0); · Omezte používání přechodových pozadí a složitých stylů (např. Stín a Poloměr).

(5) Nepoužívejte animaci
Animace mohou spouštět časté překreslování, což ovlivňuje výkon.
LVGL počítá widgety a oblasti, které je třeba překreslit při každé aktualizaci. Složité kreslení s mnoha neplatnými oblastmi bude mít za následek delší intervaly zpracování. Ujistěte se, že se překreslují pouze aktualizované oblasti, nikoli celá obrazovka. Pokud více animací aktualizuje stejnou oblast současně, zvýší se počet zbytečných překreslování, takže je nutné logiku animace optimalizovat ručně.

Q2: Jak se vypořádat s velkým obrázkem?
Obrázek může pocházet z:
Proměnná v programu: Obvykle se jedná o pole jazyka C obsahující pixelová data umístěná v interní paměti Flash. Externě uložená files: Například obrázek fileuloženy na SD kartě. Projekt musí podporovat file systém.
Obrázek s rozlišením 320×240 a barevnou hloubkou 16 bitů vyžaduje 320×240×3 bajty, tedy až 225 tisíc bajtů. Ukládání tak velkého obrázku do interní flash paměti je nepraktické.
Pokud v nabídce [Nastavení] zaškrtnete políčko [SD FatFs] pro povolení file systém SD karty, widget, který potřebuje obraz, si může zvolit načtení obrazu z SD karty. Před spuštěním firmwaru zkopírujte soubor .bin file ze složky [Obrázky] na SD kartu. Protože však obrázky pocházejí z fileRychlost obnovování systému je omezena rychlostí čtení SD karty. NapříkladampNapříklad při použití čipu HT32F12366 s frekvencí 96 MHz pro čtení obrazu s rozlišením 320 × 240 je rychlost pouze asi 4 snímky za sekundu, což není vhodné pro rychlé a rozsáhlé obnovování.

Q3: Jak zvětšit paměťový prostor pro přidání dalších widgetů na obrazovku?

Kód vygenerovaný nástrojem HT32 GUI-Builder nastavuje v souboru lv_conf.h následující parametry:

#definovat LV_MEM_CUSTOM 1

(V8)

#definovat LV_USE_STDLIB_MALLOC LV_STDLIB_CLIB

(V9)

To znamená použití standardních funkcí jazyka C pro správu paměti: malloc/free/realloc, které potřebují nakonfigurovat velikost haldy [Heap].

Počet widgetů, které lze přidat, se liší v závislosti na typu widgetu. Uživatelé mohou zvětšit nebo zmenšit velikost [Heap] podle potřeb své aplikace.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
Otázka 4: Vygenerovaný kód nefunguje správně? A. Pokud byla v nastavení obrazu vybrána možnost [FAT], ujistěte se, že obraz fileNa SD kartu byly uloženy položky s a cesta je správná. B. Zkontrolujte, zda není přidáno příliš mnoho widgetů, což má za následek nedostatek místa v [Heap]. Pro zvětšení velikosti [Heap] se řiďte pokyny k otázce 3. C. Pokud je widget nastaven se stínem nebo poloměrem, bude pro výpočet potřebovat větší velikost [Heap]. Pro zvětšení velikosti [Heap] se řiďte pokyny k otázce 3.
Q5: Proč je šířka dat EBI modulu HT32F52367 8bitová? Pokud je deska ESK32-2x001A spárována s modulem HT32F52367, je pin Key1 sdílen s převodníkem AD9 od EBI. Aby se zabránilo nefunkčnosti obrazovky při povolení vstupního zařízení Button nebo Keypad, standardně se používá 8bitová šířka dat EBI. Pro podporu 8bitového EBI je nutné nastavit přepínač SW1 na zadní straně modulu obrazovky ESK32-A2A31 na 1000.

16bitový režim

8bitový režim

Pokud není vstupní zařízení Tlačítko nebo Klávesnice povoleno, může uživatel upravit soubor lv_drvier.h tak, aby změnil šířku dat EBI na 16 bitů a zvýšil tak rychlost obnovování.

#ifndef TFT_BITOVÝ_REŽIM

#definovat TFT_BIT_MODE

(TFT_16_BITOVÝ_REŽIM)

#endif

Q6: Jak přidat ovladač displeje nebo vstupní zařízení?
Vezměte si jako příklad 5.0palcový (800×480) LCD kapacitní dotykový panel ESK32-A4A31 podporovaný HT32 GUIBuilderem.amptj. integrovaný obvod ovladače displeje je SSD1963 a integrovaný obvod ovladače dotykové obrazovky je GT911. · gpio.h: Definice pinů displeje/dotykové obrazovky a kláves. · lcd_driver.h: Definice funkcí ovladače displeje, včetně délky/šířky a rozlišení. Toto file
zahrnuje také .c filezdrojového kódu ovladače displeje a zdrojového kódu dotykové funkce.
#včetně „ht32.h“ #včetně „gpio.h“

#definovat ROZLIŠENÍ_HODNOTY_ZOBRAZENÍ #definovat ROZLIŠENÍ_VERZE_ZOBRAZENÍ #definovat BYTE_PER_PIXEL

480

Používá se v lv_port_disp.c k

272

vypočítat velikost vyrovnávací paměti displeje

#definovat LCD_NORMÁLNÍ #definovat LCD_VLEVO_90 #definovat LCD_VPRAVO_90 #definovat LCD_OTOČENÍ_180
#definovat SMĚR_TFT

(0) //zleva doprava, shora dolů (1) //shora dolů, zprava doleva (2) //zdola nahoru, zleva doprava (3) //zprava doleva, zdola nahoru
(0)

Ovladač LCD displeje musí podporovat přepínání ve čtyřech směrech; TFT_DIRECTION se používá k definování směru obrazovky.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder
void TFT_Init(void); void TFT_Config(void); void TFT_WriteRAMPrior(void); void TFT_WriteRAM(u32 RGB_Set); void TFT_SetDisplayArea(u16 Xstart, u16 Ystart, u16 Xend, u16 Yend);
TFT_Init se používá k inicializaci EBI a pinů, TFT_Config se používá k inicializaci TFT obrazovky, tyto funkce jsou volány funkcí disp_init v lv_port_disp.c. fileTFT_SetDisplayArea/ TFT_WriteRAMPrior/TFT_WriteRAM jsou volány funkcí disp_flush v souboru lv_port_disp.c. file, které se používají k implementaci funkce obnovování obrazovky.
#include „lcd_driver_st6201.c“ Slouží k implementaci výše uvedených pěti funkcí. #include „i2c1_gt911.c“ Zdroj dotykových funkcí file void Touch_Init(void) bool is_pressed() void get_xy(lv_coord_t * x, lv_coord_t * y) Implementujte výše uvedené tři funkce, které bude volat lv_port_indev.c. file.
· icd_drvier_ssd1963: Zdrojový kód ovladače displeje, který je součástí souboru lcd_driver.h file. · i2c1_gt911.c: Zdrojový kód dotykové funkce, který patří vstupnímu zařízení a je součástí
lcd_driver.h file. · lv_port_indev.c:
#ifdef _TOUCHPAD_ static void touchpad_init(void); static void touchpad_read(lv_indev_t * indev, lv_indev_data_t * data); static bool touchpad_is_pressed(void); static void touchpad_get_xy(int32_t * x, int32_t * y); #endif
#ifdef _MOUSE_ static void mouse_init(void); static void mouse_read(lv_indev_t * indev, lv_indev_data_t * data); static bool myš je_stisnuta(void); static void mouse_get_xy(int32_t * x, int32_t * y); #endif
Touchpad a myš jsou podobná vstupní zařízení.
touchpad_init/mouse_init volá Touch_Init pro inicializaci I2C/pinů a GT911. touchpad_is_pressed/mouse_is_pressed volá is_pressed pro zjištění, zda byl touchpad stisknut či nikoli.
touchpad_get_xy/mouse_get_xy volá get_xy pro získání pozice, kde je touchpad stisknut. touchpad_read/mouse_read volá is_pressed a get_xy pro současné získání stavu a pozice.

Rev. 1.00

13. června 2025

Uživatelská příručka pro HT32 GUI-Builder

Copyright© 2025 by HOLTEK SEMICONDUCTOR INC. Všechna práva vyhrazena.
Informace uvedené v tomto dokumentu byly vytvořeny s přiměřenou péčí a pozorností před zveřejněním, avšak společnost HOLTEK nezaručuje, že informace jsou zcela přesné. Informace obsažené v této publikaci jsou poskytovány pouze pro informaci a mohou být nahrazeny aktualizacemi. HOLTEK se zříká jakýchkoli vyjádřených, předpokládaných nebo zákonných záruk, včetně, ale bez omezení, vhodnosti pro komercializaci, uspokojivé kvality, specifikací, charakteristik, funkcí, vhodnosti pro konkrétní účel a neporušování práv jakékoli třetí strany. HOLTEK se zříká veškeré odpovědnosti vyplývající z informací a jejich použití. Kromě toho společnost HOLTEK nedoporučuje používat produkty společnosti HOLTEK tam, kde existuje riziko ohrožení osob z důvodu poruchy nebo jiných důvodů. Společnost HOLTEK tímto prohlašuje, že nepovoluje použití těchto produktů v součástech pro záchranu, udržení života nebo bezpečnost. Jakékoli použití produktů HOLTEK v záchranných/udržovacích nebo bezpečnostních aplikacích je zcela na riziko kupujícího a kupující souhlasí s tím, že bude HOLTEK bránit, odškodnit a ochránit před jakýmikoli škodami, nároky, obleky nebo náklady vyplývajícími z takového použití. Informace uvedené v tomto dokumentu, včetně, ale bez omezení na obsah, údaje, napřampsoubory, materiály, grafy a ochranné známky, je duševním vlastnictvím společnosti HOLTEK (a případně jejích poskytovatelů licencí) a je chráněn autorským zákonem a dalšími zákony o duševním vlastnictví. Společnost HOLTEK zde neuděluje žádnou výslovnou ani předpokládanou licenci k právu duševního vlastnictví. Společnost HOLTEK si vyhrazuje právo kdykoli bez předchozího upozornění revidovat informace popsané v dokumentu. Pro nejnovější informace nás prosím kontaktujte.

Rev. 1.00

13. června 2025

Dokumenty / zdroje

Tvůrce grafického rozhraní HOLTEK HT32F52367 [pdfUživatelská příručka
Tvůrce grafického rozhraní HT32F52367, HT32F52367, Tvůrce grafického rozhraní, Tvůrce

Reference

Uživatelská příručka

Uživatelská příručka k nástroji HOLTEK HT32F52367 GUI Builder

Tvůrce grafického uživatelského rozhraní HT32F52367

Informace o produktu

Specifikace

Návod k použití produktu

1. Přesview

2. Systémové požadavky

3. Hardwarová podpora

4. Pokyny k instalaci

5. Funkční shrnutí

6. Rychlý start

7. Podrobný funkční úvod

7.1 Nabídka

7.2 Softwarové rozhraní

Často kladené otázky (FAQ)

Otázka: Mohu ve svém projektu použít vlastní písma?

Dokumenty / zdroje

Reference

Zanechte komentář

Zrušit odpověď