Ordinador de placa única SBCS
“
Informació del producte
Especificacions:
- Models de Raspberry Pi compatibles: Pi 0, Pi 1, Pi 2, Pi 3, Pi 4,
CM1, CM3, CM4, CM5, Pico, Pico2 - Opcions de sortida d'àudio: HDMI, PCM analògic/jack de 3.5 mm, basat en I2S
plaques adaptadores, àudio USB, Bluetooth - Suport de programari: PulseAudio, PipeWire, ALSA
Instruccions d'ús del producte:
Sortida d'àudio HDMI:
Per a la sortida d'àudio HDMI, simplement connecteu el vostre Raspberry Pi a un
Monitor HDMI o televisor amb altaveus integrats.
PCM analògic/connector de 3.5 mm:
Els models Raspberry Pi B+, 2, 3 i 4 presenten un connector de 4 pols de 3.5 mm.
presa d'àudio per a la sortida d'àudio analògica. Seguiu l'assignació del senyal
taula per a connexions correctes.
Àudio USB i Bluetooth:
Per a la sortida d'àudio USB o Bluetooth, assegureu-vos que els controladors adequats estiguin disponibles.
instal·lat a la teva Raspberry Pi. Consulta el manual d'usuari per a
instruccions detallades de configuració.
Configuració del programari:
Per habilitar la reproducció d'àudio, instal·leu els paquets de programari necessaris
utilitzant la línia d'ordres. Reinicieu la vostra Raspberry Pi després de la instal·lació
perquè els canvis tinguin efecte.
Example Ordres:
sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils sudo apt install pipewire-alsa pactl list modules short pactl list sinks short
Preguntes freqüents:
P: Quins models de Raspberry Pi admeten àudio analògic?
sortida?
A: Els models B+, 2, 3 i 4 de Raspberry Pi presenten un connector de 4 pols de 3.5 mm.
presa d'àudio per a la sortida d'àudio analògica.
P: Puc utilitzar una targeta de so USB amb la meva Raspberry Pi?
R: Sí, podeu utilitzar una targeta de so USB amb la vostra Raspberry Pi per a
sortida d'àudio. Assegureu-vos que hi hagi els controladors adequats instal·lats.
"`
Raspberry Pi
Un document tècnic que ofereix una visió general d'alt nivellview d'opcions d'àudio a les SBC de Raspberry Pi
Raspberry Pi Ltd
Raspberry Pi Ltd
Un document tècnic que ofereix una visió general d'alt nivellview d'opcions d'àudio a les SBC de Raspberry Pi
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 compilació: 28/05/2025
Avís legal d'exempció de responsabilitat
LES DADES TÈCNIQUES I DE FIABILITAT DELS PRODUCTES RASPBERRY PI (INCLOSES LES FULLS DE DADES) QUE ES MODIFIQUEN PERIÒDICAMENT (“RECURSOS”) SÓN PROPORCIONADES PER RASPBERRY PI LTD (“RPL”) “TAL QUAL” I ES REBUTJA QUALSEVOL GARANTIA EXPLÍCITA O IMPLÍCITA, INCLOSES, ENTRE D'ALTRES, LES GARANTIES IMPLÍCITES DE COMERCIABILITAT I IDONEÏTAT PER A UN PROPÒSIT PARTICULAR. EN LA MESURA MÀXIMA PERMESA PER LA LLEI APLICABLE, EN CAP CAS RPL SERÀ RESPONSABLE DE CAP DANY DIRECTE, INDIRECTE, INCIDENTAL, ESPECIAL, EXEMPLAR O CONSEQÜENT (INCLOSOS, ENTRE D'ALTRES, L'ADQUISICIÓ DE BÉNS O SERVEIS SUBSTITUTS; PÈRDUA D'ÚS, DADES O BENEFICIS; O INTERRUPCIÓ DEL NEGOCI) INDEPENDENTMENT DE LA CAUSA I SEGUINT LES CONDICIONS DE QUALSEVOL TEORIA DE RESPONSABILITAT, JA SIGUI PER CONTRACTE, RESPONSABILITAT ESTRICTA O DELICTE (INCLOSA LA NEGLIGÈNCIA O D'ALTRE) QUE DERIVI DE QUALSEVOL MANERA DE L'ÚS DELS RECURSOS, ENCARA QUE S'HAGI ADVERTIT DE LA POSSIBILITAT D'AQUESTS DANYS. RPL es reserva el dret de fer qualsevol millora, correcció o qualsevol altra modificació als RECURSOS o a qualsevol producte que s'hi descriu en qualsevol moment i sense previ 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 RPL de tota responsabilitat, cost, dany 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 els 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 a les Condicions estàndard de RPL. La provisió dels RECURSOS per part de RPL no amplia ni modifica de cap altra manera les Condicions Estàndard de RPL, incloent-hi, entre d'altres, les exempcions de responsabilitat i les garanties que s'hi expressen.
Avís legal d'exempció de responsabilitat
2
Un document tècnic que ofereix una visió general d'alt nivellview d'opcions d'àudio a les SBC de Raspberry Pi
Historial de versions del document
Data de llançament
Descripció
1.0
1 d'abril de 2025 Llançament inicial
Àmbit del document
Aquest document s'aplica als següents productes Raspberry Pi:
Pi 0
Pi 1
Pi 2
Pi Pi Pi Pi Pi CM1 CM3 CM4 CM5 Pico Pico2
3
4 400 5 500
0 WHABABB Tots Tots Tots Tots Tots Tots Tots Tots Tots Tots
Àmbit del document
1
Un document tècnic que ofereix una visió general d'alt nivellview d'opcions d'àudio a les SBC de Raspberry Pi
Introducció
Amb els anys, les opcions disponibles per a la sortida d'àudio als SBC (ordinadors de placa única) 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 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.
Introducció
2
Un document tècnic que ofereix una visió general d'alt nivellview d'opcions d'àudio a les SBC de Raspberry Pi
Maquinari d'àudio Raspberry Pi
HDMI
Tots els SBC de Raspberry Pi tenen un connector HDMI que admet àudio HDMI. Si connecteu el vostre SBC de Raspberry Pi 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 ara DTS és compatible. Si utilitzeu vídeo HDMI però voleu que el senyal d'àudio es separi, per exemple...ample, 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 No hi ha sortida d'àudio analògica a la Raspberry Pi 5.
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.
Senyal del segment Jack
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 en 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 compleixen les especificacions adequades es coneixen com a HAT (Hardware Attached on Top). Les seves especificacions es poden trobar aquí: https://datasheets.raspberrypi.com/ La gamma completa de HAT d'àudio 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 l'à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 habilitarà la compatibilitat adequada.
Àudio USB
3
Un document tècnic que ofereix una visió general d'alt nivellview d'opcions d'àudio a les SBC de Raspberry Pi
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 força curt: uns 10 m com a màxim. Els dispositius Bluetooth s'han d'"emparellar" amb el Raspberry Pi SBC i apareixeran a la configuració d'àudio de l'escriptori un cop fet això. El Bluetooth està instal·lat 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.
Bluetooth
4
Un document tècnic que ofereix una visió general d'alt nivellview d'opcions d'àudio a les SBC de Raspberry Pi
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. PulseAudio va succeir a ALSA, abans de ser substituït pel sistema actual, que s'anomena PipeWire. Aquest sistema té la mateixa funcionalitat que PulseAudio 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 PipeWire utilitza la mateixa API que PulseAudio, les utilitats de PulseAudio funcionen correctament en un sistema PipeWire. Aquestes utilitats s'utilitzen en l'ex...ampfitxers a continuació. Per mantenir la mida de la imatge baixa, Raspberry Pi OS Lite encara utilitza ALSA per proporcionar compatibilitat amb l'àudio i no inclou cap biblioteca d'àudio PipeWire, PulseAudio 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 profileNormalment, els dispositius proporcionen 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 sobre aquest botó, s'obriran les opcions de menú específiques del micròfon, com ara la selecció de dispositius 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 sobre la icona de Bluetooth a la barra de tasques i seleccioneu "Afegeix dispositiu". El sistema començarà a buscar els dispositius disponibles, que s'hauran de posar en mode "Descobreix" 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 PipeWire utilitza la mateixa API que PulseAudio, la majoria de les ordres de PulseAudio que s'utilitzen per controlar l'àudio funcionen a PipeWire. pactl és la manera estàndard de controlar PulseAudio: 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ò, PipeWire no està instal·lat per defecte i s'ha d'instal·lar manualment per poder reproduir so. Per instal·lar les biblioteques necessàries per a PipeWire a Raspberry Pi OS Lite, introduïu el següent:
sudo apt instal·la 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 instal·la 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 per exempleampMostra una llista dels mòduls PulseAudio instal·lats en format breu (el format llarg conté molta informació i és difícil de llegir):
$ pactl llista mòduls curts
Mostra una llista breu dels dissipadors de PulseAudio:
Línia d'ordres
5
Un document tècnic que ofereix una visió general d'alt nivellview d'opcions d'àudio a les SBC de Raspberry Pi
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 PipeWire s32le 2 canals 48000Hz SUSPENDIT 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output PipeWire s16le 2 canals 48000Hz SUSPENDIT
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é HDMI i sortida analògica), es retorna el següent:
$ pactl list sinks short 69 alsa_output.platform-bcm2835_audio.stereo-fallback PipeWire s16le 2 canals 48000Hz SUSPENDIT 70 alsa_output.platform-107c701400.hdmi.hdmi-stereo PipeWire s32le 2 canals 48000Hz SUSPENDIT
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 del usuari $ pactl play-sampel sampnom
Hi ha una ordre de PulseAudio 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 PulseAudio 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 PulseAudio que no s'esmenten aquí. Les ordres de PulseAudio webEl lloc web (https://www.freedesktop.org/wiki/Software/PulseAudio/) i les pàgines de manual de cada ordre ofereixen informació extensa sobre el sistema.
Línia d'ordres
6
Un document tècnic que ofereix una visió general d'alt nivellview d'opcions d'àudio a les SBC de Raspberry Pi
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 les llistes d'ús. Feu 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 desactivat
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]# list 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 després connectar-se a un dispositiu pot ser el següent:
$ bluetoothctl Agent registrat [bluetooth]# detectable en Canviant detectable en reeixit [CHG] Controlador D8:3A:DD:3B:00:00 Descobrible en [bluetooth]# emparellable en Canviant emparellable en reeixit [CHG] Controlador D8:3A:DD:3B:00:00 Emparellable en [bluetooth]# escaneig en
<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, amb el format xx:xx:xx:xx:xx:xx] [bluetooth]# scan off [bluetooth]# connect [mateixa adreça MAC] El dispositiu Bluetooth ara hauria d'aparèixer a la llista de dissipadors, tal com es mostra en aquest ex.ample d'una instal·lació de Raspberry Pi OS Lite:
$ pactl list sinks short 69 alsa_output.platform-bcm2835_audio.stereo-fallback PipeWire s16le 2 canals 48000Hz SUSPENDIT 70 alsa_output.platform-107c701400.hdmi.hdmi-stereo PipeWire s32le 2 canals 48000Hz SUSPENDIT 71 bluez_output.CA_3A_B2_CA_7C_55.1 PipeWire s32le 2 canals 48000Hz SUSPENDIT
Línia d'ordres
7
Un document tècnic que ofereix una visió general d'alt nivellview d'opcions d'àudio a les SBC de Raspberry Pi
$ pactl set-default-sink 71 $ paplayample_audio_file>
Ara podeu establir que sigui el valor per defecte i reproduir-hi àudio.
Línia d'ordres
8
Un document tècnic que ofereix una visió general d'alt nivellview d'opcions d'àudio a les SBC de Raspberry Pi
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.
Conclusions
9
Raspberry Pi Un document tècnic que ofereix una visió general d'alt nivellview d'opcions d'àudio a les SBC de Raspberry Pi
Raspberry Pi
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 |