Baltoji knyga, suteikianti
Aukšto lygio viršview garso įrašo
Raspberry Pi SBC parinktys
Raspberry Pi Ltd
Kolofonas
© 2022-2025 Raspberry Pi Ltd
Ši dokumentacija licencijuota pagal „Creative Commons Attribution-No Derivatives 4.0 International“ (CC BY-ND) licenciją.
1.0 versija
Pagaminimo data: 2025-05-28
Teisinis atsakomybės atsisakymo pranešimas
RASPBERRY PI PRODUKTŲ TECHNINIUS IR PATIKIMUMO DUOMENYS (ĮSKAITANT DUOMENŲ LAPUS), KAIP KARTAS KARTAS PAKEITIMAI („IŠTEKLIAI“), TEIKIA „RASPBERRY PI LTD“ („RPL“) „TOKIAI, KOKIA YRA“ IR JOKIŲ AIŠKIŲ, NEREIKIAMŲ AR NUMANOMŲ NUOMONĖS GARANTIJŲ DĖL TINKAMUMO PARDUOTI IR TINKAMUMO TAM TAM TAM TIKRAI ATSAKOMYBĖS. IKI DIDŽIAUSIOS TAIKOMOS TEISĖS LEIDŽIAMO DYDŽIO RPL JOKIU ATVEJU NEATSAKO UŽ JOKIĄ TIESIOGIĄ, NETIESIOGINĘ, ATTITINKĄ, SPECIALIĄJĄ, PAvyzdinę ARBA IŠSEKESĘ ŽALĄ (ĮSKAITANT PASLAUGŲ PASLAUGŲ NAUDOJIMĄ, BET NEAPSIribodama, , DUOMENYS , Arba pelno; DĖL TOKIOS ŽALOS.
RPL pasilieka teisę bet kuriuo metu ir be papildomo įspėjimo atlikti bet kokius IŠTEKLIŲ ar bet kurių juose aprašytų produktų patobulinimus, patobulinimus, pataisymus ar bet kokius kitus pakeitimus.
IŠTEKLIAI skirti kvalifikuotiems naudotojams, turintiems atitinkamų projektavimo žinių. Naudotojai yra visiškai atsakingi už IŠTEKLIŲ pasirinkimą ir naudojimą bei bet kokį juose aprašytų produktų pritaikymą. Naudotojas sutinka atlyginti RPL nuostolius ir apsaugoti ją nuo bet kokios atsakomybės, išlaidų, žalos ar kitų nuostolių, atsirandančių dėl IŠTEKLIŲ naudojimo. RPL suteikia naudotojams leidimą naudoti IŠTEKLIUS tik kartu su „Raspberry Pi“ produktais. Bet koks kitas IŠTEKLIŲ naudojimas yra draudžiamas. Jokia licencija nesuteikiama jokiai kitai RPL ar kitai trečiosios šalies intelektinės nuosavybės teisei.
DIDELĖS RIZIKOS VEIKLA. „Raspberry Pi“ produktai nėra sukurti, pagaminti ar skirti naudoti pavojingoje aplinkoje, kurioje reikalingas saugus veikimas, pavyzdžiui, branduolinių objektų, orlaivių navigacijos ar ryšių sistemų, oro eismo kontrolės, ginklų sistemų ar saugai svarbių programų (įskaitant gyvybės palaikymo sistemas ir kitus medicinos prietaisus) eksploatavimo metu, kai gaminių gedimas gali tiesiogiai sukelti mirtį, kūno sužalojimą arba didelę fizinę ar aplinkos žalą („Didelės rizikos veikla“). RPL konkrečiai atsisako bet kokios aiškios ar numanomos tinkamumo didelės rizikos veiklai garantijos ir neprisiima jokios atsakomybės už „Raspberry Pi“ gaminių naudojimą ar įtraukimą į didelės rizikos veiklą. „Raspberry Pi“ produktai teikiami laikantis RPL... Standartinės sąlygosRPL teikiami IŠTEKLIAI neišplečia ir kitaip nekeičia RPL. Standartinės sąlygos įskaitant, bet neapsiribojant, juose išreikštus atsakomybės apribojimus ir garantijas.
Dokumento versijų istorija
| Paleisti | Data | Aprašymas |
| 1 | 1-balandžio-25 d | Pradinis išleidimas |
Dokumento apimtis
Šis dokumentas taikomas šiems Raspberry Pi produktams:
| 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 | Visi | Visi | Visi | Visi | Visi | Visi | Visi | Visi | Visi | Visi |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Įvadas
Bėgant metams, „Raspberry Pi SBC“ (vienos plokštės kompiuteriuose) garso išvesties parinktys tapo daug didesnės, o jų valdymo programine įranga būdas pasikeitė.
Šiame dokumente bus aptartos daugelis galimų garso išvesties parinkčių jūsų „Raspberry Pi“ įrenginyje ir pateiktos instrukcijos, kaip naudoti garso parinktis darbalaukyje ir komandinėje eilutėje.
Šiame informaciniame dokumente daroma prielaida, kad „Raspberry Pi“ įrenginyje veikia „Raspberry Pi“ OS ir jis yra visiškai atnaujintas su naujausia programine įranga ir branduoliais.
Raspberry Pi garso aparatūra
HDMI
Visuose „Raspberry Pi“ SBC yra HDMI jungtis, palaikanti HDMI garsą. Prijungus „Raspberry Pi SBC“ prie monitoriaus arba televizoriaus su garsiakalbiais, automatiškai bus įjungta HDMI garso išvestis per tuos garsiakalbius. HDMI garsas yra aukštos kokybės skaitmeninis signalas, todėl rezultatai gali būti labai geri, be to, palaikomas daugiakanalis garsas, pvz., DTS.
Jei naudojate HDMI vaizdo įrašą, bet norite, kad garso signalas būtų atskirtas, pvz.ample, į an ampskirstytuvas, kuris nepalaiko HDMI įvesties, garso signalui iš HDMI signalo išskirti reikės papildomos įrangos, vadinamos skirstytuvu. Tai gali būti brangu, tačiau yra ir kitų variantų, kurie aprašyti toliau.
Analoginis PCM / 3.5 mm lizdas
„Raspberry Pi“ modeliai B+, 2, 3 ir 4 turi 4 polių 3.5 mm garso lizdą, kuris gali palaikyti garso ir kompozicinius vaizdo signalus. Tai žemos kokybės analoginis išėjimas, generuojamas iš PCM (impulsinio kodo moduliacijos) signalo, tačiau jis vis tiek tinka ausinėms ir staliniams garsiakalbiams.
PASTABA
„Raspberry Pi 5“ nėra analoginio garso išvesties.
Lizdo kištuko signalai apibrėžti šioje lentelėje, pradedant nuo kabelio galo ir baigiant antgaliu. Kabeliai būna su skirtingais priskyrimais, todėl įsitikinkite, kad turite tinkamą.
| Džeko segmentas | Signalas |
| Rankovė | Vaizdo įrašas |
| Žiedas 2 | Žemė |
| Žiedas 1 | Teisingai |
| Patarimas | Kairė |
I2S pagrindu sukurtos adapterio plokštės
Visuose „Raspberry Pi SBC“ modeliuose yra I2S periferinis įrenginys, esantis GPIO antraštėje. I2S yra elektrinis nuosekliosios magistralės sąsajos standartas, naudojamas skaitmeniniams garso įrenginiams prijungti ir PCM garso duomenims perduoti tarp periferinių įrenginių elektroniniame įrenginyje. „Raspberry Pi Ltd.“ gamina įvairias garso plokštes, kurios jungiamos prie GPIO antraštės ir naudoja I2S sąsają garso duomenims perduoti iš SoC (sistemos luste) į papildomą plokštę.
Pastaba: Papildomos plokštės, kurios jungiamos per GPIO jungtį ir atitinka atitinkamas specifikacijas, vadinamos HAT (angl. Hardware Attached on Top – aparatinė įranga prijungta viršuje). Jų specifikacijas galite rasti čia: https://datasheets.raspberrypi.com/
Visą garso HAT asortimentą galite pamatyti „Raspberry Pi Ltd.“ svetainėje. websvetainė: https://www.raspberrypi.com/products/
Taip pat yra daug trečiųjų šalių HAT, skirtų garso išvesčiai, pvz.ampiš „Pimoroni“, „HiFiBerry“, „Adafruit“ ir kt., ir jie siūlo daugybę skirtingų funkcijų.
USB garsas
Jei neįmanoma įdiegti HAT arba ieškote greito ir paprasto būdo prijungti ausinių išvesties arba mikrofono įvesties lizdą, geras pasirinkimas yra USB garso adapteris. Tai paprasti, pigūs įrenginiai, kurie jungiami į vieną iš „Raspberry Pi SBC“ USB-A prievadų.
„Raspberry Pi“ OS pagal numatytuosius nustatymus turi USB garso tvarkykles; kai tik įrenginys prijungiamas, jis turėtų būti rodomas įrenginio meniu, kuris rodomas dešiniuoju pelės mygtuku spustelėjus garsiakalbio piktogramą užduočių juostoje.
Sistema taip pat automatiškai aptiks, ar prijungtas USB įrenginys turi mikrofono įvestį, ir įjungs atitinkamą palaikymą.
Bluetooth
„Bluetooth“ garsas reiškia belaidį garso duomenų perdavimą naudojant labai plačiai naudojamą „Bluetooth“ technologiją. Ji leidžia „Raspberry Pi SBC“ bendrauti su „Bluetooth“ garsiakalbiais ir ausinėmis arba bet kuriuo kitu garso įrenginiu, palaikančiu „Bluetooth“. Atstumas yra gana trumpas – daugiausia apie 10 m.
„Bluetooth“ įrenginius reikia „suporuoti“ su „Raspberry Pi SBC“ ir, kai tai bus padaryta, jie bus rodomi darbalaukio garso nustatymuose. „Bluetooth“ įdiegtas pagal numatytuosius nustatymus „Raspberry Pi“ OS, o „Bluetooth“ logotipas rodomas darbalaukio užduočių juostoje visuose įrenginiuose, kuriuose įdiegta „Bluetooth“ įranga (integruota arba per „Bluetooth“ USB adapterį). Kai „Bluetooth“ įjungtas, piktograma bus mėlyna; kai jis išjungtas, piktograma bus pilka.
Programinės įrangos palaikymas
Pagrindinė garso palaikymo programinė įranga pilname „Raspberry Pi“ OS atvaizdyje gerokai pasikeitė, ir galutiniam vartotojui šie pakeitimai dažniausiai yra nepastebimi. Iš pradžių naudota garso posistemė buvo ALSA. „Pulse Audio“ pakeitė ALSA, kol buvo pakeista dabartine sistema, vadinama „Pipe Wire“. Ši sistema turi tas pačias funkcijas kaip ir „Pulse Audio“ ir suderinamą API, tačiau ji taip pat turi plėtinių, skirtų vaizdo ir kitų funkcijų tvarkymui, todėl vaizdo ir garso integravimas yra daug lengvesnis. Kadangi „Pipe Wire“ naudoja tą pačią API kaip ir „Pulse Audio“, „Pulse Audio“ programos puikiai veikia „Pipe Wire“ sistemoje.
Šios komunalinės paslaugos naudojamos examples žemiau.
Siekiant sumažinti vaizdo dydį, „Raspberry Pi OS Lite“ vis dar naudoja ALSA garso palaikymui ir neapima jokių „Pipe Wire“, „Pulse Audio“ ar „Bluetooth“ garso bibliotekų. Tačiau galima įdiegti atitinkamas bibliotekas, kad prireikus būtų galima pridėti šias funkcijas, ir šis procesas taip pat aprašytas toliau.
Darbalaukis
Kaip minėta aukščiau, garso operacijos atliekamos naudojant garsiakalbio piktogramą darbalaukio užduočių juostoje. Kairiuoju pelės mygtuku spustelėjus piktogramą, atidaromas garsumo slankiklis ir nutildymo mygtukas, o dešiniuoju pelės mygtuku spustelėjus – galimų garso įrenginių sąrašas. Tiesiog spustelėkite norimą naudoti garso įrenginį. Taip pat yra galimybė dešiniuoju pelės mygtuku spustelėjus, kad pakeistumėte garsą.filekiekvienas įrenginys naudoja šias programas.filepaprastai teikia skirtingus kokybės lygius.
Jei įjungtas mikrofono palaikymas, meniu pasirodys mikrofono piktograma; dešiniuoju pelės mygtuku spustelėjus ją, bus atidarytos su mikrofonu susijusios meniu parinktys, pvz., įvesties įrenginio pasirinkimas, o kairiuoju pelės mygtuku spustelėjus – įvesties lygio nustatymai.
Bluetooth
Norėdami susieti „Bluetooth“ įrenginį, kairiuoju pelės mygtuku spustelėkite „Bluetooth“ piktogramą užduočių juostoje ir pasirinkite „Pridėti įrenginį“. Sistema pradės ieškoti galimų įrenginių, kuriuos reikės perjungti į „Aptikimo“ režimą, kad jie būtų matomi. Spustelėkite įrenginį, kai jis pasirodys sąraše, ir įrenginiai turėtų būti susieti. Susiejus garso įrenginį, jis pasirodys meniu, kurį galima pasirinkti spustelėjus garsiakalbio piktogramą užduočių juostoje.
Komandinė eilutė
Kadangi „Pipe Wire“ naudoja tą pačią API kaip ir „Pulse Audio“, dauguma „Pulse Audio“ komandų, naudojamų garsui valdyti, veikia ir „Pipe Wire“. „pacts“ yra standartinis „Pulse Audio“ valdymo būdas: daugiau informacijos rasite komandinėje eilutėje įvedę „man pactl“.
„Raspberry Pi OS Lite“ būtinos sąlygos
Pilnai įdiegus „Raspberry Pi OS“, visos reikalingos komandinės eilutės programos ir bibliotekos jau yra įdiegtos. Tačiau „Lite“ versijoje „Pipe Wire“ nėra įdiegiama pagal numatytuosius nustatymus ir, norint atkurti garsą, ją reikia įdiegti rankiniu būdu.
Norėdami įdiegti reikiamas „Pipe Wire“ bibliotekas „Raspberry Pi OS Lite“ sistemoje, įveskite: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Jei ketinate paleisti programas, kurios naudoja ALSA, taip pat turėsite įdiegti: sudo apt install pipewire-alsa
Paleidimas iš naujo po įdiegimo yra lengviausias būdas viską atkurti ir paleisti.
Garso atkūrimas examples
Rodyti įdiegtų „Pulse“ garso modulių sąrašą trumpuoju formatu (ilgojoje formoje yra daug informacijos ir ją sunku skaityti): $ pactl list modules short Rodyti „Pulse Audio“ kriauklių sąrašą trumpuoju formatu:
$ pactl sąrašas trūksta
„Raspberry Pi 5“, prijungtame prie HDMI monitoriaus su integruota garso sistema ir papildoma USB garso plokšte, ši komanda pateikia tokią išvestį: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Vamzdinis laidas s32le 2 kanalų 48000Hz PAKABINAMAS 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Vamzdinis laidas s16le 2 kanalų 48000Hz PAKABINAMAS
PASTABA
„Raspberry Pi 5“ neturi analoginio išėjimo.
Jei „Raspberry Pi OS Lite“ diegiama „Raspberry Pi 4“ planšetiniame kompiuteryje, kuriame yra HDMI ir analoginė išvestis, grąžinama ši reikšmė: $ „pactl“ sąrašas neatitinka tikrovės
69 alsa_output.platform-bcm2835_audio.stereo-fallback Vamzdžių laidas s16le 2 kanalų 48000Hz PAKABINAMAS
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Vamzdžių laidas s32le 2 kanalų 48000Hz PAKABINAMAS
Norėdami šiame „Raspberry Pi OS Lite“ diegime rodyti ir pakeisti numatytąjį kriauklę į HDMI garsą (atkreipkite dėmesį, kad tai jau gali būti numatytoji), įveskite:
$ 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
Norėdami atkurti kaipampy., pirmiausia jį reikia įkelti į samp„le cache“, šiuo atveju – numatytojoje saugykloje. Galite pakeisti saugyklą pridėdami jos pavadinimą prie „pactl play-s“ pabaigos.ample komanda:
$ pactl įkėlimaiampsample.mp3 samplename
$ pactl žaidimaiampsamplename
Yra „Pulse Audio“ komanda, kurią dar lengviau naudoti garsui atkurti:
$ paplay sample.mp3
„pactl“ turi parinktį nustatyti atkūrimo garsumą. Kadangi darbalaukyje garso informacijai gauti ir nustatyti naudojamos „Pulse Audio“ programos, šių komandinės eilutės pakeitimų vykdymas taip pat atsispindės darbalaukio garsumo slankiklyje.
Šis buvęsampsumažina garsumą 10 %:
$ pactl set-sink-volume @DEFAULT_SINK@ -10%
Šis buvęsample nustato garsumą iki 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
Yra daugybė „Pulse Audio“ komandų, kurios čia nepaminėtos. websvetainė (https://www.freedesktop.org/wiki/Software/PulseAudio/) ir kiekvienos komandos žinyno puslapiuose pateikiama išsami informacija apie sistemą.
Bluetooth
„Bluetooth“ valdymas iš komandinės eilutės gali būti sudėtingas procesas. Naudojant „Raspberry Pi OS Lite“, atitinkamos komandos jau yra įdiegtos. Naudingiausia komanda yra „bluetoothctl“, o kai kurios, pvz.ampŽemiau pateikiami jo naudojimo pavyzdžiai.
Padarykite įrenginį aptinkamą kitiems įrenginiams:
$ bluetoothctl aptinkamas
Padarykite įrenginį suporuojamą su kitais įrenginiais:
$ bluetoothctl suporuojamas įjungtas
Ieškoti „Bluetooth“ įrenginių diapazone:
$ bluetoothctl nuskaitymas įjungtas
Išjungti nuskaitymą:
„$ bluetoothctl scan off“ „bluetoothctl“ taip pat turi interaktyvųjį režimą, kuris iškviečiamas naudojant komandą be parametrų. Toliau pateiktas pavyzdysamp„le“ paleidžia interaktyvųjį režimą, kuriame įvedama list komanda ir rodomi rezultatai „Raspberry Pi 4“ planšetiniame kompiuteryje, kuriame veikia „Raspberry Pi OS Lite“. Bookworm: $ bluetoothctl
Įregistruotas agentas
[bluetooth]# sąrašas
Valdiklis D8:3A:DD:3B:00:00 Pi4Lite [numatytasis] [„Bluetooth“]#
Dabar galite įvesti komandas į interpretatorių ir jos bus vykdomos. Įprastas susiejimo su įrenginiu ir prisijungimo prie jo procesas gali būti toks: $ bluetoothctl
Agentas užregistruotas [„Bluetooth“] # aptinkamas įrenginyje
Pakeisti aptinkamą funkciją pavyko
[CHG] Valdiklis D8:3A:DD:3B:00:00 Aptinkamas per [bluetooth]# susiejamas per
Pavyko pakeisti porą
[CHG] Valdiklis D8:3A:DD:3B:00:00 Susiejamas per [bluetooth]# nuskaitymas įjungtas
<gali būti ilgas netoliese esančių įrenginių sąrašas>
[bluetooth]# pora [įrenginio MAC adresas iš nuskaitymo komandos arba iš paties įrenginio, formatu xx:xx:xx:xx:xx:xx] [bluetooth]# nuskaitymas išjungtas
[bluetooth]# connect [tas pats MAC adresas] „Bluetooth“ įrenginys dabar turėtų būti rodomas kriauklių sąraše, kaip parodyta šiame pavyzdyjeampfailas iš „Raspberry Pi OS Lite“ diegimo:
$ pactl sąrašas trūksta
69 alsa_output.platform-bcm2835_audio.stereo-fallback Vamzdžių laidas s16le 2 kanalų 48000Hz PAKABINAMAS
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Vamzdžių laidas s32le 2 kanalų 48000Hz PAKABINAMAS
71 bluez_output.CA_3A_B2_CA_7C_55.1 Vamzdžių laidas s32le 2 kanalai 48000Hz PAKABINAMAS
$ pactl set-default-sink 71
$ paplayample_audio_file>
Dabar galite tai padaryti kaip numatytąją ir jame atkurti garsą.
Išvados
Yra daug skirtingų būdų, kaip išgauti garso išvestį iš „Raspberry Pi Ltd“ įrenginių, patenkinančių daugumos vartotojų poreikius. Šioje informacinėje knygoje aprašyti šie mechanizmai ir pateikta informacija apie daugelį jų. Tikimasi, kad čia pateikti patarimai padės galutiniam vartotojui pasirinkti tinkamą garso išvesties schemą savo projektui. Paprastas pavyzdysampPateikiamos garso sistemų naudojimo instrukcijos, tačiau skaitytojas turėtų daugiau informacijos ieškoti garso ir „Bluetooth“ komandų vadovuose ir žinynų puslapiuose.
Raspberry Pi yra Raspberry Pi Ltd prekės ženklas
Raspberry Pi Ltd
Dokumentai / Ištekliai
 |
Raspberry Pi SBCS vienos plokštės kompiuteris [pdfVartotojo vadovas SBCS vienos plokštės kompiuteris, SBCS, vienos plokštės kompiuteris, borto kompiuteris, kompiuteris |