UŽIVATELSKÁ PŘÍRUČKA
ŘADA pixxiLCD
pixxiLCD-13P2/CTP-CLB
pixxiLCD-20P2/CTP-CLB
pixxiLCD-25P4/CTP
pixxiLCD-39P4/CTP

Řada pixxiLCD

*Dostupné také ve verzi Cover Lens Beel (CLB).

VARIANTY:
Procesor PIXXI (P2)
Procesor PIXXI (P4)
Bezdotykové (NT)
Kapacitní dotyk (CTP)
Kapacitní dotyk s rámečkem krycí čočky (CTP-CLB)
Tato uživatelská příručka vám pomůže začít používat moduly pixxiLCD-XXP2/P4-CTP/CTP-CLB spolu s WorkShop4 IDE. Obsahuje také seznam zásadních projektů, napřampsoubory a poznámky k aplikaci.

Co je v krabici

Podpůrné dokumenty, datový list, modely kroků CAD a poznámky k aplikaci jsou k dispozici na adrese www.4dsystems.com.au

Zavedení

Tato uživatelská příručka je úvodem k seznámení se s pixxiLCDXXP2/P4-CT/CT-CLB as ním spojeným softwarovým IDE. Tato příručka by měla být
považovány pouze za užitečný výchozí bod a nikoli za komplexní referenční dokument. Seznam všech podrobných referenčních dokumentů naleznete v aplikačních poznámkách.

V této uživatelské příručce se stručně zaměříme na následující témata:

• Hardwarové a softwarové požadavky
• Připojení zobrazovacího modulu k počítači
• Začínáme s jednoduchými projekty
• Projekty využívající pixxiLCD-XXP2/P4-CT/CT-CLB
• Poznámky k aplikaci
• Referenční dokumenty

PixxiLCD-XXP2/P4-CT/CT-CLB je součástí řady zobrazovacích modulů Pixxi navržených a vyrobených společností 4D Systems. Modul je vybaven 1.3” kulatým, 2.0”, 2.5” nebo 3.9 barevným TFT LCD displejem s volitelným kapacitním dotykem. Je poháněn grafickým procesorem 4D Systems Pixxi22/Pixxi44 s bohatými funkcemi, který nabízí řadu funkcí a možností pro návrháře/integrátora/uživatele.
Inteligentní zobrazovací moduly jsou nízkonákladová vestavěná řešení používaná v různých aplikacích v lékařství, výrobě, armádě, automobilovém průmyslu, domácí automatizaci, spotřební elektronice a dalších průmyslových odvětvích. Ve skutečnosti je dnes na trhu jen velmi málo vestavěných designů, které nemají displej. Dokonce i mnoho spotřebního bílého zboží a kuchyňských spotřebičů obsahuje nějakou formu displeje. Tlačítka, otočné voliče, spínače a další vstupní zařízení nahrazují barevnější a snáze ovladatelné dotykové displeje v průmyslových strojích, termostatech, dávkovačích nápojů, 3D tiskárnách, komerčních aplikacích – prakticky v jakékoli elektronické aplikaci.
Pro designéry/uživatele, aby mohli vytvářet a navrhovat uživatelské rozhraní pro své aplikace, které poběží na 4D inteligentních zobrazovacích modulech, poskytuje 4D Systems bezplatné a uživatelsky přívětivé softwarové IDE (Integrated Development Environment) s názvem „Workshop4“ nebo „WS4“. . Toto softwarové IDE je podrobněji popsáno v části „Požadavky na systém“.

Systémové požadavky

Následující podkapitoly pojednávají o hardwarových a softwarových požadavcích této příručky.

Železářské zboží

1. Modul inteligentního displeje a příslušenství
Inteligentní zobrazovací modul pixxiLCD-xxP2/P4-CT/CT-CLB a jeho příslušenství (deska adaptéru a plochý flex kabel) jsou součástí balení, které vám bude doručeno po zakoupení z našeho webnebo prostřednictvím některého z našich distributorů. Obrázky zobrazovacího modulu a jeho příslušenství naleznete v části „Co je v krabici“.
2. Programovací modul
Programovací modul je samostatné zařízení potřebné pro připojení zobrazovacího modulu k PC s Windows. 4D Systems nabízí následující programovací modul:

