TRMNL を使う

このガイドは、互換性のある任意の Seeed ePaper 製品で TRMNL を使用するための唯一の信頼できる情報源です。各ステップで必要なときに一度だけハードウェアを選択すれば、残りのワークフローはすべて同じです。
TRMNL は公式に reTerminal E1001、reTerminal E1002、reTerminal E1003、TRMNL 7.5" (OG) DIY Kit、および XIAO 7.5" ePaper Panel をサポートしています。E1002 では現在、コンテンツは モノクロモード で描画されます — フルカラー描画は今後のリリースで提供される予定です。E1003 の静電容量式タッチパネルは SenseCraft HMI ファームウェアでのみ利用可能であり、TRMNL ファームウェアでは本体の物理ボタンを使用します。
TRMNL とは?
TRMNL は、ますます気が散りやすくなっているデジタル世界の中で、人々が集中力と落ち着きを保てるように設計された革新的なプラットフォームです。2023 年に設立されて以来、TRMNL は E Ink® ダッシュボード管理のリーディングソリューションとなり、従来の画面のような絶え間ない通知や気晴らしなしに情報を表示する、ユニークなアプローチを提供しています。
TRMNL の中核にあるのは、テクノロジーは常に注意を要求するのではなく、私たちの生活を向上させるべきだという哲学です。このプラットフォームは、E Ink® ディスプレイを通じて重要な情報を一目で確認できるエレガントな方法を提供し、よりマインドフルで侵入性の低いテクノロジー体験を実現します。
なぜ TRMNL を使うのか?
- ダッシュボード作成の簡素化:TRMNL の拡大し続けるアプリと連携機能のライブラリにより、複雑なプログラミングなしでカスタム情報ディスプレイを簡単に作成できます。
- 低消費電力:TRMNL の効率的なソフトウェアと E Ink® の最小限の電力要件を組み合わせることで、非常に省エネルギーなソリューションを実現します。
- 気が散らない情報表示:通知や目の疲れに悩まされることなく、必要な情報を取得できます。
- 定期的なアップデート:TRMNL は活発に開発されており、新機能や連携機能が毎週追加されています。
- 開発者フレンドリー:TRMNL のオープンな API と開発者ツールにより、カスタムプラグインや連携機能を実装できます。
対応ハードウェア
reTerminal E シリーズ
| reTerminal E1001 | reTerminal E1002 | reTerminal E1003 |
|---|---|---|
![]() | ![]() | ![]() |
| 7.5" モノクロ 一体型ターミナル | 7.3" Spectra 6(カラー) 一体型ターミナル TRMNL ではモノクロモード | 10.3" モノクロ 16 階調グレースケール 一体型ターミナル |
TRMNL DIY Kit と XIAO パネル
| TRMNL 7.5" (OG) DIY Kit | XIAO 7.5" ePaper Panel |
|---|---|
![]() | ![]() |
| 7.5" モノクロ + DIY ケース XIAO ESP32-S3 Plus ドライバ | 7.5" モノクロ裸パネル XIAO ESP32-C3 へ直接接続 |
ステップ 1: TRMNL アカウントのセットアップと BYOD アクセス
デバイスを TRMNL に接続する前に、TRMNL アカウントと BYOD(Bring Your Own Device)アクセスが必要です — ハードウェアに関係なくフローは同じです。
-
TRMNL アクセスを購入する
- TRMNL Web アプリとデバイス機能へのアクセスを次のサイトで購入します: https://shop.usetrmnl.com/products/byod
- これにより、TRMNL プラットフォームを利用するために必要な認証情報が提供されます。
- https://usetrmnl.com/claim-a-device にアクセスして仮想デバイスを有効化します(購入後、有効化まで最大 10 分かかる場合があります)。

-
TRMNL アカウントを作成する
- TRMNL の Web サイト にアクセスします
- 新しいアカウントを作成するために "Sign Up" をクリックします。
- 画面の指示に従って登録プロセスを完了します。

