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の開始方法

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. プロジェクトを開く

    • VSCodeでクローンしたfirmwareフォルダを開いてください。
  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という名前のネットワークを探して接続します。(デフォルトではパスワードは不要です。)

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

  • 接続したら、Webブラウザ(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 Webインターフェースにアクセスする

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

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

    • コンピューターまたはモバイルデバイスでブラウザを開き、TRMNL web interfaceにアクセスします。
  2. デバイスページに移動する

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

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

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

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

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

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

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

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

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

caution

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

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

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

ボタンの使用方法

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

KEY1の使用方法:

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

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

TRMNL Playlist機能の理解

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

Playlistの概要

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

Playlistアイテム

playlistの各行は、ePaper Panelに表示される画面またはウィジェットを表します(参考のみ):

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

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

  • 設定(歯車アイコン): プラグインのオプションを設定します。
  • 削除(Xアイコン): playlistからアイテムを削除します。
  • プレビュー(目のアイコン): 画面がどのように表示されるかをプレビューします。
  • 並び替え(バーアイコン): ドラッグして画面が表示される順序を変更します。

Smart Playlist

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

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

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

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 キットコミュニティのユーザーエクスペリエンスが大幅に向上しました。

リソース

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

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

Loading Comments...