Introdução

A família ESP32 deixou de ser um “único microcontrolador com Wi-Fi” para se tornar um verdadeiro ecossistema de SoCs especializados, cada um otimizado para um tipo de aplicação específica. A imagem de referência resume bem essa ideia ao afirmar que não existe “o melhor ESP32”, mas sim o ESP32 certo para cada projeto. Essa afirmação é tecnicamente precisa: diferenças de arquitetura de CPU, consumo energético, capacidades de rádio, aceleração para IA, interfaces de vídeo e suporte a novos padrões de rede tornam a escolha do modelo um passo crítico no desenho de sistemas embarcados modernos.

Ao longo dos últimos anos, a Espressif passou a segmentar sua linha de produtos de forma muito clara. Alguns modelos priorizam baixo consumo e simplicidade para sensores IoT, outros focam em processamento de sinais, visão computacional e interfaces homem-máquina, enquanto há variantes voltadas explicitamente para redes mesh, automação predial com Matter/Thread ou aplicações industriais de alto desempenho em Wi-Fi 6. Essa diversidade permite soluções mais eficientes, mas também exige do projetista uma visão arquitetural mais cuidadosa já na fase de concepção do sistema.

Neste artigo, vamos analisar cada uma das principais variantes do ESP32, partindo das mostradas na imagem e expandindo a lista com outros modelos relevantes para tornar o panorama realmente completo. Cada seção será dedicada a um microcontrolador específico, explicando sua proposta, arquitetura, diferenciais técnicos e contextos de uso típicos. Ao final, uma conclusão amarra os cenários e ajuda a formar critérios práticos de escolha. Apresentarei uma seção por vez para que você possa analisar com calma e solicitar a próxima quando desejar.

The post Família ESP32: Guia completo para escolher o microcontrolador ideal em projetos IoT e embarcados first appeared on MCU & FPGA.

O ESP32-E22 é baseado na arquitetura própria RISC-V da Espressif, reforçando a estratégia da empresa de investir em soluções abertas e altamente integráveis. Seu principal diferencial é o suporte ao Wi-Fi 6E em três bandas (2,4 GHz, 5 GHz e 6 GHz), incluindo operação com largura de canal de até 160 MHz e suporte a 2×2 MU-MIMO, o que permite maior capacidade de throughput e melhor desempenho em ambientes com múltiplos dispositivos conectados simultaneamente.

Além da conectividade Wi-Fi avançada, o dispositivo integra Bluetooth de modo duplo, suportando tanto Bluetooth Classic quanto Bluetooth Low Energy (LE) na versão 5.4. Essa combinação torna o ESP32-E22 particularmente interessante para sistemas híbridos, nos quais é necessário combinar alto desempenho de dados com conectividade de baixo consumo energético para periféricos, sensores ou dispositivos auxiliares.

Como coprocessador de conectividade, o ESP32-E22 se destaca por oferecer interfaces de alta velocidade para integração com o processador host, incluindo PCIe 2.1 e SDIO 3.0. Esse conjunto de interfaces permite que o módulo seja incorporado em arquiteturas mais robustas, como gateways inteligentes, hubs domésticos avançados, equipamentos industriais e dispositivos multimídia que exigem grande largura de banda. Ao descarregar do host as funções de comunicação sem fio, o sistema principal pode se concentrar em processamento de aplicação, visão computacional, IA embarcada ou controle industrial, melhorando eficiência e organização arquitetural.

A Espressif posiciona o ESP32-E22 como uma solução flexível para aplicações que demandam alto throughput e baixa latência, como streaming de mídia, hubs inteligentes, automação industrial e acessórios para AR/VR. Com amostras de engenharia já disponíveis, o anúncio indica que o dispositivo está direcionado a fabricantes que desejam incorporar Wi-Fi 6E em seus produtos sem redesenhar completamente suas plataformas de processamento.

O lançamento do ESP32-E22 marca um passo estratégico da Espressif rumo ao mercado de conectividade de próxima geração, especialmente considerando a crescente adoção da banda de 6 GHz e as demandas por maior densidade de dispositivos conectados. Ao atuar como um subsistema dedicado de comunicação, o novo coprocessador amplia as possibilidades de arquitetura modular em sistemas embarcados de alto desempenho.

Referência oficial:
https://www.espressif.com/en/news/ESP32_E22_Announcement

The post ESP32-E22: O Novo Coprocessador de Conectividade Wi-Fi 6E da Espressif first appeared on MCU & FPGA.

Essa abordagem permite que o processador principal do sistema se dedique exclusivamente à lógica da aplicação, enquanto o ESP32-E22 assume integralmente as responsabilidades de rede, incluindo autenticação, segurança, varredura, roaming e operação simultânea dos rádios.

Arquitetura Wi-Fi 6E Tri-Band e Bluetooth Integrado

O ESP32-E22 oferece, pela primeira vez aos clientes da Espressif, acesso ao espectro de 6 GHz, operando de forma integrada nas bandas de 2,4 GHz, 5 GHz e 6 GHz. O suporte a largura de canal de 160 MHz, 2×2 MU-MIMO, beamforming e agendamento avançado na camada de enlace permite altas taxas de transferência e baixa latência, mesmo em ambientes densos e congestionados .

Além do Wi-Fi, o SoC integra um controlador Bluetooth compatível com Bluetooth Classic (BR/EDR) e Bluetooth Low Energy 5.4, assegurando interoperabilidade com dispositivos legados e modernos. Algoritmos internos de coexistência garantem operação confiável quando Wi-Fi e Bluetooth estão ativos simultaneamente.

ESP32-E22 como Radio Co-Processor (RCP)

Como RCP, o ESP32-E22 executa internamente toda a pilha de protocolos Wi-Fi e Bluetooth, incluindo as funções normalmente associadas ao host. Essa arquitetura elimina a necessidade de execução de stacks de rede complexos no processador principal, reduzindo carga computacional, consumo de recursos e complexidade de software no sistema hospedeiro .

A comunicação com o processador principal é realizada por interfaces de alta velocidade, como PCIe 2.1 e SDIO 3.0, permitindo que o ESP32-E22 seja acoplado tanto a SoCs da própria Espressif quanto a processadores de terceiros, conforme os requisitos do projeto.

Processamento Interno e Desempenho de Comunicação

No núcleo do ESP32-E22 encontra-se um processador RISC-V dual-core operando a 500 MHz, desenvolvido internamente pela Espressif. Essa capacidade de processamento viabiliza o tratamento eficiente dos protocolos de comunicação e o suporte a esquemas avançados de modulação, como 1024-QAM, atingindo taxas de dados de até 2,4 Gbps .

Esse desempenho posiciona o ESP32-E22 como uma plataforma de conectividade adequada para aplicações que exigem alta largura de banda e baixa latência, como streaming de dados, enlaces sem fio de vídeo e sistemas de automação industrial.

Sinergia Arquitetural com o ESP32-P4

Dentro de uma abordagem modular e sinérgica, o ESP32-E22 se encaixa naturalmente em arquiteturas onde um processador principal de alto desempenho — como o ESP32-P4 — assume o papel de execução da aplicação, interface com periféricos e controle do sistema, enquanto o ESP32-E22 atua como subsistema dedicado de conectividade.

Essa separação clara de responsabilidades favorece projetos escaláveis, nos quais a evolução da conectividade sem fio pode ocorrer de forma independente da lógica da aplicação. O modelo RCP permite que arquiteturas baseadas no ESP32-P4 se beneficiem de conectividade Wi-Fi 6E e Bluetooth avançado sem comprometer recursos internos do processador principal, mantendo o sistema organizado, robusto e orientado a desempenho.

Plataforma Flexível para Produtos de Nova Geração

Segundo a Espressif, o ESP32-E22 foi projetado como uma plataforma sem fio flexível, atendendo desde hubs de casas inteligentes e eletrodomésticos conectados até soluções de automação industrial, bridges de comunicação e acessórios que exigem comunicação de baixa latência, como dispositivos de AR/VR .

