Iara Guia de montagem · v0.4

ESP32-S3Tela de 4"Impressão 3DPortuguês

Iara, uma atendente virtual de mesa

Uma caixa do tamanho de um celular grande, que fica em pé numa base na mesa e sai dela para ir na mochila, com uma tela de 4 polegadas mostrando uma atendente de corpo inteiro. Você fala com ela em português e ela responde em voz alta, mudando de animação enquanto escuta, pensa e fala.

  • 78 × 172 × 32mm, leva como um celular
  • 320 × 480tela ST7796 de 4"
  • ≈ R$ 480peças, caixa e base
  • 26 fiossoldados na ESP32

Em construção. Peças, ligações e caixa já valem e podem ser compradas, impressas e montadas. O firmware e o gerador de vídeos ainda estão sendo feitos; as seções marcadas com "em breve" vão ser atualizadas.

A Iara montada, vista de frenteCaixa em pé do tamanho de um celular grande, com a tela mostrando a atendente de corpo inteiro, o microfone e o LED em cima e a grade do alto-falante embaixo.

Parada: respira e pisca enquanto espera alguém chamar.

01

Visão geral

A Iara não desenha a personagem em tempo real: cada estado é um vídeo curto em loop guardado no cartão de memória. A placa troca de vídeo conforme o que está acontecendo na conversa.

  1. Você falaDiz "Iara" ou aperta o botão BOOT.
  2. Ela escutaA ESP32-S3 grava sua voz pelo microfone e manda pelo Wi-Fi.
  3. O servidor pensaO xiaozhi.me ou um servidor no seu PC transcreve, chama a IA e gera a voz.
  4. Ela respondeA voz sai no alto-falante enquanto a tela toca o vídeo "falando".
Medidas
78 × 172 × 32 mm, lisa atrás como um celular
Na mesa
Numa base separada, inclinada 15° para trás; é só pôr e tirar
Tela
4", 320 × 480, chip ST7796, ligação SPI
Placa
ESP32-S3 N16R8: 16 MB de flash e 8 MB de PSRAM
Som
Microfone INMP441, amplificador MAX98357A de 3 W, alto-falante de 40 mm
Conexão
Wi-Fi de 2,4 GHz
Energia
5 V pelo USB-C, de um carregador de celular de 2 A
Firmware
Baseado no XiaoZhi ESP32, licença MIT

O XiaoZhi é o mesmo projeto aberto que está por baixo de assistentes como o Troko. O que muda aqui é a tela maior, a caixa e os vídeos da personagem no lugar do rostinho.

02

O projeto

A caixa tem cinco partes empilhadas da frente para trás. A tela fica encostada na frente, um suporte impresso segura a tela e carrega a eletrônica, e a tampa fecha atrás, lisa. Na mesa ela fica numa base impressa separada, que é só pôr e tirar.

Iara fechada, de frente e de ladoFrente com a janela da tela, furo do microfone e LED em cima e grade do alto-falante embaixo. Lado direito com a entrada USB-C e a tampa lisa atrás.LED de estadoFuro do microfone, 3 mmJanela da tela, 56 × 84 mmGrade do alto-falanteVolumeEntrada USB-CTampa lisa, sem péFrenteLado direito78 × 172 × 32 mm, para levar como um celular grande

Arraste o desenho para o lado para ver tudo.

Fechada, de frente e de lado. O microfone e o LED ficam em cima, a grade do alto-falante embaixo, os botões de volume na lateral esquerda e o USB-C na direita.
03

Materiais

Tudo isto tem com envio nacional. Os preços são de referência, pesquisados em novembro de 2026, e mudam bastante entre vendedores.

Eletrônica

