Meshtastic ファームウェア ソースコード実践チュートリアル

このチュートリアルは、Meshtastic ファームウェアのソースコードにこれから触れるユーザーを対象としています。Windows と macOS の両方で共通するワークフローを含んでいます。目的はシンプルで、公式リポジトリをクローンし、ビルドを成功させ、UI を 1 か所だけ簡単に変更し、その変更済みファームウェアをデバイスに書き込んで動作を確認することです。

すでに Git、Python、または PlatformIO に慣れている場合は、該当するセクションを飛ばして、ハンズオンのパートから始めても構いません。

ヒント

このガイドには、Windows と macOS の両方で共通して使えるコマンドを掲載しています。スクリーンショットの多くは Windows 環境で撮影したものですが、macOS での全体的なワークフローもほぼ同じです。

事前準備

始める前に、次のツールを用意してください。

1. Git
2. Python 3
3. VS Code
4. PlatformIO

1. Git をインストールする

Windows

公式の Git for Windows ダウンロードページを開きます。

Git for Windows

ページを開くと、通常はインストーラのダウンロードが自動的に始まります。ダウンロードが完了したら、インストーラをダブルクリックしてセットアップウィザードに従います。

インストール中で最も重要なステップは PATH 環境変数の調整 です。次を選択します。

Git from the command line and also from 3rd-party software

その他のオプションは、通常はデフォルトのままで問題ありません。そのまま Next をクリックし続けてください。

インストールが完了するまで待ちます。

インストール後、現在開いている PowerShell と VS Code のターミナルウィンドウをすべて閉じてから、新しく PowerShell を開き、次を実行します。

& "C:\Program Files\Git\cmd\git.exe" --version

Git のバージョン番号が表示されれば、Git は正常にインストールされています。

git コマンドがまだ使えない場合

まず PowerShell で次のコマンドを実行し、Git のデフォルトのインストールパスを確認できます。

$gitCmd = "C:\Program Files\Git\cmd"
$gitBin = "C:\Program Files\Git\bin"
Write-Host $gitCmd
Write-Host $gitBin

その後、Git をシステム環境変数に手動で追加します。

GUI での修正手順

1. Win を押します
2. 「Edit the system environment variables」を検索します
3. 開いて Environment Variables をクリックします
4. System variables の下にある Path を探します
5. Edit をクリックします
6. New をクリックして、次の 2 つのパスを追加します。

C:\Program Files\Git\cmd
C:\Program Files\Git\bin

7. 最後まで OK をクリックして保存します

保存後、次の操作も必要です。

• すべての PowerShell ウィンドウを閉じる
• PowerShell を再度開く

そのうえで、次を実行します。

git --version

バージョン番号が表示されれば、インストールは完了です。

macOS

macOS では Git をインストールする方法が複数ありますが、通常は Homebrew を使うのが最も簡単です。

1. まず Command Line Tools をインストールします。

xcode-select --install

2. Homebrew がまだインストールされていない場合は、先にインストールします。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Git をインストールします。

brew install git

4. インストールされたバージョンを確認します。

git --version

ターミナルがすでに有効な Git バージョンを返す場合は、改めてインストールする必要はありません。

Git のユーザー情報を設定する

次に、Git のユーザー情報を設定します。サンプルの値を自分の名前とメールアドレスに置き換えてください。

git config --global user.name "your name"
git config --global user.email "your [email protected]"

その後、次を実行します。

git config --global --list

設定が反映されていることを確認します。

2. Python 3 をインストールする

コマンドラインから Python をインストールする

Windows

ターミナルで次のコマンドを実行します。

winget search --id Python.Python.3.13 --source winget
winget install -e --id Python.Python.3.13 --source winget

最初のコマンドで Python が見つかれば、通常は 2 つ目のコマンドでそのままインストールされます。

インストール後、ターミナルを閉じて再度開き、次を実行します。

python --version
pip --version

バージョン番号が表示されれば、Python と pip を使用する準備が整っています。

macOS

macOS には、すでに Python 環境が含まれていることがよくあります。新しいバージョンをインストールする前に、python3 と pip3 がすでに利用可能かどうかを確認してください。

python3 --version
pip3 --version