あなたの TRMNL 認証情報は機密情報です。決して公開したり、バージョン管理システムにコミットしたりしないでください。
問題が発生した場合は、[email protected] から TRMNL チームに直接連絡してください。
ステップ 2: ハードウェアのセットアップ
reTerminal E シリーズと XIAO 7.5" パネルはあらかじめ組み立て済みであり、電源を入れるだけで使用できます。TRMNL DIY Kit は組み立てが必要です。
- reTerminal E1001 / E1002 / E1003
- TRMNL DIY Kit
- XIAO 7.5" パネル
reTerminal E シリーズは完全に一体化されています。USB-C ケーブルを接続し、電源スイッチを ON にスライドして電源を入れるだけです。組み立て手順は不要です。
デバイスがスリープ状態で反応しない場合は、USB 接続やフラッシュモードに入る前に、本体上部の Refresh ボタンを押してウェイクアップしてください。
ステップ 1. ディスプレイをドライバボードに接続する
FPC ケーブルを XIAO ePaper Display Board 上のコネクタに合わせ、ラッチを固定して確実に接続されていることを確認します。
FPC ケーブルの金属面は上向きにする必要があります。向きが逆だとコンテンツは表示されません。多くの人がここで間違えるため、必ず以下の取り付け動画に従ってください。

ステップ 2. バッテリーを取り付ける
バッテリーケーブルをドライバボード上の JST コネクタに接続し、極性が正しいことを確認します(赤い線を +、黒い線を - に接続)。

ステップ 3. エンクロージャの組み立て(任意)
画面のフレキシブルケーブルは非常に繊細です。作業時は注意してください。損傷すると、画面全体が動作しなくなります。
Resources セクションからオープンソースのエンクロージャ部品を印刷し、その中に各コンポーネントを組み込みます。

まず、ドライバボードとバッテリーを組み立てます:
TRMNL キットをテストします:
ケースに画面を差し込み、FPC ケーブルを外側に引き出します:
FPC延長ケーブルを接続し、ケース全体を組み立てます:
L字型エンクロージャの組み立てもほぼ同様です:
TRMNLキットがルーターから離れている場合は、アンテナをケースの外に取り回すことで、より良い信号性能が得られます。
XIAO 7.5インチ ePaper パネルは、XIAO ESP32-C3がパネルに直接接続された状態で出荷されます。USB-Cで接続するだけで使用でき、追加の組み立ては不要です。
ステップ3:TRMNLファームウェアを書き込む
3つの書き込み方法が利用できます。**方法1(Web Flasher)**が最も簡単で、サポートされているすべてのハードウェアで動作します。**方法2(reTerminal E-Series Firmware Flasher)**はreTerminal E シリーズ専用です。**方法3(ソースからビルド)**は上級ユーザー向けです。
新品のTRMNL 7.5インチ(OG)DIYキットを購入した場合、すでにTRMNLファームウェアがプリインストールされています。その場合、この書き込みステップは完全にスキップしてステップ4に進むことができます。
方法1:TRMNL Web Flasher(推奨)
TRMNL Web Flasherはブラウザ上で直接動作し、このページにあるすべてのデバイスをサポートします。
- https://usetrmnl.com/flash にアクセスします。
- デバイスをUSB-Cで接続し、画面の指示に従います。
- 使用しているハードウェアに対応するファームウェアを選択します:
- reTerminal E1001 / E1002 / E1003
- TRMNL DIY Kit
- XIAO 7.5" パネル
- reTerminal E1001 / E1002:Seeedとの互換性のために FW 1.6.7以降 を使用してください。
- reTerminal E1003:ファームウェア一覧で reTerminal E1003 を選択し、FW 1.8.7以降 を使用してください。

TRMNL DIY Kitでは、Seeedとの互換性のために FW 1.5.12以降 を使用してください。

XIAO 7.5インチ ePaper パネルでは、Seeedとの互換性のために FW 1.5.12以降 を使用してください。