PeçaO que pedirPreçoOnde achei
ESP32-S3 DevKitC-1 N16R8Tem que ser N16R8: 16 MB de flash e 8 MB de PSRAM, com USB-C. Sem PSRAM o firmware não roda. Prefira com as barras de pinos soltas.R$ 67 a 95Mercado Livre, Curto Circuito
Tela TFT 4" ST7796SPI, 320 × 480, chip ST7796, com entrada de cartão SD atrás. Touch não é necessário.R$ 232Mercado Livre
Microfone INMP441Microfone digital I2S. Pinos SCK, WS, SD, L/R, VDD e GND.R$ 22MakerHero
Amplificador MAX98357AAmplificador I2S de 3 W. Pinos LRC, BCLK, DIN, GAIN, SD, GND e VIN.R$ 46Mercado Livre
Alto-falante4 a 8 Ω, 2 a 3 W, 40 mm de diâmetro. É a medida do anel da caixa.~R$ 15Qualquer loja de eletrônica
Cartão microSDDe 8 a 32 GB, classe 10, formatado em FAT32. É onde ficam os vídeos.—Provavelmente você já tem um
2 botões táteis6 × 6 mm, com 5 mm de altura. Para subir e baixar o volume.centavosQualquer loja de eletrônica
LED de 3 mm e resistor de 220 ΩMostra o estado da Iara por uma luz.centavosQualquer loja de eletrônica
Fio e caboUns 3 m de fio flexível 26 AWG em 4 cores, termorretrátil fino e um cabo USB-C de dados (muitos só carregam).~R$ 15Qualquer loja de eletrônica

Caixa

PeçaPara quêPreço
4 parafusos M3 × 8, cabeça chataFecham a tampa. A cabeça entra no escareado.~R$ 20
4 insertos M3 de rosca quenteRosca de metal nas torres. Peça os de 5,7 mm de comprimento e 4,6 mm por fora.
4 parafusos M2,5 × 8 autoatarraxantesPrendem o suporte nos pinos.
Fita dupla face de espuma, 1 mmPrende a ESP32 e o amplificador e veda o microfone.~R$ 20
Cola quenteAlto-falante, LED e botões.
4 pezinhos de silicone adesivosEmbaixo da base de mesa, para ela não escorregar.
Filamento PETG ou PLAUns 180 g para todas as peças, com a base.~R$ 20
Total aproximadoR$ 480 R$ 420 de eletrônica e R$ 60 de caixa e base. Importando a tela, fica perto de R$ 330.

Importar a tela. A mesma tela de 4" ST7796 sai por US$ 11 a 15 no AliExpress, uns R$ 60 a 80. Desde setembro de 2026 as compras de até US$ 50 não pagam mais o imposto federal, só o ICMS do estado, de 17 a 20% (Poder360). A entrega leva de 20 a 40 dias úteis. Procure "4.0 inch SPI TFT ST7796 320x480" e confira na foto que o chip é ST7796.

E se eu quiser a tela menor?

As telas de 2,4" e 2,8" com chip ILI9341 (240 × 320, R$ 60 a 80) usam a mesma ligação, pino por pino, e o vídeo fica mais fluido nelas. A caixa desta página é para a de 4"; a de 2,8" precisa de outra caixa. Evite a de 3,5" com chip ILI9488: pelo SPI ela manda cor de 18 bits e fica lenta para vídeo.

04

Esquema elétrico

A ESP32-S3 está desenhada vista de cima, com o USB embaixo. Os pinos são contados de cima para baixo nas duas fileiras, de 1 a 22. Os pinos com bolinha branca são os que levam fio.

Esquema elétrico da IaraESP32-S3 DevKitC-1 vista de cima no centro, com as fileiras de 22 pinos da esquerda e da direita. À esquerda, a tela ST7796 com o cartão SD e o LED. À direita, o microfone INMP441, os botões de volume e o amplificador MAX98357A com o alto-falante.ESP32-S3N16R8ESP32-S3 DevKitC-1, vista de cimafileira esquerdafileira direitaUARTUSBBOOTRST 1 3V3 2 3V3 3 RST 4 GPIO4 5 GPIO5 6 GPIO6 7 GPIO7 8 GPIO15 9 GPIO1610 GPIO1711 GPIO1812 GPIO813 GPIO314 GPIO4615 GPIO916 GPIO1017 GPIO1118 GPIO1219 GPIO1320 GPIO1421 5V22 GNDGND 1TX 2RX 3GPIO1 4GPIO2 5GPIO42 6GPIO41 7GPIO40 8GPIO39 9GPIO38 10GPIO37 11GPIO36 12GPIO35 13GPIO0 14GPIO45 15GPIO48 16GPIO47 17GPIO21 18GPIO20 19GPIO19 20GND 21GND 22BOOT da placa: falarTela 4"ST7796320×480cartão SDSD_CSSD_SCKSD_MOSISD_MISOSDI / MOSISCKLEDCSDC / RSRESETSDO: não ligarT_…: não ligarVCCGNDLED220 Ω5V5V do pino 21 da esquerda até o VIN do amplificador3V3 do pino 1 da esquerda até o VDD do microfoneMicrofone INMP441SCKSDWSGNDL/RVDDVolume −Volume +Amplificador MAX98357ALRCBCLKDINGNDVINGAIN e SD: soltos+−alto-falante4 a 8 Ω

