Gravando modelos de IA no SenseCAP Watcher
Visão geral
Agradecimentos especiais ao XiaoZhi AI Chatbot por suas contribuições de código aberto que tornaram este projeto possível.
Este guia se concentra em como gravar no SenseCAP Watcher o firmware de Conversação Acionada por Reconhecimento Visual e como substituir ou atualizar o modelo de IA no dispositivo. Ele é destinado como um guia prático e instrucional para essas operações.
Para uma introdução completa aos recursos, aplicações e casos de uso do Watcher, consulte: SenseCAP Watcher - AI Assistant that actively interacts with the world
Pré-requisitos
Hardware necessário
- Dispositivo SenseCAP Watcher
- Cabo de dados USB Tipo-C
- PC com Windows
Se você estiver gravando o Visual Activation Firmware e o modelo do seu dispositivo Watcher não for -EN, você também precisará gravar manualmente o arquivo de autenticação para uso normal (necessário apenas uma vez).
Para instruções detalhadas, consulte o Watcher Agent Firmware Flashing Guide.
Processo de gravação de firmware
- SenseCraft AI
- Flash Download Tool
- Command Line
- Compile from Source (For Developers)
Pré-requisitos
Passo 1. Acesse o workspace do SenseCAP Watcher via SenseCraft AI > Models > Workspace > SenseCAP Watcher, ou use este link direto para o workspace.

Passo 2. Conecte-se à nossa plataforma pela porta serial
-
Clique em
Connect
-
Selecione a porta serial correta (terminando com “A”)

Se você estiver usando macOS ou Linux, escolha a porta com o número menor.
-
Clique em
Connect
Passo 3. Verifique e atualize a versão do dispositivo
-
Clique em
Update
-
Selecione a porta serial correta (terminando com "B")
notaSe você estiver usando macOS ou Linux, escolha a porta com o número maior.


-
Clique em 'Connect'

-
Selecione a versão que você deseja gravar e clique em
Confirm
-
Aguarde o processo de atualização e reinicialização

Pré-requisitos
-
Visual Trigger Firmware v2.0.4: Download Link
-
Flash Download Tool (3.9.6 ou superior)
Passo 1. Conecte-se ao dispositivo (porta Type-C na parte inferior do dispositivo) e abra o seu Flash Download Tool

Passo 2. Configure as definições de firmware

Passo 3. Selecione a porta COM e as configurações de gravação

-
Se a gravação não iniciar após clicar em START, clique em STOP e confirme se você selecionou a porta COM terminando com “B”.

Passo 4. Apagar e gravar
- Clique no botão
ERASEpara limpar o firmware existente - Aguarde a conclusão do processo de apagamento
- Clique no botão
STARTpara iniciar a gravação - Você deverá ver informações de progresso na janela de log
- Se nenhum progresso aparecer ou falhar, tente a outra porta COM
Passo 5. Verificar sucesso
-
O processo de gravação estará completo quando você vir a mensagem de sucesso na janela de log.

Passo 6. Reinicie o dispositivo
- Localize o orifício de reset no seu dispositivo Watcher
- Use um pino para pressionar suavemente o botão de reset
- O dispositivo será reiniciado com o novo firmware

-
Pré-requisitos
-
Visual Trigger Firmware v2.0.4: Download Link
-
Passo 1. Extraia o pacote de firmware baixado e use o esptool.py para realizar a gravação
esptool.py -p /dev/ttyACM0 -b 2000000 write_flash 0 merged-binary.bin
(Observação: ajuste a porta /dev/ttyACM0 de acordo com o seu sistema, por exemplo, COM3 no Windows)
Passo 2. Reinicie o dispositivo
- Localize o orifício de reset no seu dispositivo Watcher
- Use um pino para pressionar suavemente o botão de reset
- O dispositivo será reiniciado com o novo firmware

