オーディオSDKサンプル¶

SiFli-SDKのオーディオサンプルは、信号経路全体を検証するための実践的な出発点であり、そのまま製品に組み込めるファームウェアではありません。マイク入力、スピーカー出力、ストレージ、コーデック、複数ストリームの同時処理など、設計上の難所をすでに検証しているサンプルを選びます。サブシステムを一つずつ変更する前に、まずは未変更の状態で対象ボード上で動作させてください。

このページでは、SiFli-SDKの代表的なオーディオサンプルを開発目的ごとに整理しています。公式のオーディオサンプル一覧は入口として利用できます。表の対象ボードは、今回確認したSiFli公式ページに明記された範囲です。シリーズ名は、そのシリーズの全ボードや全SDKリリースでの動作を保証するものではありません。ビルド前に該当バージョンのページと対象ボードの設定を確認してください。

目的に合ったサンプルを選ぶ¶

共通の前提条件¶

多くのサンプルに共通する前提条件は、必要なオーディオ回路がボードに実装され、正しく配線されていること、ボード設定で必要なオーディオブロックが有効になっていること、対象ボードがそのサンプルに対応していることです。ファイルを読み書きするサンプルでは、ファイルシステムもマウントしておく必要があります。公式ドキュメントと対象ボードの設定ファイルを確認せずに、別のサンプルからボード名、ピン割り当て、menuconfig設定をコピーしないでください。

最初の検証では、確認範囲を意図的に絞ります。

1. 対応ボード向けに、未変更のプロジェクトをビルドして書き込みます。
2. 正常動作を確認済みのオーディオ機器とファイルを使い、想定どおりに録音または再生できることを確認します。
3. SDKのリビジョン、ボード名、設定、ピン割り当て、シリアルログを記録します。
4. 製品固有の要素を1つだけ変更し、同じテストを繰り返します。

オーディオ概要では、各サンプルの基礎となるインターフェースとシステム構成を説明しています。バッファーの管理、セッションの終了処理、ディスプレイやBluetoothとの共存については、Audio Serverとバッファリングを参照してください。

PDMによるデジタルマイク録音¶

アナログ入力ではなくデジタルマイクを使う製品では、PDMサンプルを利用してください。公式サンプルは2本または4本のPDMマイクに対応しますが、録音ファイルの生成と再生の動作は処理モードによって異なります。資料に記載された構成では、2本の場合はPDM1の左右チャンネルを使い、4本の場合はPDM2を追加します。PDMインターフェース1つで最大2本のデジタルマイクを扱えるため、インターフェース数とマイク数を同一視しないでください。実際に使用できる構成は、対象SoCのインターフェースとチャンネルのマッピングを確認してください。

現在の公式ページでは、対応ボードとしてsf32lb56-lcd_a128r12n1が記載されています。pdm open pdm12 4 rawはログだけを出力し、録音ファイルを作りません。Anyka処理モードは4マイク構成でもモノラル出力です。入力が4系統あっても、出力ファイルが4チャンネルになるとは限りません。マイクアレイの検証に使う前に、アルゴリズムの依存関係と出力形式を確認してください。

製品に合わせて変更する前に、次の4点を確認してください。

• 対象チップとボードから、必要なPDM信号を取り出せること。
• マイクのクロック、データ線、電源、接地がデータシートの仕様に合っていること。
• ドライバーを起動する前に、ボードのピン設定でPDM機能が割り当てられていること。
• 製品で、このサンプルが有効にする録音/再生サービスが必要であること。PDMデータを取り込むだけなら、これらのサービスは必須ではありません。

公式のPDMページには、対応ボードの設定とサンプル用のピン割り当てが記載されています。検証済みの参考情報として利用しつつ、そのまま流用せず、対象ボードの実際の配線に合わせてください。PDMサンプルを参照してください。

アナログ入力と基本的な録音・再生¶

録音サンプルは、マイク入力からローカル再生までを手早く検証できます。公式ページに記載された対象はeh-lb525、sf32lb52-lcd、sf32lb56-lcd、sf32lb58-lcd各シリーズです。5秒間録音してPCMメモリーバッファーに保存し、その後、自動でスピーカー再生します。ファイルシステム、圧縮、Bluetooth転送、複数マイクを追加する前の確認に適しています。

Local Music Example for stereo speaker（デュアルADC/DACサンプル）は、SF32LB58xカスタムボード向けの応用例です。公式ページによると、SiFliモジュールボードでは動作せず、アナログマイク2本とアナログスピーカー2台が必要です。mic2fileコマンドは2本のマイクを同時に録音し、別々のPCMファイルに保存します。mic2speaker 0またはmic2speaker 1でマイクを選び、スピーカーからモニターできます。製品のアナログ構成が一致する場合にのみ使い、それ以外の場合は、よりシンプルな録音サンプルから始めてください。

どちらの経路でも、ソフトウェア機能を調べる前に、無信号時のノイズレベル、ゲイン、クリッピング、開始・停止時の動作を確認してください。PCMの録音・再生経路を安定させることが、コーデック、ファイル、Bluetoothの実装の土台になります。

