Audio-SDK-Beispiele¶

Die Audio-Beispiele des SiFli-SDK sind praktische Ausgangspunkte, um einen vollständigen Signalpfad zu prüfen. Sie sind keine fertige Produkt-Firmware. Wählen Sie das Beispiel, das den anspruchsvollsten Teil Ihres Designs bereits abdeckt — Mikrofonaufnahme, Lautsprecherausgabe, Speicherung, Codec oder mehrere gleichzeitige Audioströme. Führen Sie das unveränderte Beispiel zunächst auf dem vorgesehenen Entwicklungsboard aus; passen Sie danach jeweils nur ein Subsystem an.

Diese Seite ordnet ausgewählte SiFli-SDK-Audiobeispiele nach Entwicklungsaufgabe. Der offizielle Audio-Index dient als Einstieg. Die Tabelle nennt die Entwicklungsboards, die auf den offiziellen SiFli-Seiten zum Zeitpunkt dieser Prüfung ausdrücklich aufgeführt sind; aus einem Seriennamen folgt keine Unterstützung für jedes Entwicklungsboard oder jede SDK-Version dieser Serie. Prüfen Sie vor dem Build die genaue Seite und die Dateien des Zielboards.

Das passende Beispiel auswählen¶

Gemeinsame Voraussetzungen¶

Die meisten Beispiele haben dieselben Voraussetzungen: Die benötigte Audio-Hardware muss auf dem Entwicklungsboard vorhanden und korrekt angeschlossen sein. Die Konfiguration des Entwicklungsboards muss die erforderlichen Audio-Blöcke aktivieren, und das Beispiel muss das jeweilige Entwicklungsboard unterstützen. Beispiele, die Dateien lesen oder schreiben, benötigen außerdem ein eingebundenes Dateisystem. Übernehmen Sie Boardnamen, Pinbelegungen oder menuconfig-Einstellungen nicht ungeprüft aus anderen Beispielen, sondern gleichen Sie sie mit der offiziellen SiFli-Seite und den Konfigurationsdateien des Entwicklungsboards ab.

Beschränken Sie die erste Prüfung bei allen Beispielen bewusst auf das Wesentliche:

1. Bauen Sie das unveränderte Projekt für ein unterstütztes Entwicklungsboard und flashen Sie es.
2. Prüfen Sie das erwartete Aufnahme- oder Wiedergabeverhalten mit nachweislich funktionierender Audio-Hardware und geprüften Dateien.
3. Dokumentieren Sie SDK-Revision, Boardname, Konfiguration, Pinbelegung und serielle Ausgabe.
4. Ändern Sie genau ein produktspezifisches Element und wiederholen Sie denselben Test.

Die Audioübersicht erläutert die Schnittstellen- und Systementscheidungen hinter diesen Beispielen. Informationen zur Pufferverwaltung, zum Beenden von Sitzungen und zur Koexistenz mit Display oder Bluetooth finden Sie unter Audio-Server und Pufferung.

Digitale Mikrofone erfassen: PDM¶

Verwenden Sie das PDM-Beispiel, wenn das Produkt digitale Mikrofone statt eines analogen Mikrofoneingangs benötigt. Das offizielle Beispiel unterstützt zwei oder vier PDM-Mikrofone; ob eine Aufnahmedatei entsteht und wie sie wiedergegeben wird, hängt vom Verarbeitungsmodus ab. In der dokumentierten Topologie dienen der linke und rechte Kanal von PDM1 für zwei Mikrofone; mit PDM2 werden vier erreicht. Eine PDM-Schnittstelle kann bis zu zwei digitale Mikrofone bedienen; die Zahl der Schnittstellen entspricht daher nicht der Mikrofonanzahl. Prüfen Sie die unterstützte Konfiguration anhand der Schnittstellen- und Kanalzuordnung des Ziel-SoC.

Die aktuelle offizielle Seite führt sf32lb56-lcd_a128r12n1 als unterstütztes Entwicklungsboard. pdm open pdm12 4 raw erzeugt nur Protokollausgaben, keine Aufnahmedatei. Die Anyka-Verarbeitungsmodi liefern auch bei vier Mikrofonen Monoausgabe. Vier Eingänge bedeuten daher keine vierkanalige Ausgabedatei. Prüfen Sie Algorithmusabhängigkeiten und Ausgabeformat, bevor Sie das Beispiel als Grundlage für ein Mikrofonarray nutzen.

Prüfen Sie vor der Anpassung diese vier Punkte:

