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 ボタンをダブルクリックして DFU モードに手動で入ります。10〜15 秒後に TRACKER L1 という名前のディスクがポップアップ表示されます。
ダウンロードした UF2 ファイルをポップアップしたディスクにドラッグします。
ファームウェアの書き込みが正常に完了すると、そのディスクは消えます。この時点ではデバイス内にファームウェアがないため、デバイスは自動的には再起動しません。
ファームウェアの書き込み
最新のファームウェアバージョンを選択します。
UF2 ファイルをダウンロードします。
RST ボタンをダブルクリックして DFU モードに手動で入ります。10〜15 秒後に TRACKER L1 という名前のディスクがポップアップ表示されます。
ダウンロードした UF2 ファイルをポップアップしたディスクにドラッグします。
ファームウェアの書き込みが正常に完了すると、そのディスクは消えます。この時点ではデバイス内にファームウェアがないため、デバイスは NOT 自動的には再起動しません。
設定
デバイスの電源を入れる
電源スイッチを上に上げてオンにします。
ボタンを押してもデバイスが反応しない場合は、まず充電してください。急速充電器は使用しないでください。
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 parameter を引き続き設定できます。
GPS の設定
GPS を使用したい場合は、有効に設定してください。
APP の Position Settings に移動して GPS を有効にできます。または、デバイスの GPS ページに移動し、4 方向ジョイスティックを押して GPS をオンまたはオフにすることもできます。
ブザーの設定
ユーザーボタンを3回クリックすると、ブザーのオン／オフを制御できます。
センサーの設定
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
ファームウェア更新の失敗 / OTA 復旧
Wio Tracker L1 がファームウェア更新後に反応しなくなった場合は、次の手順を試してください。
- USB データケーブルでデバイスをコンピュータに接続し、Reset ボタンを2回押して DFU モードに手動で入る ようにします。
- UF2 ドライブが表示されたら、Firmware Flashing ガイドに従って、適切なアプリケーションファームウェアを再インストールします。
- それでもデバイスを復旧できず、DFU シリアルポートが利用可能な場合は、Device Bricked & Bootloader Recovery に従い、その後アプリケーションファームウェアを再インストールします。
デバイスが DFU モードに入れない、またはコンピュータに認識されない場合は、テクニカルサポートにお問い合わせください。
デバイスがブリックした & ブートローダー復旧
説明：
デバイスが反応せず、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 を 2 回押します（黄色の LED が点灯し続けます）。ステップ 3 と同様に DFU シリアルポートを探し、そのポートに対してステップ 5 のコマンドを --touch 1200 なしで実行します。成功時の表示はステップ 6 と同じです。
DFU モードに入れない & 手動で DFU モードに入る
デバイスを PC に接続し、Reset ボタンを 2 回押します — 黄色の 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 用のアンテナ交換が必要な場合は、click here から入手できます。
リソース
- ブートローダー（シリアル DFU パッケージ）
- (V1) 3D プリント参照ファイル
- (V2 新しい 4 方向ジョイスティック) 3D プリント参照ファイル
- L1 エンクロージャーデザインチャレンジ
- 外形ファイル
- TELEC 認証
- FCC 認証
- CE 認証
- 消費電力テストおよびバッテリー寿命計算
技術サポート & 製品ディスカッション