方法2:reTerminal E-Series Firmware Flasherで書き込む(reTerminal E シリーズのみ)
この方法が適用できるのは reTerminal E1001 / E1002 / E1003 のみです。reTerminal E-Series Firmware Flasherは、これら3つのreTerminal E シリーズデバイス向けのTRMNLファームウェアパッケージを提供します。
reTerminal E-Series Firmware Flasherは、reTerminal E シリーズデバイス向けにSeeedがホストするTRMNLファームウェアチャネルを提供します。ただし、このチャネルは公式のTRMNL Web Flasherほど頻繁には更新されず、すべての上流TRMNLファームウェアリリースがここに同期されるわけではありません。
より新しいTRMNLファームウェアリリースが必要な場合は、まず方法1:TRMNL Web Flasherを使用してください。SeeedホストのreTerminal E シリーズ向け書き込みフローが必要な場合に、この方法を使用します。
クリックしてreTerminal E-Series Firmware Flasherの手順を展開
-
reTerminal E-Series Firmware Flasher にアクセスします。
-
Select platform で、公式プラットフォームセクションから TRMNL カードを選択します。
-
デバイスを選択します:
- reTerminal E1001
- reTerminal E1002
- reTerminal E1003
-
2ページ目で、選択したデバイス向けに利用可能なTRMNLファームウェアバージョンを確認します。
-
デバイスをUSBデータケーブルでコンピュータに接続します。
-
Flash to device で、初回インストール時は Erase flash + flash を選択し、Connect & flash をクリックします。
-
ブラウザのプロンプトでデバイスのシリアルポートを選択し、書き込みプロセスを開始します。
初回インストール時は、デバイスをクリーンなファームウェア状態から起動させるために Erase flash + flash を選択してください。
電源スイッチがONになっていることを確認してください。デバイスがスリープ状態で書き込みが開始されない場合は、本体上部の Refresh ボタンを押してウェイクアップし、再試行してください。
reTerminal E1002はフルカラーのePaperスクリーンを使用していますが、TRMNLファームウェアは現在コンテンツをモノクロモードで描画します。Wi-Fiプロビジョニング中、E1002のAP画面には右下にTRMNLロゴがあるコンパクトなレイアウトが表示されます。この画面が表示されたら、E1002のホットスポットを検索して接続し、他のデバイスと同じWi-Fiセットアップフローを続行してください。
書き込みが完了したら、ステップ4:デバイスをWi-Fiに接続に進みます。
方法3:ソースからビルドして書き込む(上級者向け)
-
ファームウェアリポジトリをクローンする
-
公式ファームウェアリポジトリにアクセスし、クローンします:
git clone https://github.com/usetrmnl/trmnl-firmware.git
ヒント当社からTRMNL上流へのPRがレビュー中の場合があります。最新のSeeed側パッチが必要な場合は、代わりにSeeedミラーを使用してください:
git clone https://github.com/Seeed-Projects/Seeed_TRMNL_Eink_Project.git -
-
PlatformIO をVS Code拡張機能として、またはコマンドラインからインストールします。
-
プロジェクトを開く:クローンした
firmwareフォルダをVS Codeで開きます。 -
ハードウェアに合ったPlatformIO環境を選択します:
- reTerminal E1001 / E1002 / E1003
- TRMNL DIY Kit
- XIAO 7.5" パネル
platformio.iniで:- reTerminal E1001 の場合は、
seeed_reTerminal_E1001環境を選択します。 - reTerminal E1002 の場合は、
seeed_reTerminal_E1002環境を選択します(TRMNLはE1002上でコンテンツをモノクロで描画します)。 - reTerminal E1003 の場合は、公式TRMNLファームウェアリポジトリ内の
TRMNL_X_E1003環境を選択します。

platformio.iniで、TRMNL_7inch5_OG_DIY_Kit環境を選択します。
platformio.iniで、seeed_xiao_esp32c3環境を選択します。
-
デバイスをUSB-Cで接続します。
-
ビルドして書き込む:PlatformIOの Upload ボタンをクリックするか、次を実行します:
pio run --target upload
ステップ4:Wi-Fiを設定してデバイスをプロビジョニングする
Wi-Fiプロビジョニングのワークフローは、サポートされているすべてのハードウェアで同一です。
💡 Wi-Fi接続で問題がありますか? TRMNL Device Wi-Fi Troubleshooting Guide を参照してください。
電源を入れてプロビジョニングモードに入る
TRMNLファームウェアを書き込み、デバイスの電源を入れると、まだWi-Fiに接続されていない場合は自動的にプロビジョニングモードに入ります。
- reTerminal E1001 / E1002 / E1003
- TRMNL DIY Kit
- XIAO 7.5" パネル



