警告

This document is not updated for ESP32C5 yet, so some of the content may not be correct.

This warning was automatically inserted due to the source file being in the add_warnings_pages list.

NVS 分区解析程序

[English]

介绍

NVS 分区解析程序 nvs_flash/nvs_partition_tool/nvs_tool.py 加载并解析 NVS 存储分区,以便于调试和数据提取。该程序还支持完整性检查功能,可扫描分区中可能存在的错误。Blob 数据以 base64 格式进行编码。

加密分区

此程序不支持解密。如需解密 NVS 分区,请使用 NVS 分区生成程序。该工具支持 NVS 分区加解密。

使用方法

该程序提供了 -f-format 选项,对应两种不同的输出格式:
  • json - 所有输出均以 JSON 格式打印。

  • text - 输出以可读文本的格式打印,有以下输出格式可选。

针对 text 输出格式,该程序提供了 -d-dump 选项,包含六种不同的输出方式:
  • all (默认) - 打印所有带有元数据的条目。

  • written - 只打印带有元数据的写入条目。

  • minimal - 打印写入的 namespace:key = value 对。

  • namespaces - 打印所有写入的命名空间。

  • blobs - 打印所有 blob 和字符串(若 blob 和字符串是以分块的形式,则对其进行重组)。

  • storage_info - 打印每一页面的条目状态计数。

注意

该程序还提供 none 选项,该选项不会打印任何内容。如果 NVS 分区的内容并不相关,可以将该选项和完整性检查选项一起使用。

该程序支持完整性检查功能,选择选项 -i--integrity-check 即可运行(该选项会导致 json 输出格式无效,因此只适用于 text 格式)。此功能可扫描整个分区,并打印出可能存在的错误。当此功能和 -d none 一起使用时,可只打印可能存在的错误。