Usa ka Whitepaper nga Paghatag a
Taas nga lebelview sa Audio
Mga kapilian sa Raspberry Pi SBCs
Raspberry Pi Ltd

Kolophon

© 2022-2025 Raspberry Pi Ltd
Kini nga dokumentasyon kay lisensyado ubos sa Creative Commons Attribution-No Derivatives 4.0 International (CC BY-ND).
Bersyon 1.0
Petsa sa pagtukod: 28/05/2025

Legal nga pahibalo sa disclaimer

TEKNIKAL UG KASALIG NGA DATA PARA SA MGA PRODUKTO SA RASPBERRY PI (KASULOD SA MGA DATASHEETS) AS NGA GIusab GIKAN SA PANAHON SA PANAHON (“RESOURCES”) GIHATAG SA RASPBERRY PI LTD (“RPL”) “AS IS” UG BISAN UNSANG GIPASABOT O GIPAHIBALO NGA WARRANTY, DILI LIMITADO, SA, ANG GIPAHIBALO NGA MGA WARRANTY SA KALIGTASAN UG KAAYOHAN ALANG SA PARTIKULAR NGA KATUYOAN GISAYAG. HANGTOD SA LABING KASABOT NGA GITUGOT SA MAHIMONG BALAOD SA WALAY HITABO NGA ANG RPL MAHIMONG TUBAG ALANG SA BISAN UNSANG DIREKTO, INDIREKTO, INSIDENTAL, ESPESYAL, EKSEMPLARY, O HINUNGDANONG MGA KADOT (API, APAN DILI LIMITADO SA, PAGPANGHILI SA SUBSTITUTE NGA MGA SERBISYO, DILI LIMITADO; , O GANTOS; O BUSINESS INTERRUPTION) BISAN UNSAY HINUNGDAN UG SA BISAN UNSANG TEORYA SA LIABILIDAD, BISAN SA KONTRATA, ESTRIKTO NGA LIABILIDAD, O TORT (KASULOD ANG PAGPASAYD O UBAN PA) NGA NAGTUBO SA BISAN UNSANG PAAGI GAWAS SA PAGGAMIT SA MGA RESOURCES, SA MAONG KAdaut.
Ang RPL adunay katungod sa paghimo sa bisan unsang mga pagpauswag, pagpaayo, pagkorihir o bisan unsang uban pang mga pagbag-o sa mga RESOURCES o bisan unsang mga produkto nga gihulagway niini bisan unsang oras ug wala’y dugang nga pahibalo.
Ang mga RESOURCES gituyo alang sa mga hanas nga tiggamit nga adunay angay nga lebel sa kahibalo sa disenyo. Ang mga tiggamit mao lamang ang responsable sa ilang pagpili ug paggamit sa mga RESOURCES ug bisan unsang aplikasyon sa mga produkto nga gihulagway niini. Miuyon ang Gumagamit nga bayran ug huptan nga dili makadaot ang RPL batok sa tanan nga mga utang, gasto, kadaot o uban pang mga kapildihan nga naggikan sa ilang paggamit sa MGA RESOURCES. Gihatagan sa RPL ang mga tiggamit og pagtugot nga gamiton ang RESOURCES dungan sa mga produkto sa Raspberry Pi. Gidili ang tanang ubang paggamit sa RESOURCES. Wala’y lisensya nga gihatag sa bisan unsang ubang RPL o uban pang ikatulo nga partido nga katungod sa intelektwal nga kabtangan.
HIGH RISK NGA KALIHOKAN. Ang mga produkto sa Raspberry Pi wala gidesinyo, gigama o gituyo alang sa paggamit sa mga peligrosong palibot nga nanginahanglan og mapakyas nga luwas nga performance, sama sa operasyon sa mga pasilidad sa nukleyar, nabigasyon sa ayroplano o mga sistema sa komunikasyon, kontrol sa trapiko sa kahanginan, mga sistema sa armas o mga aplikasyon nga kritikal sa kaluwasan (lakip ang mga sistema sa pagsuporta sa kinabuhi ug uban pang mga medikal nga aparato), diin ang pagkapakyas sa mga produkto mahimong direktang mosangpot sa kamatayon, personal nga kadaot o grabe nga kadaot sa pisikal o kinaiyahan ("Taas nga kadaot sa kinaiyahan"). Ang RPL espesipikong nagsalikway sa bisan unsang dayag o gipasabot nga garantiya sa kaangayan alang sa Taas nga Risk nga Kalihokan ug wala modawat og tulubagon sa paggamit o paglakip sa mga produkto sa Raspberry Pi sa Taas nga Risk nga Kalihokan. Ang mga produkto sa Raspberry Pi gihatag ubos sa RPL's Standard nga Termino. Ang probisyon sa RPL sa RESOURCES dili mopalapad o mag-usab sa RPL's Standard nga Termino lakip apan dili limitado sa mga disclaimer ug mga garantiya nga gipahayag niini.

