ПОСІБНИК КОРИСТУВАЧА
pixxiLCD СЕРІЯ
pixxiLCD-13P2/CTP-CLB
pixxiLCD-20P2/CTP-CLB
pixxiLCD-25P4/CTP
pixxiLCD-39P4/CTP

Серія pixxiLCD

*Також доступний у версії Cover Lens Bezel (CLB).

ВАРИАНТИ:
Процесор PIXXI (P2)
Процесор PIXXI (P4)
Non Touch (NT)
Ємнісний сенсорний (CTP)
Ємнісний сенсорний екран із кришкою об’єктива (CTP-CLB)
Цей посібник користувача допоможе вам почати використовувати модулі pixxiLCD-XXP2/P4-CTP/CTP-CLB разом із WorkShop4 IDE. Він також містить список основних проектів, напрampфайли та примітки до програми.

Що в коробці

Супровідні документи, таблиця даних, покрокові моделі САПР і примітки щодо застосування доступні за адресою www.4dsystems.com.au

вступ

Цей посібник користувача є вступом до ознайомлення з pixxiLCDXXP2/P4-CT/CT-CLB і пов’язаним із ним програмним середовищем IDE. Цей посібник має бути
розглядається лише як корисна відправна точка, а не як вичерпний довідковий документ. Зверніться до Приміток до програми, щоб отримати список усіх детальних довідкових документів.

У цьому посібнику користувача ми коротко зупинимося на наступних темах:

• Вимоги до обладнання та програмного забезпечення
• Підключення дисплея до ПК
• Початок роботи з простими проектами
• Проекти за допомогою pixxiLCD-XXP2/P4-CT/CT-CLB
• Примітки до програми
• Довідкові документи

pixxiLCD-XXP2/P4-CT/CT-CLB є частиною серії дисплеїв Pixxi, розроблених і виготовлених компанією 4D Systems. Модуль має 1.3-дюймовий круглий, 2.0-дюймовий, 2.5-дюймовий або 3.9-кольоровий TFT РК-дисплей з додатковим ємнісним сенсорним екраном. Він оснащений багатофункціональним графічним процесором 4D Systems Pixxi22/Pixxi44, який пропонує набір функцій і опцій для дизайнера/інтегратора/користувача.
Інтелектуальні дисплеї — це недорогі вбудовані рішення, які використовуються в різних сферах медицини, виробництва, військових, автомобільної промисловості, домашньої автоматизації, споживчої електроніки та інших галузей. Фактично, сьогодні на ринку дуже мало вбудованих конструкцій, які не мають дисплея. Навіть багато споживчої білої техніки та кухонної техніки мають певну форму дисплея. Кнопки, поворотні селектори, перемикачі та інші пристрої введення замінюються більш барвистими та зручнішими сенсорними дисплеями в промислових машинах, термостатах, дозаторах напоїв, 3D-принтерах, комерційних програмах – практично в будь-якій електронній програмі.
Щоб дизайнери/користувачі могли створювати та проектувати інтерфейс користувача для своїх додатків, які працюватимуть на модулях інтелектуального 4D-дисплею, 4D Systems надає безкоштовне та зручне програмне середовище IDE (інтегроване середовище розробки) під назвою «Workshop4» або «WS4». . Більш детально це програмне середовище IDE описано в розділі «Системні вимоги».

Системні вимоги

У наступних підрозділах розглядаються вимоги до апаратного та програмного забезпечення цього посібника.

Обладнання

1. Інтелектуальний дисплейний модуль і аксесуари
Модуль інтелектуального дисплея pixxiLCD-xxP2/P4-CT/CT-CLB і його аксесуари (адаптерна плата та плоский гнучкий кабель) входять у коробку та доставляються вам після покупки в нашому webсайту або через одного з наших дистриб’юторів. Зображення модуля дисплея та його аксесуарів див. у розділі «Що в коробці».
2. Модуль програмування
Модуль програмування — це окремий пристрій, необхідний для підключення дисплея до ПК з ОС Windows. 4D Systems пропонує наступний модуль програмування:

• Кабель для програмування 4D
• Адаптер програмування uUSB-PA5-II
• 4Д-УПА

