Limites e números medidos
Os limites que o protocolo e a nuvem impõem, e o que o SDK custa numa placa, medido. Cada número traz a base: um limite vem da especificação devui.1 ou da nuvem; um número medido diz quando e em quê.
Mensagens
| Limite | Padrão | Quem fixa |
|---|---|---|
| Quadro recebido pela placa | 1.024 B, com o cabeçalho | a placa (MAX_RX_FRAME) |
| Mensagem recebida pela placa | 4.096 B | a placa (MAX_RX_MSG) |
| Janela por sessão (o que a nuvem deixa em trânsito para uma aba) | 4.096 B | a placa (SESSION_WINDOW) |
| Quadro enviado pela placa | 4.096 B, com o cabeçalho | a nuvem |
| Mensagem enviada pela placa | o tamanho da fila do SDK (até 64 KB com PSRAM) | a placa |
| Mensagem WebSocket no gateway | 16 KiB | a nuvem |
| Mensagem remontada pela lib, vinda da placa | 64 KB | a lib |
Uma mensagem maior que o quadro vai em pedaços, remontados só nas pontas. Acima do limite de quem recebe: recusa 4413. Uma mensagem que espera mais de 10 s na fila do relay, ou que a placa lê com mais de 10 s, é descartada sem ser executada (4408; veja Os níveis de confirmação).
Os eventos de negócio (devui_audit, desde 26/10) têm texto de até 128 B e a cota que a nuvem diz no HELLO_ACK: por padrão, 10 de uma vez e 360 por hora por dispositivo; acima dela, DEVUI_ERR_OVER_QUOTA na placa (e 4429 da nuvem, que não grava o evento).
No ESP8266, o perfil "8266" baixa esses limites: mensagens de até 1 KB nos dois sentidos, até 4 abas e sem ordens de confiança assinadas (O SDK no ESP8266).
A interface e os dados
- Bundle: a interface vem do firmware ou da publicação do produto. A do firmware (a pasta
web/empacotada) sobe da placa para a nuvem, até 512 KB, e o empacotador avisa quando ela não cabe na partição do alvo; num produto com a interface na nuvem, a nuvem a recusa, e as abas recebem só a publicação. A publicação pela CLI vai até 512 KiB sem assinatura; assinada, até o teto do plano da conta (Referência da CLI). - Subidas por dia: um bundle novo conta até 3 por dispositivo no dia UTC (vira à 00:00 UTC); a retomada, o
HAVEe oWAITnão contam, e os até 2 dispositivos de desenvolvimento da conta não têm teto. Acima disso a nuvem respondeREJECT, e a placa diz na serial. - O que a interface guarda no navegador (
dev.storage): 64 KiB por usuário e dispositivo no plano Grátis, 256 KiB nos pagos; chaves de até 256 caracteres. Sai no logout, quando outra pessoa entra no navegador e depois de 90 dias sem uso.
O banco de dados
Os pedidos da placa ao banco (Banco de dados):
| Limite | Padrão | Quem fixa |
|---|---|---|
| Escritas por placa | 60 por minuto, com rajada de 10 | a nuvem (DEVUI_DB_LIMIT, com a espera) |
| Leituras por placa | 120 por minuto, com rajada de 20 | a nuvem (DEVUI_DB_LIMIT, com a espera) |
| Pedidos esperando resposta ao mesmo tempo | 4 | a placa (o quinto volta DEVUI_ERR_DB_LIMIT sem ir ao fio) e a nuvem |
| Pedido, em JSON | 4.083 B (1.011 B no ESP8266); a inserção da fila, 4.055 B (983 B), que ganha o op_id | a placa (a fila de envio do SDK; ESP_ERR_INVALID_SIZE) |
| Registro | 2 KB e 32 campos | a nuvem (DEVUI_DB_TOO_LARGE) |
| Espera pela resposta | 10 s | a placa (DEVUI_DB_UNAVAILABLE) |
| Fila de inserções na NVS | 2.048 B (DEVUI_DB_QUEUE_FLASH_MAX); no ESP8266, a fila só na RAM | a placa |
| Tabelas de um produto | 64, de 1 a 32 campos | a nuvem e a CLI |
A abertura da conexão
Na placa, o TLS e o upgrade do WebSocket esperam a rede até 15 s (no ESP-IDF e no Arduino para ESP32, o network_timeout_ms do cliente WebSocket, a cada leitura ou escrita; no ESP8266 e no porte POSIX, o mesmo prazo). A nuvem dá 20 s a cada etapa da abertura (o opening_timeout_ms do gateway). O da placa é menor de propósito: numa parada da rede, ela desiste e tenta de novo antes de a nuvem cortar a conexão. Em 27/10/2026, numa rede doméstica, o ESP32 levou de 3 a 16,5 s do DNS ao HELLO_ACK em 49 aberturas, e os 10 s de antes cortaram uma (-0x7280 na serial). Uma placa só ganha o prazo novo quando é gravada com o SDK de depois dessa data.
O que o SDK custa numa placa (medido em 13/10/2026)
Medido com o SDK do protocolo 1.0 e o ESP-IDF 5.5.5, no exemplo do LED; o SDK cresceu desde então, e estes números são a ordem de grandeza, não a promessa.
| O quê | ESP32 (sem PSRAM) | C3 |
|---|---|---|
| Heap livre só com o Wi-Fi | 251.664 B | 206.392 B |
| Heap livre em regime, com 0 a 4 abas | ~228 KB | ~183 KB |
| Heap livre no pior momento, 4 abas a 10 msg/s | ~203 KB | — |
| Flash do SDK com o cliente WebSocket e o TLS | 31,8 a 36,4 KB | 37,3 a 44,8 KB |
Assinatura P-256 do HELLO | 273 ms a 160 MHz; 205 ms a 240 MHz | 141 ms |
Do IP ao HELLO_ACK, p50 / p95 | 2,59 / 3,54 s a 160 MHz; 1,92 / 2,46 s a 240 MHz | 1,45 / 2,44 s |
Ida e volta da página à placa (ack: 'device'), p50 | ~100 ms com WIFI_PS_MIN_MODEM; 34 ms sem economia | ~100 ms; 22 ms sem economia |
| Folga de pilha: task do SDK / task do WebSocket (6 KB cada) | 3,8 a 4,2 KB / 2,6 a 3,5 KB (os dois chips juntos) |
O alvo do produto é deixar pelo menos 100 KB de heap livre num ESP32 sem PSRAM. A economia de energia padrão do Wi-Fi põe ~70 ms na mediana da ida e volta; o p95 da abertura do ESP32 a 160 MHz passa da meta de 3 s, e a 240 MHz cabe.
No core Arduino 3.3 como ele vem, o SDK custa o dobro: o mbedTLS pré-compilado do core usa buffers TLS fixos, e a sessão do SDK parada ocupa ~40 KB em vez de ~4 KB (medido em 11/11/2026 no ESP32 sem PSRAM: ~82 KB de RAM de 8 bits com o SDK online, contra ~45 KB com os buffers dinâmicos). A receita para o Arduino no ESP32 sem PSRAM, com as medidas, está em ESP32 sem PSRAM no Arduino.
A regra inteira está na especificação do protocolo, devui.1.