Kasaysayan sa bersyon sa dokumento

Sakop sa dokumento
Kini nga dokumento magamit sa mosunod nga mga produkto sa Raspberry Pi:

Pasiuna

Sulod sa mga katuigan, ang mga opsyon nga anaa alang sa audio output sa Raspberry Pi SBCs (single-board computers) nahimong mas daghan, ug ang paagi nga sila giabog gikan sa software nausab.
Kini nga dokumento moagi sa daghang mga magamit nga kapilian alang sa audio output sa imong Raspberry Pi nga aparato ug maghatag mga panudlo kung giunsa ang paggamit sa mga kapilian sa audio gikan sa desktop ug linya sa mando.
Kini nga whitepaper nagtuo nga ang Raspberry Pi device nagpadagan sa Raspberry Pi OS ug bug-os nga napapanahon sa pinakabag-o nga firmware ug kernels.

Raspberry Pi audio hardware

HDMI
Ang tanan nga Raspberry Pi SBC adunay usa ka konektor sa HDMI nga nagsuporta sa audio sa HDMI. Ang pagkonektar sa imong Raspberry Pi SBC sa usa ka monitor o telebisyon nga adunay mga mamumulong awtomatik nga makahimo sa HDMI audio output pinaagi sa mga mamumulong. Ang HDMI audio usa ka taas nga kalidad nga digital signal, mao nga ang mga resulta mahimong maayo kaayo, ug ang multichannel audio sama sa DTS gisuportahan.
Kung naggamit ka ug HDMI video apan gusto nimo nga mabulag ang signal sa audio - alang sa example, sa usa amplifier nga wala nagsuporta sa input sa HDMI - nan kinahanglan nimo nga mogamit usa ka dugang nga piraso sa hardware nga gitawag nga splitter aron makuha ang audio signal gikan sa signal sa HDMI. Mahimong mahal kini, apan adunay ubang mga kapilian, ug kini gihulagway sa ubos.
Analogue PCM/3.5mm jack
Ang Raspberry Pi nga mga modelo B+, 2, 3, ug 4 adunay 4-pole 3.5 mm audio jack nga makasuporta sa audio ug composite video signal. Kini usa ka ubos nga kalidad nga analogue output nga namugna gikan sa usa ka signal sa PCM (pulse-code modulation), apan kini angayan gihapon alang sa mga headphone ug desktop speaker.
NOTA
Walay analogue audio output sa Raspberry Pi 5.
Ang mga signal sa jack plug gihubit sa mosunod nga lamesa, sugod sa tumoy sa kable ug matapos sa tumoy. Anaa ang mga kable nga adunay lainlaing mga buluhaton, busa siguruha nga naa nimo ang husto.

