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

オーディオ開発

オーディオ開発の境界を理解する​

マイクとスピーカーにより、デバイスは音声を取得して再生できます。音声メッセージを別のデバイスに送信するには、十分な無線エアタイムも必要です。

ユースケース原理開発の境界
音楽や録音ファイルを再生するローカルオーディオ
LoRa を必要としない
✅
ボイスメモを録音するローカルオーディオ
LoRa を必要としない
✅
ローカル音声制御を開発するデバイス上での認識とローカルアクション
カスタムファームウェア実装が必要
✅
MeshCore 経由で短い音声クリップを送信するオーディオトラフィックが共有チャネルを飽和させ、緊急メッセージをブロックする可能性がある❌
連続した音声通話やトランシーバーのようなストリーミングオーディオトラフィックが共有チャネルを飽和させ、緊急メッセージをブロックする可能性がある❌

オーディオ開発がサポートされる範囲​

L2 Pro 上でのオーディオ開発は現在、ローカルでの処理、保存、および再生に限定されています。サポートされる開発方向は次のとおりです。

  • ローカル音声制御: デバイス上でコマンドを認識し、それを用いてローカルアクションをトリガーする
  • オーディオ録音と保存: マイク入力を取得し、録音を microSD に保存する。
  • オーディオ再生: 音楽や録音したボイスメモを再生する。
  • ローカル通知音: テキストメッセージや他のイベントが到着したときに、LoRa 経由でサウンドファイルを送信することなく、ローカルに保存されたサウンドを再生する。
警告

MeshCore ネットワーク経由でのボイスメッセージ伝送は、この L2 Pro オーディオ開発ワークフローではサポートされていません。

LoRa メッシュノードは限られた無線エアタイムを共有します。オーディオ転送はチャネルを長時間占有する可能性があり、中継や再送がさらに負荷を増やします。これにより深刻な輻輳が発生し、メッシュ通信が停止状態に陥ることで、緊急メッセージがチャネルにアクセスできなかったり、時間内に到達しなくなったりするおそれがあります。

オーディオの取得、音声処理、保存、および再生はデバイス上に留めてください。メッシュネットワーク上でオーディオペイロードを送信しないでください。

ローカルオーディオ開発のヒント​

カスタムのローカルオーディオアプリケーションを作成する場合、次の点を計画してください。

  • 入力と出力: マイクとスピーカーの経路を個別に検証し、マイクゲインと再生音量を含めて確認する。
  • ローカル音声認識: ESP32-S3 の処理能力とメモリ予算に適合する、デバイス上で動作する認識エンジンを選択する。
  • ストレージ: 利用可能な microSD 容量に収まるサンプル形式と録音時間を選択し、カード容量が一杯になった場合や書き込み失敗時の処理を行う。
  • タスクスケジューリング: オーディオ処理やファイルアクセスが、メッシュパケット処理やタッチスクリーンインターフェースをブロックしないようにする。

L2 Pro におけるハードウェア基盤​

オーディオ信号経路​

L2 Pro のオーディオサブシステムは、I2S インターフェース、コーデック回路、マイク経路を使用します。

オーディオピンマッピング​

インターフェースボード信号ESP32-S3 GPIO用途
I2SCODEC_I2S0_MCLKGPIO10マスタークロック
I2SCODEC_I2S0_SCLKGPIO11ビットクロック(BCLK とも呼ばれる)
I2SCODEC_I2S0_LRCKGPIO12ワードセレクト/フレームクロック(WS とも呼ばれる)
I2SCODEC_I2S0_DSDINGPIO16ESP32-S3 TX → コーデックデータ入力;再生
I2SCODEC_I2S0_SDOUTGPIO15オーディオデータ出力 → ESP32-S3 RX;録音
I²CIIC0_SDAGPIO47周辺機器設定データ
I²CIIC0_SCLGPIO48周辺機器設定クロック

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:ダウンロードモードに入る

  1. L2 Pro をコンピュータに接続し、電源スイッチをオンにします。

  2. User/Boot を押し続けます。

  3. 押し続けたまま RST を押して離します。

  4. User/Boot を離します。

ステップ 3:ブラウザ経由で書き込む

  1. Espressif の Web Flasher を開きます。

  2. Connect をクリックし、デバイスのシリアルポートを選択します。

  3. Erase Flash を選択し、完了するまで待ちます。

  4. ファームウェアアドレスを 0x0 に設定し、ダウンロードした L2 Pro の -full.bin を選択します。

  5. Program をクリックし、書き込みが完了するまで待ちます。

  6. フラッシャーとの接続を切断し、RST を押して Cairn を起動します。

Cairn のオーディオインターフェースを試す​

Audio ハブを開く​

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

microSD から音楽を再生する​

  1. カードのルートに music という名前のフォルダを作成します。

  2. 短い MP3 または WAV ファイルをその中にコピーし、コンピュータから安全にカードを取り外します。

  3. カードを L2 Pro に挿入し、プレーヤーを開いて Library → Music からファイルを選択します。

  4. 低い音量から再生を開始し、動作を確認します。

ボイスメモを録音する​

  1. Audio ハブから Recorder を開きます。

  2. 設定を開き、録音品質、マイクゲイン、時間制限を選択します。

  3. 短い録音を開始し、マイクの近くで話してから停止します。

  4. 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 経路を検証してください。

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

Loading Comments...