Skip to main content

TRMNL 7.5inch(OG) DIY KitとTRMNLの連携


TRMNLとは?

TRMNLは、ますます注意散漫になるデジタル世界において、人々が集中力を保ち、落ち着いた状態を維持できるよう支援するために設計された革新的なプラットフォームです。2023年に設立されたTRMNLは、E Ink®ダッシュボード管理の主要なソリューションとして急速に成長し、従来のスクリーンの絶え間ない通知や気を散らす要素なしに情報を表示するユニークなアプローチを提供しています。

TRMNLの核心は、テクノロジーは絶え間ない注意を要求することなく私たちの生活を向上させるべきだという哲学に基づいています。このプラットフォームは、E Ink®ディスプレイを通じて重要な情報を一目で確認できるエレガントな方法を提供し、より思慮深く、侵入的でないテクノロジー体験を創造します。

なぜTRMNLを使用するのか?

TRMNLの統合により、いくつかの魅力的な利点がもたらされます:

  • 簡素化されたダッシュボード作成: TRMNLの成長するアプリとインテグレーションライブラリにより、複雑なプログラミングなしでカスタム情報ディスプレイを簡単に作成できます
  • 低消費電力: TRMNLの効率的なソフトウェアと当社のE Ink®ディスプレイの最小限の電力要件の組み合わせにより、極めてエネルギー効率の高いソリューションを実現します
  • 気を散らさない情報表示: 従来のスクリーンに関連する絶え間ない通知や眼精疲労なしに、必要な情報を取得できます
  • 定期的なアップデート: TRMNLの活発な開発により、新機能とインテグレーションが毎週追加され、ディスプレイの可能性を継続的に拡張します
  • 開発者フレンドリー: TRMNLのオープンAPIと開発者ツールにより、特定のニーズに合わせたカスタムプラグインとインテグレーションを作成できます

TRMNLの強力なプラットフォームと当社の高品質E Ink®ディスプレイを組み合わせることで、ユーザーの注意と時間の両方を尊重する、パーソナライズされた低消費電力情報ダッシュボードを作成するためのエレガントなソリューションを提供しています。

TRMNLの開始方法

機器の設置

ステップ1. ディスプレイをドライバーボードに接続
FPCケーブルをXIAO ePaper Display Boardのコネクタに合わせ、ラッチを固定して確実な接続を確保します。

tip

FPCケーブルの金属面は上向きにする必要があります。そうでないと、コンテンツが表示されません。

以下の設置チュートリアルに従ってください。多くの人が間違えます。

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

ステップ3. エンクロージャーの組み立て(オプション)

tip

スクリーンのフレキシブルケーブルは非常に壊れやすいことにご注意ください。操作時は注意してください。損傷すると、スクリーン全体が動作しなくなります。

Resource partからオープンソースのエンクロージャー部品を印刷し、内部にコンポーネントを組み立てます。

まず、ドライバーボードとバッテリーを組み立てます。

TRMNLキットが正常に動作するかテストします。

スクリーンをケースに差し込み、FPCを外に出します。

FPC延長ケーブルを接続し、ケース全体を組み立てます。

L字型エンクロージャーも非常に似ています。

tip

TRMNLキットがルーターから遠い場合は、アンテナをケースの外に移動できます。より良いパフォーマンスが得られます。

TRMNLアカウントの設定とTRMNLアクセス

キットをTRMNLに接続する前に、以下を行う必要があります:

  1. TRMNLアクセスの購入

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

    • TRMNLのウェブサイトにアクセス
    • "Sign Up"をクリックして新しいアカウントを作成
    • 登録プロセスに従います
note

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

材料を準備し、TRMNLアクセスを購入したら、デバイスをTRMNLのプラットフォームに接続する手順に進むことができます。問題が発生したり質問がある場合は、[email protected]でTRMNLチームに直接連絡できます。

ファームウェアの書き込み

tip

新品のキットを入手した場合、内部にファームウェアが入っています。そのため、このステップをスキップできます。

TRMNL 7.5inch(OG) DIYキットをTRMNLと連携させるには、デバイスに適切なファームウェアを書き込む必要があります。推奨される方法は3つあります:

方法1: TRMNL Web Flasherで書き込み(最も簡単)

tip

Seeed互換性のため、FW 1.5.12以降のファームウェアを使用してください。

  1. TRMNL Web Flasherにアクセス

    • https://usetrmnl.com/flashにアクセス
    • このツールを使用すると、ブラウザから直接デバイスに書き込みができます。
    • 画面の指示に従って書き込みプロセスを完了します。