• 4D programovací kabel
• Programovací adaptér uUSB-PA5-II
• 4D-UPA

Chcete-li používat programovací modul, musí být v počítači nejprve nainstalován příslušný ovladač.
Více informací a podrobný návod naleznete na produktové stránce daného modulu.
POZNÁMKA: Toto zařízení je k dispozici samostatně od 4D Systems. Více informací naleznete na produktových stránkách.

3. Ukládání médií
Workshop4 má vestavěné widgety, které lze použít k návrhu uživatelského rozhraní displeje. Většinu těchto widgetů je nutné uložit na paměťové zařízení, jako je karta microSD nebo externí flash, spolu s další grafikou. files během kroku kompilace.
POZNÁMKA: Karta microSD a externí blesk jsou volitelné a jsou potřeba pouze u projektů, které využívají grafiku files.
Upozorňujeme také, že ne všechny karty microSD na trhu jsou kompatibilní s SPI, a proto ne všechny karty lze použít v produktech 4D Systems. Nakupujte s důvěrou, vyberte si karty doporučené společností 4D Systems.

4. PC s Windows
Workshop4 běží pouze na operačním systému Windows. Doporučuje se používat na Windows 7 až Windows 10, ale měl by stále fungovat s Windows XP. Některé starší OS, jako ME a Vista, nebyly nějakou dobu testovány, nicméně software by měl stále fungovat.
Pokud chcete spustit Workshop4 na jiných operačních systémech, jako je Mac nebo Linux, doporučuje se nastavit virtuální stroj (VM) na vašem PC.

Software

1. Workshop4 IDE
Workshop4 je komplexní softwarové IDE pro Microsoft Windows, které poskytuje integrovanou platformu pro vývoj softwaru pro všechny procesory a moduly z rodiny 4D. IDE kombinuje editor, kompilátor, linker a downloader k vývoji kompletního kódu aplikace 4DGL. Veškerý kód uživatelské aplikace je vyvíjen v rámci Workshop4 IDE.
Workshop4 zahrnuje tři vývojová prostředí, z nichž si uživatel může vybrat na základě požadavků aplikace nebo dokonce úrovně uživatelských dovedností – Designer, ViSi–Genie a ViSi.

Workshop4 Prostředí
Návrhář
Toto prostředí umožňuje uživateli napsat 4DGL kód v jeho přirozené podobě pro programování zobrazovacího modulu.

ViSi – Genie
Pokročilé prostředí, které vůbec nevyžaduje žádné kódování 4DGL, vše se provádí automaticky za vás. Jednoduše rozložte displej požadovanými objekty (podobně jako ViSi), nastavte události, které je řídí, a kód se za vás napíše automaticky. ViSi-Genie poskytuje nejnovější zkušenosti s rychlým vývojem od 4D Systems.

vizi
Vizuální programovací zážitek, který umožňuje umisťování objektů typu drag-and-drop na pomoc s generováním kódu 4DGL a umožňuje uživateli vizualizovat, jak
displej bude vypadat při vývoji.

2. Nainstalujte Workshop4
Odkazy ke stažení instalačního a instalačního průvodce WS4 lze nalézt na stránce produktu Workshop4.

Připojení modulu displeje k počítači
V této části jsou uvedeny úplné pokyny pro připojení displeje k počítači. V této části jsou tři (3) možnosti pokynů, jak je znázorněno na obrázcích níže. Každá možnost je specifická pro programovací modul. Postupujte pouze podle pokynů platných pro programovací modul, který používáte.

Možnosti připojení

Možnost A – Použití 4D-UPA

1. Připojte jeden konec FFC k 15cestné ZIF patici pixxiLCD tak, aby kovové kontakty na FFC směřovaly k západce.
2. Připojte druhý konec FFC k 30cestné ZIF zásuvce na 4D-UPA tak, aby kovové kontakty na FFC směřovaly k západce
3. Připojte kabel USB-Micro-B k 4D-UPA.
4. Nakonec připojte druhý konec kabelu USB-Micro-B k počítači.

Možnost B – Použití 4D programovacího kabelu

