描述

介紹

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

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

將 ESP32 板添加到 XOD IDE

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

ESP32 在 XOD IDE（版本 0.38.0）中默認(rèn)不可用。

?

在您的用戶目錄中，您將找到一個(gè)名為 xod 的目錄。此目錄中有一個(gè)名為 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)在應(yīng)該出現(xiàn)在 XOD IDE 的板模型列表中；如果沒有，請(qǐng)單擊刷新按鈕：

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

?

當(dāng)您第一次嘗試將補(bǔ)丁上傳到 ESP32 時(shí)，系統(tǒng)會(huì)提示您安裝依賴項(xiàng)。單擊下載并安裝。

Arduino 依賴項(xiàng)丟失消息

?

XOD IDE 將顯示一條消息以確認(rèn)已成功安裝依賴項(xiàng)：

安裝了 Arduino 依賴項(xiàng)

?

安裝 esp32-preferences 庫(kù)

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

wayland/esp32-preferences

有關(guān)更多信息，請(qǐng)參閱使用庫(kù)。

添加 esp32-preferences 庫(kù)

?

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

幫助

?

esp32-preferences 庫(kù)的節(jié)點(diǎn)

首選項(xiàng)節(jié)點(diǎn)創(chuàng)建一個(gè)代表 NVS 的首選項(xiàng)對(duì)象。使用esp32-prefrences 庫(kù)的所有補(bǔ)丁都需要首選項(xiàng)節(jié)點(diǎn)。

首選項(xiàng)對(duì)象節(jié)點(diǎn)

?

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

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

?

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

用于存儲(chǔ)鍵值對(duì)的節(jié)點(diǎn)。

?

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

用于檢索由鍵標(biāo)識(shí)的值的節(jié)點(diǎn)。

?

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

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

?

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

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

?

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

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

?

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

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

用于演示寫入 NVS 的補(bǔ)丁。

?

NB XOD 有一個(gè)Pi節(jié)點(diǎn)，因此實(shí)際上不需要存儲(chǔ) Pi 的值。

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

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

用于演示從 NVS 讀取的補(bǔ)丁。

?

引導(dǎo)計(jì)數(shù)器

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

引導(dǎo)計(jì)數(shù)器的補(bǔ)丁。

?

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

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

在上傳補(bǔ)丁后的第一次啟動(dòng)時(shí)，LCD 應(yīng)該顯示一個(gè)計(jì)數(shù)。計(jì)數(shù)將在每次后續(xù)啟動(dòng)時(shí)遞增。

啟動(dòng)計(jì)數(shù)器正在運(yùn)行。

?

概括

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