Pular para o conteúdo
ThingFace

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çãoInícioTamanho
nvs0x900020 KB
otadata0xe0008 KB
ota_00x100001.966.080 B
ota_10x1f00001.966.080 B
devui0x3d000016 KB
coredump0x3f000064 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-flash antes do write-flash do examples/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.