方法2: ソースからビルドして書き込み(上級ユーザー/開発者向け)

  1. ファームウェアリポジトリのクローン
tip

コードを更新してTRMNLにPRを提出し、表示される前にレビューが必要な場合があります。最新のファームウェアバージョンを最初に使用したい場合は、Seeed ProjectのTRMNLリポジトリも使用できます。

  • Seedリポジトリにアクセスしてクローンします:

    git clone https://github.com/Seeed-Projects/Seeed_TRMNL_Eink_Project.git
  1. PlatformIOのインストール

    • PlatformIOをVSCode拡張機能として、またはコマンドライン経由でインストールします。
  2. プロジェクトを開く

    • クローンしたfirmwareフォルダをVSCodeで開きます。
  3. 正しい環境を選択

    • platformio.iniで、TRMNL_7inch5_OG_DIY_Kit環境を選択します。
  1. デバイスの接続

    • TRMNL 7.5inch(OG) DIYキットを接続します。
  2. ビルドとアップロード

    • PlatformIOで"Upload"ボタンをクリックするか、以下を実行します:

      pio run --target upload
    • ファームウェアがコンパイルされ、デバイスにアップロードされます。

Wi-Fiの設定とTRMNLへのプレイリスト送信

TRMNL 7.5inch(OG) DIYキットをTRMNLで使用してプレイリストを送信するには、まずデバイスをWi-Fiネットワークに接続する必要があります。このプロセスは「WiFiペアリングモード」と呼ばれ、シンプルなキャプティブポータルを通じて行われます。以下の手順に従ってください:

💡 Wi-Fiのトラブルシューティング? デバイスをWi-Fiに接続する際に問題が発生した場合は、一般的なネットワークとルーター互換性の問題の解決策についてTRMNL Device Wi-Fi Troubleshooting Guideを参照してください。

電源投入とプロビジョニングモードの開始

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

TRMNL Wi-Fi に接続する

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

キャプティブポータルを開く

  • 接続したら、ウェブブラウザ(Chrome や Edge など)を開きます。
  • デバイスは自動的に TRMNL 設定ページにリダイレクトするはずです。リダイレクトされない場合は、ブラウザで手動で http://4.3.2.1 にアクセスしてください。

Wi-Fi 認証情報を入力する

  • 設定ページで、利用可能な Wi-Fi ネットワークのリストが表示されます。
  • 2.4GHz Wi-Fi ネットワークを選択してください(TRMNL は 5GHz ネットワークをサポートしていません)。
  • Wi-Fi パスワードを入力します。
  • Save または Connect をクリックします。

⚠️ 重要: 2.4GHz Wi-Fi ネットワークを使用してください。5GHz ネットワークは ESP32-C3 チップでサポートされていません。

デバイスがネットワークに接続する

  • デバイスは Wi-Fi への接続を試行します。
  • 成功すると、TRMNL Wi-Fi から切断され、ホームネットワークに参加します。
  • ウィンドウと e-ink スクリーンにデバイスの MAC アドレスが表示されます。MAC アドレスを記録してください。後のステップで必要になります。

⚠️ 注意: MAC アドレスはキャプティブポータルで 1-2 秒間のみ表示されます。見逃した場合は、以下の方法でも確認できます:

  • VS Code > PlatformIO のビルド/アップロードログから取得する。
  • usetrmnl.com/flash 方法を使用し、フラッシュ中に Chrome/Edge/Firefox の開発者コンソールで MAC アドレスを確認する。
  • ルーターまたは Mesh ネットワークアプリの接続デバイスリストで見つける。

詳細とスクリーンショットについては、公式ガイドを参照してください:Finding your TRMNL MAC address

TRMNL ウェブインターフェースにアクセスする

