РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ
pixxiLCD СЕРИЯ
pixxiLCD-13P2/CTP-CLB
pixxiLCD-20P2/CTP-CLB
pixxiLCD-25P4/CTP
pixxiLCD-39P4/CTP

серия pixxiLCD

*Также доступна версия с защитной рамкой линзы (CLB).

ВАРИАНТЫ:
Процессор PIXXI (P2)
Процессор PIXXI (P4)
Без сенсорного экрана (NT)
Емкостный сенсорный (CTP)
Емкостный сенсорный экран с защитной рамкой линзы (CTP-CLB)
Это руководство пользователя поможет вам начать использовать модули pixxiLCD-XXP2/P4-CTP/CTP-CLB вместе с WorkShop4 IDE. Он также включает список основных проектов,ampфайлы и примечания по применению.

Что в коробке

Вспомогательные документы, техническое описание, пошаговые модели CAD и примечания по применению доступны по адресу www.4dsystems.com.ua

Введение

Данное руководство пользователя представляет собой введение в ознакомление с pixxiLCDXXP2/P4-CT/CT-CLB и связанной с ним программной средой IDE. Это руководство должно быть
рассматриваться только как полезная отправная точка, а не как всеобъемлющий справочный документ. Список всех подробных справочных документов см. в «Примечаниях к применению».

В этом Руководстве пользователя мы кратко остановимся на следующих темах:

• Требования к оборудованию и программному обеспечению
• Подключение модуля дисплея к вашему ПК
• Начало работы с простыми проектами
• Проекты с использованием pixxiLCD-XXP2/P4-CT/CT-CLB
• Заметки по применению
• Справочные документы

PixxiLCD-XXP2/P4-CT/CT-CLB является частью серии модулей дисплея Pixxi, разработанных и изготовленных 4D Systems. Модуль оснащен цветным TFT ЖК-дисплеем с диагональю 1.3 дюйма, 2.0 дюйма, 2.5 дюйма или 3.9 дюйма с дополнительным емкостным сенсорным экраном. Он оснащен многофункциональным графическим процессором 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, рекомендуется настроить виртуальную машину (ВМ) на вашем ПК.

Программное обеспечение

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

Workshop4 Окружающая среда
Дизайнер
Эта среда позволяет пользователю писать код 4DGL в его естественной форме для программирования модуля дисплея.

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

ВиСи
Опыт визуального программирования, который позволяет размещать объекты методом перетаскивания, помогая генерировать код 4DGL, и позволяет пользователю визуализировать, как
дисплей будет выглядеть во время проявления.

2. Установите Мастерскую4
Ссылки для загрузки установщика WS4 и руководства по установке можно найти на странице продукта Workshop4.

Подключение модуля дисплея к ПК
В этом разделе приведены полные инструкции по подключению дисплея к ПК. В этом разделе есть три (3) варианта инструкций, как показано на изображениях ниже. Каждая опция специфична для модуля программирования. Следуйте только инструкциям, применимым к используемому программному модулю.

Варианты подключения

Вариант А – Использование 4D-UPA

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. Откройте IDE Workshop4 и создайте новый проект.
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.

Добавить виджет слайдера
Чтобы добавить виджет-слайдер, просто нажмите вкладку «Главная» и выберите «Виджеты ввода». Из списка вы можете выбрать тип виджета, который хотите использовать. В данном случае выбран виджет слайдера.

Просто перетащите виджет в раздел What-You-See-Is-What-You-Get (WYSIWYG).

Добавить виджет датчика
Чтобы добавить виджет датчика, перейдите в раздел «Датчики» и выберите тип датчика, который вы хотите использовать. В этом случае выбран виджет Coolgauge.

Перетащите его в раздел WYSIWYG, чтобы продолжить.

Связать виджет
Виджеты ввода можно настроить для управления виджетом вывода. Для этого достаточно нажать на ввод (в этом упр.ample, виджет ползунка) и перейдите в раздел «Инспектор объектов» и щелкните вкладку «События».
На вкладке событий виджета ввода доступны два события — OnChanged и OnChanging. Эти события запускаются сенсорными действиями, выполняемыми на виджете ввода.
Событие OnChanged запускается каждый раз при отпускании виджета ввода. С другой стороны, событие OnChanging постоянно запускается при касании виджета ввода. В этом бывшемample используется событие OnChanging. Установите обработчик событий, щелкнув символ многоточия для обработчика событий OnChanging.

Появится окно выбора события. Выберите coolgauge0Set, затем нажмите OK.

Настройте виджет ввода для отправки сообщений хосту
Внешний хост, подключенный к модулю дисплея через последовательный порт, может быть уведомлен о состоянии виджета. Этого можно добиться, настроив виджет на отправку сообщений о событиях в последовательный порт. Для этого установите для обработчика событий OnChanged виджета слайдера значение Report Message.

