In wytboek dat in
Heechnivo oerview fan Audio
Opsjes op Raspberry Pi SBC's
Raspberry Pi Ltd
Kolofon
© 2022-2025 Raspberry Pi Ltd
Dizze dokumintaasje is lisinsearre ûnder in Creative Commons Attribution-No Derivatives 4.0 International (CC BY-ND).
Ferzje 1.0
Boudatum: 28/05/2025
Juridyske disclaimer notice
TECHNISCHE EN BETROUWBAARHEIDSGEGEVENS FOAR RASPBERRY PI-PRODUKTEN (YNKLUDEREGE DATABLAD) SOOS TIJD TOT TIID WYzige ("BRONNEN") WORDE FERGESE FAN RASPBERRY PI LTD ("RPL") "AS IS" EN ELKE EXPRESS OF IMPLICEERD, NET YNLEFT TO, DE YMPLIZE GARANTIES FAN VERHANDELBAARHEID EN GESIGHEID FOAR IN BEPAAL DOEL WORDEN DISCLAIMED. TOT DE Maksimum MATE TASTE TAAST FAN TAPAASJE WET YN GEEN GEVAL SILT RPL YN FERGESE AANSPRAKELIJK WEES FOAR ELKE DIREKTE, INDIREKTE, INSIDENTELE, SPESIALE, EXEMPLARY OF GEVOLGLIKE SKADES (YNKLUDEREF, MAAR NET BEPERKTE TOT GOEDE FAN FERGESE SERVICE; , DATA , As winsten; as saaklike ûnderbrekking) lykwols feroarsake en op elke teory fan oanspraaklikens, of strangte oanspraaklikheid, of oars as oars) ûntstean op ien of oare manier út it gebrûk fan 'e boarnen, sels as mooglikheid FAN sokke skea.
RPL behâldt it rjocht foar om op elk momint en sûnder fierdere notice alle ferbetterings, ferbetteringen, korreksjes of oare wizigingen oan te meitsjen oan 'e RESOURCES of alle produkten dy't dêryn beskreaun binne.
De BOARNEN binne bedoeld foar betûfte brûkers mei geskikte nivo's fan ûntwerpkennis. Brûkers binne allinnich ferantwurdlik foar harren seleksje en gebrûk fan 'e BOARNEN en elke tapassing fan 'e produkten dy't dêryn beskreaun wurde. De brûker giet dermei akkoard om RPL te frijwarjen en skeadeleas te hâlden tsjin alle oanspraaklikheden, kosten, skea of oare ferliezen dy't ûntsteane út harren gebrûk fan 'e BOARNEN. RPL jout brûkers tastimming om de BOARNEN allinnich te brûken yn kombinaasje mei de Raspberry Pi-produkten. Elk oar gebrûk fan 'e BOARNEN is ferbean. Der wurdt gjin lisinsje ferliend oan oare yntellektuele eigendomsrjochten fan RPL of oare tredden.
AKTIVITEITEN MEI HEGE RISIKO. Raspberry Pi-produkten binne net ûntworpen, produsearre of bedoeld foar gebrûk yn gefaarlike omjouwings dy't feilige prestaasjes fereaskje, lykas by de wurking fan kearnsintrales, fleantugenavigaasje- of kommunikaasjesystemen, loftferkearskontrôle, wapensystemen of feiligenskrityske tapassingen (ynklusyf libbensbehâldende systemen en oare medyske apparaten), wêryn't it falen fan 'e produkten direkt kin liede ta de dea, persoanlik letsel of swiere fysike of miljeuskea ("Aktiviteiten mei hege risiko"). RPL wiist spesifyk elke útdruklike of ymplisearre garânsje fan geskiktheid foar aktiviteiten mei hege risiko ôf en akseptearret gjin oanspraaklikens foar gebrûk of opnames fan Raspberry Pi-produkten yn aktiviteiten mei hege risiko. Raspberry Pi-produkten wurde levere ûnder foarbehâld fan RPL's... StandertbetingstenDe foarsjenning fan 'e BOARNEN troch RPL wreidet de RPL's net út of feroaret se net oars. Standertbetingsten ynklusyf mar net beheind ta de disclaimers en garânsjes dy't dêryn útdrukt binne.
Dokumint ferzje skiednis
| Release | Datum | Beskriuwing |
| 1 | 1-Apr-25 | Inisjele release |
Berik fan dokumint
Dit dokumint jildt foar de folgjende Raspberry Pi-produkten:
| 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 | Alle | Alle | Alle | Alle | Alle | Alle | Alle | Alle | Alle | Alle |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Ynlieding
Yn 'e rin fan 'e jierren binne de opsjes dy't beskikber binne foar audio-útfier op Raspberry Pi SBC's (single-board computers) talryk wurden, en de manier wêrop se fanút software oandreaun wurde is feroare.
Dit dokumint sil in protte fan 'e beskikbere opsjes foar audio-útfier op jo Raspberry Pi-apparaat besprekke en ynstruksjes jaan oer hoe't jo audio-opsjes kinne brûke fan it buroblêd en de kommandorigel.
Dizze whitepaper giet derfan út dat it Raspberry Pi-apparaat Raspberry Pi OS brûkt en folslein by de tiid is mei de lêste firmware en kernels.
Raspberry Pi audio-hardware
HDMI
Alle Raspberry Pi SBC's hawwe in HDMI-ferbining dy't HDMI-audio stipet. As jo jo Raspberry Pi SBC ferbine mei in monitor of televyzje mei sprekkers, wurdt automatysk HDMI-audioútfier fia dy sprekkers mooglik makke. HDMI-audio is in digitaal sinjaal fan hege kwaliteit, sadat de resultaten tige goed wêze kinne, en mearkanaalsaudio lykas DTS wurdt stipe.
As jo HDMI-fideo brûke, mar wolle dat it audiosignaal ôfsplitst wurdt - bygelyksample, oan in ampin splitter dy't gjin HDMI-ynfier stipet - dan moatte jo in ekstra stik hardware brûke, in splitter neamd, om it audiosignaal út it HDMI-signaal te heljen. Dit kin djoer wêze, mar d'r binne oare opsjes, en dizze wurde hjirûnder beskreaun.
Analoge PCM/3.5 mm-jack
Raspberry Pi-modellen B+, 2, 3 en 4 hawwe in 4-polige 3.5 mm audio-jack dy't audio- en gearstalde fideosignalen kin stypje. Dit is in analoge útfier fan lege kwaliteit dy't generearre wurdt út in PCM-sinjaal (pulse-code modulation), mar it is noch altyd geskikt foar koptelefoanen en buroblêdsprekkers.
NOAT
Der is gjin analoge audio-útfier op 'e Raspberry Pi 5.
De jackplug-sinjalen binne definiearre yn 'e folgjende tabel, begjinnend fan it kabelein en einigjend by de punt. Kabels binne beskikber mei ferskate tawizings, dus soargje derfoar dat jo de juste hawwe.
| Jack-segmint | Sinjaal |
| Sleeve | Video |
| Ring 2 | Grûn |
| Ring 1 | Rjochts |
| Tip | Links |
I2S-basearre adapterboerden
Alle modellen fan Raspberry Pi SBC's hawwe in I2S-perifeare apparaat beskikber op 'e GPIO-header. I2S is in elektryske seriële bus-ynterfacestandert dy't brûkt wurdt om digitale audio-apparaten te ferbinen en PCM-audiogegevens te kommunisearjen tusken perifeare apparaten yn in elektroanysk apparaat. Raspberry Pi Ltd produseart in oanbod fan audioboards dy't ferbine mei de GPIO-header en de I2S-ynterface brûke om audiogegevens oer te dragen fan 'e SoC (system on a chip) nei it tafoegingsboard.
Noat: Tafoegingsboerden dy't ferbûn binne fia de GPIO-header en foldogge oan de passende spesifikaasjes binne bekend as HAT's (Hardware Attached on Top). Harren spesifikaasjes kinne hjir fûn wurde: https://datasheets.raspberrypi.com/
It folsleine oanbod fan audio-HAT's is te sjen op 'e Raspberry Pi Ltd. website: https://www.raspberrypi.com/products/
Der binne ek in grut oantal HAT's fan tredden beskikber foar audio-útfier, bygelyksample fan Pimoroni, HiFiBerry, Adafruit, ensfh., en dizze leverje in mannichte ferskillende funksjes.
USB audio
As it net mooglik is om in HAT te ynstallearjen, of jo sykje nei in rappe en maklike manier om in jackplug oan te sluten foar in koptelefoanútgong of in mikrofoanyngong, dan is in USB-audioadapter in goede kar. Dit binne ienfâldige, goedkeape apparaten dy't yn ien fan 'e USB-A-poarten op 'e Raspberry Pi SBC stekke wurde.
Raspberry Pi OS befettet standert stjoerprogramma's foar USB-audio; sa gau as in apparaat is ynstutsen, moat it ferskine yn it apparaatmenu dat ferskynt as jo mei de rjochtermûsknop op it sprekkerikoantsje op 'e taakbalke klikke.
It systeem sil ek automatysk detektearje as it oansletten USB-apparaat in mikrofoanynfier hat en de passende stipe ynskeakelje.
Bluetooth
Bluetooth-audio ferwiist nei de draadloze oerdracht fan lûdsgegevens fia Bluetooth-technology, dy't tige breed brûkt wurdt. It stelt de Raspberry Pi SBC yn steat om te kommunisearjen mei Bluetooth-sprekkers en koptelefoanen/earbuds, of elk oar audioapparaat mei Bluetooth-stipe. It berik is frij koart - sawat 10 m maksimaal.
Bluetooth-apparaten moatte 'keppele' wurde mei de Raspberry Pi SBC en sille ferskine yn 'e audio-ynstellingen op it buroblêd as dit dien is. Bluetooth is standert ynstalleare op Raspberry Pi OS, wêrby't it Bluetooth-logo ferskynt op 'e taakbalke fan it buroblêd op alle apparaten dy't Bluetooth-hardware ynstalleare hawwe (ynboud of fia in Bluetooth USB-dongle). As Bluetooth ynskeakele is, sil it ikoan blau wêze; as it útskeakele is, sil it ikoan griis wêze.
Software stipe
De ûnderlizzende audio-stipesoftware is flink feroare yn 'e folsleine Raspberry Pi OS-ôfbylding, en foar de einbrûker binne dizze feroarings meast transparant. It orizjinele lûdssubsysteem dat brûkt waard wie ALSA. Pulse Audio folge ALSA op, foardat it ferfongen waard troch it hjoeddeiske systeem, dat Pipe Wire hjit. Dit systeem hat deselde funksjonaliteit as Pulse Audio, en in kompatibel API, mar it hat ek útwreidings om fideo en oare funksjes te behanneljen, wêrtroch de yntegraasje fan fideo en audio folle makliker wurdt. Omdat Pipe Wire deselde API brûkt as Pulse Audio, wurkje Pulse Audio-hulpprogramma's prima op in Pipe Wire-systeem.
Dizze nutsfoarsjennings wurde brûkt yn 'e eksamples ûnder.
Om de ôfbyldingsgrutte leech te hâlden, brûkt Raspberry Pi OS Lite noch altyd ALSA om audio-stipe te leverjen en omfettet gjin Pipe Wire-, Pulse Audio- of Bluetooth-audiobibleteken. It is lykwols mooglik om de passende bibleteken te ynstallearjen om dy funksjes ta te foegjen as nedich, en dit proses wurdt hjirûnder ek beskreaun.
Buroblêd
Lykas hjirboppe neamd, wurde audio-operaasjes ôfhannele fia it sprekkerikoantsje op 'e taakbalke fan it buroblêd. As jo mei de linker mûsknop op it ikoan klikke, ferskine de folumeslider en de mute-knop, wylst jo mei de rjochter mûsknop in list mei beskikbere audio-apparaten iepenje. Klik gewoan op it audio-apparaat dat jo brûke wolle. Der is ek in opsje, fia in rjochter mûsknop, om de pro te feroarjen.files brûkt troch elk apparaat. Dizze profiles leverje meastentiids ferskillende kwaliteitsnivo's.
As mikrofoanstipe ynskeakele is, sil in mikrofoanikoan yn it menu ferskine; as jo hjir mei de rjochtermûsknop op klikke, krije jo mikrofoanspesifike menu-opsjes te sjen, lykas de seleksje fan ynfierapparaten, wylst jo mei de linkermûsknop op de ynfiernivo-ynstellingen klikke.
Bluetooth
Om in Bluetooth-apparaat te koppelen, klikje jo mei de linker mûsknop op it Bluetooth-ikoantsje op 'e taakbalke en selektearje dan 'Apparaat tafoegje'. It systeem sil dan begjinne te sykjen nei beskikbere apparaten, dy't yn 'Untdekke'-modus set wurde moatte om sjoen te wurden. Klik op it apparaat as it yn 'e list ferskynt en de apparaten moatte dan koppele wurde. Sadree't it keppele is, sil it audio-apparaat ferskine yn it menu, dat selektearre wurdt troch te klikken op it sprekkerikoantsje op 'e taakbalke.
Kommandorigel
Omdat Pipe Wire deselde API brûkt as Pulse Audio, wurkje de mearderheid fan 'e Pulse Audio-kommando's dy't brûkt wurde om audio te kontrolearjen op Pipe Wire. pacts is de standert manier om Pulse Audio te kontrolearjen: typ man pactl yn 'e kommandorigel foar mear details.
Foarôfgeande easken foar Raspberry Pi OS Lite
Op in folsleine ynstallaasje fan Raspberry Pi OS binne alle fereaske kommandorigel-applikaasjes en bibleteken al ynstalleare. Op 'e Lite-ferzje is Pipe Wire lykwols net standert ynstalleare en moat it mei de hân ynstalleare wurde om lûd ôf te spyljen.
Om de fereaske bibleteken foar Pipe Wire op Raspberry Pi OS Lite te ynstallearjen, fier it folgjende yn: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils As jo fan doel binne applikaasjes út te fieren dy't ALSA brûke, moatte jo ek it folgjende ynstallearje: sudo apt install pipewire-alsa
Opnij opstarte nei ynstallaasje is de maklikste manier om alles wer oan 'e gong te krijen.
Audioôfspieling bygelyksamples
Toan in koarte list mei ynstalleare Pulse-audiomodules (de lange foarm befettet in soad ynformaasje en is lestich te lêzen): $ pactl list modules short Toan in koarte list mei Pulse Audio-sinks:
$ pactl list sakket koart
Op in Raspberry Pi 5 ferbûn mei in HDMI-monitor mei ynboude audio en in ekstra USB-lûdskaart, jout dit kommando de folgjende útfier: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Piiptried s32le 2ch 48000Hz OPHANGD 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Piiptried s16le 2ch 48000Hz OPHANGD
NOAT
De Raspberry Pi 5 hat gjin analoge útfier.
Foar in Raspberry Pi OS Lite-ynstallaasje op in Raspberry Pi 4 - dy't HDMI en analoge útfier hat - wurdt it folgjende weromjûn: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Piiptried s16le 2ch 48000Hz OPHENGD
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Piiptried s32le 2ch 48000Hz OPHANGD
Om de standert sink wer te jaan en te feroarjen nei HDMI-audio (tinke dat it miskien al de standert is) op dizze ynstallaasje fan Raspberry Pi OS Lite, typ yn:
$ pactl krije-standert-sink
alsa_output.platform-bcm2835_audio.stereo-fallback
$ pactl set-default-sink 70
$ pactl krije-standert-sink
alsa_output.platform-107c701400.hdmi.hdmi-stereo
Om werom te spyljen asample, it moat earst nei de s upload wurdeampde cache, yn dit gefal op 'e standert sink. Jo kinne de sink feroarje troch de namme ta te foegjen oan 'e ein fan it pactl play-sample kommando:
$ pactl upload-sample sample.mp3 samplename
$ pactl spielje-sample samplename
Der is in Pulse Audio-kommando dat noch makliker te brûken is om audio ôf te spyljen:
$ paplay sample.mp3
pactl hat in opsje om it folume foar it ôfspyljen yn te stellen. Omdat it buroblêd Pulse Audio-hulpprogramma's brûkt om audioynformaasje te krijen en yn te stellen, sil de útfiering fan dizze kommandorigelwizigingen ek werjûn wurde yn 'e folumeslider op it buroblêd.
Dizze eksample ferminderet it folume mei 10%:
$ pactl set-sink-folume @DEFAULT_SINK@ -10%
Dizze eksample stelt it folume yn op 50%:
$ pactl set-sink-folume @DEFAULT_SINK@ 50%
Der binne in soad, in soad Pulse Audio-kommando's dy't hjir net neamd wurde. De Pulse Audio webside (https://www.freedesktop.org/wiki/Software/PulseAudio/) en de man-pagina's foar elk kommando biede wiidweidige ynformaasje oer it systeem.
Bluetooth
It kontrolearjen fan Bluetooth fan 'e kommandorigel kin in yngewikkeld proses wêze. By it brûken fan Raspberry Pi OS Lite binne de passende kommando's al ynstalleare. It nuttichste kommando is bluetoothctl, en guon foarbylden ...ampynformaasje derfan yn gebrûk wurde hjirûnder jûn.
Meitsje it apparaat ûntdekber foar oare apparaten:
$ bluetoothctl ûntdekber op
Meitsje it apparaat keppelber mei oare apparaten:
$ bluetoothctl keppelber oan
Sykje nei Bluetooth-apparaten binnen berik:
$ bluetoothctl scan oan
Skanne útskeakelje:
$ bluetoothctl scan off bluetoothctl hat ek in ynteraktive modus, dy't oproppen wurdt troch it kommando sûnder parameters te brûken. De folgjende foarbyldample fiert de ynteraktive modus út, wêrby't it list-kommando ynfierd wurdt en de resultaten werjûn wurde, op in Raspberry Pi 4 mei Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Agent registrearre
[bluetooth]# list
Kontrôler D8:3A:DD:3B:00:00 Pi4Lite [standert] [bluetooth]#
Jo kinne no kommando's yn 'e ynterpreter ynfiere en se sille útfierd wurde. In typysk proses foar it koppelen mei, en dan ferbine mei, in apparaat kin as folget lêze: $ bluetoothctl
Agent registrearre [bluetooth]# ûntdekber op
Feroaring te finen op slagge
[CHG] Controller D8:3A:DD:3B:00:00 Untdekber op [bluetooth]# keppelber op
Feroarje pairable op slagge
[CHG] Controller D8:3A:DD:3B:00:00 Koppelber op [bluetooth]# scan oan
< koe in lange list mei apparaten yn 'e buert wêze >
[bluetooth]# pear [mac-adres fan apparaat, fan it scankommando of fan it apparaat sels, yn 'e foarm xx:xx:xx:xx:xx:xx] [bluetooth]# scan út
[bluetooth]# ferbine [itselde mac-adres] It Bluetooth-apparaat moat no ferskine yn 'e list mei sinks, lykas werjûn yn dit foarbyldample fan in Raspberry Pi OS Lite ynstallaasje:
$ pactl list sakket koart
69 alsa_output.platform-bcm2835_audio.stereo-fallback Piiptried s16le 2ch 48000Hz OPHENGD
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Piiptried s32le 2ch 48000Hz OPHANGD
71 bluez_output.CA_3A_B2_CA_7C_55.1 Piiptried s32le 2ch 48000Hz OPHANGD
$ pactl set-default-sink 71
$ paplayample_audio_file>
Jo kinne dit no standert ynstelle en der audio op ôfspylje.
Konklúzjes
Der binne in oantal ferskillende manieren om in audio-útfier te produsearjen fan Raspberry Pi Ltd-apparaten, dy't foldogge oan de grutte mearderheid fan brûkerseasken. Dizze whitepaper hat dy meganismen sketst en ynformaasje jûn oer in protte dêrfan. Hopelik sil it hjir presintearre advys de einbrûker helpe by it kiezen fan it juste audio-útfierskema foar har projekt. Ienfâldich foarbyldampYnstruksjes oer hoe't jo de audiosystemen brûke kinne binne levere, mar de lêzer moat de hantliedingen en man-pagina's rieplachtsje foar de audio- en Bluetooth-kommando's foar mear details.
Raspberry Pi is in hannelsmerk fan Raspberry Pi Ltd
Raspberry Pi Ltd
Dokuminten / Resources
 |
Raspberry Pi SBCS Single Board Computer [pdf] Brûkersgids SBCS Single Board Computer, SBCS, Single Board Computer, Board Computer, Kompjûter |