利用できない場合、またはより新しいバージョンが必要な場合は、Homebrew で Python をインストールします。

brew install python

インストール後、ターミナルを開き直して次を実行します。

python3 --version
pip3 --version

python や pip を使いたい場合は、自分でシェルエイリアスを設定することもできます。ただし macOS では、python3 と pip3 を使う方が一般的に信頼性が高い選択です。

3. PlatformIO をインストールする

このステップは、PlatformIO が多くの依存関係を自動的にダウンロードし、インストールに時間がかかるため、初心者にはやや分かりにくく感じられるかもしれません。インストール中にエラーが出た場合は、基本的には焦らず、1 つずつ問題を切り分けて対処するのがよいでしょう。エラーメッセージの確認には、AI ツールを活用すると時間の節約にもなります。

VS Code の拡張機能マーケットプレイスで PlatformIO を検索し、インストールします。

インストール後、左側のツールバーにアリの形をしたアイコンが表示されるはずです。

4. Meshtastic ファームウェアリポジトリをクローンする

Meshtastic 公式のファームウェアリポジトリは meshtastic/firmware です。

Windows

作業ディレクトリのターミナルで次のコマンドを実行します。

git clone https://github.com/meshtastic/firmware.git
cd firmware
git submodule update --init

プロジェクトディレクトリが別のドライブや別のパスにある場合は、先にその場所へ移動してください。

出力が上のスクリーンショットと同様であれば、リポジトリは正常にクローンされています。

macOS

作業ディレクトリのターミナルで次のコマンドを実行します。

cd ~/workplace
git clone https://github.com/meshtastic/firmware.git
cd firmware
git submodule update --init

もし ~/workplace がまだ存在しない場合は、先に作成します。

mkdir -p ~/workplace

コマンドが問題なく完了すれば、リポジトリは正常にクローンされています。

リポジトリの準備ができたら、次の 2 つの実践プロジェクトのいずれかを続けて進められます。プロジェクト A は Wio Tracker L1 の UI カスタマイズに焦点を当てています。プロジェクト B は Meshtastic 上での XIAO ESP32S3 による環境テレメトリに焦点を当てています。

プロジェクト A: Wio Tracker L1 の UI カスタマイズ

ハンズオン実践

この段階では、すぐにコード編集に取りかからないでください。まずはプロジェクトが最後までビルドプロセスを正常に完走できることを確認します。

最初に次の 3 つのタスクから始めることをおすすめします。

1. firmware を開く
2. platformio.ini を確認する
3. 対象ボード用のビルド環境を探す

重要なポイントが 1 つあります。ルートの platformio.ini だけに注目しないでください。実際には、次のような追加の設定ファイルを include しています。

extra_configs =
    variants/*/*.ini
    variants/*/*/platformio.ini
    variants/*/diy/*/platformio.ini

つまり、実際のボードレベルの環境定義は、通常 variants/.../platformio.ini の下にあります。

対象ボードを特定する際は、次の 2 つのディレクトリに特に注意してください。

• variants/
• boards/

ここでは、例として Wio Tracker L1 Pro をターゲットにします。

これにより、Meshtastic において Wio Tracker L1 / L1 Pro のビルドターゲットは seeed_wio_tracker_L1 であることが分かります。

最小限の変更のまとめ

最小限のエンドツーエンドの練習だけを完了したい場合は、次の重要なステップに集中してください。

1. Git、Python 3、VS Code、PlatformIO をインストールする。
2. meshtastic/firmware リポジトリをクローンし、サブモジュールを初期化する。
3. pio run -e seeed_wio_tracker_L1 を使って、元のプロジェクトが正常にビルドできることを確認する。
4. src/graphics/SharedUIDisplay.cpp 内の表示ロジックを変更する。
5. ファームウェアを再ビルドし、生成された UF2 ファイルをデバイスに書き込んで動作を確認する。

ステップ 1: プロジェクトが正常にビルドできることを確認する

ここでは、ビルドに PlatformIO Core CLI を使用します。

最初のビルドでは、次のコマンドを実行することをおすすめします。

Windows

cd D:\workplace\firmware  # Adjust to your actual project path
pio run -e seeed_wio_tracker_L1

macOS