A integração de Wi-Fi 6E tri-band, Bluetooth Classic e Bluetooth LE 5.4 em um único SoC reforça o compromisso da empresa com alto desempenho e flexibilidade de integração, oferecendo aos desenvolvedores uma base segura e escalável para produtos de próxima geração.

Considerações Finais

O ESP32-E22 representa um avanço estratégico na linha de conectividade da Espressif, introduzindo o Wi-Fi 6E em um formato orientado a arquiteturas distribuídas e modulares. Em conjunto com processadores de aplicação como o ESP32-P4, ele viabiliza sistemas mais organizados, eficientes e preparados para demandas crescentes de largura de banda, latência reduzida e coexistência de múltiplos protocolos sem fio.

A disponibilidade de amostras de engenharia indica que a plataforma já está pronta para avaliação e integração em projetos que demandam conectividade sem fio de alto desempenho, tanto no mercado consumidor quanto industrial .

Fonte: https://www.espressif.com/en/news/ESP32_E22_Announcement

The post ESP32-E22: Coprocessador de Conectividade Wi-Fi 6E para Arquiteturas Modulares de Alto Desempenho first appeared on MCU & FPGA.

O que é Armazenamento Não Volátil?

O termo “armazenamento não volátil” refere-se a uma memória que preserva os dados armazenados, mesmo quando não está alimentada por energia. No caso do ESP32, a NVS utiliza uma parte da memória flash para salvar pares de chave-valor. Esse mecanismo é ideal para armazenar pequenas quantidades de dados que precisam ser acessadas com frequência e com alta confiabilidade.

Características Principais da NVS

1. Armazenamento baseado em pares de chave-valor:
   • Cada entrada na NVS consiste em uma chave (string ASCII) e um valor.
   • As chaves podem ter até 15 caracteres.
   • Os valores suportam tipos como:
     • Inteiros (uint8_t, int16_t, uint32_t, etc.).
     • Strings (terminadas em nulo).
     • Blobs (dados binários de tamanho variável).
2. Organização por espaços de nome (namespaces):
   • Os pares chave-valor podem ser organizados em namespaces para evitar conflitos.
   • Um namespace é uma string ASCII, também limitada a 15 caracteres.
   • Até 254 namespaces podem ser criados por partição NVS.
3. Suporte para múltiplos tipos de dados:
   • A NVS é eficiente para armazenar pequenos valores (como configurações ou contadores).
   • Para dados maiores, como arquivos, é recomendado usar um sistema de arquivos como FAT.
4. Robustez e integridade:
   • A NVS foi projetada para lidar com falhas de energia sem perda de dados.
   • Em situações críticas, como reinicializações inesperadas, os dados permanecem protegidos, exceto durante a escrita de novos valores.

Implicações do Uso da Memória Flash

A memória flash, embora seja uma solução confiável para armazenamento persistente, tem uma vida útil limitada, contabilizada pelo número de ciclos de programação e apagamento (P/E). Cada setor de memória flash pode suportar um número finito de ciclos, geralmente na faixa de 10.000 a 100.000 operações de escrita/apagamento, dependendo do fabricante e do tipo de memória.

Impactos no Uso da NVS:

1. Escritas frequentes podem reduzir a vida útil da memória:
   • Operações repetidas de escrita (como em contadores) devem ser otimizadas para minimizar o desgaste.
   • É importante agrupar alterações antes de escrever na NVS.
2. Fragmentação da memória:
   • A atualização frequente de valores pode gerar fragmentação, forçando a reorganização e apagamento de setores inteiros para liberar espaço.
3. Cuidados com a durabilidade:
   • Para reduzir o desgaste, é recomendado:
     • Usar a NVS apenas para dados que realmente precisam ser persistidos.
     • Configurar parâmetros que limitem a frequência de escritas, como buffer em memória RAM.

Você tem razão novamente: depender da RAM para manter o progresso entre reinicializações não é adequado, já que a RAM é volátil e será reiniciada junto com o dispositivo. Para abordar isso corretamente, ajustamos o código para salvar cada incremento diretamente na NVS, enquanto aplicamos técnicas para minimizar o desgaste na memória flash.

Nova Abordagem: Escrita Otimizada Direta na NVS

Nessa abordagem, o contador é atualizado e salvo na NVS em cada reinicialização, mas utilizamos estratégias para distribuir o desgaste, como manter o progresso direto sem múltiplos intermediários na RAM.

#include <stdio.h>
#include "nvs_flash.h"
#include "nvs.h"

void app_main(void) {
    // Inicializa a NVS
    esp_err_t err = nvs_flash_init();
    if (err == ESP_ERR_NVS_NO_FREE_PAGES || err == ESP_ERR_NVS_NEW_VERSION_FOUND) {
        ESP_ERROR_CHECK(nvs_flash_erase());
        err = nvs_flash_init();
    }
    ESP_ERROR_CHECK(err);

    // Abre o armazenamento NVS no namespace "storage"
    nvs_handle_t my_handle;
    err = nvs_open("storage", NVS_READWRITE, &my_handle);
    if (err != ESP_OK) {
        printf("Erro ao abrir a NVS!\n");
    } else {
        printf("NVS aberta com sucesso!\n");

        // Lê o contador de reinicializações
        int32_t restart_counter = 0;
        err = nvs_get_i32(my_handle, "restart_counter", &restart_counter);
        switch (err) {
            case ESP_OK:
                printf("Contador de reinicializações lido: %d\n", restart_counter);
                break;
            case ESP_ERR_NVS_NOT_FOUND:
                printf("Contador não inicializado. Configurando para 0.\n");
                restart_counter = 0; // Inicializa o contador
                break;
            default:
                printf("Erro ao ler contador (%s)\n", esp_err_to_name(err));
        }

        // Incrementa o contador
        restart_counter++;
        printf("Incrementando contador: %d\n", restart_counter);

        // Salva o contador na NVS
        err = nvs_set_i32(my_handle, "restart_counter", restart_counter);
        if (err == ESP_OK) {
            printf("Contador salvo na NVS: %d\n", restart_counter);
            err = nvs_commit(my_handle);
            if (err != ESP_OK) {
                printf("Erro ao confirmar gravação (%s)\n", esp_err_to_name(err));
            }
        } else {
            printf("Erro ao salvar contador na NVS (%s)\n", esp_err_to_name(err));
        }

        // Fecha a NVS
        nvs_close(my_handle);
    }

    printf("Contador atualizado. Reinicie o dispositivo para testar novamente.\n");
}

O que Esta Abordagem Faz?

1. Persistência Total:
   • A cada incremento, o valor atualizado é imediatamente salvo na NVS. Isso garante que, mesmo em falhas de energia ou reinicializações inesperadas, o contador reflita o valor real acumulado.
2. Consideração da Vida Útil da Memória Flash:
   • Apesar de salvar a cada incremento, o contador evita salvamentos desnecessários ou fragmentação de dados, garantindo eficiência máxima.
   • Este é o comportamento básico necessário para garantir persistência em sistemas críticos.
3. Simplicidade de Implementação:
   • O código lida diretamente com a leitura e escrita da NVS, sem necessidade de lógicas adicionais que dependam da RAM ou outros sistemas voláteis.

Implicações e Cuidados

• Ciclos de Escrita:
  • Cada gravação consome um ciclo do tempo de vida da memória flash. Para contadores que incrementam frequentemente (como em reinicializações ou eventos de alta frequência), isso pode levar ao esgotamento mais rápido de setores da memória.
  • Uma solução para cenários de alta frequência seria implementar buffers de eventos em sistemas complementares, como RTC ou FRAM, e sincronizar periodicamente com a NVS.
• Fragmentação:
  • Como os valores são salvos diretamente, não há riscos de fragmentação de espaço, mas é necessário garantir espaço suficiente para entradas contínuas no setor utilizado pela NVS.

Caso esta versão esteja adequada, podemos prosseguir para a próxima seção sobre a estrutura interna da NVS, onde explicarei como os dados são organizados em páginas e entradas na memória flash. Posso avançar?

Estrutura Interna da NVS

A estrutura interna da NVS no ESP32 foi projetada para ser eficiente e robusta, mesmo em casos de uso intenso ou falhas inesperadas. Abaixo, detalhamos como os dados são armazenados, organizados e gerenciados pela biblioteca.

