Blanka Libro Donanta
Altnivela Superview de Aŭdio
Opcioj ĉe Raspberry Pi SBC-oj
Raspberry Pi Ltd
Kolofono
© 2022-2025 Raspberry Pi Ltd
Ĉi tiu dokumentaro estas disponebla laŭ la permesilo Krea Komunaĵo Atribuite-Sen Derivaĵoj 4.0 Internacia (CC BY-ND).
Versio 1.0
Dato de konstruado: 28/05/2025
Avizo pri jura malgarantio
TEKNIKAJ KAJ FIDEBLECO-DATUMO PRI RASPBERRY PI-PRODUTOJ (INKLUDE DATUMONOJ) KIAL MODIFIKITAJ DE TEMPO AL TEMPO ("RIMEDOJ") ESTAS PROVIZITA DE RASPBERRY PI LTD ("RPL") "KIAL ESTAS" KAJ IUJ ESPRITA AŬ IMPLITA GARANTIOJ, INKLUDE, SED NE LIMIGITA. AL, LA IMPLITAJ GARANTIOJ DE KOMERKABLECO KAJ TAŬGECO POR APARTA CELO ESTAS RENKLAITAJ. ĜIS LA MAKMUME PERMESITA DE APLIKA LEĜO EN NENIAJ OKAĜO RPL RESPONDAS PRI IUJ REKTA, NEREKTA, EKZENDA, SPECIALA, EKZEMPLA AŬ KONSEKVAJ damaĝoj (INKLUDE, SED NE LIMIGITE AL, AKIRADO DE ANSTAŬOJ VAROJ, PERDO DE DATUMOJ; , AŬ PROFITOJ; AŬ KOMERCO INTERRUPTO) TAMEN KaŭZITA KAJ ĈU IUJ TEORIO DE RESPONVO, ĈU KONTRALE, STRIKA RESPONVO, AŬ kulpigo (INkluzive de neglektemo aŭ alie) ekestiĝanta iel ajn el la UZADO DE LA RESPONDEBLECO, Eĉ DE LA RIMEDOCO. DE TIA damaĝo.
RPL rezervas la rajton fari ajnajn plibonigojn, plibonigojn, korektojn aŭ ajnajn aliajn modifojn al la RIMEDOJ aŭ ajnaj produktoj priskribitaj en ili en ajna momento kaj sen plia avizo.
La RIMEDOJ estas destinitaj por spertaj uzantoj kun taŭgaj niveloj de dezajna scio. Uzantoj estas solaj respondecaj pri sia elekto kaj uzo de la RIMEDOJ kaj ajna apliko de la produktoj priskribitaj en ili. La uzanto konsentas kompensi kaj teni RPL senkulpa kontraŭ ĉiuj respondecoj, kostoj, damaĝoj aŭ aliaj perdoj rezultantaj el ilia uzo de la RIMEDOJ. RPL donas al uzantoj permeson uzi la RIMEDOJN nur lige kun la Raspberry Pi-produktoj. Ĉiu alia uzo de la RIMEDOJ estas malpermesita. Neniu licenco estas donita al iu ajn alia RPL aŭ alia triaparta intelekta proprietrajto.
ALTRISKAJ AKTIVOJ. Raspberry Pi-produktoj ne estas desegnitaj, fabrikitaj aŭ destinitaj por uzo en danĝeraj medioj postulantaj sekuran funkciadon, kiel ekzemple en la funkciigo de nukleaj instalaĵoj, aviadilnavigaciaj aŭ komunikaj sistemoj, aertrafika kontrolo, armilsistemoj aŭ sekurec-kritikaj aplikoj (inkluzive de vivtenaj sistemoj kaj aliaj medicinaj aparatoj), en kiuj la paneo de la produktoj povus rekte konduki al morto, persona vundo aŭ severa fizika aŭ media damaĝo ("Altriskaj Agadoj"). RPL specife malkonfesas ajnan eksplicitan aŭ implican garantion pri taŭgeco por Altriskaj Agadoj kaj akceptas neniun respondecon pri uzo aŭ inkludo de Raspberry Pi-produktoj en Altriskaj Agadoj. Raspberry Pi-produktoj estas provizitaj kondiĉe de la kondiĉoj de RPL. Normaj KondiĉojLa provizado de la RIMEDOJ fare de RPL ne vastigas aŭ alie modifas la rajton de RPL Normaj Kondiĉoj inkluzive de, sed ne limigite al, la malgarantioj kaj garantioj esprimitaj en ili.
Dokumentversiohistorio
| Liberigu | Dato | Priskribo |
| 1 | 1-apr-25 | Komenca eldono |
Amplekso de dokumento
Ĉi tiu dokumento validas por la sekvaj produktoj de Raspberry Pi:
| 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 | Ĉiuj | Ĉiuj | Ĉiuj | Ĉiuj | Ĉiuj | Ĉiuj | Ĉiuj | Ĉiuj | Ĉiuj | Ĉiuj |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Enkonduko
Tra la jaroj, la disponeblaj ebloj por son-eligo sur Raspberry Pi SBC-oj (unu-plataj komputiloj) fariĝis pli multaj, kaj la maniero kiel ili estas funkciigataj per programaro ŝanĝiĝis.
Ĉi tiu dokumento trairos multajn el la disponeblaj opcioj por son-eligo en via Raspberry Pi-aparato kaj provizos instrukciojn pri kiel uzi son-opciojn de la labortablo kaj la komandlinio.
Ĉi tiu blanka libro supozas, ke la Raspberry Pi-aparato funkcias per Raspberry Pi OS kaj estas plene ĝisdata per la plej nova firmvaro kaj kernoj.
Raspberry Pi-aŭdiaparataro
HDMI
Ĉiuj Raspberry Pi SBC-oj havas HDMI-konektilon, kiu subtenas HDMI-aŭdion. Konektante vian Raspberry Pi SBC al ekrano aŭ televidilo kun laŭtparoliloj aŭtomate ebligos HDMI-aŭdian eliron tra tiuj laŭtparoliloj. HDMI-aŭdio estas altkvalita cifereca signalo, do la rezultoj povas esti tre bonaj, kaj plurkanala aŭdio kiel DTS estas subtenata.
Se vi uzas HDMI-videon sed volas, ke la sonsignalo disigu — ekzempleample, al ampamplifilo kiu ne subtenas HDMI-enigon — tiam vi devos uzi aldonan aparataron nomatan dividilo por ĉerpi la sonsignalon el la HDMI-signalo. Ĉi tio povas esti multekosta, sed ekzistas aliaj ebloj, kaj ĉi tiuj estas priskribitaj sube.
Analoga PCM/3.5 mm konektilo
Raspberry Pi modeloj B+, 2, 3, kaj 4 havas 4-polan 3.5 mm aŭdio-konektilon, kiu povas subteni aŭdajn kaj komponitajn videosignalojn. Ĉi tio estas malaltkvalita analoga eligo generita de PCM (puls-koda modulado) signalo, sed ĝi tamen taŭgas por aŭdiloj kaj surtablaj laŭtparoliloj.
NOTO
Ne estas analoga son-eligo ĉe Raspberry Pi 5.
La signaloj de la konektilo estas difinitaj en la jena tabelo, komencante de la kablofino kaj finiĝante ĉe la pinto. Kabloj haveblas kun malsamaj asignoj, do certigu, ke vi havas la ĝustan.
| Jack-segmento | Signalo |
| Maniko | Video |
| Ringo 2 | Tero |
| Ringo 1 | Ĝuste |
| Konsileto | Maldekstre |
I2S-bazitaj adaptilaj tabuloj
Ĉiuj modeloj de Raspberry Pi SBC-oj havas I2S-flankaparaton haveblan sur la GPIO-kaplinio. I2S estas elektra seria busa interfaca normo uzata por konekti ciferecajn aŭdaparatojn kaj komuniki PCM-aŭdajn datumojn inter flankaparatoj en elektronika aparato. Raspberry Pi Ltd fabrikas gamon da aŭdaj kartoj, kiuj konektiĝas al la GPIO-kaplinio kaj uzas la I2S-interfacon por transdoni aŭdajn datumojn de la SoC (sistemo sur ĉipo) al la aldona karto.
Notu: Aldonaj kartoj, kiuj konektiĝas per la GPIO-kaplinio kaj sekvas la taŭgajn specifojn, estas konataj kiel HAT-oj (Hardware Attached on Top - Aparataro Alkroĉita Supre). Iliaj specifoj troveblas ĉi tie: https://datasheets.raspberrypi.com/
La plena gamo de aŭdaj HAT-oj videblas ĉe la Raspberry Pi Ltd. webretejo: https://www.raspberrypi.com/products/
Ankaŭ ekzistas granda nombro da triapartaj HAT-oj haveblaj por aŭdio-eligo, ekzempleample de Pimoroni, HiFiBerry, Adafruit, ktp., kaj ĉi tiuj provizas amason da malsamaj funkcioj.
USB-aŭdio
Se ne eblas instali HAT-on, aŭ vi serĉas rapidan kaj facilan manieron konekti ingon por aŭdila eligo aŭ mikrofona enigo, tiam USB-aŭdadaptilo estas bona elekto. Ĉi tiuj estas simplaj, malmultekostaj aparatoj, kiuj konektiĝas al unu el la USB-A-pordoj de la Raspberry Pi SBC.
Raspberry Pi OS defaŭlte inkluzivas pelilojn por USB-aŭdio; tuj kiam aparato estas konektita, ĝi devus aperi en la aparata menuo, kiu aperas kiam la laŭtparolila ikono sur la taskobreto estas dekstre alklakita.
La sistemo ankaŭ aŭtomate detektos ĉu la konektita USB-aparato havas mikrofonan eniron kaj ebligos la taŭgan subtenon.
Bluetooth
Bluetooth-aŭdio rilatas al la sendrata transdono de sondatumoj per Bluetooth-teknologio, kiu estas tre vaste uzata. Ĝi ebligas al la Raspberry Pi SBC komuniki kun Bluetooth-laŭtparoliloj kaj aŭdiloj, aŭ ajna alia aŭdaparato kun Bluetooth-subteno. La atingo estas sufiĉe mallonga — ĉirkaŭ 10 m maksimume.
Bludentaj aparatoj devas esti "parigitaj" kun la Raspberry Pi SBC kaj aperos en la sonaj agordoj sur la labortablo post kiam tio estos farita. Bludento estas instalita defaŭlte sur Raspberry Pi OS, kun la Bluetooth-emblemo aperanta sur la taskobreto de la labortablo sur ĉiuj aparatoj, kiuj havas instalitan Bluetooth-aparataron (ĉu enkonstruitan aŭ per Bluetooth USB-adaptilo). Kiam Bludento estas ebligita, la ikono estos blua; kiam ĝi estas malŝaltita, la ikono estos griza.
Subteno de programaro
La subesta sonsubtena programaro ŝanĝiĝis konsiderinde en la plena bildo de Raspberry Pi OS, kaj, por la finuzanto, ĉi tiuj ŝanĝoj estas plejparte travideblaj. La originala sonsubsistemo uzita estis ALSA. Pulse Audio sukcedis ALSA, antaŭ ol esti anstataŭigita per la nuna sistemo, kiu nomiĝas Pipe Wire. Ĉi tiu sistemo havas la saman funkcion kiel Pulse Audio, kaj kongruan API-on, sed ĝi ankaŭ havas etendaĵojn por pritrakti videon kaj aliajn funkciojn, faciligante la integriĝon de video kaj audio. Ĉar Pipe Wire uzas la saman API-on kiel Pulse Audio, la iloj de Pulse Audio funkcias bone en Pipe Wire-sistemo.
Ĉi tiuj servaĵoj estas uzataj en la eksamples sube.
Por teni la bildgrandecon malalta, Raspberry Pi OS Lite ankoraŭ uzas ALSA por provizi aŭdian subtenon kaj ne inkluzivas iujn ajn aŭdio-bibliotekojn de Pipe Wire, Pulse Audio, aŭ Bluetooth. Tamen, eblas instali la taŭgajn bibliotekojn por aldoni tiujn funkciojn laŭbezone, kaj ĉi tiu procezo estas ankaŭ priskribita sube.
Labortablo
Kiel menciite supre, sonoperacioj estas pritraktataj per la laŭtparolila ikono sur la taskobreto de la labortablo. Maldekstra klako sur la ikono aperigas la laŭtvoĉelan ŝovilon kaj la butonon por silentigi, dum dekstra klako aperigas liston de disponeblaj sonaparatoj. Simple alklaku la sonaparaton, kiun vi volas uzi. Ankaŭ ekzistas eblo, per dekstra klako, ŝanĝi la laŭtvoĉan...fileuzataj de ĉiu aparato. Ĉi tiuj programojfiles kutime provizas malsamajn kvalitnivelojn.
Se mikrofona subteno estas ebligita, mikrofona ikono aperos en la menuo; dekstreklako sur ĉi tio aperigos mikrofon-specifajn menuerojn, kiel ekzemple elekton de eniga aparato, dum maldekstreklako aperigos agordojn de eniga nivelo.
Bluetooth
Por pariĝi Bluetooth-aparaton, maldekstre alklaku la Bluetooth-ikonon en la taskobreto, poste elektu "Aldoni Aparaton". La sistemo tiam komencos serĉi disponeblajn aparatojn, kiuj devos esti metitaj en "Malkovri"-reĝimon por esti viditaj. Alklaku la aparaton kiam ĝi aperas en la listo kaj la aparatoj devus tiam pariĝi. Post pariĝo, la aŭdilo aperos en la menuo, kiu estas elektita alklakante la laŭtparolilan ikonon en la taskobreto.
Komandlinio
Ĉar Pipe Wire uzas la saman API-on kiel Pulse Audio, la plimulto de la Pulse Audio-komandoj uzataj por regi aŭdion funkcias en Pipe Wire. "pacts" estas la norma maniero regi Pulse Audion: tajpu "man pactl" en la komandlinion por pliaj detaloj.
Antaŭkondiĉoj por Raspberry Pi OS Lite
Ĉe plena instalado de Raspberry Pi OS, ĉiuj bezonataj komandliniaj aplikaĵoj kaj bibliotekoj jam estas instalitaj. Tamen, ĉe la Lite-versio, Pipe Wire ne estas instalita defaŭlte kaj devas esti instalita permane por povi reludigi sonon.
Por instali la bezonatajn bibliotekojn por Pipe Wire sur Raspberry Pi OS Lite, bonvolu enigi la jenon: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Se vi intencas uzi aplikaĵojn, kiuj uzas ALSA, vi ankaŭ devos instali la jenon: sudo apt install pipewire-alsa
Rekomenci post instalado estas la plej facila maniero por ke ĉio funkciu.
Aŭdio-reludigo ekzempleamples
Montri liston de instalitaj Pulse-aŭdio-moduloj mallonge (la longa formo enhavas multajn informojn kaj estas malfacile legebla): $ pactl list modules short Montri liston de Pulse-aŭdio-sinkiloj mallonge:
$ pactl-listo malpleniĝas
Sur Raspberry Pi 5 konektita al HDMI-ekrano kun enkonstruita aŭdio kaj aldona USB-sonkarto, ĉi tiu komando donas la jenan eliron: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Tuba Drato s32le 2-kanala 48000Hz PENDIGA 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Tuba Drato s16le 2-kanala 48000Hz PENDIGA
NOTO
Raspberry Pi 5 ne havas analogan eliron.
Por instalado de Raspberry Pi OS Lite sur Raspberry Pi 4 — kiu havas HDMI kaj analogan eliron — la sekvanta estas redonata: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Tuba Drato s16le 2-kanala 48000Hz PENDIGA
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Tuba Drato s32le 2-kanala 48000Hz PENDIGA
Por montri kaj ŝanĝi la defaŭltan konektilon al HDMI-aŭdio (notante, ke ĝi eble jam estas la defaŭlta) en ĉi tiu instalado de Raspberry Pi OS Lite, tajpu:
$ paktl akiri-defaŭltan-sinkon
alsa_output.platform-bcm2835_audio.stereo-fallback
$ paktl agordi-defaŭltan-lavujon 70
$ paktl akiri-defaŭltan-sinkon
alsa_output.platform-107c701400.hdmi.hdmi-stereo
Reludi kielample, ĝi unue devas esti alŝutita al la sampla kaŝmemoron, en ĉi tiu kazo sur la defaŭlta lavujo. Vi povas ŝanĝi la lavujon aldonante ĝian nomon al la fino de la paktl lud-sample komando:
$ pactl alŝutojamplaample.mp3 sampnomo
$ paktl lud-ojamplaampnomo
Ekzistas Pulse Audio-komando, kiu estas eĉ pli facile uzebla por reprodukti aŭdion:
$ paplay sample.mp3
pactl havas opcion por agordi la laŭtecon por la reludigo. Ĉar la labortablo uzas la ilojn Pulse Audio por akiri kaj agordi aŭdajn informojn, la plenumo de ĉi tiuj komandliniaj ŝanĝoj ankaŭ estos reflektita en la laŭteca ŝovilo sur la labortablo.
Ĉi tiu ekzample reduktas la volumenon je 10%:
$ paktl agordi-lavujon-volumenon @DEFAULT_SINK@ -10%
Ĉi tiu ekzample agordas la laŭtecon al 50%:
$ paktl agordi-lavujon-volumenon @DEFAULT_SINK@ 50%
Estas multaj, multaj Pulse Audio-komandoj, kiuj ne estas menciitaj ĉi tie. La Pulse Audio webretejo (https://www.freedesktop.org/wiki/Software/PulseAudio/) kaj la man-paĝoj por ĉiu komando ofertas ampleksajn informojn pri la sistemo.
Bluetooth
Regi Bluetooth per la komandlinio povas esti komplika procezo. Kiam oni uzas Raspberry Pi OS Lite, la taŭgaj komandoj jam estas instalitaj. La plej utila komando estas bluetoothctl, kaj kelkaj ekzemple...ampMalpli da ĝi en uzo estas provizitaj sube.
Igi la aparaton trovebla por aliaj aparatoj:
$ bluetoothctl malkovrebla ĉe
Igu la aparaton parigebla kun aliaj aparatoj:
$ bluetoothctl parigebla ŝaltita
Skani por Bluetooth-aparatoj ene de atingo:
$ bluetoothctl skanado ŝaltita
Malŝalti skanadon:
$ bluetoothctl scan off bluetoothctl ankaŭ havas interagan reĝimon, kiu estas alvokata per la komando sen parametroj. La jena ekzample funkciigas la interagan reĝimon, kie la komando "list" estas enigita kaj la rezultoj montrataj, sur Raspberry Pi 4 funkcianta per Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Agento registrita
[bludento]# listo
Regilo D8:3A:DD:3B:00:00 Pi4Lite [defaŭlte] [bludento]#
Vi nun povas tajpi komandojn en la interpretilon kaj ili estos plenumitaj. Tipa procezo por pariĝi kun, kaj poste konekti al, aparato povus esti jena: $ bluetoothctl
Agento registrita [bluetooth]# trovebla je
Ŝanĝo malkovrebla sur sukcesis
[CHG] Regilo D8:3A:DD:3B:00:00 Malkovrebla per [bluetooth]# parigebla per
Ŝanĝo parebla sur sukcesis
[CHG] Regilo D8:3A:DD:3B:00:00 Parigebla per [bluetooth]# skanado ŝaltita
< povus esti longa listo de aparatoj en la ĉirkaŭaĵo >
[bluetooth]# paro [mac-adreso de aparato, el la skankomando aŭ el la aparato mem, en la formo xx:xx:xx:xx:xx:xx] [bluetooth]# skanado malŝaltita
[bluetooth]# konekti [sama mac-adreso] La Bluetooth-aparato nun devus aperi en la listo de sinkiloj, kiel montrite en ĉi tiu ekz.ample el instalado de Raspberry Pi OS Lite:
$ pactl-listo malpleniĝas
69 alsa_output.platform-bcm2835_audio.stereo-fallback Tuba Drato s16le 2-kanala 48000Hz PENDIGA
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Tuba Drato s32le 2-kanala 48000Hz PENDIGA
71 bluez_output.CA_3A_B2_CA_7C_55.1 Tubdrato s32le 2-kanala 48000Hz PENDIGA
$ paktl agordi-defaŭltan-lavujon 71
$ paplayample_audio_file>
Vi nun povas fari ĉi tion la defaŭlta kaj reprodukti aŭdion per ĝi.
Konkludoj
Ekzistas pluraj malsamaj manieroj produkti aŭdian eligon el aparatoj de Raspberry Pi Ltd, kiuj plenumas la vastan plimulton de uzantaj bezonoj. Ĉi tiu blanka libro skizis tiujn mekanismojn kaj provizis informojn pri multaj el ili. Oni esperas, ke la konsiloj prezentitaj ĉi tie helpos la finuzanton elekti la ĝustan aŭdian eligan skemon por sia projekto. Simpla ekz.ampDosieroj pri kiel uzi la aŭdsistemojn estas provizitaj, sed la leganto konsultu la manlibrojn kaj man-paĝojn por la aŭdaj kaj Bludentaj komandoj por pliaj detaloj.
Raspberry Pi estas varmarko de Raspberry Pi Ltd
Raspberry Pi Ltd
Dokumentoj/Rimedoj
 |
Unu-plata komputilo Raspberry Pi SBCS [pdf] Uzantogvidilo SBCS Unu-tabula komputilo, SBCS, Unu-tabula komputilo, Tabula komputilo, Komputilo |