Щоб використовувати модуль програмування, спочатку необхідно встановити на ПК відповідний драйвер.
Ви можете звернутися до сторінки продукту даного модуля для отримання додаткової інформації та детальних інструкцій.
ПРИМІТКА: Цей пристрій доступний окремо від 4D Systems. Для отримання додаткової інформації зверніться до сторінок продукту.

3. Зберігання носіїв
Workshop4 має вбудовані віджети, які можна використовувати для розробки інтерфейсу користувача дисплея. Більшість із цих віджетів потрібно зберігати на запам’ятовуючому пристрої, наприклад на картці microSD або зовнішньому флеш-пам’яті, разом із іншою графікою files на етапі компіляції.
ПРИМІТКА: карта microSD і зовнішня флеш-пам’ять є необов’язковими та потрібні лише для проектів, які використовують графіку files.
Зверніть також увагу, що не всі картки microSD на ринку є сумісними з SPI, а тому не всі картки можна використовувати в продуктах 4D Systems. Купуйте сміливо, вибирайте карти, рекомендовані 4D Systems.

4. ПК Windows
Workshop4 працює лише в операційній системі Windows. Рекомендовано використовувати в Windows 7 до Windows 10, але все ще має працювати з Windows XP. Деякі старіші ОС, такі як ME та Vista, не тестувалися протягом тривалого часу, однак програмне забезпечення має працювати.
Якщо ви хочете запустити Workshop4 в інших операційних системах, таких як Mac або Linux, рекомендується налаштувати віртуальну машину (VM) на вашому ПК.

програмне забезпечення

1. Workshop4 IDE
Workshop4 — це комплексне програмне середовище IDE для Microsoft Windows, яке забезпечує інтегровану платформу розробки програмного забезпечення для всіх процесорів і модулів сімейства 4D. IDE поєднує в собі редактор, компілятор, компонувальник і завантажувач для розробки повного програмного коду 4DGL. Весь код програми користувача розроблено в середовищі IDE Workshop4.
Workshop4 включає три середовища розробки, які користувач може вибрати залежно від вимог програми або навіть рівня навичок користувача – Designer, ViSi–Genie та ViSi.

Workshop4 Середовища
Дизайнер
Це середовище дозволяє користувачеві писати код 4DGL у його природній формі для програмування модуля дисплея.

ВіСі – Джин
Розширене середовище, яке взагалі не потребує кодування 4DGL, все робиться автоматично за вас. Просто розмістіть на дисплеї потрібні вам об’єкти (подібно до ViSi), встановіть події для їх керування, і код буде написаний для вас автоматично. ViSi-Genie надає новітній досвід швидкої розробки від 4D Systems.

ВіСі
Візуальний досвід програмування, який дозволяє розміщувати об’єкти за допомогою перетягування, щоб допомогти з генерацією коду 4DGL, і дозволяє користувачеві візуалізувати, як
дисплей буде виглядати під час проявлення.

2. Встановіть Workshop4
Посилання для завантаження інсталятора WS4 і посібника зі встановлення можна знайти на сторінці продукту Workshop4.

Підключення дисплея до ПК
У цьому розділі наведені повні інструкції щодо підключення дисплея до ПК. У цьому розділі є три (3) варіанти інструкцій, як показано на зображеннях нижче. Кожна опція є специфічною для модуля програмування. Дотримуйтеся лише інструкцій, що стосуються модуля програмування, який ви використовуєте.

Параметри підключення

Варіант А – за допомогою 4Д-УПА

1. Під’єднайте один кінець FFC до 15-контактного роз’єму ZIF на pixxiLCD так, щоб металеві контакти FFC були звернені до засувки.
2. Під’єднайте інший кінець FFC до 30-контактного роз’єму ZIF на 4D-UPA так, щоб металеві контакти на FFC були звернені до засувки
3. Підключіть кабель USB-Micro-B до 4D-UPA.
4. Нарешті, під’єднайте інший кінець кабелю USB-Micro-B до комп’ютера.

Варіант Б – використання кабелю для програмування 4D

