Whitepaper Kutoa a
Kiwango cha Juu Zaidiview ya Sauti
Chaguzi kwenye Raspberry Pi SBCs
Raspberry Pi Ltd
Colophon
© 2022-2025 Raspberry Pi Ltd
Hati hizi zimeidhinishwa chini ya Creative Commons Attribution-No Derivatives 4.0 International (CC BY-ND).
Toleo la 1.0
Tarehe ya ujenzi: 28/05/2025
Notisi ya kisheria ya kukanusha
DATA YA KIUFUNDI NA KUTEGEMEA KWA BIDHAA ZA RASPBERRY PI (pamoja na DATASHEETI) ZINAVYOREKEBISHWA MARA KWA MARA (“RASILIMALI”) HUTOLEWA NA RASPBERRY PI LTD (“RPL”) “KAMA ILIVYO” NA KASI YOYOTE AU YOYOTE ILIYOHUSIKA, ISIYO NA DHAMANA, KWA, DHAMANA ZILIZOHUSIKA ZA UUZAJI NA KUFAA KWA MADHUMUNI MAALUM IMEKANUSHWA. Kwa kiwango cha juu kinachoruhusiwa na sheria inayotumika katika hafla yoyote haitawajibika kwa uharibifu wowote wa moja kwa moja, wa moja kwa moja, wa kawaida, maalum, wa mfano, au unaofaa (pamoja na, lakini sio mdogo, ununuzi wa bidhaa mbadala au huduma; upotezaji wa matumizi, data , AU FAIDA; AU KUKATAZWA KWA BIASHARA) HATA HIVYO ILIVYOSABABISHWA NA KWA NADHARIA YOYOTE YA DHIMA, IKIWE KATIKA MKATABA, DHIMA MADHUBUTI, AU TORT (pamoja na UZEMBE AU VINGINEVYO) INAYOTOKEA KWA NJIA YOYOTE NJE YA UTUMIAJI WA RASILIMALI, HATA KWA USHAURI. YA UHARIBIFU HUO.
RPL inahifadhi haki ya kufanya uboreshaji, uboreshaji, masahihisho au marekebisho yoyote kwa RASILIMALI au bidhaa zozote zilizofafanuliwa humo wakati wowote na bila taarifa zaidi.
RASILIMALI zimekusudiwa watumiaji wenye ujuzi na viwango vinavyofaa vya ujuzi wa kubuni. Watumiaji wanawajibika kikamilifu kwa uteuzi wao na matumizi ya RASILIMALI na matumizi yoyote ya bidhaa zilizofafanuliwa ndani yao. Mtumiaji anakubali kufidia na kuweka RPL bila madhara dhidi ya dhima zote, gharama, uharibifu au hasara nyinginezo zinazotokana na matumizi yao ya RASILIMALI. RPL huwapa watumiaji ruhusa ya kutumia RESOURCES pekee kwa kushirikiana na bidhaa za Raspberry Pi. Matumizi mengine yote ya RASILIMALI ni marufuku. Hakuna leseni inayotolewa kwa RPL nyingine yoyote au haki nyingine miliki ya watu wengine.
SHUGHULI ZA HATARI KUBWA. Bidhaa za Raspberry Pi hazijaundwa, kutengenezwa au kukusudiwa kutumika katika mazingira hatarishi yanayohitaji utendakazi usiofaa, kama vile katika uendeshaji wa vifaa vya nyuklia, urambazaji wa ndege au mifumo ya mawasiliano, udhibiti wa trafiki ya anga, mifumo ya silaha au maombi muhimu zaidi ya usalama (ikiwa ni pamoja na mifumo ya usaidizi wa maisha na vifaa vingine vya matibabu), ambapo kushindwa kwa bidhaa kunaweza kusababisha kifo moja kwa moja, kuumia kibinafsi au Hatari kubwa ya shughuli za kimwili au mazingira ("). RPL inakanusha mahususi dhamana yoyote ya wazi au inayodokezwa ya kufaa kwa Shughuli za Hatari Kuu na haikubali dhima ya matumizi au mjumuisho wa bidhaa za Raspberry Pi katika Shughuli za Hatari Kuu. Bidhaa za Raspberry Pi hutolewa chini ya RPL's Masharti ya Kawaida. Utoaji wa RPL wa RPLASILIMALI haupanui au kurekebisha RPL Masharti ya Kawaida ikijumuisha lakini sio tu kanusho na dhamana zilizoonyeshwa ndani yake.
Historia ya toleo la hati
| Kutolewa | Tarehe | Maelezo |
| 1 | 1-Apr-25 | Kutolewa kwa awali |
Upeo wa hati
Hati hii inatumika kwa bidhaa zifuatazo za 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 | Wote | Wote | Wote | Wote | Wote | Wote | Wote | Wote | Wote | Wote |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Utangulizi
Kwa miaka mingi, chaguzi zinazopatikana za kutoa sauti kwenye Raspberry Pi SBCs (kompyuta za bodi moja) zimekuwa nyingi zaidi, na njia zinavyoendeshwa kutoka kwa programu imebadilika.
Hati hii itapitia chaguo nyingi zinazopatikana za kutoa sauti kwenye kifaa chako cha Raspberry Pi na kutoa maagizo ya jinsi ya kutumia chaguo za sauti kutoka kwa eneo-kazi na mstari wa amri.
Karatasi nyeupe hii inachukulia kuwa kifaa cha Raspberry Pi kinaendesha Raspberry Pi OS na kimesasishwa kikamilifu na programu dhibiti na viini vipya zaidi.
Vifaa vya sauti vya Raspberry Pi
HDMI
Raspberry Pi SBC zote zina kiunganishi cha HDMI kinachoauni sauti ya HDMI. Kuunganisha Raspberry Pi SBC yako kwenye kifuatiliaji au televisheni iliyo na spika kutawezesha kiotomatiki kutoa sauti ya HDMI kupitia spika hizo. Sauti ya HDMI ni mawimbi ya dijiti ya ubora wa juu, kwa hivyo matokeo yanaweza kuwa mazuri sana, na sauti ya vituo vingi kama vile DTS inatumika.
Ikiwa unatumia video ya HDMI lakini unataka mawimbi ya sauti kugawanyika - kwa mfanoample, kwa amplifier ambayo haiauni ingizo la HDMI - basi utahitaji kutumia kipande cha ziada cha maunzi kinachoitwa splitter kutoa mawimbi ya sauti kutoka kwa mawimbi ya HDMI. Hii inaweza kuwa ghali, lakini kuna chaguzi nyingine, na hizi zimeelezwa hapa chini.
Jack ya analogi ya PCM/3.5 mm
Aina za Raspberry Pi B+, 2, 3, na 4 zina jeki ya sauti ya 4-pole 3.5 mm ambayo inaweza kuauni mawimbi ya sauti na video mchanganyiko. Hili ni toleo la ubora wa chini la analogi linalozalishwa kutoka kwa mawimbi ya PCM (kubadilisha msimbo wa kunde), lakini bado linafaa kwa vipokea sauti vinavyobanwa kichwani na vipaza sauti vya mezani.
KUMBUKA
Hakuna pato la sauti ya analog kwenye Raspberry Pi 5.
Ishara za kuziba jack zimefafanuliwa katika jedwali lifuatalo, kuanzia mwisho wa kebo na kuishia kwenye ncha. Kebo zinapatikana zikiwa na kazi tofauti, kwa hivyo hakikisha una moja sahihi.
| Sehemu ya Jack | Mawimbi |
| Sleeve | Video |
| pete 2 | Ardhi |
| pete 1 | Sawa |
| Kidokezo | Kushoto |
Bodi za adapta zenye msingi wa I2S
Aina zote za Raspberry Pi SBC zina pembeni ya I2S inayopatikana kwenye kichwa cha GPIO. I2S ni kiwango cha kiolesura cha basi cha umeme kinachotumiwa kuunganisha vifaa vya sauti vya dijiti na kuwasiliana na data ya sauti ya PCM kati ya vifaa vya pembeni kwenye kifaa cha kielektroniki. Raspberry Pi Ltd hutengeneza bodi mbalimbali za sauti zinazounganishwa na kichwa cha GPIO na kutumia kiolesura cha I2S kuhamisha data ya sauti kutoka kwa SoC (mfumo kwenye chip) hadi kwenye ubao wa programu-jalizi.
Kumbuka: Vibao vya kuongeza vinavyounganishwa kupitia kichwa cha GPIO na kuzingatia vipimo vinavyofaa vinajulikana kama HAT (Kifaa Kimeambatishwa Juu). Maelezo yao yanaweza kupatikana hapa: https://datasheets.raspberrypi.com/
Aina kamili za kofia za sauti zinaweza kuonekana kwenye Raspberry Pi Ltd webtovuti: https://www.raspberrypi.com/products/
Pia kuna idadi kubwa ya KOFIA za watu wengine zinazopatikana kwa kutoa sauti, kwa mfanoample kutoka Pimoroni, HiFiBerry, Adafruit, n.k., na hizi hutoa wingi wa vipengele tofauti.
Sauti ya USB
Ikiwa haiwezekani kufunga HAT, au unatafuta njia ya haraka na rahisi ya kuunganisha plug ya jack kwa pato la kichwa au pembejeo ya kipaza sauti, basi adapta ya sauti ya USB ni chaguo nzuri. Hivi ni vifaa rahisi na vya bei nafuu ambavyo huchomeka kwenye mojawapo ya bandari za USB-A kwenye Raspberry Pi SBC.
Raspberry Pi OS inajumuisha viendeshi vya sauti ya USB kwa chaguo-msingi; pindi tu kifaa kinapochomekwa, kinapaswa kuonekana kwenye menyu ya kifaa inayoonekana wakati ikoni ya spika kwenye upau wa kazi inapobofya kulia.
Mfumo pia utagundua kiotomatiki ikiwa kifaa cha USB kilichoambatishwa kina ingizo la maikrofoni na kuwezesha usaidizi unaofaa.
Bluetooth
Sauti ya Bluetooth inahusu upitishaji wa data wa sauti bila waya kupitia teknolojia ya Bluetooth, ambayo hutumiwa sana. Huwezesha Raspberry Pi SBC kuzungumza na spika za Bluetooth na vipokea sauti vya masikioni/vipokea sauti vya masikioni, au kifaa kingine chochote cha sauti chenye usaidizi wa Bluetooth. Safu ni fupi sana - karibu 10 m upeo.
Vifaa vya Bluetooth vinahitaji 'kuoanishwa' na Raspberry Pi SBC na vitaonekana katika mipangilio ya sauti kwenye eneo-kazi pindi hii itakapokamilika. Bluetooth imesakinishwa kwa chaguo-msingi kwenye Raspberry Pi OS, na nembo ya Bluetooth ikionekana kwenye upau wa kazi wa eneo-kazi kwenye vifaa vyovyote ambavyo vimesakinishwa maunzi ya Bluetooth (ama iliyojengwa ndani au kupitia dongle ya USB ya Bluetooth). Wakati Bluetooth imewezeshwa, ikoni itakuwa bluu; inapozimwa, ikoni itakuwa kijivu.
Usaidizi wa programu
Programu ya msingi ya usaidizi wa sauti imebadilika sana katika picha kamili ya Raspberry Pi OS, na, kwa mtumiaji wa mwisho, mabadiliko haya ni ya uwazi zaidi. Mfumo mdogo wa sauti uliotumika ulikuwa ALSA. Sauti ya Pulse ilifanikiwa ALSA, kabla ya kubadilishwa na mfumo wa sasa, unaoitwa Pipe Wire. Mfumo huu una utendakazi sawa na Pulse Audio, na API patanifu, lakini pia una viendelezi vya kushughulikia video na vipengele vingine, na kufanya ujumuishaji wa video na sauti kuwa rahisi zaidi. Kwa sababu Pipe Wire hutumia API sawa na Pulse Audio, huduma za Pulse Audio hufanya kazi vizuri kwenye mfumo wa Pipe Wire.
Huduma hizi hutumiwa katika exampchini.
Ili kupunguza ukubwa wa picha, Raspberry Pi OS Lite bado inatumia ALSA kutoa usaidizi wa sauti na haijumuishi maktaba zozote za Pipe Wire, Pulse Audio, au Bluetooth. Hata hivyo, inawezekana kusakinisha maktaba zinazofaa ili kuongeza vipengele hivyo inavyohitajika, na mchakato huu pia umeelezwa hapa chini.
Eneo-kazi
Kama ilivyoelezwa hapo juu, shughuli za sauti hushughulikiwa kupitia ikoni ya spika kwenye upau wa kazi wa eneo-kazi. Kubofya aikoni ya kushoto huleta kitelezi cha sauti na kitufe cha bubu, huku kubofya kulia kunaleta orodha ya vifaa vya sauti vinavyopatikana. Bofya tu kwenye kifaa cha sauti ambacho ungependa kutumia. Pia kuna chaguo, kupitia kubofya kulia, kubadilisha profilehutumiwa na kila kifaa. Hawa profiles kawaida hutoa viwango tofauti vya ubora.
Ikiwa usaidizi wa kipaza sauti umewezeshwa, ikoni ya kipaza sauti itaonekana kwenye menyu; kubofya kulia kwenye hii kutaleta chaguo mahususi za menyu ya maikrofoni, kama vile uteuzi wa kifaa cha kuingiza data, huku kubofya kushoto kuleta mipangilio ya kiwango cha ingizo.
Bluetooth
Ili kuoanisha kifaa cha Bluetooth, bofya-kushoto kwenye ikoni ya Bluetooth kwenye upau wa kazi, kisha uchague 'Ongeza Kifaa'. Kisha mfumo utaanza kutafuta vifaa vinavyopatikana, ambavyo vitahitajika kuwekwa kwenye hali ya 'Gundua' ili kuonekana. Bofya kwenye kifaa kinapoonekana kwenye orodha na vifaa vinapaswa kuunganishwa. Mara baada ya kuunganishwa, kifaa cha sauti kitaonekana kwenye menyu, ambayo imechaguliwa kwa kubofya ikoni ya msemaji kwenye barani ya kazi.
Mstari wa amri
Kwa sababu Pipe Wire hutumia API sawa na Pulse Audio, amri nyingi za Pulse Audio zinazotumiwa kudhibiti kazi ya sauti kwenye Pipe Wire. pacts ndio njia ya kawaida ya kudhibiti Sauti ya Pulse: chapa man pactl kwenye safu ya amri kwa maelezo zaidi.
Masharti ya Raspberry Pi OS Lite
Kwenye usakinishaji kamili wa Raspberry Pi OS, programu zote za mstari wa amri na maktaba tayari zimesakinishwa. Hata hivyo, kwenye toleo la Lite, Pipe Wire haijasakinishwa kwa chaguomsingi na lazima isakinishwe wewe mwenyewe ili kuweza kucheza sauti tena.
Ili kusakinisha maktaba zinazohitajika za Pipe Wire kwenye Raspberry Pi OS Lite, tafadhali ingiza zifuatazo: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Ikiwa unakusudia kuendesha programu zinazotumia ALSA, utahitaji pia kusakinisha zifuatazo: sudo apt install pipewire-alsa.
Kuanzisha upya baada ya usakinishaji ndiyo njia rahisi ya kupata kila kitu na kufanya kazi.
Uchezaji wa sauti kwa mfanoampchini
Onyesha orodha ya moduli za sauti za Pulse zilizosakinishwa kwa ufupi (fomu ndefu ina maelezo mengi na ni vigumu kusoma): $ pactl list modules short Onyesha orodha ya sinki za Sauti ya Pulse kwa ufupi:
Orodha ya $ pactl ni fupi
Kwenye Raspberry Pi 5 iliyounganishwa na kifuatiliaji cha HDMI kilicho na sauti iliyojengewa ndani na kadi ya ziada ya sauti ya USB, amri hii inatoa matokeo yafuatayo: $ pactl list inazama fupi.
. s16le 2ch 48000Hz IMESIMAMA
KUMBUKA
Raspberry Pi 5 haina analog nje.
Kwa usakinishaji wa Raspberry Pi OS Lite kwenye Raspberry Pi 4 - ambayo ina HDMI na analog nje - ifuatayo inarejeshwa: $ pactl list inazama fupi.
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pipe Wire s16le 2ch 48000Hz IMESIMAMISHWA
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pipe Wire s32le 2ch 48000Hz IMESIMAMISHWA
Ili kuonyesha na kubadilisha sinki chaguo-msingi kuwa sauti ya HDMI (ikibainisha kuwa inaweza kuwa chaguomsingi) kwenye usakinishaji huu wa Raspberry Pi OS Lite, andika:
$ pactl pata-default-sink
alsa_output.platform-bcm2835_audio.stereo-fallback
$ pactl set-default-sink 70
$ pactl pata-default-sink
alsa_output.platform-107c701400.hdmi.hdmi-stereo
Ili kucheza nyuma kamaampna, kwanza inahitaji kupakiwa kwa sample cache, katika kesi hii kwenye sinki chaguo-msingi. Unaweza kubadilisha sinki kwa kuongeza jina lake hadi mwisho wa pactl play-sampamri hii:
$ pactl upload-sampyaample.mp3 samplename
$ pactl kucheza-sampyaamplename
Kuna amri ya Sauti ya Pulse ambayo ni rahisi zaidi kutumia kucheza sauti tena:
$ paplay sample.mp3
pactl ina chaguo la kuweka sauti ya uchezaji tena. Kwa sababu eneo-kazi hutumia huduma za Sauti ya Pulse kupata na kuweka maelezo ya sauti, utekelezaji wa mabadiliko haya ya mstari wa amri pia utaonyeshwa kwenye kitelezi cha sauti kwenye eneo-kazi.
Ex huyuample inapunguza sauti kwa 10%:
$ pactl set-sink-volume @DEFAULT_SINK@ -10%
Ex huyuampleta sauti hadi 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
Kuna amri nyingi, nyingi za Sauti ya Pulse ambazo hazijatajwa hapa. Sauti ya Pulse webtovuti (https://www.freedesktop.org/wiki/Software/PulseAudio/) na kurasa za mtu kwa kila amri hutoa habari nyingi juu ya mfumo.
Bluetooth
Kudhibiti Bluetooth kutoka kwa mstari wa amri inaweza kuwa mchakato mgumu. Unapotumia Raspberry Pi OS Lite, amri zinazofaa tayari zimewekwa. Amri muhimu zaidi ni bluetoothctl, na baadhi ya zamaniampmachache yanayotumika yametolewa hapa chini.
Fanya kifaa kitambulike kwa vifaa vingine:
$ bluetoothctl inaweza kugunduliwa kwenye
Fanya kifaa kilinganishwe na vifaa vingine:
$ bluetoothctl inayoweza kulinganishwa imewashwa
Changanua vifaa vya Bluetooth katika masafa:
$ bluetoothctl scanning imewashwa
Zima utambazaji:
$ bluetoothctl scan off bluetoothctl pia ina modi ya mwingiliano, ambayo hutolewa kwa kutumia amri bila vigezo. Ex ifuatayoample huendesha modi ya maingiliano, ambapo amri ya orodha imeingizwa na matokeo yameonyeshwa, kwenye Raspberry Pi 4 inayoendesha Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Wakala amesajiliwa
[bluetooth]# orodha
Kidhibiti D8:3A:DD:3B:00:00 Pi4Lite [chaguo-msingi] [bluetooth]#
Sasa unaweza kuandika amri kwenye mkalimani na zitatekelezwa. Mchakato wa kawaida wa kuoanisha na, na kisha kuunganisha kwa, kifaa kinaweza kusoma kama ifuatavyo: $ bluetoothctl
Wakala amesajiliwa [bluetooth]# inaweza kugunduliwa kwenye
Ubadilishaji unaoweza kutambulika umefaulu
[CHG] Kidhibiti D8:3A:DD:3B:00:00 Kinaweza kutambulika kwenye [bluetooth]# inayooanishwa kwenye
Kubadilisha mlinganisho kumefaulu
[CHG] Kidhibiti D8:3A:DD:3B:00:00 Huoanishwa kwenye [bluetooth]# scan
< inaweza kuwa orodha ndefu ya vifaa vilivyo karibu >
[bluetooth]# jozi [anwani ya mac ya kifaa, kutoka kwa amri ya kuchanganua au kutoka kwa kifaa chenyewe, katika mfumo wa xx:xx:xx:xx:xx:xx] [bluetooth]# imezimwa
[bluetooth]# connect [anuani sawa ya mac] Kifaa cha Bluetooth sasa kinafaa kuonekana kwenye orodha ya sinki, kama inavyoonyeshwa katika nakala hii.ample kutoka kwa usakinishaji wa Raspberry Pi OS Lite:
Orodha ya $ pactl ni fupi
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pipe Wire s16le 2ch 48000Hz IMESIMAMISHWA
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pipe Wire s32le 2ch 48000Hz IMESIMAMISHWA
71 bluez_output.CA_3A_B2_CA_7C_55.1 Pipe Wire s32le 2ch 48000Hz IMESIMAMISHWA
$ pactl set-default-sink 71
$ paplayample_sauti_file>
Sasa unaweza kufanya hii iwe chaguomsingi na ucheze sauti tena juu yake.
Hitimisho
Kuna njia kadhaa tofauti za kutoa pato la sauti kutoka kwa vifaa vya Raspberry Pi Ltd, vinavyokidhi mahitaji mengi ya watumiaji. Whitepaper hii imeainisha taratibu hizo na kutoa taarifa kuhusu nyingi kati yake. Inatarajiwa kwamba ushauri uliotolewa hapa utamsaidia mtumiaji wa mwisho kuchagua mpango sahihi wa kutoa sauti kwa mradi wao. Mfano rahisiampmaelezo ya jinsi ya kutumia mifumo ya sauti yametolewa, lakini msomaji anapaswa kutazama miongozo na kurasa za watu kwa amri za sauti na Bluetooth kwa maelezo zaidi.
Raspberry Pi ni chapa ya biashara ya Raspberry Pi Ltd
Raspberry Pi Ltd
Nyaraka / Rasilimali
 |
Kompyuta ya Bodi ya Raspberry Pi SBCS [pdf] Mwongozo wa Mtumiaji Kompyuta ya Bodi Moja ya SBCS, SBCS, Kompyuta ya Bodi Moja, Kompyuta ya Bodi, Kompyuta |