Bijela knjiga koja daje
Visoka razina iznadview zvuka
Opcije na Raspberry Pi SBC-ima
Raspberry Pi Ltd
Znak štampara
© 2022-2025 Raspberry Pi Ltd
Ova dokumentacija je licencirana pod Creative Commons Imenovanje-Bez prerada 4.0 International (CC BY-ND).
Verzija 1.0
Datum izgradnje: 28.05.2025.
Obavijest o odricanju od pravne odgovornosti
TEHNIČKE PODATKE I PODATKE O POUZDANOSTI ZA RASPBERRY PI PROIZVODE (UKLJUČUJUĆI PODATKOVNE TABLICE) POVREMENO MODIFICIRANE (“RESURSI”) PRUŽA RASPBERRY PI LTD (“RPL”) “KAKVI JESU” I SVA IZRIČITA ILI PODRAZUMEVANA JAMSTVA, UKLJUČUJUĆI, ALI NE OGRANIČENO TO, IMPLICIRANA JAMSTVA O PRODAJI I PRIKLADNOSTI ZA ODREĐENU NAMJENU SE ODRICU. U MAKSIMALNOJ MJERI DOPUŠTENOJ PRIMJENJIVIM ZAKONOM, RPL NI U KOJEM SLUČAJU NEĆE BITI ODGOVORAN ZA BILO KAKVU IZRAVNU, NEIZRAVNU, SLUČAJNU, POSEBNU, EKZEMPLARNU ILI POSLJEDIČNU ŠTETU (UKLJUČUJUĆI, ALI NE OGRANIČENO NA, NABAVU ZAMJENSKE ROBE ILI SE USLUGE; GUBITAK KORIŠTENJA, PODATAKA , ILI DOBITI; ILI PREKIDA U POSLOVANJU) KAKO BILO UZROKOVANO I NA BILO KOJOJ TEORIJI ODGOVORNOSTI, BILO U UGOVORU, STRIKTNOJ ODGOVORNOSTI ILI DELIKTU (UKLJUČUJUĆI NEMAR ILI NA DRUGI NAČIN) KOJI NA BILO KOJI NAČIN PROIZILAZE KORIŠTENJEM RESURSA, ČAK I AKO JE UPOZORENO O MOGUĆNOSTI. ITY TAKVE ŠTETE.
RPL pridržava pravo na bilo kakva poboljšanja, poboljšanja, ispravke ili bilo koje druge izmjene RESURSA ili bilo kojih proizvoda opisanih u njima u bilo koje vrijeme i bez daljnje obavijesti.
RESURSI su namijenjeni vještim korisnicima s odgovarajućom razinom znanja o dizajnu. Korisnici su isključivo odgovorni za svoj odabir i korištenje RESURSA i bilo kakvu primjenu proizvoda opisanih u njima. Korisnik se slaže obeštetiti i zaštititi RPL od svih obveza, troškova, šteta ili drugih gubitaka koji proizlaze iz njihove upotrebe RESURSA. RPL daje korisnicima dopuštenje za korištenje RESURSA isključivo u kombinaciji s Raspberry Pi proizvodima. Svaka druga upotreba RESURSA je zabranjena. Ne daje se licenca za bilo koje drugo RPL ili drugo pravo intelektualnog vlasništva treće strane.
AKTIVNOSTI VISOKOG RIZIKA. Raspberry Pi proizvodi nisu dizajnirani, proizvedeni ili namijenjeni za upotrebu u opasnim okruženjima koja zahtijevaju sigurne performanse, kao što je rad nuklearnih postrojenja, navigacijski ili komunikacijski sustavi zrakoplova, kontrola zračnog prometa, sustavi naoružanja ili sigurnosno kritične aplikacije (uključujući sustave za održavanje života i druge medicinske uređaje), u kojima bi kvar proizvoda mogao izravno dovesti do smrti, tjelesnih ozljeda ili teške fizičke ili ekološke štete („Aktivnosti visokog rizika“). RPL se izričito odriče bilo kakvog izričitog ili implicitnog jamstva o prikladnosti za aktivnosti visokog rizika i ne preuzima nikakvu odgovornost za upotrebu ili uključivanje Raspberry Pi proizvoda u aktivnosti visokog rizika. Raspberry Pi proizvodi isporučuju se u skladu s RPL-ovim Standardni uvjetiRPL-ovo pružanje RESURSA ne proširuje niti na drugi način mijenja RPL-ove Standardni uvjeti uključujući, ali ne ograničavajući se na odricanja od odgovornosti i jamstva izražena u njima.
Povijest verzija dokumenta
| Otpuštanje | Datum | Opis |
| 1 | 1. travnja 25 | Početno izdanje |
Opseg dokumenta
Ovaj se dokument 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
Tijekom godina, opcije dostupne za audio izlaz na Raspberry Pi SBC-ima (jednopločnim računalima) postale su brojnije, a način na koji se njima upravlja softverom 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 korištenju audio opcija s radne površine i iz naredbenog retka.
Ovaj dokument pretpostavlja da Raspberry Pi uređaj koristi Raspberry Pi OS i da je u potpunosti ažuriran s najnovijim firmwareom i kernelima.
Raspberry Pi audio hardver
HDMI
Svi Raspberry Pi SBC-ovi imaju HDMI priključak koji podržava HDMI audio. Spajanjem Raspberry Pi SBC-a na monitor ili televizor sa zvučnicima automatski će se omogućiti HDMI audio izlaz putem 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 naziva razdjelnik kako biste izdvojili audio signal iz HDMI signala. To 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. Riječ je o analognom izlazu niske kvalitete generiranom iz PCM (pulsno-kodna modulacija) signala, ali je i dalje prikladan za slušalice i stolne zvučnike.
BILJEŠKA
Raspberry Pi 5 nema analogni audio izlaz.
Signali utikača definirani su u sljedećoj tablici, počevši od kraja kabela do vrha. Kabeli su dostupni s različitim namjenama, stoga provjerite imate li ispravnu.
| Segment Jacka | Signal |
| Rukav | Video |
| Prsten 2 | Ground |
| Prsten 1 | Pravo |
| Savjet | Lijevo |
Adapterske ploče temeljene na I2S-u
Svi modeli Raspberry Pi SBC-ova imaju I2S periferni uređaj dostupan na GPIO konektoru. I2S je standard električnog serijskog sabirničkog sučelja koji se koristi za povezivanje digitalnih audio uređaja i komunikaciju PCM audio podataka između perifernih uređaja u elektroničkom uređaju. Raspberry Pi Ltd proizvodi niz audio ploča koje se spajaju na GPIO konektor i koriste I2S sučelje za prijenos audio podataka sa SoC-a (sustava na čipu) na dodatnu ploču.
Bilješka: Dodatne ploče koje se spajaju putem GPIO konektora i pridržavaju se odgovarajućih specifikacija poznate su kao HAT-ovi (Hardware Attached on Top - hardver pričvršćen na vrh). Njihove specifikacije možete pronaći ovdje: https://datasheets.raspberrypi.com/
Cijeli niz audio HAT-ova može se vidjeti na Raspberry Pi Ltd. webstranica: https://www.raspberrypi.com/products/
Također je dostupan velik broj HAT-ova trećih strana za audio izlaz, na primjerampod Pimoronija, HiFiBerryja, Adafruita itd., a oni pružaju mnoštvo različitih značajki.
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, USB audio adapter je dobar izbor. To su jednostavni, jeftini uređaji koji se priključuju na jedan od USB-A priključaka na Raspberry Pi SBC-u.
Raspberry Pi OS uključuje upravljačke programe za USB audio prema zadanim postavkama; čim se uređaj priključi, trebao bi se pojaviti u izborniku uređaja koji se pojavljuje kada se desnom tipkom miša klikne ikona zvučnika na programskoj traci.
Sustav će također automatski prepoznati ima li priključeni USB uređaj ulaz za mikrofon i omogućiti odgovarajuću podršku.
Bluetooth
Bluetooth audio odnosi se na bežični prijenos zvučnih podataka putem Bluetooth tehnologije, koja se vrlo široko koristi. Omogućuje Raspberry Pi SBC-u komunikaciju s Bluetooth zvučnicima i slušalicama/bubicama za uši ili bilo kojim drugim audio uređajem koji podržava Bluetooth. Domet je prilično kratak - maksimalno oko 10 m.
Bluetooth uređaje treba 'upariti' s Raspberry Pi SBC-om i nakon toga će se pojaviti u postavkama zvuka na radnoj površini. Bluetooth je prema zadanim postavkama instaliran na Raspberry Pi OS-u, a logotip Bluetootha pojavljuje se na programskoj traci na svim uređajima koji imaju instaliran Bluetooth hardver (ugrađeni ili putem Bluetooth USB adaptera). Kada je Bluetooth omogućen, ikona će biti plava; kada je onemogućen, ikona će biti siva.
Programska podrška
Temeljni softver za podršku zvuka znatno se promijenio u punoj slici Raspberry Pi OS-a i, za krajnjeg korisnika, te su promjene uglavnom transparentne. Izvorni korišteni zvučni podsustav bio je ALSA. Pulse Audio naslijedio je ALSA-u prije nego što ga je zamijenio trenutni sustav koji se zove Pipe Wire. Ovaj sustav ima istu funkcionalnost kao Pulse Audio i kompatibilan API, ali ima i proširenja za rukovanje videom i drugim značajkama, š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 dobro rade na Pipe Wire sustavu.
Ovi se uslužni programi koriste u bivšemampispod.
Kako bi se smanjila veličina slike, Raspberry Pi OS Lite i dalje koristi ALSA-u 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 značajki prema potrebi, a taj je postupak također opisan u nastavku.
Radna površina
Kao što je gore spomenuto, audio operacije se obavljaju putem ikone zvučnika na programskoj traci na radnoj površini. Lijevim klikom na ikonu otvara se klizač za glasnoću i gumb za isključivanje zvuka, dok desnim klikom otvara se popis dostupnih audio uređaja. Jednostavno kliknite 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 razine kvalitete.
Ako je omogućena podrška za mikrofon, ikona mikrofona će se pojaviti u izborniku; klikom desne tipke miša na nju otvorit će se opcije izbornika specifične za mikrofon, kao što je odabir ulaznog uređaja, dok klikom lijeve tipke miša otvaraju se postavke razine ulaznog zvuka.
Bluetooth
Za uparivanje Bluetooth uređaja, lijevom tipkom miša kliknite ikonu Bluetooth na programskoj traci, a zatim odaberite 'Dodaj uređaj'. Sustav ć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 popisu i uređaji bi se trebali upariti. Nakon uparivanja, audio uređaj će se pojaviti u izborniku koji se odabire klikom na ikonu zvučnika na programskoj traci.
Naredbeni redak
Budući da Pipe Wire koristi isti API kao i Pulse Audio, većina Pulse Audio naredbi koje se koriste za upravljanje zvukom radi na Pipe Wireu. pacts je standardni način upravljanja Pulse Audiom: upišite man pactl u naredbeni redak za više detalja.
Preduvjeti za Raspberry Pi OS Lite
Na punoj instalaciji Raspberry Pi OS-a, sve potrebne aplikacije i biblioteke naredbenog retka već su instalirane. Međutim, na Lite verziji, Pipe Wire nije instaliran prema zadanim postavkama i mora se ručno instalirati kako bi se mogao reproducirati zvuk.
Za instalaciju potrebnih biblioteka 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 popis instaliranih Pulse audio modula u skraćenom obliku (dugi oblik sadrži puno informacija i teško ga je čitati): $ pactl list modules short Prikažite popis Pulse Audio odvoda u skraćenom obliku:
$ pactl lista pada
Na Raspberry Pi 5 spojenom na HDMI monitor s 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 2 kanala 48000Hz OBUSTAVLJENO 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Cijevni kabel s16le 2 kanala 48000Hz OBUSTAVLJENO
BILJEŠKA
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 kaoampnpr., prvo ga treba prenijeti naamppredmemoriju, u ovom slučaju na zadanom odvodu. Odvod možete promijeniti dodavanjem njegovog imena na kraj pakta za reprodukcijuample naredba:
$ pactl upload-sampsample.mp3 sampime_lene
$ paktl play-sampsampime_lene
Postoji naredba Pulse Audio koja je još jednostavnija za korištenje za reprodukciju zvuka:
$ paplay sample.mp3
pactl ima opciju za postavljanje glasnoće za reprodukciju. Budući da radna površina koristi uslužne programe Pulse Audio za dobivanje i postavljanje audio informacija, izvršavanje ovih promjena naredbenog retka također će se odraziti na klizaču glasnoće na radnoj površini.
Ovaj bivšiampsmanjuje glasnoću za 10%:
$ pactl set-sink-volume @DEFAULT_SINK@ -10%
Ovaj bivšiamppostavlja glasnoću na 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
Postoji mnogo, mnogo naredbi Pulse Audio koje ovdje nisu spomenute. Pulse Audio webweb mjesto (https://www.freedesktop.org/wiki/Software/PulseAudio/) i stranice priručnika za svaku naredbu nude opsežne informacije o sustavu.
Bluetooth
Upravljanje Bluetoothom iz naredbenog retka može biti kompliciran proces. Prilikom korištenja Raspberry Pi OS Lite, odgovarajuće naredbe su već instalirane. Najkorisnija naredba je bluetoothctl, a neke npr.ampDetalji o njegovoj upotrebi navedeni su u nastavku.
Učinite uređaj vidljivim drugim uređajima:
$ bluetoothctl vidljiv na
Uparivanje uređaja 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 primjerample pokreće interaktivni način rada, gdje se unosi naredba list i prikazuju rezultati, na Raspberry Pi 4 s Raspberry Pi OS Lite Bookwormom: $ bluetoothctl
Agent registriran
[bluetooth]# popis
Kontroler D8:3A:DD:3B:00:00 Pi4Lite [zadano] [bluetooth]#
Sada možete upisivati naredbe u interpreter i one će se izvršiti. Tipičan postupak uparivanja i povezivanja s uređajem može izgledati ovako: $ bluetoothctl
Agent registriran [bluetooth]# vidljiv na
Promjena vidljivosti na uspjela
[CHG] Kontroler D8:3A:DD:3B:00:00 Vidljivo na [bluetooth]# uparivo na
Promjena parable na uspjela
[CHG] Kontroler D8:3A:DD:3B:00:00 Uparivanje na [bluetooth]# skeniranje uključeno
<može biti dug popis uređaja u blizini>
[bluetooth]# uparivanje [mac adresa uređaja, iz naredbe skeniranja 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 popisu odvoda, 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 zadano i reproducirati zvuk na njemu.
Zaključci
Postoji niz različitih načina za stvaranje 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 projekt. Jednostavan primjerampPružene su upute o korištenju audio sustava, ali čitatelj bi se trebao konzultirati s priručnicima i stranicama s uputama za audio i Bluetooth naredbe za više detalja.
Raspberry Pi je zaštitni znak Raspberry Pi Ltd
Raspberry Pi Ltd
Dokumenti / Resursi
 |
Raspberry Pi SBCS jednopločno računalo [pdf] Korisnički priručnik SBCS jednopločno računalo, SBCS, jednopločno računalo, pločasto računalo, računalo |