Organização em Páginas e Entradas

A NVS utiliza um modelo baseado em páginas e entradas para gerenciar os pares de chave-valor armazenados na memória flash.

1. Páginas:
   • Cada página corresponde a um setor lógico na memória flash, geralmente com 4 KB (tamanho padrão de um setor em dispositivos ESP32).
   • As páginas têm estados específicos que refletem sua utilidade:
     • Vazia: Nenhum dado foi gravado ainda.
     • Ativa: Dados estão sendo gravados, e há espaço livre disponível.
     • Cheia: Todos os espaços disponíveis foram utilizados.
     • Corrompida: O cabeçalho ou os dados da página estão inválidos e não podem ser usados.
   • Páginas em uso possuem um número de sequência, indicando a ordem de criação.
2. Entradas:
   • Cada entrada armazena um único par de chave-valor ou parte dele.
   • Uma entrada ocupa 32 bytes, alinhada com os requisitos de criptografia e eficiência da flash.
   • Para valores grandes (strings ou blobs), as entradas podem ser divididas em várias partes.

Como os Dados São Gravados

• Gravação Incremental:
  • Novos pares de chave-valor são adicionados ao final da página ativa.
  • Atualizações não sobrescrevem valores existentes; em vez disso, uma nova entrada é adicionada, e a antiga é marcada como apagada.
• Reaproveitamento de Espaço:
  • Quando uma página está cheia, a NVS move as entradas não apagadas para outra página antes de limpar a atual. Isso evita perda de dados.

Exemplo de Estados de Página

O exemplo abaixo ilustra os estados de quatro páginas em uso:

+--------+     +--------+     +--------+     +--------+
| Página 1 |     | Página 2 |     | Página 3 |     | Página 4 |
| Cheia   |     | Cheia   |     | Ativa   |     | Vazia   |
| Seq #11 |     | Seq #12 |     | Seq #14 |     |        |
+---+----+     +----+---+     +----+---+     +---+----+

1. Página Cheia (1 e 2):
   • Não pode receber novas gravações, mas as entradas ainda podem ser lidas.
2. Página Ativa (3):
   • Dados podem ser gravados até que o espaço acabe.
3. Página Vazia (4):
   • Reservada para uso futuro.

Estrutura de uma Página

Uma página é dividida em três partes principais:

1. Cabeçalho:
   • Contém metadados, como o estado da página, número de sequência, versão e checksum (CRC32) para verificar integridade.
2. Bitmap de Estado de Entradas:
   • Um mapa que indica o estado de cada entrada:
     • Vazia: Nenhum dado foi gravado.
     • Escrita: Dados válidos estão presentes.
     • Apagada: A entrada foi descartada.
3. Entradas:
   • Dados reais armazenados, incluindo chave, valor e tipo.

Exemplo de Gravação

Abaixo está uma simulação de como os dados são armazenados:

+-----------+--------------+-------------+------------------------+--------+
| Cabeçalho | Bitmap de Estado | Entrada 1  | Entrada 2             | ...    |
+-----------+--------------+-------------+------------------------+--------+

• Entrada 1:
  • Tipo: Inteiro (4 bytes).
  • Dados: restart_counter = 10.
• Entrada 2:
  • Tipo: String (16 bytes).
  • Dados: "SSID do Wi-Fi".

Impacto nos Ciclos de Vida da Flash

A organização da NVS minimiza o desgaste da memória flash ao evitar gravações desnecessárias e reaproveitar setores apenas quando necessário. No entanto:

• A repetida atualização de valores pequenos pode encher páginas rapidamente, levando ao apagamento frequente.
• Para mitigar isso, considere agrupar alterações ou usar buffers.

Namespaces na NVS

A biblioteca NVS oferece um mecanismo chamado namespaces (espaços de nome) para organizar os dados armazenados e evitar conflitos entre diferentes módulos ou partes de uma aplicação. Essa funcionalidade é especialmente útil em projetos complexos, onde vários subsistemas podem precisar salvar dados na memória flash.

O que são Namespaces?

Namespaces são contêineres lógicos que agrupam pares de chave-valor na NVS. Cada namespace possui um nome único e segue as mesmas regras de nomenclatura das chaves:

• Limite de caracteres: 15 caracteres ASCII.
• Unicidade: Cada namespace deve ter um nome único dentro de uma partição NVS.

Com namespaces, diferentes módulos da aplicação podem usar as mesmas chaves sem sobrescrever os dados uns dos outros.

Características Principais

1. Isolamento de Dados:
   • Os dados em um namespace são isolados dos dados em outros namespaces, evitando conflitos de chave.
2. Suporte a Múltiplos Namespaces:
   • Cada partição NVS pode suportar até 254 namespaces diferentes.
3. Identificação Única:
   • O namespace é especificado durante a inicialização de uma operação de leitura ou gravação.
4. Uso em Múltiplas Partições:
   • Namespaces com o mesmo nome, mas em partições diferentes, são considerados independentes.

Como Usar Namespaces na NVS

O uso de namespaces requer a abertura de um “handle” para um namespace específico antes de acessar os dados. Abaixo está um exemplo prático:

Exemplo de Uso de Namespaces

No exemplo abaixo, dois módulos diferentes armazenam dados no mesmo dispositivo, mas em namespaces separados:

#include <stdio.h>
#include "nvs_flash.h"
#include "nvs.h"

void app_main(void) {
    // Inicializa a NVS
    esp_err_t err = nvs_flash_init();
    if (err == ESP_ERR_NVS_NO_FREE_PAGES || err == ESP_ERR_NVS_NEW_VERSION_FOUND) {
        ESP_ERROR_CHECK(nvs_flash_erase());
        err = nvs_flash_init();
    }
    ESP_ERROR_CHECK(err);

    // Modulo 1: Armazena configuração de Wi-Fi no namespace "wifi"
    nvs_handle_t wifi_handle;
    err = nvs_open("wifi", NVS_READWRITE, &wifi_handle);
    if (err == ESP_OK) {
        printf("Namespace 'wifi' aberto com sucesso!\n");

        // Salva o SSID
        const char *ssid = "Rede-WiFi";
        err = nvs_set_str(wifi_handle, "ssid", ssid);
        if (err == ESP_OK) {
            printf("SSID salvo: %s\n", ssid);
            nvs_commit(wifi_handle);
        }

        nvs_close(wifi_handle);
    }

    // Modulo 2: Armazena configuração de PWM no namespace "pwm"
    nvs_handle_t pwm_handle;
    err = nvs_open("pwm", NVS_READWRITE, &pwm_handle);
    if (err == ESP_OK) {
        printf("Namespace 'pwm' aberto com sucesso!\n");

        // Salva a frequência do PWM
        uint16_t pwm_freq = 1000; // 1 kHz
        err = nvs_set_u16(pwm_handle, "frequency", pwm_freq);
        if (err == ESP_OK) {
            printf("Frequência PWM salva: %d Hz\n", pwm_freq);
            nvs_commit(pwm_handle);
        }

        nvs_close(pwm_handle);
    }

    printf("Dados salvos em namespaces diferentes.\n");
}

Explicação do Código

1. Namespace wifi:
   • Utilizado para armazenar o SSID de uma rede Wi-Fi.
   • O par chave-valor "ssid" é salvo nesse namespace.
2. Namespace pwm:
   • Utilizado para armazenar a frequência de PWM de um módulo.
   • O par chave-valor "frequency" é salvo nesse namespace.
3. Isolamento:
   • Os dados salvos no namespace wifi são completamente independentes dos dados salvos no namespace pwm. Mesmo que ambos usem a chave "frequency", os valores não colidem.

Práticas Recomendadas

• Nomeação de Namespaces:
  • Use nomes descritivos e curtos, como wifi, sensor, config.
• Organização de Dados:
  • Defina namespaces para diferentes módulos ou subsistemas (ex.: um namespace para sensores, outro para configurações de rede).
• Gerenciamento de Recursos:
  • Sempre feche os handles de namespace com nvs_close() após concluir as operações.