1. Під’єднайте один кінець FFC до 15-контактного роз’єму ZIF на pixxiLCD так, щоб металеві контакти FFC були звернені до засувки.
2. Під’єднайте інший кінець FFC до 30-контактного роз’єму ZIF на gen4-IB так, щоб металеві контакти FFC були звернені до засувки.
3. Під’єднайте 5-контактний гніздо кабелю програмування 4D до gen4-IB, дотримуючись орієнтації на етикетках кабелю та модуля. Ви також можете зробити це за допомогою стрічкового кабелю, що додається.
4. Підключіть інший кінець кабелю 4D-програмування до комп’ютера.

Варіант C – використання uUSB-PA5-II

1. Під’єднайте один кінець FFC до 15-контактного роз’єму ZIF на pixxiLCD так, щоб металеві контакти FFC були звернені до засувки.
2. Під’єднайте інший кінець FFC до 30-контактного роз’єму ZIF на gen4-IB так, щоб металеві контакти FFC були звернені до засувки.
3. Під’єднайте 5-контактний гніздо uUSB-PA5-II до gen4-IB, дотримуючись орієнтації на етикетках кабелю та модуля. Ви також можете зробити це за допомогою стрічкового кабелю, що додається.
4. Під’єднайте кабель USB-Mini-B до uUSB-PA5-II.
5. Нарешті, підключіть інший кінець uUSB-Mini-B до комп’ютера.

Нехай WS4 ідентифікує дисплейний модуль

Після виконання відповідного набору інструкцій у попередньому розділі вам тепер потрібно налаштувати та налаштувати Workshop4, щоб переконатися, що він ідентифікує та підключається до правильного модуля дисплея.

1. Відкрийте Workshop4 IDE і створіть новий проект.
2. Виберіть зі списку модуль дисплея, який ви використовуєте.
3. Виберіть бажану орієнтацію для свого проекту.
4. Натисніть далі.
5. Виберіть середовище програмування WS4. Буде ввімкнено лише сумісне середовище програмування для модуля дисплея.
   
6. Клацніть на вкладці COMMS, виберіть зі спадного списку COM-порт, до якого підключено дисплейний модуль.
7. Натисніть на ЧЕРВОНУ крапку, щоб почати сканування модуля дисплея. Під час сканування відображатиметься ЖОВТА крапка. Переконайтеся, що ваш модуль підключено правильно.
8. Нарешті, успішне виявлення дасть вам БЛАКИТНУ крапку з назвою модуля дисплея, що відображається поруч.
9. Клацніть вкладку «Головна», щоб почати створення проекту.

Початок роботи з простим проектом

Після успішного підключення модуля дисплея до ПК за допомогою модуля програмування ви можете почати створювати базову програму. У цьому розділі показано, як створити простий інтерфейс користувача за допомогою середовища ViSi-Genie і віджетів повзунка та калібрувача.
Отриманий проект складається з повзунка (віджет введення), який керує датчиком (віджет виводу). Віджети також можна налаштувати для надсилання повідомлень про події на зовнішній хост-пристрій через послідовний порт.

Створіть новий проект ViSi-Genie
Ви можете створити проект ViSi-Genie, відкривши Workshop і вибравши тип відображення та середовище, з яким ви хочете працювати. Цей проект буде використовувати середовище ViSi-Genie.

1. Відкрийте Workshop4, двічі клацнувши піктограму.
2. Створіть новий проект за допомогою нової вкладки.
3. Виберіть тип дисплея.
4. Натисніть Далі.
5. Виберіть середовище ViSi-Genie.

Додайте віджет-повзунок
Щоб додати віджет-повзунок, просто клацніть вкладку «Головна» та виберіть «Віджети введення». Зі списку ви можете вибрати тип віджета, який хочете використовувати. У цьому випадку вибрано віджет-повзунок.

Просто перетягніть віджет до розділу WYSIWYG (What-You-See-Is-What-You-Get).

Додайте віджет Gauge
Щоб додати віджет датчика, перейдіть до розділу Датчики та виберіть тип датчика, який ви хочете використовувати. У цьому випадку вибрано віджет Coolgauge.

Щоб продовжити, перетягніть його до розділу WYSIWYG.

