Sebuah Whitepaper yang Memberikan
Over Level Tinggiview dari Audio
Opsi pada Raspberry Pi SBC
Raspberry Pi Ltd
Tanda penerbit
Hak cipta © 2022-2025 Raspberry Pi Ltd.
Dokumentasi ini dilisensikan di bawah Creative Commons Attribution-No Derivatives 4.0 International (CC BY-ND).
Versi 1.0
Tanggal pembuatan: 28/05/2025
Pemberitahuan penafian hukum
DATA TEKNIS DAN KEANDALAN UNTUK PRODUK RASPBERRY PI (TERMASUK LEMBAR DATA) SEBAGAIMANA DIUBAH DARI WAKTU KE WAKTU (“SUMBERDAYA”) YANG DISEDIAKAN OLEH RASPBERRY PI LTD (“RPL”) “SEBAGAIMANA ADANYA” DAN SETIAP GARANSI TERSURAT MAUPUN TERSIRAT, TERMASUK, NAMUN TIDAK TERBATAS UNTUK, JAMINAN TERSIRAT TENTANG DAGANG DAN KESESUAIAN UNTUK TUJUAN TERTENTU DITOLAK. SEJAUH YANG DIIZINKAN OLEH HUKUM YANG BERLAKU DALAM KEADAAN APA PUN, RPL TIDAK BERTANGGUNG JAWAB ATAS KERUSAKAN LANGSUNG, TIDAK LANGSUNG, INSIDENTAL, KHUSUS, CONTOH, ATAU KONSEKUENSIAL (TERMASUK, NAMUN TIDAK TERBATAS PADA, PENGADAAN BARANG ATAU LAYANAN PENGGANTI; KEHILANGAN PENGGUNAAN, DATA , ATAU KEUNTUNGAN; ATAU GANGGUAN BISNIS) NAMUN PENYEBABNYA DAN BERDASARKAN TEORI TANGGUNG JAWAB APA PUN, BAIK DALAM KONTRAK, TANGGUNG JAWAB SANGAT, ATAU KERUGIAN (TERMASUK KELALAIAN ATAU LAINNYA) YANG TIMBUL DALAM CARA APAPUN DARI PENGGUNAAN SUMBER DAYA, BAHKAN JIKA DIBERITAHU TENTANG KEMUNGKINANNYA KERUSAKAN TERSEBUT.
RPL berhak melakukan penyempurnaan, perbaikan, koreksi atau modifikasi lain apa pun terhadap SUMBER DAYA atau produk apa pun yang dijelaskan di dalamnya kapan saja dan tanpa pemberitahuan lebih lanjut.
SUMBER DAYA ini ditujukan bagi pengguna terampil dengan tingkat pengetahuan desain yang memadai. Pengguna bertanggung jawab penuh atas pemilihan dan penggunaan SUMBER DAYA ini serta setiap aplikasi produk yang dijelaskan di dalamnya. Pengguna setuju untuk mengganti rugi dan membebaskan RPL dari segala kewajiban, biaya, kerusakan, atau kerugian lain yang timbul akibat penggunaan SUMBER DAYA ini. RPL memberikan izin kepada pengguna untuk menggunakan SUMBER DAYA ini hanya jika digunakan bersama dengan produk Raspberry Pi. Penggunaan SUMBER DAYA lainnya dilarang. Tidak ada lisensi yang diberikan kepada RPL lain atau hak kekayaan intelektual pihak ketiga lainnya.
AKTIVITAS BERISIKO TINGGI. Produk Raspberry Pi tidak dirancang, diproduksi, atau ditujukan untuk digunakan di lingkungan berbahaya yang memerlukan kinerja keamanan, seperti dalam pengoperasian fasilitas nuklir, sistem navigasi atau komunikasi pesawat, kontrol lalu lintas udara, sistem persenjataan, atau aplikasi yang sangat penting bagi keselamatan (termasuk sistem pendukung kehidupan dan perangkat medis lainnya), yang kegagalan produknya dapat mengakibatkan kematian, cedera diri, atau kerusakan fisik atau lingkungan yang parah (“Aktivitas Berisiko Tinggi”). RPL secara khusus menyangkal segala jaminan tersurat maupun tersirat atas kesesuaian untuk Aktivitas Berisiko Tinggi dan tidak bertanggung jawab atas penggunaan atau penyertaan produk Raspberry Pi dalam Aktivitas Berisiko Tinggi. Produk Raspberry Pi disediakan dengan tunduk pada ketentuan RPL. Istilah StandarPenyediaan SUMBER DAYA oleh RPL tidak memperluas atau mengubah sumber daya RPL. Istilah Standar termasuk namun tidak terbatas pada penyangkalan dan jaminan yang dinyatakan di dalamnya.
Riwayat versi dokumen
| Melepaskan | Tanggal | Keterangan |
| 1 | 1 April 25 | Rilis awal |
Lingkup dokumen
Dokumen ini berlaku untuk produk Raspberry Pi berikut:
| Nomor Induk 0 | Nomor Induk 1 | Nomor 2 | Nomor 3 | Nomor 4 | Nomor 400 | Nomor 5 | Nomor 500 | CM1 | CM3 | CM4 | CM5 | Piko | Pico2 | ||||
| 0 | W | H | A | B | A | B | B | Semua | Semua | Semua | Semua | Semua | Semua | Semua | Semua | Semua | Semua |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Perkenalan
Selama bertahun-tahun, pilihan yang tersedia untuk keluaran audio pada Raspberry Pi SBC (komputer papan tunggal) telah menjadi lebih banyak, dan cara menggerakkannya dari perangkat lunak telah berubah.
Dokumen ini akan membahas banyak pilihan yang tersedia untuk keluaran audio pada perangkat Raspberry Pi Anda dan memberikan petunjuk tentang cara menggunakan pilihan audio dari desktop dan baris perintah.
Dokumen ini mengasumsikan bahwa perangkat Raspberry Pi menjalankan OS Raspberry Pi dan sepenuhnya menggunakan firmware dan kernel terbaru.
Perangkat keras audio Raspberry Pi
Video yang menggunakan HDMI
Semua Raspberry Pi SBC memiliki konektor HDMI yang mendukung audio HDMI. Menghubungkan Raspberry Pi SBC Anda ke monitor atau televisi dengan speaker akan secara otomatis mengaktifkan output audio HDMI melalui speaker tersebut. Audio HDMI adalah sinyal digital berkualitas tinggi, sehingga hasilnya bisa sangat baik, dan audio multikanal seperti DTS juga didukung.
Jika Anda menggunakan video HDMI tetapi ingin sinyal audio terbagi — misalnyaample, ke sebuah ampJika Anda memiliki amplifier yang tidak mendukung input HDMI, Anda perlu menggunakan perangkat keras tambahan yang disebut splitter untuk memisahkan sinyal audio dari sinyal HDMI. Proses ini mungkin mahal, tetapi ada pilihan lain, yang akan dijelaskan di bawah ini.
Jack PCM/3.5 mm analog
Raspberry Pi model B+, 2, 3, dan 4 dilengkapi jack audio 3.5 mm 4-pin yang dapat mendukung sinyal audio dan video komposit. Output analog berkualitas rendah ini dihasilkan dari sinyal PCM (modulasi kode pulsa), tetapi tetap cocok untuk headphone dan speaker desktop.
CATATAN
Tidak ada keluaran audio analog pada Raspberry Pi 5.
Sinyal colokan jack didefinisikan dalam tabel berikut, dimulai dari ujung kabel dan berakhir di ujungnya. Kabel tersedia dengan fungsi yang berbeda-beda, jadi pastikan Anda memiliki kabel yang tepat.
| Segmen Jack | Sinyal |
| Lengan baju | Video |
| Cincin 2 | Tanah |
| Cincin 1 | Benar |
| Tip | Kiri |
Papan adaptor berbasis I2S
Semua model Raspberry Pi SBC memiliki periferal I2S yang tersedia pada header GPIO. I2S adalah standar antarmuka bus serial elektrik yang digunakan untuk menghubungkan perangkat audio digital dan mengomunikasikan data audio PCM antar periferal dalam perangkat elektronik. Raspberry Pi Ltd memproduksi berbagai papan audio yang terhubung ke header GPIO dan menggunakan antarmuka I2S untuk mentransfer data audio dari SoC (sistem pada chip) ke papan tambahan.
Catatan: Papan tambahan yang terhubung melalui header GPIO dan mematuhi spesifikasi yang sesuai dikenal sebagai HAT (Hardware Attached on Top). Spesifikasinya dapat ditemukan di sini: https://datasheets.raspberrypi.com/
Rangkaian lengkap HAT audio dapat dilihat di Raspberry Pi Ltd weblokasi: https://www.raspberrypi.com/products/
Ada juga sejumlah besar HAT pihak ketiga yang tersedia untuk keluaran audio, misalnyaampdari Pimoroni, HiFiBerry, Adafruit, dll., dan ini menyediakan banyak fitur berbeda.
suara USB
Jika tidak memungkinkan untuk memasang HAT, atau Anda mencari cara cepat dan mudah untuk memasang jack untuk output headphone atau input mikrofon, adaptor audio USB adalah pilihan yang tepat. Adaptor ini merupakan perangkat sederhana dan murah yang dapat dicolokkan ke salah satu port USB-A pada Raspberry Pi SBC.
Raspberry Pi OS menyertakan driver untuk audio USB secara default; segera setelah perangkat dicolokkan, perangkat tersebut akan muncul pada menu perangkat yang muncul saat ikon speaker pada bilah tugas diklik kanan.
Sistem juga akan secara otomatis mendeteksi apakah perangkat USB yang terpasang memiliki input mikrofon dan mengaktifkan dukungan yang sesuai.
Bahasa Indonesia: Bluetooth
Audio Bluetooth mengacu pada transmisi nirkabel data suara melalui teknologi Bluetooth, yang sangat luas penggunaannya. Teknologi ini memungkinkan Raspberry Pi SBC untuk berkomunikasi dengan speaker dan headphone/earbud Bluetooth, atau perangkat audio lain yang mendukung Bluetooth. Jangkauannya cukup pendek — maksimal sekitar 10 m.
Perangkat Bluetooth perlu 'dipasangkan' dengan Raspberry Pi SBC dan akan muncul di pengaturan audio di desktop setelah proses ini selesai. Bluetooth terpasang secara default di Raspberry Pi OS, dengan logo Bluetooth muncul di bilah tugas desktop pada perangkat apa pun yang memiliki perangkat keras Bluetooth terpasang (baik bawaan maupun melalui dongle USB Bluetooth). Saat Bluetooth diaktifkan, ikonnya akan berwarna biru; saat dinonaktifkan, ikonnya akan berwarna abu-abu.
Dukungan perangkat lunak
Perangkat lunak pendukung audio yang mendasarinya telah berubah secara signifikan dalam citra OS Raspberry Pi secara keseluruhan, dan, bagi pengguna akhir, perubahan ini sebagian besar tidak terlihat. Subsistem suara asli yang digunakan adalah ALSA. Pulse Audio menggantikan ALSA, sebelum digantikan oleh sistem yang ada saat ini, yang disebut Pipe Wire. Sistem ini memiliki fungsionalitas yang sama dengan Pulse Audio, dan API yang kompatibel, tetapi juga memiliki ekstensi untuk menangani video dan fitur lainnya, sehingga integrasi video dan audio menjadi jauh lebih mudah. Karena Pipe Wire menggunakan API yang sama dengan Pulse Audio, utilitas Pulse Audio berfungsi dengan baik pada sistem Pipe Wire.
Utilitas ini digunakan dalam examples di bawah ini.
Untuk menjaga ukuran gambar tetap rendah, Raspberry Pi OS Lite tetap menggunakan ALSA untuk menyediakan dukungan audio dan tidak menyertakan pustaka audio Pipe Wire, Pulse Audio, atau Bluetooth. Namun, Anda dapat menginstal pustaka yang sesuai untuk menambahkan fitur-fitur tersebut sesuai kebutuhan, dan prosesnya juga dijelaskan di bawah ini.
Meja kerja
Seperti yang telah disebutkan sebelumnya, pengoperasian audio ditangani melalui ikon speaker di bilah tugas desktop. Klik kiri ikon tersebut akan menampilkan slider volume dan tombol mute, sementara klik kanan akan menampilkan daftar perangkat audio yang tersedia. Cukup klik perangkat audio yang ingin Anda gunakan. Terdapat juga opsi, melalui klik kanan, untuk mengubah pengaturan pro.fileyang digunakan oleh setiap perangkat. Inifilebiasanya menyediakan tingkat kualitas yang berbeda.
Jika dukungan mikrofon diaktifkan, ikon mikrofon akan muncul pada menu; klik kanan pada ikon ini akan memunculkan pilihan menu khusus mikrofon, seperti pemilihan perangkat input, sedangkan klik kiri akan memunculkan pengaturan level input.
Bahasa Indonesia: Bluetooth
Untuk memasangkan perangkat Bluetooth, klik kiri ikon Bluetooth di bilah tugas, lalu pilih 'Tambah Perangkat'. Sistem akan mulai mencari perangkat yang tersedia, yang perlu dialihkan ke mode 'Temukan' agar dapat dilihat. Klik perangkat tersebut ketika muncul di daftar, dan perangkat akan terpasang. Setelah terpasang, perangkat audio akan muncul di menu, yang dapat dipilih dengan mengeklik ikon speaker di bilah tugas.
Baris perintah
Karena Pipe Wire menggunakan API yang sama dengan Pulse Audio, mayoritas perintah Pulse Audio yang digunakan untuk mengontrol audio berfungsi pada Pipe Wire. pacts adalah cara standar untuk mengontrol Pulse Audio: ketik man pactl ke dalam baris perintah untuk detail lebih lanjut.
Prasyarat untuk Raspberry Pi OS Lite
Pada instalasi penuh Raspberry Pi OS, semua aplikasi dan pustaka baris perintah yang diperlukan sudah terpasang. Namun, pada versi Lite, Pipe Wire tidak terpasang secara default dan harus dipasang secara manual agar dapat memutar suara.
Untuk menginstal pustaka yang diperlukan untuk Pipe Wire pada Raspberry Pi OS Lite, silakan masukkan yang berikut: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Jika Anda bermaksud menjalankan aplikasi yang menggunakan ALSA, Anda juga perlu menginstal yang berikut: sudo apt install pipewire-alsa
Memulai ulang setelah instalasi adalah cara termudah untuk menyiapkan dan menjalankan semuanya.
Pemutaran audio exampsedikit
Menampilkan daftar modul audio Pulse yang terpasang dalam bentuk singkat (bentuk panjang berisi banyak informasi dan sulit dibaca): $ pactl list modules short Menampilkan daftar sink Pulse Audio dalam bentuk singkat:
$ pactl list gagal
Pada Raspberry Pi 5 yang terhubung ke monitor HDMI dengan audio internal dan kartu suara USB tambahan, perintah ini memberikan output berikut: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pipa Kawat s32le 2ch 48000Hz DIGANTUNG 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Pipa Kawat s16le 2ch 48000Hz DIGANTUNG
CATATAN
Raspberry Pi 5 tidak memiliki keluaran analog.
Untuk instalasi Raspberry Pi OS Lite pada Raspberry Pi 4 — yang memiliki HDMI dan keluaran analog — berikut ini dikembalikan: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pipa Kawat s16le 2ch 48000Hz DITANGGUHKAN
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pipa Kawat s32le 2ch 48000Hz DITANGGUHKAN
Untuk menampilkan dan mengubah sink default ke audio HDMI (perlu diketahui bahwa itu mungkin sudah menjadi default) pada instalasi Raspberry Pi OS Lite ini, ketik:
$ pactl dapatkan-wastafel-default
alsa_output.platform-bcm2835_audio.stereo-fallback
$ pactl set-default-sink 70
$ pactl dapatkan-wastafel-default
alsa_output.platform-107c701400.hdmi.hdmi-stereo
Untuk memutar ulang sebagaiample, pertama perlu diunggah ke sample cache, dalam hal ini di sink default. Anda dapat mengubah sink dengan menambahkan namanya di akhir perintah pactl play-sampperintah le:
$ pactl upload-sampituample.mp3 sampnama kecil
$ pactl play-sampituampnama kecil
Ada perintah Pulse Audio yang bahkan lebih mudah digunakan untuk memutar audio:
$ paplay sample.mp3
pactl memiliki opsi untuk mengatur volume pemutaran. Karena desktop menggunakan utilitas Pulse Audio untuk mendapatkan dan mengatur informasi audio, eksekusi perubahan baris perintah ini juga akan tercermin pada penggeser volume di desktop.
Mantan iniample mengurangi volume sebesar 10%:
$ pactl set-sink-volume @DEFAULT_SINK@ -10%
Mantan iniample mengatur volume ke 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
Ada banyak sekali perintah Pulse Audio yang tidak disebutkan di sini. Pulse Audio weblokasi (https://www.freedesktop.org/wiki/Software/PulseAudio/) dan halaman manual untuk setiap perintah menawarkan informasi lengkap tentang sistem.
Bahasa Indonesia: Bluetooth
Mengontrol Bluetooth dari baris perintah bisa menjadi proses yang rumit. Saat menggunakan Raspberry Pi OS Lite, perintah yang sesuai sudah terpasang. Perintah yang paling berguna adalah bluetoothctl, dan beberapa contohnyaampContoh penggunaannya disediakan di bawah ini.
Jadikan perangkat dapat ditemukan oleh perangkat lain:
$ bluetoothctl dapat ditemukan di
Jadikan perangkat dapat dipasangkan dengan perangkat lain:
$ bluetoothctl dapat dipasangkan aktif
Pindai perangkat Bluetooth dalam jangkauan:
$ bluetoothctl memindai aktif
Matikan pemindaian:
$ bluetoothctl scan off bluetoothctl juga memiliki mode interaktif, yang dipanggil dengan menggunakan perintah tanpa parameter. Contoh berikutample menjalankan mode interaktif, di mana perintah daftar dimasukkan dan hasilnya ditampilkan, pada Raspberry Pi 4 yang menjalankan Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Agen terdaftar
[bluetooth]# daftar
Pengontrol D8:3A:DD:3B:00:00 Pi4Lite [default] [bluetooth]#
Anda sekarang dapat mengetikkan perintah ke dalam interpreter dan perintah tersebut akan dieksekusi. Proses umum untuk memasangkan dan menghubungkan ke suatu perangkat dapat berupa: $ bluetoothctl
Agen mendaftarkan [bluetooth]# dapat ditemukan di
Mengubah dapat ditemukan menjadi berhasil
[CHG] Pengontrol D8:3A:DD:3B:00:00 Dapat ditemukan di [bluetooth]# dapat dipasangkan di
Mengubah yang dapat dipasangkan menjadi berhasil
[CHG] Pengontrol D8:3A:DD:3B:00:00 Dapat dipasangkan pada [bluetooth]# pemindaian aktif
< bisa jadi merupakan daftar panjang perangkat di sekitar >
[bluetooth]# pair [alamat mac perangkat, dari perintah pemindaian atau dari perangkat itu sendiri, dalam bentuk xx:xx:xx:xx:xx:xx] [bluetooth]# pemindaian mati
[bluetooth]# connect [alamat mac yang sama] Perangkat Bluetooth sekarang akan muncul di daftar sink, seperti yang ditunjukkan pada contoh iniample dari instalasi Raspberry Pi OS Lite:
$ pactl list gagal
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pipa Kawat s16le 2ch 48000Hz DITANGGUHKAN
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pipa Kawat s32le 2ch 48000Hz DITANGGUHKAN
71 bluez_output.CA_3A_B2_CA_7C_55.1 Pipa Kawat s32le 2ch 48000Hz DITANGGUHKAN
$ pactl set-default-sink 71
$ paplayample_audio_file>
Sekarang Anda dapat menjadikannya default dan memutar audio di dalamnya.
Kesimpulan
Terdapat sejumlah cara berbeda untuk menghasilkan keluaran audio dari perangkat Raspberry Pi Ltd, yang memenuhi sebagian besar kebutuhan pengguna. Dokumen ini telah menguraikan mekanisme tersebut dan memberikan informasi tentang banyak di antaranya. Diharapkan saran yang disajikan di sini akan membantu pengguna akhir memilih skema keluaran audio yang tepat untuk proyek mereka. Contoh sederhanaampPanduan tentang cara menggunakan sistem audio telah disediakan, tetapi pembaca harus merujuk pada manual dan halaman manual untuk perintah audio dan Bluetooth untuk detail lebih lanjut.
Raspberry Pi adalah merek dagang dari Raspberry Pi Ltd
Raspberry Pi Ltd
Dokumen / Sumber Daya
 |
Komputer Papan Tunggal Raspberry Pi SBCS [Bahasa Indonesia:] Panduan Pengguna Komputer Papan Tunggal SBCS, SBCS, Komputer Papan Tunggal, Komputer Papan, Komputer |