• Der gewählte Chip und das Entwicklungsboard stellen die benötigten PDM-Signale bereit.
• Mikrofontakt, Datenleitungen, Versorgung und Masseführung entsprechen dem Mikrofon-Datenblatt.
• Die Pin-Mux-Konfiguration des Entwicklungsboards weist die PDM-Funktionen zu, bevor der Treiber gestartet wird.
• Das Produkt benötigt die im Beispiel aktivierten Aufnahme- und Wiedergabedienste tatsächlich; für die reine PDM-Erfassung sind sie nicht erforderlich.

Die offizielle PDM-Seite dokumentiert eine eigene Entwicklungsboard-Konfiguration und beispielhafte Pinbelegung. Nutzen Sie diese als geprüfte Referenz, ersetzen Sie sie jedoch durch die tatsächliche Verdrahtung des Zielboards. Übernehmen Sie die Angaben nicht ungeprüft. Siehe das PDM-Beispiel.

Analoge Erfassung sowie einfache Aufnahme und Wiedergabe¶

Das Aufnahmebeispiel prüft den Signalweg von der Mikrofonaufnahme bis zur lokalen Wiedergabe: Es zeichnet fünf Sekunden in einen PCM-Puffer im Speicher auf und gibt diesen anschließend automatisch über den Lautsprecher wieder. Die offizielle Seite führt eh-lb525 sowie die Serien sf32lb52-lcd, sf32lb56-lcd und sf32lb58-lcd auf. Es eignet sich als erster Schritt, bevor Dateisystem, Komprimierung, Bluetooth-Übertragung oder mehrere Mikrofone hinzukommen.

Das Local Music Example for stereo speaker (Dual-ADC/DAC-Beispiel) ist eine spezielle Referenz für ein kundenspezifisches SF32LB58x-Board. Laut offizieller Seite läuft es nicht auf SiFli-Modulboards und benötigt zwei analoge Mikrofone sowie zwei analoge Lautsprecher. mic2file zeichnet beide Mikrofone gleichzeitig in getrennte PCM-Dateien auf; mic2speaker 0 oder mic2speaker 1 wählt ein Mikrofon zur Wiedergabe über den Lautsprecher aus. Verwenden Sie es nur, wenn diese analoge Topologie den Produktanforderungen entspricht; andernfalls beginnen Sie mit dem einfacheren Aufnahmebeispiel.

Prüfen Sie bei beiden Signalwegen zunächst den Rauschpegel ohne Eingangssignal, die Verstärkung, Übersteuerungen und das Verhalten beim Starten und Stoppen. Erst danach sollten Sie weitere Softwarefunktionen untersuchen. Ein stabiler PCM-Aufnahme- und Wiedergabepfad ist die Grundlage für Codecs, Dateizugriff und Bluetooth.

Lokale Wiedergabe und Speichermedien¶

Das Beispiel für lokale Musikwiedergabe ist die einfachste Referenz für dateibasierte Wiedergabe. Die offizielle Seite führt eh-lb525 sowie die Serien sf32lb52-lcd, sf32lb56-lcd und sf32lb58-lcd auf. Es bindet die FAT-Root-Partition ein und spielt die vorbereitete Datei 16k.wav ab. Eine MP3-Datei kann ebenfalls im Verzeichnis disk/ des Beispiels bereitgestellt werden, sofern sie in die konfigurierte Dateisystemkapazität passt. Das Beispiel eignet sich für Benachrichtigungstöne, mitgelieferte Ansagen und die erste Prüfung des lokalen Lautsprecherpfads.

Der MP3-Player für lokale Musikwiedergabe ergänzt Wechselspeicher: Er spielt MP3 oder WAV aus dem SD-Kartenverzeichnis music ab und regelt die Lautstärke über die Shell. Beide lokalen Wiedergabebeispiele benötigen ein Dateisystem; dieses nutzt zusätzlich SPI1 und den SPI-MSD-Treiber. Schließen Sie beim dokumentierten Board sf32lb52-lchspi-ulp einen Akku an, sonst werden lange Tastendrücke nicht erkannt. Wählen Sie das Beispiel, wenn SD-Karten zum Produkt gehören.

Beide Beispiele demonstrieren die Wiedergabe, aber keine vollständige Architektur für einen Mediaplayer. Bevor Sie eines davon zu einer Produktfunktion ausbauen, planen Sie Dateiverwaltung, den Umgang mit beschädigten Medien, Unterbrechungen, die Wiederherstellung nach Energiesparzuständen und das Verhalten der Benutzeroberfläche separat.

FLAC- und Opus-Verarbeitungsketten¶