Пов’яжіть віджет
Віджети введення можна налаштувати для керування віджетом виведення. Для цього просто натисніть на вхід (у цьому прикладіample, віджет-повзунок) і перейдіть до його розділу «Інспектор об’єктів» і клацніть вкладку «Події».
На вкладці подій віджета введення доступні дві події – OnChanged і OnChanging. Ці події викликаються діями дотику, які виконуються на віджеті введення.
Подія OnChanged запускається кожного разу, коли випускається віджет введення. З іншого боку, подія OnChanging постійно запускається під час торкання віджета введення. У цьому ексample використовується подія OnChanging. Встановіть обробник подій, клацнувши символ з крапкою для обробника подій OnChanging.

З’явиться вікно вибору під час події. Виберіть coolgauge0Set і натисніть OK.

Налаштуйте віджет введення для надсилання повідомлень на хост
Зовнішній хост, підключений до модуля дисплея через послідовний порт, може бути повідомлений про статус віджета. Цього можна досягти, налаштувавши віджет на надсилання повідомлень про події до послідовного порту. Для цього встановіть обробник події OnChanged віджета-повзунка на повідомлення про повідомлення.

Карта microSD / вбудована послідовна флеш-пам'ять
У модулях дисплея Pixxi графічні дані для віджетів можна зберігати на картці microSD/вбудованій послідовній флеш-пам’яті, доступ до якої буде мати графічний процесор модуля дисплея під час роботи. Графічний процесор відтворить віджети на дисплеї.

Відповідний PmmC також потрібно завантажити в модуль Pixxi, щоб використовувати відповідний пристрій зберігання даних. PmmC для підтримки карт microSD має суфікс «-u», а PmmC для підтримки вбудованої послідовної флеш-пам’яті має суфікс «-f».
Щоб завантажити PmmC вручну, натисніть вкладку «Інструменти» та виберіть «Завантажувач PmmC».

Збірка та компіляція проекту
Щоб створити/завантажити проект, клацніть піктограму (Збірка) Копіювати/Завантажити.

Скопіюйте обов'язкове Files до
карта microSD / вбудована послідовна флеш-пам'ять

карта microSD
WS4 генерує необхідну графіку files і запропонує вказати диск, до якого підключено картку microSD. Переконайтеся, що картку microSD правильно підключено до ПК, а потім виберіть правильний диск у вікні підтвердження копіювання, як показано на зображенні нижче.

Натисніть OK після files передаються на картку microSD. Від’єднайте картку microSD від ПК і вставте її в гніздо для картки microSD модуля дисплея.

Вбудована послідовна флеш-пам'ять
При виборі флеш-пам’яті як місця призначення для графіки file, переконайтеся, що в модулі не під’єднано картку microSD
З’явиться спливаюче вікно підтвердження копіювання, як показано в повідомленні нижче.

Натисніть OK і a File Відкриється вікно трансферу. Зачекайте, поки процес завершиться, і графіка відобразиться на дисплеї.

Перевірте додаток
Тепер програма має працювати на модулі дисплея. Тепер мають відображатися повзунок і віджети вимірювача. Почніть торкатися та рухати великим пальцем віджет-повзунок. Зміна його значення також має призвести до зміни значення віджета вимірювача, оскільки два віджети пов’язані.

Використовуйте GTX Tool, щоб перевірити повідомлення
У WS4 є інструмент, який використовується для перевірки повідомлень про події, які надсилаються дисплеєм на послідовний порт. Цей інструмент називається «GTX», що означає «Genie Test eXecutor». Цей інструмент також можна розглядати як симулятор для зовнішнього хост-пристрою. Інструмент GTX можна знайти в розділі Інструменти. Натисніть на значок, щоб запустити інструмент.

Якщо перемістити та відпустити великий палець повзунка, програма надсилатиме повідомлення про події до послідовного порту. Потім ці повідомлення будуть отримані та надруковані GTX Tool. Для отримання додаткової інформації про протокол зв’язку для програм ViSiGenie зверніться до довідкового посібника ViSi-Genie. Цей документ описано в розділі «Довідкові документи».

Примітки до програми

