Primeiros Passos com ReSpeaker XVF3800
Visão Geral
O ReSpeaker XVF3800 USB 4-Mic Array é um array circular profissional de 4 microfones com XMOS XVF3800, oferecendo AEC, AGC, DoA, formação de feixes (beamforming), VAD, supressão de ruído, desreverberação, captura de voz em 360° (até 5 m) e modos de operação duplos para aplicações avançadas de voz.

Recursos
-
Atualização de chip :De XVF3000 para XVF3800
-
Array Quad de Microfones :4 microfones de alto desempenho em padrão circular para captura de voz em campo distante de 360° até 5 metros
-
Processamento de Áudio Avançado :Baseado no XVF3800 com AEC, formação de múltiplos feixes, desreverberação, detecção de DoA, supressão dinâmica de ruído, faixa de AGC de 60 dB
-
Número de Série Único do Dispositivo :SN integrado permite implantações com múltiplos dispositivos e gerenciamento avançado de dispositivos
-
Modos Duplos de Operação :Modo USB plug-and-play para conexão instantânea a PC e modo INT-Device (I2S) para integração com sistemas embarcados — configurável via comandos USB ou I2C alternando-se o firmware conforme necessário
-
Compatível com Open Source :Funciona com hosts USB (Windows, macOS, Raspberry Pi OS) e hosts I2S (XIAO Série, ESP32, Arduino).
-
Feedback Visual :LEDs RGB programáveis e indicadores de status mostram os estados do dispositivo e a atividade de voz
-
Qualidade de áudio igual ou superior :em comparação ao modelo anterior
Visão Geral do Hardware

Principais Componentes
| Componente / Recurso | Descrição |
|---|---|
| Processador Principal de Áudio | XMOS XVF3800, realiza o processamento de áudio incluindo AEC, formação de feixes, supressão de ruído, etc. |
| Array de Microfones | Quatro microfones PDM MEMS em padrão circular, com suporte a captura de voz em campo distante de 360° (5 m). |
| Codec de Áudio | TLV320AIC3104, responsável pela conversão e saída de áudio. |
| LEDs RGB | 12x WS2812 LEDs RGB endereçáveis individualmente para feedback visual (por exemplo, status, atividade de voz). |
| Botão de Mute | Pressione para ativar/desativar o mute da entrada do microfone. |
| LED Indicador de Mute | Acende (tipicamente vermelho) para indicar que o áudio está silenciado. |
| Botão de Reset | Reset de hardware para a placa/sistema. |
| Porta USB Tipo-C | Usada tanto para alimentação quanto dados (compatível com USB Audio Class 2.0). |
| Conector P2 (3,5 mm) para Fone de Ouvido | Saída de áudio para fones de ouvido ou caixas ativas. |
| Conector de Alto-falante | Interface de alto-falante JST, suporta alto-falantes amplificados de 5 W. |
| Pads de Depuração | Acesso de depuração para XTAG4 ou outros programadores. |
| Headers I2C & I2S | Headers expostos para comunicação I2C e I2S com dispositivos externos. |
| Pads de IO Não Utilizados (XIAO) | Pads de I/O adicionais soldados e conectados ao módulo XIAO. |
| Comunicação I2S & I2C | Suporta conexão a hosts externos como Raspberry Pi, PC, etc. usando esses protocolos. |
| Modos USB & INT-Device | Operação em modo duplo: USB plug-and-play ou modo de dispositivo interno INT via I2S. |
| Número de Série Único | SN do dispositivo integrado para identificação e gerenciamento de múltiplos dispositivos. |
| Compatibilidade com Open Source | Funciona com Arduino, Raspberry Pi, PC/Mac, e é compatível com a XIAO Série. |
| Recursos Avançados de Áudio | AEC, formação de feixes, desreverberação, detecção de DoA, supressão de ruído baseada em DNN, AGC de 60 dB. |
| Feedback Visual | Estado do dispositivo e atividade de áudio exibidos via padrões de LEDs RGB e indicadores de status. |
| Qualidade de Áudio | Igual ou superior aos projetos anteriores baseados em XVF3000. |
O ReSpeaker XVF3800 é oferecido em duas variantes — uma sem XIAO e outra com o XIAO ESP32S3 integrado. A versão sem XIAO opera com o firmware USB padrão. Para usar a versão com XIAO integrado, você deve gravar um firmware construído para o modo INT-Device (I2S). Para instruções detalhadas de configuração, consulte o guia oficial da wiki.
Suporte ao XIAO ESP32S3
- Entrada/saída I2S estéreo com múltiplas opções de saída; interface I2C para configurar e gerenciar parâmetros do XVF3800.
- Reset do XIAO via pino de IO
- Interface e pads de solda
Pinagem