TRMNL 7.5inch(OG) DIY キットが Wi-Fi に接続され、MAC アドレス(Device ID)を記録したら、TRMNL アカウントに追加できます:

  1. TRMNL ウェブインターフェースを開く

  2. Devices ページに移動する

    • TRMNL インターフェースで、Devices セクションに移動します。
  3. 新しいデバイスを追加する

    • Add new device ボタンをクリックします。通常、Devices ページの右上角または中央にあります。
  4. Device ID を入力する

    • ポップアップウィンドウで、TRMNL アクセスを購入した際に受け取った Device ID を入力します(これは MAC アドレスではありません)。購入確認メールまたは TRMNL ダッシュボードの Device ID を使用してください。
    • Add new device をクリックしてプロセスを完了します。
  5. XIAO 7.5" デバイス MAC アドレスを登録する

    XIAO epaper パネルと TRMNL の間の接続を構築するために、TRMNL 設定ページ内で正しいデバイス MAC アドレスをバインドする必要があります。

    • PlatformIO アップロードプロセス中に MAC アドレスを取得できます(アップロードログを確認)、またはプロビジョニングポータルから取得できます(Wi-Fi セットアップ後に表示されます)。

    • MAC アドレスを早期に追加することで、スムーズなオンボーディングプロセスとデバイス管理が確保されます。

    • その後、ePaper パネルにカスタム名を設定し、必要に応じて他の設定を調整できます。

TRMNL 7.5inch(OG) DIY キットが TRMNL アカウントにリンクされました!TRMNL インターフェースから直接、プレイリスト、画像、その他のコンテンツをディスプレイに送信できるようになりました。

💡 ヒント: 複数の ePaper パネルがある場合は、それぞれの固有の Device ID を使用して上記の手順を繰り返してください。

caution

TRMNL ウェブインターフェースでデバイスを追加した後、デバイスの設定ページに移動し、Firmware Early ReleaseOTA Updates Enabled の両方をオフにしてください。

これらのオプションが有効のままになっていると、デバイスがインターネットに接続された際に TRMNL からファームウェアアップデートを自動的にダウンロードしてインストールする可能性があります。これらのアップデートは公式 TRMNL ハードウェア用であり、TRMNL 7.5inch(OG) DIY キットとは互換性がありません。互換性のないファームウェアをインストールすると、デバイスが誤動作したり応答しなくなったりする可能性があります。

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

ボタンの使用方法

この開発ボードには 4 つのボタンがあります。RESET、KEY1、KEY2、KEY3 で、TRMNL ファームウェアでは RESET と KEY1 ボタンのみを使用します。

KEY1 の使用方法:

  1. 1 回クリック: ページを即座に更新します。
  2. ダブルクリック: カスタム機能、設定ページで確認できます。
  3. 長押し: 約 5 秒間、ネットワークを再設定します。

RESET の使用方法: 1 回クリックのみでデバイスをリセットします。

TRMNL プレイリスト機能の理解

TRMNL プレイリスト機能により、ePaper パネルに何を表示するか、いつ表示するかを正確に制御できます。上のスクリーンショットに示されているように、主要なセクションとコントロールの内訳は以下の通りです:

