Pemberian Kertas Putih a
Atas Aras Tinggiview daripada Audio
Pilihan pada SBC Raspberry Pi
Raspberry Pi Ltd
Kolofon
© 2022-2025 Raspberry Pi Ltd
Dokumentasi ini dilesenkan di bawah Creative Commons Attribution-No Derivatives 4.0 International (CC BY-ND).
Versi 1.0
Tarikh binaan: 28/05/2025
Notis penafian undang-undang
DATA TEKNIKAL DAN KEBOLEHPERCAYAAN UNTUK PRODUK RASPBERRY PI (TERMASUK LEMBARAN DATA) SEPERTI YANG DIUBAHSUAI DARI SEMASA KE SEMASA (“SUMBER”) DISEDIAKAN OLEH RASPBERRY PI LTD (“RPL”) “SEBAGAIMANA ADANYA” DAN MANA-MANA WARANTI NYATA ATAU TERSIRAT, TIDAK TERMASUK, KEPADA, WARANTI TERSIRAT KEBOLEHPERDAGANGAN DAN KESESUAIAN UNTUK TUJUAN TERTENTU ADALAH DITOLAK. SEJAUH MAKSIMUM YANG DIBENARKAN OLEH UNDANG-UNDANG YANG BERKENAAN DALAM APA PUN RPL TIDAK AKAN BERTANGGUNGJAWAB ATAS SEBARANG KEROSAKAN LANGSUNG, TIDAK LANGSUNG, SAMPINGAN, KHAS, TEladan ATAU AKIBAT (TERMASUK, TETAPI TIDAK TERHAD KEPADA, PEROLEHAN PEROLEHAN PERKHIDMATAN PENGGANTIAN, DIRI PENGGANTIAN; , ATAU KEUNTUNGAN; ATAU GANGGUAN PERNIAGAAN) WALAUPUN AGAMA AGAMA ADANYA DAN ATAS MANA-MANA TEORI LIABILITI, SAMA ADA DALAM KONTRAK, LIABILITI KETAT ATAU TORT (TERMASUK KECUAIAN ATAU LAIN-LAIN) YANG TIMBUL DALAM MANA-MANA CARA KELUAR DARIPADA PENGGUNAAN SUMBER YANG DIPERCAYAKAN, KEROSAKAN TERSEBUT.
RPL berhak untuk membuat sebarang penambahbaikan, penambahbaikan, pembetulan atau sebarang pengubahsuaian lain pada SUMBER atau mana-mana produk yang diterangkan di dalamnya pada bila-bila masa dan tanpa notis lanjut.
RESOURCES bertujuan untuk pengguna mahir dengan tahap pengetahuan reka bentuk yang sesuai. Pengguna bertanggungjawab sepenuhnya untuk pemilihan dan penggunaan SUMBER dan sebarang aplikasi produk yang diterangkan di dalamnya. Pengguna bersetuju untuk menanggung rugi dan memastikan RPL tidak berbahaya terhadap semua liabiliti, kos, kerosakan atau kerugian lain yang timbul daripada penggunaan SUMBER. RPL memberi kebenaran kepada pengguna untuk menggunakan RESOURCES semata-mata bersama dengan produk Raspberry Pi. Semua penggunaan lain SUMBER adalah dilarang. Tiada lesen diberikan kepada mana-mana RPL lain atau hak harta intelek pihak ketiga yang lain.
AKTIVITI BERISIKO TINGGI. Produk Raspberry Pi tidak direka bentuk, dikilangkan atau dimaksudkan untuk digunakan dalam persekitaran berbahaya yang memerlukan prestasi selamat yang gagal, seperti dalam pengendalian kemudahan nuklear, navigasi pesawat atau sistem komunikasi, kawalan trafik udara, sistem senjata atau aplikasi kritikal keselamatan (termasuk sistem sokongan hayat dan peranti perubatan lain), di mana kegagalan produk boleh membawa kepada kematian, kecederaan peribadi atau kerosakan fizikal atau alam sekitar yang teruk ("Aktiviti Berisiko Tinggi"). RPL secara khusus menafikan sebarang waranti tersurat atau tersirat kesesuaian untuk Aktiviti Berisiko Tinggi dan tidak menerima liabiliti untuk penggunaan atau kemasukan produk Raspberry Pi dalam Aktiviti Berisiko Tinggi. Produk Raspberry Pi disediakan tertakluk kepada RPL Syarat Standard. Peruntukan RPL bagi RESOURCES tidak mengembangkan atau mengubah suai RPL Syarat Standard termasuk tetapi tidak terhad kepada penafian dan jaminan yang dinyatakan di dalamnya.
Sejarah versi dokumen
| Lepaskan | tarikh | Penerangan |
| 1 | 1-Apr-25 | Keluaran awal |
Skop dokumen
Dokumen ini digunakan untuk produk Raspberry Pi berikut:
| 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 | Semua | Semua | Semua | Semua | Semua | Semua | Semua | Semua | Semua | Semua |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
pengenalan
Selama bertahun-tahun, pilihan yang tersedia untuk output audio pada Raspberry Pi SBC (komputer papan tunggal) telah menjadi lebih banyak, dan cara ia didorong daripada perisian telah berubah.
Dokumen ini akan melalui banyak pilihan yang tersedia untuk output audio pada peranti Raspberry Pi anda dan memberikan arahan tentang cara menggunakan pilihan audio daripada desktop dan baris arahan.
Kertas putih ini menganggap bahawa peranti Raspberry Pi menjalankan OS Raspberry Pi dan dikemas kini sepenuhnya dengan perisian tegar dan kernel terkini.
Perkakasan audio Raspberry Pi
HDMI
Semua Raspberry Pi SBC mempunyai penyambung HDMI yang menyokong audio HDMI. Menyambungkan Raspberry Pi SBC anda ke monitor atau televisyen dengan pembesar suara secara automatik akan mendayakan output audio HDMI melalui pembesar suara tersebut. Audio HDMI ialah isyarat digital berkualiti tinggi, jadi hasilnya boleh menjadi sangat baik, dan audio berbilang saluran seperti DTS disokong.
Jika anda menggunakan video HDMI tetapi mahu isyarat audio dipisahkan — contohnyaample, kepada an amplifier yang tidak menyokong input HDMI — maka anda perlu menggunakan perkakasan tambahan yang dipanggil pembahagi untuk mengekstrak isyarat audio daripada isyarat HDMI. Ini mungkin mahal, tetapi terdapat pilihan lain, dan ini diterangkan di bawah.
Bicu PCM/3.5 mm analog
Model Raspberry Pi B+, 2, 3, dan 4 menampilkan bicu audio 3.5 mm 4 kutub yang boleh menyokong isyarat audio dan video komposit. Ini ialah output analog berkualiti rendah yang dihasilkan daripada isyarat PCM (modulat kod nadi), tetapi ia masih sesuai untuk fon kepala dan pembesar suara desktop.
NOTA
Tiada output audio analog pada Raspberry Pi 5.
Isyarat palam bicu ditakrifkan dalam jadual berikut, bermula dari hujung kabel dan berakhir di hujung. Kabel tersedia dengan tugasan yang berbeza, jadi pastikan anda mempunyai yang betul.
| Segmen jek | isyarat |
| lengan baju | Video |
| Cincin 2 | tanah |
| Cincin 1 | Betul |
| Petua | kiri |
Papan penyesuai berasaskan I2S
Semua model Raspberry Pi SBC mempunyai peranti I2S yang tersedia pada pengepala GPIO. I2S ialah standard antara muka bas bersiri elektrik yang digunakan untuk menyambungkan peranti audio digital dan menyampaikan data audio PCM antara peranti dalam peranti elektronik. Raspberry Pi Ltd mengeluarkan pelbagai papan audio yang bersambung ke pengepala GPIO dan menggunakan antara muka I2S untuk memindahkan data audio daripada SoC (sistem pada cip) ke papan tambahan.
Nota: Papan tambahan yang bersambung melalui pengepala GPIO dan mematuhi spesifikasi yang sesuai dikenali sebagai HAT (Perkakasan Dilampirkan di Atas). Spesifikasi mereka boleh didapati di sini: https://datasheets.raspberrypi.com/
Rangkaian penuh HAT audio boleh dilihat pada Raspberry Pi Ltd webtapak: https://www.raspberrypi.com/products/
Terdapat juga sejumlah besar HAT pihak ketiga yang tersedia untuk output audio, contohnyaample daripada Pimoroni, HiFiBerry, Adafruit, dsb., dan ini menyediakan pelbagai ciri yang berbeza.
Audio USB
Jika tidak mungkin untuk memasang HAT, atau anda sedang mencari cara yang cepat dan mudah untuk memasang palam bicu untuk output fon kepala atau input mikrofon, maka penyesuai audio USB ialah pilihan yang baik. Ini adalah peranti mudah dan murah yang dipalamkan ke salah satu port USB-A pada Raspberry Pi SBC.
Raspberry Pi OS termasuk pemacu untuk audio USB secara lalai; sebaik sahaja peranti dipalamkan, ia akan dipaparkan pada menu peranti yang muncul apabila ikon pembesar suara pada bar tugas diklik kanan.
Sistem juga akan mengesan secara automatik jika peranti USB yang dilampirkan mempunyai input mikrofon dan membolehkan sokongan yang sesuai.
Bluetooth
Audio Bluetooth merujuk kepada penghantaran tanpa wayar data bunyi melalui teknologi Bluetooth, yang digunakan secara meluas. Ia membolehkan Raspberry Pi SBC bercakap dengan pembesar suara Bluetooth dan fon kepala/fon telinga, atau mana-mana peranti audio lain dengan sokongan Bluetooth. Julatnya agak pendek — kira-kira 10 m maksimum.
Peranti Bluetooth perlu 'dipasangkan' dengan Raspberry Pi SBC dan akan muncul dalam tetapan audio pada desktop sebaik sahaja ini dilakukan. Bluetooth dipasang secara lalai pada OS Raspberry Pi, dengan logo Bluetooth muncul pada bar tugas desktop pada mana-mana peranti yang mempunyai perkakasan Bluetooth dipasang (sama ada terbina dalam atau melalui dongle USB Bluetooth). Apabila Bluetooth didayakan, ikon akan menjadi biru; apabila ia dilumpuhkan, ikon akan menjadi kelabu.
Sokongan perisian
Perisian sokongan audio yang mendasari telah banyak berubah dalam imej Raspberry Pi OS penuh, dan, untuk pengguna akhir, perubahan ini kebanyakannya telus. Subsistem bunyi asal yang digunakan ialah ALSA. Audio Pulse menggantikan ALSA, sebelum digantikan dengan sistem semasa, yang dipanggil Pipe Wire. Sistem ini mempunyai fungsi yang sama seperti Audio Pulse, dan API yang serasi, tetapi ia juga mempunyai sambungan untuk mengendalikan video dan ciri lain, menjadikan penyepaduan video dan audio lebih mudah. Oleh kerana Pipe Wire menggunakan API yang sama seperti Pulse Audio, utiliti Pulse Audio berfungsi dengan baik pada sistem Pipe Wire.
Utiliti ini digunakan dalam examples di bawah.
Untuk mengecilkan saiz imej, Raspberry Pi OS Lite masih menggunakan ALSA untuk menyediakan sokongan audio dan tidak termasuk mana-mana pustaka audio Pipe Wire, Pulse Audio atau Bluetooth. Walau bagaimanapun, adalah mungkin untuk memasang perpustakaan yang sesuai untuk menambah ciri tersebut seperti yang diperlukan, dan proses ini juga diterangkan di bawah.
Desktop
Seperti yang dinyatakan di atas, operasi audio dikendalikan melalui ikon pembesar suara pada bar tugas desktop. Klik kiri pada ikon memaparkan peluncur kelantangan dan butang redam, manakala klik kanan memaparkan senarai peranti audio yang tersedia. Hanya klik pada peranti audio yang ingin anda gunakan. Terdapat juga pilihan, melalui klik kanan, untuk menukar profiles digunakan oleh setiap peranti. Pro inifiles biasanya menyediakan tahap kualiti yang berbeza.
Jika sokongan mikrofon didayakan, ikon mikrofon akan muncul pada menu; klik kanan pada ini akan memaparkan pilihan menu khusus mikrofon, seperti pemilihan peranti input, manakala klik kiri memaparkan tetapan tahap input.
Bluetooth
Untuk memasangkan peranti Bluetooth, klik kiri pada ikon Bluetooth pada bar tugas, kemudian pilih 'Tambah Peranti'. Sistem kemudiannya akan mula mencari peranti yang tersedia, yang perlu dimasukkan ke dalam mod 'Discover' untuk dilihat. Klik pada peranti apabila ia muncul dalam senarai dan peranti kemudiannya harus berpasangan. Setelah dipasangkan, peranti audio akan muncul dalam menu, yang dipilih dengan mengklik ikon pembesar suara pada bar tugas.
Barisan arahan
Oleh kerana Pipe Wire menggunakan API yang sama seperti Pulse Audio, majoriti arahan Pulse Audio digunakan untuk mengawal kerja audio pada Pipe Wire. pacts ialah cara standard untuk mengawal Audio Pulse: taip man pactl ke dalam baris arahan untuk mendapatkan butiran lanjut.
Prasyarat untuk Raspberry Pi OS Lite
Pada pemasangan penuh Raspberry Pi OS, semua aplikasi baris arahan dan perpustakaan yang diperlukan telah dipasang. Pada versi Lite, walau bagaimanapun, Pipe Wire tidak dipasang secara lalai dan mesti dipasang secara manual untuk dapat memainkan semula bunyi.
Untuk memasang perpustakaan yang diperlukan untuk Pipe Wire pada Raspberry Pi OS Lite, sila masukkan yang berikut: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Jika anda berhasrat untuk menjalankan aplikasi yang menggunakan ALSA, anda juga perlu memasang yang berikut: sudo apt install pipewire-alsa
But semula selepas pemasangan adalah cara paling mudah untuk mendapatkan segala-galanya dan berjalan.
Main balik audio examples
Paparkan senarai modul audio Pulse yang dipasang dalam bentuk pendek (bentuk panjang mengandungi banyak maklumat dan sukar dibaca): $ senarai modul pactl pendek Paparkan senarai sinki Audio Pulse dalam bentuk pendek:
$ senarai pactl tenggelam pendek
Pada Raspberry Pi 5 yang disambungkan ke monitor HDMI dengan audio terbina dalam dan kad bunyi USB tambahan, arahan ini memberikan output berikut: $ senarai pactl tenggelam pendek
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Paip Wayar s32le 2ch 48000Hz DIGANTUNG 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP00.Sound_output-Device- s16le 2ch 48000Hz DIGANTUNG
NOTA
Raspberry Pi 5 tidak mempunyai analog keluar.
Untuk pemasangan Raspberry Pi OS Lite pada Raspberry Pi 4 — yang mempunyai HDMI dan analog keluar — perkara berikut dikembalikan: $ senarai pactl tenggelam pendek
69 alsa_output.platform-bcm2835_audio.stereo-fallback Wayar Paip s16le 2ch 48000Hz DIGANTUNG
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Wayar Paip s32le 2ch 48000Hz DIGANTUNG
Untuk memaparkan dan menukar sinki lalai kepada audio HDMI (dengan menyatakan bahawa ia mungkin sudah menjadi lalai) pada pemasangan Raspberry Pi OS Lite ini, taipkan:
$ 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
Untuk bermain semula sebagaiample, ia perlu dimuat naik terlebih dahulu ke sample cache, dalam kes ini pada sinki lalai. Anda boleh menukar sinki dengan menambahkan namanya pada penghujung pactl play-sampperintah:
$ pactl upload-sampsample.mp3 samplename
$ pactl play-sampsamplename
Terdapat arahan Audio Pulse yang lebih mudah digunakan untuk memainkan semula audio:
$ betik sample.mp3
pactl mempunyai pilihan untuk menetapkan kelantangan untuk main semula. Oleh kerana desktop menggunakan utiliti Audio Pulse untuk mendapatkan dan menetapkan maklumat audio, pelaksanaan perubahan baris arahan ini juga akan ditunjukkan dalam peluncur kelantangan pada desktop.
bekas iniample mengurangkan volum sebanyak 10%:
$ pactl set-sink-volume @DEFAULT_SINK@ -10%
bekas iniample menetapkan volum kepada 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
Terdapat banyak, banyak arahan Audio Pulse yang tidak disebutkan di sini. Audio Nadi webtapak (https://www.freedesktop.org/wiki/Software/PulseAudio/) dan halaman manual untuk setiap arahan menawarkan maklumat yang luas tentang sistem.
Bluetooth
Mengawal Bluetooth dari baris arahan boleh menjadi proses yang rumit. Apabila menggunakan Raspberry Pi OS Lite, arahan yang sesuai telah dipasang. Perintah yang paling berguna ialah bluetoothctl, dan beberapa exampkurang daripadanya digunakan disediakan di bawah.
Jadikan peranti boleh ditemui kepada peranti lain:
$ bluetoothctl boleh ditemui pada
Jadikan peranti berpasangan dengan peranti lain:
$ bluetoothctl berpasangan dihidupkan
Imbas peranti Bluetooth dalam julat:
$ imbasan bluetoothctl dihidupkan
Matikan pengimbasan:
$ bluetoothctl scan off bluetoothctl juga mempunyai mod interaktif, yang digunakan dengan menggunakan arahan tanpa parameter. Ex berikutample menjalankan mod interaktif, di mana arahan senarai dimasukkan dan hasilnya ditunjukkan, pada Raspberry Pi 4 yang menjalankan Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Ejen berdaftar
[bluetooth]# senarai
Pengawal D8:3A:DD:3B:00:00 Pi4Lite [lalai] [bluetooth]#
Anda kini boleh menaip arahan ke dalam penterjemah dan ia akan dilaksanakan. Proses biasa untuk berpasangan dengan, dan kemudian menyambung ke, peranti mungkin berbunyi seperti berikut: $ bluetoothctl
Ejen berdaftar [bluetooth]# boleh ditemui pada
Perubahan boleh ditemui pada berjaya
[CHG] Pengawal D8:3A:DD:3B:00:00 Boleh ditemui pada [bluetooth]# berpasangan dihidupkan
Menukar pasangan pada berjaya
[CHG] Pengawal D8:3A:DD:3B:00:00 Boleh dipasangkan pada [bluetooth]# imbasan dihidupkan
< boleh menjadi senarai panjang peranti di sekitar >
[bluetooth]# pasangan [alamat mac peranti, daripada arahan imbasan atau daripada peranti itu sendiri, dalam bentuk xx:xx:xx:xx:xx:xx] [bluetooth]# imbasan dimatikan
[bluetooth]# sambung [alamat mac yang sama] Peranti Bluetooth kini sepatutnya muncul dalam senarai sinki, seperti yang ditunjukkan dalam bekas iniample daripada pemasangan Raspberry Pi OS Lite:
$ senarai pactl tenggelam pendek
69 alsa_output.platform-bcm2835_audio.stereo-fallback Wayar Paip s16le 2ch 48000Hz DIGANTUNG
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Wayar Paip s32le 2ch 48000Hz DIGANTUNG
71 bluez_output.CA_3A_B2_CA_7C_55.1 Wayar Paip s32le 2ch 48000Hz DIGANTUNG
$ pactl set-default-sink 71
$ betikample_audio_file>
Anda kini boleh menjadikan ini sebagai lalai dan memainkan semula audio padanya.
Kesimpulan
Terdapat beberapa cara berbeza untuk menghasilkan output audio daripada peranti Raspberry Pi Ltd, memenuhi sebahagian besar keperluan pengguna. Kertas putih ini telah menggariskan mekanisme tersebut dan memberikan maklumat tentang kebanyakannya. Adalah diharapkan bahawa nasihat yang dikemukakan di sini akan membantu pengguna akhir memilih skema output audio yang sesuai untuk projek mereka. Contoh mudahampsedikit tentang cara menggunakan sistem audio telah disediakan, tetapi pembaca harus merujuk manual dan halaman manual untuk arahan audio dan Bluetooth untuk mendapatkan butiran lanjut.
Raspberry Pi ialah tanda dagangan Raspberry Pi Ltd
Raspberry Pi Ltd
Dokumen / Sumber
 |
Komputer Papan Tunggal Raspberry Pi SBCS [pdf] Panduan Pengguna Komputer Papan Tunggal SBCS, SBCS, Komputer Papan Tunggal, Komputer Papan, Komputer |