Инструменты пользователя

Инструменты сайта


ehlektronika:ispolniteli:displej

Дисплей

Дисплей ТЕХНИЧЕСКИЕ ХАРАКТЕРИСТИКИ

  1. Диагональ: 2,4«.
  2. Разрешение: 320х240.
  3. Технология: TFT.
  4. Физические размеры: 80 x 48 мм.
  5. Интерфейс подключения: UART.
  6. Напряжение питания: 3-5В.
  7. Резистивный тачскрин.
  8. Слот для карт microSD.
  9. Вес: 54г.

Описание

Дисплей пригодится для вывода графической информации - текста, изображений, рисования фигур. Дисплей основан на решении Nextion HMI, имеет разрешение 320х240px, управляется по UART, имеет резистивный тачскрин.

С помощью включенных в состав ПО «Роботрек» библиотек и графических блоков можно выполнять базовые действия - рисовать геометрические фигуры, выводить текст, включать режим рисования на тачскрине. Для вывода изображений и реализации графического пользовательского интерфейса (кнопок, ползунков, полей ввода) используйте библиотеку и программное обеспечение от ITEAD Studio.

Использование

Подключение

Датчик использует 4-пиновый разъем UART и подключается в любой из двух портов UART контроллера "Трекдуино".

Дисплей подключается к плате с помощью идущей в комплекте 4-проводной шины по следующей схеме:

Цвет провода Пин UART на плате
Черный GND
Красный 5V
Желтый TX
Синий RX

Программирование

Все блоки для работы с дисплеем расположены в группе блоков «Дисплей».

При использовании дисплея первым делом необходимо подключить соответствующую библиотеку <Dispaly.h> и создать объект класса Display, указав интерфейс UART, к которому подключен дисплей, в качестве аргумента. В визуальной среде эту функцию выполняет блок «Подключить дисплей», который необходимо использовать в секции Установка.

По умолчанию библиотека работает с дисплеем на скорости 115200. Не настраивайте используемый с дисплеем интерфейс UART вручную на другую скорость.

На данный момент дисплей не поддерживает вывод русских букв.

В функциях для дисплея, принимающих в качестве одного из аргументов цвет (keyword color), можно использовать следующие ключевые слова при работе в текстовом режиме:

Ключевое слово Цвет Соответствующее число
BLACK Черный 0
WHITE Белый 1
RED Красный 2
GREEN Зеленый 3
BLUE Синий 4
BROWN Коричневый 5
YELLOW Желтый 6
GREY Серый 7
Блок и генерируемая им функция Описание


#include <Display.h> Display display(int uartPort); 
Подключает библиотеку дисплея и создает объект с именем по умолчанию Display, очищает дисплей.

Аргументы:
UART (int uartPort) - интерфейс UART, к которому подключен дисплей. Допустимые значения - UART1 или UART2.


display.clear()
Очищает дисплей (заливает весь дисплей черным цветом).


display.line(int x1, int y1, int x2, int y2, int color);
Рисует отрезок заданного цвета шириной в 1 пиксель между точками с координатами [x1,y1] и [x2,y2].

Аргументы:
X1 (int x1) - координата х начала отрезка.
Y1 (int y1) - координата y начала отрезка.
X2 (int x2) - координата х конца отрезка.
Y2 (int y2) - координата y конца отрезка.
цвет (int color) - цвет линии.


display.rectangle(int x1, int y1, int x2, int y2, int color);
Рисует незалитый прямоугольник заданного цвета с рамкой шириной в 1 пиксель с противолежащими (по диагонали) углами в точках с координатами [x1,y1] и [x2,y2].

Аргументы:
X1 (int x1) - координата х угла прямоугольника.
Y1 (int y1) - координата y угла прямоугольника.
X2 (int x2) - координата х противолежащего угла прямоугольника.
Y2 (int y2) - координата y противолежащего угла прямоугольника.
цвет (int color) - цвет рамки прямоугольника.


display.fill(int x1, int y1, int x2, int y2, int  color);
Заливает прямоугольную площадь заданным цветом.

Аргументы:
X1 (int x1) - координата х угла прямоугольника.
Y1 (int y1) - координата y угла прямоугольника.
X2 (int x2) - координата х противолежащего угла прямоугольника.
Y2 (int y2) - координата y противолежащего угла прямоугольника.
цвет (int color) - цвет заливки.


display.circle(int x, int y, int R, int  color);
Рисует незалитую окружность шириной в 1 пиксель с радиусом R и центром в точке с координатами [x,y].

Аргументы:
X (int x) - координата х центра окружности.
Y (int y) - координата y центра окружности.
R (int R) - радиус окружности.
цвет (int color) - цвет заливки.


display.brightness(int brightness);
Изменяет яркость подсветки экрана от 0% до 100%.
Установленная яркость сохраняется до следующей перезагрузки экрана.
После перезагрузки устанавливается яркость по умолчанию = 100%.

Аргументы:
яркость (int brightness) - задаваемая яркость подсветки экрана от 0 до 100.


display.enableDrawing()


или

display.disableDrawing()
Включает/выключает режим рисования.
Процесс рисования начинается после прикосновения к тачскрину, после этого рисуется пятно красным цветом, если иной цвет не установлен блоком «цвет кисти».

Аргументы:
вкл? (bool mode) - включение или отключение.
«Истина» - включение режима рисования.
«Ложь» - выключение режима рисования.


display.drawingColor(int color)
Устанавливает цвет кисти для режима рисования.

Аргументы:
цвет (int color) - цвет кисти.


display.text(int x, int y, int font, int color, text)
Выводит текст заданного цвета и заданным шрифтом в заданном месте экрана. Координаты x,y соответствуют левому верхнему углу текстового блока. Текст выравнивается по левому верхнему краю. При выходе за границы эрана текст автоматически переносится на новую строку.


«Приклеивание» численной переменной к тексту в данном блоке не поддерживается. Можно вывести либо численную переменную (используя блок «клей»), либо текст.




Аргументы:
X (int x) - координата х начала текста.
Y (int y) - координата y начала текста.
сообщение (char[], int, float, double test) - выводимый текст.
шрифт (int font) - шрифт. Подробнее см. Шрифты и изображения.
цвет (int color) - цвет выводимого текста.




display.print(text)
Выводит текст в режиме терминала, аналогично функциям Serial.print и Serial.println.
В данном блоке возможно «Приклеивание» численной переменной к тексту.

Шрифты и изображения

Дисплей содержит в памяти набор шрифтов, доступных для вывода с помощью соответствующих функций. Стандартное ПО дисплеев, поставляемых с наборами роботрек, содержит следующие шрифты:

Условный номер Шрифт Размер символа (ШхВ) в пикселях
0 Arial 16 пт., обычный 8×16
1 Arial 24 пт., обычный 12×24
2 Arial 32 пт., обычный 16×32

Обновление ПО

Текущая версия ПО дисплея: 1.0.2

Ссылка на последнюю версию ПО: Прошивка дисплея

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

Для обновления ПО дисплея необходимо:

  1. Скачать последнюю версию по Прошивка дисплея
  2. Отключить дисплей от питания
  3. Записать файл (robotrack.tft) в корень карточки MicroSD (объем не важен)
  4. Вставить карточку в слот для карт памяти дисплея (возможно, придется разобрать корпус), подключить дисплей к плате и включить питание. Процесс обновления будет сопровождаться информацией на экране.
  5. По завершении обновления отключить питание и вытащить карту памяти.

Примеры использования в проектах

ehlektronika/ispolniteli/displej.txt · Последние изменения: 2023/02/17 14:09 — temp23