Papur Gwyn yn Rhoi
Dros Lefel Uchelview o Sain
Opsiynau ar SBCs Raspberry Pi
Raspberry Pi Cyf
Colophon
© 2022-2025 Raspberry Pi Cyf
Mae'r ddogfennaeth hon wedi'i thrwyddedu o dan Creative Commons Attribution-No Derivatives 4.0 International (CC BY-ND).
Fersiwn 1.0
Dyddiad adeiladu: 28/05/2025
Hysbysiad ymwadiad cyfreithiol
DDARPERIR DATA TECHNEGOL A DIBYNADWYEDD AR GYFER CYNHYRCHION RASPBERRY PI (GAN GYNNWYS TAFLENNI DATA) FEL Y'U ADDASWYD O AMSER I AMSER ("ADNODDAU") GAN RASPBERRY PI LTD (“RPL”) “FEL Y MAE” AC UNRHYW WARANTAU MYNEGI NEU WEDI EU HYNNY, YN CYNNWYS, NID OND AT, GWAHODDIR GWARANTIAETHAU GOBLYGEDIG O FYDDHADEDD A FFITRWYDD AT DDIBEN NODEDIG. I'R MAINT UCHAF A GANIATEIR GAN Y GYFRAITH BERTHNASOL MEWN DIGWYDDIAD NI FYDD RPL YN ATEBOL AM UNRHYW DDIFROD UNIONGYRCHOL, ANUNIONGYRCHOL, ARBENNIG, ENGHREIFFTIOL NEU GANLYNIADOL (GAN GYNNWYS, OND NID YN GYFYNGEDIG I, GAEL DEFNYDD O DDIDDORDEB, WEDI EI GADW; , NEU ELW; NEU YMYRIAD I FUSNES) FODD WEDI ACHOSI AC AR UNRHYW Damcaniaeth O ATEBOLRWYDD, P'un ai WRTH GYTUNDEB, ATEBOLRWYDD DYNOL, NEU GAMWEDD (GAN GYNNWYS Esgeulustod NEU FEL ARALL) SY'N CODI MEWN UNRHYW FFORDD ALLAN O DDEFNYDDIO'R ADNODDAU HYD YN OED, HYD YN OED. O'R FATH DDIFROD.
Mae RPL yn cadw'r hawl i wneud unrhyw welliannau, gwelliannau, cywiriadau neu unrhyw addasiadau eraill i'r ADNODDAU neu unrhyw gynhyrchion a ddisgrifir ynddynt ar unrhyw adeg a heb rybudd pellach.
Bwriedir yr ADNODDAU ar gyfer defnyddwyr medrus sydd â lefelau addas o wybodaeth ddylunio. Defnyddwyr sy'n gyfrifol yn llwyr am eu dewis a'u defnydd o'r ADNODDAU ac unrhyw gymhwysiad o'r cynhyrchion a ddisgrifir ynddynt. Mae'r defnyddiwr yn cytuno i indemnio a dal RPL yn ddiniwed rhag pob atebolrwydd, cost, difrod neu golled arall sy'n deillio o'u defnydd o'r ADNODDAU. Mae RPL yn rhoi caniatâd i ddefnyddwyr ddefnyddio'r ADNODDAU ar y cyd â chynhyrchion Raspberry Pi yn unig. Gwaherddir pob defnydd arall o'r ADNODDAU. Ni roddir unrhyw drwydded i unrhyw hawl eiddo deallusol RPL arall na thrydydd parti arall.
GWEITHGAREDDAU RISG UCHEL. Nid yw cynhyrchion Raspberry Pi wedi'u cynllunio, eu cynhyrchu na'u bwriadu i'w defnyddio mewn amgylcheddau peryglus sy'n gofyn am berfformiad diogel rhag methiannau, megis wrth weithredu cyfleusterau niwclear, systemau llywio neu gyfathrebu awyrennau, rheoli traffig awyr, systemau arfau neu gymwysiadau sy'n hanfodol i ddiogelwch (gan gynnwys systemau cynnal bywyd a dyfeisiau meddygol eraill), lle gallai methiant y cynhyrchion arwain yn uniongyrchol at farwolaeth, anaf personol neu ddifrod corfforol neu amgylcheddol difrifol (“Gweithgareddau Risg Uchel”). Mae RPL yn gwadu'n benodol unrhyw warant benodol neu ymhlyg o addasrwydd ar gyfer Gweithgareddau Risg Uchel ac nid yw'n derbyn unrhyw atebolrwydd am ddefnyddio neu gynnwys cynhyrchion Raspberry Pi mewn Gweithgareddau Risg Uchel. Darperir cynhyrchion Raspberry Pi yn amodol ar RPL. Telerau SafonolNid yw darpariaeth RPL o'r ADNODDAU yn ehangu nac yn addasu RPL fel arall Telerau Safonol gan gynnwys ond heb fod yn gyfyngedig i'r ymwadiadau a'r gwarantau a fynegir ynddynt.
Hanes fersiynau dogfen
| Rhyddhau | Dyddiad | Disgrifiad |
| 1 | 1-Ebr-25 | Rhyddhad cychwynnol |
Cwmpas y ddogfen
Mae'r ddogfen hon yn berthnasol i'r cynhyrchion Raspberry Pi canlynol:
| DP 0 | DP 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 | Pawb | Pawb | Pawb | Pawb | Pawb | Pawb | Pawb | Pawb | Pawb | Pawb |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Rhagymadrodd
Dros y blynyddoedd, mae'r opsiynau sydd ar gael ar gyfer allbwn sain ar gyfrifiaduron un bwrdd (SBCs) Raspberry Pi wedi dod yn fwy niferus, ac mae'r ffordd maen nhw'n cael eu gyrru o feddalwedd wedi newid.
Bydd y ddogfen hon yn mynd trwy lawer o'r opsiynau sydd ar gael ar gyfer allbwn sain ar eich dyfais Raspberry Pi ac yn darparu cyfarwyddiadau ar sut i ddefnyddio opsiynau sain o'r bwrdd gwaith a'r llinell orchymyn.
Mae'r papur gwyn hwn yn tybio bod y ddyfais Raspberry Pi yn rhedeg system weithredu Raspberry Pi ac yn gwbl gyfredol gyda'r cadarnwedd a'r cnewyllyn diweddaraf.
Caledwedd sain Raspberry Pi
HDMI
Mae gan bob SBC Raspberry Pi gysylltydd HDMI sy'n cefnogi sain HDMI. Bydd cysylltu eich SBC Raspberry Pi â monitor neu deledu gyda seinyddion yn galluogi allbwn sain HDMI yn awtomatig trwy'r seinyddion hynny. Mae sain HDMI yn signal digidol o ansawdd uchel, felly gall y canlyniadau fod yn dda iawn, a chefnogir sain amlsianel fel DTS.
Os ydych chi'n defnyddio fideo HDMI ond eisiau i'r signal sain hollti i ffwrdd — er enghraifftample, i un amplifter nad yw'n cefnogi mewnbwn HDMI — yna bydd angen i chi ddefnyddio darn ychwanegol o galedwedd o'r enw holltwr i echdynnu'r signal sain o'r signal HDMI. Gall hyn fod yn ddrud, ond mae opsiynau eraill, a disgrifir y rhain isod.
Jac PCM/3.5 mm analog
Mae modelau Raspberry Pi B+, 2, 3, a 4 yn cynnwys jac sain 4-polyn 3.5 mm a all gefnogi signalau sain a fideo cyfansawdd. Mae hwn yn allbwn analog o ansawdd isel a gynhyrchir o signal PCM (modiwleiddio cod pwls), ond mae'n dal yn addas ar gyfer clustffonau a seinyddion bwrdd gwaith.
NODYN
Nid oes allbwn sain analog ar Raspberry Pi 5.
Diffinnir y signalau plwg jac yn y tabl canlynol, gan ddechrau o ben y cebl ac yn gorffen ar y domen. Mae ceblau ar gael gydag aseiniadau gwahanol, felly gwnewch yn siŵr bod gennych yr un cywir.
| Segment Jack | Arwydd |
| llawes | Fideo |
| Ffonio 2 | Daear |
| Ffonio 1 | Iawn |
| Tip | Chwith |
Byrddau addasydd sy'n seiliedig ar I2S
Mae gan bob model o SBCs Raspberry Pi berifferol I2S ar gael ar bennawd GPIO. Safon rhyngwyneb bws cyfresol trydanol yw I2S a ddefnyddir i gysylltu dyfeisiau sain digidol a chyfleu data sain PCM rhwng perifferolion mewn dyfais electronig. Mae Raspberry Pi Ltd yn cynhyrchu ystod o fyrddau sain sy'n cysylltu â'r pennawd GPIO ac yn defnyddio'r rhyngwyneb I2S i drosglwyddo data sain o'r SoC (system ar sglodion) i'r bwrdd ychwanegu.
Nodyn: Gelwir byrddau ychwanegol sy'n cysylltu trwy'r pennawd GPIO ac yn cadw at y manylebau priodol yn HATs (Hardware Attached on Top). Gellir dod o hyd i'w manylebau yma: https://datasheets.raspberrypi.com/
Gellir gweld yr ystod lawn o HATs sain ar y Raspberry Pi Ltd. websafle: https://www.raspberrypi.com/products/
Mae nifer fawr o HATs trydydd parti ar gael hefyd ar gyfer allbwn sain, er enghraifftampgan Pimoroni, HiFiBerry, Adafruit, ac ati, ac mae'r rhain yn darparu llu o nodweddion gwahanol.
USB sain
Os nad yw'n bosibl gosod HAT, neu os ydych chi'n chwilio am ffordd gyflym a hawdd o atodi plwg jac ar gyfer allbwn clustffonau neu fewnbwn meicroffon, yna mae addasydd sain USB yn ddewis da. Dyfeisiau syml, rhad yw'r rhain sy'n plygio i mewn i un o'r porthladdoedd USB-A ar y Raspberry Pi SBC.
Mae system weithredu Raspberry Pi yn cynnwys gyrwyr ar gyfer sain USB yn ddiofyn; cyn gynted ag y bydd dyfais wedi'i phlygio i mewn, dylai ymddangos ar ddewislen y ddyfais sy'n ymddangos pan gliciwch ar y dde ar eicon y siaradwr ar y bar tasgau.
Bydd y system hefyd yn canfod yn awtomatig a oes gan y ddyfais USB sydd ynghlwm fewnbwn meicroffon ac yn galluogi'r gefnogaeth briodol.
Bluetooth
Mae sain Bluetooth yn cyfeirio at drosglwyddo data sain yn ddiwifr drwy dechnoleg Bluetooth, a ddefnyddir yn helaeth iawn. Mae'n galluogi'r Raspberry Pi SBC i siarad â siaradwyr Bluetooth a chlustffonau/clustffonau, neu unrhyw ddyfais sain arall sydd â chefnogaeth Bluetooth. Mae'r ystod yn eithaf byr - tua 10 m ar y mwyaf.
Mae angen 'paru' dyfeisiau Bluetooth gyda'r Raspberry Pi SBC a byddant yn ymddangos yn y gosodiadau sain ar y bwrdd gwaith unwaith y bydd hyn wedi'i wneud. Mae Bluetooth wedi'i osod yn ddiofyn ar Raspberry Pi OS, gyda'r logo Bluetooth yn ymddangos ar dasg y bwrdd gwaith ar unrhyw ddyfeisiau sydd â chaledwedd Bluetooth wedi'i osod (naill ai wedi'i gynnwys neu drwy dongl USB Bluetooth). Pan fydd Bluetooth wedi'i alluogi, bydd yr eicon yn las; pan fydd wedi'i analluogi, bydd yr eicon yn llwyd.
Cymorth meddalwedd
Mae'r feddalwedd cymorth sain sylfaenol wedi newid yn sylweddol yn y ddelwedd system weithredu Raspberry Pi lawn, ac, i'r defnyddiwr terfynol, mae'r newidiadau hyn yn dryloyw ar y cyfan. Yr is-system sain wreiddiol a ddefnyddiwyd oedd ALSA. Olynodd Pulse Audio ALSA, cyn cael ei ddisodli gan y system gyfredol, a elwir yn Pipe Wire. Mae gan y system hon yr un swyddogaeth â Pulse Audio, ac API cydnaws, ond mae ganddi hefyd estyniadau i drin fideo a nodweddion eraill, gan wneud integreiddio fideo ac sain yn llawer haws. Gan fod Pipe Wire yn defnyddio'r un API â Pulse Audio, mae cyfleustodau Pulse Audio yn gweithio'n iawn ar system Pipe Wire.
Defnyddir y cyfleustodau hyn yn yr exampllai isod.
Er mwyn cadw maint y ddelwedd i lawr, mae Raspberry Pi OS Lite yn dal i ddefnyddio ALSA i ddarparu cefnogaeth sain ac nid yw'n cynnwys unrhyw lyfrgelloedd sain Pipe Wire, Pulse Audio, na Bluetooth. Fodd bynnag, mae'n bosibl gosod y llyfrgelloedd priodol i ychwanegu'r nodweddion hynny yn ôl yr angen, a disgrifir y broses hon isod hefyd.
Penbwrdd
Fel y soniwyd uchod, mae gweithrediadau sain yn cael eu trin trwy eicon y siaradwr ar dasg y bwrdd gwaith. Mae clicio chwith ar yr eicon yn dod â'r llithrydd cyfaint a'r botwm mud i fyny, tra bod clicio dde yn dod â rhestr o ddyfeisiau sain sydd ar gael i fyny. Cliciwch ar y ddyfais sain rydych chi am ei defnyddio. Mae yna opsiwn hefyd, trwy glicio dde, i newid y profilea ddefnyddir gan bob dyfais. Mae'r pro hynfilefel arfer maent yn darparu gwahanol lefelau ansawdd.
Os yw cefnogaeth meicroffon wedi'i alluogi, bydd eicon meicroffon yn ymddangos ar y ddewislen; bydd clicio ar y dde ar hwn yn dangos opsiynau dewislen penodol i'r meicroffon, fel dewis dyfais mewnbwn, tra bydd clicio ar y chwith yn dangos gosodiadau lefel mewnbwn.
Bluetooth
I baru dyfais Bluetooth, cliciwch ar y chwith ar yr eicon Bluetooth ar y bar tasgau, yna dewiswch 'Ychwanegu Dyfais'. Yna bydd y system yn dechrau chwilio am ddyfeisiau sydd ar gael, y bydd angen eu rhoi yn y modd 'Darganfod' i'w gweld. Cliciwch ar y ddyfais pan fydd yn ymddangos yn y rhestr a dylai'r dyfeisiau baru wedyn. Ar ôl eu paru, bydd y ddyfais sain yn ymddangos yn y ddewislen, a ddewisir trwy glicio ar yr eicon siaradwr ar y bar tasgau.
Llinell orchymyn
Gan fod Pipe Wire yn defnyddio'r un API â Pulse Audio, mae'r rhan fwyaf o'r gorchmynion Pulse Audio a ddefnyddir i reoli sain yn gweithio ar Pipe Wire. pacts yw'r ffordd safonol o reoli Pulse Audio: teipiwch man pactl i'r llinell orchymyn am fwy o fanylion.
Rhagofynion ar gyfer Raspberry Pi OS Lite
Ar osodiad llawn o Raspberry Pi OS, mae'r holl gymwysiadau a llyfrgelloedd llinell orchymyn gofynnol eisoes wedi'u gosod. Ar y fersiwn Lite, fodd bynnag, nid yw Pipe Wire wedi'i osod yn ddiofyn a rhaid ei osod â llaw er mwyn gallu chwarae sain yn ôl.
I osod y llyfrgelloedd gofynnol ar gyfer Pipe Wire ar Raspberry Pi OS Lite, mewnbwnwch y canlynol: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Os ydych chi'n bwriadu rhedeg cymwysiadau sy'n defnyddio ALSA, bydd angen i chi hefyd osod y canlynol: sudo apt install pipewire-alsa
Ailgychwyn ar ôl y gosodiad yw'r ffordd hawsaf o gael popeth ar waith.
Chwarae sain e.e.amples
Dangos rhestr o fodiwlau sain Pulse sydd wedi'u gosod ar ffurf fer (mae'r ffurf hir yn cynnwys llawer o wybodaeth ac mae'n anodd ei darllen): $ pactl list modules short Dangos rhestr o sinciau Pulse Audio ar ffurf fer:
Mae rhestr $ pactl yn suddo'n fyr
Ar Raspberry Pi 5 sydd wedi'i gysylltu â monitor HDMI gyda sain adeiledig a cherdyn sain USB ychwanegol, mae'r gorchymyn hwn yn rhoi'r allbwn canlynol: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Gwifren Bibell s32le 2ch 48000Hz WEDI'I ATAL 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Gwifren Bibell s16le 2ch 48000Hz WEDI'I ATAL
NODYN
Nid oes gan Raspberry Pi 5 allbwn analog.
Ar gyfer gosodiad Raspberry Pi OS Lite ar Raspberry Pi 4 — sydd ag allbwn HDMI ac analog — dychwelir y canlynol: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pibell Gwifren s16le 2ch 48000Hz ATALIADWY
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pibell Gwifren s32le 2ch 48000Hz ATALIADWY
I arddangos a newid y sinc diofyn i sain HDMI (gan nodi y gallai fod yn ddiofyn eisoes) ar y gosodiad hwn o Raspberry Pi OS Lite, teipiwch:
$ pactl cael-diofyn-sinc
alsa_output.platform-bcm2835_audio.stereo-fallback
$ pactl set-default-sinc 70
$ pactl cael-diofyn-sinc
alsa_output.platform-107c701400.hdmi.hdmi-stereo
I chwarae yn ôl felample, mae angen ei uwchlwytho i'r s yn gyntafampy storfa, yn yr achos hwn ar y sinc diofyn. Gallwch newid y sinc trwy ychwanegu ei enw at ddiwedd y pactl play-sampgorchymyn:
$ pactl llwytho i fynyample sample.mp3 samplename
$ pactl play-sample samplename
Mae gorchymyn Pulse Audio sydd hyd yn oed yn haws i'w ddefnyddio i chwarae sain yn ôl:
$ paplay sample.mp3
Mae gan pactl opsiwn i osod y gyfrol ar gyfer y chwarae yn ôl. Gan fod y bwrdd gwaith yn defnyddio cyfleustodau Pulse Audio i gael a gosod gwybodaeth sain, bydd gweithrediad y newidiadau llinell orchymyn hyn hefyd yn cael ei adlewyrchu yn y llithrydd cyfrol ar y bwrdd gwaith.
Mae'r cynampMae le yn lleihau'r gyfaint 10%:
$ pactl set-sinc-volume @DEFAULT_SINK@ -10%
Mae'r cynampMae le yn gosod y gyfrol i 50%:
$ pactl set-sinc-volume @DEFAULT_SINK@ 50%
Mae yna lawer iawn o orchmynion Pulse Audio nad ydyn nhw wedi'u crybwyll yma. Y Pulse Audio websafle (https://www.freedesktop.org/wiki/Software/PulseAudio/) ac mae'r tudalennau llawysgrifen ar gyfer pob gorchymyn yn cynnig gwybodaeth helaeth am y system.
Bluetooth
Gall rheoli Bluetooth o'r llinell orchymyn fod yn broses gymhleth. Wrth ddefnyddio Raspberry Pi OS Lite, mae'r gorchmynion priodol eisoes wedi'u gosod. Y gorchymyn mwyaf defnyddiol yw bluetoothctl, ac mae rhai e.e.ampDarperir manylion ohono mewn defnydd isod.
Gwneud y ddyfais yn ganfyddadwy i ddyfeisiau eraill:
$ bluetoothctl yn ganfyddadwy ar
Gwneud y ddyfais yn baradwy â dyfeisiau eraill:
$ bluetoothctl paradwy ymlaen
Sganiwch am ddyfeisiau Bluetooth o fewn yr ystod:
$ sgan bluetoothctl ymlaen
Diffoddwch sganio:
Mae gan $ bluetoothctl scan off bluetoothctl ddull rhyngweithiol hefyd, sy'n cael ei alw trwy ddefnyddio'r gorchymyn heb unrhyw baramedrau. Yr enghraifft ganlynolampMae le yn rhedeg y modd rhyngweithiol, lle mae'r gorchymyn rhestr yn cael ei nodi a'r canlyniadau'n cael eu dangos, ar Raspberry Pi 4 sy'n rhedeg Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Asiant wedi'i gofrestru
rhestr # [bluetooth]
Rheolydd D8:3A:DD:3B:00:00 Pi4Lite [diofyn] [bluetooth]#
Gallwch nawr deipio gorchmynion i'r dehonglydd a byddant yn cael eu gweithredu. Gall proses nodweddiadol ar gyfer paru â dyfais, ac yna cysylltu â hi, ddarllen fel a ganlyn: $ bluetoothctl
Asiant wedi'i gofrestru [bluetooth]# darganfyddadwy ar
Llwyddwyd i newid y gellir ei ddarganfod
[CHG] Rheolydd D8:3A:DD:3B:00:00 Gellir ei ganfod ar [bluetooth]# paru ar
Llwyddwyd i newid y parau
[CHG] Rheolydd D8:3A:DD:3B:00:00 Gellir ei baru ar [bluetooth]# sgan ymlaen
< gallai fod yn rhestr hir o ddyfeisiau yn y cyffiniau >
[bluetooth]# pâr [cyfeiriad mac y ddyfais, o'r gorchymyn sganio neu o'r ddyfais ei hun, ar y ffurf xx:xx:xx:xx:xx:xx] [bluetooth]# sganio i ffwrdd
[bluetooth]# cysylltu [yr un cyfeiriad mac] Dylai'r ddyfais Bluetooth ymddangos yn rhestr y sinciau nawr, fel y dangosir yn yr enghraifft honampo osodiad Raspberry Pi OS Lite:
Mae rhestr $ pactl yn suddo'n fyr
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pibell Gwifren s16le 2ch 48000Hz ATALIADWY
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pibell Gwifren s32le 2ch 48000Hz ATALIADWY
71 bluez_output.CA_3A_B2_CA_7C_55.1 Gwifren Pibell s32le 2s 48000Hz Wedi'i Atal
$ pactl set-default-sinc 71
$ paplayample_sain_file>
Gallwch nawr wneud hwn yn ddiofyn a chwarae sain yn ôl arno.
Casgliadau
Mae nifer o wahanol ffyrdd o gynhyrchu allbwn sain o ddyfeisiau Raspberry Pi Ltd, gan ddiwallu gofynion y mwyafrif helaeth o ddefnyddwyr. Mae'r papur gwyn hwn wedi amlinellu'r mecanweithiau hynny ac wedi darparu gwybodaeth am lawer ohonynt. Gobeithir y bydd y cyngor a gyflwynir yma yn helpu'r defnyddiwr terfynol i ddewis y cynllun allbwn sain cywir ar gyfer eu prosiect. Enghraifft symlampDarparwyd canllawiau ar sut i ddefnyddio'r systemau sain, ond dylai'r darllenydd ymgynghori â'r llawlyfrau a'r tudalennau llawlyfr ar gyfer y gorchmynion sain a Bluetooth am fwy o fanylion.
Mae Raspberry Pi yn nod masnach Raspberry Pi Ltd
Raspberry Pi Cyf
Dogfennau / Adnoddau
 |
Cyfrifiadur Bwrdd Sengl Raspberry Pi SBCS [pdfCanllaw Defnyddiwr Cyfrifiadur Bwrdd Sengl SBCS, SBCS, Cyfrifiadur Bwrdd Sengl, Cyfrifiadur Bwrdd, Cyfrifiadur |