NVS 分区解析程序
======================

:link_to_translation:`en:[English]`

介绍
-------

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

加密分区
-----------

此程序不支持解密。如需解密 NVS 分区，请使用 :doc:`NVS 分区生成程序 </api-reference/storage/nvs_partition_gen>`。该工具支持 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` 一起使用时，可只打印可能存在的错误。