En vitbok som ger en
Hög nivå överview av ljud
Alternativ på Raspberry Pi SBC:er
Raspberry Pi Ltd
Kolofon
© 2022-2025 Raspberry Pi Ltd
Denna dokumentation är licensierad under en Creative Commons Erkännande-Inga bearbetningar 4.0 International (CC BY-ND).
Version 1.0
Byggdatum: 2025-05-28
Juridisk friskrivningsklausul
TEKNISK OCH PÅLITLIGHETSDATA FÖR RASPBERRY PI-PRODUKTER (INKLUSIVE DATABLAD) SOM ÄNDRADE FRÅN TID TILL TID ("RESURSER") TILLHANDAHÅLLS AV RASPBERRY PI LTD ("RPL") "I BEFINTLIGT SKICK" OCH EVENTUELLA UTTRYCKLIGA ELLER UNDERFÖRSTÅDDA, UNDERFÖRSTÅDDA, UNDERFÖRSTÅDDA TILL FRÅSES UNDERFÖRSTÅDDA GARANTIER OM SÄLJBARHET OCH LÄMPLIGHET FÖR ETT SÄRSKILT SYFTE. I DEN MAXIMALA UTSTRÄCKNING SOM TILLÅTS AV TILLÄMPLIG LAG SKALL RPL UNDER INGEN OMSTÄNDIGHET VARA ANSVARIGT FÖR NÅGON DIREKTA, INDIREKTA, OAVSIKTLIGA, SPECIELLA, EXEMPELSKADOR ELLER FÖLJDSKADOR (INKLUSIVE, MEN INTE BEGRÄNSADE TILL ANVÄNDNING AV VAROR, UPPHANDLING AV ANVÄNDARE; , DATA , Eller vinster, eller affärsavbrott) orsakade emellertid och på någon teori om ansvar, vare sig det är i kontrakt, strikt ansvar eller skadestånd (inklusive vårdslöshet eller på annat sätt) som uppstår på något sätt ut ur användningen av resurserna, även om det är råd om möjligheten AV SÅDAN SKADA.
RPL förbehåller sig rätten att göra förbättringar, förbättringar, korrigeringar eller andra modifieringar av RESURSERNA eller de produkter som beskrivs i dem när som helst och utan ytterligare meddelande.
RESURSERNA är avsedda för skickliga användare med lämpliga nivåer av designkunskaper. Användare är ensamma ansvariga för sitt val och användning av RESURSERNA och all tillämpning av de produkter som beskrivs i dem. Användaren samtycker till att hålla RPL skadeslöst för allt ansvar, alla kostnader, skador eller andra förluster som uppstår till följd av deras användning av RESURSERNA. RPL ger användare tillstånd att använda RESURSERNA enbart i samband med Raspberry Pi-produkterna. All annan användning av RESURSERNA är förbjuden. Ingen licens beviljas till någon annan RPL- eller tredje parts immateriella rättigheter.
HÖGRISKAKTIVITETER. Raspberry Pi-produkter är inte konstruerade, tillverkade eller avsedda för användning i farliga miljöer som kräver felsäker prestanda, såsom vid drift av kärnkraftsanläggningar, flygnavigations- eller kommunikationssystem, flygtrafikledning, vapensystem eller säkerhetskritiska tillämpningar (inklusive livsuppehållande system och annan medicinteknisk utrustning), där fel på produkterna kan leda direkt till dödsfall, personskada eller allvarlig fysisk eller miljömässig skada ("Högriskaktiviteter"). RPL frånsäger sig uttryckligen alla uttryckliga eller underförstådda garantier för lämplighet för högriskaktiviteter och tar inget ansvar för användning eller inkludering av Raspberry Pi-produkter i högriskaktiviteter. Raspberry Pi-produkter tillhandahålls i enlighet med RPL:s bestämmelser. StandardvillkorRPL:s tillhandahållande av RESURSER utökar eller ändrar inte på annat sätt RPL:s Standardvillkor inklusive men inte begränsat till de ansvarsfriskrivningar och garantier som uttrycks i dem.
Dokumentversionshistorik
| Släppa | Datum | Beskrivning |
| 1 | 1 april 25 | Initial release |
Dokumentets omfattning
Detta dokument gäller för följande Raspberry Pi-produkter:
| 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 | Alla | Alla | Alla | Alla | Alla | Alla | Alla | Alla | Alla | Alla |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Introduktion
Under årens lopp har alternativen för ljudutgång på Raspberry Pi SBC:er (enkortsdatorer) blivit fler, och sättet de drivs från programvara har förändrats.
Det här dokumentet går igenom många av de tillgängliga alternativen för ljudutgång på din Raspberry Pi-enhet och ger instruktioner om hur du använder ljudalternativ från skrivbordet och kommandoraden.
Denna rapport förutsätter att Raspberry Pi-enheten kör Raspberry Pi OS och är helt uppdaterad med den senaste firmware och kärnorna.
Raspberry Pi ljudhårdvara
HDMI
Alla Raspberry Pi SBC-enheter har en HDMI-kontakt som stöder HDMI-ljud. Om du ansluter din Raspberry Pi SBC till en bildskärm eller TV med högtalare aktiveras automatiskt HDMI-ljudutgång genom dessa högtalare. HDMI-ljud är en digital signal av hög kvalitet, så resultaten kan bli mycket bra, och flerkanaligt ljud som DTS stöds.
Om du använder HDMI-video men vill att ljudsignalen ska delas upp – till exempelample, till en ampen splitter som inte stöder HDMI-ingång — då måste du använda en extra hårdvara som kallas en splitter för att extrahera ljudsignalen från HDMI-signalen. Detta kan vara dyrt, men det finns andra alternativ, och dessa beskrivs nedan.
Analog PCM/3.5 mm-uttag
Raspberry Pi-modellerna B+, 2, 3 och 4 har ett 4-poligt 3.5 mm ljuduttag som stöder ljud- och kompositvideosignaler. Detta är en analog utgång av låg kvalitet som genereras från en PCM-signal (pulskodsmodulering), men den är fortfarande lämplig för hörlurar och stationära högtalare.
NOTERA
Det finns ingen analog ljudutgång på Raspberry Pi 5.
Jackkontaktsignalerna definieras i följande tabell, med början från kabeländen och slutar vid spetsen. Kablar finns med olika tilldelningar, så se till att du har rätt.
| Jack-segmentet | Signal |
| Ärm | Video |
| Ring 2 | Jord |
| Ring 1 | Rätt |
| Dricks | Vänster |
I2S-baserade adapterkort
Alla modeller av Raspberry Pi SBC:er har en I2S-kringutrustning tillgänglig på GPIO-headern. I2S är en elektrisk seriell bussgränssnittsstandard som används för att ansluta digitala ljudenheter och kommunicera PCM-ljuddata mellan kringutrustning i en elektronisk enhet. Raspberry Pi Ltd tillverkar en rad ljudkort som ansluts till GPIO-headern och använder I2S-gränssnittet för att överföra ljuddata från SoC (system-på-ett-chip) till tilläggskortet.
Notera: Tilläggskort som ansluts via GPIO-headern och följer lämpliga specifikationer kallas HAT (Hardware Attached on Top). Deras specifikationer finns här: https://datasheets.raspberrypi.com/
Hela utbudet av ljud-HAT:er kan ses på Raspberry Pi Ltd. webplats: https://www.raspberrypi.com/products/
Det finns också ett stort antal tredjeparts-HAT:er tillgängliga för ljudutgång, till exempelampfrån Pimoroni, HiFiBerry, Adafruit, etc., och dessa erbjuder en mängd olika funktioner.
USB-ljud
Om det inte går att installera en HAT, eller om du letar efter ett snabbt och enkelt sätt att ansluta en teleplugg för ett hörlursutgång eller en mikrofoningång, då är en USB-ljudadapter ett bra val. Det här är enkla, billiga enheter som ansluts till en av USB-A-portarna på Raspberry Pi SBC.
Raspberry Pi OS innehåller drivrutiner för USB-ljud som standard; så snart en enhet är ansluten bör den visas på enhetsmenyn som visas när du högerklickar på högtalarikonen i aktivitetsfältet.
Systemet kommer också automatiskt att upptäcka om den anslutna USB-enheten har en mikrofoningång och aktivera lämpligt stöd.
Bluetooth
Bluetooth-ljud avser trådlös överföring av ljuddata via Bluetooth-teknik, vilket är mycket vanligt förekommande. Det gör det möjligt för Raspberry Pi SBC att kommunicera med Bluetooth-högtalare och hörlurar/öronsnäckor, eller andra ljudenheter med Bluetooth-stöd. Räckvidden är ganska kort – cirka 10 m som mest.
Bluetooth-enheter måste "paras ihop" med Raspberry Pi SBC och visas i ljudinställningarna på skrivbordet när detta är klart. Bluetooth är installerat som standard på Raspberry Pi OS, och Bluetooth-logotypen visas i skrivbordets aktivitetsfält på alla enheter som har Bluetooth-hårdvara installerad (antingen inbyggd eller via en Bluetooth USB-dongel). När Bluetooth är aktiverat är ikonen blå; när den är inaktiverad är ikonen grå.
Programvarustöd
Den underliggande ljudstödsprogramvaran har ändrats avsevärt i den fullständiga Raspberry Pi OS-avbildningen, och för slutanvändaren är dessa förändringar mestadels transparenta. Det ursprungliga ljudundersystemet som användes var ALSA. Pulse Audio efterträdde ALSA innan det ersattes av det nuvarande systemet, som kallas Pipe Wire. Detta system har samma funktionalitet som Pulse Audio och ett kompatibelt API, men det har också tillägg för att hantera video och andra funktioner, vilket gör integrationen av video och ljud mycket enklare. Eftersom Pipe Wire använder samma API som Pulse Audio fungerar Pulse Audio-verktygen bra på ett Pipe Wire-system.
Dessa verktyg används i examples nedan.
För att hålla nere bildstorleken använder Raspberry Pi OS Lite fortfarande ALSA för att tillhandahålla ljudstöd och inkluderar inga Pipe Wire-, Pulse Audio- eller Bluetooth-ljudbibliotek. Det är dock möjligt att installera lämpliga bibliotek för att lägga till dessa funktioner efter behov, och denna process beskrivs också nedan.
Skrivbord
Som nämnts ovan hanteras ljudfunktioner via högtalarikonen i skrivbordets aktivitetsfält. Om du vänsterklickar på ikonen visas volymreglaget och ljudavstängningsknappen, medan du högerklickar visar en lista över tillgängliga ljudenheter. Klicka bara på den ljudenhet du vill använda. Det finns också ett alternativ, via högerklicka, att ändra ljudnivån.fileanvänds av varje enhet. Dessa profiles erbjuder vanligtvis olika kvalitetsnivåer.
Om mikrofonstöd är aktiverat visas en mikrofonikon i menyn. Om du högerklickar på den visas mikrofonspecifika menyalternativ, till exempel val av inmatningsenhet, medan du vänsterklickar visar inställningar för ingångsnivå.
Bluetooth
För att para ihop en Bluetooth-enhet, vänsterklicka på Bluetooth-ikonen i aktivitetsfältet och välj sedan "Lägg till enhet". Systemet börjar sedan leta efter tillgängliga enheter, som måste försättas i "Upptäck"-läge för att visas. Klicka på enheten när den visas i listan så bör enheterna paras ihop. När de är parade visas ljudenheten i menyn, som väljs genom att klicka på högtalarikonen i aktivitetsfältet.
Kommandorad
Eftersom Pipe Wire använder samma API som Pulse Audio, fungerar majoriteten av Pulse Audio-kommandona som används för att styra ljud på Pipe Wire. pacts är standardsättet för att styra Pulse Audio: skriv man pactl i kommandoraden för mer information.
Förutsättningar för Raspberry Pi OS Lite
Vid en fullständig installation av Raspberry Pi OS är alla nödvändiga kommandoradsprogram och bibliotek redan installerade. På Lite-versionen är dock Pipe Wire inte installerat som standard och måste installeras manuellt för att kunna spela upp ljud.
För att installera de nödvändiga biblioteken för Pipe Wire på Raspberry Pi OS Lite, vänligen ange följande: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Om du tänker köra program som använder ALSA måste du också installera följande: sudo apt install pipewire-alsa
Att starta om efter installationen är det enklaste sättet att få igång allting.
Ljuduppspelning ex.amples
Visa en lista över installerade Pulse-ljudmoduler i kort form (den långa formen innehåller mycket information och är svårläst): $ pactl list modules short Visa en lista över Pulse Audio-sinks i kort form:
$ pactl-listan sjunker kort
På en Raspberry Pi 5 ansluten till en HDMI-skärm med inbyggt ljud och ett extra USB-ljudkort ger detta kommando följande utdata: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Rörkabel s32le 2-kanalig 48000Hz UPPHÄNGD 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Rörkabel s16le 2-kanalig 48000Hz UPPHÄNGD
NOTERA
Raspberry Pi 5 har ingen analog utgång.
För en Raspberry Pi OS Lite-installation på en Raspberry Pi 4 — som har HDMI och analog utgång — returneras följande: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Rörledning s16le 2-kanalig 48000Hz AVSTÄNGD
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Rörkabel s32le 2-kanalig 48000Hz HÄNGD
För att visa och ändra standardinställningen för sink till HDMI-ljud (observera att det redan kan vara standardinställningen) på den här installationen av Raspberry Pi OS Lite, skriv in:
$ pactl get-default-sink
alsa_output.platform-bcm2835_audio.stereo-fallback
$ pactl set-default-sink 70
$ pactl get-default-sink
alsa_output.platform-107c701400.hdmi.hdmi-stereo
Att spela upp somample, den måste först laddas upp till sample cache, i det här fallet på standardsinken. Du kan ändra sinken genom att lägga till dess namn i slutet av pactl play-sample kommando:
$ pactl uppladdningarampsample.mp3 samplenamn
$ pactl play-sampsamplenamn
Det finns ett Pulse Audio-kommando som är ännu enklare att använda för att spela upp ljud:
$ paplay sample.mp3
pactl har ett alternativ för att ställa in volymen för uppspelningen. Eftersom skrivbordet använder Pulse Audio-verktyg för att hämta och ställa in ljudinformation, kommer utförandet av dessa kommandoradsändringar också att återspeglas i volymreglaget på skrivbordet.
Detta example minskar volymen med 10%:
$ pactl set-sink-volym @DEFAULT_SINK@ -10%
Detta example ställer in volymen till 50%:
$ pactl set-sink-volym @DEFAULT_SINK@ 50%
Det finns många, många Pulse Audio-kommandon som inte nämns här. Pulse Audio webwebbplats (https://www.freedesktop.org/wiki/Software/PulseAudio/) och manualsidorna för varje kommando erbjuder omfattande information om systemet.
Bluetooth
Att styra Bluetooth från kommandoraden kan vara en komplicerad process. När du använder Raspberry Pi OS Lite är lämpliga kommandon redan installerade. Det mest användbara kommandot är bluetoothctl, och vissa exempelampMer information om hur den används finns nedan.
Gör enheten synbar för andra enheter:
$ bluetoothctl kan upptäckas på
Gör enheten parkopplad med andra enheter:
$ bluetoothctl parkopplad på
Skanna efter Bluetooth-enheter inom räckhåll:
$ bluetoothctl-skanning på
Stäng av skanning:
$ bluetoothctl scan off bluetoothctl har också ett interaktivt läge, som anropas genom att använda kommandot utan parametrar. Följande example kör det interaktiva läget, där list-kommandot matas in och resultaten visas, på en Raspberry Pi 4 som kör Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Agent registrerad
[bluetooth]# lista
Styrenhet D8:3A:DD:3B:00:00 Pi4Lite [standard] [bluetooth]#
Du kan nu skriva kommandon i tolken så kommer de att köras. En typisk process för att para ihop med, och sedan ansluta till, en enhet kan se ut så här: $ bluetoothctl
Agent registrerad [bluetooth]# upptäckbar på
Ändring av upptäckbar på lyckades
[CHG] Controller D8:3A:DD:3B:00:00 Synbar på [bluetooth]# parkopplingsbar på
Ändring av parbar på lyckades
[CHG] Controller D8:3A:DD:3B:00:00 Parar ihop med [bluetooth]# skanning på
< kan vara en lång lista med enheter i närheten >
[bluetooth]# par [enhetens MAC-adress, från skanningskommandot eller från själva enheten, i formen xx:xx:xx:xx:xx:xx] [bluetooth]# skanning av
[bluetooth]# anslut [samma mac-adress] Bluetooth-enheten bör nu visas i listan över mottagare, som visas i detta exempelampfrån en Raspberry Pi OS Lite-installation:
$ pactl-listan sjunker kort
69 alsa_output.platform-bcm2835_audio.stereo-fallback Rörledning s16le 2-kanalig 48000Hz AVSTÄNGD
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Rörkabel s32le 2-kanalig 48000Hz HÄNGD
71 bluez_output.CA_3A_B2_CA_7C_55.1 Rörledning s32le 2-kanalig 48000Hz HÄNGANDE
$ pactl set-default-sink 71
$ paplayample_audio_file>
Du kan nu göra detta till standardinställningen och spela upp ljud på den.
Slutsatser
Det finns ett antal olika sätt att producera ljudutgång från Raspberry Pi Ltd-enheter, vilket tillgodoser de allra flesta användarnas behov. Denna whitepaper har beskrivit dessa mekanismer och gett information om många av dem. Förhoppningen är att de råd som presenteras här kommer att hjälpa slutanvändaren att välja rätt ljudutgångsschema för sitt projekt. Enkelt exempelampInstruktioner om hur man använder ljudsystemen har tillhandahållits, men läsaren bör konsultera manualerna och manualsidorna för ljud- och Bluetooth-kommandona för mer information.
Raspberry Pi är ett varumärke som tillhör Raspberry Pi Ltd
Raspberry Pi Ltd
Dokument/resurser
 |
Raspberry Pi SBCS enkortsdator [pdf] Användarhandbok SBCS Enkortsdator, SBCS, Enkortsdator, Kortdator, Dator |