'n Witboek wat 'n
Hoëvlak-oorview van Oudio
Opsies op Raspberry Pi SBC's
Raspberry Pi Bpk
Kolofon
© 2022-2025 Raspberry Pi Bpk
Hierdie dokumentasie is gelisensieer onder 'n Creative Commons Attribution-No Derivatives 4.0 International (CC BY-ND).
Weergawe 1.0
Boudatum: 28/05/2025
Wetlike vrywaringskennisgewing
TEGNIESE EN BETROUBAARHEIDSDATA VIR RASPBERRY PI-PRODUKTE (INSLUITEND DATABLADE) SOOS VAN TYD TOT TYD GEWYSIG ("HULPBRONNE") WORD VERSKAF DEUR RASPBERRY PI BPK ("RPL") "SOOS IS" EN ENIGE UITDRUKKELIJKE OF INGESULDE, INGESULDE, INGESLUIT, NIE geïmpliseer nie. TOT, WORD DIE GEÏSPLISEERDE WAARBORGE VAN VERHANDELBAARHEID EN GESKIKTHEID VIR 'N SPESIFIEKE DOEL AFGEWYS. SAL RPL IN GEEN GEVAL AANSPREEKLIK WEES VIR ENIGE DIREKTE, INDIREKTE, TOEVALLE, SPESIALE, VOORBEELDE OF GEVOLLIKE SKADE (INSLUITEND, MAAR NIE BEPERK TOT, VERKRYWERS VAN GOEDE, VERKRYWER) IN DIE MAKSIMUM MAAT WAT DEUR TOEPASSELIJKE WET TOEGESTAAN WORD NIE; , DATA , Of winste; of onderbreking van sakeonderbrekings) egter veroorsaak en op enige teorie van aanspreeklikheid, hetsy in kontrak, streng aanspreeklikheid, of skadelike (insluitend nalatigheid of andersins) wat voortspruit uit die gebruik van die hulpbronne, selfs al is dit van die moontlikheid in kennis gestel. VAN SULKE SKADE.
RPL behou die reg voor om enige verbeterings, verbeterings, regstellings of enige ander wysigings aan die HULPBRONNE of enige produkte wat daarin beskryf word, te eniger tyd en sonder verdere kennisgewing aan te bring.
Die HULPMIDDELS is bedoel vir bekwame gebruikers met geskikte vlakke van ontwerpkennis. Gebruikers is alleen verantwoordelik vir hul keuse en gebruik van die HULPMIDDELS en enige toepassing van die produkte wat daarin beskryf word. Die gebruiker stem in om RPL te vrywaar en skadeloos te hou teen alle laste, koste, skade of ander verliese wat voortspruit uit hul gebruik van die HULPMIDDELS. RPL gee gebruikers toestemming om die HULPMIDDELS slegs in samewerking met die Raspberry Pi-produkte te gebruik. Alle ander gebruik van die HULPMIDDELS is verbode. Geen lisensie word toegestaan aan enige ander RPL- of ander derdeparty-intellektuele eiendomsreg nie.
HOËRISIKO-AKTIWITEITE. Raspberry Pi-produkte is nie ontwerp, vervaardig of bedoel vir gebruik in gevaarlike omgewings wat veilige werkverrigting vereis nie, soos in die bedryf van kernfasiliteite, vliegtuignavigasie- of kommunikasiestelsels, lugverkeersbeheer, wapenstelsels of veiligheidskritieke toepassings (insluitend lewensondersteuningstelsels en ander mediese toestelle), waarin die mislukking van die produkte direk tot die dood, persoonlike besering of ernstige fisiese of omgewingskade ("Hoërisiko-aktiwiteite") kan lei. RPL verwerp spesifiek enige uitdruklike of geïmpliseerde waarborg van geskiktheid vir hoërisiko-aktiwiteite en aanvaar geen aanspreeklikheid vir die gebruik of insluiting van Raspberry Pi-produkte in hoërisiko-aktiwiteite nie. Raspberry Pi-produkte word verskaf onderhewig aan RPL se... StandaardvoorwaardesRPL se voorsiening van die HULPBRONNE brei nie RPL se bronne uit of wysig dit andersins nie. Standaardvoorwaardes insluitend maar nie beperk tot die vrywarings en waarborge wat daarin uitgedruk word nie.
Dokument weergawe geskiedenis
| Loslaat | Datum | Beskrywing |
| 1 | 1-25 April | Aanvanklike vrystelling |
Omvang van dokument
Hierdie dokument is van toepassing op die volgende Raspberry Pi-produkte:
| PI 0 | PI 1 | Pi 2 | Pi 3 | Pi 4 | Pi 400 | Pi 5 | Pi 500 | CM1 | CM3 | CM4 | CM5 | Pico | Pico2 | ||||
| 0 | W | H | A | B | A | B | B | Almal | Almal | Almal | Almal | Almal | Almal | Almal | Almal | Almal | Almal |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Inleiding
Oor die jare het die opsies wat beskikbaar is vir klankuitvoer op Raspberry Pi SBC's (enkelbordrekenaars) meer geword, en die manier waarop hulle vanaf sagteware aangedryf word, het verander.
Hierdie dokument sal deur baie van die beskikbare opsies vir klankuitvoer op jou Raspberry Pi-toestel gaan en instruksies verskaf oor hoe om klankopsies vanaf die lessenaar en die opdragreël te gebruik.
Hierdie witskrif neem aan dat die Raspberry Pi-toestel die Raspberry Pi-bedryfstelsel gebruik en ten volle op datum is met die nuutste firmware en kernels.
Raspberry Pi oudio hardeware
HDMI
Alle Raspberry Pi SBC's het 'n HDMI-aansluiting wat HDMI-klank ondersteun. As jy jou Raspberry Pi SBC aan 'n monitor of televisie met luidsprekers koppel, sal dit outomaties HDMI-klankuitset deur daardie luidsprekers aktiveer. HDMI-klank is 'n hoëgehalte digitale sein, so die resultate kan baie goed wees, en meerkanaalklank soos DTS word ondersteun.
As jy HDMI-video gebruik, maar wil hê dat die klanksein afgesplits word – bv.ample, na 'n amp'n Verwyderaar wat nie HDMI-invoer ondersteun nie — dan sal jy 'n bykomende stuk hardeware genaamd 'n splitter moet gebruik om die klanksein uit die HDMI-sein te onttrek. Dit kan duur wees, maar daar is ander opsies, en dit word hieronder beskryf.
Analoog PCM/3.5 mm-aansluiting
Raspberry Pi-modelle B+, 2, 3 en 4 beskik oor 'n 4-polige 3.5 mm-klankaansluiting wat klank- en saamgestelde videoseine kan ondersteun. Dit is 'n lae-gehalte analooguitset wat gegenereer word vanaf 'n PCM (pulskodemodulasie) sein, maar dit is steeds geskik vir oorfone en tafelsprekers.
LET WEL
Daar is geen analoog klankuitset op Raspberry Pi 5 nie.
Die jack-propseine word in die volgende tabel gedefinieer, beginnende by die kabelpunt en eindigend by die punt. Kabels is beskikbaar met verskillende toewysings, so maak seker dat jy die korrekte een het.
| Jack-segment | Sein |
| Mou | Video |
| Skakel 2 | Grond |
| Skakel 1 | Reg |
| Wenk | Links |
I2S-gebaseerde adapterborde
Alle modelle van Raspberry Pi SBC's het 'n I2S-randtoestel beskikbaar op die GPIO-kopstuk. I2S is 'n elektriese seriële buskoppelvlakstandaard wat gebruik word om digitale oudiotoestelle te koppel en PCM-oudiadata tussen randapparatuur in 'n elektroniese toestel te kommunikeer. Raspberry Pi Bpk. vervaardig 'n reeks oudioborde wat aan die GPIO-kopstuk koppel en die I2S-koppelvlak gebruik om oudiodata van die SoC (stelsel op 'n skyfie) na die byvoegbord oor te dra.
Let wel: Byvoegborde wat via die GPIO-kopstuk verbind en aan die toepaslike spesifikasies voldoen, staan bekend as HAT's (Hardware Attached on Top). Hul spesifikasies kan hier gevind word: https://datasheets.raspberrypi.com/
Die volledige reeks oudio-HAT's kan op die Raspberry Pi Bpk. gesien word. webwebwerf: https://www.raspberrypi.com/products/
Daar is ook 'n groot aantal derdeparty-HAT's beskikbaar vir klankuitvoer, byvoorbeeldampvan Pimoroni, HiFiBerry, Adafruit, ens., en hierdie bied 'n menigte verskillende funksies.
USB-klank
As dit nie moontlik is om 'n HAT te installeer nie, of jy soek 'n vinnige en maklike manier om 'n jack-prop vir 'n koptelefoon-uitset of 'n mikrofoon-inset aan te heg, dan is 'n USB-klankadapter 'n goeie keuse. Dit is eenvoudige, goedkoop toestelle wat in een van die USB-A-poorte op die Raspberry Pi SBC inprop.
Raspberry Pi OS bevat standaard drywers vir USB-klank; sodra 'n toestel ingeprop is, behoort dit op die toestelkieslys te verskyn wat verskyn wanneer daar met die rechtermuisknop op die luidsprekerikoon op die taakbalk geklik word.
Die stelsel sal ook outomaties opspoor of die aangehegte USB-toestel 'n mikrofooninset het en die toepaslike ondersteuning aktiveer.
Bluetooth
Bluetooth-klank verwys na die draadlose oordrag van klankdata via Bluetooth-tegnologie, wat baie wyd gebruik word. Dit stel die Raspberry Pi SBC in staat om met Bluetooth-luidsprekers en koptelefoon/oordopjes, of enige ander klanktoestel met Bluetooth-ondersteuning, te kommunikeer. Die reikwydte is redelik kort – ongeveer 10 m maksimum.
Bluetooth-toestelle moet met die Raspberry Pi SBC "gekoppel" word en sal in die klankinstellings op die lessenaar verskyn sodra dit gedoen is. Bluetooth word standaard op Raspberry Pi OS geïnstalleer, met die Bluetooth-logo wat op die lessenaartaakbalk verskyn op enige toestelle wat Bluetooth-hardeware geïnstalleer het (óf ingebou óf via 'n Bluetooth USB-dongle). Wanneer Bluetooth geaktiveer is, sal die ikoon blou wees; wanneer dit gedeaktiveer is, sal die ikoon grys wees.
Sagteware ondersteuning
Die onderliggende klankondersteuningsagteware het aansienlik verander in die volledige Raspberry Pi OS-beeld, en vir die eindgebruiker is hierdie veranderinge meestal deursigtig. Die oorspronklike klanksubstelsel wat gebruik is, was ALSA. Pulse Audio het ALSA opgevolg voordat dit vervang is deur die huidige stelsel, wat Pipe Wire genoem word. Hierdie stelsel het dieselfde funksionaliteit as Pulse Audio, en 'n versoenbare API, maar dit het ook uitbreidings om video en ander funksies te hanteer, wat die integrasie van video en klank baie makliker maak. Omdat Pipe Wire dieselfde API as Pulse Audio gebruik, werk Pulse Audio-hulpprogramme goed op 'n Pipe Wire-stelsel.
Hierdie nutsdienste word in die eks gebruikamples hieronder.
Om die beeldgrootte klein te hou, gebruik Raspberry Pi OS Lite steeds ALSA om klankondersteuning te bied en sluit geen Pipe Wire-, Pulse Audio- of Bluetooth-klankbiblioteke in nie. Dit is egter moontlik om die toepaslike biblioteke te installeer om daardie funksies by te voeg soos benodig, en hierdie proses word ook hieronder beskryf.
Desktop
Soos hierbo genoem, word oudio-operasies hanteer via die luidspreker-ikoon op die taakbalk van die lessenaar. As jy met die linkermuisknop op die ikoon klik, verskyn die volumeskuifbalk en die stilknoppie, terwyl as jy met die rechtermuisknop regs klik, verskyn 'n lys van beskikbare oudiotoestelle. Klik eenvoudig op die oudiotoestel wat jy wil gebruik. Daar is ook 'n opsie, via regskliek, om die pro te verander.files wat deur elke toestel gebruik word. Hierdie profiles bied gewoonlik verskillende kwaliteitsvlakke.
Indien mikrofoonondersteuning geaktiveer is, sal 'n mikrofoonikoon op die kieslys verskyn; regs-kliek hierop sal mikrofoonspesifieke kieslysopsies oopmaak, soos die keuse van invoertoestelle, terwyl links-kliek die invoervlakinstellings oopmaak.
Bluetooth
Om 'n Bluetooth-toestel te koppel, linkskliek op die Bluetooth-ikoon op die taakbalk en kies dan 'Voeg toestel by'. Die stelsel sal dan begin soek na beskikbare toestelle, wat in 'Ontdek'-modus geplaas moet word om gesien te word. Klik op die toestel wanneer dit in die lys verskyn en die toestelle behoort dan te koppel. Sodra dit gekoppel is, sal die oudiotoestel in die kieslys verskyn, wat gekies word deur op die luidsprekerikoon op die taakbalk te klik.
Opdragreël
Omdat Pipe Wire dieselfde API as Pulse Audio gebruik, werk die meerderheid van die Pulse Audio-opdragte wat gebruik word om klank te beheer op Pipe Wire. pacts is die standaard manier om Pulse Audio te beheer: tik man pactl in die opdragreël vir meer besonderhede.
Voorvereistes vir Raspberry Pi OS Lite
Op 'n volledige installasie van Raspberry Pi OS is al die vereiste opdragreëltoepassings en biblioteke reeds geïnstalleer. Op die Lite-weergawe is Pipe Wire egter nie standaard geïnstalleer nie en moet dit handmatig geïnstalleer word om klank te kan speel.
Om die vereiste biblioteke vir Pipe Wire op Raspberry Pi OS Lite te installeer, voer asseblief die volgende in: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils As jy van plan is om toepassings te gebruik wat ALSA gebruik, moet jy ook die volgende installeer: sudo apt install pipewire-alsa
Om alles weer te begin na die installasie is die maklikste manier om dit aan die gang te kry.
Oudio-terugspeel bv.amples
Vertoon 'n lys van geïnstalleerde Pulse-klankmodules in kort vorm (die lang vorm bevat baie inligting en is moeilik om te lees): $ pactl list modules short Vertoon 'n lys van Pulse Audio-sinks in kort vorm:
$ pactl lys sink kort
Op 'n Raspberry Pi 5 wat aan 'n HDMI-monitor met ingeboude klank en 'n bykomende USB-klankkaart gekoppel is, gee hierdie opdrag die volgende uitvoer: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pyp Draad s32le 2ch 48000Hz GESKORP 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Pyp Draad s16le 2ch 48000Hz GESKORP
LET WEL
Raspberry Pi 5 het nie 'n analoog-uitset nie.
Vir 'n Raspberry Pi OS Lite-installasie op 'n Raspberry Pi 4 — wat HDMI en analoog-uitvoer het — word die volgende teruggegee: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pyp Draad s16le 2ch 48000Hz OPGESKORT
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pyp Draad s32le 2ch 48000Hz OPGEHANG
Om die standaard wasbak na HDMI-klank te vertoon en te verander (let wel dat dit reeds die standaard mag wees) op hierdie installasie van Raspberry Pi OS Lite, tik in:
$ pactl kry-standaard-sink
alsa_output.platform-bcm2835_audio.stereo-fallback
$ pactl stel-standaard-sink 70
$ pactl kry-standaard-sink
alsa_output.platform-107c701400.hdmi.hdmi-stereo
Om terug te speel asample, dit moet eers na die s opgelaai wordampdie kasgeheue, in hierdie geval op die standaard wasbak. Jy kan die wasbak verander deur die naam daarvan aan die einde van die pactl play-s by te voeg.ampdie opdrag:
$ pactl oplaai-sampdieample.mp3 samplenaam
$ pactl speel-sampdieamplenaam
Daar is 'n Pulse Audio-opdrag wat selfs makliker is om te gebruik om klank terug te speel:
$ paplay sample.mp3
pactl het 'n opsie om die volume vir die terugspeel te stel. Omdat die lessenaar Pulse Audio-hulpprogramme gebruik om klankinligting te kry en in te stel, sal die uitvoering van hierdie opdragreëlveranderinge ook in die volumeskuifbalk op die lessenaar weerspieël word.
Hierdie example verminder die volume met 10%:
$ pactl stel-sink-volume @DEFAULT_SINK@ -10%
Hierdie example stel die volume op 50%:
$ pactl stel-sink-volume @DEFAULT_SINK@ 50%
Daar is baie, baie Pulse Audio-opdragte wat nie hier genoem word nie. Die Pulse Audio webwerf (https://www.freedesktop.org/wiki/Software/PulseAudio/) en die manbladsye vir elke opdrag bied uitgebreide inligting oor die stelsel.
Bluetooth
Die beheer van Bluetooth vanaf die opdragreël kan 'n ingewikkelde proses wees. Wanneer Raspberry Pi OS Lite gebruik word, is die toepaslike opdragte reeds geïnstalleer. Die nuttigste opdrag is bluetoothctl, en sommige voorbeeldeampLees meer daarvan in gebruik word hieronder verskaf.
Maak die toestel opspoorbaar vir ander toestelle:
$ bluetoothctl ontdekbaar op
Maak die toestel koppelbaar met ander toestelle:
$ bluetoothctl koppelbaar aan
Skandeer vir Bluetooth-toestelle binne bereik:
$ bluetoothctl skandering aan
Skakel skandering af:
$ bluetoothctl scan off bluetoothctl het ook 'n interaktiewe modus, wat aangeroep word deur die opdrag sonder parameters te gebruik. Die volgende bv.ample voer die interaktiewe modus uit, waar die lys-opdrag ingevoer word en die resultate vertoon word, op 'n Raspberry Pi 4 wat Raspberry Pi OS Lite Bookworm gebruik: $ bluetoothctl
Agent geregistreer
[bluetooth]# lys
Beheerder D8:3A:DD:3B:00:00 Pi4Lite [standaard] [bluetooth]#
Jy kan nou opdragte in die interpreteerder tik en hulle sal uitgevoer word. 'n Tipiese proses vir die koppel met, en dan verbinding met, 'n toestel kan soos volg lees: $ bluetoothctl
Agent geregistreer [bluetooth]# ontdekbaar op
Verandering ontdekbaar op geslaag
[CHG] Beheerder D8:3A:DD:3B:00:00 Opspoorbaar op [bluetooth]# koppelbaar aan
Verandering van paarbaar op geslaag
[CHG] Beheerder D8:3A:DD:3B:00:00 Koppelbaar aan [bluetooth]# skandering aan
< kan 'n lang lys van toestelle in die omgewing wees >
[bluetooth]# paar [mac-adres van toestel, vanaf die skanderingsopdrag of vanaf die toestel self, in die vorm xx:xx:xx:xx:xx:xx] [bluetooth]# skandering af
[bluetooth]# koppel [dieselfde MAC-adres] Die Bluetooth-toestel behoort nou in die lys van sinks te verskyn, soos in hierdie voorbeeld getoonample van 'n Raspberry Pi OS Lite installasie:
$ pactl lys sink kort
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pyp Draad s16le 2ch 48000Hz OPGESKORT
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pyp Draad s32le 2ch 48000Hz OPGEHANG
71 bluez_output.CA_3A_B2_CA_7C_55.1 Pyp Draad s32le 2kanaal 48000Hz OPGEHANG
$ pactl stel-standaard-sink 71
$ paplayample_klank_file>
Jy kan dit nou die verstekwaarde maak en klank daarop terugspeel.
Gevolgtrekkings
Daar is 'n aantal verskillende maniere om 'n klankuitset vanaf Raspberry Pi Ltd-toestelle te produseer, wat aan die oorgrote meerderheid gebruikersvereistes voldoen. Hierdie witskrif het daardie meganismes uiteengesit en inligting oor baie daarvan verskaf. Daar word gehoop dat die advies wat hier aangebied word, die eindgebruiker sal help om die regte klankuitsetskema vir hul projek te kies. Eenvoudige voorbeeldampInstruksies oor hoe om die klankstelsels te gebruik, is verskaf, maar die leser moet die handleidings en manbladsye vir die klank- en Bluetooth-opdragte raadpleeg vir meer besonderhede.
Raspberry Pi is 'n handelsmerk van Raspberry Pi Bpk
Raspberry Pi Bpk
Dokumente / Hulpbronne
 |
Raspberry Pi SBCS Enkelbordrekenaar [pdf] Gebruikersgids SBCS Enkelbordrekenaar, SBCS, Enkelbordrekenaar, Bordrekenaar, Rekenaar |