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

TRMNL を使う

このガイドは、互換性のある任意の Seeed ePaper 製品で TRMNL を使用するための唯一の信頼できる情報源です。各ステップで必要なときに一度だけハードウェアを選択すれば、残りのワークフローはすべて同じです。

ハードウェアサポート

TRMNL は公式に reTerminal E1001reTerminal E1002reTerminal E1003TRMNL 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 E1001reTerminal E1002reTerminal E1003
7.5" モノクロ
一体型ターミナル
7.3" Spectra 6(カラー)
一体型ターミナル
TRMNL ではモノクロモード
10.3" モノクロ
16 階調グレースケール
一体型ターミナル

TRMNL DIY Kit と XIAO パネル

TRMNL 7.5" (OG) DIY KitXIAO 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)アクセスが必要です — ハードウェアに関係なくフローは同じです。

  1. TRMNL アクセスを購入する

    • TRMNL Web アプリとデバイス機能へのアクセスを次のサイトで購入します: https://shop.usetrmnl.com/products/byod
    • これにより、TRMNL プラットフォームを利用するために必要な認証情報が提供されます。
    • https://usetrmnl.com/claim-a-device にアクセスして仮想デバイスを有効化します(購入後、有効化まで最大 10 分かかる場合があります)。
  2. TRMNL アカウントを作成する

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

あなたの TRMNL 認証情報は機密情報です。決して公開したり、バージョン管理システムにコミットしたりしないでください。

問題が発生した場合は、[email protected] から TRMNL チームに直接連絡してください。

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

reTerminal E シリーズと XIAO 7.5" パネルはあらかじめ組み立て済みであり、電源を入れるだけで使用できます。TRMNL DIY Kit は組み立てが必要です。

reTerminal E シリーズは完全に一体化されています。USB-C ケーブルを接続し、電源スイッチを ON にスライドして電源を入れるだけです。組み立て手順は不要です。

reTerminal E1003 のみ

デバイスがスリープ状態で反応しない場合は、USB 接続やフラッシュモードに入る前に、本体上部の Refresh ボタンを押してウェイクアップしてください。

ステップ3:TRMNLファームウェアを書き込む

3つの書き込み方法が利用できます。**方法1(Web Flasher)**が最も簡単で、サポートされているすべてのハードウェアで動作します。**方法2(reTerminal E-Series Firmware Flasher)**はreTerminal E シリーズ専用です。**方法3(ソースからビルド)**は上級ユーザー向けです。

新品のTRMNL DIYキットにはすでにTRMNLファームウェアが書き込まれています

新品のTRMNL 7.5インチ(OG)DIYキットを購入した場合、すでにTRMNLファームウェアがプリインストールされています。その場合、この書き込みステップは完全にスキップしてステップ4に進むことができます。

方法1:TRMNL Web Flasher(推奨)

TRMNL Web Flasherはブラウザ上で直接動作し、このページにあるすべてのデバイスをサポートします。

  1. https://usetrmnl.com/flash にアクセスします。
  2. デバイスをUSB-Cで接続し、画面の指示に従います。
  3. 使用しているハードウェアに対応するファームウェアを選択します:
  • reTerminal E1001 / E1002:Seeedとの互換性のために FW 1.6.7以降 を使用してください。
  • reTerminal E1003:ファームウェア一覧で reTerminal E1003 を選択し、FW 1.8.7以降 を使用してください。

方法2:reTerminal E-Series Firmware Flasherで書き込む(reTerminal E シリーズのみ)

備考

この方法が適用できるのは reTerminal E1001 / E1002 / E1003 のみです。reTerminal E-Series Firmware Flasherは、これら3つのreTerminal E シリーズデバイス向けのTRMNLファームウェアパッケージを提供します。

新しいTRMNLファームウェアには方法1を優先してください

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の手順を展開
  1. reTerminal E-Series Firmware Flasher にアクセスします。

  2. Select platform で、公式プラットフォームセクションから TRMNL カードを選択します。

  3. デバイスを選択します:

    • reTerminal E1001
    • reTerminal E1002
    • reTerminal E1003
  4. 2ページ目で、選択したデバイス向けに利用可能なTRMNLファームウェアバージョンを確認します。

  5. デバイスをUSBデータケーブルでコンピュータに接続します。

  6. Flash to device で、初回インストール時は Erase flash + flash を選択し、Connect & flash をクリックします。

  7. ブラウザのプロンプトでデバイスのシリアルポートを選択し、書き込みプロセスを開始します。

初回の書き込み

初回インストール時は、デバイスをクリーンなファームウェア状態から起動させるために Erase flash + flash を選択してください。

reTerminal E1003のみ

電源スイッチがONになっていることを確認してください。デバイスがスリープ状態で書き込みが開始されない場合は、本体上部の Refresh ボタンを押してウェイクアップし、再試行してください。

reTerminal E1002のディスプレイ動作

reTerminal E1002はフルカラーのePaperスクリーンを使用していますが、TRMNLファームウェアは現在コンテンツをモノクロモードで描画します。Wi-Fiプロビジョニング中、E1002のAP画面には右下にTRMNLロゴがあるコンパクトなレイアウトが表示されます。この画面が表示されたら、E1002のホットスポットを検索して接続し、他のデバイスと同じWi-Fiセットアップフローを続行してください。

書き込みが完了したら、ステップ4:デバイスをWi-Fiに接続に進みます。

