Comando CFW — DFOTA do Modem
Atualiza de forma remota o firmware do modem celular (DFOTA) baixando um pacote delta, com telemetria de fase e progresso.
Para que serve?
📡 Casos de uso principais:
- ⬆️ Atualizar o firmware do modem celular em campo, sem acesso físico
- 🌐 Corrigir compatibilidade de rede ou operadora via update remoto
- 📊 Monitorar a fase e o progresso de uma atualização em curso
- 🏭 Forçar um update em bancada de testes ignorando a verificação de bateria
O DFOTA atualiza o firmware do modem, não o firmware de aplicação do equipamento. É uma operação crítica: uma interrupção no meio do flasheo pode deixar o modem inutilizável, por isso o equipamento exige bateria FULL salvo override explícito.
Comandos
| Operação | Sintaxe | Resposta |
|---|---|---|
| Disparar DFOTA | SCFW"<url>.pack" | RCFW OK / RCFW ERR-… |
| Forçar (sem brick-guard) | SCFW^"<url>.pack" | RCFW OK / RCFW ERR-… |
| Consultar estado | QCFW | RCFW<fase>,<pct> |
Disponível desde o firmware v1.09.24.
SCFW — Disparar o update
SCFW"<url>.pack"
SCFW^"<url>.pack"- A URL deve começar com
http,httpsouftp. As aspas são opcionais. - O prefixo
^força o update pulando o brick-guard de bateria (pensado para bancada de testes). Sem^, o equipamento exige bateria FULL. - O pacote é um delta direcional com formato de nome
<from>-<to>: é aplicado sobre uma versão de origem específica para levar o modem a uma versão destino.
Internamente o equipamento lança o update apenas com contexto de dados ativo e monitora o progresso por meio de notificações do modem.
Respostas do SCFW
| Resposta | Significado |
|---|---|
RCFW OK | Update enfileirado corretamente |
RCFW ERR-URL | A URL não começa com http/https/ftp |
RCFW ERR-CONN | Modem não conectado (sem contexto de dados ativo) |
RCFW ERR-BAT | Bateria não está FULL (usar ^ para forçar) |
RCFW ERR-BUSY | Já há um DFOTA em curso |
RCFW ERR-MEM | Sem memória para armazenar a URL |
Exemplos
// Disparar um update normal (exige bateria FULL)
>SCFW"http://fota.rinho.com.ar/dfota/v1-v2.pack"<
>RCFW OK<
// Forçar em bancada, ignorando a verificação de bateria
>SCFW^"http://fota.rinho.com.ar/dfota/v1-v2.pack"<
>RCFW OK<
// URL inválida
>SCFWfota.rinho.com.ar/v1-v2.pack<
>RCFW ERR-URL<QCFW — Consultar fase e progresso
QCFWResposta
RCFW<fase>,<pct>| Fase | Estado | Descrição |
|---|---|---|
0 | Idle | Sem DFOTA em curso |
1 | Pedido | Update enfileirado, aguardando disparo |
2 | Baixando | Baixando o pacote .pack |
3 | Atualizando | Aplicando o delta ao modem |
4 | OK | Última atualização finalizada corretamente |
5 | Erro | Última atualização finalizada com erro |
O campo <pct> (3 dígitos, 000-100) indica o progresso da fase de atualização. A fase é preservada após terminar, de modo que QCFW permite consultar o resultado do último update remotamente.
Exemplos
// Consulta durante o download
>QCFW<
>RCFW2,045< // fase 2 (baixando), 45%
// Consulta com o update finalizado
>QCFW<
>RCFW4,100< // fase 4 (OK), 100%
// Consulta sem update em curso
>QCFW<
>RCFW0,000< // idle