Compilar, gravar e monitorar a saída serial¶

Esta página apresenta o fluxo diário de trabalho com o SiFli-SDK: ativar o ambiente, compilar com scons, gravar o firmware na placa e acompanhar os logs.

Ativar o SDK¶

Instale o ambiente do SDK seguindo o guia oficial de instalação correspondente à sua versão. Antes de compilar, ative-o em cada novo terminal executando o script de exportação na raiz do SDK:

cd ~/OpenSiFli/SiFli-SDK
. ./export.sh

cd C:\OpenSiFli\SiFli-SDK
.\export.ps1

O script de exportação carrega no terminal atual o ambiente correspondente à cópia do SDK em uso. As etapas de instalação e gerenciamento podem variar conforme a versão; consulte o guia oficial correspondente.

Compilar¶

No diretório do projeto de exemplo, execute:

scons --board=<board_name> -j8

Escolha um valor de -j adequado à capacidade da máquina. Se o nome da placa não especificar o núcleo, o SDK selecionará HCPU por padrão. Por exemplo, sf32lb52-lcd_n16r8 gera build_sf32lb52-lcd_n16r8_hcpu/. Use o diretório de saída correspondente à combinação de placa e núcleo definida pelo SDK; se o identificador da placa já especificar um núcleo, não acrescente _hcpu novamente.

Compilação limpa¶

Faça uma limpeza seguida de nova compilação ao trocar de placa, alterar configurações importantes ou investigar um artefato suspeito. No diretório do projeto de exemplo, use a opção de limpeza do SCons:

scons -c

Esse comando limpa os alvos de compilação e remove os arquivos temporários e os arquivos de objeto gerados. Em seguida, compile novamente com a configuração de placa pretendida.

Gravar o firmware¶

Por exemplo, para o destino HCPU de sf32lb52-lcd_n16r8, use o script de download UART gerado pela compilação:

./build_sf32lb52-lcd_n16r8_hcpu/uart_download.sh

build_sf32lb52-lcd_n16r8_hcpu\uart_download.bat

O projeto OpenSiFli também publica o sftool, um utilitário de linha de comando de código aberto para comunicação com SoCs SiFli por uma interface serial. As operações documentadas incluem gravar, ler e apagar a memória flash, além de controlar a reinicialização do chip. Consulte o README da ferramenta para saber quais chips e tipos de armazenamento são suportados e quais opções de comando estão disponíveis.

Acompanhar a saída serial¶

Use um terminal serial configurado para a placa e o exemplo. O log serial deve exibir a saída de boot, as mensagens de inicialização do RT-Thread, mensagens da aplicação ou o prompt do shell.

Registre:

• Nome da placa.
• Porta serial.
• Taxa de transmissão (baud rate).
• Comando de compilação.
• Comando de gravação.
• Branch ou versão do SDK.

Ciclo diário de desenvolvimento¶

Comece por um exemplo correspondente¶

Antes de criar um projeto ou reformulá-lo substancialmente, escolha o exemplo do SDK que melhor corresponda à placa e ao subsistema crítico. Primeiro compile, grave e acompanhe a saída serial do exemplo sem alterações; em seguida, registre no projeto adaptado o nome da placa, a versão do SDK, os comandos e a saída esperada.

Se usar o CodeKit, mantenha os mesmos registros de validação e confirme que as ações realizadas no editor podem ser reproduzidas pelo fluxo de comandos do SDK.

Solução de problemas¶

Checklist para a transição¶

Antes de entregar o projeto a outro desenvolvedor, inclua:

• Branch ou commit do SDK.
• Nome da placa.
• Instruções de instalação e configuração.
• Comando de compilação.
• Comando de gravação.
• Configuração do monitor serial.
• Primeiras linhas de log esperadas.
• Comando de recuperação.

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