Arraste o desenho para o lado para ver tudo.

  • Tela
  • Cartão SD
  • Microfone
  • Amplificador
  • Botões e LED
  • 5V
  • 3V3
  • GND
Nos módulos, os pinos foram desenhados na ordem que deixa os fios retos. Na plaquinha de verdade a ordem pode ser outra: ligue sempre pelo nome escrito ao lado do pino.

Lista de fios: o que soldar onde

São 26 fios saindo da ESP32, cada um num pino diferente. Marque cada fio quando soldar; a página lembra o que você já marcou neste navegador.

Feito✓Pino do móduloLiga emOnde fica na ESP32
Tela ST7796fios de 14 cm
VCC3V3fileira esquerda, 2º pino
GNDGNDfileira esquerda, 22º pino (o último)
SDI / MOSIGPIO 8fileira esquerda, 12º pino
SCKGPIO 9fileira esquerda, 15º pino
LEDGPIO 10fileira esquerda, 16º pino
CSGPIO 11fileira esquerda, 17º pino
DC / RSGPIO 12fileira esquerda, 18º pino
RESETGPIO 13fileira esquerda, 19º pino
SDO / MISO e os pinos T_não ligardeixe sem fio
Cartão SD da telafios de 14 cm
SD_CSGPIO 4fileira esquerda, 4º pino
SD_SCKGPIO 5fileira esquerda, 5º pino
SD_MOSIGPIO 6fileira esquerda, 6º pino
SD_MISOGPIO 7fileira esquerda, 7º pino
Microfone INMP441fios de 10 cm
VDD3V3fileira esquerda, 1º pino (o primeiro)
GNDGNDfileira direita, 1º pino (o primeiro)
L/RGND do microfoneum fio curtinho até o pino GND do próprio microfone
SCKGPIO 42fileira direita, 6º pino
SDGPIO 41fileira direita, 7º pino
WSGPIO 40fileira direita, 8º pino
Amplificador MAX98357Afios de 10 cm
VIN5Vfileira esquerda, 21º pino
GNDGNDfileira direita, 21º pino
LRCGPIO 48fileira direita, 16º pino
BCLKGPIO 47fileira direita, 17º pino
DINGPIO 21fileira direita, 18º pino
+ e −alto-falanteos dois fios do alto-falante
GAIN e SDnão ligardeixe sem fio
Botões e LEDfios de 10 cm
Volume −, uma pernaGPIO 39fileira direita, 9º pino
Volume +, uma pernaGPIO 38fileira direita, 10º pino
LED, perna longa (+)GPIO 14fileira esquerda, 20º pino
LED, perna curta (−)resistor 220 Ωuma ponta do resistor
A outra perna dos dois botões e a outra ponta do resistorGNDsoldadas juntas, um fio só até a fileira direita, 22º pino (o último)
Botão BOOTnão ligarjá vem na placa: é o botão de falar
0 de 0 ligações feitas

Não use estes pinos para mais nada: GPIO 19 e 20 (USB), GPIO 35, 36 e 37 (presos na memória PSRAM) e TX e RX (porta serial). No desenho eles aparecem apagados.

Não troque BCLK com LRC no amplificador nem SCK com WS no microfone: qualquer uma dessas trocas deixa a Iara muda ou surda. O SD do amplificador fica solto; se for para o GND, ele desliga.

05

Peças para imprimir

Cinco peças. Todas as medidas estão em milímetros e já têm folga para o encaixe. Confira com a sua tela e a sua ESP32 antes de imprimir.

Como ler as medidas. O ponto zero é o canto de cima, à esquerda, olhando a Iara de frente. X cresce para a direita, Y cresce para baixo e Z é a profundidade, contada a partir da face da frente. As letras dos desenhos são as mesmas das tabelas.

1. Carcaça

