メインコンテンツまでスキップ

Meshtastic を使い始める

ヒント

Wio Tracker L1 シリーズは同じハードウェアフレームワークを共有しています。動画ガイドは L1 Pro 向けですが、L1 シリーズの他のすべての製品にも適用できます。

ビデオチュートリアル​

パート 1 開封​

L1、L1 Lite、L1 E-Ink モデルを初めて使用する場合は、USB 電源に接続した後、電源スイッチを上に持ち上げて電源を入れてください。

パート 2 ファームウェア書き込み​

note

ファームウェアの更新には don't use NRF-OTA を使用しないでください。デバイスが完全に動作不能になる可能性があります。

パート 3 デバイスの使用方法​

4 方向ジョイスティック​

L1 E-Ink ファームウェアの latest Alpha firmware は現在、4 方向ジョイスティックをサポートしています。ジョイスティックを使用したい場合は、ここをクリックしてファームウェアをアップグレードしてください。

メニューバー​

pir

メニューバーをサポートしているのは 2.7 ファームウェアのみです。メニューバーを使用したい場合は、Flash Firmware Tutorial に従ってファームウェアを更新してください。

pir

ブザー​

ブザーをオンまたはオフにしたい場合は、まずファームウェアをバージョン 2.7 に update the firmware してください。メニューバーがあるのは 2.7 バージョンのファームウェアのみだからです。

  • ブザーをオンにする Setting（歯車の形をしたアイコン） -> Notification -> Buzzer Action -> Disable
  • ブザーをオフにする Setting（歯車の形をしたアイコン） -> Notification -> Buzzer Action -> All enabled

パート 4 スマートフォン接続​

パート 5 各種ステータス​

はじめに​

note

デバイスが以下の状態にあるときは、手動で再起動したり電源を切ったりしないでください。そうしないとデバイスが故障する可能性があります。

  1. メッセージ送信プロセスが完了していない
  2. 設定中

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

note

ファームウェアの更新には don't use NRF-OTA を使用しないでください。デバイスが完全に動作不能になる可能性があります。

Meshtastic Web Flasher にアクセスします。

L1、L1 Lite、L1 Pro の場合は、ターゲットデバイスとして Seeed Wio Tracker L1 を選択し、最新のファームウェアを選んでから Flash をクリックします。

pir

pir

L1 E-Ink の場合は、ターゲットデバイスとして Seeed Wio Tracker L1 E-Ink を選択し、最新のファームウェアを選んでから Flash をクリックします。

pir

pir

デバイスの電源を入れ、Enter DFU Mode をクリックします。Tracker L1 という名前のシリアルポートが表示されるので、それをクリックして接続します。Tracker L1 という名前のドライブが表示されるはずです。

pir

UF2 ファイルを DFU ドライブにドラッグします。ファイルのコピー完了後、デバイスが再起動するとファームウェアの書き込みが完了します。

デバイスの電源を入れる​

USB ケーブルを接続してデバイスを起動します。電源スイッチを上に持ち上げて電源を入れてください。

ヒント

ボタンを押してもデバイスが反応しない場合は、まず充電してください。急速充電器は使用しないでください。

アプリ経由で接続する​

  • Bluetooth パネルでターゲットデバイスを選択します。

pir

  • ディスプレイに表示されているコードを入力し、OK をクリックしてデバイスに接続します。

pir

LoRa を設定する​

メッシュ上で通信を開始するには、まずリージョンを設定する必要があります。この設定はデバイスが使用する周波数帯域を制御し、自分がいる地域に合わせて設定する必要があります。

pir

リージョン一覧

Region CodeDescriptionFrequency Range (MHz)Duty Cycle (%)Power Limit (dBm)
UNSET未設定N/AN/AN/A
USアメリカ合衆国902.0 - 928.010030
EU_868欧州連合 868MHz869.4 - 869.651027

より包括的な一覧については、LoRa Region by Country を参照してください。

備考

EU_868 は、1 時間あたり 10% のデューティサイクル制限を順守する必要があり、ローリング 1 時間ベースで毎分計算されます。この制限に達すると、再び許可されるまでデバイスは送信を停止します。

これでデバイスの LoRa リージョンを設定できたので、自分の用途に合わせて任意の LoRa Configs を続けて設定できます。

詳細設定​

Web サイト経由で接続する​

Web サイト上でメッセージを送信し、他のノードと通信したい場合は、デバイスを Meshtastic Website に接続できます。

ステップ 1: Web サイトを開く

Click here をクリックして Web サイトに移動します。

pir