ローカル再生とストレージ¶

ローカル音楽再生サンプルは、ファイル再生の最小構成を確認するためのものです。公式ページの対応対象はeh-lb525、sf32lb52-lcd、sf32lb56-lcd、sf32lb58-lcd各シリーズです。FATルートパーティションをマウントして、プリセットの16k.wavを再生します。MP3もサンプルのdisk/ディレクトリに配置してプリセットできますが、設定されたファイルシステム容量を超えないようにしてください。通知音や製品内蔵の音声メッセージ、スピーカー経路の初期検証に利用できます。

MP3ローカル音楽プレーヤーはリムーバブルストレージに対応し、SDカードのmusicディレクトリからMP3/WAVを再生して、シェルで音量を制御します。どちらのローカル再生サンプルにもファイルシステムが必要ですが、こちらはさらにSPI1とSPI MSDドライバーを使用します。資料に記載されたsf32lb52-lchspi-ulpでは、バッテリーを接続しないとボタンの長押しを検出できません。製品でSDカードを使う場合に選んでください。

どちらのサンプルも再生機能の検証用であり、汎用メディアプレーヤーの構成を示すものではありません。製品のプレーヤー機能に展開する前に、ファイルの索引作成、破損ファイルへの対処、再生中断、電力状態からの復帰、UIの動作を別途設計してください。

FLACとOpusの処理経路¶

FLACサンプルでは、マイクからPCMを録音し、FLACにエンコード、デコードして再生するまでの一連の処理を検証できます。公式ページの対応対象はsf32lb52-lcd、sf32lb56-lcd、sf32lb58-lcd各シリーズで、FATファイルシステム、オーディオ関連コンポーネント、libFLACが必要です。ファイルに記録する録音経路のテストや、非圧縮PCMとストレージ使用量を比較する場合に適しています。

Opusサンプルは、音声アプリケーション向けの圧縮経路を検証します。現在の公式ページの対応対象はeh-lb525のみです。サンプルは16 kHzでマイク入力をキャプチャし、約16 kbpsで10 ms単位のフレームを処理した後、ストリームをデコードして再生します。エンコーダーモードによって必要なスタックサイズが異なることも、ドキュメントに明記されています。サンプルを基準に製品へ適用する際は、この制約を維持してください。アプリケーション処理を追加した後も、タスクのデフォルトスタックで十分だとは限りません。

SiFli-SDKの公式READMEでは、エンコードモードに応じてOPUS_STACK_SIZEを設定するよう案内しています。opus_test()内でopus_encoder_ctl(encoder, OPUS_SET_FORCE_MODE(MODE_SILK_ONLY))を呼び出す場合は20k、呼び出さない場合は200kです。これはサンプル固有の設定であり、Opus全般の要件ではありません。適用前に使用するSDKリビジョンとエンコード経路を確認し、製品相当の負荷でスタックの高水位を測定してタスクスタックのサイズを決めてください。

どちらのサンプルも、Bluetooth通話やストリーミング製品の全経路を実装するものではありません。まずローカルでのエンコードとデコードを検証し、その後、レイテンシとメモリーの余裕を測定したうえで、転送、バッファリング、セッション制御を統合してください。

3チャンネルのミキシング¶

3チャンネルオーディオミキサーの現在の公式ページでは、検証済みの対象としてsf32lb52-lcd_n16r8とsf32lb56-lcd_n16r12n1が列挙されています。ローカル音声ファイルを3つ読み込み、各ストリームを個別にデコードします。48 kHz以外の入力は必要に応じてリサンプリングし、モノラルPCMストリームをミキシングして再生します。サンプルとしてMP3ファイル2つとWAVファイル1つが記載されています。任意の音声ファイルがイメージに含まれるとは限らないため、例のファイルシステムイメージとファイル名を確認してください。

確認したミキサーは3つのモノラルサンプルを加算して3で割り、そのままのゲインで加算する方式ではありません。資料に記載された実行時間は約50秒です。このゲイン方針と有限のデモ時間は、製品のミキシング要件とは分けて考えてください。

通知音、効果音、音楽を同時に再生し、どの音を重ねるか製品側で制御する場合の出発点として適しています。ただし、完成したオーディオ制御機能ではありません。ストリームの優先度、音量制御、クリッピング時の動作、メモリー予算、入力ファイルの読み込みやデコードが期限に間に合わない場合の処理を定義してください。実行時の制御境界については、Audio Serverとバッファリングを参照してください。

検証の根拠を保ちながらサンプルを製品に適用する¶

関連情報¶

• インターフェース、セッション構成、消費電力、検証についてはオーディオ概要を参照してください。
• ストリームとバッファーの管理、DMAバッファー、製品負荷試験についてはAudio Serverとバッファリングを参照してください。
• ドメイン横断のSDKサンプルについてはサンプルを参照してください。
• 最新の公式一覧と各サンプルの設定手順についてはSiFli-SDKオーディオサンプル一覧を参照してください。

最終更新: 2026-10-19