34 KiB
title, parent, nav_order, last_updated, description, aliases
| title | parent | nav_order | last_updated | description | aliases | |||
|---|---|---|---|---|---|---|---|---|
| 設定：モジュールと管理 | User Guide | 8 | 2026-08-30 | オプションの機能モジュール（MQTT、テレメトリ、定型メッセージ、TAK など）を設定し、デバイスの管理を行います。 |
|
設定：モジュールと管理
オプションの機能モジュールを設定し、デバイスの管理を行います。 モジュールは、専用の機能で Meshtastic を拡張します。それぞれ個別に有効・無効を切り替えられます。
💡 ヒント： 実際に使うモジュールだけを有効にすれば十分です。 使わないモジュールを無効にすると、電波利用時間が減り、バッテリーを節約でき、設定もシンプルになります。 A module you expect can be missing for three reasons: your node's role does not enable it, your firmware is older than the release that added it, or the firmware build excludes it for this hardware.
モジュールの設定は、トグルスイッチ、ドロップダウン、テキストフィールド、スライダーを備えたカード形式のレイアウトを使用します：
モジュールの設定
Every module lives under Settings → Module configuration.
⚠️ Important: Saving a module screen restarts the radio — the button reads Save & restart, and the radio is unreachable for a few seconds afterwards. External Notification and Mesh Beacon are the exceptions: their button reads Save, and the radio may still restart for some changes.
MQTT モジュール
インターネット接続のために、メッシュのメッセージを MQTT サーバーとの間で橋渡しします。 これにより、無線の到達範囲を超えてメッシュを拡張したり、ホームオートメーションシステムと連携したりできます。
| 設定項目 | 説明 |
|---|---|
| MQTTを有効化 | MQTT ブリッジを切り替え |
| アドレス | MQTT サーバーのアドレス |
| ユーザー名 | 認証用のユーザー名 |
| パスワード | 認証用のパスワード |
| 暗号化の有効化 | MQTT ペイロードを暗号化 |
| JSON出力の有効化 | Publish and consume MQTT messages as JSON. Marked deprecated in the protobuf schema, but it is still the only toggle for this behavior and the firmware still honors it |
| TLS の有効化 | セキュアな接続を使用 |
| ルート トピック | MQTT のベーストピックパス |
| クライアントへのプロキシの有効化 | Let a connected phone carry the node's MQTT traffic, instead of the node reaching the broker itself |
| このスマートフォンの MQTT プロキシ | The phone-side half of Proxy to client enabled: whether this phone acts as that relay. See MQTT |
| マップレポート | Publish position to the public map — see the Map reporting group that follows |
Turning Map reporting on reveals a consent card headed Consent to Share Unencrypted Node Data via MQTT, with an I agree. switch under it. The rest of the card does not exist on screen until you agree:
| 設定項目 | 説明 |
|---|---|
| 同意します。 | Explicit consent to transmit your node data, including an approximate position, unencrypted. Map reporting does not start without it |
| Precision slider | The slider has no label of its own. It sets how coarsely your position is published, from 12 to 15; the line beneath reads ± the resulting distance, in your own units |
| マップレポートの間隔 (秒) | How often to report. A dropdown of fixed intervals from 1 hour to 72 hours — nothing shorter is offered |
暗号化、プライバシー、サーバーの設定を含む詳しい使い方は、MQTT を参照してください。
シリアルモジュール
外部デバイスとの連携（GPS モジュール、センサー、カスタムハードウェア）のために、シリアルポート通信を有効にします。 有効にすると、ノードのシリアルポートで protobuf またはテキストデータを送受信でき、外部のマイコンやコンピューターがメッシュとやり取りできるようになります。
| 設定項目 | 説明 |
|---|---|
| シリアル通信を有効化 | シリアル通信を有効化 |
| Echoを有効化 | 受信したシリアルデータをそのまま返す |
| シリアルモード | Which protocol the port speaks — Default, Simple, Proto, Text message, NMEA, CalTopo, WS85 weather station, VE.Direct, MeshSolar config, Log, or Log (text only) |
| RX / TX | GPIO pins for the serial connection |
| シリアルボーレイト | Port speed |
| タイムアウト | How long to wait before considering an incoming message complete |
| コンソールのシリアルポートを上書き | Take over the port the debug console normally uses |
外部通知モジュール
無線機ハードウェアのブザー、LED、振動によるアラートを制御します。 メッセージ到着時に物理的に知らせる必要があるデバイスに便利です。特に無人設置や屋外設置で役立ちます。
There are two independent triggers — an incoming message, and a received bell character — and each can drive the LED, the buzzer and the vibration motor separately, giving six toggles.
| 設定項目 | 説明 |
|---|---|
| 外部通知を有効化 | Master toggle for the module |
| Alert message LED / buzzer / vibra | Which outputs fire on an incoming message |
| Alert bell LED / buzzer / vibra | Which outputs fire on a received bell character |
| LED出力 (GPIO) | Pin the LED is wired to |
| LED出力 アクティブハイ | Whether the LED pin is active high or low |
| ブザー出力(GPIO) | Pin the buzzer is wired to |
| バイブレーション出力 (GPIO) | Pin the vibration motor is wired to |
| PWMブザーを使用 | Drive the buzzer with PWM, which allows tones rather than a single pitch |
| I2Sをブザーとして使用 | Send the alert through an I2S audio output instead |
| 出力時間 (ミリ秒) | How long a single alert lasts |
| 繰り返し通知間隔（秒） | Keep repeating the alert for this long until it is acknowledged. 0 disables nagging |
| 着信音 | The tone played on a PWM buzzer, in RTTTL. Can be imported from a file |
Store & Forward モジュール
一時的にオフラインだったノードのためにメッセージをバッファリングし、それらのノードが再接続したときに再送します。 ノードが頻繁に圏内・圏外を行き来するメッシュに不可欠です。短時間の切断中にメッセージが失われないようにします。
| 設定項目 | 説明 |
|---|---|
| 一時保管と転送の有効化 | ストア＆フォワードを有効化 |
| ハートビート | このノードのストア＆フォワード機能を定期的に告知する |
| サーバーの最大保管レコード数 (デフォルト 約11,000レコード) | 保存するメッセージの最大数 |
| リクエスト可能な最大の履歴件数 | 再送するメッセージの最大数 |
| リクエスト可能な履歴の期間 (分) | 再送する時間の範囲 |
| サーバー | メッシュのストア＆フォワードサーバーとして動作する（十分なメモリが必要、例：PSRAM 搭載の ESP32） |
💡 ヒント： ストア＆フォワードは、十分なメモリを持つノード（PSRAM 搭載の ESP32）で最も良く機能します。 ルーターノードは通常は常時起動しているため、理想的な候補です。
レンジテストモジュール
⚠️ Warning: Range Test only works on a secured primary channel. As long as your primary channel still uses the default channel key, the interval and CSV controls stay disabled — you can still switch an already-enabled module off — and saving force-disables the module if the channel has reverted to public.
ノード間のリンク品質を評価するための、自動レンジテストツールです。 有効にすると、ノードはカウンターを増やしながらテストメッセージを定期的に送信します。 受信側のノードがこれらのメッセージを記録するため、歩いたり車で移動したりして、後からどの距離でメッセージが届かなくなったかを分析できます。
| 設定項目 | 説明 |
|---|---|
| レンジテストを有効化 | レンジテストを有効化 |
| 送信者のメッセージ間隔 (秒) | Time between test transmissions, chosen from a dropdown of fixed intervals |
| ストレージにCSVファイルを保存(ESP32のみ) | Log received test data to the radio's own filesystem. ESP32 hardware only |
テレメトリモジュール
ノードがメッシュと共有するテレメトリデータを制御します。 テレメトリには、デバイスの状態（バッテリー、連続稼働時間）と環境センサーのデータ（温度、湿度、気圧）が含まれます。
Each of the four metric groups has its own enable toggle and its own interval, so you can report battery health often and sensors rarely.
| 設定項目 | 説明 |
|---|---|
| デバイステレメトリを送信 | Master toggle for device metrics. Only shown on firmware 2.7.12 and newer |
| デバイスメトリクスの更新間隔 | How often to report battery, uptime and channel utilization |
| 環境メトリクスモジュールを有効化 | Report the attached environment sensors |
| 環境メトリクスの更新間隔 | How often to report them |
| 環境メトリクスを画面上で有効化 | Also show these readings on the device's own display |
| 環境メトリクスは華氏を使用 | Use °F on the device's display. This is the radio's screen only — the app follows your phone's locale, see Units & Locale |
| 空気品質測定モジュールを有効化 | Report particulate and CO₂ sensor data |
| 空気品質メトリクスの更新間隔 | How often to report them |
| 電源メトリクスモジュール有効 | Report the per-channel voltage and current readings |
| 電源メトリクスの更新間隔 | How often to report them |
| 電源メトリクスを画面上で有効化 | Also show power readings on the device's display |
対応センサーと設定の推奨事項については、テレメトリとセンサー を参照してください。
定型メッセージモジュール
Pre-configured messages accessible from the radio's physical buttons (for radios with rotary encoders, keypads, or similar input hardware). スマートフォンを接続していなくても送信できる、クイック送信メッセージのリストを定義します。フィールドでの使用に最適です。
| 設定項目 | 説明 |
|---|---|
| ⚠️ Deprecated in the protobuf schema | |
| メッセージ | 改行で区切ったメッセージのリスト |
| ベルを送信 | Send a bell character alongside the message, so a receiving node's External Notification module can sound |
| ロータリーエンコーダ #1 を有効化 | Use a rotary encoder as the input device |
| GPIO pin for rotary encoder A / B / Press port | The three pins the encoder is wired to |
| Generate input event on Press / CW / CCW | Which key event each encoder action produces |
| 上下/選択入力を有効化 | A separate, simpler input scheme using up/down/select buttons rather than an encoder |
| ⚠️ Deprecated in the protobuf schema |
オーディオモジュール
メッシュ上での低帯域幅の音声通信のための、Codec2 音声サポートです。 これは、Codec2 コーデックを使って音声を非常に小さなデータパケットにエンコードする、実験的な機能です。
| 設定項目 | 説明 |
|---|---|
| CODEC 2 を有効化 | オーディオモジュールを有効化 |
| CODEC2 サンプルレート | 音質と帯域幅のトレードオフ |
| PTT端子 | GPIO pin for the push-to-talk button |
| I2S ワードセレクト | I2S WS 用の GPIO ピン |
| I2S データ IN | I2S DIN 用の GPIO ピン |
| I2S データ OUT | I2S DOUT 用の GPIO ピン |
| I2S クロック | GPIO pin for the I2S bit clock |
ℹ️ Note: Audio requires specific hardware (I2S microphone and speaker). 音質は非常に低帯域です。「聞き取れる無線の声」程度で、電話並みの品質ではないと考えてください。
リモートハードウェアモジュール
メッシュネットワーク経由での GPIO 制御です。 リモートのノードが、別のノードの GPIO ピンを読み書きできるようにします。リレーの作動、スイッチの読み取り、離れた場所からの外部ハードウェア制御に便利です。
⚠️ Warning: Turning on Allow undefined pin access gives remote nodes access to all GPIO pins, which could interfere with the radio's own hardware. Turn it on only on dedicated GPIO nodes.
| 設定項目 | 説明 |
|---|---|
| リモートハードウェアを有効化 | リモート GPIO アクセスを有効化 |
| 未定義のピンへのアクセスを許可 | 任意の GPIO ピンへのアクセスを許可（セキュリティリスク） |
| 使用可能な端子 | このノードがリモートの読み書き用に公開する GPIO ピン（最大 4 個） |
隣接ノード情報モジュール
直接受信した隣接ノードの情報をブロードキャストし、メッシュのトポロジーマッピングを可能にします。 有効にした各ノードは、受信できる他のノードとその信号品質のリストを定期的に共有します。
| 設定項目 | 説明 |
|---|---|
| 近隣ノード情報を有効化 | 隣接ノードのブロードキャストを有効化 |
| 更新間隔 (秒) | 隣接ノードのリストをブロードキャストする頻度 |
| LoRaで送信 | MQTT／スマートフォンだけでなく、LoRa 経由でも隣接ノード情報をブロードキャストします。 デフォルトの鍵と名前を使用しているチャンネルでは利用できません |
See Local Mesh Discovery for how to use neighbor data for mesh topology exploration.
アンビエントライティングモジュール
対応ハードウェア上の、オンボードの NeoPixel やその他のアドレサブル RGB LED を制御します。 視覚的なステータス表示、通知ライト、装飾的な演出に使用できます。
| 設定項目 | 説明 |
|---|---|
| LEDの状態 | LED のオン／オフを切り替え |
| 電流 | LED の電流制限（0〜31） |
| 赤／緑／青 | 各色チャンネルの値（0〜255） |
検知センサーモジュール
ノードを、動きやドアを検知するセンサーアラートシステムに変えます。 GPIO ピンが状態の変化（動きの検知、ドアの開放）を検出すると、ノードはメッシュ経由でアラートメッセージをブロードキャストします。
| 設定項目 | 説明 |
|---|---|
| 検出センサーを有効化 | 検知センサーを有効化 |
| モニターのGPIOピン | センサーに接続された GPIO ピン |
| 検出トリガーの種類 | ピンの状態を検知イベントにどう対応させるか（例：アクティブハイ／ロー、エッジトリガー） |
| INPUT_PULLUP モードを使用 | ピンの内蔵プルアップ抵抗を有効にする |
| 最小ブロードキャスト間隔(秒) | アラートのブロードキャスト間の最小時間 |
| 状態のブロードキャスト間隔 (秒) | 定期的な状態ブロードキャストの間隔 |
| アラートメッセージ付きのベルを送信 | アラートにベル文字を含める |
| 名前 | このセンサーのカスタム名 |
Paxcounter モジュール
People counter using Wi-Fi and BLE probe requests. スマートフォンやノートパソコンがネットワークを探すときに発するプローブ要求を受動的に受信して、近くのデバイスを数えます。 ESP32 デバイスでのみ利用できます。
| 設定 | 説明 |
|---|---|
| Paxcounter を有効化 | 人数カウントを有効化 |
| 更新間隔 (秒) | カウントを報告する頻度 |
| Wi-Fi RSSI threshold | Ignore Wi-Fi probes weaker than this, so distant devices are not counted (defaults to −80 dBm) |
| BLE RSSI threshold | The same cut-off for BLE advertisements (defaults to −80 dBm) |
💡 ヒント： Paxcounter は、登山口やイベント会場などの人出を推定するのに便利です。 カウントはおおよその値です。1 人が複数のデバイスを持っていることがあります。
Status Message Module
The status message has no module screen. It is edited with the rest of the node's identity, on Settings — Radio & User.
Mesh Beacon Module
Broadcasts an invitation to your mesh, and receives invitations from others. The entry appears only on radios running firmware 2.8.0 or newer. See Local Mesh Discovery for the full walkthrough.
TAK モジュール
ATAK および WinTAK と相互運用するための、Team Awareness Kit 連携です。 Two things have to be
true before the entry appears in the module list: the radio runs firmware 2.8.0 or newer, and its
Device Role on Settings → Device configuration → Device is set to TAK or TAK_TRACKER.
詳しい設定と使い方は、TAK 連携 を参照してください。
管理
リモート管理
管理者鍵を共有しているノードをリモートで設定します：
- ノードリストで対象のノードを選択します。
- そのノードの「設定」に移動します。
- 設定を変更します。
- 「保存」をタップします。変更がメッシュ経由で送信されます。
⚠️ Important: Requires an admin key configured on both your node and the target node.
Device Actions
Settings → Administration holds five one-shot actions, each behind a confirmation dialog:
| 操作 | 内容 |
|---|---|
| 時刻を設定 | Sends your phone's clock to the radio |
| 再起動 | Restarts the radio |
| シャットダウン | Powers the radio down |
| 出荷時にリセット | Returns every setting to its factory default |
| NodeDBをリセット | Clears the radio's node database. This dialog carries a Preserve Favorites? switch |
⚠️ Warning: Factory reset erases all settings, channels, and keys, and cannot be undone. Before you reset, use Export configuration to save the radio's settings and Backup Keys on the Security screen to save its keys, so you can put both back afterwards.
バックアップと復元
Settings → Backup & Restore writes the connected radio's whole configuration to a file with Export configuration, and reads a saved file back in with Import configuration. Export before a factory reset, or to copy one radio's setup onto another. The section is shown for your own radio only, not over remote admin.
詳細設定
Settings → Advanced collects the tools that read or rewrite local state, and is likewise shown for your own radio only: Firmware Update on OTA-capable hardware, Clean Node Database, TAK Server, Local Mesh Discovery, and the Debug Panel.
ノードデータベースの整理
Prunes nodes from your node database — from the app's copy and from the radio's own, so this is not a display-only cleanup. The two filters combine rather than acting separately; the screen puts it as Selections are additive.
- Clean up nodes last seen older than N days — always applied. The slider runs from 7 days to 365 and starts at 30; with Clean up only unknown nodes turned on, its floor drops to 0.
- Clean up only unknown nodes — narrows the same purge to nodes that never sent their user info. The age limit still applies on top of it.
The screen lists the nodes queued for deletion as you move the filters. Clean Now carries the purge out, after one more confirmation, and it cannot be undone. Favorited nodes, ignored nodes, and nodes with a public key heard in the last seven days are never removed, whatever the filters say — that is why the queued list can be shorter than you expect.
デバッグ
診断出力の表示・絞り込み・エクスポートを行う「パケット」タブと「アプリログ」タブを開きます。 詳しい手順は、デバッグログ を参照してください。
App Settings
Two easy-to-miss entries on the Settings screen configure the app rather than the radio, and appear only when your own node is selected:
- Node Layout — how much detail each row of the node list shows.
- Message Filter — hides incoming messages that contain words you list. With no words configured it does nothing.
概要
Settings → About carries the app's own identity rather than the radio's:
Three sections:
- What is Meshtastic? — a short description of the project.
- Apps — opens with Need Hardware?, a rotating carousel of popular devices that links out to where to buy one. It also lists the GitHub repository, the running app version, and Acknowledgements (see the next section).
- Project information — links to the website and to this documentation.
謝辞
Reached from About, this lists every open-source library the app ships, with its license, generated at build time by AboutLibraries. It was previously called the license screen.
リモート管理のトラブルシューティング
- 「対象ノードから応答がありません」：対象が圏外、オフライン、または管理者鍵が一致していない可能性があります。 両方のノードで管理者鍵が一致しているか確認してください。
- 変更が適用されない：一部の設定は、反映に再起動が必要です。 保存後に「再起動」を実行してみてください。
- リモートの設定が表示されない：自分のノードに、対象ノードの管理者鍵があることを確認してください。 管理チャンネルは、管理者鍵を設定すると自動的に構成されます。
関連トピック
- 設定：無線機とユーザー：基本の無線機とユーザープロファイルの設定
- モジュール設定リファレンス：meshtastic.org にある詳細なモジュールのドキュメント
- FAQ：meshtastic.org のよくある質問