Das FLAC-Beispiel deckt den vollständigen verlustfreien Ablauf ab: PCM vom Mikrofon aufnehmen, als FLAC codieren, decodieren und wiedergeben. Die offizielle Seite führt die Serien sf32lb52-lcd, sf32lb56-lcd und sf32lb58-lcd auf; erforderlich sind FAT, libFLAC und Audiokomponenten. Es eignet sich zum Testen einer dateibasierten Aufnahmekette oder zum Vergleich des Speicherbedarfs mit unkomprimiertem PCM.

Das Opus-Beispiel demonstriert einen komprimierten Signalweg für Sprachsignale. Die aktuelle offizielle Seite führt nur eh-lb525 auf. Das Beispiel erfasst Audio mit 16 kHz, verarbeitet 10-ms-Frames mit etwa 16 kbit/s und decodiert und gibt den resultierenden Stream wieder. Die Dokumentation weist außerdem darauf hin, dass die benötigte Stackgröße vom gewählten Encoder-Modus abhängt. Berücksichtigen Sie diese Anforderung beim Anpassen des Beispiels; der standardmäßige Task-Stack reicht nach dem Hinzufügen von Anwendungscode möglicherweise nicht mehr aus.

Die offizielle SiFli-SDK-README nennt beispielspezifische Stack-Einstellungen: OPUS_STACK_SIZE soll 20k betragen, wenn opus_test() opus_encoder_ctl(encoder, OPUS_SET_FORCE_MODE(MODE_SILK_ONLY)) aufruft; ohne diesen erzwungenen Modus empfiehlt sie 200k. Das sind keine allgemeinen Opus-Anforderungen. Prüfen Sie vor der Übernahme die verwendete SDK-Revision und den Encoder-Pfad und messen Sie den Stack-Höchstverbrauch unter der Produktlast, um die Task-Stackgröße festzulegen.

Keines der beiden Beispiele bildet einen vollständigen Bluetooth-Anruf oder ein Streaming-Produkt ab. Prüfen Sie damit zunächst die lokale Codierung und Decodierung. Integrieren Sie anschließend Transport, Pufferverwaltung und Sitzungssteuerung und messen Sie die verfügbaren Latenz- und Speicherreserven.

Drei Audiokanäle mischen¶

Die aktuelle offizielle Seite des Dreikanal-Audiomixers führt sf32lb52-lcd_n16r8 und sf32lb56-lcd_n16r12n1 als getestete Entwicklungsboards auf. Das Beispiel liest drei lokale Audiodateien, decodiert jeden Stream, tastet Eingaben mit einer anderen Abtastrate als 48 kHz bei Bedarf neu ab, mischt die Mono-PCM-Streams und gibt das Ergebnis wieder. Die dokumentierten Beispieldateien umfassen zwei MP3-Dateien und eine WAV-Datei. Verwenden Sie das angegebene Dateisystem-Image und die Dateinamen; beliebige Audiodateien sind darin nicht zwingend enthalten.

Die geprüfte Implementierung des Mixers addiert die drei Mono-Samples und teilt durch drei, statt sie mit voller Verstärkung zu summieren. Der dokumentierte Durchlauf dauert etwa 50 Sekunden. Trennen Sie diese Verstärkungsstrategie und die begrenzte Demonstrationsdauer von den Mischanforderungen des Produkts.

Das ist eine geeignete Referenz für gleichzeitig abgespielte Ansagen, Effekte und Musik, wenn das Produkt festlegen muss, welche Klänge überlagert werden dürfen. Eine fertige Audiorichtlinie ist damit nicht gegeben: Legen Sie Stream-Prioritäten, Lautstärkeregelung, Verhalten bei Übersteuerung, Speicherbudget und Reaktion auf eine verpasste Frist beim Lesen oder Decodieren fest. Der Artikel Audio-Server und Pufferung hilft, diese Laufzeitbedingungen genauer festzulegen.

Ein Beispiel anpassen und die Nachweise erhalten¶

Weiterführende Informationen¶

• Audioübersicht zu Schnittstellen, Sitzungstypen, Energiebedarf und Validierung.
• Audio-Server und Pufferung zu Stream-Verwaltung, DMA-Puffern und Tests unter Produktlast.
• Beispiele zum SDK-Beispielkatalog aus verschiedenen Bereichen.
• Audio-Beispielindex des SiFli-SDK mit der aktuellen offiziellen Liste und den Einrichtungsanleitungen der einzelnen Beispiele.

Zuletzt aktualisiert: 2026-10-12