Un libro blanco que ofrece una
Alto nivel superiorview de audio
Opciones en las SBC de Raspberry Pi
frambuesa pi ltd
Colofón
© 2022-2025 Raspberry Pi Ltd
Esta documentación está bajo una licencia Creative Commons Atribución-Sin Derivadas 4.0 Internacional (CC BY-ND).
Versión 1.0
Fecha de construcción: 28/05/2025
Aviso legal
LOS DATOS TÉCNICOS Y DE CONFIABILIDAD DE LOS PRODUCTOS DE RASPBERRY PI (INCLUYENDO LAS HOJAS DE DATOS) SEGÚN LAS MODIFICACIONES PERIODALES ("RECURSOS") SON PROPORCIONADOS POR RASPBERRY PI LTD ("RPL") "TAL CUAL" Y CUALQUIER GARANTÍA EXPLÍCITA O IMPLÍCITA, INCLUYENDO, ENTRE OTRAS SE RENUNCIA A LAS GARANTÍAS IMPLÍCITAS DE COMERCIABILIDAD E IDONEIDAD PARA UN FIN DETERMINADO. EN LA MEDIDA MÁXIMA PERMITIDA POR LA LEY APLICABLE, EN NINGÚN CASO RPL SERÁ RESPONSABLE DE CUALQUIER DAÑO DIRECTO, INDIRECTO, INCIDENTAL, ESPECIAL, EJEMPLAR O CONSECUENTE (INCLUYENDO, ENTRE OTROS, ADQUISICIÓN DE BIENES O SERVICIOS SUSTITUTOS; PÉRDIDA DE USO, PÉRDIDA DE DATOS , O BENEFICIOS O INTERRUPCIÓN DEL NEGOCIO) CUALQUIERA QUE SEA CAUSADO Y SOBRE CUALQUIER TEORÍA DE RESPONSABILIDAD, YA SEA POR CONTRATO, RESPONSABILIDAD ESTRICTA O AGRAVIO (INCLUYENDO NEGLIGENCIA O DE OTRO TIPO) QUE SURJA DE CUALQUIER MANERA DEL USO DE LOS RECURSOS, INCLUSO SI SE HA ADVERTIDO DE LA POSIBILIDAD DE TALES DAÑOS.
RPL se reserva el derecho de realizar cualquier mejora, mejora, corrección o cualquier otra modificación a los RECURSOS o a cualquier producto descrito en ellos en cualquier momento y sin previo aviso.
Los RECURSOS están destinados a usuarios cualificados con conocimientos de diseño adecuados. Los usuarios son los únicos responsables de la selección y el uso de los RECURSOS, así como de cualquier aplicación de los productos descritos en ellos. El usuario se compromete a indemnizar y eximir a RPL de toda responsabilidad, coste, daño o cualquier otra pérdida derivada del uso de los RECURSOS. RPL autoriza a los usuarios a utilizar los RECURSOS únicamente en combinación con los productos Raspberry Pi. Queda prohibido cualquier otro uso de los RECURSOS. No se concede ninguna licencia sobre ningún otro derecho de propiedad intelectual de RPL ni de terceros.
ACTIVIDADES DE ALTO RIESGO. Los productos Raspberry Pi no están diseñados, fabricados ni destinados a utilizarse en entornos peligrosos que requieran un funcionamiento a prueba de fallos, como la operación de instalaciones nucleares, sistemas de navegación o comunicación de aeronaves, control de tráfico aéreo, sistemas de armas o aplicaciones críticas para la seguridad (incluidos sistemas de soporte vital y otros dispositivos médicos), en los que un fallo de los productos podría provocar directamente la muerte, lesiones personales o daños físicos o ambientales graves ("Actividades de Alto Riesgo"). RPL renuncia específicamente a cualquier garantía expresa o implícita de idoneidad para Actividades de Alto Riesgo y no acepta ninguna responsabilidad por el uso o la inclusión de productos Raspberry Pi en Actividades de Alto Riesgo. Los productos Raspberry Pi se proporcionan sujetos a las políticas de RPL. Términos estándarLa provisión de los RECURSOS por parte de RPL no amplía ni modifica de otro modo los derechos de RPL. Términos estándar incluyendo, entre otras, las exenciones de responsabilidad y garantías expresadas en ellos.
Historial de versiones del documento
| Liberar | Fecha | Descripción |
| 1 | 1 de abril de 25 | Lanzamiento inicial |
Alcance del documento
Este documento se aplica a los siguientes productos 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 | Todo | Todo | Todo | Todo | Todo | Todo | Todo | Todo | Todo | Todo |
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ||
Introducción
Con el paso de los años, las opciones disponibles para la salida de audio en las SBC (computadoras de placa única) Raspberry Pi se han vuelto más numerosas y la forma en que se controlan desde el software ha cambiado.
Este documento repasará muchas de las opciones disponibles para la salida de audio en su dispositivo Raspberry Pi y proporcionará instrucciones sobre cómo utilizar las opciones de audio desde el escritorio y la línea de comandos.
Este documento técnico asume que el dispositivo Raspberry Pi ejecuta el sistema operativo Raspberry Pi y está completamente actualizado con el firmware y los kernels más recientes.
Hardware de audio Raspberry Pi
HDMI
Todas las tarjetas de expansión Raspberry Pi tienen un conector HDMI compatible con audio HDMI. Al conectar la tarjeta de expansión Raspberry Pi a un monitor o televisor con altavoces, se activará automáticamente la salida de audio HDMI a través de estos. El audio HDMI es una señal digital de alta calidad, por lo que los resultados pueden ser muy buenos, y es compatible con audio multicanal como DTS.
Si está utilizando video HDMI pero desea que la señal de audio se divida, por ejemploample, a un ampSi su dispositivo no admite la entrada HDMI, necesitará un divisor para extraer la señal de audio de la señal HDMI. Esto puede ser costoso, pero existen otras opciones que se describen a continuación.
PCM analógico/conector de 3.5 mm
Los modelos Raspberry Pi B+, 2, 3 y 4 cuentan con un conector de audio de 3.5 mm de 4 polos compatible con señales de audio y vídeo compuesto. Esta salida analógica de baja calidad se genera a partir de una señal PCM (modulación por código de pulsos), pero es compatible con auriculares y altavoces de escritorio.
NOTA
No hay salida de audio analógica en Raspberry Pi 5.
Las señales de los conectores jack se definen en la siguiente tabla, comenzando por el extremo del cable y terminando en la punta. Hay cables disponibles con diferentes asignaciones, así que asegúrese de tener el correcto.
| Segmento de gato | Señal |
| Manga | Video |
| Anillo 2 | Suelo |
| Anillo 1 | Bien |
| Consejo | Izquierda |
Placas adaptadoras basadas en I2S
Todos los modelos de SBC Raspberry Pi cuentan con un periférico I²S disponible en el conector GPIO. I²S es un estándar de interfaz de bus serie eléctrico que se utiliza para conectar dispositivos de audio digital y comunicar datos de audio PCM entre periféricos de un dispositivo electrónico. Raspberry Pi Ltd. fabrica una gama de tarjetas de audio que se conectan al conector GPIO y utilizan la interfaz I²S para transferir datos de audio desde el SoC (sistema en chip) a la placa complementaria.
Nota: Las placas complementarias que se conectan mediante el conector GPIO y cumplen con las especificaciones correspondientes se conocen como HAT (Hardware Attached on Top). Sus especificaciones se pueden encontrar aquí: https://datasheets.raspberrypi.com/
La gama completa de HAT de audio se puede ver en Raspberry Pi Ltd websitio: https://www.raspberrypi.com/products/
También hay una gran cantidad de HAT de terceros disponibles para la salida de audio, por ejemplo:ampde Pimoroni, HiFiBerry, Adafruit, etc., y estos proporcionan una multitud de características diferentes.
Audio USB
Si no es posible instalar un HAT o busca una forma rápida y sencilla de conectar un conector jack para la salida de auriculares o la entrada de micrófono, un adaptador de audio USB es una buena opción. Se trata de dispositivos sencillos y económicos que se conectan a uno de los puertos USB-A de la tarjeta de control de la Raspberry Pi (SBC).
El sistema operativo Raspberry Pi incluye controladores para audio USB de manera predeterminada; tan pronto como se conecta un dispositivo, debería aparecer en el menú del dispositivo que aparece cuando se hace clic derecho en el ícono del altavoz en la barra de tareas.
El sistema también detectará automáticamente si el dispositivo USB conectado tiene una entrada de micrófono y habilitará el soporte adecuado.
Bluetooth
El audio Bluetooth se refiere a la transmisión inalámbrica de datos de sonido mediante la tecnología Bluetooth, ampliamente utilizada. Permite que la Raspberry Pi SBC se comunique con altavoces y auriculares Bluetooth, o cualquier otro dispositivo de audio compatible con Bluetooth. El alcance es bastante corto: un máximo de unos 10 m.
Los dispositivos Bluetooth deben emparejarse con la tarjeta SBC de Raspberry Pi y, una vez hecho esto, aparecerán en la configuración de audio del escritorio. El Bluetooth está instalado por defecto en el sistema operativo Raspberry Pi; su logotipo aparece en la barra de tareas del escritorio en cualquier dispositivo con Bluetooth instalado (ya sea integrado o mediante un adaptador USB). Cuando el Bluetooth está activado, el icono será azul; cuando está desactivado, será gris.
Soporte de software
El software de soporte de audio subyacente ha cambiado considerablemente en la imagen completa del sistema operativo Raspberry Pi y, para el usuario final, estos cambios son prácticamente transparentes. El subsistema de sonido original utilizado era ALSA. Pulse Audio sucedió a ALSA, antes de ser reemplazado por el sistema actual, llamado Pipe Wire. Este sistema tiene la misma funcionalidad que Pulse Audio y una API compatible, pero también incluye extensiones para gestionar vídeo y otras funciones, lo que facilita enormemente la integración de vídeo y audio. Dado que Pipe Wire utiliza la misma API que Pulse Audio, las utilidades de Pulse Audio funcionan correctamente en un sistema Pipe Wire.
Estas utilidades se utilizan en el examples abajo.
Para reducir el tamaño de la imagen, Raspberry Pi OS Lite aún utiliza ALSA para la compatibilidad de audio y no incluye bibliotecas de audio Pipe Wire, Pulse Audio ni Bluetooth. Sin embargo, es posible instalar las bibliotecas necesarias para añadir estas funciones según sea necesario. Este proceso también se describe a continuación.
De oficina
Como se mencionó anteriormente, las operaciones de audio se gestionan mediante el icono del altavoz en la barra de tareas del escritorio. Al hacer clic con el botón izquierdo en el icono, aparecen el control deslizante de volumen y el botón de silencio, mientras que al hacer clic con el botón derecho, se muestra una lista de dispositivos de audio disponibles. Simplemente haga clic en el dispositivo de audio que desee usar. También puede cambiar el perfil con el botón derecho.files utilizados por cada dispositivo. Estos profilePor lo general, ofrecemos diferentes niveles de calidad.
Si la compatibilidad con micrófono está habilitada, aparecerá un ícono de micrófono en el menú; al hacer clic derecho en él, aparecerán las opciones de menú específicas del micrófono, como la selección del dispositivo de entrada, mientras que al hacer clic izquierdo aparecerán las configuraciones del nivel de entrada.
Bluetooth
Para emparejar un dispositivo Bluetooth, haga clic izquierdo en el icono de Bluetooth en la barra de tareas y seleccione "Agregar dispositivo". El sistema buscará los dispositivos disponibles, que deberán activarse en modo "Descubrir" para verlos. Haga clic en el dispositivo cuando aparezca en la lista y se emparejarán. Una vez emparejado, el dispositivo de audio aparecerá en el menú, que se selecciona haciendo clic en el icono del altavoz en la barra de tareas.
Línea de comandos
Debido a que Pipe Wire usa la misma API que Pulse Audio, la mayoría de los comandos de Pulse Audio utilizados para controlar el audio funcionan en Pipe Wire. pacts es la forma estándar de controlar Pulse Audio: escriba man pactl en la línea de comando para obtener más detalles.
Requisitos previos para Raspberry Pi OS Lite
En una instalación completa del sistema operativo Raspberry Pi, todas las aplicaciones y bibliotecas de línea de comandos necesarias ya están instaladas. Sin embargo, en la versión Lite, Pipe Wire no está instalado por defecto y debe instalarse manualmente para poder reproducir sonido.
Para instalar las bibliotecas necesarias para Pipe Wire en Raspberry Pi OS Lite, ingrese lo siguiente: sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils Si tiene la intención de ejecutar aplicaciones que usen ALSA, también deberá instalar lo siguiente: sudo apt install pipewire-alsa
Reiniciar después de la instalación es la forma más fácil de poner todo en funcionamiento.
Reproducción de audio ej.ampLos
Muestra una lista de módulos de audio Pulse instalados en formato corto (el formato largo contiene mucha información y es difícil de leer): $ pactl list modules short Muestra una lista de receptores de Pulse Audio en formato corto:
$ pactl lista se hunde corto
En una Raspberry Pi 5 conectada a un monitor HDMI con audio incorporado y una tarjeta de sonido USB adicional, este comando da el siguiente resultado: $ pactl list sinks short
179 alsa_output.platform-107c701400.hdmi.hdmi-stereo Cable de tubo s32le 2 canales 48000 Hz SUSPENDIDO 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output Cable de tubo s16le 2 canales 48000 Hz SUSPENDIDO
NOTA
Raspberry Pi 5 no tiene salida analógica.
Para una instalación de Raspberry Pi OS Lite en una Raspberry Pi 4 (que tiene salida HDMI y analógica), se devuelve lo siguiente: $ pactl list sinks short
69 alsa_output.platform-bcm2835_audio.stereo-fallback Cable de tubería s16le 2 canales 48000 Hz SUSPENDIDO
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Cable de tubería s32le 2 canales 48000 Hz SUSPENDIDO
Para mostrar y cambiar el receptor predeterminado a audio HDMI (teniendo en cuenta que puede que ya sea el predeterminado) en esta instalación de Raspberry Pi OS Lite, escriba:
$ pactl obtener-receptor-predeterminado
alsa_output.platform-bcm2835_audio.stereo-fallback
$ pactl set-default-sink 70
$ pactl obtener-receptor-predeterminado
alsa_output.platform-107c701400.hdmi.hdmi-estéreo
Para reproducir comoampEs decir, primero hay que subirlo al sampLa caché, en este caso en el receptor predeterminado. Puedes cambiar el receptor añadiendo su nombre al final del pactl play-s.ample comando:
$ pactl upload-sampel sample.mp3 sampnombre del archivo
$ pactl play-sampel sampnombre del archivo
Hay un comando Pulse Audio que es aún más fácil de usar para reproducir audio:
$paplay sample.mp3
pactl tiene una opción para configurar el volumen de reproducción. Dado que el escritorio utiliza las utilidades de Pulse Audio para obtener y configurar la información de audio, la ejecución de estos cambios en la línea de comandos también se reflejará en el control deslizante de volumen del escritorio.
Este example reduce el volumen en un 10%:
$ pactl set-sink-volume @DEFAULT_SINK@ -10%
Este example establece el volumen al 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
Hay muchísimos comandos de Pulse Audio que no se mencionan aquí. Pulse Audio websitiohttps://www.freedesktop.org/wiki/Software/PulseAudio/) y las páginas del manual de cada comando ofrecen información detallada sobre el sistema.
Bluetooth
Controlar el Bluetooth desde la línea de comandos puede ser un proceso complicado. Al usar Raspberry Pi OS Lite, los comandos adecuados ya están instalados. El comando más útil es bluetoothctl, y algunos ejemplos...ampA continuación se muestran algunos ejemplos de su uso.
Hacer que el dispositivo sea detectable para otros dispositivos:
$ bluetoothctl detectable en
Hacer que el dispositivo sea emparejable con otros dispositivos:
$ bluetoothctl emparejable en
Busque dispositivos Bluetooth dentro del alcance:
$ bluetoothctl escanear en
Desactivar el escaneo:
$ bluetoothctl scan off bluetoothctl también tiene un modo interactivo, que se invoca usando el comando sin parámetros. El siguiente ejemploampejecuta el modo interactivo, donde se ingresa el comando de lista y se muestran los resultados, en una Raspberry Pi 4 con Raspberry Pi OS Lite Bookworm: $ bluetoothctl
Agente registrado
[bluetooth]# lista
Controlador D8:3A:DD:3B:00:00 Pi4Lite [predeterminado] [bluetooth]#
Ahora puede escribir comandos en el intérprete y se ejecutarán. Un proceso típico para emparejar y conectar un dispositivo podría ser el siguiente: $ bluetoothctl
Agente registrado [bluetooth]# detectable en
Cambio de visible en exitoso
[CHG] Controlador D8:3A:DD:3B:00:00 Detectable en [bluetooth]# emparejable en
Cambio de emparejamiento exitoso
[CHG] Controlador D8:3A:DD:3B:00:00 Emparejable en [bluetooth]# escanear en
<podría ser una larga lista de dispositivos en las cercanías>
[bluetooth]# par [dirección mac del dispositivo, desde el comando de escaneo o desde el dispositivo mismo, en el formato xx:xx:xx:xx:xx:xx] [bluetooth]# escaneo desactivado
[bluetooth]# connect [misma dirección mac] El dispositivo Bluetooth ahora debería aparecer en la lista de receptores, como se muestra en este ejemplo.ample de una instalación de Raspberry Pi OS Lite:
$ pactl lista se hunde corto
69 alsa_output.platform-bcm2835_audio.stereo-fallback Cable de tubería s16le 2 canales 48000 Hz SUSPENDIDO
70 alsa_output.platform-107c701400.hdmi.hdmi-stereo Cable de tubería s32le 2 canales 48000 Hz SUSPENDIDO
71 bluez_output.CA_3A_B2_CA_7C_55.1 Cable de tubería s32le 2 canales 48000 Hz SUSPENDIDO
$ pactl set-default-sink 71
$paplayampel_audio_file>
Ahora puedes establecerlo como predeterminado y reproducir audio en él.
Conclusiones
Existen diversas maneras de generar una salida de audio desde dispositivos Raspberry Pi Ltd, satisfaciendo la gran mayoría de las necesidades de los usuarios. Este informe técnico describe estos mecanismos y proporciona información sobre muchos de ellos. Se espera que los consejos aquí presentados ayuden al usuario final a elegir el esquema de salida de audio adecuado para su proyecto. Ejemplo simpleampSe han proporcionado instrucciones sobre cómo utilizar los sistemas de audio, pero el lector debe consultar los manuales y las páginas de manual de los comandos de audio y Bluetooth para obtener más detalles.
Raspberry Pi es una marca comercial de Raspberry Pi Ltd.
frambuesa pi ltd
Documentos / Recursos
 |
Computadora de placa única SBCS Raspberry Pi [pdf] Guía del usuario Computadora de placa única SBCS, SBCS, computadora de placa única, computadora de placa, computadora |