Bijela knjiga koja daje
Visokonivo iznadview zvuka
Opcije na Raspberry Pi SBC-ima
Raspberry Pi Ltd
Kolofon
© 2022-2025 Raspberry Pi Ltd
Ova dokumentacija je licencirana pod Creative Commons Attribution-No Derivatives 4.0 International (CC BY-ND).
Verzija 1.0
Datum izgradnje: 28.05.2025.
Pravno obaveštenje o odricanju od odgovornosti
TEHNIČKE PODATKE I POUZDANOST ZA PROIZVODE RASPBERRY PI (UKLJUČUJUĆI LISTE PODATAKA) KOJE SE S VREMENA NA VREME MODIFIKUJU (“RESURSI”) OBEZBEĐUJE RASPBERRY PI LTD (“RPL”) “KAKO JESU” I BILO KOJI IZRIČITO, NJ. DA SE IMPLICIRANE GARANCIJE O PRODAJNOSTI I PRIKLADNOSTI ZA ODREĐENU NAMJENU ODRIČE. U MAKSIMALNOJ MERI KOJI JE DOZVOLJENO VAŽEĆIM ZAKONOM NI U KOJEM SLUČAJU RPL NEĆE BITI ODGOVORAN ZA BILO KAKVE DIREKTNE, INDIREKTNE, SLUČAJNE, POSEBNE, PRIMJERNE ILI POSLJEDIČNE ŠTETE (UKLJUČUJUĆI, DA GODINE, ALI KOJI SE ODGOVARAJU GUBITAK KORIŠĆENJA, PODATAKA , ILI DOBITAKA; ILI PREKIDA POSLOVANJA) KOJI BI BILO UZROK I NA BILO KOJOJ TEORIJI ODGOVORNOSTI, BILO U UGOVORU, STROGOJ ODGOVORNOSTI ILI DEŽITNOM DELATKU (UKLJUČUJUĆI NEMAR ILI NA DRUGAČIJEG DRŽAVE) KOJI NASTAJE NA BILO KOJI NAČIN BILO KOJI IZ NJEGA ILITY TAKVE ŠTETE.
RPL zadržava pravo da izvrši bilo kakva poboljšanja, poboljšanja, ispravke ili bilo koje druge modifikacije RESURSA ili bilo kojih proizvoda opisanih u njima u bilo koje vrijeme i bez daljnje najave.
RESURSI su namijenjeni vještim korisnicima s odgovarajućim nivoom znanja o dizajnu. Korisnici su isključivo odgovorni za svoj odabir i korištenje RESURSA i bilo koju primjenu proizvoda opisanih u njima. Korisnik se slaže da obešteti i zaštiti RPL od svih obaveza, troškova, šteta ili drugih gubitaka koji proizlaze iz njihovog korištenja RESURSA. RPL daje korisnicima dozvolu da koriste RESURSE isključivo u kombinaciji s Raspberry Pi proizvodima. Svaka druga upotreba RESURSA je zabranjena. Ne dodjeljuje se licenca za bilo koje drugo RPL ili pravo intelektualnog vlasništva treće strane.
AKTIVNOSTI VISOKOG RIZIKA. Raspberry Pi proizvodi nisu dizajnirani, proizvedeni niti namijenjeni za upotrebu u opasnim okruženjima koja zahtijevaju sigurne performanse, kao što je rad nuklearnih postrojenja, navigacijski ili komunikacijski sistemi za avione, kontrola zračnog prometa, sistemi naoružanja ili sigurnosno kritične aplikacije (uključujući sisteme za održavanje života i druge medicinske uređaje), u kojima bi kvar proizvoda mogao direktno dovesti do smrti, tjelesnih povreda ili teške fizičke ili ekološke štete („Aktivnosti visokog rizika“). RPL se posebno odriče bilo kakve izričite ili implicitne garancije pogodnosti za aktivnosti visokog rizika i ne preuzima nikakvu odgovornost za upotrebu ili uključivanje Raspberry Pi proizvoda u aktivnosti visokog rizika. Raspberry Pi proizvodi se isporučuju u skladu sa RPL-ovim Standardni usloviRPL-ovo pružanje RESURSA ne proširuje niti na drugi način mijenja RPL-ove Standardni uslovi uključujući, ali ne ograničavajući se na odricanja odgovornosti i garancije izražene u njima.
Istorija verzija dokumenta
| Pusti | Datum | Opis |
| 1 | 1-apr-25 | Prvo izdanje |
Obim dokumenta
Ovaj dokument se odnosi na sljedeće Raspberry Pi proizvode:
| 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 | Sve | Sve | Sve | Sve | Sve | Sve | Sve | Sve | Sve | Sve |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Uvod
Tokom godina, opcije dostupne za audio izlaz na Raspberry Pi SBC-ima (jednopločnim računarima) postale su brojnije, a način na koji se njima upravlja putem softvera se promijenio.
Ovaj dokument će proći kroz mnoge dostupne opcije za audio izlaz na vašem Raspberry Pi uređaju i pružiti upute o tome kako koristiti audio opcije s radne površine i komandne linije.
Ovaj dokument pretpostavlja da Raspberry Pi uređaj koristi Raspberry Pi OS i da je u potpunosti ažuriran s najnovijim firmverom i kernelima.
Raspberry Pi audio hardver
HDMI
Svi Raspberry Pi SBC-ovi imaju HDMI konektor koji podržava HDMI audio. Spajanje vašeg Raspberry Pi SBC-a na monitor ili televizor sa zvučnicima automatski će omogućiti HDMI audio izlaz preko tih zvučnika. HDMI audio je visokokvalitetni digitalni signal, tako da rezultati mogu biti vrlo dobri, a podržan je i višekanalni zvuk poput DTS-a.
Ako koristite HDMI video, ali želite da se audio signal odvoji - na primjerample, do ampuređaj koji ne podržava HDMI ulaz - tada ćete morati koristiti dodatni hardver koji se zove razdjelnik kako biste izdvojili audio signal iz HDMI signala. Ovo može biti skupo, ali postoje i druge opcije, a one su opisane u nastavku.
Analogni PCM/3.5 mm priključak
Raspberry Pi modeli B+, 2, 3 i 4 imaju 4-polni 3.5 mm audio priključak koji može podržavati audio i kompozitne video signale. Ovo je analogni izlaz niske kvalitete generiran iz PCM (pulsno-kodna modulacija) signala, ali je i dalje pogodan za slušalice i desktop zvučnike.
NAPOMENA
Raspberry Pi 5 nema analogni audio izlaz.
Signali utikača su definisani u sljedećoj tabeli, počevši od kraja kabla i završavajući na vrhu. Kablovi su dostupni sa različitim namjenama, stoga se uvjerite da imate ispravnu.
| Segment Jacka | Signal |
| Rukav | Video |
| Prsten 2 | Ground |
| Prsten 1 | U redu |
| Savjet | lijevo |
Adapterske ploče bazirane na I2S-u
Svi modeli Raspberry Pi SBC-ova imaju I2S periferni uređaj dostupan na GPIO konektoru. I2S je standard električnog serijskog magistralnog interfejsa koji se koristi za povezivanje digitalnih audio uređaja i komunikaciju PCM audio podataka između perifernih uređaja u elektronskom uređaju. Raspberry Pi Ltd proizvodi niz audio ploča koje se povezuju na GPIO konektor i koriste I2S interfejs za prenos audio podataka sa SoC-a (sistem na čipu) na dodatnu ploču.
Napomena: Dodatne ploče koje se povezuju putem GPIO konektora i pridržavaju se odgovarajućih specifikacija poznate su kao HAT (Hardware Attached on Top - hardver pričvršćen na vrh). Njihove specifikacije možete pronaći ovdje: https://datasheets.raspberrypi.com/
Cijeli asortiman audio HAT-ova možete vidjeti na Raspberry Pi Ltd. webstranica: https://www.raspberrypi.com/products/
Također je dostupan veliki broj HAT-ova trećih strana za audio izlaz, na primjerampod Pimoronija, HiFiBerryja, Adafruita itd., a oni pružaju mnoštvo različitih funkcija.
USB audio
Ako nije moguće instalirati HAT ili tražite brz i jednostavan način za spajanje priključka za izlaz za slušalice ili ulaz za mikrofon, onda je USB audio adapter dobar izbor. To su jednostavni, jeftini uređaji koji se priključuju na jedan od USB-A portova na Raspberry Pi SBC-u.
Raspberry Pi OS podrazumevano uključuje drajvere za USB audio; čim se uređaj priključi, trebao bi se pojaviti u meniju uređaja koji se pojavljuje kada se desnim klikom miša klikne na ikonu zvučnika na traci zadataka.
Sistem će također automatski detektovati da li priključeni USB uređaj ima ulaz za mikrofon i omogućiti odgovarajuću podršku.
Bluetooth
Bluetooth audio se odnosi na bežični prijenos zvučnih podataka putem Bluetooth tehnologije, koja se vrlo široko koristi. Omogućava Raspberry Pi SBC-u da komunicira s Bluetooth zvučnicima i slušalicama/bubicama ili bilo kojim drugim audio uređajem koji podržava Bluetooth. Domet je prilično kratak - maksimalno oko 10 m.
Bluetooth uređaje je potrebno 'upariti' s Raspberry Pi SBC-om i pojavit će se u postavkama zvuka na radnoj površini nakon što se to uradi. Bluetooth je instaliran prema zadanim postavkama na Raspberry Pi OS-u, a Bluetooth logotip se pojavljuje na traci zadataka na radnoj površini na svim uređajima koji imaju instaliran Bluetooth hardver (bilo ugrađen ili putem Bluetooth USB adaptera). Kada je Bluetooth omogućen, ikona će biti plava; kada je onemogućen, ikona će biti siva.
Softverska podrška
Osnovni softver za podršku zvuka znatno se promijenio u punoj slici Raspberry Pi OS-a i, za krajnjeg korisnika, ove promjene su uglavnom transparentne. Originalni korišteni zvučni podsistem bio je ALSA. Pulse Audio je naslijedio ALSA-u, prije nego što ga je zamijenio trenutni sistem, koji se zove Pipe Wire. Ovaj sistem ima istu funkcionalnost kao Pulse Audio i kompatibilan API, ali također ima proširenja za rukovanje videom i drugim funkcijama, što integraciju videa i zvuka čini mnogo lakšom. Budući da Pipe Wire koristi isti API kao Pulse Audio, uslužni programi Pulse Audio rade dobro na Pipe Wire sistemu.
Ovi uslužni programi se koriste u bivšemamples ispod.
Da bi se smanjila veličina slike, Raspberry Pi OS Lite i dalje koristi ALSA za podršku zvuka i ne uključuje nikakve Pipe Wire, Pulse Audio ili Bluetooth audio biblioteke. Međutim, moguće je instalirati odgovarajuće biblioteke za dodavanje tih funkcija po potrebi, a taj proces je također opisan u nastavku.
Desktop
Kao što je gore spomenuto, audio operacije se obavljaju putem ikone zvučnika na traci zadataka na radnoj površini. Lijevim klikom na ikonu otvara se klizač za jačinu zvuka i dugme za isključivanje zvuka, dok desnim klikom otvara se lista dostupnih audio uređaja. Jednostavno kliknite na audio uređaj koji želite koristiti. Postoji i opcija, desnim klikom, za promjenu postavki.filekoje koristi svaki uređaj. Ovi profileobično pružaju različite nivoe kvaliteta.
Ako je omogućena podrška za mikrofon, ikona mikrofona će se pojaviti u meniju; klikom desnim tasterom miša na nju otvorit će se opcije menija specifične za mikrofon, kao što je odabir ulaznog uređaja, dok klikom lijevim tasterom miša otvaraju se postavke nivoa ulaznog zvuka.
Bluetooth
Da biste uparili Bluetooth uređaj, kliknite lijevom tipkom miša na ikonu Bluetooth na traci zadataka, a zatim odaberite "Dodaj uređaj". Sistem će zatim početi tražiti dostupne uređaje, koje je potrebno staviti u način rada "Otkrivanje" da bi se vidjeli. Kliknite na uređaj kada se pojavi na listi i uređaji bi se trebali upariti. Nakon uparivanja, audio uređaj će se pojaviti u meniju, koji se odabire klikom na ikonu zvučnika na traci zadataka.
Komandna linija
Budući da Pipe Wire koristi isti API kao i Pulse Audio, većina Pulse Audio naredbi koje se koriste za kontrolu zvuka rade na Pipe Wire-u. pacts je standardni način kontrole Pulse Audio-a: upišite man pactl u komandnu liniju za više detalja.
Preduslovi za Raspberry Pi OS Lite
Na punoj instalaciji Raspberry Pi OS-a, sve potrebne aplikacije i biblioteke komandne linije su već instalirane. Međutim, na Lite verziji, Pipe Wire nije instaliran po defaultu i mora se ručno instalirati da bi se mogao reproducirati zvuk.
Da biste instalirali potrebne biblioteke za Pipe Wire na Raspberry Pi OS Lite, unesite sljedeće: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Ako namjeravate pokretati aplikacije koje koriste ALSA, morat ćete instalirati i sljedeće: sudo apt install pipewire-alsa
Ponovno pokretanje nakon instalacije je najlakši način da sve pokrenete i pokrenete.
Reprodukcija zvuka npr.amples
Prikažite listu instaliranih Pulse audio modula u skraćenom obliku (dugi oblik sadrži mnogo informacija i teško ga je čitati): $ pactl list modules short Prikažite listu Pulse Audio prijemnika u skraćenom obliku:
$ pactl lista pada
Na Raspberry Pi 5 računaru povezanom na HDMI monitor sa ugrađenim zvukom i dodatnom USB zvučnom karticom, ova naredba daje sljedeći izlaz: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Cijevni kabel s32le 2ch 48000Hz OBUSTAVLJENO 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Cijevni kabel s16le 2ch 48000Hz OBUSTAVLJENO
NAPOMENA
Raspberry Pi 5 nema analogni izlaz.
Za instalaciju Raspberry Pi OS Lite na Raspberry Pi 4 — koji ima HDMI i analogni izlaz — vraća se sljedeće: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Cijevni kabel s16le 2ch 48000Hz OBUSTAVLJENO
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Cijevni kabel s32le 2ch 48000Hz OBUSTAVLJENO
Za prikaz i promjenu zadanog odvoda na HDMI audio (imajući na umu da je možda već zadani) na ovoj instalaciji Raspberry Pi OS Lite, upišite:
$ 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
Za reprodukciju kaoampprvo ga treba otpremiti na sampkeš memorije, u ovom slučaju na zadanom sink-u. Sink možete promijeniti dodavanjem njegovog imena na kraj paktl play-ovaampnaredba:
$ pactl upload-sampsample.mp3 sampime
$ pactl play-sampsampime
Postoji Pulse Audio komanda koja je još jednostavnija za korištenje za reprodukciju zvuka:
$ paplay sample.mp3
pactl ima opciju za podešavanje jačine zvuka za reprodukciju. Budući da radna površina koristi uslužne programe Pulse Audio za dobijanje i podešavanje audio informacija, izvršavanje ovih promjena komandne linije će se također odraziti na klizaču za jačinu zvuka na radnoj površini.
Ovaj exampsmanjuje jačinu zvuka za 10%:
$ pactl set-sink-volume @DEFAULT_SINK@ -10%
Ovaj example postavlja jačinu zvuka na 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
Postoji mnogo, mnogo Pulse Audio komandi koje ovdje nisu spomenute. Pulse Audio webstranica (https://www.freedesktop.org/wiki/Software/PulseAudio/) i stranice priručnika za svaku komandu nude opsežne informacije o sistemu.
Bluetooth
Kontroliranje Bluetootha iz komandne linije može biti komplikovan proces. Kada koristite Raspberry Pi OS Lite, odgovarajuće komande su već instalirane. Najkorisnija komanda je bluetoothctl, a neke npr.ampDetalji o njegovoj upotrebi navedeni su u nastavku.
Učinite uređaj vidljivim drugim uređajima:
$ bluetoothctl vidljiv na
Uparite uređaj s drugim uređajima:
$ bluetoothctl uparljiv na
Skeniraj Bluetooth uređaje u dometu:
$ bluetoothctl skeniranje uključeno
Isključi skeniranje:
$ bluetoothctl scan off bluetoothctl također ima interaktivni način rada, koji se poziva korištenjem naredbe bez parametara. Sljedeći primjerampKomanda le pokreće interaktivni režim, gdje se unosi komanda list i prikazuju rezultati, na Raspberry Pi 4 računaru sa Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Agent registrovan
[bluetooth]# lista
Kontroler D8:3A:DD:3B:00:00 Pi4Lite [zadano] [bluetooth]#
Sada možete ukucati naredbe u interpreter i one će biti izvršene. Tipičan proces uparivanja, a zatim povezivanja s uređajem može izgledati ovako: $ bluetoothctl
Agent registrovan [bluetooth]# vidljiv na
Promjena vidljivog na uspjela
[CHG] Kontroler D8:3A:DD:3B:00:00 Vidljivo na [bluetooth]# uparivo na
Promjena uparivanja na uspjela
[CHG] Kontroler D8:3A:DD:3B:00:00 Uparivanje na [bluetooth]# skeniranje uključeno
<može biti dugačak popis uređaja u blizini>
[bluetooth]# uparivanje [mac adresa uređaja, iz komande za skeniranje ili sa samog uređaja, u obliku xx:xx:xx:xx:xx:xx] [bluetooth]# skeniranje isključeno
[bluetooth]# povezivanje [ista mac adresa] Bluetooth uređaj bi se sada trebao pojaviti na listi uređaja, kao što je prikazano u ovom primjeruampiz instalacije Raspberry Pi OS Lite:
$ pactl lista pada
69 alsa_output.platform-bcm2835_audio.stereo-fallback Cijevni kabel s16le 2ch 48000Hz OBUSTAVLJENO
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Cijevni kabel s32le 2ch 48000Hz OBUSTAVLJENO
71 bluez_output.CA_3A_B2_CA_7C_55.1 Cijevni kabel s32le 2ch 48000Hz OBUSTAVLJENO
$ pactl set-default-sink 71
$ paplayample_audio_file>
Sada ovo možete postaviti kao zadanu postavku i reproducirati zvuk na njoj.
Zaključci
Postoji niz različitih načina za generiranje audio izlaza iz Raspberry Pi Ltd uređaja, zadovoljavajući veliku većinu korisničkih zahtjeva. Ovaj dokument je opisao te mehanizme i pružio informacije o mnogima od njih. Nadamo se da će savjeti predstavljeni ovdje pomoći krajnjem korisniku da odabere pravu shemu audio izlaza za svoj projekat. Jednostavan primjerampUputstva o korištenju audio sistema su data, ali čitalac bi trebao konsultovati priručnike i stranice priručnika za audio i Bluetooth komande za više detalja.
Raspberry Pi je zaštitni znak kompanije Raspberry Pi Ltd
Raspberry Pi Ltd
Dokumenti / Resursi
 |
Raspberry Pi SBCS jednopločni računar [pdf] Korisnički priručnik SBCS jednopločni računar, SBCS, jednopločni računar, računar na ploči, računar |