I2S-based nga adapter boards
Ang tanang modelo sa Raspberry Pi SBCs adunay I2S peripheral nga anaa sa GPIO header. Ang I2S usa ka electrical serial bus interface standard nga gigamit sa pagkonektar sa digital audio device ug pagkomunikar sa PCM audio data tali sa mga peripheral sa usa ka electronic device. Ang Raspberry Pi Ltd naggama og usa ka lain-laing mga audio board nga nagkonektar sa GPIO header ug naggamit sa I2S interface aron ibalhin ang audio data gikan sa SoC (system on a chip) ngadto sa add-on board.
Mubo nga sulat: Ang mga add-on nga tabla nga nagkonektar pinaagi sa header sa GPIO ug nagsunod sa angay nga mga espesipikasyon nailhan nga HATs (Hardware Attached on Top). Ang ilang mga detalye makita dinhi: https://datasheets.raspberrypi.com/
Ang bug-os nga han-ay sa audio HATs makita sa Raspberry Pi Ltd website: https://www.raspberrypi.com/products/
Adunay usab daghang gidaghanon sa mga third-party nga HAT nga magamit alang sa audio output, alang sa example gikan sa Pimoroni, HiFiBerry, Adafruit, ug uban pa, ug kini naghatag og daghang lain-laing mga bahin.
USB audio
Kung dili posible ang pag-instalar sa usa ka HAT, o nangita ka usa ka dali ug dali nga paagi sa pag-attach sa usa ka jack plug alang sa usa ka headphone output o usa ka input sa mikropono, nan ang usa ka USB audio adapter usa ka maayong kapilian. Kini mga yano, barato nga mga aparato nga nag-plug sa usa sa mga USB-A port sa Raspberry Pi SBC.
Ang Raspberry Pi OS naglakip sa mga drayber alang sa USB audio pinaagi sa default; sa diha nga ang usa ka device gisaksak, kini kinahanglan nga makita sa device menu nga makita sa diha nga ang speaker icon sa taskbar mao ang right-click.
Ang sistema usab awtomatik nga makamatikod kon ang gilakip nga USB device adunay input sa mikropono ug makapahimo sa tukma nga suporta.
Bluetooth
Ang Bluetooth audio nagtumong sa wireless transmission sa sound data pinaagi sa Bluetooth nga teknolohiya, nga kaylap kaayo nga gigamit. Gitugotan niini ang Raspberry Pi SBC nga makigsulti sa mga Bluetooth speaker ug headphone/earbuds, o bisan unsang ubang audio device nga adunay suporta sa Bluetooth. Ang gitas-on medyo mubo - mga 10 m ang labing kataas.
Ang mga Bluetooth device kinahanglan nga 'ipares' sa Raspberry Pi SBC ug makita sa mga setting sa audio sa desktop kung mahuman na kini. Gi-install ang Bluetooth pinaagi sa default sa Raspberry Pi OS, nga ang logo sa Bluetooth makita sa desktop taskbar sa bisan unsang mga aparato nga adunay Bluetooth hardware nga na-install (mahimo nga gitukod sa o pinaagi sa Bluetooth USB dongle). Kung ang Bluetooth mahimo, ang icon mahimong asul; kung kini ma-disable, ang icon mahimong abuhon.

Suporta sa software