ステップ 2: 新しいデバイスを追加する

"+ New Connection" をクリックします。

pir

接続方法は 2 通りあります。好みの方法を選択できます。

方法 1: Bluetooth 経由

bluetooth 方法を選択します。ポップアップウィンドウでデバイス ID を選択します。

pir

方法 2: シリアル経由

serial 方法を選択します。デバイスマネージャーを開き、デバイスがどのポートに接続されているかを確認します。ポップアップウィンドウでそのポートを選択します。

pir

デバイスがリストに表示されます。クリックして接続します。接続に成功すると、ウェブサイト上でデバイスのステータスを直接確認できます。

pir

GPS の設定​

GPS を有効に設定してください。より最新の位置情報を取得するために、更新間隔とブロードキャスト間隔を調整できます。

pir

IOS の場合は、Accurate Location をオンにしてください。そうしないと、位置がずれる可能性があります。

pir

センサー接続​

pir

Grove インターフェースを介してデバイスにセンサーを追加できます。以下のセンサーは、デバイス上の Grove インターフェースとの互換性が確認されています。

センサータイプセンサーモデル
環境センサー気圧BMP085
温度MCP9808 、PCT2075
温度 & 湿度SHT31/SHTC3/SHT4X、AHT10
温度 & 湿度 & 気圧BME280
その他心拍数 & SpO₂MAX30102
I2C キーボードCardKB
  • Telemetry を有効にしてセンサーデータを取得します。OLED 画面にセンサーデータを表示したい場合は、on screen を有効にします

pir

on screen を有効にすると、OLED にセンサーデータが表示されます。

pir

画面接続​

  • E-Ink スクリーン 互換性のある E-Ink スクリーンを入手するには、Click here をクリックしてください。

pir

  • OLED スクリーン Click here をクリックして、互換性のある OLED スクリーンを入手してください。現在の OLED ドライバは SSD1306 です。

pir

バーチャルキーボード​

pir

バージョン 2.7 のファームウェアではバーチャルキーボードがサポートされました！デバイス上で直接メッセージを入力して、他のデバイスと通信できます。ファームウェアを更新するには、Flash Firmware Tutorial に従ってください。

pir

着信音の設定​

Settings -> Ringtone Config に移動し、外部通知に使用したい RTTTL 着信音文字列を入力します。

pir

24:d=16,o=5,b=120:g,c6,d6,2g6

FAQ​

ファームウェア更新の失敗 / OTA 復旧​

NRF-OTA ファームウェア更新後に Wio Tracker L1 が反応しなくなった場合は、次のことを試してください。

  1. USB データケーブルでデバイスをコンピュータに接続し、Reset ボタンを 2 回押して手動で DFU モードに入ります。
  2. UF2 ドライブが表示されたら、Flash Firmware ガイドに従って、適切なアプリケーションファームウェアを再インストールします。
  3. それでもデバイスを復旧できず DFU シリアルポートが利用可能な場合は、デバイスがブリックした場合 & ブートローダーの復旧 に従い、その後アプリケーションファームウェアを再インストールします。

デバイスが DFU モードに入れない、またはコンピュータに認識されない場合は、テクニカルサポートにお問い合わせください。

デバイスがブリックした場合 & ブートローダーの復旧​

説明：

デバイスが反応せず、LED も点灯せず、アプリとペアリングできません。独自のファームウェアを書き込んだ後にデバイスが完全に動作しなくなった場合は、ブートローダーの再インストールも試すことができます。

ブートローダーは、adafruit-nrfutil を使用して USB シリアルポート（Serial DFU）経由で復元します。

note

書き込み中は、ケーブル接続を安定させ、シリアルポート番号が変わったとしても 絶対に 取り外さないでください。

ステップ 1：準備

  • Wio Tracker L1 シリーズデバイス（L1 / L1 Pro）
  • 動作確認済みの USB データケーブル（充電専用ケーブルは不可）
  • Python 3 と pip がインストールされた Windows、macOS または Linux PC
  • ブートローダーパッケージ：Click here to download Bootloader — ZIP を展開しないでください。adafruit-nrfutil は ZIP のまま使用します

ステップ 2：adafruit-nrfutil をインストール

Python 3 と pip が利用可能か確認します（pip がない場合は、先に python -m ensurepip --upgrade を実行します）。

python --version
python -m pip --version

Check Python and pip on Windows

次にインストールして確認します（このガイドでテストしたバージョンは 0.5.3.post16 です）。

python -m pip install --user adafruit-nrfutil
adafruit-nrfutil version

adafruit-nrfutil version output on Windows

注記

常に adafruit-nrfutil version でバージョンを確認してください。adafruit-nrfutil --version は使用しないでください。

ステップ 3：シリアルポートを確認

デバイスのシリアルポートを確認します — 以下の例は PC によって異なります。

デバイス マネージャー → ポート (COM と LPT) を開きます。例：

USB Serial Device (COM43)

Wio Tracker L1 serial port in Windows Device Manager

ステップ 4: ブートローダを書き込む

ステップ 3 で見つけたポートに置き換えてください：

デバイスに接続しているシリアルモニタやブラウザフラッシャをすべて閉じてください。すでに Reset を 2 回押して DFU モードに入っている場合は、現在の DFU ポートを使用し、以下のコマンドから --touch 1200 を省略します。

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 にそのフルパスを指定します。例: "C:\path\to\wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip"。

ステップ 5: シリアルポートの変更に対応する

--touch 1200 は、シリアルポートを 1200 ボーで開閉することで DFU モードを要求します。その後、OS が別のポートを割り当てる場合があり、最初のコマンドが次のようなトレースバックで停止することがあります：

Touched serial port COM43
...
FileNotFoundError: could not open port 'COM43'

再試行する前に、新しい DFU ポートが現れていないか確認してください。このエラーだけでは、デバイスが DFU モードに入ったことや、ブートローダが正常に書き込まれたことは確認できません。テストした Windows PC では、ポートが COM43 から COM45 に変わりました：

Windows のデバイスマネージャで再列挙後に表示される DFU シリアルポート

USB ケーブルは接続したままにしてください。 新しいポートを探し（デバイスマネージャ → ポート (COM と LPT) を更新するか、ls /dev/cu.* / ls /dev/ttyACM* を再実行します）、その新しいポートに対して --touch 1200 なしで再度フラッシュします：

adafruit-nrfutil --verbose dfu serial --package "wio_tracker_l1_bootloader-0.10.0_s140_7.3.0.zip" -p COM45 -b 115200 --singlebank

ステップ 6: 結果を確認する

出力の最後が Device programmed. で終わっていれば、書き込みは成功しています：

Device programmed で終わる adafruit-nrfutil の出力

その後、PC 上に UF2 ドライブが表示されます（スクリーンショットはテストした Windows PC のものです）。ボリュームラベルはブートローダビルドによって異なります（テストした個体では XIAO-BOOT と表示されました）が、これは合否判定の基準ではありません。ドライブ名や INFO_UF2.TXT で結果を判断しないでください：

ブートローダ書き込み後に表示される UF2 ドライブ

ステップ 7: アプリケーションファームウェアを再インストールする

警告

ブートローダを復元しても、アプリケーションファームウェアは再インストールされません — 再度ファームウェアを書き込むまで、デバイスには動作するファームウェアがありません。

上記の手順を完了したら、Flash Firmware に従ってアプリケーションファームウェアを書き込んでください。

トラブルシューティング

  • インストール後に adafruit-nrfutil が認識されない：Python のユーザースクリプトディレクトリを PATH に追加します（Windows では Scripts、macOS ではホームディレクトリ配下の bin）。Linux では、pipx ensurepath の後にターミナルを開き直してください。
  • ポートがビジー / アクセス拒否：シリアルモニタ、Web フラッシャのタブ、Arduino IDE など、そのポートを使用しているものをすべて閉じてください。Linux では、ステップ 3 で説明したようにシリアルポートのパーミッションとグループ所属も確認してください。
  • Touched serial port ... の後に FileNotFoundError: could not open port ... が表示される：新しい DFU ポートが現れていないか確認し、ステップ 5 に従ってください。DFU ポートが現れない場合は、以下の手動 DFU 復旧を試してください。
  • DFU モードに入れない：Unable to enter DFU & Entering DFU Mode Manually を参照してください。

手動 DFU 復旧

ファームウェアが完全に応答しないなどの理由で --touch 1200 でデバイスを DFU モードにできない場合は、手動で DFU モードに入ります。デバイスを接続し、Reset を 2 回押します（黄色の LED が点灯し続けます）。ステップ 3 と同様に DFU シリアルポートを探し、そのポートに対して --touch 1200 なしでステップ 5 のコマンドを実行します。成功時の見た目はステップ 6 と同じです。

DFU モードに入れない & 手動で DFU モードに入る​

デバイスを PC に接続し、Reset ボタンを 2 回押します。黄色の LED が点灯し続け、PC 上に DFU シリアルポートが表示されます。

このモードでブートローダを書き込むには、Device Bricked & Bootloader Recovery に従いますが、--touch 1200 は省略してください — デバイスはすでに DFU モードに入っています。

DFU モードの終了​

DFU モードを終了するには、Reset ボタンを 1 回押します。

プライマリチャンネルで通信できない​

デバイスが近くのノードと通信できない、またはメッセージを送信できない場合は、まず LoRa リージョンとモデムプリセットが周囲のノードと一致しているか確認してください。デフォルトの PSK が変更されていないかも確認する必要があります。プライマリチャンネルで PSK が異なると、そのチャンネル上の他のノードと通信できなくなります。

この問題を見つける最も簡単な方法はモバイルアプリを使うことです。アプリを開き、対象デバイスに接続してから、Settings -> Channels に移動します。プライマリチャンネルを選択し、PSK の値を確認します。周囲のノードと異なる場合は、同じ PSK に更新してチャンネル設定を保存してください。

iOS アプリでプライマリチャンネルの PSK を確認する

解決方法

どの設定が変更されたか分からない場合は、Factory Reset ガイドに従って、デバイスをデフォルト設定に復元してください。PSK だけが変更された場合は、AQ== に戻してください。

デバイスが自動的に電源オフになる​

説明​

  • デバイスの電源を入れた後、しばらくすると自動的に電源が切れる、または再起動します。
  • シリアルポートログがしばらく動作した後に停止します。

これは、メッセージ送信処理が完了していない、設定中であるなど、デバイスが次の状態にあるときに、手動で強制的に再起動または電源オフしたことが原因の可能性があります。

トラブルシュート​

click here をクリックして動画を確認してください。フラッシュの消去を実行し、その後最新のファームウェアを書き込み直す必要があります。

Factory Reset​

デフォルト設定に戻したい場合は、Factory Reset を実行できます。Factory Reset を行う方法は 2 つあります。

  • click here をクリックして動画を確認してください。フラッシュの消去を実行し、その後最新のファームウェアを書き込み直す必要があります。

  • アプリで Factory Reset ボタンをクリックします。デバイスは工場出荷時の設定で自動的に再起動します。

    pir

ダイレクトメッセージが失敗する​

NodeDB のリセット​

NodeDB は、現在の Mesh ネットワークで検出されたノードに関する情報を保存するローカルデータベースです。特定のノードと通信できない状況に遭遇した場合、そのノードに対して NodeDB に古い情報が保存されている可能性があります。更新する必要があります。

アプリを開いて対象デバイスに接続します。Settings->Device->Device Config->Reset NodeDB に進みます。

アプリ内のデバイス設定と Reset NodeDB ボタン

ユーザー情報の交換​

各ノードは自分自身のノード情報を定期的に送信し、メッシュ内の他のノードがそれを「見て」「認識」できるようにします。2つのノードが互いに通信できるようにするには、互いのノード情報を交換する必要があります。リスト内の別のノードとプライベートメッセージの送受信ができない場合は、アプリで手動で情報交換を促すことができます。

Device entry in Settings

秘密鍵の再生成​

各ノードは公開鍵/秘密鍵ペアを所有しています。暗号化されたプライベートメッセージを交換するには、送信者は受信者の公開鍵でメッセージを暗号化し、その受信者の秘密鍵だけが復号できます。2つのノードは互いの公開鍵を知ることで、プライベートに通信できるようになります。あるノードがプライベートメッセージの送信に繰り返し失敗する場合は、そのノードの秘密鍵を再生成してみてください。再生成後は、他のデバイスのノードリストからそのノードを削除し、再接続して新しい公開鍵を取得できるようにします。

Device entry in Settings

不具合のあるデバイスを再起動して、設定を有効にしてください。

注記

鍵を再生成した後は、他のデバイスがそのノードと再接続する必要があります。そのため、他のデバイスのノードリストからそのノードを削除しておくことをお勧めします。

信号品質​

  • SNR は通信リンクの品質を反映します。通常のデバイスは -7 dB 以上で動作します。SNR が -10 dB 未満のデバイスは性能が低いことを示します。

  • RSSI はデバイスとその周囲の環境の両方によって決まります。通常のデバイスは -110 dBm 以上で動作します。RSSI が -115 dBm 未満のデバイスは性能が低いと見なされます。

    最良の信号状態を得るために、開けた障害物の少ない場所で、干渉が最小限となる環境でデバイスを使用してください。

対応アンテナ​

L1 Pro 用にアンテナの交換が必要な場合は、click here から入手できます。

リソース​

技術サポート & 製品ディスカッション​

Loading Comments...