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

    • クローンした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アドレスを確認する。
  • ルーターまたはメッシュネットワークアプリの接続デバイスリストで見つける。

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

TRMNLウェブインターフェースへのアクセス

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

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

  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ウェブインターフェースでデバイスを追加した後、デバイスの設定ページに移動し、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」)。
    • 最後に更新された時期も表示されます。

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

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

スマートプレイリスト

  • スマートプレイリストオプション: 下部で、コンテンツが変更されていない画面を自動的にスキップするかどうかを選択できます(例:「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: ウェブまたは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キットコミュニティのユーザーエクスペリエンスが大幅に向上しました。

トラブルシューティング

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

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

リソース

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

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

Loading Comments...