メインコンテンツまでスキップ

Arduino で使う

このページは、Arduino IDE から互換性のある任意の Seeed ePaper 製品を駆動するためのリファレンスマニュアルです。ここでは、すべてのハードウェアで共通となる部分を扱います。

  1. Arduino IDE と ESP32 ボードサポートのセットアップ。
  2. Seeed ePaper を一級サポートする、TFT_eSPI をフォークしてメンテナンスしている Seeed_GFX ライブラリのインストール。
  3. Seeed GFX Configuration Tool を使って、ボードとスクリーンの組み合わせに対応した driver.h を生成。
  4. （オプション）代替ドライバとしてサードパーティ製ライブラリ GxEPD2 を使用。

「箱を開けて、Hello World を書き込み、センサーやボタンを光らせる」までのエンドツーエンドの手順については、使用している特定ハードウェア向けのクックブックに進んでください。これらのページでは、このリファレンスで説明するボイラープレートを再利用し、そのうえで製品固有のサンプル（ペリフェラル、コード例、トラブルシューティング）を追加しています。

もしボイラープレート（まだクックブックで扱われていない新製品での Hello World）だけが必要であれば、このページだけで十分です。

対応ハードウェア​

メインハブページ 上で Arduino 列にチェックが入っているすべての Seeed ePaper 製品は、このワークフローを実行できます。概要は次のとおりです。

製品ラインMCU備考
reTerminal E1001 / E1002 / E1003 / E1004XIAO ESP32-S3（内蔵）クックブックあり — 上記リンクを参照
EE02 / EE03 / EE04 / EE05XIAO ESP32-S3 / ESP32-S3 Plus使用するスクリーンに合わせて Configuration Tool を使用
EN04 / EN05XIAO nRF52840 PlusnRF52840 ボードパッケージを選択；主なターゲットは OpenDisplay（BLE）
XIAO 7.5" ePaper PanelXIAO ESP32-C3専用の XIAO 7.5" Panel + Arduino ガイド を参照
TRMNL 7.5" (OG) DIY KitXIAO ESP32-S3 Plus専用の TRMNL DIY Kit + Arduino ガイド を参照
XIAO eInk Expansion Board v2 / ePaper Breakout Board接続した任意の XIAO使用する XIAO とスクリーンの組み合わせで Configuration Tool を使用

ステップ 1: Arduino IDE をセットアップする​

Arduino から ESP32 / ESP32-S3 / ESP32-C3 上で動作する任意の Seeed ePaper 製品を駆動するには、Arduino IDE と ESP32 ボードサポートが必要です。

ヒント

Arduino を初めて使用する場合は、先に Getting Started with Arduino を参照してください。

ステップ 1. Arduino IDE をダウンロードしてインストールします。

Arduino IDE をダウンロード

ステップ 2. ESP32 ボードサポートを追加します。Arduino IDE で File → Preferences を開き、Additional Boards Manager URLs フィールドに次を追加します。

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

ステップ 3. ESP32 ボードパッケージをインストールします：Tools → Board → Boards Manager を開き、esp32 を検索し、Espressif Systems によるパッケージをインストールします。

ステップ 4. 使用しているハードウェアに合ったボードを選択します。

  • reTerminal E シリーズ / EE04 with EE04 plus / TRMNL DIY Kit: XIAO_ESP32S3_PLUS
  • EE02 / EE03 / EE04 / EE05 standard / EN04（Arduino 経由）: XIAO_ESP32S3（nRF52840 ベースのボードでは XIAO_nRF52840）
  • XIAO 7.5" ePaper Panel: XIAO_ESP32C3

どれを選べばよいか分からない場合は、製品のクックブックに記載されています。

ステップ 5. ハードウェアを USB-C で接続し、Tools → Port から正しいポートを選択します。

ステップ 6. ESP32-S3 ボード（ほとんどの reTerminal E シリーズおよび EE0x ボード）では、PSRAM を有効にします。

Tools → PSRAM → OPI PSRAM

ステップ 2: Seeed_GFX ライブラリをインストールする​

Seeed_GFX は、Seeed 製ディスプレイを一級サポートするようにした TFT_eSPI のフォークです。当社の ePaper ライン全体に推奨されるライブラリです。

ステップ 1. GitHub から Seeed_GFX ライブラリをダウンロードします。

ライブラリをダウンロード

ステップ 2. Sketch → Include Library → Add .ZIP Library を選び、ダウンロードした ZIP を指定します。