TRMNLのWi-Fiに接続する
スマートフォンまたはコンピュータで、利用可能なWi-Fiネットワーク一覧を開きます。TRMNL という名前のネットワークを探して接続します(デフォルトではパスワード不要)。

キャプティブポータルを開く
接続後、Webブラウザを開きます。デバイスは自動的にTRMNLの設定ページへリダイレクトするはずです。そうならない場合は、手動で http://4.3.2.1 にアクセスしてください。
Wi-Fi認証情報を入力する
- 2.4 GHz Wi-Fiネットワーク を選択します(5 GHzネットワークはサポートされていません)。
- Wi-Fiパスワードを入力し、Save / Connect をクリックします。
⚠️ 重要: 必ず 2.4 GHz の Wi-Fi ネットワークを使用してください。これらのデバイス上の ESP32-C3 / ESP32-S3 チップは 5 GHz ネットワークをサポートしません。

デバイスがネットワークに参加する
デバイスは TRMNL Wi-Fi から切断され、自宅のネットワークに参加します。キャプティブポータルウィンドウにはデバイスの MAC アドレスが表示されます。MAC アドレスを必ず控えてください — 次のステップで必要になります。

⚠️ 注意: MAC アドレスはキャプティブポータル上に 1〜2 秒間しか表示されません。見逃してしまった場合は、次の方法でも確認できます:
- VS Code → PlatformIO のビルド/アップロードログから取得する。
- usetrmnl.com/flash の方法を使い、フラッシュ中にブラウザの開発者コンソールを確認する。
- ルーターまたはメッシュネットワークアプリの接続デバイス一覧から探す。
公式ガイドも参照してください: Finding your TRMNL MAC address。
ステップ 5: TRMNL 上でデバイスを登録する
デバイスが Wi-Fi に接続され、MAC アドレスが分かったら、TRMNL の Web インターフェースで登録します:
-
TRMNL Web インターフェース https://trmnl.app を開きます。
-
Devices ページ に移動します。
-
新しいデバイスを追加 します(右上またはページ中央のボタン)。

-
BYOD アクセスを購入したときに受け取った Device ID を入力します(これは MAC アドレスではありません — Device ID は購入確認メールまたは TRMNL ダッシュボードで確認できます)。Add new device をクリックします。

-
デバイス設定ページで デバイスの MAC アドレスを紐付け ます:

ここでカスタム名を設定したり、その他の設定を調整したりすることもできます。

これでデバイスは TRMNL アカウントにリンクされました!TRMNL インターフェースからプレイリスト、画像、その他のコンテンツを直接送信できるようになります。
💡 ヒント: 複数のデバイスがある場合は、それぞれ固有の Device ID を使って上記の手順を繰り返してください。
TRMNL Web インターフェースにデバイスを追加したら、デバイスの設定ページに移動し、Firmware Early Release と OTA Updates Enabled の両方をオフにします。
有効のままにしておくと、Seeed デバイスと互換性のない公式 TRMNL ハードウェア向けのファームウェアアップデートを自動的にダウンロードしてしまう可能性があります。互換性のないファームウェアをインストールすると、デバイスが誤動作したり、応答しなくなったりするおそれがあります。
安定した動作を確保するため、常に両方のオプションを無効のままにしておいてください。
ボタンの使い方
- reTerminal E1001 / E1002
- reTerminal E1003
- TRMNL DIY Kit
- XIAO 7.5" Panel
reTerminal E1001 と E1002 では、TRMNL ファームウェアの下でユーザーが操作できるボタンは 1 つだけです:
- Green Button — 5 秒間長押し: Wi-Fi 再設定モードに入ります。
- Reset ボタン: シングルクリックでデバイスを再起動します。
reTerminal E1003 では、TRMNL ファームウェアの下で上部に 3 つのボタンがあります:
- Refresh ボタン — シングルプレス: デバイスを起動するか、現在の画面を即座に更新します。
- Page Up + Page Down — 2 秒間長押し: Wi-Fi 再設定モードに入ります。
- 電源スイッチ: OFF にしてから ON にスライドしてデバイスを再起動します。
静電容量式タッチは SenseCraft HMI ファームウェアでのみサポートされています。TRMNL ファームウェアはタッチパネルを使用せず、すべての操作は上記の物理ボタンで行います。
XIAO ePaper Display Board には 4 つのボタン(RESET / KEY1 / KEY2 / KEY3)があります。TRMNL ファームウェアで使用されるのは RESET と KEY3 のみです。
KEY3 の使い方:
- シングルクリック: ページを即座に更新します。
- ダブルクリック: カスタム機能 — TRMNL の設定ページから構成します。
- 長押し(約 5 秒): ネットワークを再設定します。
RESET の使い方: シングルクリックでデバイスをリセットします。
XIAO ESP32-C3 には標準の RESET ボタンと BOOT ボタンがあります。
- Reset → 離す → BOOT を 5 秒間押し続ける: ネットワークを再設定します(TRMNL プロビジョニングポータルに戻ります)。
- RESET シングルクリック: デバイスを再起動します。
TRMNL プレイリストを理解する