Visão Geral dos GPIOs
O reSpeaker XVF3800 expõe 3 pinos de entrada (GPI) e 5 pinos de saída (GPO) para controle externo. Você pode usá-los para ler estados de botões ou controlar hardware como o LED de mute, o amplificador ou LEDs.
| Nome do Pino | Direção | Função |
|---|---|---|
| X1D09 | Entrada (RO) | Status do botão de mute (alto quando solto) |
| X1D13 | Entrada (RO) | Flutuante |
| X1D34 | Entrada (RO) | Flutuante |
| X0D11 | Saída (RW) | Flutuante |
| X0D30 | Saída (RW) | Controle do LED de mute + mute do microfone (alto = mute) |
| X0D31 | Saída (RW) | Habilitação do amplificador (baixo = habilitado) |
| X0D33 | Saída (RW) | Controle de alimentação do LED WS2812 (alto = ligado) |
| X0D39 | Saída (RW) | Flutuante |
Primeiros Passos
Preparação de Hardware
- Cabo USB Tipo-C
- Computador host ou Raspberry Pi
Preparação de Software
Uso Fora da Caixa
DOA (Direction of Arrival)
Você pode ver o array de LEDs seguindo a direção da voz que está chegando.
Botão de Mute

O botão de Mute no seu ReSpeaker é usado para desativar temporariamente a captura de voz pelo array de microfones. O que acontece quando você pressiona o botão de Mute?
- Os microfones são silenciados — vozes externas não serão mais capturadas nem processadas.
- Um LED vermelho acende para indicar que o modo mute está ativo.
- Isso significa que o ReSpeaker não enviará nenhuma entrada de áudio para o seu computador ou dispositivo host.
Experimente você mesmo com o Audacity

Botão de Reset
O botão de reset (RST) fornece um reset de hardware para o XVF3800 — quando pressionado, ele reinicia o chip e reinicializa o sistema desde o começo, como em um ciclo completo de energia.

Conexão de Alto-falante
Aqui você pode ver como conectar alto-falantes usando o conector P2 (3,5 mm) para fones de ouvido ou a interface JST de alto-falante integrada, dependendo da sua preferência de saída de áudio.


Modo Seguro
O Modo Seguro é um modo especial de recuperação no ReSpeaker XVF3800 que permite gravar firmware via USB DFU ou I2C — para dispositivos como o Raspberry Pi e o ESP32. Se você já tiver gravado o firmware I2S e quiser voltar para o firmware USB, pode entrar no Modo Seguro e regravar o firmware USB usando USB DFU.
Cada tipo de firmware no ReSpeaker XVF3800 suporta diferentes métodos de atualização:
-
O firmware USB oferece suporte apenas a USB DFU, o que significa que você pode atualizar o dispositivo usando uma conexão USB. No entanto, ele não oferece suporte a I2C DFU.
-
O firmware I2S é o oposto — ele oferece suporte a I2C DFU, permitindo atualizações de firmware via interface I2C, mas não oferece suporte a USB DFU.
-
O firmware de Modo de Segurança, que é armazenado na partição Factory, é o mais flexível. Ele oferece suporte a USB DFU e I2C DFU.
Quando usar o Modo de Segurança
- Seu firmware não está funcionando corretamente (por exemplo, USB não é detectado, o LED não está acendendo como esperado).
- Você precisa regravar um novo firmware, mas o atual não responde.
- Você acidentalmente gravou algo errado e quer recuperar o dispositivo.
Como entrar no Modo de Segurança
- Desligue o dispositivo completamente.
- Pressione e segure o botão Mute.
- Enquanto mantém o botão Mute pressionado, reconecte a alimentação.
- O LED vermelho começará a piscar — isso confirma que o dispositivo agora está em Modo de Segurança.
- Agora o dispositivo executa o firmware de Modo de Segurança armazenado na partição Factory.
Atualizar Firmware
Três versões de firmware estão disponíveis no repositório oficial do GitHub. Você pode escolher e gravar o firmware apropriado dependendo dos requisitos da sua aplicação. Para mais detalhes e downloads, consulte o Github Link
Certifique-se de que você precise baixar o repositório inteiro.
- USB
- I2S
- HA
O firmware USB é projetado para uso com sistemas operacionais host como Windows, Linux e macOS ao se comunicar por meio da interface de hardware USB.
Duas variantes de firmware estão disponíveis: respeaker_xvf3800_usb_dfu_firmware_v2.0.x.bin, que fornece áudio de 2 canais, e respeaker_xvf3800_usb_dfu_firmware_6chl_v2.0.x.bin, que fornece áudio de 6 canais. Ambas as versões de firmware operam a uma taxa de amostragem de 16 kHz com profundidade de 32 bits.
Você pode explorar esses arquivos de firmware neste link
| Firmware | Canais | Notas |
|---|---|---|
| respeaker_xvf3800_usb_dfu_firmware_v2.0.x.bin | 2 | Saída processada de 2 canais Canal 0: Conferência Canal 1: ASR |
| respeaker_xvf3800_usb_dfu_firmware_6chl_v2.0.x.bin | 6 | Canal 0: Áudio processado (Conferência) Canal 1: Áudio processado (ASR) Canal 2: Dados brutos do Mic 0 Canal 3: Dados brutos do Mic 1 Canal 4: Dados brutos do Mic 2 Canal 5: Dados brutos do Mic 3 |
O firmware I2S é destinado ao uso quando o dispositivo está conectado a um microcontrolador host como o XIAO ESP32S3. Nessa configuração, os dados de voz são transmitidos usando o protocolo I2S.
O arquivo de firmware respeaker_xvf3800_i2s_dfu_firmware_v1.0.x.bin está disponível aqui. Este firmware suporta áudio de 2 canais com profundidade de 32 bits.
| Firmware | Canais | Notas |
|---|---|---|
| respeaker_xvf3800_i2s_dfu_firmware_v1.0.x.bin | 2 | Saída processada de 2 canais Canal 0: Conferência Canal 1: ASR |
O firmware para Home Assistant é outro firmware baseado em I2S especificamente projetado para integração com o Home Assistant. Este firmware otimizado usa áudio de 2 canais com taxa de amostragem de 48 kHz, oferecendo melhor compatibilidade e desempenho dentro do ambiente do Home Assistant. Você pode visualizar o firmware a partir daqui
| Firmware | Canais | Notas |
|---|---|---|
| respeaker_xvf3800_i2s_master_dfu_firmware_v1.0.x_48k.bin | 2 | Saída processada de 2 canais Canal 0: ASR Canal 1: Palavra de ativação (wake word) |
Conecte o reSpeaker XVF3800 ao seu PC via cabo USB. Observe que você precisa usar a porta XMOS USB-C (próxima à porta jack de 3,5 mm) para gravar o firmware da XMOS.
Instalar DFU Util
dfu-util é uma ferramenta de linha de comando para atualização de firmware de dispositivo via USB.
- Windows
- macOS
- Linux
-
Baixe
dfu-util-0.11-binaries.tar.xze extraia, por exemplo, paraD:\dfu-util-0.11-binaries\win64\
Link para Download -
Adicione o caminho para
dfu-util.exeà variável de sistemaPath:
My Computer > Properties > Advanced > Environment Variables > Path -
Abra o Prompt de Comando (
cmd) e verifique a instalação:
dfu-util -V

- Conecte o ReSpeaker XVF3800 e verifique a detecção do dispositivo:
dfu-util -l

Se você obtiver:
Cannot open DFU device 2886:001a ... (LIBUSB_ERROR_NOT_SUPPORTED)
Prossiga com a etapa de instalação do driver abaixo.
- Instale o Zadig
- Abra o Zadig →
Options > List All Devices - Selecione
reSpeaker 3800oureSpeaker XVF3800 4-Mic Array - Instale o driver WinUSB
- Desligue e ligue o dispositivo
- Execute
dfu-util -lnovamente para confirmar a detecção.
- Abra o Zadig →
- Instale o dfu-util com o Homebrew:
brew install dfu-util
- Verifique se o dispositivo foi detectado:
dfu-util -l
Saída esperada:
dfu-util -l
dfu-util 0.11
Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc.
Copyright 2010-2021 Tormod Volden and Stefan Schmidt
This program is Free Software and has ABSOLUTELY NO WARRANTY
Please report bugs to http://sourceforge.net/p/dfu-util/tickets/
Found DFU: [2886:001a] ver=0202, devnum=3, cfg=1, intf=4, path="2-1.1.4", alt=1, name="reSpeaker DFU Upgrade", serial="101991441000000001"
Found DFU: [2886:001a] ver=0202, devnum=3, cfg=1, intf=4, path="2-1.1.4", alt=0, name="reSpeaker DFU Factory", serial="101991441000000001"
- Instale o dfu-util:
sudo apt install dfu-util
- Conecte o XVF3800 e verifique a detecção:
sudo dfu-util -l
Saída esperada:
pi@raspberrypi:~ $ sudo dfu-util -l
dfu-util 0.9
Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc.
Copyright 2010-2016 Tormod Volden and Stefan Schmidt
This program is Free Software and has ABSOLUTELY NO WARRANTY
Please report bugs to http://sourceforge.net/p/dfu-util/tickets/
Found DFU: [2886:001a] ver=0202, devnum=5, cfg=1, intf=3, path="1-1.1", alt=1, name="reSpeaker DFU Upgrade", serial="101991441000000001"
Found DFU: [2886:001a] ver=0202, devnum=5, cfg=1, intf=3, path="1-1.1", alt=0, name="reSpeaker DFU Factory", serial="101991441000000001"
Gravar Firmware
Baixe o repositório completo de firmware do GitHub aqui XMOS XVF 3800
- Execute o seguinte comando para gravar o firmware
dfu-util -R -e -a 1 -D /path/to/dfu_firmware.bin
- No Linux, execute com sudo
sudo dfu-util -R -e -a 1 -D /path/to/dfu_firmware.bin
- A opção
-Rirá reiniciar a placa automaticamente após a gravação.

- Verifique novamente a versão do firmware com o comando
dfu-util -l, para ter certeza de que o novo firmware foi gravado
Gravação e Reprodução
- Windows
- macOS
- Raspberry Pi / Linux
Configurar o Audacity (Windows)
- Abra o Audacity
- Vá para Audio Setup > Audio Settings

- Defina:
- Host:
Windows WASAPI - Recording Device:
reSpeaker 3800 - Channels:
2 (Stereo) - Sample Rate:
16000 Hz(para Project e Default Sample Rate) - Sample Format:
24-bit
- Host:

- Clique em OK
- Tudo pronto — comece a gravar!

Configurar o Audacity (macOS)
- Abra o Audacity
- Vá para Audio Setup e selecione Recording Device como reSpeaker 3800


- Vá para Audio Setting e defina:

- Recording Device:
reSpeaker 3800 - Channels:
2 (Stereo) - Sample Rate:
16000 Hz(para Project e Default Sample Rate) - Sample Format:
24-bit

- Clique em OK
- Pronto para gravar!

Gravando no Raspberry Pi (Linha de Comando)
- Encontrar o número da placa de som:
arecord -l
Exemplo de saída:
**** List of CAPTURE Hardware Devices ****
card 4: Array [reSpeaker XVF3800 4-Mic Array], device 0: USB Audio [USB Audio]
Subdevices: 1/1
Subdevice #0: subdevice #0
Nesse caso, o número da placa é 4
- Gravar áudio (5 segundos):
arecord -D plughw:4,0 -c 2 -r 16000 -f S16_LE -d 5 output.wav
Substitua 4 pelo número real da sua placa de som
- Ajustando o volume do ReSpeaker XVF3800 no ALSA
alsamixer
No alsamixer, use as setas esquerda/direita para navegar até o dispositivo de som correto. Use a seta para cima para aumentar o volume.

- Reprodução:
aplay -D plughw:4,0 output.wav
Gravação no Raspberry Pi (Audacity)
- Instalar Pi-Apps (se ainda não estiver instalado)
Abra um terminal no seu Raspberry Pi. Execute o seguinte comando para instalar o Pi-Apps
wget -qO- https://raw.githubusercontent.com/Botspot/pi-apps/master/install | bash
Aguarde a conclusão da instalação. Um novo ícone do Pi-Apps aparecerá no seu menu.
-
Instalar o Audacity via Pi-Apps
-
Configurar entrada e saída de áudio
- Clique em "Audio Setup" na barra de ferramentas.
- Selecione "Audio Settings" no menu suspenso.
- Na janela de Configurações de Áudio:
- Escolha o Dispositivo de Gravação correto (por exemplo, reSpeaker XVF3800).
- Escolha o Dispositivo de Reprodução apropriado (por exemplo, reSpeaker XVF3800).
- Certifique-se de que o Host esteja configurado como ALSA para melhor compatibilidade no Raspberry Pi.
- Clique em OK para aplicar as configurações.
- Gravar e reproduzir áudio
Como controlar o reSpeaker XVF3800
O reSpeaker XVF3800 está equipado com uma interface de controle que permite aos usuários configurar a operação do dispositivo, definir ou ler dados de parâmetros e salvar dados de parâmetros no dispositivo. Os usuários podem controlar o dispositivo via interface USB ou I2C. Um aplicativo host de exemplo, xvf_host (para Linux, macOS e Raspberry Pi OS) ou xvf_host.exe (para Windows), é fornecido para conectar-se facilmente à interface de controle do reSpeaker XVF3800.
Baixe a partir daqui
Se você quiser explorar mais sobre o controle via xvf_host, leia este artigo.
- Windows
- macOS / Linux / Raspberry Pi
Usuários Windows
- Certifique-se de que o ReSpeaker XVF3800 esteja conectado via USB
- Extraia
xvf_host.exepara uma pasta como:
C:\Tools\xvf_host\
Verificar instalação
cd C:\Tools\xvf_host
xvf_host.exe --help
Verificar conexão do dispositivo
xvf_host.exe VERSION
Saída esperada:
Device (USB)::device_init() -- Found device VID: 10374 PID: 26 interface: 3
VERSION 2 0 2
Controle de LED
| Comando | Exemplo | Descrição |
|---|---|---|
led_effect | xvf_host.exe led_effect 1 | 0=off, 1=breath, 2=rainbow, 3=solid, 4=DoA |
led_color | xvf_host.exe led_color 0xff8800 | Definir cor em hex (laranja) |
led_speed | xvf_host.exe led_speed 1 | Definir velocidade do efeito |
led_brightness | xvf_host.exe led_brightness 255 | Definir brilho |
led_gammify | xvf_host.exe led_gammify 1 | Ativar correção de gama |
led_doa_color | xvf_host.exe led_doa_color 0x0000ff 0xff0000 | Definir cor base/direcional de DoA |
🟠 Exemplo (respiração laranja):
xvf_host.exe led_effect 1
xvf_host.exe led_color 0xff8800
xvf_host.exe led_speed 1
xvf_host.exe led_brightness 255
Configuração
xvf_host.exe save_configuration 1
xvf_host.exe clear_configuration 1
Controle de GPIO
Ler Entradas:
xvf_host.exe GPI_READ_VALUES
Exemplo de saída: GPI_READ_VALUES 1 0 0
Neste exemplo, o retorno 1 0 0 significa que o pino X1D09 está em nível alto, o pino X1D13 está em nível baixo e o pino X1D34 está em nível baixo.
Ler Saídas:
xvf_host.exe GPO_READ_VALUES
Exemplo de saída: GPO_READ_VALUES 0 1 1 0 0
Neste exemplo, o retorno 0 0 0 1 0 significa que o pino X0D11 está em nível baixo, o pino X0D30 está em nível baixo, o pino X0D31 está em nível alto, o pino X0D33 está em nível alto e o pino X0D39 está em nível baixo.
Definir Saída:
xvf_host.exe GPO_WRITE_VALUE 30 1 # Turn ON mute LED
xvf_host.exe GPO_WRITE_VALUE 30 0 # Turn OFF mute LED
Direção de Chegada (DoA)
- DoA informa de qual direção alguém está falando.
- O anel de LED no ReSpeaker XVF3800 mostra a direção usando luzes.
- Você também pode ler os valores de DoA usando a ferramenta
xvf_host.
Comando para verificar valores de DoA
xvf_host.exe AEC_AZIMUTH_VALUES
Exemplo de saída
Device (USB)::device_init() -- Found device VID: 10374 PID: 26 interface: 3
AEC_AZIMUTH_VALUES 0.91378 (52.36 deg) 0.00000 (0.00 deg) 1.57080 (90.00 deg) 0.91378 (52.36 deg)
- Focused beam 1: Primeira direção fixa de escuta
- Focused beam 2: Segunda direção fixa de escuta
- Free running beam: Direção sempre em varredura
- Auto selected beam: Feixe final escolhido para melhor áudio (usado para indicação de DoA)
Indicação de Fala
- A Energia de Fala mostra quão forte é o sinal de voz — como um medidor de volume da fala.
- Usada para detectar se alguém está falando e quão alto/perto a pessoa está.
- Ruído, eco e distância podem afetar o valor de energia.
Comando para verificar a Energia de Fala:
xvf_host.exe AEC_SPENERGY_VALUES
Exemplo de saída
Device (USB)::device_init() -- Found device VID: 10374 PID: 26 interface: 3
AEC_SPENERGY_VALUES 2080656 0 2083455 2080656
- Focused beam 1: Energia do primeiro feixe
- Focused beam 2: Energia do segundo feixe
- Free running beam: Energia do feixe de varredura
- Auto selected beam: Energia do feixe escolhido para a saída final
Canais de Saída de Áudio
- O XVF3800 fornece 2 canais de áudio:
- Canal esquerdo: Áudio limpo, pós-processado
- Canal direito: Feixe ASR ou dados de eco/referência
Você pode redirecionar esses canais para saídas de diferentes fontes.
Exemplos de comandos
Definir o canal esquerdo para Microfone Amplificado 0
xvf_host.exe AUDIO_MGR_OP_L 3 0
Definir o canal direito para dados de Far End (referência)
xvf_host.exe AUDIO_MGR_OP_R 5 0
Exemplo de saída:
Device (USB)::device_init() -- Found device VID: 10374 PID: 26 interface: 3
Parâmetros de Ajuste (Deixe o som melhor!)
- Essas configurações ajudam a melhorar cancelamento de eco, supressão de ruído, ganho, etc.
- Use-as quando as configurações padrão não forem boas o suficiente.
Parâmetros comuns:
| Parâmetro | Significado |
|---|---|
| AUDIO_MGR_REF_GAIN | Ganho de entrada do alto-falante (sinal de eco) |
| AUDIO_MGR_MIC_GAIN | Ganho de entrada do microfone (quão alto o mic capta) |
| AUDIO_MGR_SYS_DELAY | Atraso entre os sinais do microfone e do alto-falante |
| PP_AGCMAXGAIN | Nível máximo de controle automático de ganho |
| AEC_ASROUTGAIN | Ganho para a saída do feixe ASR |
Para documentação mais detalhada e comandos avançados, visite o repositório oficial no GitHub:
ReSpeaker XVF3800 Host Control README
Para Raspberry Pi
- Conecte o XVF3800 via USB ou I2C
- Torne
xvf_hostexecutável:
cd /path/to/xvf_host
chmod +x xvf_host
Verificar instalação
./xvf_host --help
./xvf_host VERSION
Esperado:
Device (USB)::device_init() -- Found device VID: 10374 PID: 26 interface: 3
VERSION 2 0 2
Usando I2C:
./xvf_host --use i2c VERSION
Controle de LED (igual ao Windows, prefixado com ./)
./xvf_host led_effect 1
./xvf_host led_color 0xff8800
./xvf_host led_speed 1
./xvf_host led_brightness 255
Configuração
./xvf_host save_configuration 1
./xvf_host clear_configuration 1
Controle de GPIO
chmod +x ./xvf_host
Ler Entradas:
./xvf_host GPI_READ_VALUES
Exemplo de saída: GPI_READ_VALUES 1 0 0
Neste exemplo, o retorno 1 0 0 significa que o pino X1D09 está em nível alto, o pino X1D13 está em nível baixo e o pino X1D34 está em nível baixo.
Ler Saídas:
./xvf_host GPO_READ_VALUES
Exemplo de saída: GPO_READ_VALUES 0 1 1 0 0
Neste exemplo, o retorno 0 0 0 1 0 significa que o pino X0D11 está em nível baixo, o pino X0D30 está em nível baixo, o pino X0D31 está em nível alto, o pino X0D33 está em nível alto e o pino X0D39 está em nível baixo.
Definir Saídas:
./xvf_host GPO_WRITE_VALUE 30 1
./xvf_host GPO_WRITE_VALUE 30 0
Direção de Chegada (DoA)
- DoA informa de qual direção alguém está falando.
- O anel de LED no ReSpeaker XVF3800 mostra a direção usando luzes.
- Você também pode ler os valores de DoA usando a ferramenta
xvf_host.
Comando para verificar valores de DoA
./xvf_host AEC_AZIMUTH_VALUES
Exemplo de saída
Device (USB)::device_init() -- Found device VID: 10374 PID: 26 interface: 3
AEC_AZIMUTH_VALUES 0.91378 (52.36 deg) 0.00000 (0.00 deg) 1.57080 (90.00 deg) 0.91378 (52.36 deg)
- Focused beam 1: Primeira direção fixa de escuta
- Focused beam 2: Segunda direção fixa de escuta
- Free running beam: Direção sempre em varredura
- Auto selected beam: Feixe final escolhido para melhor áudio (usado para indicação de DoA)
Indicação de Fala
- A Energia de Fala mostra quão forte é o sinal de voz — como um medidor de volume da fala.
- Usada para detectar se alguém está falando e quão alto/perto a pessoa está.
- Ruído, eco e distância podem afetar o valor de energia.
Comando para verificar a Energia de Fala:
./xvf_host AEC_SPENERGY_VALUES
Exemplo de Saída
Device (USB)::device_init() -- Found device VID: 10374 PID: 26 interface: 3
AEC_SPENERGY_VALUES 2080656 0 2083455 2080656
- Focused beam 1: Energia do primeiro feixe
- Focused beam 2: Energia do segundo feixe
- Free running beam: Energia do feixe de varredura
- Auto selected beam: Energia do feixe escolhido para a saída final
Canais de Saída de Áudio
-
O XVF3800 fornece 2 canais de áudio:
- Canal esquerdo: Áudio limpo, pós-processado
- Canal direito: Feixe ASR ou dados de eco/referência
Você pode redirecionar esses canais para saídas de diferentes fontes.
Comandos de exemplo
Definir canal esquerdo para Microfone Amplificado 0
./xvf_host AUDIO_MGR_OP_L 3 0
Definir canal direito para dados de Extremidade Distante (referência)
./xvf_host AUDIO_MGR_OP_R 5 0
Exemplo de Saída:
Device (USB)::device_init() -- Found device VID: 10374 PID: 26 interface: 3
Parâmetros de Ajuste (Deixe o Som Melhor!)
- Essas configurações ajudam a melhorar cancelamento de eco, supressão de ruído, ganho, etc.
- Use-as quando as configurações padrão não forem boas o suficiente.
Parâmetros Comuns:
| Parâmetro | Significado |
|---|---|
| AUDIO_MGR_REF_GAIN | Ganho de entrada do alto-falante (sinal de eco) |
| AUDIO_MGR_MIC_GAIN | Ganho de entrada do microfone (quão alto o mic ouve) |
| AUDIO_MGR_SYS_DELAY | Atraso entre os sinais do microfone e do alto-falante |
| PP_AGCMAXGAIN | Nível máximo de controle de ganho automático |
| AEC_ASROUTGAIN | Ganho para saída do feixe ASR |
Para documentação mais detalhada e comandos avançados, visite o repositório oficial do GitHub: ReSpeaker XVF3800 Host Control README
Solução de Problemas
A reprodução de som pela saída do alto-falante não é suficiente?
Se o volume de saída do alto-falante do ReSpeaker XVF3800 estiver muito baixo no Linux, talvez seja necessário ajustar os níveis do mixer ALSA para a placa de som XVF3800. Siga as etapas abaixo para aumentar o volume de saída.
Passo 1: Abrir o ALSA Mixer
-
Abra um terminal.
-
Digite o seguinte comando e pressione Enter:
alsamixer
Passo 2: Selecionar a Placa de Som XVF3800
- Pressione F6 para abrir o menu de seleção de placa de som.
- Use as setas para cima/baixo para destacar a placa de som XVF3800.
- Pressione Enter para confirmar a seleção.
Passo 3: Ajustar o Volume do PCM-1
- Use as setas esquerda/direita para navegar até PCM-1.
- Use a seta para cima para aumentar o nível de volume até 100%.

