mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
34 lines
1.9 KiB
ReStructuredText
34 lines
1.9 KiB
ReStructuredText
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` 一起使用时，可只打印可能存在的错误。
|