cd ~/workplace/firmware  # Adjust to your actual project path
pio run -e seeed_wio_tracker_L1

もしインターフェースが上のスクリーンショットと同様に見えていれば、ビルドプロセスは正しく開始されています。最初のビルドは時間がかかることが多いので、しばらく待ちましょう。

ビルドが失敗した場合

ビルドが失敗したときは、まず PlatformIO に現在の環境で必要な依存関係をインストールさせることができます：

Windows

cd D:\workplace\firmware  # Adjust to your actual project path
pio pkg install -e seeed_wio_tracker_L1

macOS

cd ~/workplace/firmware  # Adjust to your actual project path
pio pkg install -e seeed_wio_tracker_L1

この方法にはいくつかの利点があります：

• 依存関係のみをインストールし、すぐにフルビルドを開始しません。
• どのパッケージが問題を引き起こしているかを確認しやすくなります。
• エラーメッセージがより絞り込まれ、トラブルシューティングしやすくなります。

依存関係のインストールが完了したら、次を実行します：

Windows

pio run -e seeed_wio_tracker_L1 -v

macOS

pio run -e seeed_wio_tracker_L1 -v

依存関係のインストールが完了したら、通常のビルドを再度実行します：

Windows

pio run -e seeed_wio_tracker_L1

macOS

pio run -e seeed_wio_tracker_L1

この時点でビルドが通れば、ファームウェア出力は正常に生成されています。

ステップ 2: コードを変更する

実践 1: UI 表示を変更する

まずボードレベルの設定から表示の実装をたどっていきます。最初に次を確認できます：

• variants/nrf52840/seeed_wio_tracker_L1/platformio.ini
• variants/nrf52840/seeed_wio_tracker_L1/variant.h

これらの設定ファイルから、L1 が HAS_SCREEN と USE_SSD1306 を定義していることが分かります。つまり、スクリーンなし構成でも E-Ink ソリューションでもなく、標準的な OLED ディスプレイパイプラインを使用しているということです。

表示ロジックをさらに追っていくと、関連コードのほとんどは次の場所にあります：

• src/graphics/
• src/graphics/draw/

具体的にどのように変更するかは、ソースコードを読む力に依存します。ここでは非常にシンプルな例として、ホーム画面の UI を変更するところから始めます。

変更 1: バッテリーテキストの右端を記録する

Before / After

// Before
int batteryX = 1;
int batteryY = HEADER_OFFSET_Y + 1;

// After
int batteryX = 1;
int batteryY = HEADER_OFFSET_Y + 1;
int batteryTextEndX = batteryX - 1;

src/graphics/SharedUIDisplay.cpp:157

ここでは batteryTextEndX を追加し、バッテリー残量テキストの終端位置を記録しています。これにより、後でバッテリー情報の後ろにカスタムテキストを追加しやすくなります。

変更 2: バッテリー残量描画時に右端境界を計算する

// Before
if (chargePercent != 101) {
    char chargeStr[4];
    snprintf(chargeStr, sizeof(chargeStr), "%d", chargePercent);
    int chargeNumWidth = display->getStringWidth(chargeStr);
    display->drawString(batteryX, textY, chargeStr);
    display->drawString(batteryX + chargeNumWidth - 1, textY, "%");
    if (isBold) {
        display->drawString(batteryX + 1, textY, chargeStr);
        display->drawString(batteryX + chargeNumWidth, textY, "%");
    }
}

// After
if (chargePercent != 101) {
    char chargeStr[4];
    snprintf(chargeStr, sizeof(chargeStr), "%d", chargePercent);
    int chargeNumWidth = display->getStringWidth(chargeStr);
    int percentWidth = display->getStringWidth("%");
    display->drawString(batteryX, textY, chargeStr);
    display->drawString(batteryX + chargeNumWidth - 1, textY, "%");
    if (isBold) {
        display->drawString(batteryX + 1, textY, chargeStr);
        display->drawString(batteryX + chargeNumWidth, textY, "%");
    }
    batteryTextEndX = batteryX + chargeNumWidth + percentWidth - 1 + (isBold ? 1 : 0);
} else {
    batteryTextEndX = batteryX - 1;
}

src/graphics/SharedUIDisplay.cpp:204