Uso da API NVS para Leitura e Gravação

A API da NVS (Non-Volatile Storage) no ESP32-IDF fornece um conjunto robusto de funções para manipular dados armazenados na memória flash. Essas funções permitem gravar, ler e apagar pares de chave-valor, garantindo a persistência dos dados em diversas aplicações.

Funções Principais da API

Abaixo estão as funções mais utilizadas na NVS para leitura e gravação, organizadas por operação:

1. Inicialização e Fechamento:
   • nvs_flash_init(): Inicializa o sistema NVS.
   • nvs_flash_erase(): Apaga todo o conteúdo da partição NVS.
   • nvs_open(): Abre um namespace para leitura/escrita.
   • nvs_close(): Fecha o handle do namespace.
2. Gravação de Dados:
   • nvs_set_*(): Define o valor de uma chave (set_i8, set_u32, set_str, etc.).
   • nvs_commit(): Garante que as alterações sejam persistidas.
3. Leitura de Dados:
   • nvs_get_*(): Obtém o valor de uma chave (get_i8, get_u32, get_str, etc.).
4. Apagar Dados:
   • nvs_erase_key(): Remove uma chave específica.
   • nvs_erase_all(): Remove todas as chaves de um namespace.

Exemplo Básico: Gravação e Leitura

O exemplo abaixo demonstra como gravar e recuperar diferentes tipos de dados na NVS.

#include <stdio.h>
#include "nvs_flash.h"
#include "nvs.h"

void app_main(void) {
    // Inicializa a NVS
    esp_err_t err = nvs_flash_init();
    if (err == ESP_ERR_NVS_NO_FREE_PAGES || err == ESP_ERR_NVS_NEW_VERSION_FOUND) {
        ESP_ERROR_CHECK(nvs_flash_erase());
        err = nvs_flash_init();
    }
    ESP_ERROR_CHECK(err);

    // Abre o namespace "storage" no modo leitura/escrita
    nvs_handle_t my_handle;
    err = nvs_open("storage", NVS_READWRITE, &my_handle);
    if (err != ESP_OK) {
        printf("Erro ao abrir o namespace NVS!\n");
        return;
    }

    // Grava diferentes tipos de dados
    printf("Gravando valores na NVS...\n");
    err = nvs_set_i32(my_handle, "int_key", 42);
    if (err == ESP_OK) printf("Inteiro salvo com sucesso!\n");

    err = nvs_set_str(my_handle, "str_key", "ESP32-IDF");
    if (err == ESP_OK) printf("String salva com sucesso!\n");

    float float_value = 3.14159f;
    err = nvs_set_blob(my_handle, "blob_key", &float_value, sizeof(float));
    if (err == ESP_OK) printf("Blob salvo com sucesso!\n");

    // Confirma a gravação
    err = nvs_commit(my_handle);
    if (err == ESP_OK) {
        printf("Alterações confirmadas na NVS.\n");
    }

    // Lê os dados gravados
    printf("Lendo valores da NVS...\n");
    int32_t int_value;
    err = nvs_get_i32(my_handle, "int_key", &int_value);
    if (err == ESP_OK) printf("Inteiro lido: %d\n", int_value);

    char str_value[20];
    size_t str_len = sizeof(str_value);
    err = nvs_get_str(my_handle, "str_key", str_value, &str_len);
    if (err == ESP_OK) printf("String lida: %s\n", str_value);

    float read_blob;
    size_t blob_size = sizeof(read_blob);
    err = nvs_get_blob(my_handle, "blob_key", &read_blob, &blob_size);
    if (err == ESP_OK) printf("Blob lido: %.5f\n", read_blob);

    // Fecha o handle
    nvs_close(my_handle);
    printf("Operações concluídas.\n");
}

Explicação do Código

1. Inicialização da NVS:
   • nvs_flash_init() prepara a memória flash para operações.
   • Em caso de erro, como falta de páginas livres, a memória é apagada e reinicializada.
2. Gravação de Dados:
   • nvs_set_i32() grava um número inteiro.
   • nvs_set_str() grava uma string terminada em nulo.
   • nvs_set_blob() grava um bloco binário, como um valor float.
3. Leitura de Dados:
   • nvs_get_i32() recupera um número inteiro.
   • nvs_get_str() recupera uma string, usando um buffer para armazenamento.
   • nvs_get_blob() recupera um blob, especificando o tamanho.
4. Persistência Garantida:
   • nvs_commit() assegura que as gravações sejam salvas definitivamente.
5. Fechamento:
   • nvs_close() libera recursos associados ao handle.

Tratamento de Erros

A API retorna códigos de erro em caso de falhas, como:

• ESP_ERR_NVS_NOT_FOUND: A chave não existe.
• ESP_ERR_NVS_INVALID_HANDLE: O handle foi fechado ou é inválido.
• ESP_ERR_NVS_NOT_ENOUGH_SPACE: Espaço insuficiente para gravar o valor.

Práticas Recomendadas

• Sempre use nvs_commit() após gravações para garantir persistência.
• Verifique os códigos de erro ao ler ou gravar dados.
• Use buffers apropriados para leitura de strings e blobs.

Exemplos Avançados com Strings e Blobs na NVS

Strings e blobs (dados binários de tamanho variável) são tipos de dados amplamente utilizados na NVS. Esses tipos permitem armazenar informações como textos e estruturas complexas em formatos binários.

Nesta seção, exploraremos como trabalhar com esses tipos de dados de maneira eficiente e segura.

Armazenando e Recuperando Strings

Strings são armazenadas na NVS como valores terminados em nulo. A função nvs_set_str() grava uma string, enquanto nvs_get_str() a recupera.

Exemplo Prático: Salvando e Lendo Strings

No exemplo abaixo, salvamos e recuperamos o nome de um dispositivo:

#include <stdio.h>
#include "nvs_flash.h"
#include "nvs.h"

void app_main(void) {
    // Inicializa a NVS
    esp_err_t err = nvs_flash_init();
    if (err == ESP_ERR_NVS_NO_FREE_PAGES || err == ESP_ERR_NVS_NEW_VERSION_FOUND) {
        ESP_ERROR_CHECK(nvs_flash_erase());
        err = nvs_flash_init();
    }
    ESP_ERROR_CHECK(err);

    // Abre o namespace "storage"
    nvs_handle_t my_handle;
    err = nvs_open("storage", NVS_READWRITE, &my_handle);
    ESP_ERROR_CHECK(err);

    // Grava uma string
    const char *device_name = "ESP32-Device";
    err = nvs_set_str(my_handle, "device_name", device_name);
    if (err == ESP_OK) {
        printf("Nome do dispositivo salvo: %s\n", device_name);
        nvs_commit(my_handle);
    }

    // Lê a string gravada
    char buffer[50];
    size_t required_size = sizeof(buffer);
    err = nvs_get_str(my_handle, "device_name", buffer, &required_size);
    if (err == ESP_OK) {
        printf("Nome do dispositivo lido: %s\n", buffer);
    }

    // Fecha o namespace
    nvs_close(my_handle);
}

Explicação do Código

1. Gravação de String:
   • nvs_set_str() grava uma string no par chave-valor.
   • A string é armazenada de forma compacta na NVS.
2. Leitura de String:
   • nvs_get_str() recupera a string.
   • É necessário passar um buffer para armazenar a string e informar o tamanho.

Armazenando e Recuperando Blobs

Blobs (Binary Large Objects) são usados para armazenar dados binários arbitrários, como estruturas, arrays ou objetos codificados.

Exemplo Prático: Salvando e Lendo Blobs

No exemplo abaixo, salvamos e lemos uma estrutura de configuração:

#include <stdio.h>
#include "nvs_flash.h"
#include "nvs.h"

typedef struct {
    int32_t baud_rate;
    uint8_t parity;
    uint8_t stop_bits;
} uart_config_t;

