Unit LCD

SKU:U120

説明

ユニットLCDは、1.14インチカラー液晶ディスプレイの拡張画面ユニットです。ST7789V2駆動方式を採用し、解像度は135*240、RGB666表示（262,144色）に対応しています。ESP32-PICO制御コアの内部統合（ファームウェア内蔵、ディスプレイ開発がより便利）、I2C（addr | 0x3E）通信インターフェースによる制御とファームウェアアップグレードをサポートします。画面背面にはマグネットを内蔵しており、金属面に簡単に吸着して固定することができます。LCDスクリーンエクステンションは、表示パネルとして簡単なコンテンツを表示する必要がある様々な機器や制御機器への組み込みに適しています。

製品の特徴

• 1.14インチカラー液晶ディスプレイパネル
• ST7789V2駆動方式
• I2C通信インターフェース
• 解像度: 135*240
• 視野角: 全視野角
• 磁気背部設計
• I2Cファームウェアのアップグレードをサポート

含まれるもの

• 1x Unit LCD
• 1x HY2.0-4P ケーブル

アプリケーション

• 情報表示

仕様

PinMap

回路図

関連リンク

• データシート

  • ST7789V2

• ライブラリ

  • M5GFX ライブラリ

• ファームウェア

  • M5UnitLCD_FirmWare

例

• 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);
}

Video

ユニットLCDについて

• ユニットLCDは、ESP32とST7789V2を搭載したI2Cユニットです。
• IPSパネルを搭載しており、解像度は135×240です。
• 表示可能な色数は、ST7789V2の仕様であるRGB666の262,144色です。
• ESP32はI2C通信を担当し、受信した内容に基づいてメモリ内のフレームバッファに描画します。
• ESP32のメモリ内のフレームバッファの内容は、SPI通信のDMA転送によりST7789V2に反映されます。
• フレームバッファ上ではRGB888 16,777,216色で表現されます。

ユニットLCDとの通信について

• ユニットLCDとの通信は、I2C通信でコマンドの送信とデータの受信が可能です。
• I2C通信の最大通信速度は、400kHzです。
• I2Cの7ビットアドレスの初期値は、0x3Eです。CHANGE_ADDRコマンドで変更可能です。
• 送信に必要なバイト数はコマンドによって異なり、1Byteで完了するコマンドもあれば、7Byte必要なコマンドもあります。
• コマンド送信中にI2C通信のSTOPやRESTARTが発生した場合、中断されたコマンドは処理されません。
  1回の送信シーケンスで最後まで途切れずに送信する必要があります。
• 固定長のコマンドを送信した後、続けて別のコマンドを送信することができます。
• 不定長のコマンドを送信した後は、コマンドの終了を示すためにI2C通信を停止させる必要があります。
• NOPコマンドや未定義コマンドを送信した場合、I2C通信が停止するまで通信内容は無視されます。
• I2C通信部と描画処理部は並列に動作するため、描画処理中であってもI2C通信を行うことができる。
• I2C通信の内容は、ESP32のメモリ上のコマンドバッファに格納され、描画処理部はこれを順次処理する。
• 広範囲な塗りつぶしや範囲コピーなどの重い処理を大量に送信すると、コマンドバッファを圧迫してしまうので、READ_BUFCOUNTコマンドでバッファの残量を確認する必要があります。

描画コマンドについて

• FILLRECT で任意の領域を単色で塗りつぶすと、矩形が描画されます。
• 1 ピクセルだけ描画したい場合は，FILLRECT の代わりに DRAWPIXEL を使用することができます．
• 前景色を省略したコマンドを使用した場合は、最後に使用した色が使用されます。
• CASET、RASET で描画範囲を指定し、WRITE_RAW コマンドで画像データを送信することができる。
• WRITE_RAW の代わりに WRITE_RLE を使用すると、ランレングス圧縮された画像データを送信することができる。

コマンドリスト

未定義のコマンドは、NOP として扱われます。

コマンドリスト (読み取り可能なコマンド)

通信例

コマンド 6Ah は、合計 7Byte のコマンド列です。 送信中に I2C 通信の STOP または RESTART が発生した場合、コマンドは処理されません。 1回の送信シーケンスで最後まで途切れることなく送信する必要があります。

矩形塗り潰しコマンドは、68h～6Chのいずれかを使用することができます。 インデックス1～4は同じですが、インデックス5以降は色の指定方法が異なります。

コマンド68hの記憶色は、最後に指定した色を再利用することを意味します。 つまり、同じ色の矩形塗りつぶしを何回か続けて行いたい場合、最初の矩形塗りつぶしだけ色を指定し、68hコマンドで色指定を省略することができるのです。

コマンド6Ch、ARGB8888では、アルファチャンネル（透明度）を指定することで、すでに描かれている内容を描画色と合成することができます。

---

---

• RLE の仕様は、BMP ファイル用の RLE をベースにしている。
• BMPファイル用のRLEとは異なり、RGB565とRGB888に使用することができます。
• まず、同じ色の連続した画素数（0～255）を送信し、その後に色データを送信します。
• 連続した番号に0を送ると、RLEを使用しないダイレクトモードになります。
• ダイレクトモードでは、まず画素数（1～255）を送信し、その後に画素数分の色データを送信します。

上記の例では、以下のように処理されます。

• index1-3 : RLEモードで赤を7画素描画する。
• index4-5 : ダイレクトモードに切り替え、3ピクセル描画するよう指示。
• index6-11 : ダイレクトモードで3画素分の色を送信し、緑、青、赤を描画します。
• index11で3画素分のダイレクトモードが終了しているので、index12からRLEモードに戻ることになります。
• index12-14 : RLEモードで4画素分の青を描画します。

ファームウェアのアップグレード

方法1. ESP32-Downloaderを使用して、更新用ファームウェアをダウンロードする。

M5Burner をダウンロードし、UNITの液晶ケースを開けて、 ESP32 DOWNLOADER でアップデートしてください。

方法2. I2C通信によるアップデート

上記の Githubソースコード または リソースページからM5Burnerをダウンロード をコンパイルし、M5Core1/Core2/M5StickC/Plus/ATOM/PaperのいずれかのマスターコントローラにRecord LCD_UNIT_FirmwareUpdater ファームウェアを書き込みます。UNIT LCDをI2Cポートに配線することで、自動的にアップデートが開始されます。