Карта microSD/встроенная последовательная флэш-память
В модулях дисплея Pixxi графические данные для виджетов могут храниться на карте microSD/встроенной последовательной флэш-памяти, к которой будет обращаться графический процессор модуля дисплея во время работы. Затем графический процессор отобразит виджеты на дисплее.

Соответствующий PmmC также необходимо загрузить в модуль Pixxi, чтобы использовать соответствующее устройство хранения. PmmC для поддержки карт microSD имеет суффикс «-u», а PmmC для поддержки встроенной последовательной флэш-памяти имеет суффикс «-f».
Чтобы загрузить PmmC вручную, перейдите на вкладку «Инструменты» и выберите «Загрузчик PmmC».

Соберите и скомпилируйте проект
Чтобы создать/загрузить проект, щелкните значок (Сборка) Копировать/Загрузить.

Скопируйте необходимое Fileс к
Карта microSD/встроенная последовательная флэш-память

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

Нажмите OK после fileпередаются на карту microSD. Отсоедините карту microSD от ПК и вставьте ее в слот для карты microSD модуля дисплея.

Встроенная последовательная флэш-память
При выборе флэш-памяти в качестве места назначения для графики file, убедитесь, что к модулю не подключена карта microSD
Появится окно подтверждения копирования, как показано в сообщении ниже.

Нажмите ОК, и File Появится окно трансфера. Подождите, пока процесс завершится, и теперь на модуле дисплея отобразится графика.

Протестируйте приложение
Теперь приложение должно работать на модуле дисплея. Виджеты ползунка и шкалы теперь должны отображаться. Начните касаться и перемещать большой палец виджета-слайдера. Изменение его значения также должно привести к изменению значения виджета датчика, поскольку эти два виджета связаны.

Используйте инструмент GTX для проверки сообщений
В WS4 есть инструмент, используемый для проверки сообщений о событиях, отправляемых модулем дисплея на последовательный порт. Этот инструмент называется «GTX», что означает «Genie Test eXecutor». Этот инструмент также можно рассматривать как симулятор внешнего хост-устройства. Инструмент GTX можно найти в разделе «Инструменты». Нажмите на значок, чтобы запустить инструмент.

Перемещение и отпускание ползунка заставит приложение отправлять сообщения о событиях в последовательный порт. Эти сообщения затем будут получены и распечатаны GTX Tool. Дополнительную информацию о протоколе связи для приложений ViSiGenie см. в Справочном руководстве ViSi-Genie. Этот документ описан в разделе «Справочная документация».

Заметки по применению

Примечание к приложению	Заголовок	Описание	Поддерживаемая среда
4Д-АН-00117	Начало работы с дизайнером — первый проект	В этом примечании по применению показано, как создать новый проект с помощью среды дизайнера. Он также знакомит с основами 4DGL (языка 4D-графики).	Дизайнер
4Д-АН-00204	ViSi: Начало работы – первый проект для Pixxi	В этих указаниях по применению показано, как создать новый проект с использованием среды ViSi. Он также знакомит с основами 4DGL (языка 4D-графики и базового использования экрана WYSIWYG (что вы видите, то и получаете).	ВиСи
4Д-АН-00203	ВиСи Джинни Начало работы – первый проект по дисплеям 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.

Руководство пользователя IDE Workshop4
Этот документ представляет собой введение в Workshop4, интегрированную среду разработки 4D Systems.

ПРИМЕЧАНИЕ: Дополнительные сведения о Workshop4 в целом см. в Руководстве пользователя Workshop4 IDE, доступном по адресу www.4dsystems.com.ua

ГЛОССАРИЙ

Аппаратное обеспечение

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. Адаптер для программирования — используется для программирования модулей дисплея 4-го поколения, взаимодействия с макетной платой для прототипирования, взаимодействия с интерфейсами 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 — «что видишь, то и получаешь». Раздел графического редактора в Workshop4, где пользователь может перетаскивать виджеты.

Посетите наш webсайт по адресу: www.4dsystems.com.ua
Техническая поддержка: www.4dsystems.com.au/support
Поддержка продаж: sales@4dsystems.com.au

© 4D Systems, 2022. Все права защищены.
Все товарные знаки принадлежат их соответствующим владельцам и признаются и признаются.

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

Плата расширения оценочной платформы Arduino 4D Systems pixxiLCD-13P2-CTP-CLB [pdf] Руководство пользователя pixxiLCD-13P2-CTP-CLB, Оценочная плата расширения платформы Display Arduino, Оценочная плата расширения платформы, Оценочная плата расширения, pixxiLCD-13P2-CTP-CLB, Плата расширения

Ссылки

• Руководство пользователя