このコードはバッテリー残量描画ロジックの内部にあります。バッテリーレベルを通常どおり表示するだけでなく、テキスト領域の右端境界も計算し、その後ろにカスタムラベルを配置できるようにしています。

変更 3: 右側のアイコン領域用に境界を確保する

// Before
int iconRightEdge = timeX - 2;

// After
int iconRightEdge = timeX - 2;
int headerLabelRight = timeX - 4;

src/graphics/SharedUIDisplay.cpp:263

この部分は、右側にある時刻、メール、ミュートなどのアイコンが使用する領域を処理します。ここでは headerLabelRight を追加し、中央テキストの最大右端境界を制限して、右側のコンテンツと重ならないようにしています。

変更 4: タイトルが空のときにカスタムラベルを描画する

// Newly added core logic
#if defined(SEEED_WIO_TRACKER_L1) && !defined(SEEED_WIO_TRACKER_L1_EINK)
if (titleStr && titleStr[0] == '\0') {
    static const char *yclLabel = "made by AE";
    int labelWidth = display->getStringWidth(yclLabel);
    int labelLeft = batteryTextEndX + 4;
    if (labelLeft + labelWidth <= headerLabelRight) {
        int labelX = labelLeft + ((headerLabelRight - labelLeft) - labelWidth) / 2;
        display->drawString(labelX, textY, yclLabel);
        if (isBold)
            display->drawString(labelX + 1, textY, yclLabel);
    }
}
#endif

src/graphics/SharedUIDisplay.cpp:350

これは変更の中核となるロジックです。SEEED_WIO_TRACKER_L1 にのみ適用され、E-Ink バリアントは明示的に除外しています。バッテリー情報と時刻表示の間の空白に、made by AE というテキストを中央配置します。

変更 5: 時刻が表示されない分岐を処理する

// Add the same boundary control for the no-time branch
int iconRightEdge = screenW - xOffset;
int headerLabelRight = screenW - xOffset - 2;

src/graphics/SharedUIDisplay.cpp:377

ここは時刻値が表示されない場合に使われる分岐です。同じ境界制御をここにも追加する必要があります。

#if defined(SEEED_WIO_TRACKER_L1) && !defined(SEEED_WIO_TRACKER_L1_EINK)
        if (titleStr && titleStr[0] == '\0') {
            static const char *yclLabel = "made by AE";
            int labelWidth = display->getStringWidth(yclLabel);
            int labelLeft = batteryTextEndX + 4;
            if (labelLeft + labelWidth <= headerLabelRight) {
                int labelX = labelLeft + ((headerLabelRight - labelLeft) - labelWidth) / 2;
                display->drawString(labelX, textY, yclLabel);
                if (isBold)
                    display->drawString(labelX + 1, textY, yclLabel);
            }
        }
#endif

src/graphics/SharedUIDisplay.cpp:426

ここは、時刻なし分岐で made by AE を描画する実装です。

完全なコードはこちらで確認できます：

📎SharedUIDisplay.cpp

ステップ 3: 自分のファームウェアをビルドする

変更が完了したら、プロジェクトルートに戻り、同じターゲットを再度ビルドします：

Windows

cd D:\workplace\firmware  # Adjust to your actual project path
pio run -e seeed_wio_tracker_L1

macOS

cd ~/workplace/firmware  # Adjust to your actual project path
pio run -e seeed_wio_tracker_L1

表示ロジックは変更しましたが、ビルドターゲットは同じままです：

seeed_wio_tracker_L1

ビルドが成功すると、出力は通常次の場所にあります：

Windows

D:\workplace\firmware\.pio\build\seeed_wio_tracker_L1\

macOS

~/workplace/firmware/.pio/build/seeed_wio_tracker_L1/

更新されていることを確認すべきファイルは次のとおりです：

firmware-seeed_wio_tracker_L1-*.uf2

ファームウェアを書き込む

ビルドが完了したら、公式の書き込みページを開きます：

Meshtastic Flasher

ほとんどの場合、最初に消去操作を行う必要があります。

その後、先ほどビルドしたファームウェアファイルを選択し、デバイスに書き込みます。