1 peça78 × 172 × 29,5Imprima com a frente na mesa
Carcaça vista de frente, com cotasFrente da carcaça com a largura de 78 mm, a altura de 172 mm e a janela de 56 por 84 mm a 11 mm da lateral e 30 mm do topo.XY781723084581156ABCDI
Frente
Carcaça por dentro, com as peças internasEncaixe da tela, anel do alto-falante, os 4 pinos do suporte e as 4 torres dos parafusos da tampa.XYEFGH
Por dentro, com a frente transparente
Laterais da carcaça com cotasLateral esquerda com os dois furos dos botões e lateral direita com o rasgo do USB-C.621622IfrenteEsquerda272418,59JfrenteDireita
Laterais. Z conta a partir da face da frente
O quêMedidaOnde
Caixa (frente e laterais)78 × 172 × 29,5, cantos R8frente 2; laterais, topo e base 2,5
AJanela da tela56 × 84, cantos R1X 11 a 67; Y 30 a 114
BFuro do microfoneØ 3centro X 39; Y 10
CFuro do LEDØ 3,2centro X 20; Y 10
DGrade do alto-falante45 furos Ø 2,2, passo 4,5, dentro de Ø 36centro X 39; Y 148,5
EEncaixe da tela: 4 cantoneiras em Lbraços de 8, espessura 1,2, altura 4 (Z 2 a 6)contorno de dentro 62,5 × 109: X 7,75 a 70,25; Y 17,5 a 126,5
FAnel do alto-falanteØ 40,6 por dentro, parede 1,2, altura 3centro X 39; Y 148,5
G4 pinos do suporteØ 6 × 15 de altura (Z 2 a 17), furo Ø 2,1 × 10(14; 12), (64; 12), (10; 140), (68; 140)
H4 torres da tampaØ 8, até a borda (27,5 de altura), furo Ø 4 × 6 para o inserto(7; 7), (71; 7), (7; 165), (71; 165)
I2 furos dos botões, lateral esquerdaØ 4Y 62 e 78; Z 22
JRasgo do USB-C, lateral direita24 × 9, cantos R1,5Y 27 a 51; Z 18,5 a 27,5

A área que acende pode não estar no meio da placa da tela. Meça do topo da placa até onde começa a imagem e, se for diferente de 12,5 mm, ajuste o Y da janela A.

2. Suporte

1 peça70 × 142 × 2Imprima com os apoios para cima
Suporte interno com cotasPlaca de 70 por 142 mm com os furos de fixação, a área da ESP32, a área do amplificador, a abertura central, o rasgo dos fios da tela e o recorte do alto-falante.XY70142ESP32ampLMNOKP
Vista de frente. Os apoios K ficam virados para a tela; a ESP32 e o amplificador, tracejados, ficam atrás
O quêMedidaOnde
Placa70 × 142 × 2, cantos de cima recortados 8,5 × 8,5X 4 a 74; Y 4 a 146; fica em Z 17 a 19
K4 apoios da tela, na face da frenteØ 5 × 8,5(11,1; 40), (66,9; 40), (11,1; 104), (66,9; 104)
LAbertura central50 × 36X 14 a 64; Y 76 a 112
MRasgo de baixo, para os fios da tela54 × 7X 12 a 66; Y 116 a 123
NRecorte do alto-falantearco R 22centro X 39; Y 148,5
ORasgo de cima, para os fios do microfone, do LED e do SD38 × 6X 20 a 58; Y 17 a 23
P4 furos dos parafusosØ 2,8nos mesmos pontos dos pinos G
Área da ESP32, na face de trás70 × 26Y 26 a 52
Área do amplificador, na face de trás17 × 17X 30,5 a 47,5; Y 56 a 73

O suporte fica atrás dos pinos da tela, então não importa onde eles estão na sua tela. Só confira que nenhum pino passa de 9 mm para trás da placa da tela.

3. Tampa

1 peça78 × 172 × 2,5Imprima com a face de fora na mesa
Tampa de trás com cotasTampa de 78 por 172 mm com 4 furos escareados, 4 rasgos de ventilação e o ressalto de encaixe.XY78172QRS
Vista de trás. O ressalto T, tracejado, fica do lado de dentro
O quêMedidaOnde
Placa78 × 172 × 2,5, cantos R8mesmo contorno da caixa
Q4 furos escareadosØ 3,4, cabeça Ø 6,5 a 90°(7; 7), (71; 7), (7; 165), (71; 165)
R4 rasgos de ventilação30 × 2,5X 24 a 54; Y 32; 37; 42; 47
SRessalto: 4 trilhos na face de dentro1,2 de largura × 3 de alturaa 2,8 da borda; em cima e embaixo X 13 a 65; nas laterais Y 13 a 159

A tampa é simétrica: tanto faz olhar por dentro ou por fora.

