ТЕХНИЧЕСКИЕ ХАРАКТЕРИСТИКИ
Дисплей пригодится для вывода графической информации - текста, изображений, рисования фигур. Дисплей основан на решении 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 соответствуют левому верхнему углу текстового блока. Текст выравнивается по левому верхнему краю. При выходе за границы эрана текст автоматически переносится на новую строку.
|
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
Ссылка на последнюю версию ПО: Прошивка дисплея
В процессе улучшения продукта, возможно, будут выходить обновления для ПО дисплея. Текущую версию ПО можно посмотреть, подключив дисплей к палте и подав питание, но не выполняя подключение дисплея в программе. Должен появиться логотип Роботрек, а внизу - версия ПО дисплея.
Для обновления ПО дисплея необходимо: