Computadora de placa única SBCS
“
Información do produto
Especificacións:
- Modelos de Raspberry Pi compatibles: Pi 0, Pi 1, Pi 2, Pi 3, Pi 4,
CM1, CM3, CM4, CM5, Pico, Pico2 - Opcións de saída de audio: HDMI, PCM analóxico/conector de 3.5 mm, baseado en I2S
placas adaptadoras, audio USB, Bluetooth - Soporte de software: PulseAudio, PipeWire, ALSA
Instrucións de uso do produto:
Saída de audio HDMI:
Para a saída de audio HDMI, simplemente conecta a túa Raspberry Pi a un
Monitor HDMI ou televisor con altofalantes incorporados.
PCM analóxico/conector de 3.5 mm:
Os modelos B+, 2, 3 e 4 de Raspberry Pi inclúen un conector de 4 polos e 3.5 mm
toma de son para saída de son analóxica. Siga a asignación de sinal
táboa para as conexións correctas.
Son por USB e Bluetooth:
Para a saída de audio USB ou Bluetooth, asegúrese de que os controladores axeitados estean dispoñibles.
instalado na túa Raspberry Pi. Consulta o manual do usuario para obter información sobre
instrucións de configuración detalladas.
Configuración de software:
Para activar a reprodución de son, instala os paquetes de software necesarios
usando a liña de comandos. Reinicie a súa Raspberry Pi despois da instalación
para que os cambios teñan efecto.
Example Comandos:
sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils sudo apt install pipewire-alsa pactl list modules short pactl list sinks short
FAQ:
P: Que modelos de Raspberry Pi admiten audio analóxico?
saída?
A: Os modelos B+, 2, 3 e 4 de Raspberry Pi inclúen un conector jack de 4 polos e 3.5 mm.
toma de son para saída de son analóxica.
P: Podo usar unha tarxeta de son USB coa miña Raspberry Pi?
R: Si, podes usar unha tarxeta de son USB coa túa Raspberry Pi para
saída de son. Asegúrate de que estean instalados os controladores axeitados.
"'
Raspberry Pi
Un documento técnico que ofrece unha visión xeral de alto nivelview de opcións de audio en SBC de Raspberry Pi
Raspberry Pi Ltd
Raspberry Pi Ltd
Un documento técnico que ofrece unha visión xeral de alto nivelview de opcións de audio en SBC de Raspberry Pi
Colofón
© 2022-2025 Raspberry Pi Ltd Esta documentación ten unha licenza Creative Commons Atribución-SenDerivadas 4.0 Internacional (CC BY-ND). Versión 1.0 Data de compilació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ÍENDO, PERO NON LIMITADO Á GARANTÍA IMPLÍCITA, A GARANTÍA IMPLÍCITA E IMPLÍCITA DE GARANTÍA. DENUNCIASE A 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 CONSECUCIÓN DE BENS SUBSTITUTIVOS, PERDA DE BENEFICIOS, PERDA DE DATOS, DERIVADOS DE SERVIZOS; OU INTERRUPCIÓN EMPRESARIAL) 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, AÍNDA QUE SE CONSULTA. 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ñecemento do 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 comprométese a indemnizar e eximir a RPL de todas as responsabilidades, custos, danos ou outras perdas derivadas do uso dos RECURSOS. RPL concede aos usuarios permiso para usar os RECURSOS unicamente xunto cos produtos Raspberry Pi. Queda prohibido calquera outro uso dos RECURSOS. Non se concede ningunha licenza a ningún outro RPL ou dereito de propiedade intelectual de terceiros. ACTIVIDADES DE ALTO RISCO. Os produtos Raspberry Pi non están deseñados, fabricados nin destinados a ser utilizados en ambientes perigosos que requiran un rendemento seguro, 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índo sistemas de soporte vital e outros dispositivos médicos), nos que o fallo dos produtos pode provocar directamente a morte, lesións persoais ou danos físicos ou ambientais graves ("Actividades de risco alto"). RPL renuncia específicamente a calquera garantía expresa ou implícita de aptitude para actividades de alto risco e non acepta ningunha responsabilidade polo uso ou inclusión de produtos Raspberry Pi en actividades de alto risco. Os produtos Raspberry Pi ofrécense suxeitos ás Condicións estándar de RPL. A disposición de RPL dos RECURSOS non amplía nin modifica de ningún xeito as Condicións estándar de RPL, incluíndo, entre outras, as renuncias e garantías expresadas nelas.
Aviso legal de exención de responsabilidade
2
Un documento técnico que ofrece unha visión xeral de alto nivelview de opcións de audio en SBC de Raspberry Pi
Historial de versións do documento
Data de lanzamento
Descrición
1.0
1 de abril de 2025 Publicación inicial
Alcance do documento
Este documento aplícase aos seguintes produtos 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 Todo Todo Todo Todo Todo Todo Todo Todo Todo Todo
Alcance do documento
1
Un documento técnico que ofrece unha visión xeral de alto nivelview de opcións de audio en SBC de Raspberry Pi
Introdución
Co paso dos anos, as opcións dispoñibles para a saída de son nos SBC (ordenadores dunha soa placa) de Raspberry Pi aumentaron 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.
Introdución
2
Un documento técnico que ofrece unha visión xeral de alto nivelview de opcións de audio en SBC de Raspberry Pi
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 o audio multicanle como DTS é compatible. 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 Non hai saída de audio analóxica en Raspberry Pi 5.
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.
Sinal do segmento Jack
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 da cabeceira 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, un adaptador de audio USB é unha boa opción. Trátase de dispositivos sinxelos e económicos 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.
Audio USB
3
Un documento técnico que ofrece unha visión xeral de alto nivelview de opcións de audio en SBC de Raspberry Pi
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, duns 10 m como máximo. Os dispositivos Bluetooth deben estar "emparellados" co Raspberry Pi SBC e aparecerán na configuración de audio do escritorio unha vez feito isto. Bluetooth está instalado por defecto en Raspberry Pi OS, 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 Bluetooth está activado, a icona será azul; cando está desactivado, a icona será gris.
Bluetooth
4
Un documento técnico que ofrece unha visión xeral de alto nivelview de opcións de audio en SBC de Raspberry Pi
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. PulseAudio sucedeu a ALSA, antes de ser substituído polo sistema actual, que se chama PipeWire. Este sistema ten a mesma funcionalidade que PulseAudio 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 PipeWire usa a mesma API que PulseAudio, as utilidades de PulseAudio funcionan ben nun sistema PipeWire. Estas utilidades úsanse no exampficheiros a continuación. 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 PipeWire, PulseAudio 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 profileNormalmente, os dispositivos ofrecen 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 de menú específicas do micrófono, como a selección de dispositivos 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 emparellado, 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 PipeWire usa a mesma API que PulseAudio, a maioría dos comandos de PulseAudio que se usan para controlar o audio funcionan en PipeWire. pactl é a forma estándar de controlar PulseAudio: 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, todas as aplicacións e bibliotecas de liña de comandos necesarias xa están instaladas. Non obstante, na versión Lite, PipeWire non está instalado por defecto e debe instalarse manualmente para poder reproducir son. Para instalar as bibliotecas necesarias para PipeWire en Raspberry Pi OS Lite, introduce o seguinte:
sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils
Se pretendes executar aplicacións que usen ALSA, tamén terás que instalar o seguinte:
sudo apt install pipewire-alsa
Reiniciar despois da instalación é o xeito máis doado de que todo funcione. Reprodución de audio por exemploampMostrar unha lista dos módulos de PulseAudio instalados en formato curto (o formato longo contén moita información e é difícil de ler):
$ pactl lista módulos curtos
Mostrar unha lista resumida dos sumidoiros de PulseAudio:
Liña de comandos
5
Un documento técnico que ofrece unha visión xeral de alto nivelview de opcións de audio en SBC de Raspberry Pi
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 lista disipa curto 179 alsa_output.platform-107c701400.hdmi.hdmi-stereo PipeWire s32le 2 canles 48000 Hz SUSPENDIDO 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output PipeWire s16le 2 canles 48000 Hz SUSPENDIDO
NOTA Raspberry Pi 5 non ten saída analóxica. Para unha instalación de Raspberry Pi OS Lite nunha Raspberry Pi 4 (que ten HDMI e saída analóxica), devólvese o seguinte:
$ pactl list sinks short 69 alsa_output.platform-bcm2835_audio.stereo-fallback PipeWire s16le 2 canles 48000 Hz SUSPENDIDO 70 alsa_output.platform-107c701400.hdmi.hdmi-stereo PipeWire 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-sumidoiro-predeterminado alsa_output.platform-bcm2835_audio.stereo-fallback $ pactl establecer-sumidoiro-predeterminado 70 $ pactl obter-sumidoiro-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 $ pactl reproduciónsample sampnome de usuario
Hai un comando de PulseAudio que é aínda máis doado de usar para reproducir audio:
$ paplay sample.mp3
pactl ten unha opción para axustar o volume da reprodución. Dado que o escritorio usa as utilidades PulseAudio para obter e axustar 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 exemploampreduce 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 PulseAudio que non se mencionan aquí. O comando de PulseAudio webO sitio web (https://www.freedesktop.org/wiki/Software/PulseAudio/) e as páxinas do manual de cada comando ofrecen información exhaustiva sobre o sistema.
Liña de comandos
6
Un documento técnico que ofrece unha visión xeral de alto nivelview de opcións de audio en SBC de Raspberry Pi
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, indícanse algunhas das súas funcións. Fai 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:
$ dixitalización bluetoothctl desactivada
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]# list 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]# descubríbel activado Cambiando descubríbel en caso de éxito [CHG] Controlador D8:3A:DD:3B:00:00 Descubríbel activado [bluetooth]# emparellable activado Cambiando de emparellable en caso de éxito [CHG] Controlador D8:3A:DD:3B:00:00 Emparellable en [bluetooth]# dixitalización activada
<podería haber unha longa lista de dispositivos nas proximidades>
[bluetooth]# emparellamento [enderezo MAC do dispositivo, desde o comando de dixitalización ou desde o propio dispositivo, no formato xx:xx:xx:xx:xx:xx] [bluetooth]# desactivación da dixitalización [bluetooth]# conexión [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:
$ pactl lista disipa curto 69 alsa_output.platform-bcm2835_audio.stereo-fallback PipeWire s16le 2 canles 48000Hz SUSPENDIDO 70 alsa_output.platform-107c701400.hdmi.hdmi-stereo PipeWire s32le 2 canles 48000Hz SUSPENDIDO 71 bluez_output.CA_3A_B2_CA_7C_55.1 PipeWire s32le 2 canles 48000Hz SUSPENDIDO
Liña de comandos
7
Un documento técnico que ofrece unha visión xeral de alto nivelview de opcións de audio en SBC de Raspberry Pi
$ pactl definir-sumidoiro-predeterminado 71 $ paplayample_audio_file>
Agora podes configuralo como predeterminado e reproducir audio nel.
Liña de comandos
8
Un documento técnico que ofrece unha visión xeral de alto nivelview de opcións de audio en SBC de Raspberry Pi
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.
Conclusións
9
Raspberry Pi Un documento técnico que ofrece unha visión xeral de alto nivelview de opcións de audio en SBC de Raspberry Pi
Raspberry Pi
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 |