オーディオ開発
オーディオ開発の境界を理解する
マイクとスピーカーにより、デバイスは音声を取得して再生できます。音声メッセージを別のデバイスに送信するには、十分な無線エアタイムも必要です。
| ユースケース | 原理 | 開発の境界 |
|---|---|---|
| 音楽や録音ファイルを再生する | ローカルオーディオ LoRa を必要としない | ✅ |
| ボイスメモを録音する | ローカルオーディオ LoRa を必要としない | ✅ |
| ローカル音声制御を開発する | デバイス上での認識とローカルアクション カスタムファームウェア実装が必要 | ✅ |
| MeshCore 経由で短い音声クリップを送信する | オーディオトラフィックが共有チャネルを飽和させ、緊急メッセージをブロックする可能性がある | ❌ |
| 連続した音声通話やトランシーバーのようなストリーミング | オーディオトラフィックが共有チャネルを飽和させ、緊急メッセージをブロックする可能性がある | ❌ |
オーディオ開発がサポートされる範囲
L2 Pro 上でのオーディオ開発は現在、ローカルでの処理、保存、および再生に限定されています。サポートされる開発方向は次のとおりです。
- ローカル音声制御: デバイス上でコマンドを認識し、それを用いてローカルアクションをトリガーする
- オーディオ録音と保存: マイク入力を取得し、録音を microSD に保存する。
- オーディオ再生: 音楽や録音したボイスメモを再生する。
- ローカル通知音: テキストメッセージや他のイベントが到着したときに、LoRa 経由でサウンドファイルを送信することなく、ローカルに保存されたサウンドを再生する。
MeshCore ネットワーク経由でのボイスメッセージ伝送は、この L2 Pro オーディオ開発ワークフローではサポートされていません。
LoRa メッシュノードは限られた無線エアタイムを共有します。オーディオ転送はチャネルを長時間占有する可能性があり、中継や再送がさらに負荷を増やします。これにより深刻な輻輳が発生し、メッシュ通信が停止状態に陥ることで、緊急メッセージがチャネルにアクセスできなかったり、時間内に到達しなくなったりするおそれがあります。
オーディオの取得、音声処理、保存、および再生はデバイス上に留めてください。メッシュネットワーク上でオーディオペイロードを送信しないでください。
ローカルオーディオ開発のヒント
カスタムのローカルオーディオアプリケーションを作成する場合、次の点を計画してください。
- 入力と出力: マイクとスピーカーの経路を個別に検証し、マイクゲインと再生音量を含めて確認する。
- ローカル音声認識: ESP32-S3 の処理能力とメモリ予算に適合する、デバイス上で動作する認識エンジンを選択する。
- ストレージ: 利用可能な microSD 容量に収まるサンプル形式と録音時間を選択し、カード容量が一杯になった場合や書き込み失敗時の処理を行う。
- タスクスケジューリング: オーディオ処理やファイルアクセスが、メッシュパケット処理やタッチスクリーンインターフェースをブロックしないようにする。
L2 Pro におけるハードウェア基盤
オーディオ信号経路
L2 Pro のオーディオサブシステムは、I2S インターフェース、コーデック回路、マイク経路を使用します。

オーディオピンマッピング
| インターフェース | ボード信号 | ESP32-S3 GPIO | 用途 |
|---|---|---|---|
| I2S | CODEC_I2S0_MCLK | GPIO10 | マスタークロック |
| I2S | CODEC_I2S0_SCLK | GPIO11 | ビットクロック(BCLK とも呼ばれる) |
| I2S | CODEC_I2S0_LRCK | GPIO12 | ワードセレクト/フレームクロック(WS とも呼ばれる) |
| I2S | CODEC_I2S0_DSDIN | GPIO16 | ESP32-S3 TX → コーデックデータ入力;再生 |
| I2S | CODEC_I2S0_SDOUT | GPIO15 | オーディオデータ出力 → ESP32-S3 RX;録音 |
| I²C | IIC0_SDA | GPIO47 | 周辺機器設定データ |
| I²C | IIC0_SCL | GPIO48 | 周辺機器設定クロック |
L2 Pro に Cairn をインストールする

