Pular para o conteúdo
ThingFace

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 tempoaté 4 (padrão, DEVUI_RX_MAX_SESSIONS)até 4
Mensagem, nos dois sentidosaté 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_ORDERnão: a ordem é registrada no log e descartada; trocar endpoint ou CA pede regravar a placa
Chave do dispositivoNVS (partição devui), protegida pela criptografia da flash em produçãosetor fixo da flash (0x3FA000); o ESP8266 não tem secure boot nem criptografia de flash
Onde o SDK rodatask própriana thread do sketch, depois de cada loop() e dentro de delay()/yield()
Diagnóstico no HELLOmotivo 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 Arduinonão: local() responde ESP_ERR_NOT_SUPPORTED
Fila de inserções do banco sem nuvemna 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 JSONaté 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 falharpela 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 do loop(), 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_function ou Ticker::attach_scheduled. Chamada do contexto do sistema (um evento de Wi-Fi, um Ticker com attach) é recusada com ESP_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 WiFiClientSecure com 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 abas16,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 segundo10,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.