Примітка до програми	Назва	опис	Підтримуване середовище
4D-AN-00117	Початок роботи дизайнера – перший проект	Ця примітка до програми показує, як створити новий проект за допомогою середовища дизайнера. Він також знайомить з основами 4DGL (4D Graphics Language).	Дизайнер
4D-AN-00204	ViSi Getting Started – перший проект для Pixxi	Ця примітка до програми показує, як створити новий проект за допомогою середовища ViSi. Він також знайомить з основами 4DGL (мова 4D-графіки) і базовим використанням екрана WYSIWYG (Що-Ви-Бачите-Є-Що-Ви-Отримуєте).	ВіСі
4D-AN-00203	ViSi Genie Початок роботи – перший проект для дисплеїв Pixxi	Простий проект, розроблений у цій нотатці про застосування, демонструє базову сенсорну функціональність і взаємодію з об’єктами за допомогою ViSi-Genie Навколишнє середовище. Проект ілюструє, як вхідні об’єкти налаштовані для надсилання повідомлень зовнішньому хост-контролеру та як ці повідомлення інтерпретуються.	ВіСі-Джин

Довідкові документи

ViSi-Genie — середовище, рекомендоване для початківців. Це середовище не обов’язково передбачає кодування, що робить його найбільш зручною платформою серед чотирьох середовищ.
Однак ViSi-Genie має свої обмеження. Для користувачів, які бажають більше контролю та гнучкості під час проектування та розробки додатків, рекомендується середовище Designer або ViSi. ViSi та Designer дозволяють користувачам писати код для своїх програм.
Мова програмування, яка використовується з графічними процесорами 4D Systems, називається «4DGL». Основні довідкові документи, які можна використовувати для подальшого вивчення різних середовищ, перераховані нижче.

Довідковий посібник ViSi-Genie
ViSi-Genie виконує все фонове кодування, не потрібно вивчати 4DGL, воно робить усе за вас. У цьому документі описано функції ViSi-Genie, доступні для процесорів PIXXI, PICASO та DIABLO16, а також використовуваний протокол зв’язку, відомий як стандартний протокол Genie.

Довідковий посібник програміста 4DGL
4DGL — це графічно орієнтована мова, яка дозволяє швидко розробляти програми. Велика бібліотека графіки, тексту та file системні функції та простота використання мови, яка поєднує в собі найкращі елементи та структуру синтаксису таких мов, як C, Basic, Pascal тощо. Цей документ охоплює стиль мови, синтаксис і керування потоком.

Інструкція з внутрішніх функцій
4DGL має ряд внутрішніх функцій, які можна використовувати для полегшення програмування. Цей документ описує внутрішні (резидентні) функції, доступні для процесора pixxi.

Технічний опис pixxiLCD-13P2/P2CT-CLB
Цей документ містить детальну інформацію про інтегровані модулі дисплея pixxiLCD-13P2/P2CT-CLB.

Технічний опис pixxiLCD-20P2/P2CT-CLB
Цей документ містить детальну інформацію про інтегровані модулі дисплея pixxiLCD-20P2/P2CT-CLB.

Технічний опис pixxiLCD-25P4/P4CT
Цей документ містить детальну інформацію про інтегровані модулі дисплея pixxiLCD-25P4/P4CT.

Технічний опис pixxiLCD-39P4/P4CT
Цей документ містить детальну інформацію про інтегровані модулі дисплея pixxiLCD-39P4/P4CT.

Workshop4 IDE Посібник користувача
Цей документ містить вступ до Workshop4, інтегрованого середовища розробки 4D Systems.

ПРИМІТКА: Для отримання додаткової інформації про Workshop4 загалом зверніться до посібника користувача IDE Workshop4, доступного за адресою www.4dsystems.com.au

ГЛОСАРІЙ

Обладнання

1. 4D-кабель для програмування – 4D-кабель для програмування є кабелем-перетворювачем USB на Serial-TTL UART. Кабель забезпечує швидкий і простий спосіб підключення всіх 4D-пристроїв, яким потрібен послідовний інтерфейс рівня TTL, до USB.
2. Вбудована система – запрограмована керуюча та операційна система зі спеціальною функцією в рамках більшої механічної або електричної системи, часто з
   обчислювальні обмеження в реальному часі. Він вбудований як частина повного пристрою, який часто включає апаратні та механічні частини.