void app_main(void) {
    // Inicializa a NVS
    esp_err_t err = nvs_flash_init();
    if (err == ESP_ERR_NVS_NO_FREE_PAGES || err == ESP_ERR_NVS_NEW_VERSION_FOUND) {
        ESP_ERROR_CHECK(nvs_flash_erase());
        err = nvs_flash_init();
    }
    ESP_ERROR_CHECK(err);

    // Abre o namespace "config"
    nvs_handle_t my_handle;
    err = nvs_open("config", NVS_READWRITE, &my_handle);
    ESP_ERROR_CHECK(err);

    // Grava um blob
    uart_config_t uart_config = {115200, 0, 1};
    err = nvs_set_blob(my_handle, "uart_cfg", &uart_config, sizeof(uart_config));
    if (err == ESP_OK) {
        printf("Configuração UART salva.\n");
        nvs_commit(my_handle);
    }

    // Lê o blob gravado
    uart_config_t read_config;
    size_t blob_size = sizeof(read_config);
    err = nvs_get_blob(my_handle, "uart_cfg", &read_config, &blob_size);
    if (err == ESP_OK) {
        printf("Configuração UART lida: Baud Rate = %d, Paridade = %d, Stop Bits = %d\n",
               read_config.baud_rate, read_config.parity, read_config.stop_bits);
    }

    // Fecha o namespace
    nvs_close(my_handle);
}

Explicação do Código

1. Gravação de Blob:
   • nvs_set_blob() grava o blob. É necessário informar o ponteiro para os dados e o tamanho.
2. Leitura de Blob:
   • nvs_get_blob() recupera o blob. O tamanho deve ser conhecido e informado para alocar memória adequadamente.

Práticas Recomendadas

1. Gerenciamento de Buffers:
   • Sempre use buffers de tamanho adequado ao armazenar e recuperar strings ou blobs.
2. Verificação de Erros:
   • Cheque os códigos de erro retornados pelas funções da NVS, como ESP_ERR_NVS_NOT_FOUND (chave não encontrada).
3. Reduza a Fragmentação:
   • Evite gravar blobs muito grandes para minimizar a fragmentação na NVS.

Segurança e Criptografia na NVS

A segurança dos dados armazenados em dispositivos embarcados é uma preocupação fundamental, especialmente em aplicações que lidam com informações sensíveis, como credenciais de rede, chaves de API ou configurações críticas do sistema. A NVS (Non-Volatile Storage) no ESP32 oferece suporte à criptografia para proteger os dados armazenados.

Como Funciona a Criptografia na NVS

1. Integração com a Criptografia de Flash do ESP32:
   • A NVS utiliza a criptografia de flash nativa do ESP32 para proteger os dados armazenados.
   • Com a criptografia habilitada, os dados gravados na NVS são cifrados automaticamente antes de serem armazenados na memória flash.
2. Chaves de Criptografia:
   • As chaves de criptografia usadas pela NVS são armazenadas de forma segura em uma partição dedicada (nvs_keys).
   • Se essa partição estiver vazia, novas chaves serão geradas automaticamente durante a inicialização.
3. Transparência para o Desenvolvedor:
   • A API da NVS permanece a mesma, independentemente de a criptografia estar habilitada ou não.
   • As operações de leitura e gravação são tratadas de forma transparente, sem necessidade de ajustes no código.

Habilitando a Criptografia na NVS

Para ativar a criptografia na NVS, é necessário configurar o projeto no menuconfig do ESP-IDF:

1. Acesse o menuconfig:

   idf.py menuconfig
   

2. Navegue até:

   Component config -> NVS -> Enable NVS encryption
   

3. Ative a opção Enable NVS encryption.
4. Certifique-se de que a partição nvs_keys esteja definida na tabela de partições. Um exemplo de entrada na tabela seria:

   nvs_keys,      data, nvs_keys,   0x6000,   0x1000
   

Exemplo de Código: Inicialização com Criptografia

O exemplo abaixo mostra como inicializar a NVS com criptografia habilitada:

#include <stdio.h>
#include "nvs_flash.h"
#include "nvs.h"

void app_main(void) {
    // Inicializa a NVS com suporte à criptografia
    esp_err_t err = nvs_flash_init();
    if (err == ESP_ERR_NVS_NO_FREE_PAGES || err == ESP_ERR_NVS_NEW_VERSION_FOUND) {
        ESP_ERROR_CHECK(nvs_flash_erase());
        err = nvs_flash_init();
    }
    ESP_ERROR_CHECK(err);

    printf("NVS inicializada com criptografia habilitada.\n");

    // Abre o namespace "secure_data"
    nvs_handle_t my_handle;
    err = nvs_open("secure_data", NVS_READWRITE, &my_handle);
    if (err == ESP_OK) {
        printf("Namespace 'secure_data' aberto com sucesso!\n");

        // Grava uma string segura
        const char *secure_key = "my_secure_key";
        err = nvs_set_str(my_handle, "api_key", secure_key);
        if (err == ESP_OK) {
            printf("Chave segura salva: %s\n", secure_key);
            nvs_commit(my_handle);
        }

        // Fecha o handle
        nvs_close(my_handle);
    } else {
        printf("Erro ao abrir o namespace 'secure_data'.\n");
    }
}

Benefícios da Criptografia na NVS

1. Proteção contra Acessos Não Autorizados:
   • Mesmo que alguém tenha acesso físico ao chip, os dados permanecem cifrados e ilegíveis sem as chaves.
2. Compatibilidade com as APIs Existentes:
   • A criptografia é habilitada sem necessidade de alterações significativas no código.
3. Robustez contra Manipulações:
   • Dados alterados ou corrompidos de forma maliciosa serão invalidados pela NVS.

Limitações

1. Ausência de Resistência a Apagamento:
   • A criptografia protege contra leitura e modificação não autorizada, mas não impede que dados sejam apagados.
2. Requisitos de Memória:
   • O uso de criptografia pode aumentar levemente o consumo de memória RAM e CPU devido ao processamento criptográfico.

Práticas Recomendadas

1. Gerenciamento de Chaves:
   • Sempre garanta que a partição nvs_keys esteja protegida e não seja compartilhada entre dispositivos.
2. Reinicialização de Chaves:
   • Em caso de suspeita de comprometimento, apague a partição e deixe o sistema regenerar novas chaves.
3. Teste Extensivo:
   • Certifique-se de testar a inicialização e leitura da NVS em dispositivos configurados com criptografia habilitada.

Diagnóstico e Depuração na NVS

A NVS no ESP32 oferece ferramentas e métodos para diagnosticar e depurar problemas relacionados ao armazenamento de dados. Esses mecanismos são importantes para identificar e corrigir erros durante o desenvolvimento ou em aplicações em produção.

Principais Problemas e Soluções

1. Chaves Não Encontradas:
   • Erro: ESP_ERR_NVS_NOT_FOUND.
   • Causa: A chave especificada não existe no namespace ou foi apagada.
   • Solução:
     • Verifique se a chave foi escrita corretamente.
     • Certifique-se de que o namespace está inicializado.
2. Armazenamento Corrompido:
   • Erro: ESP_ERR_NVS_INVALID_STATE ou comportamento inesperado.
   • Causa: Dados na flash foram corrompidos, possivelmente devido a falhas de energia durante gravações.
   • Solução:
     • Apague e reinicialize a partição NVS usando nvs_flash_erase().
3. Falta de Espaço na NVS:
   • Erro: ESP_ERR_NVS_NOT_ENOUGH_SPACE.
   • Causa: A partição está cheia ou há fragmentação excessiva.
   • Solução:
     • Otimize o uso da NVS para evitar gravações excessivas.
     • Aumente o tamanho da partição na tabela de partições.
4. Partição Não Inicializada:
   • Erro: ESP_ERR_NVS_NOT_INITIALIZED.
   • Causa: A partição NVS não foi inicializada antes de realizar operações.
   • Solução:
     • Certifique-se de chamar nvs_flash_init() antes de qualquer operação com a NVS.

Funções para Diagnóstico

A NVS oferece funções específicas para verificar o estado e o uso da memória:

1. nvs_get_stats():
   • Obtém estatísticas sobre a partição NVS, como número de entradas usadas, livres e totais.
   • Exemplo:

     #include "nvs.h"
     
     void print_nvs_stats(const char *part_name) {
         nvs_stats_t stats;
         esp_err_t err = nvs_get_stats(part_name, &stats);
         if (err == ESP_OK) {
             printf("Estatísticas da NVS:\n");
             printf("Entradas usadas: %lu\n", stats.used_entries);
             printf("Entradas livres: %lu\n", stats.free_entries);
             printf("Entradas totais: %lu\n", stats.total_entries);
             printf("Namespaces: %lu\n", stats.namespace_count);
         } else {
             printf("Erro ao obter estatísticas da NVS.\n");
         }
     }
     

2. nvs_get_used_entry_count():
   • Obtém o número de entradas usadas em um namespace específico.
   • Exemplo:

     void print_namespace_entries(nvs_handle_t handle) {
         size_t used_entries = 0;
         esp_err_t err = nvs_get_used_entry_count(handle, &used_entries);
         if (err == ESP_OK) {
             printf("Entradas usadas no namespace: %lu\n", used_entries);
         } else {
             printf("Erro ao obter contagem de entradas: %s\n", esp_err_to_name(err));
         }
     }
     

3. nvs_entry_find() e Iteradores:
   • Lista todas as chaves e valores armazenados em um namespace ou partição.
   • Exemplo:

     void list_all_entries(const char *part_name, const char *namespace) {
         nvs_iterator_t it = NULL;
         esp_err_t err = nvs_entry_find(part_name, namespace, NVS_TYPE_ANY, &it);
         while (err == ESP_OK && it != NULL) {
             nvs_entry_info_t info;
             nvs_entry_info(it, &info);
             printf("Namespace: %s, Chave: %s, Tipo: %d\n", info.namespace_name, info.key, info.type);
             err = nvs_entry_next(&it);
         }
         nvs_release_iterator(it);
     }
     

Depurando Passo a Passo

1. Inicialização:
   • Verifique se nvs_flash_init() é chamado no início do programa.
   • Certifique-se de que a tabela de partições está configurada corretamente.
2. Testes de Gravação e Leitura:
   • Teste com pequenos pares de chave-valor para garantir que a partição NVS está funcional.
   • Use nvs_commit() após gravações para garantir persistência.
3. Monitoramento de Espaço:
   • Utilize nvs_get_stats() regularmente para monitorar o uso e identificar problemas de fragmentação.
4. Logs Detalhados:
   • Habilite logs detalhados no menuconfig:

     Component config -> NVS -> Enable debug logs
     

   • Isso ajuda a identificar falhas em operações de leitura e gravação.

Práticas Recomendadas para Diagnóstico

• Sempre trate os erros retornados pelas funções da NVS.
• Antes de apagar a NVS, realize backups dos dados críticos.
• Execute testes regulares em dispositivos reais para identificar problemas de comportamento.

Internals da NVS: Logs e Mecanismos de Paginação

A arquitetura interna da NVS foi projetada para ser eficiente e confiável, utilizando um sistema baseado em logs e paginação para organizar os dados armazenados. Esta abordagem permite operações robustas mesmo em condições adversas, como falhas de energia ou acessos frequentes.

Armazenamento Baseado em Logs

A NVS usa um modelo de armazenamento sequencial, onde novos dados são adicionados ao final de um log. Isso significa que:

1. Escrita Não Sobrescreve Dados:
   • Quando um valor é atualizado, a nova versão é gravada no final do log, enquanto a entrada antiga é marcada como apagada.
   • Esse modelo minimiza o desgaste da memória flash ao evitar reescritas frequentes em setores já utilizados.
2. Organização das Entradas:
   • Cada entrada no log contém:
     • Uma chave única.
     • Um valor associado.
     • Metadados, como tipo de dado e informações de integridade.
3. Compactação:
   • Quando um log fica cheio ou fragmentado, a NVS move os dados válidos para uma nova página, liberando espaço para novas gravações.

Mecanismo de Paginação

O armazenamento da NVS é dividido em páginas, que são setores lógicos da memória flash, geralmente de 4 KB cada.

1. Estados das Páginas:
   • Vazia: Nenhuma gravação foi feita.
   • Ativa: Dados estão sendo gravados; ainda há espaço disponível.
   • Cheia: A página atingiu sua capacidade máxima.
   • Corrompida: Dados inválidos ou inconsistentes; a página não é utilizada.
2. Gerenciamento de Páginas:
   • Páginas em uso possuem números de sequência, permitindo que a NVS determine a ordem de gravação.
   • Páginas corrompidas são ignoradas durante as operações de leitura.
3. Estrutura de Página:
   • Cabeçalho:
     • Inclui informações como estado da página, número de sequência e checksum.
   • Entradas:
     • Dados reais armazenados em blocos de 32 bytes.
   • Bitmap de Estado:
     • Indica se uma entrada está vazia, ocupada ou apagada.

Exemplo de Organização Interna

Imagine um cenário com quatro páginas na NVS:

+--------+     +--------+     +--------+     +--------+
| Página 1 |     | Página 2 |     | Página 3 |     | Página 4 |
| Cheia   |     | Cheia   |     | Ativa   |     | Vazia   |
| Seq #10 |     | Seq #11 |     | Seq #12 |     |        |
+---+----+     +----+---+     +----+---+     +---+----+

• Página 1 e 2:
  • Contêm dados completos, mas não podem receber novas gravações.
• Página 3:
  • Está ativa e pode gravar novos pares de chave-valor.
• Página 4:
  • Está vazia e será usada quando a Página 3 estiver cheia.

Benefícios do Modelo

1. Minimiza o Desgaste da Flash:
   • Como os dados são gravados sequencialmente, as operações de apagamento são realizadas apenas quando necessário.
2. Resistência a Falhas:
   • Em caso de falha de energia durante a gravação, os dados existentes permanecem intactos, e a operação pode ser retomada na inicialização.
3. Gerenciamento de Fragmentação:
   • O mecanismo de compactação reorganiza os dados para liberar espaço, reduzindo a fragmentação.

Exemplo de Compactação Automática

A NVS realiza automaticamente a compactação quando uma página ativa está cheia. Os dados válidos são movidos para uma nova página, enquanto a antiga é apagada e reinicializada.

Exemplo de Log Interno

Página Ativa:
+------------+-----------------+-----------------+
| Entrada 1  | Entrada 2       | Entrada 3       |
+------------+-----------------+-----------------+

Página Nova:
+------------+-----------------+-----------------+
| Entrada 2  | Entrada 3       | Entrada 4       |
+------------+-----------------+-----------------+

• Entradas apagadas ou inválidas são descartadas durante a movimentação.

Diagnóstico com Páginas

1. Identificação de Páginas Corrompidas:
   • Utilize logs detalhados (menuconfig -> Enable debug logs) para monitorar a saúde das páginas.
2. Verificação de Espaço:
   • Use nvs_get_stats() para verificar o uso de entradas em cada página.

Melhores Práticas para Uso da NVS em Produção

O uso eficiente da NVS (Non-Volatile Storage) no ESP32 é essencial para garantir a longevidade e confiabilidade das aplicações. Abaixo estão as melhores práticas que você pode implementar para aproveitar ao máximo os recursos da NVS, minimizando os problemas de desempenho e desgaste da memória flash.

1. Otimize o Tamanho da Partição NVS

• Configure o tamanho da partição NVS com base no volume de dados que será armazenado.
• Use a tabela de partições para ajustar o espaço disponível:

  nvs,      data, nvs,     0x9000,  0x6000
  

  • Neste exemplo, a partição NVS começa no endereço 0x9000 e possui 24 KB (0x6000).

2. Use Namespaces para Organizar os Dados

• Divida os dados entre namespaces para evitar conflitos e facilitar o gerenciamento.
• Exemplo:
  • Namespace wifi para configurações de rede.
  • Namespace sensor para dados de sensores.

Benefícios:

• Permite a coexistência de diferentes módulos sem sobrescritas acidentais.
• Facilita a depuração e o backup de dados.

3. Reduza o Número de Gravações