1. Připojte jeden konec FFC k 15cestné ZIF patici pixxiLCD tak, aby kovové kontakty na FFC směřovaly k západce.
2. Připojte druhý konec FFC k 30směrné ZIF patici na gen4-IB tak, aby kovové kontakty na FFC směřovaly k západce.
3. Připojte 5kolíkovou zásuvku 4D programovacího kabelu ke gen4-IB podle orientace na štítku kabelu a modulu. Můžete to udělat také pomocí dodaného plochého kabelu.
4. Připojte druhý konec 4D programovacího kabelu k počítači.

Možnost C – Použití uUSB-PA5-II

1. Připojte jeden konec FFC k 15cestné ZIF patici pixxiLCD tak, aby kovové kontakty na FFC směřovaly k západce.
2. Připojte druhý konec FFC k 30směrné ZIF patici na gen4-IB tak, aby kovové kontakty na FFC směřovaly k západce.
3. Připojte 5kolíkovou zásuvku uUSB-PA5-II ke gen4-IB podle orientace na štítku kabelu a modulu. Můžete to udělat také pomocí dodaného plochého kabelu.
4. Připojte kabel USB-Mini-B k uUSB-PA5-II.
5. Nakonec připojte druhý konec uUSB-Mini-B k počítači.

Nechte WS4 identifikovat zobrazovací modul

Po provedení příslušné sady pokynů v předchozí části nyní musíte nakonfigurovat a nastavit Workshop4, abyste se ujistili, že identifikuje a připojí se ke správnému zobrazovacímu modulu.

1. Otevřete Workshop4 IDE a vytvořte nový projekt.
2. Ze seznamu vyberte zobrazovací modul, který používáte.
3. Vyberte požadovanou orientaci pro váš projekt.
4. Klikněte na další.
5. Vyberte programovací prostředí WS4. Povoleno bude pouze kompatibilní programovací prostředí pro modul displeje.
   
6. Klikněte na záložku COMMS, z rozevíracího seznamu vyberte port COM, ke kterému je modul displeje připojen.
7. Kliknutím na ČERVENOU tečku zahájíte skenování modulu displeje. Během skenování se zobrazí ŽLUTÁ tečka. Ujistěte se, že je váš modul správně připojen.
8. A konečně, úspěšná detekce vám dá MODRÁ tečka s názvem zobrazovacího modulu zobrazeným vedle ní.
9. Kliknutím na kartu Domů začněte vytvářet svůj projekt.

Začínáme s jednoduchým projektem

Po úspěšném připojení zobrazovacího modulu k PC pomocí vašeho programovacího modulu můžete nyní začít vytvářet základní aplikaci. Tato část ukazuje, jak navrhnout jednoduché uživatelské rozhraní pomocí prostředí ViSi-Genie a pomocí posuvníku a widgetů měřidla.
Výsledný projekt se skládá z posuvníku (vstupní widget) ovládající měřidlo (výstupní widget). Widgety lze také nakonfigurovat k odesílání zpráv o událostech na externí hostitelské zařízení přes sériový port.

Vytvořte nový projekt ViSi-Genie
Projekt ViSi-Genie můžete vytvořit otevřením Workshop a výběrem typu zobrazení a prostředí, se kterým chcete pracovat. Tento projekt bude využívat prostředí ViSi-Genie.

1. Otevřete Workshop4 poklepáním na ikonu.
2. Vytvořte nový projekt pomocí nové karty.
3. Vyberte typ zobrazení.
4. Klepněte na tlačítko Další.
5. Vyberte prostředí ViSi-Genie.

Přidejte widget posuvníku
Chcete-li přidat widget posuvníku, jednoduše klikněte na kartu Domů a vyberte widgety pro vstupy. Ze seznamu si můžete vybrat typ widgetu, který chcete použít. V tomto případě je vybrán widget posuvníku.

Jednoduše přetáhněte widget směrem k části Co-You-See-Is-What-You-Get (WYSIWYG).

Přidejte widget Gauge
Chcete-li přidat widget měřidla, přejděte do části Měřidla a vyberte typ měřidla, který chcete použít. V tomto případě je vybrán widget Coolgauge.

Pokračujte přetažením směrem k sekci WYSIWYG.