Passo 1. Abra o ESP-IDF CMD e navegue até a pasta do projeto
cd xiaozhi-esp32
Passo 2. Defina o chip de destino
idf.py set-target esp32s3
Passo 3. Abra o menu de configuração
idf.py menuconfig
Passo 4. Defina o tipo de placa como SenseCAP Watcher
-
Selecione o Xiaozhi Assistant

-
Selecione o tipo de placa

-
Selecione SenseCAP Watcher

Passo 5. Configure definições adicionais de acordo com suas necessidades (opcional)
-
Idioma padrão de exibição e AEC (Cancelamento Automático de Eco / tratamento de interrupção de voz)

-
Palavras de ativação e gatilhos


-
Outros parâmetros opcionais específicos para a sua aplicação
-
Após concluir a sua configuração, salve e saia do menu
Passo 7. Compile e grave o firmware
idf.py build flash
Somente firmware na versão 1.8.8 ou superior oferece suporte à funcionalidade de despertar visual. Firmware acima da versão v2.0.3 exige dizer “Turn on the inference switch” para Xiaozhi para habilitar a detecção visual.
Processo de gravação do modelo de IA
-
Pré-requisitos
Passo 1. Acesse o workspace do SenseCAP Watcher via SenseCraft AI > Models > Workspace > SenseCAP Watcher, ou use este link direto para o workspace.

Passo 2. Conecte à nossa plataforma pela porta serial
-
Clique em
Connect
-
Selecione a porta serial correta (terminando com “A”)

Se você estiver usando macOS ou Linux, escolha a porta com o número menor.
-
Clique em
Connect
Passo 3. Ver o modelo existente e trocar para um novo modelo
-
Ver o nome do modelo e a versão do modelo

-
Clique em
Select Model...e clique no modelo que você deseja gravar
-
Clique em
Confirm
Passo 4. Visualizar o efeito e ajustar o parâmetro

A função atual de despertar visual oferece as seguintes opções de configuração:
- ID do alvo (
target): Especifica o ID do alvo a ser detectado. Esse ID depende do modelo visual usado; o valor padrão é 0. - Duração da detecção (
duration): A unidade é segundos, usada para ajustar a sensibilidade do despertar visual. O padrão é 1 segundo (esse padrão não inclui o processamento de debounce de 1 segundo). - Limite de confiança (
threshold): O limite inferior de confiança para o modelo visual reconhecer um objeto, usado para ajustar a sensibilidade da detecção. Representado como uma porcentagem, o padrão é 75%. - Período de resfriamento (
interval): A unidade é segundos, indicando o tempo de espera necessário após o término de uma conversa antes de disparar novamente, usado para evitar interrupções frequentes pelo mesmo objeto. O padrão é 8 segundos.
Por exemplo, você pode ajustar a sensibilidade do modelo modificando o parâmetro threshold. Se você achar que o limite atual está muito rigoroso, basta dizer ao Watcher: "Please set the confidence threshold to 60%".
Solução de problemas
Problemas comuns
-
Nenhuma porta COM detectada
- Certifique-se de que você está usando a porta Type-C inferior
- Tente usar um cabo USB diferente
- Verifique se os drivers USB estão instalados corretamente
-
Falha ao gravar
- Ao gravar o Himax, selecione a porta COM terminando com “A”.
- Ao gravar o ESP32-S3, selecione a porta COM terminando com “B”.
-
Dispositivo não responde
- Use um pino para pressionar suavemente o botão de reset
- Tente apagar antes de gravar
-
O dispositivo não desperta com detecção visual
- Verifique se há mensagens de log relevantes na saída serial.
- A versão de firmware v2.0.3 exige dizer “Turn on inference switch” para Xiaozhi para habilitar essa função.
-
A porta serial mostra logs de reconhecimento visual, mas o dispositivo ainda não consegue despertar
- Vá para a plataforma SenseCraft AI e grave o modelo Person no chip de IA.
FAQ
P: Posso gravar outros modelos de IA no Himax?
R: Atualmente, apenas os modelos Face e Person são suportados. Gravar outros modelos ainda não é suportado e estará disponível em uma atualização futura.