プレイリスト概要

  • プレイリストタイトル:上部に TRMNL デバイスの名前が表示されます(例:「MengDu's TRMNL」)。
  • 表示時間範囲:プレイリストがアクティブな時間範囲を設定できます(例:00:00 から 23:45 まで)。
  • 更新間隔:ディスプレイの更新頻度を選択します(例:5 分ごと)。
  • Add a Group / Add a Plugin:これらのボタンを使用してプレイリストをグループに整理したり、新しいコンテンツプラグイン(天気、カレンダー、カスタムテキストなど)を追加したりします。

プレイリストアイテム

プレイリストの各行は、ePaper パネルに表示されるスクリーンまたはウィジェットを表します(参考のみ):

  1. Weather
    • 選択した場所の現在の天気情報を表示します。
    • 緑色の「Displayed now」ラベルは、このスクリーンが現在デバイスに表示されていることを示します。
  2. Days Left This Year
    • 現在の年の残り日数のカウントダウンを表示します(例:「2025」)。
    • ラベル(例:「9 days ago」)は、このスクリーンが最後に更新または表示された時期を示します。
  3. Custom Text
    • 任意のカスタムメッセージを表示できます(例:「Hello World」)。
    • 最後に更新された時期も表示されます。

各アイテムには、いくつかのコントロールがあります:

  • Settings(歯車アイコン):プラグインのオプションを設定します。
  • Delete(X アイコン):プレイリストからアイテムを削除します。
  • Preview(目のアイコン):スクリーンがどのように見えるかをプレビューします。
  • Reorder(バーアイコン):ドラッグしてスクリーンが表示される順序を変更します。

スマートプレイリスト

  • スマートプレイリストオプション:下部で、コンテンツが変更されていないスクリーンを自動的にスキップするかどうかを選択できます(例:「Never skip screens」)。

📖 詳しく知りたいですか?高度なヒントと詳細については、Smart Playlists blog post をお読みください。

この柔軟なプレイリストシステムにより、ePaper パネルに表示する内容、更新頻度、表示順序を完全にカスタマイズできます。さまざまなプラグインを組み合わせて、ニーズに合ったパーソナライズされたダッシュボードを作成できます。

TRMNL プラグインの探索

TRMNL のプラグインシステムは、ePaper パネルを真に強力でカスタマイズ可能にするものです。プラグインは、さまざまな情報やコンテンツを表示するためにデバイスに追加できるモジュラーアプリまたはウィジェットです。

プラグインとは?

プラグインは、天気、カレンダーイベント、株価、RSS フィード、励ましの言葉、GitHub アクティビティなどを表示できる個別のコンテンツブロックです。プラグインを組み合わせて、ニーズに合ったダッシュボードを作成できます。

接続済みプラグイン

プラグインページの上部には、すでに TRMNL アカウントに接続されているすべてのプラグインが表示されます。これらはプレイリストに追加して ePaper パネルに表示する準備ができています。例:

  • Weather:現在の天気状況を表示します。
  • Days Left This Year:年末までのカウントダウン。
  • Stock Price:お気に入りの株式を追跡します。
  • RSS Feed:ニュースやブログの更新を表示します。
  • Reddit、Hacker News:トレンドの投稿を表示します。
  • Language Learning、Motivational Quote、Custom Text:学習ツールやカスタムメッセージでディスプレイをパーソナライズします。

プラグインマーケットプレイス

接続済みプラグインの下に、プラグインマーケットプレイスがあります。ここで、デバイスに追加する新しいプラグインを閲覧、検索、発見できます。プラグインはカテゴリとタグ(#productivity、#news、#ecommerce など)で整理されており、必要なものを簡単に見つけることができます。

  • 閲覧と検索:検索バーやタグを使用して、興味のあるプラグインを素早く見つけます。
  • プラグインの追加:任意のプラグインをクリックしてアカウントに接続し、プレイリストで使用を開始します。

開発者は他の人が使用できる独自のプラグインを作成して公開することもでき、エコシステムは新しい可能性で継続的に拡張されています(プラグイン作成について詳しく学ぶ)。


TRMNLの使用について質問がある場合や、より高度な機能を探求したい場合は、公式TRMNLドキュメントをお読みください:https://docs.usetrmnl.com/go

トラブルシューティング

Q1: WebやPlatformIOを使用する際に、ファームウェアをフラッシュできない問題が発生しました。どうすればよいですか?

時々、間違ったプログラムを使用すると、XIAOがポートを失ったり、正常に機能しなくなったりすることがあります。一般的な問題には以下があります:

  • XIAO がコンピュータに接続されているが、ポート番号が見つからない
  • XIAO が接続され、ポート番号が表示されるが、プログラムのアップロードが失敗する

上記の2つの状況に遭遇した場合、XIAOをBootLoaderモードにすることで、デバイスが認識されない問題やアップロード失敗の問題の大部分を解決できます。具体的な方法は以下の通りです:

  • ステップ 1. XIAO ESP32S3 の BOOT ボタンを離さずに押し続けます。
  • ステップ 2. BOOT ボタンを押したまま、データケーブルでコンピュータに接続します。コンピュータに接続した後、BOOT ボタンを離します。
  • ステップ 3. プログラムをアップロードするか、ファームウェアをフラッシュして XIAO ESP32S3 の動作を確認します。

特別な謝辞

このプロジェクトに対する強力なサポートと貴重な支援をいただいたTRMNLチーム全体に特別な感謝を申し上げます。特に、開発とドキュメント作成プロセス全体を通じて献身的な支援をいただいたBogdanRyan KulpFr3d、そして他のすべてのチームメンバーに感謝いたします。

皆様の専門知識と献身により、この統合が可能になり、TRMNL 7.5inch(OG) DIYキットコミュニティのユーザーエクスペリエンスが大幅に向上しました。

トラブルシューティング

ネットワークを再設定するには?

Key3(Resetボタンの隣のボタン)を5秒間押し続けます。デバイスは初期のTRMNLインターフェースに戻り、APをアクティブにします。

リソース

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

弊社製品をお選びいただき、ありがとうございます!弊社製品での体験が可能な限りスムーズになるよう、さまざまなサポートを提供いたします。さまざまな好みやニーズに対応するため、複数のコミュニケーションチャネルを提供しています。

Loading Comments...