これで、Meshtastic ソースコードの実践演習は完了です。環境構築、リポジトリのクローン、ボード設定の調査、ファームウェアのコンパイル、表示ロジックの変更、最終的な書き込み検証まで、一連のワークフローを一通り体験しました。

さらに先に進みたい場合は、次のような方向性を引き続き探求できます：

1. ホーム画面上の要素をさらに変更する
2. ボタン、GPS、Bluetooth などのモジュールの動作を調整する
3. 自分のボード用に独立した variant を追加する
4. src/、variants/、boards/ 間の関係を引き続き追跡する

より機能志向のソースレベルの例が欲しい場合は、以下のプロジェクト B に進んでください。これは XIAO ESP32S3 + Wio-SX1262 + SHT40 を用いた専用の環境テレメトリノードを構築します。上記の Wio Tracker L1 の UI 変更と比べて、このパートはデフォルト設定、テレメトリのタイミング、2 ノード間の実際のメッシュ検証に焦点を当てています。

プロジェクト B: XIAO ESP32S3 環境テレメトリノード

プロジェクトの目的

この発展的な例では、同じメッシュ内で 2 台の Meshtastic デバイスを使用します。

リモートセンサーノード

• SHT40 から温度と湿度を読み取る
• Meshtastic の環境テレメトリを使用する
• テレメトリをメッシュに送信する
• メッシュ送信間隔を 60s に変更する
• 初回起動時の対話的な地域設定をスキップする
• デフォルトの地域を US に設定する

近くのゲートウェイノード

• Meshtastic ネットワークに CLIENT として参加する
• LoRa 経由でリモートの TELEMETRY_APP パケットを受信する
• environmentMetrics.temperature を解析する
• environmentMetrics.relativeHumidity を解析する

通信パス

XIAO ESP32S3 + Wio-SX1262 + SHT40 -> Meshtastic LoRa -> XIAO ESP32S3 + Wio-SX1262 (or any other device on the same mesh)

ハードウェアの準備

リモートノードのハードウェア

• Seeed XIAO ESP32S3
• Wio-SX1262
• SHT40

ゲートウェイノードのハードウェア

近くのノードは、同じネットワークに参加している任意の Meshtastic デバイスで構いません。以下の例では、別の XIAO ESP32S3 + Wio-SX1262 デバイスを使用します。

SHT40 の配線

• VCC -> 3V3
• GND -> GND
• SDA -> GPIO5
• SCL -> GPIO6

動作確認済みの設定：

• I2C address = 0x44
• GPIO5 / GPIO6 は現在動作している I2C 配線ペアです

次の写真は、リモートノードで実際に使用している配線を示しています：

このプロジェクトで使用したモジュールと SKU

• Seeeduino XIAO Expansion Board (SKU: 103030356)
• XIAO ESP32S3 & Wio-SX1262 Kit for Meshtastic & LoRa (SKU: 102010611)

リモートノード用に Meshtastic ファームウェアを変更する

このプロジェクトの対象環境は次のとおりです：

seeed-xiao-s3

主なファイルは次のとおりです：

• variants/esp32s3/seeed_xiao_s3/platformio.ini
• src/modules/Telemetry/EnvironmentTelemetry.h
• src/modules/Telemetry/EnvironmentTelemetry.cpp

このパートでは、variants/esp32s3/seeed_xiao_s3/platformio.ini の build_flags セクションのみを更新します。上流ファイルのそれ以外の部分は変更しないでください。

build_flags =
  ${esp32s3_base.build_flags}
  -D SEEED_XIAO_S3
  -D ENVIRONMENTAL_TELEMETRY_MODULE_ENABLE=1 ; enable environmental telemetry by default
  -D USERPREFS_CONFIG_LORA_REGION=meshtastic_Config_LoRaConfig_RegionCode_US ; set the default region to US
  -D USERPREFS_CONFIG_DEVICE_ROLE=meshtastic_Config_DeviceConfig_Role_SENSOR ; set the default role to SENSOR
  -I variants/esp32s3/seeed_xiao_s3
  -DBOARD_HAS_PSRAM
  -DARDUINO_USB_MODE=0

build_flags の変更は次のような見た目になります：

これら 3 つのフラグは次のことを行います：

