Un document tècnic que dóna una
Alt nivell sobreview d'àudio
Opcions als SBC de Raspberry Pi
Raspberry Pi Ltd
Colofó
© 2022-2025 Raspberry Pi Ltd
Aquesta documentació està subjecta a una llicència Creative Commons Reconeixement-SenseObraDerivada 4.0 Internacional (CC BY-ND).
Versió 1.0
Data de construcció: 28/05/2025
Avís legal d'exempció de responsabilitat
LES DADES TÈCNIQUES I DE FIABILITAT DELS PRODUCTES RASPBERRY PI (INCLOSO LES FITXES DE DADES) MODIFICAT DE TANTA EN TEMPS ("RECURSOS") LES PROPORCIONEN PER RASPBERRY PI LTD ("RPL") "TAL CUAL" I QUALSEVOL GARANTIA EXPRESSA O IMPLÍCITA, INCLOSA, PERÒ NO LIMITADA. A, LES GARANTIES IMPLÍCITES DE COMERCIABILITAT I IDONEITAT PER A UN PROPÒSIT PARTICULAR ES RENUNCIAN. EN LA MESURA MÀXIMA PERMESA PER LA LLEI APLICABLE EN CAP CAS, RPL SERÀ RESPONSABLE DE CAP DANYS DIRECTS, INDIRECTS, INCIDENTALS, ESPECIALS, EXEMPLARS O CONSEQUENTLS (INCLOSOS, PERÒ NO LIMITAR-SE, LA ADQUISICIÓ DE BÉNS SUBSTITUTS, PÈRDUES DE DADES; , O BENEFICIS; O INTERRUPCIÓ DE NEGOCIS) SIGUI QUE ÉS CAUSADA I SOBRE QUALSEVOL TEORIA DE RESPONSABILITAT, JA SIGUI EN CONTRACTE, RESPONSABILITAT ESTRICTA O ALTRES (INCLOSA LA NEGLIGÈNCIA O ALTRE MANERA) SORRIJADA DE QUALSEVOL MANERA DE L'ÚS DE LA RESPONSABILITAT, D'AQUEST DANY.
RPL es reserva el dret de fer qualsevol millora, millora, correcció o qualsevol altra modificació als RECURSOS o als productes que s'hi descriuen en qualsevol moment i sense cap avís.
Els RECURSOS estan destinats a usuaris qualificats amb nivells adequats de coneixements de disseny. Els usuaris són els únics responsables de la seva selecció i ús dels RECURSOS i de qualsevol aplicació dels productes que s'hi descriuen. L'usuari accepta indemnitzar i eximir de responsabilitat RPL contra totes les responsabilitats, costos, danys o altres pèrdues derivades del seu ús dels RECURSOS. RPL concedeix als usuaris permís per utilitzar els RECURSOS únicament juntament amb els productes Raspberry Pi. Qualsevol altre ús dels RECURSOS està prohibit. No es concedeix cap llicència a cap altre dret de propietat intel·lectual de RPL o de tercers.
ACTIVITATS D'ALT RISC. Els productes Raspberry Pi no estan dissenyats, fabricats ni destinats a ser utilitzats en entorns perillosos que requereixin un rendiment a prova de fallades, com ara en el funcionament d'instal·lacions nuclears, sistemes de navegació o comunicació d'aeronaus, control de trànsit aeri, sistemes d'armes o aplicacions crítiques per a la seguretat (inclosos sistemes de suport vital i altres dispositius mèdics), en què la fallada dels productes podria provocar directament la mort, lesions personals o danys físics o ambientals greus ("Activitats d'alt risc"). RPL renuncia específicament a qualsevol garantia expressa o implícita d'idoneïtat per a Activitats d'alt risc i no accepta cap responsabilitat per l'ús o la inclusió de productes Raspberry Pi en Activitats d'alt risc. Els productes Raspberry Pi es proporcionen subjectes als termes i condicions de RPL. Termes estàndardLa provisió dels RECURSOS per part de RPL no amplia ni modifica de cap altra manera els drets de RPL. Termes estàndard incloent-hi, entre d'altres, les exempcions de responsabilitat i les garanties que s'hi expressen.
Historial de versions del document
| Alliberament | Data | Descripció |
| 1 | 1-Abr-25 | Alliberament inicial |
Àmbit del document
Aquest document s'aplica als següents productes 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 | Tots | Tots | Tots | Tots | Tots | Tots | Tots | Tots | Tots | Tots |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Introducció
Amb els anys, les opcions disponibles per a la sortida d'àudio als SBC (ordinadors d'una sola placa) de Raspberry Pi s'han tornat més nombroses, i la manera com es gestionen des del programari ha canviat.
Aquest document repassarà moltes de les opcions disponibles per a la sortida d'àudio al vostre dispositiu Raspberry Pi i proporcionarà instruccions sobre com utilitzar les opcions d'àudio des de l'escriptori i la línia d'ordres.
Aquest document tècnic assumeix que el dispositiu Raspberry Pi executa el sistema operatiu Raspberry Pi i està completament actualitzat amb el firmware i els nuclis més recents.
Maquinari d'àudio Raspberry Pi
HDMI
Tots els SBC de Raspberry Pi tenen un connector HDMI que admet àudio HDMI. Si connecteu el vostre Raspberry Pi SBC a un monitor o televisor amb altaveus, s'activarà automàticament la sortida d'àudio HDMI a través d'aquests altaveus. L'àudio HDMI és un senyal digital d'alta qualitat, de manera que els resultats poden ser molt bons, i l'àudio multicanal com el DTS és compatible.
Si feu servir vídeo HDMI però voleu que el senyal d'àudio es separi, per exempleample, a un ampun amplificador que no admet l'entrada HDMI, haureu d'utilitzar una peça de maquinari addicional anomenada divisor per extreure el senyal d'àudio del senyal HDMI. Això pot ser car, però hi ha altres opcions, que es descriuen a continuació.
PCM analògic/connector de 3.5 mm
Els models Raspberry Pi B+, 2, 3 i 4 disposen d'un connector d'àudio de 3.5 mm de 4 pols que admet senyals d'àudio i vídeo compost. Es tracta d'una sortida analògica de baixa qualitat generada a partir d'un senyal PCM (modulació per pols i codi), però encara és adequada per a auriculars i altaveus d'escriptori.
NOTA
La Raspberry Pi 5 no té sortida d'àudio analògica.
Els senyals del connector jack es defineixen a la taula següent, començant des de l'extrem del cable i acabant a la punta. Hi ha cables disponibles amb diferents assignacions, així que assegureu-vos de tenir la correcta.
| Segment de Jack | Senyal |
| màniga | Vídeo |
| Anell 2 | Terra |
| Anell 1 | D'acord |
| Consell | Esquerra |
Plaques adaptadores basades en I2S
Tots els models de SBC de Raspberry Pi tenen un perifèric I2S disponible a la capçalera GPIO. I2S és un estàndard d'interfície de bus sèrie elèctric que s'utilitza per connectar dispositius d'àudio digital i comunicar dades d'àudio PCM entre perifèrics d'un dispositiu electrònic. Raspberry Pi Ltd fabrica una gamma de plaques d'àudio que es connecten a la capçalera GPIO i utilitzen la interfície I2S per transferir dades d'àudio des del SoC (sistema en un xip) a la placa addicional.
Nota: Les plaques addicionals que es connecten a través de la capçalera GPIO i que compleixen les especificacions adequades es coneixen com a HAT (Hardware Attached on Top, o Hardware Attached on Top). Les seves especificacions es poden trobar aquí: https://datasheets.raspberrypi.com/
La gamma completa d'àudio HATs es pot veure a la Raspberry Pi Ltd. weblloc: https://www.raspberrypi.com/products/
També hi ha un gran nombre de HAT de tercers disponibles per a la sortida d'àudio, per exempleample de Pimoroni, HiFiBerry, Adafruit, etc., i aquests ofereixen una multitud de característiques diferents.
Àudio USB
Si no és possible instal·lar un HAT, o busqueu una manera ràpida i senzilla de connectar un connector jack per a una sortida d'auriculars o una entrada de micròfon, un adaptador d'àudio USB és una bona opció. Són dispositius senzills i econòmics que es connecten a un dels ports USB-A del Raspberry Pi SBC.
El sistema operatiu Raspberry Pi inclou controladors per a àudio USB per defecte; tan bon punt es connecta un dispositiu, hauria d'aparèixer al menú de dispositius que apareix quan es fa clic amb el botó dret a la icona de l'altaveu de la barra de tasques.
El sistema també detectarà automàticament si el dispositiu USB connectat té una entrada de micròfon i activarà la compatibilitat adequada.
Bluetooth
L'àudio Bluetooth fa referència a la transmissió sense fil de dades de so a través de la tecnologia Bluetooth, que s'utilitza molt àmpliament. Permet que el Raspberry Pi SBC es comuniqui amb altaveus i auriculars Bluetooth, o qualsevol altre dispositiu d'àudio compatible amb Bluetooth. L'abast és bastant curt: uns 10 m com a màxim.
Els dispositius Bluetooth s'han d'emparellar amb el SBC de la Raspberry Pi i apareixeran a la configuració d'àudio de l'escriptori un cop fet això. El Bluetooth s'instal·la per defecte al sistema operatiu Raspberry Pi, i el logotip de Bluetooth apareix a la barra de tasques de l'escriptori en qualsevol dispositiu que tingui maquinari Bluetooth instal·lat (ja sigui integrat o mitjançant un dongle USB Bluetooth). Quan el Bluetooth està habilitat, la icona serà blava; quan està desactivat, la icona serà grisa.
Suport de programari
El programari de suport d'àudio subjacent ha canviat considerablement en la imatge completa del sistema operatiu Raspberry Pi i, per a l'usuari final, aquests canvis són majoritàriament transparents. El subsistema de so original utilitzat era ALSA. Pulse Audio va succeir a ALSA, abans de ser substituït pel sistema actual, que s'anomena Pipe Wire. Aquest sistema té la mateixa funcionalitat que Pulse Audio i una API compatible, però també té extensions per gestionar vídeo i altres funcions, cosa que facilita molt la integració de vídeo i àudio. Com que Pipe Wire utilitza la mateixa API que Pulse Audio, les utilitats de Pulse Audio funcionen correctament en un sistema Pipe Wire.
Aquestes utilitats s'utilitzen en l'examples més avall.
Per mantenir la mida de la imatge baixa, Raspberry Pi OS Lite encara utilitza ALSA per proporcionar compatibilitat amb àudio i no inclou cap biblioteca d'àudio Pipe Wire, Pulse Audio o Bluetooth. Tanmateix, és possible instal·lar les biblioteques adequades per afegir aquestes funcions segons calgui, i aquest procés també es descriu a continuació.
Escriptori
Com s'ha esmentat anteriorment, les operacions d'àudio es gestionen mitjançant la icona de l'altaveu a la barra de tasques de l'escriptori. Si feu clic amb el botó esquerre a la icona, apareixerà el control lliscant de volum i el botó de silenci, mentre que si feu clic amb el botó dret, apareixerà una llista dels dispositius d'àudio disponibles. Simplement feu clic al dispositiu d'àudio que voleu utilitzar. També hi ha una opció, fent clic amb el botó dret, per canviar el pro.files utilitzat per cada dispositiu. Aquests profilesolen proporcionar diferents nivells de qualitat.
Si la compatibilitat amb el micròfon està habilitada, apareixerà una icona de micròfon al menú; si feu clic amb el botó dret, s'obriran les opcions de menú específiques del micròfon, com ara la selecció del dispositiu d'entrada, mentre que si feu clic amb el botó esquerre, s'obrirà la configuració del nivell d'entrada.
Bluetooth
Per emparellar un dispositiu Bluetooth, feu clic amb el botó esquerre a la icona de Bluetooth a la barra de tasques i seleccioneu "Afegeix dispositiu". El sistema començarà a buscar dispositius disponibles, que caldrà posar en mode "Descobrir" per ser vistos. Feu clic al dispositiu quan aparegui a la llista i els dispositius s'haurien d'emparellar. Un cop emparellat, el dispositiu d'àudio apareixerà al menú, que es selecciona fent clic a la icona de l'altaveu a la barra de tasques.
Línia d'ordres
Com que Pipe Wire utilitza la mateixa API que Pulse Audio, la majoria de les ordres de Pulse Audio que s'utilitzen per controlar l'àudio funcionen a Pipe Wire. pacts és la manera estàndard de controlar Pulse Audio: escriviu man pactl a la línia d'ordres per obtenir més detalls.
Requisits previs per a Raspberry Pi OS Lite
En una instal·lació completa de Raspberry Pi OS, totes les aplicacions i biblioteques de línia d'ordres necessàries ja estan instal·lades. A la versió Lite, però, Pipe Wire no s'instal·la per defecte i s'ha d'instal·lar manualment per poder reproduir so.
Per instal·lar les biblioteques necessàries per a Pipe Wire a Raspberry Pi OS Lite, introduïu el següent: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Si teniu previst executar aplicacions que utilitzen ALSA, també haureu d'instal·lar el següent: sudo apt install pipewire-alsa
Reiniciar després de la instal·lació és la manera més fàcil de posar-ho tot en funcionament.
Reproducció d'àudio examples
Mostra una llista dels mòduls d'àudio Pulse instal·lats en forma abreujada (la forma llarga conté molta informació i és difícil de llegir): $ pactl list modules short Mostra una llista dels dissipadors d'àudio Pulse en forma abreujada:
La llista $ pactl s'enfonsa curta
En una Raspberry Pi 5 connectada a un monitor HDMI amb àudio integrat i una targeta de so USB addicional, aquesta ordre dóna la sortida següent: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Cable de tub s32le 2 canals 48000 Hz SUSPENS 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Cable de tub s16le 2 canals 48000 Hz SUSPENS
NOTA
La Raspberry Pi 5 no té sortida analògica.
Per a una instal·lació de Raspberry Pi OS Lite en una Raspberry Pi 4 (que té sortida HDMI i analògica), es retorna el següent: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Cable de canonada s16le 2 canals 48000 Hz SUSPÈS
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Cable de canonada s32le 2 canals 48000 Hz SUSPÈS
Per mostrar i canviar el sumidero per defecte a àudio HDMI (tingueu en compte que potser ja és el valor per defecte) en aquesta instal·lació de Raspberry Pi OS Lite, escriviu:
$ 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
Per reproduir com aampés a dir, primer s'ha de pujar a la sampla memòria cau, en aquest cas al pica per defecte. Podeu canviar el pica afegint el seu nom al final del pactl play-sampl'ordre:
$ pactl upload-sampel sample.mp3 sampnom
$ pactl play-sampel sampnom
Hi ha una ordre Pulse Audio que és encara més fàcil d'utilitzar per reproduir àudio:
$ paplay sample.mp3
pactl té una opció per definir el volum de la reproducció. Com que l'escriptori utilitza les utilitats Pulse Audio per obtenir i definir la informació d'àudio, l'execució d'aquests canvis de la línia d'ordres també es reflectirà al control lliscant de volum de l'escriptori.
Aquest example redueix el volum en un 10%:
$ pactl estableix-volum-sink @DEFAULT_SINK@ -10%
Aquest exampestableix el volum al 50%:
$ pactl estableix-volum-descarregador @DEFAULT_SINK@ 50%
Hi ha moltes, moltes ordres de Pulse Audio que no s'esmenten aquí. Les ordres de Pulse Audio weblloc (https://www.freedesktop.org/wiki/Software/PulseAudio/) i les pàgines de manual de cada comanda ofereixen informació extensa sobre el sistema.
Bluetooth
Controlar el Bluetooth des de la línia d'ordres pot ser un procés complicat. Quan s'utilitza Raspberry Pi OS Lite, les ordres adequades ja estan instal·lades. L'ordre més útil és bluetoothctl, i alguns exemples...ampA continuació es proporcionen menys d'ell en ús.
Fes que el dispositiu sigui detectable per a altres dispositius:
$ bluetoothctl detectable activat
Feu que el dispositiu es pugui emparellar amb altres dispositius:
$ bluetoothctl emparellable activat
Cerca dispositius Bluetooth dins del rang:
Escaneig $ bluetoothctl activat
Desactiva l'escaneig:
$ bluetoothctl scan off bluetoothctl també té un mode interactiu, que s'invoca mitjançant l'ordre sense paràmetres. El següent exempleample executa el mode interactiu, on s'introdueix l'ordre list i es mostren els resultats, en una Raspberry Pi 4 amb Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Agent registrat
[bluetooth]# llista
Controlador D8:3A:DD:3B:00:00 Pi4Lite [per defecte] [bluetooth]#
Ara podeu escriure ordres a l'intèrpret i s'executaran. Un procés típic per emparellar-se i connectar-se a un dispositiu pot ser el següent: $ bluetoothctl
Agent registrat [bluetooth]# detectable a
S'ha canviat el detector correctament
[CHG] Controlador D8:3A:DD:3B:00:00 Descobrible amb [bluetooth]# emparellable amb
S'ha pogut canviar el emparellament
[CHG] Controlador D8:3A:DD:3B:00:00 Emparellable amb [bluetooth]# escaneig activat
<podria haver-hi una llarga llista de dispositius a la rodalia>
[bluetooth]# parell [adreça MAC del dispositiu, des de l'ordre d'escaneig o des del mateix dispositiu, en el format xx:xx:xx:xx:xx:xx] [bluetooth]# escaneig desactivat
[bluetooth]# connect [mateixa adreça mac] El dispositiu Bluetooth ara hauria d'aparèixer a la llista de receptors, tal com es mostra en aquest ex.ample d'una instal·lació de Raspberry Pi OS Lite:
La llista $ pactl s'enfonsa curta
69 alsa_output.platform-bcm2835_audio.stereo-fallback Cable de canonada s16le 2 canals 48000 Hz SUSPÈS
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Cable de canonada s32le 2 canals 48000 Hz SUSPÈS
71 bluez_output.CA_3A_B2_CA_7C_55.1 Cable de canonada s32le 2 canals 48000 Hz SUSPES
$ pactl set-default-sink 71
$ paplayample_audio_file>
Ara podeu establir que sigui el valor per defecte i reproduir-hi àudio.
Conclusions
Hi ha diverses maneres de produir una sortida d'àudio des de dispositius Raspberry Pi Ltd, que satisfan la gran majoria dels requisits dels usuaris. Aquest document tècnic ha descrit aquests mecanismes i ha proporcionat informació sobre molts d'ells. S'espera que els consells que es presenten aquí ajudin l'usuari final a triar l'esquema de sortida d'àudio adequat per al seu projecte. Exemple senzillampS'han proporcionat instruccions sobre com utilitzar els sistemes d'àudio, però el lector hauria de consultar els manuals i les pàgines de manual de les ordres d'àudio i Bluetooth per obtenir més detalls.
Raspberry Pi és una marca comercial de Raspberry Pi Ltd
Raspberry Pi Ltd
Documents/Recursos
 |
Ordinador de placa única Raspberry Pi SBCS [pdfGuia de l'usuari Ordinador de placa única SBCS, SBCS, Ordinador de placa única, Ordinador de placa, Ordinador |