4. Base de mesa

1 peça100 × 85,4 × 89,7Imprima com a placa na mesa
Base de mesa vista de lado, com cotasBase com um canal inclinado 15 graus para trás, uma aba baixa na frente, o encosto atrás e dois reforços laterais.Iara15°85,489,7TUVW
Vista de lado. A Iara entra no canal T com a tela para a frente
O quêMedidaOnde
Placa de baixo100 × 85,4 × 5, cantos R8é ela que apoia na mesa
TCanal da Iara33 entre a aba e o encosto (a Iara tem 32)inclinado 15° para trás; berço de 60 de largura; o fundo da Iara fica a 16 da mesa
UAba da frente3 de espessura, 6 de altura acima do assentofica abaixo da grade do alto-falante
VEncosto5 de espessura, 85 de altura acima do assentoapoia a tampa, abaixo dos rasgos de ventilação
W2 reforços laterais8 de largura cadasobem até 55 no encosto; o meio fica vazado
Altura total89,7com a Iara encaixada: 182 de altura

A base não prende na Iara: ela fica no canal pelo próprio peso, encostada no encosto V. O centro de massa da Iara cai bem no meio da placa de baixo, então ela não tomba para trás nem para a frente.

5. Botões

2 peçasImprima com a aba na mesa
Botão impresso visto de ladoPino de 3,6 mm de diâmetro e 4 mm de comprimento com uma aba de 6 mm de diâmetro e 1 mm de espessura.14Ø 6Ø 3,6dentrofora
Visto de lado
O quêMedidaOnde
2 botões iguaishaste Ø 3,6 × 4; aba Ø 6 × 1a aba fica do lado de dentro

A haste atravessa a parede de 2,5 mm e fica 1,5 mm para fora. A aba encosta no botão tátil por dentro.

Antes de imprimir, meça com paquímetro: a placa da tela (61,74 × 108,04 mm na maioria dos modelos), a área que acende (55,68 × 83,52), a ESP32 (tem que caber em 70 × 26), o alto-falante (40 mm) e os insertos. Se alguma medida for diferente, ajuste a peça antes.

Teste barato: imprima primeiro a moldura iara-teste-encaixe.stl, que é só a frente com as cantoneiras. Em menos de uma hora você confere se a tela entra e se a imagem fica centralizada na janela.

Arquivos para imprimir. O pacote iara-caixa-v0.4-stl.zip tem as 5 peças em STL, com a base de mesa, já deitadas na posição de impressão, a moldura de teste, uma prévia em imagem e um LEIA-ME para quem vai imprimir. Foram gerados com as mesmas medidas desta seção.

06

Solda e teste

Solde e teste tudo fora da caixa, em cima da mesa. Só depois que a Iara funcionar aberta, passe para a montagem na caixa.

Cuidados

  • Fios curtos nos GPIO 8 e 9 da tela. Com fio longo a imagem sai com listras ou a tela fica branca.
  • L/R do microfone vai no GND. O firmware escuta pelo canal esquerdo.
  • O alto-falante vai no + e − do amplificador, nunca no GND.
  • VDD do microfone e VCC da tela no 3V3, nunca no 5V. Só o amplificador vai no 5V.
  • Junte todos os GND. Sem terra comum, nada funciona direito.
07

Montagem na caixa

Com as peças impressas e a eletrônica testada. As letras em negrito são as das tabelas da seção 5.

08

Personagem e vídeos

A Iara é quem você desenhar. O jeito mais fácil e grátis é o VRoid Studio, que monta uma personagem 3D de corpo inteiro sem precisar saber modelar.

  1. Baixe o VRoid Studio (grátis, para Windows e Mac) e crie um modelo novo feminino.
  2. Ajuste rosto, cabelo e corpo. Para a roupa, uma camisa clara com blazer ou colete já passa a ideia de atendente.
  3. Exporte em formato VRM (Arquivo, Exportar como VRM). Esse arquivo .vrm é tudo o que o gerador de vídeos precisa.

Pense na tela pequena. São 320 × 480 pontos: cores chapadas e contraste forte aparecem melhor que detalhes finos.

Os vídeos em breve

O gerador vai ser uma página no navegador: você carrega o arquivo .vrm, escolhe as animações de cada estado e baixa os vídeos prontos, no tamanho e no formato que a placa lê.