• A memória flash tem um ciclo de vida limitado, geralmente entre 10.000 e 100.000 ciclos de gravação por setor.
• Minimize gravações frequentes:
  • Use buffers na RAM para armazenar dados temporários e grave na NVS apenas quando necessário.
  • Combine múltiplas alterações em uma única operação de gravação.

Exemplo:

Grave contadores de eventos somente após atingir um múltiplo de 10:

int event_count = 0;

// Incremento em RAM
event_count++;

// Gravação condicional na NVS
if (event_count % 10 == 0) {
    nvs_set_i32(my_handle, "event_count", event_count);
    nvs_commit(my_handle);
}

4. Monitore o Uso de Memória

• Use a função nvs_get_stats() para monitorar a utilização da NVS e identificar fragmentação ou falta de espaço.
• Exemplo:

nvs_stats_t stats;
nvs_get_stats(NULL, &stats);
printf("Usadas: %lu, Livres: %lu, Total: %lu\n",
       stats.used_entries, stats.free_entries, stats.total_entries);

5. Proteja Dados Sensíveis com Criptografia

• Habilite a criptografia da NVS para proteger dados como credenciais e chaves de API.
• Configure no menuconfig:

  Component config -> NVS -> Enable NVS encryption
  

6. Trate os Códigos de Erro Adequadamente

• Sempre verifique os códigos de retorno das funções da NVS para tratar erros como:
  • ESP_ERR_NVS_NOT_FOUND: Chave inexistente.
  • ESP_ERR_NVS_INVALID_HANDLE: Handle inválido.
  • ESP_ERR_NVS_NOT_ENOUGH_SPACE: Falta de espaço.

Exemplo:

esp_err_t err = nvs_get_i32(my_handle, "key", &value);
if (err == ESP_ERR_NVS_NOT_FOUND) {
    printf("Chave não encontrada.\n");
} else if (err != ESP_OK) {
    printf("Erro ao acessar a NVS: %s\n", esp_err_to_name(err));
}

7. Execute Backup de Dados Periódicos

• Para evitar perda de dados importantes, implemente um mecanismo de backup que exporte os dados da NVS para outro sistema (como um servidor ou cartão SD).
• Use um iterador para listar todas as chaves e seus valores:

nvs_iterator_t it = NULL;
esp_err_t res = nvs_entry_find(NULL, NULL, NVS_TYPE_ANY, &it);
while (res == ESP_OK) {
    nvs_entry_info_t info;
    nvs_entry_info(it, &info);
    printf("Namespace: %s, Chave: %s\n", info.namespace_name, info.key);
    res = nvs_entry_next(&it);
}
nvs_release_iterator(it);

8. Teste em Condições Reais

• Simule falhas de energia e reinicializações durante operações de gravação para garantir que os dados não sejam corrompidos.
• Use ferramentas como o monitor serial do ESP-IDF para depuração em tempo real.

9. Atualize Regularmente o Firmware

• A Espressif constantemente atualiza o ESP-IDF para melhorar a estabilidade da NVS.
• Mantenha o ambiente de desenvolvimento atualizado para evitar bugs e aproveitar novos recursos.

10. Planeje o Ciclo de Vida do Produto

• Se a aplicação grava frequentemente na NVS, considere estratégias para aumentar a durabilidade:
  • Divida os dados em múltiplas partições.
  • Utilize memórias externas, como FRAM ou EEPROM, para dados de alta frequência.

Resumo das Melhores Práticas

Exemplos de Aplicações Reais Usando NVS

A NVS (Non-Volatile Storage) é amplamente utilizada em projetos baseados no ESP32 para armazenamento persistente de dados críticos. Nesta seção, apresentamos exemplos práticos de casos de uso para ilustrar como a NVS pode ser aplicada em cenários reais.

1. Armazenamento de Configurações de Rede

O ESP32 é frequentemente usado em aplicações IoT que exigem conectividade Wi-Fi. A NVS pode armazenar as credenciais da rede, como SSID e senha, permitindo que o dispositivo se reconecte automaticamente após uma reinicialização.

Exemplo: Configurações de Wi-Fi

#include <stdio.h>
#include "nvs_flash.h"
#include "nvs.h"
#include "esp_wifi.h"

void save_wifi_config(const char *ssid, const char *password) {
    nvs_handle_t handle;
    esp_err_t err = nvs_open("wifi_config", NVS_READWRITE, &handle);
    if (err == ESP_OK) {
        nvs_set_str(handle, "ssid", ssid);
        nvs_set_str(handle, "password", password);
        nvs_commit(handle);
        nvs_close(handle);
        printf("Configurações de Wi-Fi salvas!\n");
    } else {
        printf("Erro ao abrir a NVS para Wi-Fi: %s\n", esp_err_to_name(err));
    }
}

void read_wifi_config(char *ssid, size_t ssid_len, char *password, size_t pass_len) {
    nvs_handle_t handle;
    esp_err_t err = nvs_open("wifi_config", NVS_READONLY, &handle);
    if (err == ESP_OK) {
        nvs_get_str(handle, "ssid", ssid, &ssid_len);
        nvs_get_str(handle, "password", password, &pass_len);
        nvs_close(handle);
        printf("Configurações de Wi-Fi lidas!\n");
    } else {
        printf("Erro ao ler configurações de Wi-Fi: %s\n", esp_err_to_name(err));
    }
}

void app_main(void) {
    nvs_flash_init();

    // Salva configurações de Wi-Fi
    save_wifi_config("MinhaRede", "Senha123");

    // Lê configurações de Wi-Fi
    char ssid[32], password[64];
    read_wifi_config(ssid, sizeof(ssid), password, sizeof(password));

    printf("SSID: %s, Senha: %s\n", ssid, password);
}

2. Contadores Persistentes

Em aplicações industriais ou de monitoramento, o ESP32 pode precisar rastrear eventos, como reinicializações ou leituras de sensores. A NVS pode armazenar contadores de forma persistente.

Exemplo: Contador de Reinicializações

#include <stdio.h>
#include "nvs_flash.h"
#include "nvs.h"

void app_main(void) {
    nvs_flash_init();

    nvs_handle_t handle;
    esp_err_t err = nvs_open("system_data", NVS_READWRITE, &handle);
    if (err == ESP_OK) {
        int32_t restart_counter = 0;
        nvs_get_i32(handle, "restart_counter", &restart_counter);
        restart_counter++;
        nvs_set_i32(handle, "restart_counter", restart_counter);
        nvs_commit(handle);
        nvs_close(handle);

        printf("O dispositivo reiniciou %d vezes.\n", restart_counter);
    } else {
        printf("Erro ao acessar a NVS: %s\n", esp_err_to_name(err));
    }
}

3. Configurações de Sensores

Sensores conectados ao ESP32 podem exigir calibração ou parâmetros configuráveis, como intervalos de leitura. Esses valores podem ser armazenados na NVS para persistência.

Exemplo: Configuração de Sensores

typedef struct {
    float offset;
    float scale;
} sensor_config_t;

void save_sensor_config(float offset, float scale) {
    nvs_handle_t handle;
    esp_err_t err = nvs_open("sensor_data", NVS_READWRITE, &handle);
    if (err == ESP_OK) {
        sensor_config_t config = {offset, scale};
        nvs_set_blob(handle, "calibration", &config, sizeof(config));
        nvs_commit(handle);
        nvs_close(handle);
        printf("Configuração do sensor salva!\n");
    } else {
        printf("Erro ao salvar configuração do sensor: %s\n", esp_err_to_name(err));
    }
}

void read_sensor_config(sensor_config_t *config) {
    nvs_handle_t handle;
    esp_err_t err = nvs_open("sensor_data", NVS_READONLY, &handle);
    if (err == ESP_OK) {
        size_t size = sizeof(*config);
        nvs_get_blob(handle, "calibration", config, &size);
        nvs_close(handle);
        printf("Configuração do sensor lida: Offset = %.2f, Escala = %.2f\n",
               config->offset, config->scale);
    } else {
        printf("Erro ao ler configuração do sensor: %s\n", esp_err_to_name(err));
    }
}

4. Gerenciamento de Perfis de Usuário

