O SDK no ESP8266
A mesma biblioteca e a mesma API (DevUI.h) rodam no ESP8266 com 4 MB de flash, pelo core Arduino 3.1.2 do ESP8266 (Arduino IDE: o pacote de placas "esp8266" 3.1.2; PlatformIO: platform = espressif8266). O exemplo é o Hello8266; Ola, Formulario e Painel usam FreeRTOS e são só do ESP32. O detalhe medido (memória, pilha do BearSSL, tempos do loop()) está no README da biblioteca Arduino, na seção "ESP8266".
Do zero ao eco na página: o README do Hello8266 tem o caminho inteiro, pelo PlatformIO (o platformio.ini, pio run, pio run -t upload -t monitor) ou pelo Arduino IDE (a URL do pacote de placas), com a serial a 115200 e o pareamento. A biblioteca que python tools/pack_arduino.py <pasta> monta já aponta para a nuvem de produção (gw.thingface.com:443) com as raízes que o gateway dela apresenta; não é preciso CMake.
O que muda em relação ao ESP32
| ESP32 e família (ESP-IDF ou Arduino) | ESP8266 (perfil "8266") | |
|---|---|---|
| Abas ao mesmo tempo | até 4 (padrão, DEVUI_RX_MAX_SESSIONS) | até 4 |
| Mensagem, nos dois sentidos | até 4.096 B recebidos; enviada, até o tamanho da fila do SDK (Limites) | até 1 KB (o send acima de 1.014 B responde ESP_ERR_INVALID_SIZE; a lib recusa acima de 1 KB com TOO_LARGE) |
| Ordens de confiança assinadas (troca de endpoint, raízes, chaves) | sim, com o tratador do TRUST_ORDER | não: a ordem é registrada no log e descartada; trocar endpoint ou CA pede regravar a placa |
| Chave do dispositivo | NVS (partição devui), protegida pela criptografia da flash em produção | setor fixo da flash (0x3FA000); o ESP8266 não tem secure boot nem criptografia de flash |
| Onde o SDK roda | task própria | na thread do sketch, depois de cada loop() e dentro de delay()/yield() |
Diagnóstico no HELLO | motivo da última queda; sinal do Wi-Fi (menos na P4) | os dois |
| Modo local (a interface na rede local) | sim, no ESP-IDF com CONFIG_DEVUI_LOCAL (Modo local); não na biblioteca Arduino | não: local() responde ESP_ERR_NOT_SUPPORTED |
| Fila de inserções do banco sem nuvem | na RAM ou na NVS (DEVUI_DB_QUEUE_FLASH, até 2.048 B) | só na RAM: DEVUI_DB_QUEUE_FLASH responde ESP_ERR_NOT_SUPPORTED, e um reinício perde o que esperava |
| Pedido ao banco, em JSON | até 4.083 B (Banco de dados) | até 1.011 B (983 B para a inserção da fila) |
| Atualização remota de firmware (OTA) | por HTTPS, no slot inativo, com volta automática se a imagem nova falhar | pela própria conexão do SDK, no espaço livre abaixo do sistema de arquivos (não no layout 4m3m), sem volta automática e com placa-piloto antes da frota |
A nuvem aprende cada limite na conexão; o resto é igual.
Regras de uso
- Nada a chamar no
loop(). O SDK roda sozinho a cada volta doloop(), no máximo a cada 10 ms. Os callbacks rodam ali também: curtos, sem bloquear. - A API só na thread do sketch:
setup(),loop(), os callbacks do SDK,schedule_functionouTicker::attach_scheduled. Chamada do contexto do sistema (um evento de Wi-Fi, umTickercomattach) é recusada comESP_ERR_INVALID_STATE, sempre, com um aviso na serial. - 160 MHz recomendado, não exigido: a 80 MHz funciona, mas cada abertura segura o sketch o dobro (~2 s em vez de ~1 s, o passo do TLS que não se corta).
- Layout da flash com sistema de arquivos (o padrão das placas de 4 MB): o porte recusa um layout sem ele, porque a chave mora no setor 0x3FA000.
- Uma segunda conexão TLS validada da aplicação (um
WiFiClientSecurecom cadeia P-384) não cabe junto com o SDK online: a memória livre online fica em ~16 KB.
O que ele tem a menos em segurança
- Sem secure boot e sem criptografia da flash: a chave do dispositivo fica legível na flash para quem tem a placa na mão (o setor 0x3FA000, acima).
- Sem ordens de confiança: trocar de nuvem ou de raízes pede gravar a placa de novo (a tabela acima).
- CVE-2020-12638 (Wi-Fi rebaixado para rede aberta), sem correção no core 3.1.2. Um beacon forjado faz o ESP8266 (o NONOS SDK até a 3.0.3; o core 3.1.2 usa por padrão o 2.2.x de 190703, no Arduino IDE e no PlatformIO) entrar numa rede WPA2 como se ela fosse aberta, e quem está no rádio passa a ver o tráfego da placa. Aceito como mitigado pelo TLS de ponta a ponta (decisão de 24/10/2026): o canal com a nuvem é TLS (BearSSL, com as raízes fixadas no firmware e a cadeia do gateway verificada), então do tráfego do SDK quem está no rádio vê só o TLS. O que o sketch servir na rede local por conta própria (um
ESP8266WebServer, mDNS, HTTP sem TLS) fica exposto como num Wi-Fi aberto. O registro técnico está na auditoria manual das dependências do ESP8266.
Memória, num app real
Medido em 18/10/2026 num termostato real (ESP8266EX a 160 MHz, core 3.1.2):
| Heap livre | |
|---|---|
antes do DevUI.begin (o app, Wi-Fi no ar) | 39,2 a 39,4 KB |
| online, de 0 a 4 abas | 16,4 a 16,9 KB |
| o mais baixo, na abertura (o handshake TLS) | 9,6 a 9,8 KB |
| o mais baixo, com 4 abas a 5 mensagens por segundo | 10,0 a 10,2 KB |
Na flash, o SDK ocupa ~120 KB e ~1,8 KB de RAM estática; a interface fica na flash (PROGMEM).
Na verificação
O pacote Arduino é compilado no core ESP8266 3.1.2 de verdade a cada mudança que o toca (tools/check_registries.py --so arduino8266), com o controle de uma chamada que a API não tem reprovando.
