SBCS Enkelbordrekenaar
“
Produk inligting
Spesifikasies:
- Ondersteunde Raspberry Pi-modelle: Pi 0, Pi 1, Pi 2, Pi 3, Pi 4
CM1, CM3, CM4, CM5, Piko, Piko2 - Oudio-uitvoeropsies: HDMI, analoog PCM/3.5 mm-aansluiting, I2S-gebaseerd
adapterborde, USB-klank, Bluetooth - Sagteware-ondersteuning: PulseAudio, PipeWire, ALSA
Produkgebruiksinstruksies:
HDMI -klankuitgang:
Vir HDMI-klankuitvoer, koppel eenvoudig jou Raspberry Pi aan 'n
HDMI-monitor of TV met ingeboude luidsprekers.
Analoog PCM/3.5 mm-aansluiting:
Raspberry Pi-modelle B+, 2, 3 en 4 beskik oor 'n 4-polige 3.5 mm
oudio-aansluiting vir analoog oudio-uitset. Volg die seintoewysing
tabel vir korrekte verbindings.
USB-klank en Bluetooth:
Vir USB-klank- of Bluetooth-uitvoer, maak seker dat die korrekte drywers is
geïnstalleer op jou Raspberry Pi. Verwys na die gebruikershandleiding vir
gedetailleerde opstellingsinstruksies.
Sagteware-opstelling:
Om klankweergawe te aktiveer, installeer die nodige sagtewarepakkette
deur die opdragreël te gebruik. Herbegin jou Raspberry Pi na installasie
vir veranderinge om in werking te tree.
Example opdragte:
sudo apt installeer pypdraad pypdraad-puls pypdraad-klank pulseaudio-utils sudo apt installeer pypdraad-alsa pactl lys modules kort pactl lys sink kort
Gereelde vrae:
V: Watter Raspberry Pi-modelle ondersteun analoog klank
uitset?
A: Raspberry Pi-modelle B+, 2, 3 en 4 beskik oor 'n 4-polige 3.5 mm-aansluiting.
oudio-aansluiting vir analoog oudio-uitvoer.
V: Kan ek 'n USB-klankkaart met my Raspberry Pi gebruik?
A: Ja, jy kan 'n USB-klankkaart met jou Raspberry Pi gebruik vir
oudio-uitvoer. Maak seker dat die korrekte drywers geïnstalleer is.
"`
Framboos Pi
'n Witboek wat 'n hoëvlak-oorsig geeview van klankopsies op Raspberry Pi SBC's
Raspberry Pi Bpk
Raspberry Pi Bpk
'n Witboek wat 'n hoëvlak-oorsig geeview van klankopsies op Raspberry Pi SBC's
Kolofon
© 2022-2025 Raspberry Pi Bpk Hierdie dokumentasie is gelisensieer onder 'n Creative Commons Attribution-NoDerivatives 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 IMPLIESE, INGESLUIT, NIE INGESLUIT, NIE. GEÏSPLISEERDE WAARBORGE VAN VERHANDELBAARHEID EN GESKIKTHEID VIR 'N SPESIFIEKE DOEL WORD AFGEWYS. IN DIE MAKSIMUM MAAT WAT DEUR TOEPASLIKE WET TOEGESTAAN IS, SAL RPL IN GEEN GEVAL AANSPREEKLIK WEES VIR ENIGE DIREKTE, INDIREKTE, TOEVALLE, SPESIALE, VOORBEELDLIKE OF GEVOLLIKE SKADE (INSLUITEND, MAAR NIE BEPERK TOT, VERSKAFFERS NIE; VERLIES AAN GEBRUIK, DATA OF WINSTE OF BESIGHEIDSONDERBREUKING) HOOF OOR ENIGE TEORIE VAN AANSPREEKLIKHEID, HETsy IN KONTRAK, STRENG AANSPREEKLIKHEID, OF OORTREDING (INSLUITEND NALATIGHEID OF ANDERS DIE GEBRUIK WAT ONTSTAAN; INDIEN DIE MOONTLIKHEID VAN SO SKADE IN KENNIS gestel. 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 HULPBRONNE is bedoel vir geskoolde gebruikers met geskikte vlakke van ontwerpkennis. Gebruikers is alleen verantwoordelik vir hul keuse en gebruik van die HULPBRONNE en enige toepassing van die produkte wat daarin beskryf word. Gebruiker stem in om RPL te vrywaar en skadeloos te hou teen alle aanspreeklikhede, koste, skade of ander verliese wat voortspruit uit hul gebruik van die HULPBRONNE. RPL gee gebruikers toestemming om die HULPBRONNE uitsluitlik in samewerking met die Raspberry Pi-produkte te gebruik. Alle ander gebruik van die HULPBRONNE is verbode. Geen lisensie word aan enige ander EVL of ander derdeparty intellektuele eiendomsreg toegestaan nie. HOË RISIKO AKTIWITEITE. Raspberry Pi-produkte is nie ontwerp, vervaardig of bedoel vir gebruik in gevaarlike omgewings wat mislukte veilige werkverrigting vereis nie, soos in die bedryf van kernfasiliteite, vliegtuignavigasie- of kommunikasiestelsels, lugverkeerbeheer, wapenstelsels of veiligheidskritieke toepassings (insluitend lewensondersteuningstelsels en ander mediese toestelle), waarin die mislukking van die produkte direk tot die dood, persoonlike besering of skade aan die omgewing kan lei (“gevaarlike fisiese beserings of ernstige skade”). RPL ontken 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 Standaardbepalings. RPL se voorsiening van die HULPBRONNE brei nie RPL se Standaardbepalings uit of wysig andersins nie, insluitend maar nie beperk tot die vrywarings en waarborge wat daarin uitgedruk word nie.
Wetlike vrywaringskennisgewing
2
'n Witboek wat 'n hoëvlak-oorsig geeview van klankopsies op Raspberry Pi SBC's
Dokument weergawe geskiedenis
Vrystellingsdatum
Beskrywing
1.0
1 Apr 2025 Aanvanklike vrystelling
Omvang van dokument
Hierdie dokument is van toepassing op die volgende Raspberry Pi-produkte:
Pi 0
Pi 1
Pi 2
Pi Pi Pi Pi Pi CM1 CM3 CM4 CM5 Pico Pico2
3
4 400 5 500
0 WHABABB Alles Alles Alles Alles Alles Alles Alles Alles Alles Alles
Omvang van dokument
1
'n Witboek wat 'n hoëvlak-oorsig geeview van klankopsies op Raspberry Pi SBC's
Inleiding
Oor die jare het die beskikbare opsies 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 Raspberry Pi OS gebruik en ten volle op datum is met die nuutste firmware en kernels.
Inleiding
2
'n Witboek wat 'n hoëvlak-oorsig geeview van klankopsies op Raspberry Pi SBC's
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 multikanaal-klank soos DTS word ondersteun. As jy HDMI-video gebruik, maar wil hê dat die klanksein afgesplits word – byvoorbeeld.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-segmentsein
Mou
Video
Skakel 2
Grond
Skakel 1
Reg
Wenk
Links
I2S-gebaseerde adapterborde
Alle modelle van Raspberry Pi SBC's het 'n I2S-randapparaat 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 oudiadata van die SoC (stelsel op 'n skyfie) na die byvoegbord oor te dra. Let wel: Byvoegborde wat via die GPIO-kopstuk koppel 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 gesien word op die Raspberry Pi Bpk. 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
Indien dit nie moontlik is om 'n HAT te installeer nie, of as jy opsoek is na 'n vinnige en maklike manier om 'n jack-prop vir 'n koptelefoon-uitset of 'n mikrofoon-inset aan te sluit, 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 sluit standaard drywers vir USB-klank in; 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 mikrofoon-inset het en die toepaslike ondersteuning aktiveer.
USB-klank
3
'n Witboek wat 'n hoëvlak-oorsig geeview van klankopsies op Raspberry Pi SBC's
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 taakbalk van die lessenaar 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.
Bluetooth
4
'n Witboek wat 'n hoëvlak-oorsig geeview van klankopsies op Raspberry Pi SBC's
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. PulseAudio het ALSA opgevolg voordat dit vervang is deur die huidige stelsel, wat PipeWire genoem word. Hierdie stelsel het dieselfde funksionaliteit as PulseAudio, 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 PipeWire dieselfde API as PulseAudio gebruik, werk PulseAudio-hulpprogramme goed op 'n PipeWire-stelsel. Hierdie hulpprogramme word in die eks gebruik.amples hieronder. Om die beeldgrootte klein te hou, gebruik Raspberry Pi OS Lite steeds ALSA om klankondersteuning te bied en sluit geen PipeWire-, PulseAudio- of Bluetooth-klankbiblioteke in nie. Dit is egter moontlik om die toepaslike biblioteke te installeer om daardie funksies by te voeg soos nodig, 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. As mikrofoonondersteuning geaktiveer is, sal 'n mikrofoonikoon op die kieslys verskyn; as jy hierop regs klik, sal mikrofoonspesifieke kieslysopsies verskyn, soos die keuse van invoertoestel, terwyl as jy links klik, invoervlakinstellings verskyn. 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 PipeWire dieselfde API as PulseAudio gebruik, werk die meerderheid van die PulseAudio-opdragte wat gebruik word om klank te beheer op PipeWire. pactl is die standaard manier om PulseAudio 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 PipeWire egter nie standaard geïnstalleer nie en moet dit handmatig geïnstalleer word om klank te kan speel. Om die vereiste biblioteke vir PipeWire op Raspberry Pi OS Lite te installeer, voer asseblief die volgende in:
sudo apt installeer pypdraad pypdraad-puls pypdraad-klank pulseaudio-utils
As jy van plan is om toepassings te gebruik wat ALSA gebruik, sal jy ook die volgende moet installeer:
sudo apt installeer pypleiding-alsa
Om alles weer te begin na die installasie is die maklikste manier om dit aan die gang te kry. Oudio-terugspeel bv.ampVertoon 'n lys van geïnstalleerde PulseAudio-modules in kort vorm (die lang vorm bevat baie inligting en is moeilik om te lees):
$ pactl lys modules kort
Wys 'n lys van PulseAudio-sinks in kort vorm:
Opdragreël
5
'n Witboek wat 'n hoëvlak-oorsig geeview van klankopsies op Raspberry Pi SBC's
$ 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 lys sink kort 179 alsa_output.platform-107c701400.hdmi.hdmi-stereo PipeWire s32le 2ch 48000Hz GESKORT 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output PipeWire s16le 2ch 48000Hz GESKORT
LET WEL Raspberry Pi 5 het nie 'n analoog-uitvoer nie. Vir 'n Raspberry Pi OS Lite-installasie op 'n Raspberry Pi 4 — wat HDMI en 'n analoog-uitvoer het — word die volgende terugbesorg:
$ pactl lys sink kort 69 alsa_output.platform-bcm2835_audio.stereo-fallback PipeWire s16le 2ch 48000Hz OPGESKORT 70 alsa_output.platform-107c701400.hdmi.hdmi-stereo PipeWire s32le 2ch 48000Hz OPGESKORT
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-verstek-sink alsa_uitvoer.platform-bcm2835_audio.stereo-terugval $ pactl stel-verstek-sink 70 $ pactl kry-verstek-sink alsa_uitvoer.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 samplename $ pactl speel-sampdieamplenaam
Daar is 'n PulseAudio-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 PulseAudio-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 bv.ample 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 PulseAudio-opdragte wat nie hier genoem word nie. Die PulseAudio webwebwerf (https://www.freedesktop.org/wiki/Software/PulseAudio/) en die manbladsye vir elke opdrag bied uitgebreide inligting oor die stelsel.
Opdragreël
6
'n Witboek wat 'n hoëvlak-oorsig geeview van klankopsies op Raspberry Pi SBC's
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 voorbeeldeampLesse 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 skandering af
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 Kontroleerder 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 Verander ontdekbaar op geslaagde [CHG] Kontroleerder D8:3A:DD:3B:00:00 Ontdekbaar op [bluetooth]# paarbaar op Verander koppelbaar op geslaagde [CHG] Kontroleerder D8:3A:DD:3B:00:00 Paarbaar op [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]# skandeer 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 PipeWire s16le 2ch 48000Hz GESKORT 70 alsa_output.platform-107c701400.hdmi.hdmi-stereo PipeWire s32le 2ch 48000Hz GESKORT 71 bluez_output.CA_3A_B2_CA_7C_55.1 PipeWire s32le 2ch 48000Hz GESKORT
Opdragreël
7
'n Witboek wat 'n hoëvlak-oorsig geeview van klankopsies op Raspberry Pi SBC's
$ pactl stel-standaard-sink 71 $ paplayample_klank_file>
Jy kan dit nou die verstekwaarde maak en klank daarop terugspeel.
Opdragreël
8
'n Witboek wat 'n hoëvlak-oorsig geeview van klankopsies op Raspberry Pi SBC's
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.
Gevolgtrekkings
9
Raspberry Pi 'n Witboek wat 'n hoëvlak-oorsig geeview van klankopsies op Raspberry Pi SBC's
Framboos Pi
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 |