3. Гніздо – з’єднувач, приєднаний до дроту, кабелю або частини апаратного забезпечення, який має один або більше заглиблених отворів з електричними клемами всередині.
4. FFC – гнучкий плоский кабель, або FFC, відноситься до будь-якого різновиду електричного кабелю, який одночасно є плоским і гнучким. Він використовувався для підключення дисплея до адаптера програмування.
5. gen4 – IB – простий інтерфейс, який перетворює 30-контактний кабель FFC, що надходить від модуля дисплея gen4, у загальні 5 сигналів, які використовуються для програмування
   і підключення до продуктів 4D Systems.
6. gen4-UPA – універсальний програматор, призначений для роботи з декількома модулями відображення 4D Systems.
7. Кабель Micro USB – тип кабелю, який використовується для підключення дисплея до комп’ютера.
8. Процесор – процесор – це інтегрована електронна схема, яка виконує обчислення, які запускають обчислювальний пристрій. Його основна робота — отримувати вхідні дані та
   забезпечити відповідний результат.
9. Адаптер програмування – використовується для програмування модулів дисплея gen4, підключення до макетної плати для створення прототипів, підключення до інтерфейсів Arduino та Raspberry Pi.
10. Резистивна сенсорна панель – чутливий до дотику комп’ютерний дисплей, що складається з двох гнучких листів, покритих резистивним матеріалом і розділених повітряним проміжком або мікроточками.
11. Картка microSD – тип знімної флеш-картки, яка використовується для зберігання інформації.
12. uUSB-PA5-II – мостовий перетворювач USB на Serial-TTL UART. Він надає користувачеві послідовні дані з різною швидкістю передачі даних до 3 МБ і доступ до додаткових сигналів, таких як керування потоком, у зручному 10-контактному пакеті Dual-In-Line з кроком 2.54 мм (0.1 дюйма).
13. Нульове зусилля вставлення – частина, куди вставляється гнучкий плоский кабель.

програмне забезпечення

1. Комунікаційний порт – послідовний порт або канал зв’язку, який використовується для підключення таких пристроїв, як ваш дисплей.
2. Драйвер пристрою – особлива форма програмного забезпечення, призначеного для взаємодії з апаратними пристроями. Без необхідного драйвера пристрою відповідний апаратний пристрій не працює.
3. Мікропрограмне забезпечення – певний клас комп’ютерного програмного забезпечення, яке забезпечує низькорівневе керування конкретним апаратним забезпеченням пристрою.
4. GTX Tool – відладчик Genie Test Executor. Інструмент, який використовується для перевірки даних, надісланих і отриманих дисплеєм.
5. GUI – Форма інтерфейсу користувача, яка дозволяє користувачам взаємодіяти з електронними пристроями за допомогою графічних піктограм і візуальних індикаторів, таких як вторинна нотація,
   замість текстових користувальницьких інтерфейсів, введені мітки команд або текстова навігація.
6. Зображення Files – це графіка files, створені під час компіляції програми, які слід зберегти на карті microSD.
7. Інспектор об’єктів – розділ у Workshop4, де користувач може змінювати властивості певного віджета. Тут відбувається налаштування віджетів і конфігурація подій.
8. Віджет – графічні об’єкти в Workshop4.
9. WYSIWYG – What-You-See-Is-What-You-Get. Розділ графічного редактора в Workshop4, де користувач може перетягувати віджети.

Відвідайте наш webсайт за адресою: www.4dsystems.com.au
Технічна підтримка: www.4dsystems.com.au/support
Підтримка продажів: sales@4dsystems.com.au

Copyright © 4D Systems, 2022, Усі права захищено.
Усі товарні знаки належать їхнім відповідним власникам і визнані та визнані.

Документи / Ресурси

4D SYSTEMS pixxiLCD-13P2-CTP-CLB Дисплей Плата розширення оцінки платформи Arduino [pdfПосібник користувача pixxiLCD-13P2-CTP-CLB, Плата розширення оцінки платформи Display Arduino, Плата розширення оцінки платформи, Плата розширення оцінки, pixxiLCD-13P2-CTP-CLB, Плата розширення

Список літератури

• Посібник користувача