Whitepaper li Jagħti
Livell Għoli 'l Fuqview tal-Awdjo
Għażliet fuq Raspberry Pi SBCs
Raspberry Pi Ltd
Kolofonu
© 2022-2025 Raspberry Pi Ltd
Din id-dokumentazzjoni hija liċenzjata taħt Creative Commons Attribution-No Derivatives 4.0 International (CC BY-ND).
Verżjoni 1.0
Data tal-bini: 28/05/2025
Avviż ta' ċaħda legali
DEJTA TEKNIKA U AFFIDABILTÀ GĦAL PRODOTTI RASPBERRY PI (INKLUŻI SKEJJIET TA' DATA) KIF MODIFIKATI MINN Żmien għal żmien (“RIŻORSI”) HUMA PROVVUTI MINN RASPBERRY PI LTD (“RPL”) “KIF INHI” U KULL GARANZIJA ESPRESSA JEW IMPLIKATI, INKLUŻI, IMMA MHUX LIMITATA. GĦAL, IL-GARANZIJI IMPLICITI TA' KUMMERĊJABILITÀ U ADATTAZZJONI GĦAL GĦAN PARTIKOLARI MHUMIEX JIRRADNU. SAL-MESSA MASSIMA PERMESSA MILL-LIĠI APPLIKABBLI FL-EBDA KAŻ RPL M’GĦANDU JKUN RESPONSABBLI GĦAL KWALUNKWE DANNI DIRETTI, INDIRETTI, INĊIDENTALI, SPEĊJALI, EŻEMPLARI JEW KONSEKWENZJALI (INKLUŻI, IMMA MHUX LIMITAT GĦAL, AKKWIST TA’ OĠĠETTI SOSTITUTTI TA’ UŻU TA’ SERVIZZ, TELF TA’ ID-DATA; , JEW PROFITTI; JEW INTERRUZZJONI TAN-NEGOZJU) IKKAŻAW U FUQ KWALUNKWE TEORIA TA’ RESPONSABBILTÀ, KEMM F’KUNTRATT, RESPONSABBILTÀ STRETTA, JEW DELEG (INKLUŻA NEGLIĠENZA JEW MOD IEĦOR) LI JKOLLU B’KULL MOD MINN L-UŻU TAR-RIŻORSSIBILITÀ TA’ TALI ĦSARA.
RPL tirriżerva d-dritt li tagħmel xi titjib, titjib, korrezzjoni jew kwalunkwe modifika oħra lir-RIŻORSI jew kwalunkwe prodott deskritt fihom fi kwalunkwe ħin u mingħajr avviż ieħor.
Ir-RIŻORSI huma maħsuba għal utenti tas-sengħa b'livelli xierqa ta' għarfien tad-disinn. L-utenti huma unikament responsabbli għall-għażla u l-użu tagħhom tar-RIŻORSI u kwalunkwe applikazzjoni tal-prodotti deskritti fihom. L-utent jaqbel li jindennizza u jżomm lil RPL ħielsa minn kull responsabbiltà, spiża, danni jew telf ieħor li jirriżulta mill-użu tagħhom tar-RIŻORSI. RPL tagħti lill-utenti permess li jużaw ir-RIŻORSI biss flimkien mal-prodotti Raspberry Pi. Kull użu ieħor tar-RIŻORSI huwa pprojbit. L-ebda liċenzja ma tingħata lil xi dritt ieħor ta' proprjetà intellettwali ta' RPL jew ta' parti terza.
ATTIVITAJIET TA’ RISKJU GĦOLI. Il-prodotti Raspberry Pi mhumiex iddisinjati, manifatturati jew maħsuba għall-użu f’ambjenti perikolużi li jeħtieġu prestazzjoni sikura, bħal fit-tħaddim ta’ faċilitajiet nukleari, sistemi ta’ navigazzjoni jew komunikazzjoni tal-inġenji tal-ajru, kontroll tat-traffiku tal-ajru, sistemi tal-armi jew applikazzjonijiet kritiċi għas-sikurezza (inklużi sistemi ta’ appoġġ għall-ħajja u apparati mediċi oħra), fejn il-ħsara tal-prodotti tista’ twassal direttament għal mewt, korriment personali jew ħsara fiżika jew ambjentali severa (“Attivitajiet ta’ Riskju Għoli”). RPL tiċħad speċifikament kwalunkwe garanzija espressa jew impliċita ta’ idoneità għal Attivitajiet ta’ Riskju Għoli u ma taċċetta l-ebda responsabbiltà għall-użu jew l-inklużjonijiet tal-prodotti Raspberry Pi f’Attivitajiet ta’ Riskju Għoli. Il-prodotti Raspberry Pi huma pprovduti soġġetti għall-kundizzjonijiet tal-RPL. Termini StandardIl-provvista tar-RIŻORSI mill-RPL ma tespandix jew timmodifika b'xi mod ieħor ir-riżorsi tal-RPL. Termini Standard inklużi iżda mhux limitati għaċ-ċaħdiet u l-garanziji espressi fihom.
Storja tal-verżjoni tad-dokument
| Rilaxx | Data | Deskrizzjoni |
| 1 | 1-Apr-25 | Rilaxx inizjali |
Skop tad-dokument
Dan id-dokument japplika għall-prodotti Raspberry Pi li ġejjin:
| 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 | Kollha | Kollha | Kollha | Kollha | Kollha | Kollha | Kollha | Kollha | Kollha | Kollha |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Introduzzjoni
Matul is-snin, l-għażliet disponibbli għall-output awdjo fuq Raspberry Pi SBCs (kompjuters b'bord wieħed) saru aktar numerużi, u l-mod kif dawn jitħaddmu mis-softwer inbidel.
Dan id-dokument se jgħaddi minn ħafna mill-għażliet disponibbli għall-output tal-awdjo fuq it-tagħmir Raspberry Pi tiegħek u jipprovdi struzzjonijiet dwar kif tuża l-għażliet tal-awdjo mid-desktop u l-linja tal-kmand.
Dan il-whitepaper jassumi li l-apparat Raspberry Pi qed juża Raspberry Pi OS u huwa aġġornat kompletament bl-aħħar firmware u kernels.
Ħardwer tal-awdjo tar-Raspberry Pi
HDMI
L-SBCs kollha tar-Raspberry Pi għandhom konnettur HDMI li jappoġġja awdjo HDMI. Il-konnessjoni tar-Raspberry Pi SBC tiegħek ma' monitor jew televiżjoni bi speakers awtomatikament tippermetti l-ħruġ tal-awdjo HDMI permezz ta' dawk l-ispikers. L-awdjo HDMI huwa sinjal diġitali ta' kwalità għolja, għalhekk ir-riżultati jistgħu jkunu tajbin ħafna, u awdjo b'ħafna kanali bħal DTS huwa appoġġjat.
Jekk qed tuża vidjo HDMI imma trid li s-sinjal awdjo jinqasam — pereżempjuample, għal ampli ma jappoġġjax input HDMI — allura jkollok bżonn tuża biċċa ħardwer addizzjonali msejħa splitter biex tiġbed is-sinjal awdjo mis-sinjal HDMI. Dan jista' jkun għali, iżda hemm għażliet oħra, u dawn huma deskritti hawn taħt.
Jack analogu PCM/3.5 mm
Il-mudelli Raspberry Pi B+, 2, 3, u 4 għandhom jack awdjo ta' 3.5 mm b'4 poli li jista' jappoġġja sinjali awdjo u vidjo kompost. Dan huwa output analogu ta' kwalità baxxa ġġenerat minn sinjal PCM (modulazzjoni tal-kodiċi tal-impuls), iżda xorta huwa adattat għal headphones u speakers tad-desktop.
NOTA
M'hemm l-ebda output awdjo analogu fuq Raspberry Pi 5.
Is-sinjali tal-jack plug huma definiti fit-tabella li ġejja, li jibdew mit-tarf tal-kejbil u jispiċċaw fil-ponta. Il-kejbils huma disponibbli b'assenjazzjonijiet differenti, għalhekk kun żgur li għandek dik korretta.
| Segment tal-ġakk | Sinjal |
| kmiem | Video |
| Ċirku 2 | Art |
| Ċirku 1 | Dritt |
| Tip | Xellug |
Bordijiet tal-adapter ibbażati fuq l-I2S
Il-mudelli kollha ta' Raspberry Pi SBCs għandhom periferali I2S disponibbli fuq il-header GPIO. I2S huwa standard ta' interfaċċja tas-serial bus elettrika użata biex tikkonnettja apparati awdjo diġitali u tikkomunika dejta awdjo PCM bejn periferali f'apparat elettroniku. Raspberry Pi Ltd timmanifattura firxa ta' bordijiet awdjo li jikkonnettjaw mal-header GPIO u jużaw l-interfaċċja I2S biex jittrasferixxu dejta awdjo mis-SoC (sistema fuq ċippa) għall-bord add-on.
Nota: Il-bordijiet add-on li jikkonnettjaw permezz tal-header GPIO u jaderixxu mal-ispeċifikazzjonijiet xierqa huma magħrufa bħala HATs (Hardware Attached on Top). L-ispeċifikazzjonijiet tagħhom jistgħu jinstabu hawn: https://datasheets.raspberrypi.com/
Il-firxa sħiħa ta' HATs awdjo tista' tidher fuq ir-Raspberry Pi Ltd. websit: https://www.raspberrypi.com/products/
Hemm ukoll numru kbir ta' HATs ta' partijiet terzi disponibbli għall-output tal-awdjo, pereżempjuample minn Pimoroni, HiFiBerry, Adafruit, eċċ., u dawn jipprovdu għadd kbir ta' karatteristiċi differenti.
Awdjo USB
Jekk mhux possibbli li tinstalla HAT, jew qed tfittex mod faċli u veloċi biex twaħħal jack plug għal output tal-headphones jew input tal-mikrofonu, allura adapter tal-awdjo USB huwa għażla tajba. Dawn huma apparati sempliċi u rħas li jitwaħħlu ma' wieħed mill-portijiet USB-A fuq ir-Raspberry Pi SBC.
Raspberry Pi OS jinkludi sewwieqa għall-awdjo USB awtomatikament; hekk kif apparat jiġi pplaggjat, għandu jidher fil-menu tal-apparat li jidher meta l-ikona tal-ispiker fuq it-taskbar tiġi kklikkjata bil-lemin.
Is-sistema tiskopri wkoll awtomatikament jekk l-apparat USB imwaħħal għandux input tal-mikrofonu u tippermetti l-appoġġ xieraq.
Bluetooth
L-awdjo Bluetooth jirreferi għat-trażmissjoni mingħajr fili ta' dejta tal-ħoss permezz tat-teknoloġija Bluetooth, li tintuża ħafna. Din tippermetti lir-Raspberry Pi SBC jikkomunika ma' kelliema u headphones/earbuds Bluetooth, jew kwalunkwe apparat awdjo ieħor b'appoġġ Bluetooth. Il-firxa hija pjuttost qasira — madwar 10 m massimu.
L-apparati Bluetooth jeħtieġ li jkunu 'mqabbda' mar-Raspberry Pi SBC u jidhru fis-settings tal-awdjo fuq id-desktop ladarba dan isir. Il-Bluetooth huwa installat awtomatikament fuq Raspberry Pi OS, bil-logo tal-Bluetooth jidher fuq it-taskbar tad-desktop fuq kwalunkwe apparat li għandu hardware Bluetooth installat (jew integrat jew permezz ta' dongle USB Bluetooth). Meta l-Bluetooth ikun attivat, l-ikona tkun blu; meta jkun diżattivat, l-ikona tkun griża.
Appoġġ tas-softwer
Is-softwer sottostanti tal-appoġġ awdjo nbidel konsiderevolment fl-immaġni sħiħa tar-Raspberry Pi OS, u, għall-utent aħħari, dawn il-bidliet huma fil-biċċa l-kbira trasparenti. Is-sottosistema tal-ħoss oriġinali użata kienet ALSA. Pulse Audio ħadet post ALSA, qabel ma ġiet sostitwita bis-sistema attwali, li tissejjaħ Pipe Wire. Din is-sistema għandha l-istess funzjonalità bħal Pulse Audio, u API kompatibbli, iżda għandha wkoll estensjonijiet biex timmaniġġja l-vidjow u karatteristiċi oħra, u b'hekk l-integrazzjoni tal-vidjow u l-awdjo tkun ħafna aktar faċli. Minħabba li Pipe Wire tuża l-istess API bħal Pulse Audio, l-utilitajiet ta' Pulse Audio jaħdmu tajjeb fuq sistema Pipe Wire.
Dawn l-utilitajiet jintużaw fl-eż.amples hawn taħt.
Biex id-daqs tal-immaġni jinżamm baxx, Raspberry Pi OS Lite xorta juża ALSA biex jipprovdi appoġġ awdjo u ma jinkludi l-ebda librerija awdjo Pipe Wire, Pulse Audio, jew Bluetooth. Madankollu, huwa possibbli li jiġu installati l-libreriji xierqa biex jiżdiedu dawk il-karatteristiċi kif meħtieġ, u dan il-proċess huwa deskritt ukoll hawn taħt.
Desktop
Kif imsemmi hawn fuq, l-operazzjonijiet tal-awdjo huma mmaniġġjati permezz tal-ikona tal-ispiker fuq it-taskbar tad-desktop. Meta tikklikkja bil-buttuna tax-xellug fuq l-ikona tintwera s-slider tal-volum u l-buttuna mute, filwaqt li meta tikklikkja bil-buttuna tal-lemin tintwera lista ta' apparati awdjo disponibbli. Sempliċement ikklikkja fuq l-apparat awdjo li trid tuża. Hemm ukoll għażla, permezz ta' klikk bil-buttuna tal-lemin, biex tibdel il-profiles użati minn kull apparat. Dawn il-profileġeneralment jipprovdu livelli ta' kwalità differenti.
Jekk l-appoġġ għall-mikrofonu jkun attivat, ikona tal-mikrofonu tidher fil-menu; meta tikklikkja bil-lemin fuqha se jinfetħu għażliet speċifiċi għall-mikrofonu fil-menu, bħall-għażla tal-apparat tad-dħul, filwaqt li meta tikklikkja bil-lemin se jinfetħu s-settings tal-livell tad-dħul.
Bluetooth
Biex tqabbad apparat Bluetooth, ikklikkja bil-buttuna tax-xellug fuq l-ikona Bluetooth fuq it-taskbar, imbagħad agħżel 'Żid Apparat'. Is-sistema mbagħad tibda tfittex apparati disponibbli, li jkollhom jitpoġġew fil-modalità 'Skopri' biex jidhru. Ikklikkja fuq l-apparat meta jidher fil-lista u l-apparati għandhom imbagħad jingħaqdu. Ladarba jkun imqabbad, l-apparat awdjo jidher fil-menu, li jintgħażel billi tikklikkja l-ikona tal-ispiker fuq it-taskbar.
Linja tal-kmand
Peress li Pipe Wire juża l-istess API bħal Pulse Audio, il-maġġoranza tal-kmandi ta' Pulse Audio użati biex jikkontrollaw l-awdjo jaħdmu fuq Pipe Wire. pacts huwa l-mod standard biex tikkontrolla Pulse Audio: ittajpja man pactl fil-linja tal-kmand għal aktar dettalji.
Prerekwiżiti għal Raspberry Pi OS Lite
Fuq installazzjoni sħiħa ta' Raspberry Pi OS, l-applikazzjonijiet u l-libreriji kollha meħtieġa tal-linja tal-kmand ikunu diġà installati. Fuq il-verżjoni Lite, madankollu, Pipe Wire mhux installat awtomatikament u jrid jiġi installat manwalment biex ikun jista' jindaqq il-ħoss.
Biex tinstalla l-libreriji meħtieġa għal Pipe Wire fuq Raspberry Pi OS Lite, jekk jogħġbok daħħal dan li ġej: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Jekk bi ħsiebek tħaddem applikazzjonijiet li jużaw ALSA, ser ikollok bżonn tinstalla wkoll dan li ġej: sudo apt install pipewire-alsa
L-eħfef mod biex kollox jibda jaħdem huwa li terġa' tibda s-sistema wara l-installazzjoni.
Daqq tal-awdjo eż.amples
Uri lista tal-moduli awdjo Pulse installati f'forma qasira (il-forma twila fiha ħafna informazzjoni u hija diffiċli biex tinqara): $ pactl list modules short Uri lista tas-sinkijiet tal-Awdjo Pulse f'forma qasira:
Il-lista $ pactl tonqos
Fuq Raspberry Pi 5 imqabbad ma' monitor HDMI b'awdjo integrat u sound card USB addizzjonali, dan il-kmand jagħti l-output li ġej: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Wajer tal-Pajp s32le 2ch 48000Hz SOSPIŻ 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Wajer tal-Pajp s16le 2ch 48000Hz SOSPIŻ
NOTA
Ir-Raspberry Pi 5 m'għandux ħruġ analogu.
Għal installazzjoni ta' Raspberry Pi OS Lite fuq Raspberry Pi 4 — li għandu HDMI u ħruġ analogu — jiġi rritornat dan li ġej: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pajp tal-Wajer s16le 2ch 48000Hz SOSPIŻ
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Wajer tal-Pajp s32le 2ch 48000Hz SOSPIŻ
Biex turi u tibdel is-sink awtomatiku għal awdjo HDMI (innota li jista' jkun diġà d-default) fuq din l-installazzjoni ta' Raspberry Pi OS Lite, ittajpja:
$ pactl get-default-sink
alsa_output.platform-bcm2835_audio.stereo-fallback
$ pactl issettja-sink-default 70
$ pactl get-default-sink
alsa_output.platform-107c701400.hdmi.hdmi-stereo
Biex iddoqq lura bħalaampjiġifieri, l-ewwel jeħtieġ li jiġi mtella' fuq is-sampil-cache, f'dan il-każ fuq is-sink default. Tista' tbiddel is-sink billi żżid ismu fl-aħħar tal-pactl play-sampil-kmand:
$ pactl upload-sampilample.mp3 sampisem
$ pactl play-sampilampisem
Hemm kmand Pulse Audio li huwa saħansitra aktar faċli biex tużah biex iddoqq l-awdjo:
$ paplay sample.mp3
pactl għandu għażla biex jissettja l-volum għad-daqq. Minħabba li d-desktop juża l-utilitajiet Pulse Audio biex jikseb u jissettja informazzjoni awdjo, l-eżekuzzjoni ta' dawn il-bidliet fil-linja tal-kmand se jiġu riflessi wkoll fis-slider tal-volum fuq id-desktop.
Dan example jnaqqas il-volum b'10%:
$ pactl issettja l-volum tas-sink @DEFAULT_SINK@ -10%
Dan example jissettja l-volum għal 50%:
$ pactl set-sink-volum @DEFAULT_SINK@ 50%
Hemm ħafna, ħafna kmandi tal-Pulse Audio li mhumiex imsemmija hawn. Il-Pulse Audio websit (https://www.freedesktop.org/wiki/Software/PulseAudio/) u l-paġni tal-man għal kull kmand joffru informazzjoni estensiva dwar is-sistema.
Bluetooth
Il-kontroll tal-Bluetooth mil-linja tal-kmand jista' jkun proċess ikkumplikat. Meta tuża Raspberry Pi OS Lite, il-kmandi xierqa jkunu diġà installati. L-aktar kmand utli huwa bluetoothctl, u xi eżempji...ampInqas minnu fl-użu huma pprovduti hawn taħt.
Agħmel l-apparat skopert minn apparati oħra:
$ bluetoothctl li jista' jiġi skopert fuq
Agħmel l-apparat akkoppjabbli ma' apparati oħra:
$ bluetoothctl jista' jiġi mqabbel mixgħul
Skennja għal apparati Bluetooth fil-firxa:
$ bluetoothctl scan mixgħul
Itfi l-iskennjar:
$ bluetoothctl scan off bluetoothctl għandu wkoll mod interattiv, li jiġi invokat billi jintuża l-kmand mingħajr parametri. L-eżempju li ġejample jħaddem il-modalità interattiva, fejn il-kmand tal-lista jiddaħħal u r-riżultati jintwerew, fuq Raspberry Pi 4 li jħaddem Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Aġent reġistrat
[bluetooth]# lista
Kontrollur D8:3A:DD:3B:00:00 Pi4Lite [default] [bluetooth]#
Issa tista' tittajpja kmandi fl-interpretu u dawn se jiġu eżegwiti. Proċess tipiku għall-akkoppjar ma', u mbagħad il-konnessjoni ma', apparat jista' jinqara kif ġej: $ bluetoothctl
Aġent irreġistrat [bluetooth]# li jista' jiġi skopert fuq
Nibdlu skoperta fuq irnexxielu
[CHG] Kontrollur D8:3A:DD:3B:00:00 Jista' jinstab fuq [bluetooth]# jista' jitqabbad fuq
Nibdlu pairable fuq irnexxielu
[CHG] Kontrollur D8:3A:DD:3B:00:00 Jista' jitqabbad fuq [bluetooth]# skennja mixgħul
< jista' jkun hemm lista twila ta' apparati fil-viċin >
[bluetooth]# par [indirizz mac tal-apparat, mill-kmand tal-iskennjar jew mill-apparat innifsu, fil-forma xx:xx:xx:xx:xx:xx] [bluetooth]# skennjar mitfi
[bluetooth]# qabbad [l-istess indirizz mac] L-apparat Bluetooth issa għandu jidher fil-lista tas-sinkijiet, kif muri f'dan l-eżempjuample minn installazzjoni ta' Raspberry Pi OS Lite:
Il-lista $ pactl tonqos
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pajp tal-Wajer s16le 2ch 48000Hz SOSPIŻ
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Wajer tal-Pajp s32le 2ch 48000Hz SOSPIŻ
71 bluez_output.CA_3A_B2_CA_7C_55.1 Wajer tal-Pajp s32le 2ch 48000Hz SOSPIŻ
$ pactl issettja-sink-default 71
$ paplayample_awdjo_file>
Issa tista' tagħmlu bħala dan awtomatiku u ddoqq l-awdjo fuqu.
Konklużjonijiet
Hemm numru ta' modi differenti biex tipproduċi output awdjo minn apparati Raspberry Pi Ltd, li jaqdu l-maġġoranza l-kbira tar-rekwiżiti tal-utenti. Dan il-whitepaper iddeskriva dawk il-mekkaniżmi u pprovda informazzjoni dwar ħafna minnhom. Huwa ttamat li l-pariri ppreżentati hawnhekk jgħinu lill-utent aħħari jagħżel l-iskema ta' output awdjo t-tajba għall-proġett tiegħu. Eżempju sempliċiampĠew ipprovduti fajls dwar kif jintużaw is-sistemi awdjo, iżda l-qarrej għandu jikkonsulta l-manwali u l-paġni tal-man għall-kmandi tal-awdjo u tal-Bluetooth għal aktar dettall.
Raspberry Pi hija trademark ta’ Raspberry Pi Ltd
Raspberry Pi Ltd
Dokumenti / Riżorsi
 |
Kompjuter b'Bord Uniku tal-Raspberry Pi SBCS [pdfGwida għall-Utent Kompjuter ta' Bord Uniku SBCS, SBCS, Kompjuter ta' Bord Uniku, Kompjuter tal-Bord, Kompjuter |