Passo 4: Salvar as Configurações do ALSA
- Pressione ESC para sair do
alsamixer. - Antes de desconectar o XVF3800, execute o seguinte comando para salvar suas configurações:
sudo alsactl store
Passo 5: Opção Adicional (Usando PulseAudio)
Se você ainda não conseguir ouvir o som claramente após ajustar os níveis do ALSA, tente instalar o Controle de Volume PulseAudio para ajustes de volume mais detalhados:
sudo apt install pavucontrol -y
Você pode então abrir o pavucontrol e aumentar o volume de saída além de 100% se necessário.
Após reinstalar os drivers USB, meu ReSpeaker não grava nem reproduz
Desinstale todos os drivers associados ao ReSpeaker no Gerenciador de Dispositivos. Isso resolveu o problema.
Não é possível usar como dispositivo de som no Windows após gravar o firmware?
Abra o menu Iniciar e digite Device manager. Encontre os dispositivos relacionados ao reSpeaker XVF 3800, clique com o botão direito neles e selecione Uninstall devices. Depois disso, reinicie o dispositivo (conecte e desconecte o USB) e o Windows irá reinstalar o driver correto de placa de som para ele.

Recursos
- Arquivo 3D do ReSpeaker XVF3800
- Arquivo ReSpeaker XVF3800 3D-Enclosure-Up
- Arquivo ReSpeaker XVF3800 3D-Enclosure-Down
Suporte Técnico & Discussão sobre o Produto
Obrigado por escolher nossos produtos! Estamos aqui para fornecer diferentes tipos de suporte para garantir que sua experiência com nossos produtos seja a mais tranquila possível. Oferecemos vários canais de comunicação para atender a diferentes preferências e necessidades.