Computador de placa única SBCS
“
Informações do produto
Especificações:
- Modelos de Raspberry Pi suportados: Pi 0, Pi 1, Pi 2, Pi 3, Pi 4,
CM1, CM3, CM4, CM5, Pico, Pico2 - Opções de saída de áudio: HDMI, conector analógico PCM/3.5 mm, baseado em I2S
placas adaptadoras, áudio USB, Bluetooth - Suporte de software: PulseAudio, PipeWire, ALSA
Instruções de uso do produto:
Saída de áudio HDMI:
Para saída de áudio HDMI, basta conectar seu Raspberry Pi a um
Monitor HDMI ou TV com alto-falantes integrados.
PCM analógico/conector de 3.5 mm:
Os modelos Raspberry Pi B+, 2, 3 e 4 apresentam um conector de 3.5 mm de 4 polos
Conector de áudio para saída de áudio analógica. Siga a atribuição de sinal
tabela para conexões corretas.
Áudio USB e Bluetooth:
Para saída de áudio USB ou Bluetooth, certifique-se de que os drivers adequados estejam
instalado no seu Raspberry Pi. Consulte o manual do usuário para
instruções detalhadas de configuração.
Configuração do software:
Para habilitar a reprodução de áudio, instale os pacotes de software necessários
usando a linha de comando. Reinicie o Raspberry Pi após a instalação
para que as alterações entrem em vigor.
Example Comandos:
sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils sudo apt install pipewire-alsa pactl lista módulos curtos pactl lista sumidouros curtos
PERGUNTAS FREQUENTES:
P: Quais modelos de Raspberry Pi suportam áudio analógico?
resultado?
A: Os modelos Raspberry Pi B+, 2, 3 e 4 apresentam um conector de 3.5 mm de 4 polos
conector de áudio para saída de áudio analógica.
P: Posso usar uma placa de som USB com meu Raspberry Pi?
R: Sim, você pode usar uma placa de som USB com seu Raspberry Pi para
saída de áudio. Certifique-se de que os drivers corretos estejam instalados.
“`
Raspberry Pi
Um whitepaper que oferece uma visão geral de alto nívelview de opções de áudio em Raspberry Pi SBCs
Raspberry Pi Ltda
Raspberry Pi Ltda
Um whitepaper que oferece uma visão geral de alto nívelview de opções de áudio em Raspberry Pi SBCs
Colofão
© 2022-2025 Raspberry Pi Ltd. Esta documentação está licenciada sob a Licença Creative Commons Atribuição-SemDerivações 4.0 Internacional (CC BY-ND). Versão 1.0 Data de compilação: 28/05/2025
Aviso legal de isenção de responsabilidade
DADOS TÉCNICOS E DE CONFIABILIDADE DOS PRODUTOS RASPBERRY PI (INCLUINDO FOLHAS DE DADOS), CONFORME MODIFICADOS DE TEMPOS EM TEMPOS ("RECURSOS") SÃO FORNECIDOS PELA RASPBERRY PI LTD ("RPL") "NO ESTADO EM QUE SE ENCONTRAM" E QUAISQUER GARANTIAS EXPRESSAS OU IMPLÍCITAS, INCLUINDO, MAS NÃO SE LIMITANDO A, GARANTIAS IMPLÍCITAS DE COMERCIALIZAÇÃO E ADEQUAÇÃO A UM PROPÓSITO ESPECÍFICO SÃO ISENTAS. ATÉ O LIMITE MÁXIMO PERMITIDO PELA LEI APLICÁVEL, EM NENHUMA HIPÓTESE A RPL SERÁ RESPONSÁVEL POR QUAISQUER DANOS DIRETOS, INDIRETOS, INCIDENTAIS, ESPECIAIS, EXEMPLARES OU CONSEQUENCIAIS (INCLUINDO, MAS NÃO SE LIMITANDO A, AQUISIÇÃO DE BENS OU SERVIÇOS SUBSTITUTOS; PERDA DE USO, DADOS OU LUCROS; OU INTERRUPÇÃO DE NEGÓCIOS) INDEPENDENTEMENTE DA CAUSA E DE QUALQUER TEORIA DE RESPONSABILIDADE, SEJA EM CONTRATO, RESPONSABILIDADE OBJETIVA OU ATO ILÍCITO (INCLUINDO NEGLIGÊNCIA OU OUTRO) DECORRENTES DE QUALQUER FORMA DO USO DOS RECURSOS, MESMO SE AVISADO DA POSSIBILIDADE DE TAIS DANOS. A RPL reserva-se o direito de fazer quaisquer melhorias, aprimoramentos, correções ou quaisquer outras modificações nos RECURSOS ou em quaisquer produtos descritos neles a qualquer momento e sem aviso prévio. Os RECURSOS são destinados a usuários qualificados com níveis adequados de conhecimento de design. Os usuários são os únicos responsáveis por sua seleção e uso dos RECURSOS e qualquer aplicação dos produtos descritos neles. O usuário concorda em indenizar e isentar a RPL de todas as responsabilidades, custos, danos ou outras perdas decorrentes do uso dos RECURSOS. A RPL concede aos usuários permissão para usar os RECURSOS somente em conjunto com os produtos Raspberry Pi. Qualquer outro uso dos RECURSOS é proibido. Nenhuma licença é concedida a qualquer outro direito de propriedade intelectual da RPL ou de terceiros. ATIVIDADES DE ALTO RISCO. Os produtos Raspberry Pi não são projetados, fabricados ou destinados ao uso em ambientes perigosos que exijam desempenho à prova de falhas, como na operação de instalações nucleares, sistemas de navegação ou comunicação de aeronaves, controle de tráfego aéreo, sistemas de armas ou aplicações críticas de segurança (incluindo sistemas de suporte de vida e outros dispositivos médicos), nos quais a falha dos produtos pode levar diretamente à morte, ferimentos pessoais ou danos físicos ou ambientais graves (“Atividades de Alto Risco”). A RPL isenta-se especificamente de qualquer garantia expressa ou implícita de adequação para Atividades de Alto Risco e não aceita nenhuma responsabilidade pelo uso ou inclusões de produtos Raspberry Pi em Atividades de Alto Risco. Os produtos Raspberry Pi são fornecidos sujeitos aos Termos Padrão da RPL. O fornecimento dos RECURSOS pela RPL não expande ou modifica de outra forma os Termos Padrão da RPL, incluindo, mas não se limitando às isenções de responsabilidade e garantias expressas neles.
Aviso legal de isenção de responsabilidade
2
Um whitepaper que oferece uma visão geral de alto nívelview de opções de áudio em Raspberry Pi SBCs
Histórico de versões do documento
Data de lançamento
Descrição
1.0
1 de abril de 2025 Lançamento inicial
Escopo do documento
Este documento se aplica 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 Todos Todos Todos Todos Todos Todos Todos Todos Todos Todos
Escopo do documento
1
Um whitepaper que oferece uma visão geral de alto nívelview de opções de áudio em Raspberry Pi SBCs
Introdução
Ao longo dos anos, as opções disponíveis para saída de áudio em SBCs (computadores de placa única) Raspberry Pi tornaram-se mais numerosas, e a forma como são controladas por software mudou. Este documento abordará muitas das opções disponíveis para saída de áudio no seu dispositivo Raspberry Pi e fornecerá instruções sobre como usar as opções de áudio no desktop e na linha de comando. Este whitepaper pressupõe que o dispositivo Raspberry Pi esteja executando o Raspberry Pi OS e totalmente atualizado com o firmware e os kernels mais recentes.
Introdução
2
Um whitepaper que oferece uma visão geral de alto nívelview de opções de áudio em Raspberry Pi SBCs
Hardware de áudio Raspberry Pi
HDMI
Todos os Raspberry Pi SBCs possuem um conector HDMI compatível com áudio HDMI. Conectar seu Raspberry Pi SBC a um monitor ou televisão com alto-falantes habilitará automaticamente a saída de áudio HDMI por meio desses alto-falantes. O áudio HDMI é um sinal digital de alta qualidade, portanto, os resultados podem ser muito bons, e áudio multicanal como DTS é suportado. Se você estiver usando vídeo HDMI, mas quiser que o sinal de áudio seja dividido — por exemploample, para um ampSe você tiver um amplificador que não suporte entrada HDMI, precisará usar um hardware adicional chamado divisor para extrair o sinal de áudio do sinal HDMI. Isso pode ser caro, mas existem outras opções, descritas abaixo.
Conector analógico PCM/3.5 mm
Os modelos Raspberry Pi B+, 2, 3 e 4 possuem um conector de áudio de 3.5 mm e 4 polos que suporta sinais de áudio e vídeo composto. Esta é uma saída analógica de baixa qualidade gerada a partir de um sinal PCM (modulação por código de pulso), mas ainda é adequada para fones de ouvido e alto-falantes de mesa.
NOTA Não há saída de áudio analógica no Raspberry Pi 5.
Os sinais do plugue jack são definidos na tabela a seguir, começando na extremidade do cabo e terminando na ponta. Os cabos estão disponíveis com diferentes atribuições, portanto, certifique-se de ter o cabo correto.
Segmento Jack Sinal
Manga
Vídeo
Anel 2
Chão
Anel 1
Certo
Dica
Esquerda
Placas adaptadoras baseadas em I2S
Todos os modelos de Raspberry Pi SBCs possuem um periférico I2S disponível no conector GPIO. I2S é um padrão de interface de barramento serial elétrico usado para conectar dispositivos de áudio digital e comunicar dados de áudio PCM entre periféricos em um dispositivo eletrônico. A Raspberry Pi Ltd. fabrica uma gama de placas de áudio que se conectam ao conector GPIO e usam a interface I2S para transferir dados de áudio do SoC (sistema em um chip) para a placa adicional. Observação: placas adicionais que se conectam via conector GPIO e atendem às especificações apropriadas são conhecidas como HATs (Hardware Attached on Top). Suas especificações podem ser encontradas aqui: https://datasheets.raspberrypi.com/ A gama completa de HATs de áudio pode ser vista na Raspberry Pi Ltd. website: https://www.raspberrypi.com/products/ Há também um grande número de HATs de terceiros disponíveis para saída de áudio, por exemploample da Pimoroni, HiFiBerry, Adafruit, etc., e estes oferecem uma infinidade de recursos diferentes.
Áudio USB
Se não for possível instalar um HAT, ou se você estiver procurando uma maneira rápida e fácil de conectar um conector jack para uma saída de fone de ouvido ou uma entrada de microfone, um adaptador de áudio USB é uma boa opção. São dispositivos simples e baratos que se conectam a uma das portas USB-A do Raspberry Pi SBC. O Raspberry Pi OS inclui drivers para áudio USB por padrão; assim que um dispositivo for conectado, ele deverá aparecer no menu de dispositivos que aparece quando o ícone do alto-falante na barra de tarefas é clicado com o botão direito. O sistema também detectará automaticamente se o dispositivo USB conectado possui uma entrada de microfone e habilitará o suporte apropriado.
Áudio USB
3
Um whitepaper que oferece uma visão geral de alto nívelview de opções de áudio em Raspberry Pi SBCs
Bluetooth
Áudio Bluetooth refere-se à transmissão sem fio de dados sonoros via tecnologia Bluetooth, amplamente utilizada. Ela permite que o Raspberry Pi SBC se comunique com alto-falantes e fones de ouvido Bluetooth ou qualquer outro dispositivo de áudio compatível com Bluetooth. O alcance é bastante curto — cerca de 10 m no máximo. Dispositivos Bluetooth precisam ser `emparelhados' com o Raspberry Pi SBC e aparecerão nas configurações de áudio da área de trabalho após isso. O Bluetooth é instalado por padrão no Raspberry Pi OS, com o logotipo do Bluetooth aparecendo na barra de tarefas da área de trabalho em qualquer dispositivo que tenha hardware Bluetooth instalado (integrado ou por meio de um dongle USB Bluetooth). Quando o Bluetooth está habilitado, o ícone fica azul; quando está desabilitado, o ícone fica cinza.
Bluetooth
4
Um whitepaper que oferece uma visão geral de alto nívelview de opções de áudio em Raspberry Pi SBCs
Suporte de software
O software de suporte de áudio subjacente mudou consideravelmente na imagem completa do Raspberry Pi OS e, para o usuário final, essas mudanças são em grande parte transparentes. O subsistema de som original utilizado era o ALSA. O PulseAudio sucedeu o ALSA, antes de ser substituído pelo sistema atual, chamado PipeWire. Este sistema possui a mesma funcionalidade do PulseAudio e uma API compatível, mas também possui extensões para lidar com vídeo e outros recursos, facilitando muito a integração de vídeo e áudio. Como o PipeWire utiliza a mesma API do PulseAudio, os utilitários do PulseAudio funcionam perfeitamente em um sistema PipeWire. Esses utilitários são usados no exemploampVeja abaixo. Para manter o tamanho da imagem reduzido, o Raspberry Pi OS Lite ainda usa ALSA para fornecer suporte de áudio e não inclui nenhuma biblioteca de áudio PipeWire, PulseAudio ou Bluetooth. No entanto, é possível instalar as bibliotecas apropriadas para adicionar esses recursos conforme necessário, e esse processo também é descrito abaixo.
Área de trabalho
Como mencionado acima, as operações de áudio são realizadas através do ícone do alto-falante na barra de tarefas da área de trabalho. Clicar com o botão esquerdo do mouse no ícone exibe o controle deslizante de volume e o botão de silenciar, enquanto clicar com o botão direito exibe uma lista de dispositivos de áudio disponíveis. Basta clicar no dispositivo de áudio que deseja usar. Há também uma opção, clicando com o botão direito, para alterar o som.files usados por cada dispositivo. Esses profissionaisfiles geralmente fornecem diferentes níveis de qualidade. Se o suporte ao microfone estiver habilitado, um ícone de microfone aparecerá no menu; clicar com o botão direito nele exibirá opções de menu específicas do microfone, como seleção de dispositivo de entrada, enquanto clicar com o botão esquerdo exibe as configurações de nível de entrada. Bluetooth Para parear um dispositivo Bluetooth, clique com o botão esquerdo no ícone Bluetooth na barra de tarefas e selecione `Adicionar dispositivo'. O sistema começará a procurar dispositivos disponíveis, que precisarão ser colocados no modo `Descobrir' para serem vistos. Clique no dispositivo quando ele aparecer na lista e os dispositivos deverão então parear. Uma vez pareado, o dispositivo de áudio aparecerá no menu, que é selecionado clicando no ícone do alto-falante na barra de tarefas.
Linha de comando
Como o PipeWire usa a mesma API do PulseAudio, a maioria dos comandos do PulseAudio usados para controlar o áudio funcionam no PipeWire. O comando pactl é a maneira padrão de controlar o PulseAudio: digite man pactl na linha de comando para obter mais detalhes. Pré-requisitos para o Raspberry Pi OS Lite: em uma instalação completa do Raspberry Pi OS, todos os aplicativos e bibliotecas de linha de comando necessários já estão instalados. Na versão Lite, no entanto, o PipeWire não é instalado por padrão e deve ser instalado manualmente para que seja possível reproduzir o som. Para instalar as bibliotecas necessárias para o PipeWire no Raspberry Pi OS Lite, insira o seguinte:
sudo apt install pipewire pipewire-pulse pipewire-audio pulseaudio-utils
Se você pretende executar aplicativos que usam ALSA, também precisará instalar o seguinte:
sudo apt install pipewire-alsa
Reinicializar após a instalação é a maneira mais fácil de colocar tudo em funcionamento. Reprodução de áudio ex.amples Exibe uma lista de módulos PulseAudio instalados em formato curto (o formato longo contém muitas informações e é difícil de ler):
$ pactl lista módulos curtos
Exiba uma lista resumida de coletores do PulseAudio:
Linha de comando
5
Um whitepaper que oferece uma visão geral de alto nívelview de opções de áudio em Raspberry Pi SBCs
$ pactl list afunda curto
Em um Raspberry Pi 5 conectado a um monitor HDMI com áudio integrado e uma placa de som USB adicional, este comando fornece a seguinte saída:
$ pactl list sinks short 179 alsa_output.platform-107c701400.hdmi.hdmi-stereo PipeWire s32le 2ch 48000Hz SUSPENSO 265 alsa_output.usb-C-Media_Electronics_Inc._USB_PnP_Sound_Device-00.analog-stereo-output PipeWire s16le 2ch 48000Hz SUSPENSO
NOTA: O Raspberry Pi 5 não possui saída analógica. Para uma instalação do Raspberry Pi OS Lite em um Raspberry Pi 4 — que possui HDMI e saída analógica — o seguinte é retornado:
$ pactl list sinks short 69 alsa_output.platform-bcm2835_audio.stereo-fallback PipeWire s16le 2ch 48000Hz SUSPENSO 70 alsa_output.platform-107c701400.hdmi.hdmi-stereo PipeWire s32le 2ch 48000Hz SUSPENSO
Para exibir e alterar o coletor padrão para áudio HDMI (observando que ele pode já ser o padrão) nesta instalação do Raspberry Pi OS Lite, digite:
$ 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
Para reproduzir comoample, primeiro precisa ser carregado para o sampo cache, neste caso no coletor padrão. Você pode alterar o coletor adicionando seu nome ao final do comando pactl play-sample comando:
$ pactl upload-sampo sample.mp3 sampnome de usuário $ pactl play-sampo samplename
Existe um comando PulseAudio que é ainda mais fácil de usar para reproduzir áudio:
$ papay sample.mp3
O pactl possui uma opção para definir o volume da reprodução. Como a área de trabalho utiliza os utilitários PulseAudio para obter e definir informações de áudio, a execução dessas alterações na linha de comando também será refletida no controle deslizante de volume na área de trabalho. Este exemploample reduz o volume em 10%:
$ pactl set-sink-volume @DEFAULT_SINK@ -10%
Este example define o volume para 50%:
$ pactl set-sink-volume @DEFAULT_SINK@ 50%
Existem muitos, muitos comandos do PulseAudio que não são mencionados aqui. O PulseAudio website (https://www.freedesktop.org/wiki/Software/PulseAudio/) e as páginas de manual de cada comando oferecem informações abrangentes sobre o sistema.
Linha de comando
6
Um whitepaper que oferece uma visão geral de alto nívelview de opções de áudio em Raspberry Pi SBCs
Controlar o Bluetooth a partir da linha de comando pode ser um processo complicado. Ao usar o Raspberry Pi OS Lite, os comandos apropriados já estão instalados. O comando mais útil é bluetoothctl, e alguns exampExemplos de uso são fornecidos abaixo. Torne o dispositivo detectável por outros dispositivos:
$ bluetoothctl detectável em
Torne o dispositivo pareável com outros dispositivos:
$ bluetoothctl pareável em
Procure por dispositivos Bluetooth dentro do alcance:
$ bluetoothctl scan ativado
Desativar a digitalização:
$ bluetoothctl scan desativado
bluetoothctl também possui um modo interativo, que é invocado usando o comando sem parâmetros. O exemplo a seguirample executa o modo interativo, onde o comando list é inserido e os resultados são exibidos, em um Raspberry Pi 4 executando o Raspberry Pi OS Lite Bookworm:
$ bluetoothctl Agente registrado [bluetooth]# lista Controlador D8:3A:DD:3B:00:00 Pi4Lite [padrão] [bluetooth]#
Agora você pode digitar comandos no interpretador e eles serão executados. Um processo típico de pareamento e conexão com um dispositivo pode ser o seguinte:
$ bluetoothctl Agente registrado [bluetooth]# detectável em Alterando detectável em bem-sucedido [CHG] Controlador D8:3A:DD:3B:00:00 Descobrivel em [bluetooth]# pairable em Alterando detectável em bem-sucedido [CHG] Controlador D8:3A:DD:3B:00:00 Emparelhavel em [bluetooth]# scan em
< pode ser uma longa lista de dispositivos nas proximidades >
[bluetooth]# pair [endereço mac do dispositivo, do comando scan ou do próprio dispositivo, no formato xx:xx:xx:xx:xx:xx] [bluetooth]# scan off [bluetooth]# connect [mesmo endereço mac] O dispositivo Bluetooth agora deve aparecer na lista de coletores, conforme mostrado neste exemploample de uma instalação do Raspberry Pi OS Lite:
$ pactl list sinks short 69 alsa_output.platform-bcm2835_audio.stereo-fallback PipeWire s16le 2 canais 48000Hz SUSPENSO 70 alsa_output.platform-107c701400.hdmi.hdmi-stereo PipeWire s32le 2 canais 48000Hz SUSPENSO 71 bluez_output.CA_3A_B2_CA_7C_55.1 PipeWire s32le 2 canais 48000Hz SUSPENSO
Linha de comando
7
Um whitepaper que oferece uma visão geral de alto nívelview de opções de áudio em Raspberry Pi SBCs
$ pactl definir-padrão-sink 71 $ paplayample_audio_file>
Agora você pode torná-lo padrão e reproduzir áudio nele.
Linha de comando
8
Um whitepaper que oferece uma visão geral de alto nívelview de opções de áudio em Raspberry Pi SBCs
Conclusões
Existem diversas maneiras de produzir uma saída de áudio a partir de dispositivos Raspberry Pi Ltd, atendendo à grande maioria das necessidades dos usuários. Este whitepaper descreveu esses mecanismos e forneceu informações sobre muitos deles. Esperamos que as dicas apresentadas aqui ajudem o usuário final a escolher o esquema de saída de áudio certo para seu projeto. Exemplo simplesampForam fornecidas instruções sobre como usar os sistemas de áudio, mas o leitor deve consultar os manuais e páginas de manual dos comandos de áudio e Bluetooth para obter mais detalhes.
Conclusões
9
Raspberry Pi Um Whitepaper que Oferece uma Visão Geral de Alto Nívelview de opções de áudio em Raspberry Pi SBCs
Raspberry Pi
Raspberry Pi é uma marca registrada da Raspberry Pi Ltd
Raspberry Pi Ltda
Documentos / Recursos
 |
Computador de placa única Raspberry Pi SBCS [pdf] Guia do Usuário Computador de placa única SBCS, SBCS, Computador de placa única, Computador de placa, Computador |