使用XOD訪問ESP32非易失性存儲

2512892 2023-06-15 | zip | 0.00 MB | 次下載 | 免費

資料介紹

描述

介紹

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

XOD esp32-preferences 庫是Espressif 的偏好 Arduino 庫的包裝器。它將數據作為鍵值對存儲在 NVS 中。鍵是在命名空間中定義的，以確保它們是唯一的。如果您之前沒有遇到過命名空間這個術語，那么熟悉的示例就是您計算機上的文件目錄。目錄是命名空間，在目錄中所有文件名（鍵）必須是唯一的。兩個不同的目錄（命名空間）可以各自包含一個名為“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開發模塊現在應該出現在 XOD IDE 的板模型列表中；如果沒有，請單擊刷新按鈕：

板菜單上列出的 ESP32 開發模塊

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

Arduino 依賴項丟失消息

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

安裝了 Arduino 依賴項

安裝 esp32-preferences 庫

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

wayland/esp32-preferences

有關更多信息，請參閱使用庫。

添加 esp32-preferences 庫

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

幫助

esp32-preferences 庫的節點

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

首選項對象節點

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

用于打開和關閉命名空間的節點。

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

用于存儲鍵值對的節點。

get-byte 、get-number和get-string節點用于從開放命名空間中檢索數據。

用于檢索由鍵標識的值的節點。

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

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

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

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

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

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

存儲數據

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

用于演示寫入 NVS 的補丁。

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

檢索數據

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

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

引導計數器

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

引導計數器的補丁。

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

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

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

啟動計數器正在運行。

概括

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