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

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 を書き込んで、センサーやボタンを光らせる」までの一連の手順が必要な場合は、お使いのハードウェア専用のクックブックに進んでください。これらのページでは、このリファレンスで説明するボイラープレートを再利用しつつ、製品固有のサンプル（周辺機能、コード例、トラブルシューティング）を追加しています：

  • reTerminal E シリーズ Arduino クックブック — reTerminal E1001 / E1002 / E1003 / E1004 を対象に、周辺機能（LED、ブザー、ボタン、SHT4x、BMS、microSD、BMP 画像描画）のフルサンプルをカバーします。
  • さらに多くのクックブック（XIAO 7.5" パネル、EE0x ドライバボードなど）は、対応する製品がプラットフォームに追加され次第、順次公開されます。

もしボイラープレートだけ（まだクックブックで扱われていない新製品での 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. スケッチをハードウェアに書き込みます。初回の電源投入時は部分更新のみ表示される場合がありますが、2 回目以降の更新では Hello World の例が完全に表示されます。

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

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

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

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

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

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

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

  • reTerminal E シリーズ Arduino クックブック — E1001/E1002/E1003/E1004 での Hello World に加え、LED 制御、ブザー（パッシブ PWM ビープ音 + メロディ再生）、3 ボタン入力、SHT4x 温湿度、バッテリ管理、microSD カード、SD からの BMP 画像描画といった周辺機能一式をカバーします。
  • XIAO 7.5" ePaper Panel + Arduino — Seeed_GFX を用いた XIAO ESP32-C3 のウォークスルー。
  • TRMNL 7.5" DIY Kit + Arduino — TRMNL クラウドプラットフォームではなく、キットのハードウェアをカスタム Arduino スケッチで使用する方法。

新しい 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...