TRMNL プレイリストは、ePaper デバイスに「何を」「いつ」表示するかを正確に制御します。
プレイリストの概要
- Playlist Title: TRMNL デバイスの名前。
- Display Time Range: プレイリストが有効な時間帯(例: 00:00–23:45)。
- Update Interval: ディスプレイを更新する頻度(例: 5 分ごと)。
- Add a Group / Add a Plugin: プレイリストをグループに整理したり、新しいコンテンツプラグインを追加したりします。
プレイリスト項目
各行は、デバイスに表示される画面またはウィジェットです。例:
- Weather — 現在地の天気情報。
- Days Left This Year — 今年残りの日数のカウントダウン。
- Custom Text — 任意のメッセージを表示(例: "Hello World")。
各項目について:
- Settings(歯車アイコン): プラグインのオプションを設定します。
- Delete(X アイコン): プレイリストから項目を削除します。
- Preview(目のアイコン): 画面がどのように表示されるかをプレビューします。
- Reorder(バーアイコン): ドラッグして順序を変更します。
スマートプレイリスト
一番下で、内容が変化していない画面を自動的にスキップするかどうかを選択できます。詳細は Smart Playlists のブログ記事を参照してください。
TRMNL プラグインを探索する

プラグインはモジュール式のコンテンツブロックで、天気、カレンダーイベント、株価、RSS フィード、モチベーションを高める名言、GitHub アクティビティなど、さまざまな情報を表示できます。
接続済みプラグイン
Plugins ページの上部には、すでに TRMNL アカウントに接続されているすべてのプラグインが表示されます。例として、Weather、Days Left This Year、Stock Price、RSS Feed、Reddit、Hacker News、Language Learning、Motivational Quote、Custom Text などがあります。
プラグインマーケットプレイス
接続済みプラグインの下にはマーケットプレイスがあります。プラグインはカテゴリやタグ(#productivity、#news、#ecommerce など)ごとに整理されています。ブラウズや検索を行い、任意のプラグインをクリックしてアカウントに接続します。
開発者は独自のプラグインを作成して公開することもできます。詳細は plugin marketplace docs を参照してください。
より高度な機能については、公式 TRMNL ドキュメントを参照してください: https://docs.usetrmnl.com/go。
FAQ
Q1: ネットワークを再設定するにはどうすればよいですか?
- reTerminal E1001 / E1002
- reTerminal E1003
- TRMNL DIY Kit
- XIAO 7.5" Panel
Green Button を 5 秒間押し続けます。デバイスは初期の TRMNL インターフェースに戻り、AP を有効にします。
Page Up と Page Down を同時に 2 秒間押し続けます。デバイスは初期の TRMNL インターフェースに戻り、AP を有効にします。
画面がスリープしている場合は、まず Refresh ボタンを 1 回押してデバイスを起動してください。
KEY3(Reset ボタンの隣)を 5 秒間押し続けます。デバイスは初期の TRMNL インターフェースに戻り、AP を有効にします。
XIAO 上の Reset ボタンを押して離し、その後 BOOT ボタンを 5 秒間押し続けます。デバイスは初期の TRMNL インターフェースに戻り、AP を有効にします。
Q2: 画面に常にバッテリー残量低下の警告が表示される場合はどうすればよいですか?
この画面は 2 つの異なる状況で表示される可能性があります:
-
実際にバッテリー電圧が低い場合。 これが最も一般的なケースで、デバイスが本当に充電を必要としている状態です。電源に接続するか、バッテリーを交換/充電すると、電圧が回復した時点で警告は消えるはずです。
-
TRMNL のサーバー側の問題。 バッテリー残量はデバイスだけでなく TRMNL のサーバー側でも評価されます。サーバーのバグや最近のプラットフォームアップデートにより、ハードウェアに問題がなくてもバッテリーステータスが誤って報告され、警告が表示され続ける場合があります。
バッテリーが本当に低下している場合 は、まずデバイスを充電してください — バッテリーパックが健全であることを確認するまでは警告を非表示にしないでください。
バッテリーに問題がないと確信しているのに 警告が消えない場合でも、ファームウェアを変更する必要はありません。TRMNL では、Web ダッシュボードから画面上のプロンプトを抑制できます:
ステップ 1. TRMNL Web インターフェース を開き、Devices に移動します。
ステップ 2. 該当するデバイスを選択し、その Battery 設定を開きます。
ステップ 3. Hide Low Battery Screen をオンにします。これにより、TRMNL のサーバー側のバッテリー検出が回復するまで、またはプレイリスト画面を維持したい場合に、デバイス上にバッテリー残量低下の警告画面が表示されなくなります。
ステップ 4. (任意)ディスプレイを中断することなくメールアラートを受け取りたい場合は、Low Battery Email Notification を有効のままにしておきます。

Q3: Web Flasher / PlatformIO がデバイスを検出できない、またはアップロードに失敗する
誤ったプログラムが原因で、XIAO のポートが認識されなくなったり、正しく動作しなくなることがあります:
- XIAO は接続されているが、ポート番号 が見つからない。
- XIAO は接続されておりポートも表示されるが、アップロードに失敗する。
XIAO を BootLoader モードにして復旧します:
- ステップ 1:XIAO ESP32-S3 / ESP32-C3 上の
BOOTボタンを離さずに押し続けます。 - ステップ 2:
BOOTを押したまま、USB-C でデバイスをコンピュータに接続します。接続が完了したらBOOTを離します。 - ステップ 3:アップロード / フラッシュを再実行します。ほとんどの「デバイスが認識されない」または「アップロードに失敗した」という問題は、これで解決します。
特別な謝辞
この統合全体にわたり、多大な支援と貴重な助力をいただいた TRMNL チーム全員 に心より感謝いたします。特に、開発およびドキュメント作成の期間を通じて献身的に取り組んでくださった Bogdan、Ryan Kulp、Fr3d、Schappi、および他のすべてのチームメンバーの皆様に感謝いたします。
彼らの専門知識により、この統合が実現し、reTerminal E シリーズ(E1001、E1002、E1003)、TRMNL DIY Kit、そして XIAO 7.5" ePaper Panel コミュニティの体験が大きく向上しました。
リソース
- reTerminal E1001 / E1002 / E1003
- TRMNL DIY Kit
- XIAO 7.5" Panel
- [GitHub] Seeed_TRMNL_Eink_Project
- [GitHub] Official TRMNL firmware
- [Wiki] Getting Started with reTerminal E1003
- [Firmware] TRMNL ePaper Library (GitHub)
- [Hardware] Driver Board SCH
- [Printable] Triangular base
- [Printable] Protected triangular base
- [Printable] L-shaped base
- [Thingiverse] Triangular base
- [Thingiverse] Protected triangular base
- [Thingiverse] L-shaped base
- [Makerworld] Triangular base
- [Makerworld] Protected triangular base
- [Makerworld] L-shaped base
- [STP] 3D Model enclosure
- [PDF] ePaper Driver Board SCH PDF
- [GitHub] TRMNL firmware repository
- [GitHub] Seeed_TRMNL_Eink_Project repository
技術サポート & 製品ディスカッション
弊社製品をお選びいただきありがとうございます。私たちは、製品をできるだけスムーズにご利用いただけるよう、さまざまなサポートを提供しています。お好みやニーズに応じてお選びいただける、複数のコミュニケーションチャネルをご用意しています。



