Ferramentas¶

Desenvolver para SF32 exige mais do que um compilador. Um fluxo prático também envolve ferramentas para gravação, monitoramento serial, análise de falhas, captura de traces, conversão de imagens, ajuste de RF/áudio e programação na fábrica.

A tabela abaixo relaciona tarefas comuns às ferramentas correspondentes. Ela serve como orientação e não substitui os manuais; consulte a documentação vinculada para instruções de instalação, comandos exatos e procedimentos específicos de cada ferramenta.

Visão geral das ferramentas¶

Ferramentas de gravação¶

No primeiro bring-up, use os scripts UART gerados pelo SDK: eles correspondem à compilação que você acabou de fazer. Inclua o sftool quando precisar de:

• Uma ferramenta de linha de comando consistente para gravar firmware em diferentes fluxos de trabalho.
• Integração com west flash do Zephyr.
• Suporte ao processo de upload do ArduinoCore-zephyr.
• Automação em CI, na fábrica ou em testes de regressão.

Mantenha os dois métodos documentados no projeto até que a equipe adote um padrão único.

Ferramentas de logs e traces¶

Para o desenvolvimento cotidiano, um terminal serial costuma bastar. Diante de falhas graves, capture logs estruturados e dados da falha:

• Salve o log completo de inicialização, desde o reset.
• Guarde os arquivos ELF, map e de símbolos que correspondam exatamente à imagem gravada.
• Registre se estavam ativos o shell do RT-Thread, o shell do Zephyr ou o modo de depuração do Arduino.
• Quando disponíveis, use as ferramentas de diagnóstico da SiFli para analisar dumps de asserção e capturar traces.

Ferramentas para recursos gráficos e produção¶

Produtos com uso intensivo de recursos gráficos devem documentar o processo de conversão desses recursos, sobretudo quando usam compressão eZip ou aceleração gráfica por hardware. Em produtos destinados à fabricação, documente as ferramentas de RF, áudio e produção separadamente das ferramentas de gravação usadas pelos desenvolvedores, para que a equipe da fábrica não dependa de comandos exclusivos do ambiente de desenvolvimento.

Checklist para escolher ferramentas¶

Recomendações práticas¶

• Aprenda a usar um método confiável de gravação antes de adicionar outro.
• Guarde logs seriais de referência, comprovadamente funcionais, para cada placa.
• Use os scripts gerados pelo SDK no primeiro bring-up.
• Use sftool quando precisar repetir a gravação pela linha de comando em fluxos Zephyr, Arduino ou automatizados.
• Adote ferramentas de análise de falhas antes de encontrar um problema difícil de reproduzir.

Última atualização: 2026-10-21