Migração da tabela de partições (de antes de 15/10/2026)
A tabela de partições do SDK mudou em 15/10/2026: a de agora é a ports/esp-idf/devui/partitions.csv, a mesma no ESP-IDF, no Rust, no PlatformIO, no arduino-cli e no Arduino IDE. Ela é o "Minimal SPIFFS" do core do Arduino com a partição devui (a chave da placa, o device_id e o pareamento) no lugar do SPIFFS:
| Partição | Início | Tamanho |
|---|---|---|
nvs | 0x9000 | 20 KB |
otadata | 0xe000 | 8 KB |
ota_0 | 0x10000 | 1.966.080 B |
ota_1 | 0x1f0000 | 1.966.080 B |
devui | 0x3d0000 | 16 KB |
coredump | 0x3f0000 | 64 KB (a do core do Arduino; os builds do ESP-IDF não a usam sem um core dump ligado) |
Ela pede flash de 4 MB ou mais. A tabela de antes tinha nvs em 0x9000 (24 KB), otadata em 0xf000, phy_init em 0x11000, devui em 0x12000, ota_0 em 0x20000 e ota_1 em 0x200000 (0x1e0000 cada).
Placa em campo: pela OTA, sem apagar
Uma placa em campo fica com a tabela e a identidade dela depois de uma OTA, sem apagar nada. A tabela de partições é lida da flash na hora, nunca do build: o porte abre a partição da chave pelo nome (nvs_flash_init_partition("devui")), a casca do Arduino também a procura pelo nome, a OTA do app (esp_ota_*, esp_https_ota) pega o próximo slot da tabela gravada, e o SDK não tem offset fixo de tabela nenhuma (ele não faz OTA própria). Um firmware compilado com o SDK e a tabela novos roda, então, do ota_1 antigo (0x200000) com a devui antiga (0x12000) e o mesmo device_id. Os slots das duas tabelas têm o mesmo tamanho, 0x1e0000: um app que cabe na nova cabe na antiga.
Provado em 16/10/2026 num ESP32-S3: a tabela antiga com um app do SDK antigo, depois o exemplo do LED do SDK novo gravado no ota_1 antigo e o otadata virado para ele (otatool.py write_ota_partition --slot 1 e switch_ota_partition --slot 1, o que uma OTA grava). A placa subiu de 0x200000 com o mesmo device_id, chegou ao gateway, e os 16 KB em 0x12000 ficaram com o mesmo hash.
O que essa placa não ganha: a tabela nova em si (sem a partição coredump, e a nvs fica com 24 KB). E nada pode gravá-la pela USB sem apagar: o upload do core do Arduino e a tabela nova põem o app em 0x10000, em cima da devui antiga.
Placa gravada pela USB: identidade nova
Gravada pela USB com a tabela nova, a placa ganha identidade nova, porque a tabela nova põe o app em cima da devui antiga. Apague a flash inteira e grave com a tabela nova:
- ESP-IDF:
idf.py -p PORTA erase-flash flash; - Rust:
python -m esptool erase-flashantes dowrite-flashdoexamples/rust/README.md; - Arduino: "Erase All Flash Before Sketch Upload" uma vez.
Depois passe o Wi-Fi e pareie de novo (o quickstart mostra como), e desvincule o dispositivo antigo no portal (Dispositivos): o device_id dele não volta a conectar. Sem apagar, a devui e a nvs novas começariam sobre o que a tabela antiga deixou no lugar delas (o fim do ota_1 antigo, a nvs antiga cortada em 20 KB).
O que ainda apaga a devui
Em qualquer das ferramentas: apagar a flash inteira (o "Erase All Flash" do Arduino IDE, EraseFlash=all), uma imagem extra das opções da placa (upload.extra_flags, gravada onde ela disser) e, com a tabela padrão do core, formatar o SPIFFS ou o LittleFS dela, que cobre 0x3d0000. O tools/arduino_build.py recusa os dois primeiros. Gravar com a tabela padrão do core não apaga a devui, mas o SDK não a enxerga: o DevUI.begin cria uma identidade nova na nvs comum e avisa na serial; gravar de novo com a tabela do SDK, sem apagar, traz a de antes de volta. Os detalhes de cada ferramenta estão no README.md do SDK, seção Arduino.
