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

OpenEPaperLink / OpenDisplay を使う

OpenDisplay と OpenEPaperLink (OEPL) は、Bluetooth Low Energy (BLE) 経由で ePaper ディスプレイを駆動するためのオープンソースエコシステムです。スマートフォン、コンピュータ、または Home Assistant ホストがディスプレイに直接接続できるため、基本的なワークフローでは 802.15.4 アクセスポイントは不要です。

このガイドでは、2 つの Seeed ハードウェアパスを扱います：

  • OpenDisplay Toolbox パス — reTerminal E1001、reTerminal E1002、reTerminal E1003、および XIAO ePaper Display Board EN04 上でそのまま使える OpenDisplay ファームウェアに推奨されるパスです。
  • OEPL_BLE パス — ePaper Breakout Board for Seeed Studio XIAO と XIAO nRF52840 シリーズボード を用いたモジュラーな DIY 構成に便利なパスです。

どちらのパスでもユーザー体験は似ています。ファームウェアをインストールし、BLE 経由でデバイスを設定し、その後イメージをアップロードします。使用するツールやサポートされるプリセットが異なるため、自分のハードウェアに合ったタブに従ってください。

対応ハードウェア​

OpenDisplay Toolbox には、reTerminal E1001、reTerminal E1002、reTerminal E1003 用のプリセットが含まれています。

reTerminal E1001reTerminal E1002reTerminal E1003
今すぐ入手 🖱️
今すぐ入手 🖱️
今すぐ入手 🖱️
7.5 インチ モノクロ、800 × 4807.3 インチ Spectra 6 色、800 × 48010.3 インチ モノクロ、1404 × 1872、タッチ対応
Toolbox で開くToolbox で開くToolbox で開く

完成品の reTerminal E シリーズデバイス上で OpenDisplay ファームウェアを直接実行したい場合は、このパスを使用してください。

注意

OpenDisplay ファームウェアをインストールすると、現在デバイス上で動作しているファームウェアが置き換えられます。公式の reTerminal E-Series Firmware Hub または製品 Wiki で推奨されているファームウェアパッケージを使用して、復元用のパスを必ず用意しておいてください。

なぜ OpenDisplay / OpenEPaperLink を使うのか？​

  • BLE ファーストのワークフロー — 専用の 802.15.4 アクセスポイントなしで、設定とイメージのアップロードが行えます。
  • ブラウザベースのツール — 対応ブラウザから、ファームウェアのインストール、プリセットの選択、デバイスの設定、イメージのアップロードができます。
  • Seeed ハードウェアプリセット — OpenDisplay Toolbox には reTerminal E1001、E1002、E1003、EN04 用のプリセットが含まれています。
  • Home Assistant 対応 — OpenDisplay デバイスは、Home Assistant の公式 OpenDisplay インテグレーションを通じて追加できます。
  • オープンソースエコシステム — ファームウェア、ツール、インテグレーションは公開リポジトリで開発されています。

ステップ 1: ハードウェアのセットアップ​

ステップ 1. reTerminal E シリーズデバイスを USB-C データケーブルでコンピュータに接続します。

ステップ 2. デバイスの電源を入れ、コンピュータの近くに置きます。ブラウザは、ファームウェアのインストールに USB を、設定には BLE を使用します。

ステップ 3. お使いのハードウェアに合った OpenDisplay Toolbox プリセットを選択します：

デバイスToolbox プリセットディスプレイ
reTerminal E1001reterminal-e10017.5 インチ モノクロ、800 × 480
reTerminal E1002reterminal-e10027.3 インチ Spectra 6 色、800 × 480
reTerminal E1003reterminal-e100310.3 インチ モノクロ、1404 × 1872

ステップ 2: ファームウェアをインストールする​

OpenDisplay は reTerminal E シリーズ向けに、Toolbox プリセットを直接提供しています。

ステップ 1. Chrome または Edge で対応する Toolbox プリセットを開きます：

ステップ 2. 選択したプリセットが使用しているデバイスと一致していることを確認します。

ステップ 3. Install firmware (USB) をクリックします。

ステップ 4. ブラウザのペアリングダイアログで、reTerminal を接続したときに表示される USB シリアルデバイスを選択します。

ステップ 5. インストーラーが完了し、デバイスが再起動するまで待ちます。

インストール後、次のステップで BLE 設定を続行します。

ステップ 3: BLE 経由でデバイスを設定する​

ステップ 1. 同じ OpenDisplay Toolbox ページで、Configure over Bluetooth をクリックします。

ステップ 2. BLE ペアリングダイアログで reTerminal デバイスを選択します。

ステップ 3. Toolbox が選択したプリセットを書き込むまで待ちます。

ステップ 4. ディスプレイがリフレッシュするか、OpenDisplay の起動／テスト画像が表示されることを確認します。

これでデバイスは、OpenDisplay ツールまたは Home Assistant を通じて画像をアップロードする準備が整いました。

ステップ 4: 画像をアップロードする​

OpenDisplay デバイスは、ブラウザのディスプレイツールを通じて画像を受信できます。

ステップ 1. OpenDisplay display tool を開きます。

ステップ 2. Connect をクリックし、BLE ペアリングダイアログから reTerminal デバイスを選択します。

ステップ 3. Select Image をクリックし、ローカルの画像ファイルを選択します。

ステップ 4. Upload Image をクリックします。

転送が完了すると、ePaper ディスプレイがリフレッシュされ、アップロードした画像が表示されます。