Propojte widget
Vstupní widgety lze nakonfigurovat tak, aby ovládaly výstupní widget. Chcete-li to provést, stačí kliknout na vstup (v tomto příkladuample, posuvník) a přejděte do jeho sekce Inspektor objektů a klepněte na kartu Události.
Na kartě události vstupního widgetu jsou k dispozici dvě události – OnChanged a OnChanging. Tyto události jsou spouštěny dotykovými akcemi provedenými na vstupním widgetu.
Událost OnChanged se spustí při každém uvolnění vstupního widgetu. Na druhou stranu událost OnChanging se neustále spouští, když se dotýkáte vstupního widgetu. V tomto example je použita událost OnChanging. Obsluhu události nastavte kliknutím na symbol elipsy pro obslužnou rutinu události OnChanging.

Zobrazí se okno pro výběr události. Vyberte coolgauge0Set a klikněte na OK.

Nakonfigurujte vstupní widget pro odesílání zpráv hostiteli
Externí hostitel, připojený k modulu displeje přes sériový port, může být informován o stavu widgetu. Toho lze dosáhnout konfigurací widgetu pro odesílání zpráv o událostech na sériový port. Chcete-li to provést, nastavte obslužnou rutinu události OnChanged ve widgetu posuvníku na Report Message.

Karta microSD / Vestavěná sériová flash paměť
U zobrazovacích modulů Pixxi mohou být grafická data pro widgety uložena na microSD kartu/onboard Serial Flash Memory, ke které bude mít grafický procesor zobrazovacího modulu přístup za běhu. Grafický procesor pak vykreslí widgety na displeji.

Pro použití příslušného paměťového zařízení je nutné do modulu Pixxi nahrát také příslušné PmmC. PmmC pro podporu microSD karet má příponu „-u“, zatímco PmmC pro podporu zabudované sériové paměti flash má příponu „-f“.
Chcete-li ručně nahrát PmmC, klikněte na záložku Nástroje a vyberte PmmC Loader.

Sestavte a zkompilujte projekt
Chcete-li projekt sestavit/nahrát, klepněte na ikonu (Vytvořit) Kopírovat/Načíst.

Zkopírujte požadované Files to
microSD karta / zabudovaná sériová flash paměť

microSD kartu
WS4 vygeneruje požadovanou grafiku files a zobrazí se výzva k zadání jednotky, ke které je karta microSD připojena. Ujistěte se, že je karta microSD správně připojena k počítači, a poté v okně Copy Confirmation vyberte správnou jednotku, jak je znázorněno na obrázku níže.

Po klepnutí na tlačítko OK files jsou přeneseny na microSD kartu. Odpojte kartu microSD z počítače a vložte ji do slotu pro kartu microSD v modulu displeje.

Integrovaná sériová flash paměť
Při výběru paměti Flash jako cíle pro grafiku file, ujistěte se, že v modulu není připojena žádná microSD karta
Zobrazí se okno s potvrzením kopírování, jak je znázorněno ve zprávě níže.

Klepněte na tlačítko OK a a File Zobrazí se okno přenosu. Počkejte, až proces skončí a grafika se nyní zobrazí na modulu displeje.

Otestujte aplikaci
Aplikace by nyní měla běžet na zobrazovacím modulu. Nyní by se měly zobrazit widgety posuvníku a měřidla. Začněte se dotýkat a pohybovat palcem posuvného widgetu. Změna jeho hodnoty by měla také vést ke změně hodnoty widgetu měřidla, protože tyto dva widgety jsou propojeny.

Ke kontrole zpráv použijte nástroj GTX
Ve WS4 je nástroj používaný pro kontrolu zpráv o událostech odesílaných zobrazovacím modulem na sériový port. Tento nástroj se nazývá „GTX“, což je zkratka pro „Genie Test eXecutor“. Tento nástroj lze také považovat za simulátor pro externí hostitelské zařízení. Nástroj GTX najdete v sekci Nástroje. Kliknutím na ikonu spustíte nástroj.

Posunutí a uvolnění palce posuvníku způsobí, že aplikace odešle zprávy o událostech na sériový port. Tyto zprávy pak přijme a vytiskne nástroj GTX. Další informace o podrobnostech komunikačního protokolu pro aplikace ViSiGenie naleznete v referenční příručce ViSi-Genie. Tento dokument je popsán v části „Referenční dokumenty“.

Poznámky k aplikaci