• デフォルトで環境テレメトリを有効にする
• デフォルトの地域を US に設定し、初回起動時に地域選択で停止しないようにする
• デフォルトのデバイスロールを SENSOR に設定する

テレメトリのタイミング変更は、platformio.ini ではなく EnvironmentTelemetry.h と EnvironmentTelemetry.cpp に実装されています。

すべての変更を行うと、動作は次のようになります：

• 環境テレメトリがデフォルトで有効になる
• デバイスは地域 US で起動する
• デバイスはロール SENSOR で起動する
• メッシュ環境テレメトリは 60s ごとに送信される
• path=phone と path=mesh が別々にログ記録される
• 実際にメッシュ送信が成功した後にのみ、メッシュ送信タイムスタンプが更新される

期待されるメッシュディスパッチログは次のようになります：

Environment telemetry dispatch path=mesh dest=0xffffffff interval_mesh_s=60

近くのゲートウェイノードを設定する

近くの Meshtastic デバイスを、同じメッシュ上の CLIENT として使用します。リモートノードがテレメトリ送信を開始したら、ゲートウェイが次の項目を受信できることを確認します：

• TELEMETRY_APP
• environmentMetrics.temperature
• environmentMetrics.relativeHumidity

テスト中にゲートウェイが Wi-Fi への接続を試行し続ける場合は、Meshtastic CLI を使って Wi-Fi を無効にします。<gateway_port> を実際のシリアルポートに置き換えてください。Windows では COMx、macOS では /dev/cu.usbmodem... のようになります。

meshtastic --port <gateway_port> --set network.wifi_enabled false

ビルド、書き込み、検証

ステップ 1: 変更したファイルをコピーする

ビルドする前に、変更した 3 つのファイルを Meshtastic 2.7.20 または 2.7.21 のソースツリーにコピーします：

パッケージ内のファイル	Meshtastic ソースツリー内で置き換えるファイル
meshtastic-2.7.20-s3-files/variants/esp32s3/seeed_xiao_s3/platformio.ini	<your Meshtastic directory>/variants/esp32s3/seeed_xiao_s3/platformio.ini
meshtastic-2.7.20-s3-files/src/modules/Telemetry/EnvironmentTelemetry.h	<your Meshtastic directory>/src/modules/Telemetry/EnvironmentTelemetry.h
meshtastic-2.7.20-s3-files/src/modules/Telemetry/EnvironmentTelemetry.cpp	<your Meshtastic directory>/src/modules/Telemetry/EnvironmentTelemetry.cpp

直接ダウンロードリンク：

• 📎EnvironmentTelemetry.h
• 📎EnvironmentTelemetry.cpp

グラフィカルなファイルマネージャーでファイルをコピーする場合、置き換えのプロンプトは次のような表示になります：

ステップ 2: リモート用ファームウェアをビルドする

Meshtastic ファームウェアのルートから、次を実行します：

pio run -e seeed-xiao-s3

ステップ 3: リモートノードに書き込む

Windows

pio device list
pio run -e seeed-xiao-s3 -t upload --upload-port COMx

手動でダウンロードモードに入る必要がある場合：

1. BOOT を押し続ける
2. RESET をタップする
3. RESET を離す
4. BOOT を離す

macOS

pio device list
pio run -e seeed-xiao-s3 -t upload --upload-port /dev/cu.usbmodemXXXX

最初に pio device list を使用して、正しいシリアルポートを特定します：

書き込みが完了すると、PlatformIO はフラッシュ成功を報告します：

ステップ 4: シリアルログを監視する

PlatformIO のシリアルモニタを使用して、リモートノードと近くのゲートウェイの両方を確認します。

Windows

pio device monitor -p COMx -b 115200
pio device monitor -p COMy -b 115200

macOS

pio device monitor -p /dev/cu.usbmodemE072A1D89EB81 -b 115200
pio device monitor -p /dev/cu.usbmodem3030F917FF281 -b 115200

次のようなログを探します：

Environment telemetry dispatch path=mesh dest=0xffffffff interval_mesh_s=60
Send: relative_humidity=...
Send: ... temperature=...

ステップ 5: Meshtastic CLI で検証する

まず CLI をインストールします：

Windows