ArquivoQuando tocaDuração
parada.mjpegEnquanto espera alguém chamar. Respira, pisca, mexe um pouco o peso do corpo.4 a 6 s em loop
oi.mjpegUma vez, quando ela acorda com a palavra de ativação. Um aceno.2 s
ouvindo.mjpegEnquanto você fala. Cabeça inclinada, atenção.2 a 3 s em loop
pensando.mjpegEntre você parar de falar e a resposta chegar.2 a 3 s em loop
falando.mjpegEnquanto a voz sai no alto-falante. Boca e gestos.2 a 3 s em loop
Tamanho
320 × 480, em pé
Quadros
12 por segundo
Fundo
Preto
Formato
MJPEG
Pasta no cartão
/iara
Boca
Na primeira versão não acompanha cada sílaba

A ESP32-S3 decodifica MJPEG a uns 15 quadros por segundo em 480 × 272. Na tela de 4" a meta é 12, que basta para ela respirar e se mexer de forma natural.

09

Firmware em breve

Quando o arquivo sair, a gravação é pelo navegador, sem instalar nada. Precisa do Chrome ou do Edge num computador.

  1. Ligue a ESP32-S3 no computador pelo cabo USB-C, na porta marcada USB (não a UART).
  2. Abra espressif.github.io/esptool-js, a ferramenta oficial da Espressif para gravar a placa.
  3. Clique em Connect e escolha a porta da placa. Se ela não aparecer: segure BOOT, aperte RESET, solte o BOOT e tente de novo.
  4. Na primeira vez, clique em Erase Flash e espere terminar.
  5. Em Flash Address digite 0x0 e escolha o arquivo .bin.
  6. Clique em Program. Quando terminar, aperte RESET na placa.

Pela linha de comando

pip install esptool
esptool --chip esp32s3 -b 460800 write-flash 0x0 iara-esp32s3-4pol.bin

Copiar os vídeos

  1. Formate o cartão microSD em FAT32. Cartões acima de 32 GB vêm em exFAT e não funcionam.
  2. Crie uma pasta iara na raiz e copie os cinco arquivos .mjpeg para dentro, com os nomes da tabela da seção 8.
  3. Coloque o cartão na entrada atrás da tela antes de ligar a placa. Ele só sai de novo com a caixa aberta.

Na caixa, a tela vai montada com os pinos para baixo. O firmware da Iara já gira a imagem para esse lado.

10

Primeiro uso

A Iara te guia pela tela em dois passos, do mesmo jeito que outros aparelhos baseados no XiaoZhi.

Rede: Iara-XXXX
Passo 1 de 2

Conectar no Wi-Fi

Aponte a câmera do celular para o QR code. O celular entra na rede da Iara e abre a página de configuração. Escolha o seu Wi-Fi, digite a senha e toque em Conectar.

Se a página não abrir, entre em http://192.168.4.1. A rede tem que ser de 2,4 GHz.

123456
Cadastre em xiaozhi.me
Passo 2 de 2

Cadastrar a Iara

Ela fala e mostra um código de 6 dígitos. Entre em xiaozhi.me, faça login, toque em Adicionar dispositivo e digite o código.

Se for usar o servidor no seu PC (seção 11), o cadastro é feito no painel dele.

"Iara"Palavra de ativação. Diga para ela começar a escutar.
Botão BOOTUm toque para falar ou para interromper a resposta.
Volume + e −Um toque muda um pouco. Segure para o máximo ou para o mudo.
Trocar de Wi-FiAperte RESET e logo em seguida BOOT. O passo 1 aparece de novo.

Com a caixa fechada, o BOOT e o RESET ficam lá dentro. Por isso a palavra "Iara" é o jeito normal de chamar; os botões da placa servem para a configuração, com a tampa aberta.

11

Voz em português

A placa só grava e toca o áudio. Quem entende o que você disse e gera a resposta é o servidor. Escolha um dos dois caminhos.

xiaozhi.me

Mais fácil, sem instalar nada

É o serviço padrão do firmware. No painel você escolhe a voz, o idioma e a personalidade. Confira se há voz em português do Brasil entre as opções antes de decidir.

O serviço é de terceiros e roda fora do Brasil.

Servidor no seu PC

Mais controle, voz brasileira garantida

O xiaozhi-esp32-server é aberto e tem documentação em português. A voz padrão é o Edge TTS, da Microsoft, que tem vozes brasileiras como a pt-BR-FranciscaNeural.

