描述

介紹

當設備重置或斷電時，寫入 ESP32 的非易失性存儲 (NVS) 的數(shù)據(jù)將保留。這使得 NVS 成為永久存儲配置或校準數(shù)據(jù)的有用場所。本教程提供了使用帶有esp32-preferences 庫的XOD 可視化編程語言訪問 NVS 的指南。

XOD esp32-preferences 庫是Espressif 的偏好 Arduino 庫的包裝器。它將數(shù)據(jù)作為鍵值對存儲在 NVS 中。鍵是在命名空間中定義的，以確保它們是唯一的。如果您之前沒有遇到過命名空間這個術(shù)語，那么熟悉的示例就是您計算機上的文件目錄。目錄是命名空間，在目錄中所有文件名（鍵）必須是唯一的。兩個不同的目錄（命名空間）可以各自包含一個名為“readme.txt”的文件（鍵）。

將 ESP32 板添加到 XOD IDE

您不會在 XOD IDE 的板模型列表中找到 ESP32，但可以輕松添加它。

ESP32 在 XOD IDE（版本 0.38.0）中默認不可用。

?

在您的用戶目錄中，您將找到一個名為 xod 的目錄。此目錄中有一個名為 extra.txt 的文件。

Windows 10 上 extra.txt 文件的位置。

?

將以下行添加到 extra.txt 文件中：

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json

額外的.txt

?

此行是描述 ESP32 板的JSON文件的 URL。ESP32開發(fā)模塊現(xiàn)在應該出現(xiàn)在 XOD IDE 的板模型列表中；如果沒有，請單擊刷新按鈕：

板菜單上列出的 ESP32 開發(fā)模塊

?

當您第一次嘗試將補丁上傳到 ESP32 時，系統(tǒng)會提示您安裝依賴項。單擊下載并安裝。

Arduino 依賴項丟失消息

?

XOD IDE 將顯示一條消息以確認已成功安裝依賴項：

安裝了 Arduino 依賴項

?

安裝 esp32-preferences 庫

我們現(xiàn)在準備安裝esp32-preferences 庫。在 XOD IDE 中，點擊“文件 → 添加庫”并輸入完整的庫名稱：

wayland/esp32-preferences

有關(guān)更多信息，請參閱使用庫。

添加 esp32-preferences 庫

?

在 IDE 工作區(qū)中安裝后，該庫將在項目瀏覽器中可見。要找出節(jié)點的功能，請選擇節(jié)點并點擊H以調(diào)用幫助：

幫助

?

esp32-preferences 庫的節(jié)點

首選項節(jié)點創(chuàng)建一個代表 NVS 的首選項對象。使用esp32-prefrences 庫的所有補丁都需要首選項節(jié)點。

首選項對象節(jié)點

?

提供了各種動作節(jié)點來對首選項對象進行操作。開始節(jié)點打開指定的命名空間。如果 RO（只讀）設置為 false，則存儲將以讀/寫模式打開。如果命名空間不存在，則如果 RO 設置為 False，則會創(chuàng)建該命名空間。端節(jié)點將關(guān)閉打開的命名空間。

用于打開和關(guān)閉命名空間的節(jié)點。

?

使用 put 節(jié)點將數(shù)據(jù)存儲為鍵值對。支持三種數(shù)據(jù)類型，字節(jié)( put-byte )、數(shù)字( put-number ) 和字符串( put-string )。

用于存儲鍵值對的節(jié)點。

?

get-byte 、get-number和get-string節(jié)點用于從開放命名空間中檢索數(shù)據(jù)。

用于檢索由鍵標識的值的節(jié)點。

?

可以使用刪除節(jié)點從打開的命名空間中刪除鍵值對。此功能在庫的example-remove-key補丁中進行了演示。

用于從命名空間中刪除鍵值對的節(jié)點。

?

可以使用clear節(jié)點從開放的命名空間中刪除所有鍵值對（參見example-store-retrieve ）。

用于從命名空間中刪除所有鍵值對的節(jié)點。

?

可以使用erase-nvs節(jié)點擦除和重新初始化整個 NVS（參見example-erase-nvs ）。

用于擦除和重新初始化非易失性存儲的節(jié)點。

?

存儲數(shù)據(jù)

下面是一個演示如何在 NVS 中存儲數(shù)據(jù)的補丁。在本例中，我們將 Pi 的值存儲在名為“數(shù)學常量”的命名空間中。begin節(jié)點以讀/寫模式打開“math constants”命名空間（如果“math constants”命名空間不存在，begin節(jié)點將創(chuàng)建它）。put-number節(jié)點將Pi 的值存儲為一個數(shù)字，由鍵“pi”標識。寫入鍵值對后，使用端節(jié)點關(guān)閉命名空間。

用于演示寫入 NVS 的補丁。

?

NB XOD 有一個Pi節(jié)點，因此實際上不需要存儲 Pi 的值。

檢索數(shù)據(jù)

下面的補丁演示了如何在前面的示例中檢索數(shù)據(jù)存儲。命名空間“數(shù)學常量”可以只讀模式打開，因為不會寫入任何內(nèi)容。可以使用 get-number 節(jié)點檢索由鍵“pi”標識的值。格式數(shù)字節(jié)點用于將“pi”的值顯示到小數(shù)點后六位（默認情況下，數(shù)字將四舍五入到小數(shù)點后兩位）。在調(diào)試器中運行補丁并使用tweak-pulse節(jié)點發(fā)送一個脈沖來啟動從NVS讀取的過程。

用于演示從 NVS 讀取的補丁。

?

引導計數(shù)器

esp32-preferences 庫包含一個示例啟動計數(shù)補丁，它記錄微控制器已啟動的次數(shù)并在 I2C LCD 上顯示計數(shù)。補丁本身提供了詳細的注釋，因此這里不再提供進一步的解釋。

引導計數(shù)器的補丁。

?

I2C LCD 使用四根線連接到 ESP32：

• LCD接地- ESP32接地
• LCD VCC – ESP32 5V
• LCD SDA – ESP32 GPIO21
• LCD SCL – ESP32 GPIO22

在上傳補丁后的第一次啟動時，LCD 應該顯示一個計數(shù)。計數(shù)將在每次后續(xù)啟動時遞增。

啟動計數(shù)器正在運行。

?

概括

esp32-preferences 庫對于需要在 ESP32 的 NVS 中存儲數(shù)據(jù)的 xoders 應該很有用。請注意，盡管您可以從 NVS 讀取任意次數(shù)，但寫入周期數(shù)限制為 100、000 到 1、000、000（請參閱https://randomnerdtutorials.com/esp32-flash-memory/ ）。