MeshCore を使い始める
ファームウェアの書き込み
方法1 Web Flasher 経由
USB ケーブルでデバイスをコンピュータに接続します。ケーブルがデータ通信に対応していることを確認してください。
データ転送中は USB ケーブルを抜かないでください。そうしないとデバイスが破損する可能性があります。
Meshcore Web Flasher にアクセスします。
Community Firmware グループで Seeed Studio Wio Tracker L1 Pro を選択します。
Companion Bluetooth を選択します。Bluetooth Companion ファームウェアを書き込んだデバイスは APP に接続できます。その他のファームウェアを書き込みたい場合は、click here をクリックしてチュートリアルを参照してください。
Flash 消去
Enter DFU Mode をクリックし、「L1 Pro」または「TinyUSB serial」という名前のシリアルポートを選択します。その後、Erase Flash をクリックしてシリアルポートを選択します。
Erase Flash をクリックしても反応がない場合は、Enter DFU をもう一度クリックしてから Erase Flash をクリックし、DFU モードに正常に入っていることを確認してください。
"Flashing erase firmware:100%" と表示されれば、デバイスの消去は正常に完了しています。
ファームウェアの書き込み
Enter DFU Mode をクリックし、「L1 Pro」または「TinyUSB」 serial という名前のシリアルポートを選択します。その後、Flash をクリックしてシリアルポートを選択します。
Flash をクリックしても反応がない場合は、Enter DFU をもう一度クリックしてから Flash をクリックし、DFU モードに正常に入っていることを確認してください。
進行バーが最後まで埋まれば、Flash が完了したことを示します。その後、デバイスは自動的に再起動します。
方法2 ドラッグ＆ドロップ
USB ケーブルでデバイスをコンピュータに接続します。ケーブルがデータ通信に対応していることを確認してください。
データ転送中は USB ケーブルを抜かないでください。そうしないとデバイスが破損する可能性があります。
Meshcore Web Flasher にアクセスします。
Community Firmware グループで Seeed Studio Wio Tracker L1 Pro を選択します。
Companion Bluetooth を選択します。Bluetooth Companion ファームウェアを書き込んだデバイスは APP に接続できます。その他のファームウェアを書き込みたい場合は、click here をクリックしてチュートリアルを参照してください。
Flash 消去
UF2 ファイルをダウンロードします。
RST ボタンを 2 回クリックして DFU モードに手動で入ります。10〜15 秒後に TRACKER L1 という名前のディスクがポップアップ表示されます。
ダウンロードした UF2 ファイルをポップアップしたディスクにドラッグします。
ファームウェアの書き込みが正常に完了するとディスクは消えます。この時点ではデバイス内にファームウェアがないため、デバイスは自動的には再起動しません。
ファームウェアの書き込み
最新のファームウェアバージョンを選択します。
UF2 ファイルをダウンロードします。
RST ボタンを 2 回クリックして DFU モードに手動で入ります。10〜15 秒後に TRACKER L1 という名前のディスクがポップアップ表示されます。
ダウンロードした UF2 ファイルをポップアップしたディスクにドラッグします。
ファームウェアの書き込みが正常に完了するとディスクは消えます。この時点ではデバイス内にファームウェアがないため、デバイスは自動的には再起動しません。
設定
デバイスの電源を入れる
電源スイッチを上に上げてオンにします。
ボタンを押してもデバイスが反応しない場合は、まず充電してください。急速充電器は使用しないでください。
APP を入手
Google Store または Apple Store からダウンロードします。または click here をクリックして Meshcore APP を入手します。
アプリ経由で接続
Connect をクリックし、対象デバイスを選択します。デフォルトのデバイス ID は Meshcore-MAC Address です。MAC アドレスはデバイス底面のラベルで確認できます。
デバイス画面に表示されている PIN コードを入力し、Pair をクリックしてデバイスに接続します。
接続に失敗する場合は、スマートフォンの Bluetooth リストを開き、そのデバイスを forget または Unpair してから、再度接続をお試しください。
Web インターフェース経由で接続（BLE）
- MeshCore Web App を開き、Settings アイコンをクリックします。
- BLE タブを選択し、Scan Now をクリックします。
- システムの Bluetooth ポップアップでデバイス（例：MeshCore-xxxxxx）を選択し、Pair をクリックします。
- プロンプトが表示されたら、デバイス画面に表示されている Bluetooth パスキーを入力し、OK をクリックします。このパスキーは
123456ではありません。
- ステータスが接続済みに変わり、MeshCore インターフェースにノードが表示されるまで待ちます。
LoRa の設定
メッシュ通信を開始するには、リージョンを設定する必要があります。この設定はデバイスが使用する周波数帯を制御し、お住まいの地域に合わせて設定する必要があります。
その後、デバイスを再起動してください。再起動しないと設定は有効になりません。
リージョン一覧
| Region Code | Description | Frequency Range (MHz) | Duty Cycle (%) | Power Limit (dBm) |
|---|---|---|---|---|
| UNSET | 未設定 | N/A | N/A | N/A |
| US | アメリカ合衆国 | 902.0 - 928.0 | 100 | 30 |
| EU_868 | 欧州連合 868 MHz | 869.4 - 869.65 | 10 | 27 |
これでデバイスの LoRa リージョンが設定されたので、必要に応じて任意のLoRa パラメータを引き続き設定できます。
GPS の設定
GPS を使用したい場合は、有効に設定してください。
APP の Position Settings に移動して GPS を有効にできます。または、デバイスの GPS ページに移動し、4 方向ジョイスティックを押して GPS をオンまたはオフにすることもできます。
ブザーの設定
ユーザーボタンを4回押すと、ブザーのオン／オフを制御できます。
センサーの設定
Wio Tracker L1 には、出荷時に MeshCore ファームウェア 1.12 がプリインストールされています。内蔵 Grove コネクタ経由の Grove センサー対応はファームウェア 1.13 で追加されており、最新リリースは 1.16 です。
Grove センサーには、ファームウェア 1.13 以降が必要です。デバイスがまだ工場出荷時の 1.12 のままの場合は、Method1 via Web Flasher に従い、最新バージョンを選択してください。
1.13 以降では、L1 の内蔵 Grove コネクタを通じて、温度、湿度、空気質などの環境センサーを、はんだ付けや追加ハードウェアなしで簡単に統合できるようになります。対応する Grove センサーをコネクタに接続すると、自動的に認識されます。
メッセージ送信
対応デバイスを2台持っていて、近くに MeshCore ユーザーがあまりいない場合は、両方を BLE Companion ファームウェアに書き換えることで、近くの友人や家族との通信に自分のデバイスを利用できます。
アドバタイズ
MeshCore では、自分の名前、位置情報、および公開暗号鍵を手動でブロードキャストできます。これらはなりすまし防止のために署名もされています。アドバタイズボタンをクリックすると、そのデータが LoRa 経由でブロードキャストされます。MeshCore ではこれを Advert と呼びます。アドバタイズには「ゼロホップ」と「フラッド」の2つの方法があります。
- ゼロホップ は、自分のアドバタイズが届く範囲の相手にだけ送信され、それで終了することを意味します。
- フラッド は、一度送信された後、それを受信したすべてのリピーターによって再送信されることを意味します。
アドバタイズはアプリから送信できます。また、デバイスのアドバタイズページから直接送信することもできます。
公開メッセージ
LoRa を設定した後は、プライマリチャンネルでメッセージを送信できます。同じ周波数帯にいる近くの人は全員、そのメッセージを受信します。
プライベートメッセージ
2台のデバイスは、お互いのアドバタイズを両方とも受信したときにのみ接続を確立します。
FAQ
デバイスがブリックした場合とブートローダーの復旧
説明：
デバイスが反応せず、LED も点灯せず、アプリとペアリングできません。独自ファームウェアを書き込んだ後にデバイスが完全に動作しなくなった場合は、ブートローダーの再インストールも試すことができます。
ブートローダーは、adafruit-nrfutil を使用して USB シリアルポート（Serial DFU）経由で復旧します。
書き込み中はケーブル接続を安定させ、シリアルポート番号が変わったとしても 絶対に 取り外さないでください。
ステップ 1：準備
- Wio Tracker L1 シリーズデバイス（L1 / L1 Pro）
- 動作確認済みの USB データケーブル（充電専用ケーブルは不可）
- Python 3 と pip がインストールされた Windows / macOS / Linux PC
- ブートローダーパッケージ：Click here to download Bootloader — ZIP は展開せず、そのまま
adafruit-nrfutilで使用します
ステップ 2：adafruit-nrfutil をインストール
- Windows
- macOS
- Linux
Python 3 と pip が利用可能か確認します（pip がない場合は、先に python -m ensurepip --upgrade を実行してください）：
python --version
python -m pip --version
次にインストールと確認を行います（このガイドでテストしたバージョンは 0.5.3.post16 です）：
python -m pip install --user adafruit-nrfutil
adafruit-nrfutil version
python3 --version
python3 -m pip install --user adafruit-nrfutil
adafruit-nrfutil version
pip がない場合は、先に python3 -m ensurepip --upgrade を実行してください。
pipx を使って adafruit-nrfutil をインストールします：
sudo apt install pipx
pipx install adafruit-nrfutil
pipx ensurepath
Fedora では、apt の代わりに sudo dnf install pipx を使用します。ターミナルを開き直してから、次を確認します：
adafruit-nrfutil version
常に adafruit-nrfutil version でバージョンを確認してください。adafruit-nrfutil --version は使用しないでください。
ステップ 3：シリアルポートを確認
デバイスのシリアルポートを確認します — 以下の例は PC によって異なります：
- Windows
- macOS
- Linux
デバイス マネージャー → ポート (COM と LPT) を開きます。例：
USB Serial Device (COM43)
ls /dev/cu.*
デバイスは /dev/cu.usbmodemXXXX として表示されます。
ls /dev/ttyACM*
デバイスは通常 /dev/ttyACM0 として表示されます。何も表示されない場合は、ls /dev/ttyUSB* も試してください。
ステップ 4：ブートローダーを書き込む
ステップ 3 で確認したポートに置き換えます：
- Windows
- macOS
- Linux
adafruit-nrfutil --verbose dfu serial --package "wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip" -p COM43 -b 115200 --singlebank --touch 1200
ZIP がターミナルのカレントフォルダにない場合は、--package に ZIP のフルパスを指定します。例："C:\path\to\wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip"。
adafruit-nrfutil --verbose dfu serial --package "wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip" -p /dev/cu.usbmodemXXXX -b 115200 --singlebank --touch 1200
adafruit-nrfutil --verbose dfu serial --package "wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip" -p /dev/ttyACM0 -b 115200 --singlebank --touch 1200
ステップ 5：シリアルポートの変更に対応する
--touch 1200 はデバイスを DFU モードで再起動させるため、通常シリアルポートが変わり、最初のコマンドは次のようなトレースバックで停止することがあります：
Touched serial port COM43
...
FileNotFoundError: could not open port 'COM43'
これは失敗ではありません — デバイスはすでに新しいポートで DFU モードに入っています。テストした Windows PC では、例えば COM43 から COM45 に変わりました：
USB ケーブルは接続したままにしてください。 新しいポートを探し（デバイス マネージャー → ポート (COM と LPT) を更新するか、ls /dev/cu.* / ls /dev/ttyACM* を再実行します）、--touch 1200 なしで新しいポートに対して再度書き込みを行います：
- Windows
- macOS
- Linux
adafruit-nrfutil --verbose dfu serial --package "wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip" -p COM45 -b 115200 --singlebank
adafruit-nrfutil --verbose dfu serial --package "wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip" -p /dev/cu.usbmodemXXXX -b 115200 --singlebank
adafruit-nrfutil --verbose dfu serial --package "wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip" -p /dev/ttyACM0 -b 115200 --singlebank
ステップ 6：結果を確認する
出力の最後が Device programmed. で終わっていれば、書き込みは成功です：
その後、PC 上に UF2 ドライブが表示されます（スクリーンショットはテストした Windows PC のものです）。ボリュームラベルはブートローダービルドによって異なり、テストしたユニットでは XIAO-BOOT と表示されましたが、これは合否の基準ではありません。ドライブ名や INFO_UF2.TXT の内容で結果を判断しないでください。
ステップ 7：アプリケーションファームウェアを再インストールする
ブートローダーを復旧しても、アプリケーションファームウェアは再インストールされません — 再度ファームウェアを書き込むまで、デバイスには動作するファームウェアがありません。
上記の手順を完了したら、Firmware Flashing に従ってアプリケーションファームウェアを書き込んでください。
トラブルシューティング
- インストール後に
adafruit-nrfutilが認識されない：Python のユーザースクリプトディレクトリを PATH に追加します（Windows ではScripts、macOS ではホームディレクトリ配下のbin）。Linux では、pipx ensurepathの後にターミナルを開き直してください。 - ポートがビジー／アクセス拒否：シリアルモニタ、Web フラッシャーのタブ、Arduino IDE など、そのポートを使用しているものをすべて閉じてください。
Touched serial port ...の後にFileNotFoundError: could not open port ...が出る：デバイスが新しいポートで DFU モードに入っています — ステップ 5 に従ってください。- DFU モードに入れない：Unable to enter DFU & Entering DFU Mode Manually を参照してください。
手動 DFU 復旧
もし --touch 1200 でデバイスをDFUモードに入れられない場合（例：ファームウェアがまったく反応しない場合）、手動でDFUモードに入ります：デバイスを接続し、Reset をダブルクリックします（黄色のLEDが点灯したままになります）、ステップ3と同様にDFUシリアルポートを探し、そのポートに対して --touch 1200 なしでステップ5のコマンドを実行します。成功時の表示はステップ6と同じです。
DFUモードに入れない場合 & 手動でDFUモードに入る方法
デバイスをPCに接続し、Reset ボタンをダブルクリックします — 黄色のLEDが点灯したままになり、PC上にDFUシリアルポートが表示されます。
このモードでブートローダを書き込むには、Device Bricked & Bootloader Recovery に従いますが、--touch 1200 は省略します — デバイスはすでにDFUモードになっています。
DFUモードの終了
DFUモードを終了するには、Reset ボタンを1回押します。
デバイスが自動的に電源オフになる
説明
- デバイスの電源を入れた後、しばらくすると自動的に電源が切れる、または再起動します。
- シリアルポートログがしばらく動作した後に停止します。
これは、デバイスが次の状態にあるときに、手動で強制的に再起動または電源オフしたことが原因の可能性があります：メッセージ送信プロセスが完了していない、設定中である……
トラブルシューティング
Flash Erase でファームウェアを消去します
工場出荷時リセット
デフォルト設定に戻したい場合は、工場出荷時リセットを実行できます。工場出荷時リセットを行う方法は2つあります。
-
Flash Erase でファームウェアを消去します
-
アプリで
Factory Resetボタンをクリックします。デバイスは工場出荷時の設定で自動的に再起動します。
信号品質
-
SNR は通信リンクの品質を反映します。通常のデバイスは、一般的に -7 dB より高い値で動作します。SNR が -10 dB 未満のデバイスは、性能が低いことを示します。
-
RSSI は、デバイスとその周囲の環境の両方によって決まります。通常のデバイスは、一般的に -110 dBm より高い値で動作します。RSSI が -115 dBm 未満のデバイスは、性能が低いと見なされます。
最良の信号効果を得るために、干渉が最小限で、開けていて障害物のない場所でデバイスを使用してください。
互換アンテナ
L1 Pro 用のアンテナ交換が必要な場合は、こちらをクリックして入手してください。
リソース
- ブートローダ（Serial DFU パッケージ）
- (V1) 3Dプリント参照ファイル
- (V2 新しい4方向ジョイスティック) 3Dプリント参照ファイル
- L1 エンクロージャーデザインチャレンジ
- 外形ファイル
- TELEC 認証
- FCC 認証
- CE 認証
- 消費電力テストおよびバッテリー寿命計算
技術サポート & 製品ディスカッション
