Unit LCD

SKU:U120

描述

Unit LCD 是一款 1.14 英寸的彩色 LCD 拓展屏幕单元。采用 ST7789V2 驱动方案，分辨率为 135 x 240，支持 RGB666 显示 (262,144 色)。内部集成 ESP32-PICO 控制核心 (内置固件，显示开发更加便捷)，支持通过 I2C (addr: 0x3E) 通信接口进行控制与固件升级。屏幕背部集成了磁吸设计，能够轻松吸附金属表面进行固定。该 LCD 屏幕拓展适合嵌入到各种需要显示简单内容的仪器仪表或是控制设备中作为显示面板。

产品特性

• 1.14 inch 彩色 LCD 显示面板
• I2C 通信接口
• 可视角：全视角
• 背部磁吸设计
• 支持 I2C 固件升级

包装内容

• 1 x Unit LCD
• 1 x HY2.0-4P Grove 连接线 (20cm)

应用场景

• 信息显示屏

规格参数

原理图

管脚映射

Unit LCD

尺寸图

数据手册

• ST7789V2

软件开发

Arduino

• M5GFX Arduino 驱动库

#include <M5UnitLCD.h>

M5UnitLCD display;

M5Canvas canvas(&display);

static constexpr char text[] = "Hello world ! こんにちは世界！ this is long long string sample. 寿限無、寿限無、五劫の擦り切れ、海砂利水魚の、水行末・雲来末・風来末、喰う寝る処に住む処、藪ら柑子の藪柑子、パイポ・パイポ・パイポのシューリンガン、シューリンガンのグーリンダイ、グーリンダイのポンポコピーのポンポコナの、長久命の長助";
static constexpr size_t textlen = sizeof(text) / sizeof(text[0]);
int textpos = 0;
int scrollstep = 2;

void setup(void)
{
  display.init();
  display.setRotation(2);
  canvas.setColorDepth(1); // mono color
  canvas.setFont(&fonts::lgfxJapanMinchoP_32);
  canvas.setTextWrap(false);
  canvas.setTextSize(2);
  canvas.createSprite(display.width() + 64, 72);
}

void loop(void)
{
  int32_t cursor_x = canvas.getCursorX()-scrollstep;
  if (cursor_x <= 0)
  {
    textpos = 0;
    cursor_x = display.width();
  }

  canvas.setCursor(cursor_x, 0);
  canvas.scroll(-scrollstep, 0);
  while (textpos < textlen && cursor_x <= display.width())
  {
    canvas.print(text[textpos++]);
    cursor_x = canvas.getCursorX();
  }
  display.waitDisplay();
  canvas.pushSprite(&display, 0, (display.height()-canvas.height()) >> 1);
}

内置固件

• Unit LCD 内置固件

通信协议

关于 Unit LCD

• Unit LCD 是带有 ESP32 和 ST7789V2 的 I2C 单元。
• 它有一个分辨率为 135 x 240 的 IPS 面板。
• 可显示的颜色数为 RGB666 的 262，144 色，这是 ST7789V2 的规格。
• ESP32 负责 I2C 通信，并根据接收到的内容在内存中绘制帧缓冲区。
• ESP32 内存中帧缓冲区的内容通过 SPI 通信的 DMA 传输反映在 ST7789V2 中。
• 它由帧缓冲区上的 RGB888 16，777，216 色表示。

关于 I2C 通信

• 您可以使用 I2C 通信向单元 LCD 发送命令和接收数据。
• I2C 通信的最大通信速度为 400kHz。
• I2C 的 7 位地址的初始值为 0x3E。可以使用 CHANGE_ADDR 命令更改它。
• 发送所需的字节数取决于命令。有些命令在 1 字节内完成，而其他命令需要 7 字节。还有不定长度的命令直到通信停止才会结束。
• 如果在命令传输过程中发生 I2C 通信 STOP 或 RESTART，则不会处理中断的命令。必须在单个传输序列中不间断地传输到最后。
• 发送一个定长命令后，可以连续发送另一个命令。
• 发送不确定长度的命令后，必须停止 I2C 通信以指示命令结束。
• 如果发送 NOP 命令或未定义的命令，通信内容将被忽略，直到 I2C 通信停止。
• 由于 I2C 通信单元和绘图处理单元并行运行，因此即使在绘图处理期间也可以执行 I2C 通信。
• I2C 通信内容存储在 ESP32 内存的命令缓冲区中，绘图处理单元依次处理。
• 您应该使用 READ_BUFCOUNT 命令来检查缓冲区的剩余量，因为发送大量繁重的处理，例如广泛的填充或范围复制，可能会溢出缓冲区。

关于绘图

• 您可以通过使用 FILLRECT 用单一颜色填充任何区域来绘制矩形。
• 如果只想绘制一个像素，可以使用 DRAWPIXEL 而不是 FILLRECT。
• 如果您使用省略前景色的命令，则使用最后使用的颜色。
• 您可以使用 CASET 和 RASET 指定绘图范围，并使用 WRITE_RAW 命令发送图像数据。
• 您可以使用 WRITE_RLE 而不是 WRITE_RAW 来发送运行长度压缩的图像数据。

命令列表

※ 未定义的命令被视为空操作指令。

命令列表 (可读命令)

通信示例

命令 6Ah 一共是 7Byte 命令序列。 如果在传输过程中发生 I2C 通信 STOP 或 RESTART，则不会处理该命令。 必须在单个传输序列中不间断地传输直到结束。

任何矩形填充命令 68h 到 6Ch 均可用于矩形填充。 索引 1 到 4 是相同的，但索引 5 和以后的索引指定颜色的方法不同。

命令 68h 的 “记住颜色” 表示将重用最后指定的颜色。 换句话说，如果你想连续做几个相同颜色的矩形填充，你可以只为第一个矩形填充指定颜色，然后使用 68h 命令省略颜色指定。

命令 6Ch，ARGB8888，允许您指定 alpha 通道 (透明度)，它允许您将已绘制的内容与绘制颜色组合。

• RLE 规范基于 BMP 文件的 RLE。
• 与用于 BMP 文件的 RLE 不同，它可以用于 RGB565 和 RGB888。
• 它首先发送相同颜色 (0-255) 的连续像素数，然后是颜色数据。
• 如果 0 被发送到一个连续的号码，它将在不使用 RLE 的情况下处于直接模式。
• 在直接模式下，首先发送像素数 (1-255)，然后是像素数的颜色数据。

上面的例子将按如下方式处理。

• index1-3 : 在 RLE 模式下绘制 7 个红色像素。
• index4-5 : 切换到直接模式并指示它绘制 3 个像素。
• index6-11: 在直接模式下发送 3 个像素的颜色并绘制绿色、蓝色和红色。
• 由于 3 个像素的直接模式由 index11 完成，我们将从 index12 返回到 RLE 模式。
• index12-14 : 在 RLE 模式下绘制 4 个蓝色像素。

固件升级

• 方式 1. 使用 ESP32-Downloader 下载固件进行更新

• 方式 2. 通过 I2C 通信进行更新

UiFlow1

• Unit LCD UiFlow1 文档

UiFlow2

• Unit LCD UiFlow2 文档

相关视频

• UiFlow2 Unit LCD