Cairn について
Cairn は、独自のデバイス上インターフェースを備えた MeshCore コンパニオンファームウェアの、コミュニティ開発によるフォークです。L2 Pro 向けビルドは、タッチスクリーンメッセージングとローカルオーディオツールを組み合わせ、公式 MeshCore クライアントと連携して動作します。別のビルドを使用する場合は、release notes を確認してください。
準備
次を準備します。
-
LoRa アンテナを接続した Wio Tracker L2 Pro を 1 台。
-
USB-C データケーブル と、Chrome または Edge を実行しているコンピュータ。
-
音楽および録音用の microSD カード。Cairn は FAT32 でフォーマットされた 8~32 GB の SDHC を推奨しています。exFAT は、ドキュメント化されている L2 Pro カードワークフローではサポートされていません。
-
再生テスト用の短い MP3 または WAV ファイル。
ファームウェアの書き込み
ステップ 1:L2 Pro ファームウェアをダウンロードする
Cairn Releases を開き、Assets を展開します。WioL2Pro を含むファイルを選択します。
この初回インストールチュートリアルでは、-full.bin をダウンロードしてください。アプリケーションをすでに含んでいるため、-update.bin を別途書き込む必要はありません。

ステップ 2:ダウンロードモードに入る
-
L2 Pro をコンピュータに接続し、電源スイッチをオンにします。
-
User/Boot を押し続けます。
-
押し続けたまま RST を押して離します。
-
User/Boot を離します。
ステップ 3:ブラウザ経由で書き込む
-
Espressif の Web Flasher を開きます。
-
Connect をクリックし、デバイスのシリアルポートを選択します。
-
Erase Flash を選択し、完了するまで待ちます。
-
ファームウェアアドレスを
0x0に設定し、ダウンロードした L2 Pro の-full.binを選択します。 -
Program をクリックし、書き込みが完了するまで待ちます。
-
フラッシャーとの接続を切断し、RST を押して Cairn を起動します。

Cairn のオーディオインターフェースを試す
Audio ハブを開く
準備した microSD カードを挿入します。Home から下にスワイプして Audio カードを探すか、クイックパネルから Audio を開きます。ハブからプレーヤーとレコーダーにアクセスできます。

microSD から音楽を再生する
-
カードのルートに
musicという名前のフォルダを作成します。 -
短い MP3 または WAV ファイルをその中にコピーし、コンピュータから安全にカードを取り外します。
-
カードを L2 Pro に挿入し、プレーヤーを開いて Library → Music からファイルを選択します。
-
低い音量から再生を開始し、動作を確認します。

ボイスメモを録音する
-
Audio ハブから Recorder を開きます。
-
設定を開き、録音品質、マイクゲイン、時間制限を選択します。
-
短い録音を開始し、マイクの近くで話してから停止します。
-
Library → Recordings を開いて再生します。

レコーダーは、時計が設定されている場合は日時を用いて、Recordings 内に WAV ファイルを保存します。8 kHz または 16 kHz での録音、検出された音声で録音を開始する Voice start、およびマーカーを提供します。ステータスバーには、マイクがアクティブな間 MIC または REC が表示されます。
カスタム通知音を試す
ルートレベルの Sounds フォルダに短い MP3 または WAV をコピーします。Settings → Hardware → Sound を開き、イベントを選択して、カードのサウンド一覧からファイルを選びます。
試してみる価値のあるその他の Cairn 機能
-
スタンドアロンメッセージング: タッチスクリーンキーボード、クイック返信、絵文字を使って、チャンネルおよびダイレクト会話を行います。
-
地図と測位: デバイス上の地図、GPS 情報、近くのノード位置を確認し、外出前にオフラインカバレッジを準備します。
-
無線インスペクション: パケットトラフィック、信号情報、スペクトラム/バンドスキャンを確認し、ローカルの無線状況を把握します。
-
ファイルアクセス: microSD カードを取り外さずに、Wi-Fi 転送や USB ドライブモードを試してカード内容を管理します。
-
デバイスのパーソナライズ: テーマ、ボタン動作、バッテリー履歴表示を試してみてください。
トラブルシューティング
-
ブラウザがデバイスを検出できない: USB データケーブルを確認し、他のシリアルアプリケーションを閉じてから、User/Boot + RST の手順をやり直してください。
-
音楽ファイルが表示されない: FAT32 でフォーマットされているか、ルートレベルの
Musicフォルダ、および MP3/WAV 形式を確認します。ストレージページを使用してカードを確認または再スキャンします。 -
録音が無音になる: ゲインと録音設定を確認します。カスタムファームウェアの場合は、再生とは別に、マイクの初期化と GPIO15 RX 経路を検証してください。