Un documento técnico que ofrece unha
Alto nivel sobreview de Audio
Opcións nos SBC de Raspberry Pi
Raspberry Pi Ltd
Colofón
© 2022-2025 Raspberry Pi Ltd
Esta documentación está baixo unha licenza Creative Commons Atribución-Sen Derivadas 4.0 Internacional (CC BY-ND).
Versión 1.0
Data de construción: 28/05/2025
Aviso legal de exención de responsabilidade
OS DATOS TÉCNICOS E DE FIABILIDADE DOS PRODUTOS DE RASPBERRY PI (INCLUÍDAS AS FOLLAS DE DATOS) MODIFICADOS DE CADA VEZ ("RECURSOS") PROPORCIONAN RASPBERRY PI LTD ("RPL") "TAL CUAL" E CALQUERA GARANTÍA EXPRESA OU IMPLÍCITA, INCLUÍDO, PERO NON LIMITADO. AO, NEGARÁNSE AS GARANTÍAS IMPLÍCITAS DE COMERCIABILIDADE E IDONEIDADE PARA UN FIN PARTICULAR. NA MEDIDA MÁXIMA PERMITIDA POLA LEI APLICABLE EN NINGÚN CASO, RPL SERÁ RESPONSABLE DE NINGÚN DANOS DIRECTOS, INDIRECTOS, ACCIDENTALES, ESPECIAIS, EXEMPLARS OU CONSECUENTES (INCLUÍDO, PERO NON LIMITADO A, A ADQUISICIÓN DE BENS SUBSTITUTIVOS, PERDA DE DATOS; , OU BENEFICIOS; OU INTERRUPCIÓN DE NEGOCIOS) SEEN O CAUSADOS E SOBRE CALQUERA TEORÍA DE RESPONSABILIDADE, FOI POR CONTRATO, RESPONSABILIDADE ESTRICTA OU EXTRAORDINARIA (INCLÚA A NEGLIXENCIA OU DE OUTRO MODO) DERIVADA DE CALQUERA FORMA DO USO DOS RECURSOS, INCLUSO A CONSULTABILIDADE DE DE TAL DANO.
RPL resérvase o dereito de facer calquera mellora, mellora, corrección ou calquera outra modificación nos RECURSOS ou en calquera produto descrito neles en calquera momento e sen previo aviso.
Os RECURSOS están destinados a usuarios cualificados con niveis axeitados de coñecementos de deseño. Os usuarios son os únicos responsables da súa selección e uso dos RECURSOS e de calquera aplicación dos produtos descritos neles. O usuario acepta indemnizar e eximir de responsabilidade a RPL fronte a todas as responsabilidades, custos, danos ou outras perdas derivadas do seu uso dos RECURSOS. RPL concede aos usuarios permiso para usar os RECURSOS unicamente en conxunto cos produtos Raspberry Pi. Prohíbese calquera outro uso dos RECURSOS. Non se concede ningunha licenza a ningún outro dereito de propiedade intelectual de RPL ou de terceiros.
ACTIVIDADES DE ALTO RISCO. Os produtos Raspberry Pi non están deseñados, fabricados nin destinados ao seu uso en contornas perigosas que requiren un rendemento a proba de fallos, como no funcionamento de instalacións nucleares, sistemas de navegación ou comunicación de aeronaves, control de tráfico aéreo, sistemas de armas ou aplicacións críticas para a seguridade (incluídos sistemas de soporte vital e outros dispositivos médicos), nas que o fallo dos produtos podería levar directamente á morte, lesións persoais ou danos físicos ou ambientais graves ("Actividades de alto risco"). RPL renuncia especificamente a calquera garantía expresa ou implícita de idoneidade para Actividades de alto risco e non acepta ningunha responsabilidade polo uso ou inclusións de produtos Raspberry Pi en Actividades de alto risco. Os produtos Raspberry Pi ofrécense suxeitos aos termos e condicións de RPL. Termos estándarA subministración dos RECURSOS por parte de RPL non amplía nin modifica doutro xeito os dereitos de RPL. Termos estándar incluíndo, entre outras, as exencións de responsabilidade e as garantías expresadas neles.
Historial de versións do documento
| Lanzamento | Data | Descrición |
| 1 | 1-abr-25 | Lanzamento inicial |
Alcance do documento
Este documento aplícase aos seguintes produtos 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 | Todos | Todos | Todos | Todos | Todos | Todos | Todos | Todos | Todos | Todos |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Introdución
Co paso dos anos, as opcións dispoñibles para a saída de audio nos SBC (ordenadores dunha soa placa) de Raspberry Pi fixéronse máis numerosas e a forma en que se controlan desde o software cambiou.
Este documento repasará moitas das opcións dispoñibles para a saída de son no teu dispositivo Raspberry Pi e proporcionará instrucións sobre como usar as opcións de son desde o escritorio e a liña de comandos.
Este documento técnico asume que o dispositivo Raspberry Pi executa o sistema operativo Raspberry Pi e está totalmente actualizado co firmware e os kernels máis recentes.
Hardware de son Raspberry Pi
HDMI
Todos os SBC de Raspberry Pi teñen un conector HDMI compatible con audio HDMI. Ao conectar o teu SBC de Raspberry Pi a un monitor ou televisor con altofalantes, activarase automaticamente a saída de audio HDMI a través deses altofalantes. O audio HDMI é un sinal dixital de alta calidade, polo que os resultados poden ser moi bos, e admite audio multicanle como DTS.
Se estás a usar vídeo HDMI pero queres que o sinal de audio se separe (por exemplo,ample, a un ampun adaptador que non admite a entrada HDMI, terás que usar un hardware adicional chamado divisor para extraer o sinal de audio do sinal HDMI. Isto pode ser caro, pero hai outras opcións que se describen a continuación.
PCM analóxico/conector de 3.5 mm
Os modelos B+, 2, 3 e 4 de Raspberry Pi inclúen un conector de audio de 3.5 mm de 4 polos que admite sinais de audio e vídeo composto. Trátase dunha saída analóxica de baixa calidade xerada a partir dun sinal PCM (modulación por pulsos codificados), pero aínda así é axeitada para auriculares e altofalantes de escritorio.
NOTA
A Raspberry Pi 5 non ten saída de audio analóxica.
Os sinais das fichas jack defínense na seguinte táboa, comezando polo extremo do cable e rematando na punta. Hai cables dispoñibles con diferentes asignacións, así que asegúrate de ter a correcta.
| Segmento de Jack | Sinal |
| Manga | Vídeo |
| Anel 2 | Terra |
| Anel 1 | Certo |
| Consello | Esquerda |
Placas adaptadoras baseadas en I2S
Todos os modelos de SBC de Raspberry Pi teñen un periférico I2S dispoñible na cabeceira GPIO. I2S é un estándar de interface de bus serie eléctrico que se usa para conectar dispositivos de audio dixitais e comunicar datos de audio PCM entre periféricos nun dispositivo electrónico. Raspberry Pi Ltd fabrica unha gama de placas de audio que se conectan á cabeceira GPIO e usan a interface I2S para transferir datos de audio desde o SoC (sistema nun chip) á placa complementaria.
Nota: As placas complementarias que se conectan a través do cabezallo GPIO e cumpren as especificacións axeitadas coñécense como HAT (Hardware Attached on Top, hardware conectado na parte superior). As súas especificacións pódense atopar aquí: https://datasheets.raspberrypi.com/
A gama completa de HAT de audio pódese ver na Raspberry Pi Ltd. websitio: https://www.raspberrypi.com/products/
Tamén hai un gran número de HAT de terceiros dispoñibles para a saída de audio, por exemploample de Pimoroni, HiFiBerry, Adafruit, etc., e estes ofrecen unha multitude de características diferentes.
Audio USB
Se non é posible instalar un HAT ou se estás a buscar unha forma rápida e sinxela de conectar un conector jack para unha saída de auriculares ou unha entrada de micrófono, entón un adaptador de audio USB é unha boa opción. Trátase de dispositivos sinxelos e baratos que se conectan a un dos portos USB-A do Raspberry Pi SBC.
O sistema operativo Raspberry Pi inclúe controladores para o audio USB por defecto; en canto se conecta un dispositivo, debería aparecer no menú de dispositivos que aparece ao facer clic co botón dereito na icona do altofalante da barra de tarefas.
O sistema tamén detectará automaticamente se o dispositivo USB conectado ten unha entrada de micrófono e activará a compatibilidade axeitada.
Bluetooth
O audio Bluetooth refírese á transmisión sen fíos de datos de son a través da tecnoloxía Bluetooth, que é moi utilizada. Permite que o Raspberry Pi SBC se comunique con altofalantes e auriculares Bluetooth ou calquera outro dispositivo de audio compatible con Bluetooth. O alcance é bastante curto: uns 10 m como máximo.
Os dispositivos Bluetooth deben estar "emparellados" co SBC da Raspberry Pi e aparecerán na configuración de son do escritorio unha vez feito isto. O Bluetooth está instalado por defecto no sistema operativo Raspberry Pi, e o logotipo de Bluetooth aparece na barra de tarefas do escritorio en calquera dispositivo que teña hardware Bluetooth instalado (xa sexa integrado ou a través dun dongle USB Bluetooth). Cando o Bluetooth está activado, a icona será azul; cando está desactivado, a icona será gris.
Soporte de software
O software de soporte de audio subxacente cambiou considerablemente na imaxe completa do sistema operativo Raspberry Pi e, para o usuario final, estes cambios son na súa maioría transparentes. O subsistema de son orixinal empregado era ALSA. Pulse Audio sucedeu a ALSA antes de ser substituído polo sistema actual, que se chama Pipe Wire. Este sistema ten a mesma funcionalidade que Pulse Audio e unha API compatible, pero tamén ten extensións para xestionar vídeo e outras funcións, o que facilita moito a integración de vídeo e audio. Debido a que Pipe Wire usa a mesma API que Pulse Audio, as utilidades de Pulse Audio funcionan ben nun sistema Pipe Wire.
Estas utilidades úsanse no exampos abaixo.
Para manter o tamaño da imaxe baixo, Raspberry Pi OS Lite aínda usa ALSA para proporcionar compatibilidade con audio e non inclúe ningunha biblioteca de audio Pipe Wire, Pulse Audio ou Bluetooth. Non obstante, é posible instalar as bibliotecas axeitadas para engadir esas funcionalidades segundo sexa necesario, e este proceso tamén se describe a continuación.
Escritorio
Como se mencionou anteriormente, as operacións de son xestiónanse a través da icona do altofalante na barra de tarefas do escritorio. Ao facer clic co botón esquerdo na icona, aparece o control deslizante de volume e o botón de silenciar, mentres que ao facer clic co botón dereito aparece unha lista de dispositivos de son dispoñibles. Simplemente fai clic no dispositivo de son que queres usar. Tamén hai unha opción, mediante un clic co botón dereito, para cambiar o profiles usados por cada dispositivo. Estes profileadoitan proporcionar diferentes niveis de calidade.
Se a compatibilidade co micrófono está activada, aparecerá unha icona de micrófono no menú; ao facer clic co botón dereito nela, aparecerán as opcións específicas do micrófono, como a selección do dispositivo de entrada, mentres que ao facer clic co botón esquerdo, aparecerán a configuración do nivel de entrada.
Bluetooth
Para emparellar un dispositivo Bluetooth, fai clic co botón esquerdo na icona de Bluetooth na barra de tarefas e, a seguir, selecciona "Engadir dispositivo". O sistema comezará entón a buscar dispositivos dispoñibles, que terán que poñerse no modo "Descubrir" para seren vistos. Fai clic no dispositivo cando apareza na lista e os dispositivos deberían emparellarse. Unha vez emparellados, o dispositivo de son aparecerá no menú, que se selecciona facendo clic na icona do altofalante na barra de tarefas.
Liña de comandos
Dado que Pipe Wire usa a mesma API que Pulse Audio, a maioría dos comandos de Pulse Audio que se usan para controlar o audio funcionan en Pipe Wire. `pacts` é a forma estándar de controlar Pulse Audio: escribe `man pactl` na liña de comandos para obter máis detalles.
Requisitos previos para Raspberry Pi OS Lite
Nunha instalación completa de Raspberry Pi OS, xa están instaladas todas as aplicacións e bibliotecas de liña de comandos necesarias. Non obstante, na versión Lite, Pipe Wire non se instala por defecto e debe instalarse manualmente para poder reproducir son.
Para instalar as bibliotecas necesarias para Pipe Wire en Raspberry Pi OS Lite, introduza o seguinte: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Se pretende executar aplicacións que usan ALSA, tamén terá que instalar o seguinte: sudo apt install pipewire-alsa
Reiniciar despois da instalación é o xeito máis sinxelo de que todo funcione.
Reprodución de audio por exemploamples
Mostrar unha lista dos módulos de audio Pulse instalados en formato abreviado (o formato longo contén moita información e é difícil de ler): $ pactl list modules short Mostrar unha lista dos sumidoiros de audio Pulse en formato abreviado:
A lista $ pactl afúndese curta
Nunha Raspberry Pi 5 conectada a un monitor HDMI con audio integrado e unha tarxeta de son USB adicional, este comando dá a seguinte saída: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Cable de tubo s32le 2 canles 48000 Hz SUSPENDIDO 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Cable de tubo s16le 2 canles 48000 Hz SUSPENDIDO
NOTA
A Raspberry Pi 5 non ten saída analóxica.
Para unha instalación de Raspberry Pi OS Lite nunha Raspberry Pi 4 (que ten saída HDMI e analóxica), devólvese o seguinte: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Cable de tubo s16le 2 canles 48000 Hz SUSPENDIDO
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Cable de tubo s32le 2 canles 48000 Hz SUSPENDIDO
Para mostrar e cambiar o receptor predeterminado a audio HDMI (tendo en conta que pode que xa sexa o predeterminado) nesta instalación de Raspberry Pi OS Lite, escribe:
$ pactl obter-sink-predeterminado
alsa_output.platform-bcm2835_audio.stereo-fallback
$ pactl set-predeterminado-sink 70
$ pactl obter-sink-predeterminado
alsa_output.platform-107c701400.hdmi.hdmi-stereo
Para reproducir comoampé dicir, primeiro hai que subilo ao sampa caché, neste caso no sumidoiro predeterminado. Podes cambiar o sumidoiro engadindo o seu nome ao final do pactl play-sampcomando le:
$ pactl subidas-sample sample.mp3 sampnome de usuario
Reproducións de $ pactlample sampnome de usuario
Hai un comando Pulse Audio que é aínda máis doado de usar para reproducir audio:
$ paplay sample.mp3
pactl ten unha opción para definir o volume da reprodución. Dado que o escritorio emprega as utilidades Pulse Audio para obter e definir a información de audio, a execución destes cambios na liña de comandos tamén se reflectirá no control deslizante de volume do escritorio.
Este exampreduce o volume nun 10%:
$ pactl definir-volume-sink @DEFAULT_SINK@ -10%
Este exampdefine o volume ao 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
Hai moitísimos comandos de Pulse Audio que non se mencionan aquí. Os comandos de Pulse Audio websitio (https://www.freedesktop.org/wiki/Software/PulseAudio/) e as páxinas do manual de cada comando ofrecen información exhaustiva sobre o sistema.
Bluetooth
Controlar Bluetooth desde a liña de comandos pode ser un proceso complicado. Ao usar Raspberry Pi OS Lite, os comandos axeitados xa están instalados. O comando máis útil é bluetoothctl, e algúns exemplos...ampA continuación ofrécense menos del en uso.
Facer que o dispositivo sexa detectable para outros dispositivos:
$ bluetoothctl descubríbel activado
Facer que o dispositivo sexa emparellable con outros dispositivos:
$ bluetoothctl emparellable activado
Busca de dispositivos Bluetooth dentro do alcance:
$ dixitalización bluetoothctl activada
Desactivar a dixitalización:
$ bluetoothctl scan off bluetoothctl tamén ten un modo interactivo, que se invoca usando o comando sen parámetros. O seguinte exemploampexecuta o modo interactivo, onde se introduce o comando list e se mostran os resultados, nunha Raspberry Pi 4 con Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Axente rexistrado
[bluetooth]# lista
Controlador D8:3A:DD:3B:00:00 Pi4Lite [predeterminado] [bluetooth]#
Agora podes escribir comandos no intérprete e executaranse. Un proceso típico para emparellar e logo conectar un dispositivo pode ser o seguinte: $ bluetoothctl
Axente rexistrado [bluetooth]# detectable o
O cambio de detectable se realizou correctamente
[CHG] Controlador D8:3A:DD:3B:00:00 Detectable en [bluetooth]# emparellable en
O cambio de emparejamento foi realizado correctamente
[CHG] Controlador D8:3A:DD:3B:00:00 Emparellable en [bluetooth]# exploración activada
<podería haber unha longa lista de dispositivos nas proximidades>
[bluetooth]# par [enderezo MAC do dispositivo, do comando de dixitalización ou do propio dispositivo, no formato xx:xx:xx:xx:xx:xx] [bluetooth]# dixitalización desactivada
[bluetooth]# conectar [mesmo enderezo mac] O dispositivo Bluetooth debería aparecer agora na lista de sumidoiros, como se mostra neste exemploample dunha instalación de Raspberry Pi OS Lite:
A lista $ pactl afúndese curta
69 alsa_output.platform-bcm2835_audio.stereo-fallback Cable de tubo s16le 2 canles 48000 Hz SUSPENDIDO
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Cable de tubo s32le 2 canles 48000 Hz SUSPENDIDO
71 bluez_output.CA_3A_B2_CA_7C_55.1 Cable de tubo s32le 2 canles 48000 Hz SUSPENDIDO
$ pactl set-predeterminado-sink 71
$ paplayample_audio_file>
Agora podes configuralo como predeterminado e reproducir audio nel.
Conclusións
Hai varias maneiras diferentes de producir unha saída de audio desde dispositivos Raspberry Pi Ltd, que atende á gran maioría dos requisitos dos usuarios. Este documento técnico describiu eses mecanismos e proporcionou información sobre moitos deles. Espérase que os consellos presentados aquí axuden ao usuario final a escoller o esquema de saída de audio axeitado para o seu proxecto. Exemplo sinxeloampForon proporcionados lectores sobre como usar os sistemas de son, pero o lector debe consultar os manuais e as páxinas do manual dos comandos de son e Bluetooth para obter máis detalles.
Raspberry Pi é unha marca comercial de Raspberry Pi Ltd
Raspberry Pi Ltd
Documentos/Recursos
 |
Ordenador de placa única Raspberry Pi SBCS [pdfGuía do usuario Computador de placa única SBCS, SBCS, Computador de placa única, Computador de placa, Computador |