A Whitepaper Menehi a
Dhuwur-Level Overview saka Audio
Pilihan ing Raspberry Pi SBCs
Raspberry Pi Ltd
Kolofon
© 2022-2025 Raspberry Pi Ltd
Dokumentasi iki dilisensi ing Creative Commons Attribution-No Derivatives 4.0 International (CC BY-ND).
Versi 1.0
Tanggal Dibangun: 28/05/2025
Kabar wewaler legal
DATA TEKNIS LAN reliabilitas kanggo PRODUK RASPBERRY PI (kalebu lembar data) minangka diowahi saka wektu kanggo wektu ("SUMBER") diwenehake dening RASPBERRY PI LTD ("RPL") "AS IS" LAN JAMINAN EXPRESS UTAWA TERSIRAT, ora kalebu, TO, JAMINAN sing diwenehake kanggo MERCHANTABILITY lan FITNESS FOR A TUJUAN PARTICULAR DISCLAIMED. TO THE MAXIMUM EXTENTED BY APLIKASI LAW IN NO EVENT RPL BE LIABLE FOR ANY LANGSUNG, LANGSUNG, INCIDENTAL, KHUSUS, EXEMPLARY, UTAWA KONSEQUENTIAL RUSAK (kalebu, nanging ora winates kanggo, pengadaan barang-barang pengganti, DATA PENGGANTIAN; , Utawa bathi; UTAWA GANGGUAN BISNIS) Nanging njalari lan ing sembarang teori tanggung jawab, apa ing kontrak, TANGGUNG JAWAB KETAT, UTAWA TORT (kalebu teledor utawa liyane) njedhul ing sembarang cara metu saka nggunakake sumber daya sumber daya, KARUSAKAN KITU.
RPL nduweni hak kanggo nggawe dandan, dandan, koreksi utawa modifikasi liyane menyang RESOURCES utawa produk sing diterangake ing sawayah-wayah lan tanpa kabar luwih lanjut.
SUMBER DAYA ditujokake kanggo pangguna sing trampil kanthi tingkat pengetahuan desain sing cocog. Pangguna mung tanggung jawab kanggo milih lan nggunakake RESOURCES lan aplikasi apa wae saka produk sing diterangake ing. Pangguna setuju kanggo menehi ganti rugi lan njaga RPL ora mbebayani tumrap kabeh tanggung jawab, biaya, kerusakan utawa kerugian liyane amarga nggunakake RESOURCES. RPL menehi ijin pangguna kanggo nggunakake RESOURCES mung bebarengan karo produk Raspberry Pi. Kabeh nggunakake RESOURCES liyane dilarang. Ora ana lisensi sing diwenehake marang RPL liyane utawa hak properti intelektual pihak katelu liyane.
KEGIATAN RISIKO Dhuwur. Produk Raspberry Pi ora dirancang, diprodhuksi utawa dimaksudake kanggo digunakake ing lingkungan sing mbebayani sing mbutuhake kinerja sing gagal, kayata ing operasi fasilitas nuklir, navigasi pesawat utawa sistem komunikasi, kontrol lalu lintas udhara, sistem senjata utawa aplikasi kritis safety (kalebu sistem dhukungan urip lan piranti medis liyane), sing bisa nyebabake kegagalan produk kasebut langsung nyebabake pati, ciloko pribadi utawa karusakan fisik utawa lingkungan sing abot ("Kegiatan sing mbebayani banget"). RPL khusus mbatalake sembarang babar pisan nyata utawa diwenehake saka fitness kanggo High Risk Activities lan ora tanggung jawab kanggo nggunakake utawa inklusi produk Raspberry Pi ing High Risk Kegiatan. Produk Raspberry Pi diwenehake miturut RPL Ketentuan Standar. Penyediaan RPL saka RESOURCES ora nggedhekake utawa ngowahi RPL Ketentuan Standar kalebu nanging ora winates kanggo wewaler lan babar pisan ditulis ing.
Riwayat versi dokumen
| Ngeculake | Tanggal | Katrangan |
| 1 | 1-Apr-25 | Rilis wiwitan |
Lingkup dokumen
Dokumen iki ditrapake kanggo produk Raspberry Pi ing ngisor iki:
| 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 | Kabeh | Kabeh | Kabeh | Kabeh | Kabeh | Kabeh | Kabeh | Kabeh | Kabeh | Kabeh |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Pambuka
Sajrone pirang-pirang taun, pilihan sing kasedhiya kanggo output audio ing Raspberry Pi SBCs (komputer papan tunggal) dadi luwih akeh, lan cara didorong saka piranti lunak wis diganti.
Dokumen iki bakal mbukak akeh pilihan sing kasedhiya kanggo output audio ing piranti Raspberry Pi lan menehi instruksi babagan cara nggunakake opsi audio saka desktop lan baris printah.
Whitepaper iki nganggep yen piranti Raspberry Pi mlaku ing Raspberry Pi OS lan kanthi lengkap karo perangkat kukuh lan kernel paling anyar.
hardware audio Raspberry Pi
HDMI
Kabeh Raspberry Pi SBC duwe konektor HDMI sing ndhukung audio HDMI. Nyambungake Raspberry Pi SBC menyang monitor utawa televisi nganggo speaker bakal ngaktifake output audio HDMI kanthi otomatis liwat speaker kasebut. Audio HDMI minangka sinyal digital kanthi kualitas dhuwur, saengga asile bisa apik banget, lan audio multisaluran kaya DTS didhukung.
Yen sampeyan nggunakake video HDMI nanging pengin sinyal audio dipisahake - contoneample, iki amplifier sing ora ndhukung input HDMI - banjur sampeyan kudu nggunakake piranti tambahan sing disebut splitter kanggo ngekstrak sinyal audio saka sinyal HDMI. Iki bisa larang, nanging ana opsi liyane, lan iki diterangake ing ngisor iki.
Analog PCM/3.5 mm jack
Model Raspberry Pi B+, 2, 3, lan 4 nduweni jack audio 4-kutub 3.5 mm sing bisa ndhukung sinyal audio lan video komposit. Iki minangka output analog kualitas rendah sing diasilake saka sinyal PCM (modulasi kode pulsa), nanging isih cocog kanggo headphone lan speaker desktop.
CATETAN
Ora ana output audio analog ing Raspberry Pi 5.
Sinyal plug jack ditetepake ing tabel ing ngisor iki, wiwit saka ujung kabel lan pungkasan ing pucuk. Kabel kasedhiya karo tugas beda, supaya priksa manawa sampeyan duwe sing bener.
| bagean Jack | Sinyal |
| Lengan | Video |
| Ring 2 | lemah |
| Ring 1 | bener |
| Tip | Ngiwa |
Papan adaptor basis I2S
Kabeh model Raspberry Pi SBC duwe periferal I2S sing kasedhiya ing header GPIO. I2S minangka standar antarmuka bus serial listrik sing digunakake kanggo nyambungake piranti audio digital lan komunikasi data audio PCM antarane periferal ing piranti elektronik. Raspberry Pi Ltd ngasilake sawetara papan audio sing nyambung menyang header GPIO lan nggunakake antarmuka I2S kanggo mindhah data audio saka SoC (sistem ing chip) menyang papan tambahan.
Cathetan: Papan tambahan sing nyambung liwat header GPIO lan netepi spesifikasi sing cocog diarani HATs (Hardware Attached on Top). Spesifikasi bisa ditemokake ing kene: https://datasheets.raspberrypi.com/
Range lengkap HAT audio bisa dideleng ing Raspberry Pi Ltd websitus: https://www.raspberrypi.com/products/
Ana uga nomer akeh HAT pihak katelu kasedhiya kanggo output audio, kanggo Example saka Pimoroni, HiFiBerry, Adafruit, lan sapiturute, lan iki nyedhiyakake macem-macem fitur.
USB audio
Yen ora bisa nginstal HAT, utawa sampeyan lagi nggoleki cara sing cepet lan gampang kanggo masang plug jack kanggo output headphone utawa input mikropon, banjur adaptor audio USB minangka pilihan sing apik. Iki minangka piranti sing gampang lan murah sing dipasang ing salah sawijining port USB-A ing Raspberry Pi SBC.
Raspberry Pi OS kalebu driver kanggo audio USB minangka standar; sanalika piranti wis kepasang ing, iku kudu katon ing menu piranti sing katon nalika lambang speaker ing taskbar diklik tengen.
Sistem uga bakal ndeteksi kanthi otomatis yen piranti USB sing dipasang duwe input mikropon lan ngaktifake dhukungan sing cocog.
Bluetooth
Audio Bluetooth nuduhake transmisi nirkabel data swara liwat teknologi Bluetooth, sing akeh digunakake. Iki ngidini Raspberry Pi SBC bisa ngobrol karo speaker Bluetooth lan headphone / earbuds, utawa piranti audio liyane kanthi dhukungan Bluetooth. Jangkoan cukup cendhak - maksimal 10 m.
Piranti Bluetooth kudu 'dipasangake' karo Raspberry Pi SBC lan bakal katon ing setelan audio ing desktop yen wis rampung. Bluetooth diinstal kanthi standar ing Raspberry Pi OS, kanthi logo Bluetooth katon ing taskbar desktop ing piranti apa wae sing wis diinstal hardware Bluetooth (dibangun ing utawa liwat dongle USB Bluetooth). Nalika Bluetooth diaktifake, lambang bakal biru; nalika dipatèni, lambang bakal werna abu-abu.
Dhukungan piranti lunak
Piranti lunak dhukungan audio sing ndasari wis owah banget ing gambar Raspberry Pi OS lengkap, lan, kanggo pangguna pungkasan, owah-owahan kasebut biasane transparan. Subsistem swara asli sing digunakake yaiku ALSA. Pulse Audio ngganteni ALSA, sadurunge diganti karo sistem saiki, sing diarani Pipe Wire. Sistem iki nduweni fungsi sing padha karo Pulse Audio, lan API sing kompatibel, nanging uga nduweni ekstensi kanggo nangani video lan fitur liyane, nggawe integrasi video lan audio luwih gampang. Amarga Pipe Wire nggunakake API sing padha karo Pulse Audio, utilitas Pulse Audio bisa digunakake ing sistem Pipe Wire.
Utilitas iki digunakake ing examples ngisor.
Kanggo njaga ukuran gambar mudhun, Raspberry Pi OS Lite isih nggunakake ALSA kanggo nyedhiyakake dhukungan audio lan ora kalebu perpustakaan audio Pipe Wire, Pulse Audio, utawa Bluetooth. Nanging, sampeyan bisa nginstal perpustakaan sing cocog kanggo nambah fitur kasebut kaya sing dibutuhake, lan proses iki uga diterangake ing ngisor iki.
Desktop
Kaya kasebut ing ndhuwur, operasi audio ditangani liwat lambang speaker ing taskbar desktop. Ngiwa-ngklik ing lambang ndadekke munggah volume panggeser lan tombol bisu, nalika ngeklik tengen ndadekke munggah dhaptar piranti audio kasedhiya. Cukup klik ing piranti audio sing pengin digunakake. Ana uga pilihan, liwat klik-tengen, kanggo ngganti profiles digunakake dening saben piranti. Iki profiles biasane nyedhiyani tingkat kualitas beda.
Yen dhukungan mikropon diaktifake, lambang mikropon bakal katon ing menu; ngeklik tengen iki bakal mbukak opsi menu khusus mikropon, kayata pilihan piranti input, dene ngeklik kiwa ndadekke setelan level input.
Bluetooth
Kanggo masangake piranti Bluetooth, klik kiwa ing lambang Bluetooth ing taskbar, banjur pilih 'Tambah Piranti'. Sistem banjur bakal miwiti nggoleki piranti sing kasedhiya, sing kudu dilebokake ing mode 'Temokake' supaya katon. Klik ing piranti nalika katon ing dhaptar lan piranti banjur kudu dipasangake. Sawise dipasangake, piranti audio bakal katon ing menu, sing dipilih kanthi ngeklik lambang speaker ing taskbar.
baris printah
Amarga Pipe Wire nggunakake API sing padha karo Pulse Audio, mayoritas printah Pulse Audio digunakake kanggo ngontrol karya audio ing Pipe Wire. pacts minangka cara standar kanggo ngontrol Pulse Audio: ketik man pactl menyang baris printah kanggo rincian liyane.
Prasyarat kanggo Raspberry Pi OS Lite
Ing instalasi lengkap Raspberry Pi OS, kabeh aplikasi lan perpustakaan baris perintah sing dibutuhake wis diinstal. Ing versi Lite, Nanging, Pipe Wire ora diinstal kanthi standar lan kudu diinstal kanthi manual supaya bisa muter maneh swara.
Kanggo nginstal perpustakaan sing dibutuhake kanggo Pipe Wire ing Raspberry Pi OS Lite, ketik ing ngisor iki: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Yen sampeyan pengin mbukak aplikasi sing nggunakake ALSA, sampeyan uga kudu nginstal ing ngisor iki: sudo apt install pipewire-alsa
Reboot sawise instalasi minangka cara paling gampang kanggo mbukak lan mbukak kabeh.
Puter maneh audio examples
Nampilake dhaptar modul audio Pulse sing diinstal ing wangun cendhak (wangun dawa ngemot akeh informasi lan angel diwaca): $ modul dhaptar pactl cendhak Nampilake dhaptar sinks Audio Pulse ing wangun cendhak:
$ dhaptar pactl klelep cendhak
Ing Raspberry Pi 5 sing disambungake menyang monitor HDMI kanthi audio sing dibangun lan kertu swara USB tambahan, printah iki menehi output ing ngisor iki: $ dhaptar pactl sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pipe Wire s32le 2ch 48000Hz DITUNDA 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP000-Wire Output-Device-USB_PnP000 s16le 2ch 48000Hz digantung
CATETAN
Raspberry Pi 5 ora duwe analog.
Kanggo nginstal Raspberry Pi OS Lite ing Raspberry Pi 4 - sing duwe HDMI lan analog metu - ing ngisor iki bali: $ dhaptar pactl klelep cendhak
69 alsa_output.platform-bcm2835_audio.stereo-fallback Kawat Pipa s16le 2ch 48000Hz DITUNDA
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Kawat Pipa s32le 2ch 48000Hz DITUNDA
Kanggo nampilake lan ngganti sink standar menyang audio HDMI (nyathet yen bisa uga wis dadi standar) ing instalasi Raspberry Pi OS Lite iki, ketik:
$ 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
Kanggo muter maneh minangkaample, pisanan kudu diunggah menyang sample cache, ing kasus iki ing sink standar. Sampeyan bisa ngganti sink kanthi nambah jeneng kanggo mburi pactl play-sampdhawuh:
$ pactl upload-sampsample.mp3 sampjeneng
$ pactl muter-sampsampjeneng
Ana printah Pulse Audio sing luwih gampang digunakake kanggo muter maneh audio:
$ papak sample.mp3
pactl duwe pilihan kanggo nyetel volume kanggo puter maneh. Amarga desktop nggunakake utilitas Pulse Audio kanggo entuk lan nyetel informasi audio, eksekusi owah-owahan baris perintah kasebut uga bakal katon ing panggeser volume ing desktop.
Mantan ikiample nyuda volume kanthi 10%:
$ pactl set-sink-volume @DEFAULT_SINK@ -10%
Mantan ikiample nyetel volume kanggo 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
Ana akeh prentah Pulse Audio sing ora kasebut ing kene. Audio Pulsa websitus (https://www.freedesktop.org/wiki/Software/PulseAudio/) lan kaca wong kanggo saben printah nawakake informasi ekstensif babagan sistem.
Bluetooth
Ngontrol Bluetooth saka baris printah bisa dadi proses sing rumit. Nalika nggunakake Raspberry Pi OS Lite, prentah sing cocog wis diinstal. Printah sing paling migunani yaiku bluetoothctl, lan sawetara examples saka nggunakake kasedhiya ing ngisor iki.
Nggawe piranti bisa ditemokake ing piranti liyane:
$ bluetoothctl ditemokaké ing
Gawe piranti bisa dipasangake karo piranti liyane:
$ bluetoothctl dipasangake ing
Pindai piranti Bluetooth ing jangkoan:
$ bluetoothctl scan aktif
Pateni scanning:
$ bluetoothctl scan off bluetoothctl uga duwe mode interaktif, sing dijaluk nggunakake printah tanpa parameter. Ex ing ngisor ikiample mbukak mode interaktif, ngendi printah dhaftar ngetik lan asil ditampilake, ing Raspberry Pi 4 mlaku Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Agen kadhaptar
[bluetooth]# dhaptar
Pengontrol D8:3A:DD:3B:00:00 Pi4Lite [standar] [bluetooth]#
Sampeyan saiki bisa ngetik printah menyang interpreter lan bakal dieksekusi. Proses khas kanggo masangake, banjur nyambung menyang, piranti bisa maca kaya ing ngisor iki: $ bluetoothctl
Agen kadhaptar [bluetooth]# ditemokake ing
Ngganti bisa ditemokake ing sukses
[CHG] Pengontrol D8:3A:DD:3B:00:00 Bisa ditemokake ing [bluetooth]# dipasangake ing
Ngganti pasangan ing kasil
[CHG] Kontroler D8:3A:DD:3B:00:00 Bisa dipasangake ing [bluetooth]# scan aktif
<bisa dadi dhaptar dawa piranti ing sacedhake >
[bluetooth]# pasangan [alamat mac piranti, saka printah pindai utawa saka piranti dhewe, ing wangun xx:xx:xx:xx:xx:xx] [bluetooth]# scan mati
[bluetooth]# nyambung [alamat mac padha] Piranti Bluetooth saiki kudu katon ing dhaptar sink, kaya sing ditampilake ing mantan ikiampsaka instalasi Raspberry Pi OS Lite:
$ dhaptar pactl klelep cendhak
69 alsa_output.platform-bcm2835_audio.stereo-fallback Kawat Pipa s16le 2ch 48000Hz DITUNDA
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Kawat Pipa s32le 2ch 48000Hz DITUNDA
71 bluez_output.CA_3A_B2_CA_7C_55.1 Kabel Pipa s32le 2ch 48000Hz DITUNDA
$ pactl set-default-sink 71
$papanample_audio_file>
Sampeyan saiki bisa nggawe iki standar lan muter maneh audio ing.
Kesimpulan
Ana macem-macem cara kanggo ngasilake output audio saka piranti Raspberry Pi Ltd, sing nyukupi kabutuhan pangguna. Whitepaper iki wis mbatesi mekanisme kasebut lan menehi informasi babagan akeh. Dikarepake yen saran sing diwenehake ing kene bakal mbantu pangguna pungkasan milih skema output audio sing pas kanggo proyeke. Sederhana examples carane nggunakake sistem audio wis kasedhiya, nanging maca kudu takon manual lan kaca manual kanggo printah audio lan Bluetooth kanggo luwih rinci.
Raspberry Pi minangka merek dagang saka Raspberry Pi Ltd
Raspberry Pi Ltd
Dokumen / Sumber Daya
 |
Komputer Papan Tunggal Raspberry Pi SBCS [pdf] Pandhuan pangguna SBCS Komputer Papan Tunggal, SBCS, Komputer Papan Tunggal, Komputer Papan, Komputer |