pip install meshtastic

macOS

pip3 install meshtastic

インストール後、ターミナルを再度開き、meshtastic --help が動作することを確認します。

以下のコマンドでは、<gateway_port> を実際のゲートウェイのシリアルポートに置き換えてください：

• Windows の例: COMx
• macOS の例: /dev/cu.usbmodem3030F917FF281

meshtastic --port <gateway_port> --listen --debug
meshtastic --port <gateway_port> --nodes --show-fields user.id,user.longName,user.shortName
meshtastic --port <gateway_port> --get bluetooth.enabled --get bluetooth.mode --get bluetooth.fixed_pin --get power.wait_bluetooth_secs --get power.is_power_saving
meshtastic --port <gateway_port> --set network.wifi_enabled false

次の点に注目します：

• TELEMETRY_APP
• environmentMetrics.temperature
• environmentMetrics.relativeHumidity

ステップ 6: モバイルアプリで確認する

書き込み後、Meshtastic モバイルアプリでリモートノードに接続し、環境データが表示されていることを確認します。その後、同じメッシュ上の別のデバイスにアプリを接続し、Nodes ビューを確認して、センサー値がメッシュ経由で受信されていることを確認します。

リモートセンサーノードでは、アプリ内で環境テレメトリ値を直接確認できるはずです：

近くのノードでは、メッシュ経由で転送された後に、同じ値が Nodes ビューに表示されるはずです：

よくある問題

git コマンドが使用できない

• Windows の場合、まず Git が PATH に追加されているか確認します。
• macOS の場合、最初に git --version を実行します。システムから Command Line Tools のインストールを求められたら、指示に従ってください。

python3 または pip3 が使用できない

• Windows の場合、Python が PATH に追加されていることを確認するか、ターミナルを再起動してから再試行してください。
• macOS の場合、まず python3 / pip3 が既に存在するか確認し、必要な場合のみ Homebrew で Python をインストールします。

pio コマンドが使用できない

• まず pio --version を実行します。
• それでもコマンドが使用できない場合は、VS Code とターミナルを再起動してから再試行してください。
• 必要に応じて、PlatformIO 拡張機能を再インストールし、PlatformIO Core が正しく初期化されていることを確認します。

git submodule update --init の後もコードが不完全に見える

• まず、自分が firmware リポジトリのルートディレクトリにいることを確認します。
• ネットワーク接続が不安定な場合は、次のコマンドで再試行します：

git submodule update --init --recursive

最初のビルドに時間がかかりすぎる

• 最初のビルドで多くの依存関係がダウンロードされるのは正常です。
• あまりにも長時間停止しているように見える場合は、先にパッケージを個別にインストールしてみてください：

pio pkg install -e seeed_wio_tracker_L1

その後、再度ビルドを実行します。

Web クライアントに環境テレメトリがすべて表示されない

• Meshtastic Web クライアントは現在、リモート環境テレメトリ用の完全な UI を提供していません。
• Messages / Broadcast ページはチャットトラフィック用であり、専用のテレメトリページではありません。
• 値がそこに表示されなくても、メッシュリンクが失敗していることを自動的に意味するわけではありません。

スマートフォンでデータが見えても、メッシュ転送が行われている証拠にはならない

• 直接接続されたスマートフォンで値が更新されて見えるのは、ローカルのスマートフォンとデバイス間リンクが動作していることだけを示します。
• これは、環境テレメトリがすでにメッシュ内に転送されたことを自動的に証明するものではありません。
• 実際にメッシュ転送が行われたことを確認するには、ログ内で次の項目を確認してください:
• Environment telemetry dispatch path=mesh ...
• TELEMETRY_APP
• environmentMetrics.temperature
• environmentMetrics.relativeHumidity

seeed-xiao-s3 ビルドが初回セットアップ時に失敗する

• 最初の依存関係インストールには長い時間がかかることがあります。これは正常です。
• ターゲット環境が失敗する場合は、まずパッケージをインストールしてから詳細ビルドを実行してください:

pio pkg install -e seeed-xiao-s3
pio run -e seeed-xiao-s3 -v

• 依存関係の準備ができたら、通常のビルドに戻します:

pio run -e seeed-xiao-s3