Poznámka k aplikaci	Titul	Popis	Podporované prostředí
4D-AN-00117	Návrhář Začínáme – první projekt	Tato poznámka k aplikaci ukazuje, jak vytvořit nový projekt pomocí prostředí Designer. Představuje také základy 4DGL (4D Graphics Language).	Návrhář
4D-AN-00204	ViSi Začínáme – první projekt pro Pixxi	Tato poznámka k aplikaci ukazuje, jak vytvořit nový projekt pomocí prostředí ViSi. Představuje také základy 4DGL (4D grafický jazyk a základní použití obrazovky WYSIWYG (What-You-See-Is-What-You-Get).	vizi
4D-AN-00203	ViSi Genie Začínáme – první projekt pro displeje Pixxi	Jednoduchý projekt vyvinutý v této aplikační poznámce demonstruje základní dotykovou funkčnost a interakci s objekty pomocí ViSi-Genie Životní prostředí. Projekt ukazuje, jak jsou vstupní objekty nakonfigurovány pro odesílání zpráv do externího hostitelského řadiče a jak jsou tyto zprávy interpretovány.	ViSi-Genie

Referenční dokumenty

ViSi-Genie je prostředí doporučené pro začátečníky. Toto prostředí nemusí nutně zahrnovat kódování, což z něj dělá uživatelsky nejpřívětivější platformu mezi čtyřmi prostředími.
ViSi-Genie má však svá omezení. Pro uživatele, kteří chtějí více kontroly a flexibility během návrhu a vývoje aplikací, se doporučuje prostředí Designer nebo ViSi. ViSi a Designer umožňují uživatelům psát kód pro jejich aplikace.
Programovací jazyk používaný s grafickými procesory 4D Systems se nazývá „4DGL“. Níže jsou uvedeny základní referenční dokumenty, které lze použít pro další studium různých prostředí.

Referenční příručka ViSi-Genie
ViSi-Genie provádí veškeré kódování na pozadí, žádné 4DGL, které byste se museli učit, vše udělá za vás. Tento dokument pokrývá funkce ViSi-Genie dostupné pro procesory PIXXI, PICASO a DIABLO16 a používaný komunikační protokol známý jako Genie Standard Protocol.

Referenční příručka k programátoru 4DGL
4DGL je graficky orientovaný jazyk umožňující rychlý vývoj aplikací. Rozsáhlá knihovna grafiky, textu a file systémové funkce a snadnost použití jazyka, který kombinuje nejlepší prvky a strukturu syntaxe jazyků, jako je C, Basic, Pascal atd. Tento dokument se zabývá jazykovým stylem, syntaxí a řízením toku.

Manuál k interním funkcím
4DGL má řadu vnitřních funkcí, které lze použít pro snazší programování. Tento dokument pokrývá interní (rezidentní) funkce dostupné pro procesor pixxi.

pixxiLCD-13P2/P2CT-CLB Datasheet
Tento dokument obsahuje podrobné informace o integrovaných zobrazovacích modulech pixxiLCD-13P2/P2CT-CLB.

pixxiLCD-20P2/P2CT-CLB Datasheet
Tento dokument obsahuje podrobné informace o integrovaných zobrazovacích modulech pixxiLCD-20P2/P2CT-CLB.

pixxiLCD-25P4/P4CT Datasheet
Tento dokument obsahuje podrobné informace o integrovaných zobrazovacích modulech pixxiLCD-25P4/P4CT.

pixxiLCD-39P4/P4CT Datasheet
Tento dokument obsahuje podrobné informace o integrovaných zobrazovacích modulech pixxiLCD-39P4/P4CT.

Workshop4 IDE Uživatelská příručka
Tento dokument poskytuje úvod do Workshop4, integrovaného vývojového prostředí 4D Systems.

POZNÁMKA: Další informace o Workshop4 obecně naleznete v uživatelské příručce Workshop4 IDE, která je k dispozici na adrese www.4dsystems.com.au

GLOSÁŘ

Železářské zboží

1. 4D programovací kabel – 4D programovací kabel je kabel převodníku USB na Serial-TTL UART. Kabel poskytuje rychlý a jednoduchý způsob připojení všech 4D zařízení, která vyžadují sériové rozhraní na úrovni TTL, k USB.
2. Vestavěný systém – Naprogramovaný řídicí a operační systém s vyhrazenou funkcí v rámci většího mechanického nebo elektrického systému, často s
   výpočetní omezení v reálném čase. Je zabudován jako součást kompletního zařízení, často včetně hardwaru a mechanických částí.
3. Záhlaví – konektor připojený k drátu, kabelu nebo kusu hardwaru, který má jeden nebo více zapuštěných otvorů s elektrickými svorkami uvnitř.
4. FFC – Flexibilní plochý kabel nebo FFC označuje jakýkoli elektrický kabel, který je plochý i flexibilní. Slouží k připojení displeje k programovacímu adaptéru.
5. gen4 – IB – Jednoduché rozhraní, které převádí 30cestný FFC kabel přicházející z vašeho zobrazovacího modulu gen4 na běžných 5 signálů používaných pro programování
   a propojení s produkty 4D Systems.
6. gen4-UPA – Univerzální programátor navržený pro práci s více zobrazovacími moduly 4D Systems.
7. Micro USB kabel – Typ kabelu používaný k připojení displeje k počítači.
8. Procesor – Procesor je integrovaný elektronický obvod, který provádí výpočty běžící na výpočetním zařízení. Jeho základním úkolem je přijímat vstupy a
   poskytnout odpovídající výstup.
9. Programovací adaptér – Používá se pro programování modulů displeje gen4, propojení s prádlem pro vytváření prototypů, propojení s rozhraními Arduino a Raspberry Pi.
10. Odporový dotykový panel – dotykový počítačový displej složený ze dvou ohebných listů potažených odporovým materiálem a oddělených vzduchovou mezerou nebo mikrotečkami.
11. microSD karta – Typ vyjímatelné flash paměťové karty používané pro ukládání informací.
12. uUSB-PA5-II – můstkový převodník USB na Serial-TTL UART. Poskytuje uživateli sériová data s více přenosovou rychlostí až 3M přenosovou rychlostí a přístup k dalším signálům, jako je řízení toku, v praktickém 10pinovém 2.54mm (0.1”) roztečí Dual-In-Line balíčku.
13. Zero Insertion Force – Část, do které je zasunut flexibilní plochý kabel.

Software

1. Komunikační port – sériový komunikační port nebo kanál používaný k připojení zařízení, jako je váš displej.
2. Ovladač zařízení – Zvláštní forma softwarové aplikace, která je navržena tak, aby umožňovala interakci s hardwarovými zařízeními. Bez požadovaného ovladače zařízení nebude odpovídající hardwarové zařízení fungovat.
3. Firmware – Specifická třída počítačového softwaru, který poskytuje nízkoúrovňové řízení specifického hardwaru zařízení.
4. Nástroj GTX – debugger Genie Test Executor. Nástroj používaný ke kontrole dat odeslaných a přijatých displejem.
5. GUI – forma uživatelského rozhraní, která uživatelům umožňuje interakci s elektronickými zařízeními prostřednictvím grafických ikon a vizuálních indikátorů, jako je sekundární notace,
   namísto textových uživatelských rozhraní, popisky příkazů nebo textové navigace.
6. Obraz Files – Jsou grafiky files generované při kompilaci programu, který by měl být uložen na microSD kartu.
7. Object Inspector – Sekce v Workshop4, kde může uživatel měnit vlastnosti určitého widgetu. Zde dochází k přizpůsobení widgetů a konfiguraci událostí.
8. Widget – Grafické objekty v Workshop4.
9. WYSIWYG – Co-vidíte-je-co-dostanete. Sekce grafického editoru v Workshop4, kde může uživatel přetahovat widgety.

Navštivte naši webmísto na: www.4dsystems.com.au
Technická podpora: www.4dsystems.com.au/support
Podpora prodeje: sales@4dsystems.com.au

Copyright © 4D Systems, 2022, Všechna práva vyhrazena.
Všechny ochranné známky patří jejich příslušným vlastníkům a jsou uznávány a uznávány.

Dokumenty / zdroje

4D SYSTEMS pixxiLCD-13P2-CTP-CLB Display Arduino Platform Evaluation Expansion Board [pdfUživatelská příručka pixxiLCD-13P2-CTP-CLB, Display Arduino Platform Evaluation Expansion Board, Platform Evaluation Expansion Board, Evaluation Expansion Board, pixxiLCD-13P2-CTP-CLB, Expansion Board

Reference

• Uživatelská příručka