ヒント

最もきれいな表示結果を得るには、使用しているパネルに合った画像サイズを使用してください：

  • reTerminal E1001: 800 × 480 px
  • reTerminal E1002: 800 × 480 px
  • reTerminal E1003: 1404 × 1872 px

Home Assistant との連携​

Home Assistant には、OpenDisplay ファームウェアデバイス向けの公式 OpenDisplay インテグレーションがあります。これは BLE 経由で通信し、ディスプレイに画像を送信するための opendisplay.upload_image アクションを提供します。

前提条件​

  • Home Assistant 2026.4 以降。
  • アクティブな BLE 接続をサポートする、動作中の Bluetooth セットアップ。
  • 電源が入っており、Bluetooth の範囲内にある OpenDisplay ファームウェアデバイス。

次の Bluetooth パスが利用できます：

  • Home Assistant Green、または対応する Bluetooth ハードウェアを備えたその他の Home Assistant ホスト。
  • ESPHome ファームウェア 2022.9.3 以降を実行している ESPHome Bluetooth Proxy。
備考

Shelly Bluetooth プロキシはパッシブ BLE センサーには便利ですが、OpenDisplay の画像アップロードにはアクティブな BLE 接続が必要です。このワークフローには、Home Assistant の Bluetooth アダプタまたは ESPHome Bluetooth Proxy を使用してください。

デバイスを追加する​

Step 1. Home Assistant で Settings > Devices & services に移動します。

Step 2. デバイスが自動検出された場合は、OpenDisplay カードの Add をクリックします。

Step 3. 自動検出されない場合は、Add Integration をクリックし、OpenDisplay を検索してセットアップフローに従います。

Step 4. デバイス名とエリアを割り当てます。

デバイスが追加されると、Home Assistant は Bluetooth 経由で OpenDisplay デバイスを検出して接続できるようになります。

Home Assistant から画像をアップロードする​

画像を Home Assistant のローカルメディアフォルダに保存し、その後 opendisplay.upload_image を呼び出します。

action: opendisplay.upload_image
data:
  device_id: "your_device_id"
  image:
    media_content_id: "media-source://media_source/local/photo.png"
    media_content_type: "image/png"

スケジュールされた更新には、オートメーション内で同じアクションを使用します。

triggers:
  - trigger: time
    at: "08:00:00"
actions:
  - action: opendisplay.upload_image
    data:
      device_id: "your_device_id"
      image:
        media_content_id: "media-source://media_source/local/daily.png"
        media_content_type: "image/png"
ヒント

Home Assistant のオートメーションを使用して、opendisplay.upload_image を呼び出す前に新しい PNG を生成またはコピーします。その後、OpenDisplay インテグレーションがディスプレイへの BLE 転送を処理します。

オプション：カスタム Draw ペイロード​

OpenDisplay コミュニティは、テキスト、アイコン、図形、QR コード、画像、プロット、プログレスバーを Home Assistant のペイロードから直接描画するための drawcustom ワークフローを備えた HACS インテグレーションも維持しています。

準備済み画像のアップロードではなく、特に draw コマンドレイアウトが必要な場合は、このパスを使用してください。

OpenDisplay HACS Integration

Home Assistant のビジュアルエディタでオートメーションを作成し、時間トリガーを追加してから、OpenDisplay の draw アクションを追加し、対象デバイスを選択します。

ESPHome Bluetooth Proxy の使用​

ESPHome Bluetooth Proxy は、ディスプレイが Home Assistant ホストから離れている場合に、Bluetooth のカバレッジを拡張し、信頼性を向上させます。

前提条件​

  • XIAO ESP32S3 などの ESP32 デバイス。
  • Home Assistant にインストールされた ESPHome。
  • 初回書き込み用の USB データケーブル。

手順付き設定​

Step 1. ESP32 デバイスを、書き込みに使用するコンピュータまたは Home Assistant ホストに接続します。

Step 2. 新しい ESPHome デバイスを作成し、以下の例と同様の Bluetooth Proxy 設定を使用します。

esphome:
  name: esps3-proxy
  friendly_name: ESP32S3 Bluetooth Proxy

esp32:
  board: esp32-s3-devkitc-1
  framework:
    type: esp-idf

logger:
  level: INFO

esp32_ble_tracker:
  scan_parameters:
    active: true

bluetooth_proxy:
  active: true

api:
  encryption:
    key: "YOUR_ENCRYPTION_KEY"

ota:
  - platform: esphome
    password: "YOUR_OTA_PASSWORD"

wifi:
  ssid: "YOUR_WIFI_SSID"
  password: "YOUR_WIFI_PASSWORD"

captive_portal:

Step 3. ESPHome で Install をクリックし、ESP32 デバイスにファームウェアを書き込みます。

Step 4. ESP32 が Wi-Fi に接続したら、Home Assistant で検出された Bluetooth Proxy を追加します。

Step 5. 画像アップロード中は、プロキシを OpenDisplay デバイスの近くに置いてください。

プロキシが動作していると、Home Assistant に Bluetooth Proxy が接続済みとして表示され、ePaper ディスプレイはそのプロキシ経由で検出できるようになります。

おまけ：3D プリントマウント​

7.3 インチ Spectra パネル付きの EN04 用に、このコミュニティモデルは IKEA RODALM 写真フレーム用のインサートを提供します：

リソース​

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

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

Loading Comments...