注記

以前に TFT_eSPI をインストールしている場合は、競合を避けるために Arduino のライブラリフォルダから一時的に削除するか名前を変更してください。

ステップ 3: 使用しているハードウェア向けに driver.h を生成する​

Seeed_GFX のすべてのサンプルスケッチは、スケッチフォルダ内のローカルな driver.h を探します。このヘッダが、どのボード・スクリーンコントローラ・ピンマップを使用するかをライブラリに伝えます。Configuration Tool がこれを自動生成します。

ステップ 1. サンプルスケッチを選びます。

  • モノクロスクリーン: File → Examples → Seeed_GFX → ePaper → Basic → HelloWorld
  • カラースクリーン: File → Examples → Seeed_GFX → ePaper → Colorful → HelloWorld

ステップ 2. 同じスケッチフォルダ内に driver.h という名前の新しいファイルを作成します（Arduino IDE の新しいタブの矢印を使用）。

ステップ 3. Seeed GFX Configuration Tool を開き、使用しているハードウェアを選択します。あらかじめ用意された各デバイスは、適切な BOARD_SCREEN_COMBO 値（および USE_XIAO_EPAPER_DISPLAY_BOARD_EE04 などの追加の define）を生成します。

ステップ 4. 生成された内容をコピーし、driver.h に貼り付けます。よく使われる値の例を以下に示します。

#define BOARD_SCREEN_COMBO 520 // reTerminal E1001 (UC8179)

その他の組み合わせについては、常に Configuration Tool の出力を信頼してください。XIAO ボード（または reTerminal / EN04 / 一体型キットの場合は None）と、接続しているスクリーンを選択します。

ステップ 5. スケッチをハードウェアに書き込みます。最初の電源投入時には部分更新のみが表示される場合がありますが、その後の更新では完全な Hello World の例が表示されます。

ステップ 4（オプション）: 代わりに GxEPD2 を使う​

Seeed_GFX が推奨ライブラリですが、すでに GxEPD2 ベースのコードベースを持っている場合は、それを使って Seeed ePaper を駆動することもできます。GxEPD2 は、幅広い電子ペーパーディスプレイをカバーする人気のコミュニティライブラリです。

最新のデバイスサポートを得るために、GitHub から手動でインストールするには次のようにします。

ライブラリをダウンロード

Sketch → Include Library → Add .ZIP Library を選択し、ダウンロードした ZIP を指定します。製品クックブックには、該当する場合に具体的な GxEPD2 のサンプルが含まれています（たとえば reTerminal E シリーズクックブック では、E1002 でのフルカラー描画を紹介しています）。

次のステップ — クックブック​

このページは意図的にボイラープレートまでで止めています。ハードウェア固有のコードサンプルやエンドツーエンドの手順は、各製品のクックブックにまとめられています。

新しいePaper製品が出荷されると、対応するクックブックが各製品のフォルダの下に追加され、このメインページからそのクックブックへのリンクが更新されます。

よくある問題​

画面に何も表示されない／更新されない​

  • 最も多い原因は、ePaperのFPCケーブルが緩んでいるか、上下逆になっていることです。金属端子が上を向くように差し直してください。
  • ESP32-S3ボードでは、Tools → PSRAM で OPI PSRAM が有効になっていることを確認してください。
  • driver.h 内の BOARD_SCREEN_COMBO がお使いのハードウェアに一致していることを確認してください。値が間違っていると、エラー表示もなく画面が真っ白になります。
  • 開いたサンプルスケッチが、使用している画面（Basic か Colorful か）に対応していることを確認してください。

ボードに書き込めない​

  • 別のUSB-Cケーブルを試してください（給電専用ではなくデータ通信対応のケーブル）。
  • ESP32-S3ボードの場合：ダウンロードモードに入るため、USBケーブルを接続する前に BOOT ボタンを押し続け、接続後に離してください。
  • 再接続後、Tools → Port が正しいシリアルデバイスを指していることを確認してください。

特定の製品についてより詳しくトラブルシューティングを行う場合は、そのハードウェア用のクックブックを確認してください。

技術サポートと製品ディスカッション​

弊社製品をお選びいただきありがとうございます。私たちは、製品をできるだけスムーズにご利用いただけるよう、さまざまなサポートを提供しています。お好みやニーズに応じてお選びいただけるよう、複数のコミュニケーションチャネルをご用意しています。

Loading Comments...