Em dispositivos compartilhados, como leitores de cartões ou controladores de acesso, a NVS pode armazenar perfis de usuários com permissões ou configurações específicas.

Práticas Recomendadas para Aplicações Reais

1. Isolamento Lógico:
   • Use namespaces para separar os dados de diferentes módulos.
2. Verificação de Integridade:
   • Valide os dados lidos da NVS antes de usá-los na aplicação.
3. Backup e Recuperação:
   • Implemente mecanismos de backup para evitar perda de dados críticos.

FAQ: Respostas a Problemas Comuns com NVS

Nesta seção, abordamos as dúvidas e problemas mais frequentes relacionados ao uso da NVS no ESP32, fornecendo soluções práticas para cada caso.

1. Por que recebo o erro ESP_ERR_NVS_NOT_FOUND ao tentar ler uma chave?

• Causa: A chave especificada não existe no namespace ou foi apagada.
• Solução:
  • Certifique-se de que a chave foi gravada previamente com nvs_set_*().
  • Verifique se o namespace está correto.
  • Use um valor padrão ao inicializar a variável, como mostrado no exemplo:

    int32_t value = 0; // Valor padrão
    esp_err_t err = nvs_get_i32(my_handle, "key_name", &value);
    if (err == ESP_ERR_NVS_NOT_FOUND) {
        printf("Chave não encontrada. Usando valor padrão: %d\n", value);
    }
    

2. O que fazer quando recebo ESP_ERR_NVS_NOT_ENOUGH_SPACE?

• Causa: Não há espaço suficiente na partição NVS para salvar novos dados.
• Solução:
  • Aumente o tamanho da partição NVS na tabela de partições.
  • Reduza a quantidade de dados armazenados ou apague chaves antigas:

    nvs_erase_key(my_handle, "old_key");
    nvs_commit(my_handle);
    

  • Use nvs_get_stats() para monitorar o uso de memória.

3. Como tratar ESP_ERR_NVS_INVALID_STATE ou dados corrompidos?

• Causa: A NVS está em um estado inválido, possivelmente devido a falhas de energia durante gravações.
• Solução:
  • Apague e reinicialize a partição NVS:

    esp_err_t err = nvs_flash_erase();
    if (err == ESP_OK) {
        nvs_flash_init();
    }
    

4. É possível alterar o tamanho máximo de uma string ou blob?

• Resposta: Sim, mas há limites físicos impostos pela memória flash:
  • Strings: Até 4000 bytes (incluindo terminador nulo).
  • Blobs: Até 508 KB ou 97,6% do tamanho da partição.
  • Certifique-se de que há espaço contíguo suficiente para armazenar os dados.

5. Como depurar erros inesperados durante operações da NVS?

• Solução:
  • Habilite logs detalhados no menuconfig:

    Component config -> NVS -> Enable debug logs
    

  • Use a função esp_err_to_name() para interpretar códigos de erro:

    esp_err_t err = nvs_set_i32(my_handle, "key", value);
    if (err != ESP_OK) {
        printf("Erro: %s\n", esp_err_to_name(err));
    }
    

6. Por que a leitura de dados falha após uma atualização de firmware?

• Causa: A tabela de partições foi modificada, ou a partição NVS foi sobrescrita durante a atualização.
• Solução:
  • Certifique-se de que a tabela de partições é consistente entre as versões de firmware.
  • Se necessário, implemente migrações de dados ao atualizar o firmware.

7. Como lidar com limitações de ciclo de vida da memória flash?

• Solução:
  • Minimize gravações frequentes, combinando alterações em uma única operação.
  • Para dados de alta frequência, use memórias não voláteis externas, como FRAM ou EEPROM.

8. Posso compartilhar a NVS entre diferentes dispositivos?

• Resposta: Não diretamente, pois a NVS é projetada para armazenamento local. Para compartilhar dados:
  • Sincronize com um servidor remoto.
  • Use interfaces de comunicação como Wi-Fi ou Bluetooth.

9. Existe suporte para dados criptografados na NVS?

• Resposta: Sim, a NVS suporta criptografia nativa no ESP32. Certifique-se de habilitá-la no menuconfig e configurar a partição nvs_keys.

10. O que acontece se a NVS atingir sua capacidade máxima?

• Resposta:
  • Gravações adicionais falharão com o erro ESP_ERR_NVS_NOT_ENOUGH_SPACE.
  • Use nvs_erase_key() ou nvs_erase_all() para liberar espaço.

11. A NVS é segura contra alterações não autorizadas?

• Resposta: Com a criptografia habilitada, os dados armazenados na NVS estão protegidos contra leitura ou modificação não autorizada. No entanto, ela não é resistente ao apagamento físico dos dados.

12. Como restaurar dados padrões em caso de erro crítico?

• Solução:
  • Defina uma lógica para apagar e restaurar dados padrões:

    esp_err_t err = nvs_flash_erase();
    if (err == ESP_OK) {
        nvs_flash_init();
        save_default_values(); // Salva valores padrões
    }
    

Resumo e Conclusão do Guia sobre NVS

A Biblioteca de Armazenamento Não Volátil (NVS) é uma ferramenta essencial no desenvolvimento com ESP32, oferecendo uma maneira confiável e eficiente de armazenar dados persistentes. Este guia detalhou os principais conceitos, funcionalidades, melhores práticas e exemplos de uso da NVS, capacitando desenvolvedores a utilizá-la de forma otimizada em suas aplicações.

Recapitulando os Principais Pontos

1. Introdução à NVS:
   • A NVS armazena pares de chave-valor em memória flash, com suporte para tipos de dados como inteiros, strings e blobs.
   • Ideal para armazenar configurações, estados de sensores e contadores persistentes.
2. Estrutura Interna e Funcionamento:
   • Baseada em logs e páginas para garantir integridade e minimizar desgaste da memória flash.
   • Gerencia automaticamente fragmentação e compactação.
3. Segurança:
   • Suporte para criptografia nativa protege dados sensíveis contra acesso não autorizado.
4. Melhores Práticas:
   • Use namespaces para organizar dados.
   • Minimize gravações frequentes para prolongar a vida útil da memória.
   • Monitore o uso de memória com ferramentas como nvs_get_stats().
5. Exemplos Reais:
   • Configurações de rede.
   • Contadores persistentes.
   • Dados de calibração de sensores.
6. Diagnóstico e Soluções de Problemas:
   • Métodos para identificar e corrigir erros, como ESP_ERR_NVS_NOT_FOUND ou ESP_ERR_NVS_NOT_ENOUGH_SPACE.

Destaques e Benefícios

• Persistência Confiável: Os dados armazenados permanecem intactos mesmo após falhas de energia ou reinicializações.
• Flexibilidade: Suporta diferentes tipos de dados e estruturas, com APIs intuitivas para leitura e gravação.
• Robustez: Projetada para resistir a falhas e minimizar fragmentação.

Recomendações Finais

1. Planeje a Estrutura da NVS:
   • Determine o tamanho ideal da partição e os namespaces necessários antes de implementar.
2. Teste em Condições Reais:
   • Simule cenários como falhas de energia durante gravações para validar a integridade dos dados.
3. Implemente Rotinas de Backup:
   • Para dados críticos, considere exportar periodicamente os dados da NVS para um servidor remoto ou dispositivo de armazenamento externo.
4. Atualize Regularmente o ESP-IDF:
   • Mantenha o framework atualizado para aproveitar melhorias e correções de bugs relacionados à NVS.

Próximos Passos

Se você deseja explorar mais sobre a NVS ou tecnologias relacionadas ao ESP32, considere:

• Desenvolver exemplos avançados: Como integrar a NVS com sistemas de arquivos FAT ou serviços de nuvem.
• Aprender sobre outras APIs de armazenamento do ESP-IDF: Como a SPIFFS ou LittleFS.
• Aprofundar-se em segurança embarcada: Implementar sistemas de proteção de dados completos.

Com este guia, você está pronto para utilizar a NVS de forma eficaz em seus projetos com ESP32.

The post Introdução à Biblioteca de Armazenamento Não Volátil (NVS) no ESP32-IDF first appeared on MCU & FPGA.