方法3:ソースからビルドして書き込む(上級者向け)

  1. ファームウェアリポジトリをクローンする

    ヒント

    当社からTRMNL上流へのPRがレビュー中の場合があります。最新のSeeed側パッチが必要な場合は、代わりにSeeedミラーを使用してください:

    git clone https://github.com/Seeed-Projects/Seeed_TRMNL_Eink_Project.git
  2. PlatformIO をVS Code拡張機能として、またはコマンドラインからインストールします。

  3. プロジェクトを開く:クローンした firmware フォルダをVS Codeで開きます。

  4. ハードウェアに合ったPlatformIO環境を選択します

    platformio.ini で:

    • reTerminal E1001 の場合は、seeed_reTerminal_E1001 環境を選択します。
    • reTerminal E1002 の場合は、seeed_reTerminal_E1002 環境を選択します(TRMNLはE1002上でコンテンツをモノクロで描画します)。
    • reTerminal E1003 の場合は、公式TRMNLファームウェアリポジトリ内の TRMNL_X_E1003 環境を選択します。
  5. デバイスをUSB-Cで接続します

  6. ビルドして書き込む:PlatformIOの Upload ボタンをクリックするか、次を実行します:

    pio run --target upload

ステップ4:Wi-Fiを設定してデバイスをプロビジョニングする

Wi-Fiプロビジョニングのワークフローは、サポートされているすべてのハードウェアで同一です。

💡 Wi-Fi接続で問題がありますか? TRMNL Device Wi-Fi Troubleshooting Guide を参照してください。

電源を入れてプロビジョニングモードに入る

TRMNLファームウェアを書き込み、デバイスの電源を入れると、まだWi-Fiに接続されていない場合は自動的にプロビジョニングモードに入ります。

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 インターフェースで登録します:

  1. TRMNL Web インターフェース https://trmnl.app を開きます。

  2. Devices ページ に移動します。

  3. 新しいデバイスを追加 します(右上またはページ中央のボタン)。

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

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

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

これでデバイスは TRMNL アカウントにリンクされました!TRMNL インターフェースからプレイリスト、画像、その他のコンテンツを直接送信できるようになります。

💡 ヒント: 複数のデバイスがある場合は、それぞれ固有の Device ID を使って上記の手順を繰り返してください。

ファームウェア早期リリースと OTA アップデートを無効化する

TRMNL Web インターフェースにデバイスを追加したら、デバイスの設定ページに移動し、Firmware Early ReleaseOTA Updates Enabled の両方をオフにします。

有効のままにしておくと、Seeed デバイスと互換性のない公式 TRMNL ハードウェア向けのファームウェアアップデートを自動的にダウンロードしてしまう可能性があります。互換性のないファームウェアをインストールすると、デバイスが誤動作したり、応答しなくなったりするおそれがあります。

安定した動作を確保するため、常に両方のオプションを無効のままにしておいてください。

ボタンの使い方

reTerminal E1001 と E1002 では、TRMNL ファームウェアの下でユーザーが操作できるボタンは 1 つだけです:

  • Green Button — 5 秒間長押し: Wi-Fi 再設定モードに入ります。
  • Reset ボタン: シングルクリックでデバイスを再起動します。

TRMNL プレイリストを理解する

TRMNL プレイリストは、ePaper デバイスに「何を」「いつ」表示するかを正確に制御します。

プレイリストの概要

  • Playlist Title: TRMNL デバイスの名前。
  • Display Time Range: プレイリストが有効な時間帯(例: 00:00–23:45)。
  • Update Interval: ディスプレイを更新する頻度(例: 5 分ごと)。
  • Add a Group / Add a Plugin: プレイリストをグループに整理したり、新しいコンテンツプラグインを追加したりします。

プレイリスト項目

各行は、デバイスに表示される画面またはウィジェットです。例:

  1. Weather — 現在地の天気情報。
  2. Days Left This Year — 今年残りの日数のカウントダウン。
  3. 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: ネットワークを再設定するにはどうすればよいですか?

Green Button を 5 秒間押し続けます。デバイスは初期の TRMNL インターフェースに戻り、AP を有効にします。

Q2: 画面に常にバッテリー残量低下の警告が表示される場合はどうすればよいですか?

この画面は 2 つの異なる状況で表示される可能性があります:

  1. 実際にバッテリー電圧が低い場合。 これが最も一般的なケースで、デバイスが本当に充電を必要としている状態です。電源に接続するか、バッテリーを交換/充電すると、電圧が回復した時点で警告は消えるはずです。

  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 ボタンを離さずに押し続けます。
  • ステップ 2BOOT を押したまま、USB-C でデバイスをコンピュータに接続します。接続が完了したら BOOT を離します。
  • ステップ 3:アップロード / フラッシュを再実行します。ほとんどの「デバイスが認識されない」または「アップロードに失敗した」という問題は、これで解決します。

特別な謝辞

この統合全体にわたり、多大な支援と貴重な助力をいただいた TRMNL チーム全員 に心より感謝いたします。特に、開発およびドキュメント作成の期間を通じて献身的に取り組んでくださった BogdanRyan KulpFr3dSchappi、および他のすべてのチームメンバーの皆様に感謝いたします。

彼らの専門知識により、この統合が実現し、reTerminal E シリーズ(E1001、E1002、E1003)、TRMNL DIY Kit、そして XIAO 7.5" ePaper Panel コミュニティの体験が大きく向上しました。

リソース

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

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

Loading Comments...