En hvidbog, der giver en
Højniveau overview af lyd
Indstillinger på Raspberry Pi SBC'er
Raspberry Pi Ltd
Kolofon
© 2022-2025 Raspberry Pi Ltd
Denne dokumentation er licenseret under en Creative Commons Navngivelse-Ingen Afledninger 4.0 International (CC BY-ND).
Version 1.0
Byggedato: 28/05/2025
Juridisk ansvarsfraskrivelse
TEKNISKE DATA OG PÅLIDELIGHED FOR RASPBERRY PI-PRODUKTER (INKLUSIVE DATABLAD) SOM ÆNDRET FRA TID TIL ANDEN (“RESOURCER”) LEVERES AF RASPBERRY PI LTD (“RPL”) “SOM DE ER” OG EVENTUELLE UDTRYKKELIGE ELLER UNDERFORSTÅET, UNDERFORSTÅET, UNDERFORSTÅET TIL ER DE UNDERFORSTÅEDE GARANTIER FOR SALGBARHED OG EGNETHED TIL ET BESTEMT FORMÅL FRASKRIFTLIG. I DET MAKSIMALTE OMFANG, DER ER TILLADET AF GÆLDENDE LOV, KAN RPL UNDER INGEN OMSTÆNDIGHEDER VÆRE ANSVARLIG FOR NOGEN DIREKTE, INDIREKTE, TILFÆLDELIGE, SÆRLIGE, EKSEMPEL- ELLER FØLGESKADER (INKLUSIVE, MEN IKKE BEGRÆNSET TIL, UDBYGNINGER, UDBYGNINGER, UDBYGNINGER, DATA ELLER FORTJENESTE ELLER VIRKSOMHEDSAFBRYDELSE) HVORDAN FORÅRSAGET OG PÅ ENHVER ANSVARSTEORI, HVIS I KONTRAKTER, STRIKT ANSVAR, ELLER ORGANISATION (HERunder Uagtsomhed ELLER ANDEN MÅDE), SOM ER OPSTÅET PÅ ENHVER MÅDE UD AF DET ANVENDELSE, AF SÅDAN SKADE.
RPL forbeholder sig retten til at foretage eventuelle forbedringer, forbedringer, rettelser eller andre ændringer af RESSOURCERNE eller produkter beskrevet i dem til enhver tid og uden yderligere varsel.
RESSOURCERNE er beregnet til erfarne brugere med passende niveauer af designviden. Brugerne er eneansvarlige for deres valg og brug af RESSOURCERNE og enhver anvendelse af de produkter, der er beskrevet i dem. Brugeren accepterer at skadesløsholde og holde RPL skadesløs for alt ansvar, omkostninger, skader eller andre tab, der måtte opstå som følge af deres brug af RESSOURCERNE. RPL giver brugerne tilladelse til udelukkende at bruge RESSOURCERNE i forbindelse med Raspberry Pi-produkterne. Al anden brug af RESSOURCERNE er forbudt. Der gives ingen licens til nogen anden RPL- eller tredjeparts immaterielle rettigheder.
HØJRISIKOAKTIVITETER. Raspberry Pi-produkter er ikke designet, fremstillet eller beregnet til brug i farlige miljøer, der kræver fejlsikker ydeevne, såsom drift af nukleare anlæg, flynavigations- eller kommunikationssystemer, lufttrafikkontrol, våbensystemer eller sikkerhedskritiske applikationer (herunder livsstøttende systemer og andet medicinsk udstyr), hvor produkternes svigt kan føre direkte til død, personskade eller alvorlig fysisk eller miljømæssig skade ("Højrisikoaktiviteter"). RPL fraskriver sig specifikt enhver udtrykkelig eller stiltiende garanti for egnethed til højrisikoaktiviteter og påtager sig intet ansvar for brug eller inkludering af Raspberry Pi-produkter i højrisikoaktiviteter. Raspberry Pi-produkter leveres underlagt RPL's StandardvilkårRPL's tilvejebringelse af RESSOURCERNE udvider eller ændrer ikke på anden måde RPL's Standardvilkår herunder, men ikke begrænset til, de ansvarsfraskrivelser og garantier, der er udtrykt i dem.
Dokumentversionshistorik
| Frigøre | Dato | Beskrivelse |
| 1 | 1-apr-25 | Første udgivelse |
Dokumentets omfang
Dette dokument gælder for følgende 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 | Alle | Alle | Alle | Alle | Alle | Alle | Alle | Alle | Alle | Alle |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Indledning
Gennem årene er mulighederne for lydudgang på Raspberry Pi SBC'er (single-board computere) blevet flere, og måden, de styres fra software, har ændret sig.
Dette dokument gennemgår mange af de tilgængelige muligheder for lydoutput på din Raspberry Pi-enhed og giver instruktioner om, hvordan du bruger lydindstillinger fra skrivebordet og kommandolinjen.
Denne whitepaper forudsætter, at Raspberry Pi-enheden kører Raspberry Pi OS og er fuldt opdateret med den nyeste firmware og kerner.
Raspberry Pi lydhardware
HDMI
Alle Raspberry Pi SBC'er har et HDMI-stik, der understøtter HDMI-lyd. Når du tilslutter din Raspberry Pi SBC til en skærm eller et fjernsyn med højttalere, aktiveres HDMI-lydoutput automatisk gennem disse højttalere. HDMI-lyd er et digitalt signal af høj kvalitet, så resultaterne kan være meget gode, og flerkanalslyd som DTS understøttes.
Hvis du bruger HDMI-video, men ønsker at lydsignalet skal opdeles – f.eks.ample, til en ampen splitter, der ikke understøtter HDMI-indgang — skal du bruge et ekstra stykke hardware kaldet en splitter til at udtrække lydsignalet fra HDMI-signalet. Dette kan være dyrt, men der findes andre muligheder, og disse er beskrevet nedenfor.
Analog PCM/3.5 mm jackstik
Raspberry Pi-modellerne B+, 2, 3 og 4 har et 4-polet 3.5 mm lydstik, der kan understøtte lyd- og kompositvideosignaler. Dette er en analog udgang af lav kvalitet, der genereres fra et PCM-signal (pulskodemodulation), men den er stadig egnet til hovedtelefoner og stationære højttalere.
NOTE
Der er ingen analog lydudgang på Raspberry Pi 5.
Jackstikkets signaler er defineret i følgende tabel, startende fra kabelenden og sluttende ved spidsen. Kabler fås med forskellige tildelinger, så sørg for at du har den korrekte.
| Jack-segment | Signal |
| Ærme | Video |
| Ring 2 | Jord |
| Ring 1 | Højre |
| Tip | Venstre |
I2S-baserede adapterkort
Alle modeller af Raspberry Pi SBC'er har en I2S-periferiudstyr tilgængelig på GPIO-headeren. I2S er en elektrisk seriel busgrænsefladestandard, der bruges til at forbinde digitale lydenheder og kommunikere PCM-lyddata mellem periferiudstyr i en elektronisk enhed. Raspberry Pi Ltd fremstiller en række lydkort, der tilsluttes GPIO-headeren og bruger I2S-grænsefladen til at overføre lyddata fra SoC'en (system-on-a-chip) til tilføjelseskortet.
Note: Tilføjelseskort, der tilsluttes via GPIO-headeren og overholder de relevante specifikationer, kaldes HAT'er (Hardware Attached on Top). Deres specifikationer kan findes her: https://datasheets.raspberrypi.com/
Det fulde udvalg af audio HAT'er kan ses på Raspberry Pi Ltd. webwebsted: https://www.raspberrypi.com/products/
Der findes også et stort antal tredjeparts HAT'er til lydoutput, f.eks.ampfra Pimoroni, HiFiBerry, Adafruit osv., og disse tilbyder en lang række forskellige funktioner.
USB-lyd
Hvis det ikke er muligt at installere en HAT, eller du leder efter en hurtig og nem måde at tilslutte et jackstik til en hovedtelefonudgang eller en mikrofonindgang, så er en USB-lydadapter et godt valg. Disse er enkle, billige enheder, der tilsluttes en af USB-A-portene på Raspberry Pi SBC.
Raspberry Pi OS inkluderer som standard drivere til USB-lyd; så snart en enhed er tilsluttet, burde den vises i enhedsmenuen, der vises, når der højreklikkes på højttalerikonet på proceslinjen.
Systemet vil også automatisk registrere, om den tilsluttede USB-enhed har en mikrofonindgang, og aktivere den relevante understøttelse.
Bluetooth
Bluetooth-lyd refererer til trådløs transmission af lyddata via Bluetooth-teknologi, som er meget udbredt. Det gør det muligt for Raspberry Pi SBC at kommunikere med Bluetooth-højttalere og hovedtelefoner/ørepropper eller enhver anden lydenhed med Bluetooth-understøttelse. Rækkevidden er forholdsvis kort - maksimalt omkring 10 m.
Bluetooth-enheder skal 'parres' med Raspberry Pi SBC'en, og de vises i lydindstillingerne på skrivebordet, når dette er gjort. Bluetooth er installeret som standard på Raspberry Pi OS, og Bluetooth-logoet vises på skrivebordets proceslinje på alle enheder, der har Bluetooth-hardware installeret (enten indbygget eller via en Bluetooth USB-dongle). Når Bluetooth er aktiveret, vil ikonet være blåt; når det er deaktiveret, vil ikonet være gråt.
Software support
Den underliggende lydunderstøttelsessoftware har ændret sig betydeligt i det fulde Raspberry Pi OS-billede, og for slutbrugeren er disse ændringer for det meste gennemsigtige. Det oprindelige lydundersystem, der blev brugt, var ALSA. Pulse Audio efterfulgte ALSA, før det blev erstattet af det nuværende system, der kaldes Pipe Wire. Dette system har den samme funktionalitet som Pulse Audio og en kompatibel API, men det har også udvidelser til at håndtere video og andre funktioner, hvilket gør integrationen af video og lyd meget nemmere. Fordi Pipe Wire bruger den samme API som Pulse Audio, fungerer Pulse Audio-værktøjerne fint på et Pipe Wire-system.
Disse værktøjer bruges i f.eks.amples nedenfor.
For at holde billedstørrelsen nede bruger Raspberry Pi OS Lite stadig ALSA til at understøtte lyd og inkluderer ikke nogen Pipe Wire-, Pulse Audio- eller Bluetooth-lydbiblioteker. Det er dog muligt at installere de relevante biblioteker for at tilføje disse funktioner efter behov, og denne proces er også beskrevet nedenfor.
Desktop
Som nævnt ovenfor håndteres lydbetjening via højttalerikonet på skrivebordets proceslinje. Venstreklik på ikonet åbner lydstyrkeskyderen og mute-knappen, mens højreklik åbner en liste over tilgængelige lydenheder. Du skal blot klikke på den lydenhed, du vil bruge. Der er også en mulighed for at ændre lydstyrken via højreklik.filebruges af hver enhed. Disse profiles tilbyder normalt forskellige kvalitetsniveauer.
Hvis mikrofonunderstøttelse er aktiveret, vises et mikrofonikon i menuen. Højreklik på dette ikon viser mikrofonspecifikke menupunkter, f.eks. valg af inputenhed, mens venstreklik viser indstillinger for inputniveau.
Bluetooth
For at parre en Bluetooth-enhed skal du venstreklikke på Bluetooth-ikonet på proceslinjen og derefter vælge 'Tilføj enhed'. Systemet vil derefter begynde at søge efter tilgængelige enheder, som skal sættes i 'Opdag'-tilstand for at blive set. Klik på enheden, når den vises på listen, og enhederne burde derefter parres. Når den er parret, vises lydenheden i menuen, som vælges ved at klikke på højttalerikonet på proceslinjen.
Kommandolinje
Fordi Pipe Wire bruger den samme API som Pulse Audio, fungerer størstedelen af de Pulse Audio-kommandoer, der bruges til at styre lyd, på Pipe Wire. pacts er standardmåden til at styre Pulse Audio: skriv man pactl i kommandolinjen for at få flere oplysninger.
Forudsætninger for Raspberry Pi OS Lite
På en fuld installation af Raspberry Pi OS er alle nødvendige kommandolinjeprogrammer og biblioteker allerede installeret. På Lite-versionen er Pipe Wire dog ikke installeret som standard og skal installeres manuelt for at kunne afspille lyd.
For at installere de nødvendige biblioteker til Pipe Wire på Raspberry Pi OS Lite, skal du indtaste følgende: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Hvis du har til hensigt at køre programmer, der bruger ALSA, skal du også installere følgende: sudo apt install pipewire-alsa
Genstart efter installationen er den nemmeste måde at få alt op at køre.
Lydafspilning f.eks.amples
Vis en liste over installerede Pulse-lydmoduler i kort form (den lange form indeholder en masse information og er svær at læse): $ pactl list modules short Vis en liste over Pulse Audio-sinks i kort form:
$ pactl-listen synker til kort
På en Raspberry Pi 5 tilsluttet en HDMI-skærm med indbygget lyd og et ekstra USB-lydkort, giver denne kommando følgende output: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Rørledning s32le 2-kanals 48000Hz OPHÆNGET 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Rørledning s16le 2-kanals 48000Hz OPHÆNGET
NOTE
Raspberry Pi 5 har ikke analog udgang.
For en Raspberry Pi OS Lite-installation på en Raspberry Pi 4 — som har HDMI og analog udgang — returneres følgende: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Rørledning s16le 2-kanals 48000Hz OPHÆNGET
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Rørledning s32le 2-kanals 48000Hz OPHÆNGET
For at vise og ændre standardsinken til HDMI-lyd (bemærk at det muligvis allerede er standard) på denne installation af Raspberry Pi OS Lite, skal du skrive:
$ pactl get-default-sink
alsa_output.platform-bcm2835_audio.stereo-fallback
$ pactl sæt-standard-vask 70
$ pactl get-default-sink
alsa_output.platform-107c701400.hdmi.hdmi-stereo
At afspille somample, den skal først uploades til sample cache, i dette tilfælde på standardsinken. Du kan ændre sinken ved at tilføje dens navn til slutningen af pactl play-sample kommando:
$ pactl upload-sampsample.mp3 samplenavn
$ pactl play-sampsamplenavn
Der er en Pulse Audio-kommando, der er endnu nemmere at bruge til at afspille lyd:
$ paplay sample.mp3
pactl har en mulighed for at indstille lydstyrken for afspilningen. Da skrivebordet bruger Pulse Audio-værktøjer til at hente og indstille lydinformation, vil udførelsen af disse kommandolinjeændringer også afspejles i lydstyrkeskyderen på skrivebordet.
Denne example reducerer lydstyrken med 10%:
$ pactl sæt-vask-volumen @DEFAULT_SINK@ -10%
Denne example sætter lydstyrken til 50%:
$ pactl sæt-sink-volumen @DEFAULT_SINK@ 50%
Der er mange, mange Pulse Audio-kommandoer, som ikke er nævnt her. Pulse Audio webwebsted (https://www.freedesktop.org/wiki/Software/PulseAudio/) og man-siderne for hver kommando tilbyder omfattende information om systemet.
Bluetooth
Det kan være kompliceret at styre Bluetooth fra kommandolinjen. Når du bruger Raspberry Pi OS Lite, er de relevante kommandoer allerede installeret. Den mest nyttige kommando er bluetoothctl, og nogle eksemplerampLæs mere om det i brug er angivet nedenfor.
Gør enheden synlig for andre enheder:
$ bluetoothctl kan findes på
Gør enheden parbar med andre enheder:
$ bluetoothctl kan parres på
Søg efter Bluetooth-enheder inden for rækkevidde:
$ bluetoothctl scanning aktiveret
Slå scanning fra:
$ bluetoothctl scan off bluetoothctl har også en interaktiv tilstand, som aktiveres ved at bruge kommandoen uden parametre. Følgende eksempelample kører den interaktive tilstand, hvor list-kommandoen indtastes og resultaterne vises, på en Raspberry Pi 4, der kører Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Agent registreret
[bluetooth]# liste
Controller D8:3A:DD:3B:00:00 Pi4Lite [standard] [bluetooth]#
Du kan nu skrive kommandoer i fortolkeren, og de vil blive udført. En typisk proces til at parre med og derefter oprette forbindelse til en enhed kan lyde som følger: $ bluetoothctl
Agent registreret [bluetooth]# synlig på
Ændring af synlig på lykkedes
[CHG] Controller D8:3A:DD:3B:00:00 Kan findes på [bluetooth]# kan parres på
Ændring af parbar på lykkedes
[CHG] Controller D8:3A:DD:3B:00:00 Kan parres på [bluetooth]# scanning til
< kunne være en lang liste over enheder i nærheden >
[bluetooth]# par [enhedens MAC-adresse, fra scanningskommandoen eller fra selve enheden, i formatet xx:xx:xx:xx:xx:xx] [bluetooth]# scanning fra
[bluetooth]# connect [samme mac-adresse] Bluetooth-enheden skulle nu blive vist på listen over sinks, som vist i dette eksempelampfil fra en Raspberry Pi OS Lite installation:
$ pactl-listen synker til kort
69 alsa_output.platform-bcm2835_audio.stereo-fallback Rørledning s16le 2-kanals 48000Hz OPHÆNGET
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Rørledning s32le 2-kanals 48000Hz OPHÆNGET
71 bluez_output.CA_3A_B2_CA_7C_55.1 Rørledning s32le 2-kanals 48000Hz OPHÆNGET
$ pactl sæt-standard-vask 71
$ paplayample_audio_file>
Du kan nu gøre dette til standardindstillingen og afspille lyd på den.
Konklusioner
Der findes en række forskellige måder at producere lydoutput fra Raspberry Pi Ltd-enheder på, som imødekommer langt de fleste brugerkrav. Denne whitepaper har skitseret disse mekanismer og givet information om mange af dem. Det er håbet, at de råd, der præsenteres her, vil hjælpe slutbrugeren med at vælge den rigtige lydoutputordning til deres projekt. Simpelt eksempelampDer er givet vejledning i, hvordan man bruger lydsystemerne, men læseren bør konsultere manualerne og manualsiderne for lyd- og Bluetooth-kommandoerne for at få flere oplysninger.
Raspberry Pi er et varemærke tilhørende Raspberry Pi Ltd
Raspberry Pi Ltd
Dokumenter/ressourcer
 |
Raspberry Pi SBCS enkeltkortcomputer [pdfBrugervejledning SBCS enkeltkortcomputer, SBCS, enkeltkortcomputer, indbygget computer, computer |