Você escolhe o modelo de IA e paga só o que usar dele. O firmware da Iara vai ter um campo na página de Wi-Fi para o endereço do seu servidor.

Personalidade de exemplo

Cole isto no campo de personalidade (prompt) do servidor que você escolher e ajuste do seu jeito:

Você é a Iara, uma atendente virtual simpática e direta.
Fale sempre em português do Brasil, de forma natural.
Responda em no máximo duas ou três frases, porque sua
resposta vai ser falada em voz alta.
Não use emojis, listas, asteriscos nem formatação.
Se não souber alguma coisa, diga que não sabe.
12

Problemas

Quase todo problema é fio trocado ou mal soldado. Comece por aqui.

Não sai som nenhum
  • Confira BCLK no GPIO 47, LRC no GPIO 48 e DIN no GPIO 21, sem inverter.
  • VIN do amplificador no 5V e GND dele no GND da placa.
  • O pino SD do amplificador tem que ficar solto.
  • Suba o volume pelo botão ou dizendo "aumenta o volume".
Ela não me ouve ou não reage ao "Iara"
  • Confira SCK no GPIO 42, WS no GPIO 40 e SD no GPIO 41.
  • L/R do microfone no GND e VDD no 3V3 (não no 5V).
  • Na caixa, veja se o furinho do microfone está alinhado com o furo B e se a fita de espuma não tampou o furo.
  • Fale a menos de um metro, sem muito barulho em volta.
A tela fica preta
  • Confira LED no GPIO 10 e VCC no 3V3. Sem o LED ligado, a tela funciona mas fica apagada.
  • Confira CS no GPIO 11, DC no GPIO 12 e RESET no GPIO 13.
A tela fica branca, com listras ou com cores trocadas
  • Listras e chiado: encurte os fios dos GPIO 8 e 9.
  • Cores trocadas ou imagem deslocada: a sua tela é de outro modelo. Confira se o chip é mesmo o ST7796.
O vídeo não aparece ou diz que não achou o cartão
  • Confira SD_CS no GPIO 4, SD_SCK no 5, SD_MOSI no 6 e SD_MISO no 7.
  • O cartão tem que estar em FAT32. Acima de 32 GB, formate de novo.
  • Os vídeos ficam na pasta iara, com os nomes exatos da seção 8.
O vídeo engasga ou fica lento
  • Use um cartão classe 10 ou U1, no mínimo.
  • Gere de novo com 10 quadros por segundo ou com qualidade de imagem menor.
A página do Wi-Fi não aparece ou não conecta
  • Conecte na rede "Iara-XXXX" na mão e abra http://192.168.4.1.
  • Se o celular perguntar se quer continuar numa rede sem internet, diga que sim. Desligue os dados móveis se a página não carregar.
  • Só funciona em 2,4 GHz. Se o roteador tem uma rede só, ative a faixa de 2,4 GHz nele.
O computador não reconhece a placa
  • Troque o cabo: muitos cabos USB-C só carregam.
  • Use a porta USB nativa da placa (marcada USB), não a UART.
  • Entre no modo de gravação: segure BOOT, aperte RESET e solte o BOOT.
A tela não entra no encaixe, ou fica solta
  • Não entra: a sua tela é um pouco maior ou o filamento encolheu diferente. Lixe o lado de dentro das cantoneiras E, sem pressa.
  • Fica solta: cole um pedaço de fita de espuma em cada apoio K do suporte.
  • Imagem fora do centro da janela: meça a sua tela e ajuste a posição da janela A antes de imprimir de novo.
A tampa não fecha direito
  • Algum fio está passando por cima da ESP32. Dobre a sobra para os lados, atrás do suporte.
  • Um inserto ficou saltado da torre. Aqueça de novo e empurre até ficar rente.
  • A fita da ESP32 está grossa demais. Use fita de 1 mm.
  • O ressalto T está pegando: lixe um pouco por fora.
O botão de volume não clica ou fica preso
  • Preso: passe uma broca de 4 mm no furo I.
  • Não clica: o botão tátil está longe da aba. Cole de novo encostado, com mais cola quente atrás.
Ela fica frouxa ou balança na base
  • Frouxa no canal: cole uma tira de fita de espuma no encosto V.
  • A base escorrega na mesa: cole os 4 pezinhos de silicone embaixo.
  • Balança quando você aperta o volume: segure com o polegar do outro lado, ou peça para ela "aumentar o volume".