Ang nagpahiping software sa suporta sa audio nausab pag-ayo sa tibuuk nga imahe sa Raspberry Pi OS, ug, alang sa katapusan nga tiggamit, kini nga mga pagbag-o kasagaran nga transparent. Ang orihinal nga sound subsystem nga gigamit mao ang ALSA. Ang Pulse Audio mipuli sa ALSA, sa wala pa gipulihan sa kasamtangan nga sistema, nga gitawag nga Pipe Wire. Kini nga sistema adunay parehas nga pagpaandar sama sa Pulse Audio, ug usa ka katugbang nga API, apan kini usab adunay mga extension sa pagdumala sa video ug uban pang mga bahin, nga naghimo sa panagsama sa video ug audio nga labi ka dali. Tungod kay ang Pipe Wire naggamit sa parehas nga API sama sa Pulse Audio, ang mga gamit sa Pulse Audio nagtrabaho nga maayo sa usa ka sistema sa Pipe Wire.
Kini nga mga utilities gigamit sa exampubos.
Aron maminusan ang gidak-on sa imahe, gigamit gihapon sa Raspberry Pi OS Lite ang ALSA aron maghatag suporta sa audio ug wala’y apil nga mga librarya sa Pipe Wire, Pulse Audio, o Bluetooth audio. Bisan pa, posible nga i-install ang angay nga mga librarya aron idugang ang mga bahin kung gikinahanglan, ug kini nga proseso gihulagway usab sa ubos.
Desktop
Sama sa gihisgutan sa ibabaw, ang mga operasyon sa audio gidumala pinaagi sa icon sa speaker sa desktop taskbar. Ang wala nga pag-klik sa icon nagdala sa volume slider ug mute nga buton, samtang ang pag-right-click nagdala sa usa ka lista sa mga magamit nga audio device. Pag-klik lang sa audio device nga gusto nimong gamiton. Adunay usab usa ka kapilian, pinaagi sa pag-right-click, aron mabag-o ang profiles gigamit sa matag device. Kini nga mga profiles kasagaran naghatag lain-laing mga lebel sa kalidad.
Kung ang suporta sa mikropono gipagana, usa ka icon sa mikropono ang makita sa menu; Ang pag-klik sa tuo niini magdala sa mga kapilian sa menu nga piho sa mikropono, sama sa pagpili sa aparato sa pag-input, samtang ang pag-klik sa wala magdala sa mga setting sa lebel sa input.
Bluetooth
Aron ipares ang Bluetooth device, pag-left-click sa Bluetooth icon sa taskbar, dayon pilia ang 'Add Device'. Ang sistema unya magsugod sa pagpangita alang sa magamit nga mga aparato, nga kinahanglan ibutang sa 'Discover' mode aron makita. Pag-klik sa aparato kung kini makita sa lista ug ang mga aparato kinahanglan nga ipares. Kung gipares, ang audio device makita sa menu, nga gipili pinaagi sa pag-klik sa speaker icon sa taskbar.
Linya sa sugo
Tungod kay ang Pipe Wire naggamit sa parehas nga API sama sa Pulse Audio, ang kadaghanan sa mga Pulse Audio nga mga mando nga gigamit aron makontrol ang audio nga trabaho sa Pipe Wire. pacts mao ang standard nga paagi sa pagkontrolar sa Pulse Audio: type man pactl sa command line para sa dugang detalye.
Mga kinahanglanon alang sa Raspberry Pi OS Lite
Sa bug-os nga pag-install sa Raspberry Pi OS, ang tanan nga gikinahanglan nga mga aplikasyon sa command line ug mga librarya na-install na. Sa Lite nga bersyon, bisan pa, ang Pipe Wire wala ma-install pinaagi sa default ug kinahanglan nga mano-mano nga i-install aron makadula sa tunog.
Aron ma-install ang gikinahanglan nga mga librarya para sa Pipe Wire sa Raspberry Pi OS Lite, palihog i-input ang mosunod: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Kung tuyo nimo ang pagpadagan sa mga aplikasyon nga naggamit sa ALSA, kinahanglan nimo nga i-install ang mosunod: sudo apt install pipewire-alsa
Ang pag-reboot pagkahuman sa pag-install mao ang labing kadali nga paagi aron mapadayon ang tanan.
Audio playback examples
Ipakita ang usa ka lista sa na-install nga Pulse audio modules sa mubo nga porma (ang taas nga porma adunay daghang impormasyon ug lisud basahon): $ pactl list modules mubo Ipakita ang usa ka lista sa Pulse Audio sinks sa mubo nga porma:
Ang listahan sa $ pactl mubu
Sa Raspberry Pi 5 nga konektado sa usa ka HDMI monitor nga adunay built-in nga audio ug usa ka dugang nga USB sound card, kini nga sugo naghatag sa mosunod nga output: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pipe Wire s32le 2ch 48000Hz SUSPENDED 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_00 Wire-Wire Output s16le 2ch 48000Hz GISUSPENSO
NOTA
Ang Raspberry Pi 5 walay analogue.
Alang sa usa ka Raspberry Pi OS Lite nga pag-install sa usa ka Raspberry Pi 4 - nga adunay HDMI ug analogue out - ang mosunod gibalik: $ pactl list nalunod
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pipe Wire s16le 2ch 48000Hz GISUSPENSO
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pipe Wire s32le 2ch 48000Hz SUSPENDED
Aron ipakita ug usbon ang default nga lababo sa HDMI audio (namatikdan nga mahimo na kini nga default) sa kini nga pag-install sa Raspberry Pi OS Lite, i-type ang:
$ 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
Sa pagdula balik isipample, kinahanglan una kini i-upload sa sample cache, sa niini nga kaso sa default lababo. Mahimo nimong usbon ang lababo pinaagi sa pagdugang sa ngalan niini sa katapusan sa pactl play-sampang sugo:
$ pactl upload-sampangample.mp3 samplename
$ pactl play-sampangamplename
Adunay usa ka Pulse Audio nga sugo nga mas sayon ​​​​gamiton sa pagdula og balik sa audio:
$ paplay sample.mp3
Ang pactl adunay kapilian sa pagtakda sa volume alang sa playback. Tungod kay ang desktop naggamit sa Pulse Audio utilities sa pagkuha ug pagtakda sa audio nga impormasyon, ang pagpatuman niini nga mga kausaban sa command line makita usab sa volume slider sa desktop.
Kini nga exampAng pagkunhod sa gidaghanon sa 10%:
$ pactl set-sink-volume @DEFAULT_SINK@ -10%
Kini nga exampGitakda ang volume sa 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
Adunay daghan, daghang mga Pulse Audio nga mga sugo nga wala hisgoti dinhi. Ang Pulse Audio weblugar (https://www.freedesktop.org/wiki/Software/PulseAudio/) ug ang mga panid sa tawo alang sa matag sugo nagtanyag ug daghang impormasyon bahin sa sistema.
Bluetooth
Ang pagpugong sa Bluetooth gikan sa command line mahimong usa ka komplikado nga proseso. Kung gigamit ang Raspberry Pi OS Lite, ang angay nga mga mando na-install na. Ang labing mapuslanon nga sugo mao ang bluetoothctl, ug ang uban exampang gamay niini nga gigamit gihatag sa ubos.
Himua nga makit-an ang aparato sa ubang mga aparato:
$ bluetoothctl madiskobrehan sa
Himoa ang device nga ipares sa ubang mga device:
$ bluetoothctl ipares sa
Pag-scan alang sa mga aparato nga Bluetooth sa sakup:
$ bluetoothctl scan on
I-off ang pag-scan:
Ang $ bluetoothctl scan off bluetoothctl aduna usab usa ka interactive mode, nga gigamit pinaagi sa paggamit sa command nga walay mga parameter. Ang mosunod nga exampGipadagan ang interactive mode, diin gisulod ang list command ug gipakita ang mga resulta, sa Raspberry Pi 4 nga nagpadagan sa Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Rehistrado nga ahente
[bluetooth]# listahan
Controller D8:3A:DD:3B:00:00 Pi4Lite [default] [bluetooth]#
Mahimo nimong i-type ang mga sugo sa tighubad ug kini ipatuman. Usa ka kasagarang proseso alang sa pagpares sa, ug dayon pagkonektar sa, usa ka himan mahimong mabasa sama sa mosunod: $ bluetoothctl
Rehistrado nga ahente [bluetooth]# madiskobrehan sa
Ang pagbag-o nga makit-an sa milampos
[CHG] Controller D8:3A:DD:3B:00:00 Madiskubre sa [bluetooth]# ipares sa
Nagmalampuson ang pag-ilis sa pairable
[CHG] Controller D8:3A:DD:3B:00:00 Pairable sa [bluetooth]# scan on
< mahimo nga usa ka taas nga lista sa mga aparato sa palibot >
[bluetooth]# pares [mac address sa device, gikan sa scan command o gikan mismo sa device, sa porma xx:xx:xx:xx:xx:xx] [bluetooth]# scan off
[bluetooth]# sumpay [parehas nga adres sa mac] Ang aparato nga Bluetooth kinahanglan nga makita na karon sa lista sa mga lababo, sama sa gipakita sa kini nga exampgikan sa pag-instalar sa Raspberry Pi OS Lite:
Ang listahan sa $ pactl mubu
69 alsa_output.platform-bcm2835_audio.stereo-fallback Pipe Wire s16le 2ch 48000Hz GISUSPENSO
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Pipe Wire s32le 2ch 48000Hz SUSPENDED
71 bluez_output.CA_3A_B2_CA_7C_55.1 Pipe Wire s32le 2ch 48000Hz GISUSPENSO
$ pactl set-default-sink 71
$ paplayample_audio_file>
Mahimo na nimo kini nga default ug i-play balik ang audio niini.
Mga konklusyon
Adunay ubay-ubay nga lainlain nga mga paagi aron makahimo usa ka audio output gikan sa mga aparato sa Raspberry Pi Ltd, nga nagsilbi sa kadaghanan sa mga kinahanglanon sa gumagamit. Kini nga whitepaper naglatid sa mga mekanismo ug naghatag impormasyon bahin sa kadaghanan niini. Gilauman nga ang tambag nga gipresentar dinhi makatabang sa katapusan nga tiggamit sa pagpili sa husto nga laraw sa output sa audio alang sa ilang proyekto. Simple nga exampGihatag ang gamay kung giunsa paggamit ang mga sistema sa audio, apan ang magbabasa kinahanglan nga mokonsulta sa mga manwal ug man page alang sa audio ug Bluetooth nga mga mando alang sa dugang nga detalye.

Ang Raspberry Pi usa ka marka sa Raspberry Pi Ltd
Raspberry Pi Ltd

Mga Dokumento / Mga Kapanguhaan

Raspberry Pi SBCS Single Board Computer [pdf] Giya sa Gumagamit SBCS Single Board Computer, SBCS, Single Board Computer, Board Computer, Computer

Mga pakisayran

• Manwal sa Gumagamit