Skip to content

Plugins Meshtastic

github-actions[bot] edited this page Oct 29, 2026 · 10 revisions

Meshtasticプラグイン

このモジュールのソースはSRdeckPluginsソーススナップショットで公開されますが、公式SRdeck実行ZIPにはDLLを含めません。

プラグインIDはmeshtasticです。Meshtasticで使われるLoRa信号を複数スロットで監視し、パケット、ノード、位置、診断情報を表示します。利用にはソースからのビルドと、同じリリースのSRdeckプラットフォームパッケージが必要です。

配布上の位置付け

  • ソース公開: 対象
  • with-pluginsへのDLL同梱: 対象外
  • host-onlyへのDLL同梱: 対象外
  • ホストによる署名/サンドボックス: なし
  • 利用判断: ビルドした利用者自身が地域、周波数、ライセンス、互換性を確認

ソースが存在することは、あらゆる地域・用途でのバイナリ利用を保証するものではありません。

受信モード

モード 動作 向いている状況
探索 対象帯域から候補を探索 使用プロファイルやスロットが不明
条件指定 帯域幅、プロファイル、スロットを指定し、先頭スロットをFM音声モニター 既知ネットワークを低負荷で監視

探索は便利ですが、条件指定より広い帯域と処理量を必要とする場合があります。まず地域を正しく選び、RATEと負荷を確認してください。 FM音声モニターは48 kHzモノラルで、LoRaパケット復調とは独立しています。探索モードではFM復調を行いません。

代表プロファイル

名前 Spreading Factor 帯域幅
Long Fast SF11 250 kHz
Long Moderate SF11 125 kHz
Long Slow SF12 125 kHz
Medium Slow SF10 250 kHz
Medium Fast SF9 250 kHz
Short Slow SF8 250 kHz
Short Fast SF7 250 kHz

自動判定用にAutoSF-250、AutoSF-125、AutoSF-250+125もあります。選択可能なスロット数は、リージョン、帯域幅、現在のSDR RATEで制限されます。

基本操作

  1. 互換する版でプラグインをビルドし、DLLと専用依存DLLをSRdeck.exeと同じフォルダーへ配置します。
  2. SRdeckを再起動し、MODEでMeshtasticを選びます。
  3. 対象地域のリージョンを選びます。
  4. 使用条件が分かる場合は条件指定でプロファイルとスロットを1つ選びます。
  5. 分からない場合だけ探索を使います。
  6. Startを押し、スペクトラムオーバーレイと診断を確認します。
  7. 単一スロットで安定してから監視範囲を増やします。

ワークスペース

  • 概要: 最近のノード、テキストメッセージ、受信概況
  • 一覧: ノード集計(直接・中継の件数はPacket単位で、両方を受信した場合は直接のみ計上)と、選択ノードのAPPごとの最新値・受信日時(保持中の復号済み履歴から表示)
  • 時系列: 受信イベント、選択パケットの詳細、Payload HEX
  • 地図: 位置情報を持つノード
  • リンク品質: 保持中の履歴をノード・受信条件別に比較。直接/中継/経路不明の受信件数と、直接受信のSNR・RSSIの平均・最小・最大・測定件数を表示(集計方法)
  • 診断: 受信器、スロット、同期、復調、処理状態

暗号化されたペイロードや未対応メッセージは、無線フレームを受信できても内容を表示できない場合があります。Payload HEXがあることと、アプリケーション内容を解釈できることは別です。

地図とプライバシー

位置情報を持つノードだけが地図に表示されます。地図の表示にはMicrosoft Edge WebView2 Runtimeが必要です。

地図モードは基幹画面の設定 → 地図で選びます。この設定は地図を持つすべてのプラグインで共通です。

  • 自動: 接続中はタイルを取得・更新し、通信できないときは保存済みタイルを表示します。
  • キャッシュのみ: OpenStreetMapへ接続せず、保存済みタイルだけを表示します。

キャッシュの詳しい使い方は地図とキャッシュを参照してください。

位置、ノード名、メッセージ、Payloadを保存・共有するときは、参加者のプライバシーと地域の法令を確認してください。公開ネットワークで受信できることは、内容の再公開が常に適切であることを意味しません。

性能調整

LoRaはSF、帯域幅、スロット候補の組み合わせで処理量が変わります。

Atom N100での実測では、SDR RATE 6 MS/s時のMeshtastic同時受信は約10スロットが目安です。実際の処理量は有効にする帯域幅やAutoSF設定、FFT解像度などによって変わります。125 kHzスロットも有効にする場合は、FFT更新速度を保つために受信スロット数を調整してください。

  1. 条件指定で既知プロファイルを選ぶ
  2. スロット数を減らす
  3. AutoSF-250+125より単一帯域幅を選ぶ
  4. 必要範囲が収まる最小RATEにする
  5. FFT解像度を下げる
  6. PRCとスロット別診断を比較する

よくある症状

MODEに表示されない

公式ZIPにはDLLが含まれません。自分でビルドしたDLLの名前、配置、Host API、プラットフォームパッケージ版、依存DLLを確認してください。

信号は見えるがパケットにならない

リージョン、周波数スロット、帯域幅、SF候補を確認します。単一の既知プロファイルに絞り、PPMとゲインを調整してください。

ノードは出るが地図に出ない

位置情報を送信していない、暗号化/未対応で位置を解釈できない、WebView2または地図ソースに問題がある可能性があります。一覧で緯度経度の有無を先に確認し、オンラインの場合は通信、オフラインの場合は対象地域・ズームがキャッシュに残っているか確認します。

Clone this wiki locally