Bir ESP32'de ayarları kaydetmek Preferences ile
Ya da tüm dersleri gör.
- 526parça tezgahta
- 46kart şu an çalışıyor
- 1.00xgerçek zamanlı, her kartta
Preferences kütüphanesi, bir ESP32 kodunun elektrik kesildikten sonra bir sayıyı ya da metini hatırlamasını sağlar: bir WiFi parolası, bir kalibrasyon değeri, bir sayaç. ESP32 çekirdeğiyle birlikte gelir, yani kurulacak bir şey yoktur. begin() ile bir ad alanı açarsın, doğru türdeki put ve get çağrılarıyla anahtar üzerinden değerleri kaydedip okursun ve end() ile kapatırsın. Arka planda değerler, flash bellekteki küçük bir anahtar-değer deposu olan NVS'te saklanır.
Yukarıdaki devre tek başına bir ESP32 DevKit; seri monitör tüm arayüz. Aşağıda klasik açılış sayacı, varsayılan değerli dizgiler, bir put'un 0 döndürmesine yol açan kurallar ve bunun EEPROM ile karşılaştırması var.
Açılış sayacı
Çoğu eğitimin başladığı örnek budur. begin("my-app", false), "my-app" ad alanını yazma için açar ve ilk seferde oluşturur. getUInt("counter", 0) anahtarı okur, henüz yoksa 0 döndürür. Kod bir ekler, yazdırır, putUInt() ile saklar ve ad alanını kapatır.
Bir kartta her sıfırlama ve her güç döngüsü sonraki sayıyı yazdırır. Burada ilk çalıştırma "Boot count: 1" yazdırdı ve her sayımdan sonra ESP.restart() ile "Boot count: 2" ve ardından "Boot count: 3" yazdırdı, çünkü yeniden başlatma saklanan değerleri korur. Mokxi'nin ESP32'sinin arkasında flash yoktur, bu yüzden Preferences RAM'de yaşar: ESP.restart()'ten sonra da varlıklarını sürdürür, yeni bir Çalıştır ya da EN düğmesi sayacı 1'den başlatır. Çağrılar ve yanıtlar core'a aittir; yalnızca ömür daha kısadır.
#include <Preferences.h>
Preferences prefs;
void setup() {
Serial.begin(115200);
prefs.begin("my-app", false);
unsigned int count = prefs.getUInt("counter", 0);
count++;
Serial.printf("Boot count: %u\n", count);
prefs.putUInt("counter", count);
prefs.end();
if (count < 3) {
delay(100);
ESP.restart();
}
}
void loop() {
}Bu kodu düzenleyicide açSadece kod: düzenleyici, kartı ve koddan okuyabildiği parçaları yerleştirir.
Dizgiler, varsayılanlar ve diğer tüm türler
Her türün kendi çağrı çifti vardır: putInt/getInt, putUInt, putLong, putFloat, putBool, putString/getString ve struct için putBytes. Bir anahtarı, sakladığın türle aynı türle oku. putFloat("t", 21.5) ile saklanan bir float, getFloat("t", 0) çağrısından 21.50 olarak geri geldi.
Her get, anahtar yokken döndürülen bir varsayılan alır, böylece bir kodun ilk çalışması için özel bir duruma gerek kalmaz. putString("ssid", "HomeNet") sonrasında getString("ssid", "none") "HomeNet" yazdırdı ve getString("pass", "none") "none" yazdırdı. WiFi ayarları için desen budur: setup() içinde bunları varsayılanla oku ve yalnızca varsayılanı geri aldığında yeni ayarları iste.
isKey("ssid"), anahtar varken 1 yazdırdı; remove("ssid") sonrasında 0 yazdırdı. clear(), açık ad alanındaki her anahtarı siler ve diğerlerine dokunmaz.
#include <Preferences.h>
Preferences prefs;
void setup() {
Serial.begin(115200);
prefs.begin("wifi", false);
prefs.putString("ssid", "HomeNet");
Serial.println(prefs.getString("ssid", "none"));
Serial.println(prefs.getString("pass", "none"));
Serial.println(prefs.isKey("ssid"));
prefs.remove("ssid");
Serial.println(prefs.isKey("ssid"));
prefs.end();
}
void loop() {
}Bu kodu düzenleyicide açSadece kod: düzenleyici, kartı ve koddan okuyabildiği parçaları yerleştirir.
putBytes ile tüm bir struct'ı kaydetmek
Bir kodda birkaç ayar varsa hepsini tek bir struct içinde tutup tek çağrıyla kaydetmek, her biri için ayrı bir anahtar kullanmaktan daha derli topludur. putBytes(key, &settings, sizeof(settings)), struct'ın bellekte durduğu haliyle baytlarını saklar ve getBytes(key, &settings, sizeof(settings)) onları geri kopyalar. İkisi de taşıdıkları bayt sayısını döndürür. Aşağıdaki kodda her biri 8 döndürdü, yani bir ESP32'de bir int ve bir float boyutu, ve struct 180 parlaklık ve -1.50 sapma değerleriyle geri geldi.
Okuduğuna güvenmeden önce getBytesLength(key) değerini sizeof ile karşılaştır. Struct'a sonradan bir alan eklersen eski sürümün kayıtlı kopyası daha kısa olur ve okunduğunda yeni alanda orada ne varsa o kalır. İlk çalıştırmada anahtar henüz yoktur, getBytesLength() 0 döndürür ve kod başladığı varsayılanlarla devam eder. Burada ilk put'tan önce 0, sonrasında 8 yazdırdı.
#include <Preferences.h>
struct Settings {
int brightness;
float offset;
};
Preferences prefs;
Settings settings = {128, 0.0};
void setup() {
Serial.begin(115200);
prefs.begin("my-app", false);
Serial.println(prefs.getBytesLength("settings"));
Settings changed = {180, -1.5};
Serial.println(prefs.putBytes("settings", &changed, sizeof(changed)));
Serial.println(prefs.getBytesLength("settings"));
if (prefs.getBytesLength("settings") == sizeof(settings)) {
Serial.println(prefs.getBytes("settings", &settings, sizeof(settings)));
}
Serial.println(settings.brightness);
Serial.println(settings.offset);
prefs.end();
}
void loop() {
}Bu kodu düzenleyicide açSadece kod: düzenleyici, kartı ve koddan okuyabildiği parçaları yerleştirir.
Bir put 0 döndürdüğünde
Her put, sakladığı bayt sayısını, hiçbir şey saklamadığında ise 0 döndürür. putUInt() iyi bir anahtar için 4 döndürdü. Dört hata onun 0 döndürmesini sağlar ve her biri burada bilerek yapıldı:
A key longer than 15 characters. "key_with_15chrs" stored 4 bytes; "a_key_with_16chr", one character longer, returned 0. Namespaces have the same limit, and begin("a_namespace_too_long", false) returned 0, so every call after it failed too. A namespace opened read-only: after begin("wifi", true), putUInt("x", 1) returned 0 while gets still worked. And no begin() at all: putUInt("x", 1) returned 0 and getUInt("x", 7) gave back the default, 7.
Anahtarlar ad alanına özgüdür. "wifi" altında saklanan bir anahtar "other" üzerinden bulunamadı ve o da varsayılanı olan 99'u döndürdü. İki kütüphane farklı ad alanları kullandığı sürece "mode" adında bir anahtarı çakışma olmadan kullanabilir.
ESP32'de Preferences mı EEPROM mu?
ESP32'de EEPROM çipi yoktur. ESP32'de EEPROM.h, bir flash bölümünde taklit edilir: önce EEPROM.begin(size) çağırırsın, yazdıktan sonra EEPROM.commit() çağırırsın, yoksa hiçbir şey kaydedilmez. Burada EEPROM.write(0, 42) ve ardından commit() 1 döndürdü ve read(0) 42 verdi. Bu, Uno'dan taşınan kodlar için oradadır.
Yeni kod için Preferences daha iyi bir seçimdir. Adrese göre değil adla saklarsın, her değer tipini korur ve NVS yazmaları bölümün sayfalarına yayar, bu da önemlidir çünkü flash birçok silme döngüsünden sonra yıpranır. Hangisini seçersen seç, değeri her loop() turunda değil, değiştiğinde yaz.
Bu devreyi düzenleyicide aç. ESP32 DevKit: bu sayfanın üstünde çalıştığı haliyle kablolanmış seri monitör. Bir parçayı veya değeri değiştirip yeniden çalıştır.
Sorular
ESP32 Preferences kütüphanesi verileri nerede saklar?
NVS'de, flash'ın bir bölümündeki anahtar-değer deposunda, yani değerler sıfırlamalarda ve güç kesintilerinde korunur. Mokxi'de RAM'de tutulurlar, bu da ESP.restart()'i atlatır ama yeni bir Çalıştır'ı atlatamaz.
Why does my Preferences put return 0?
Anahtar veya ad alanı 15 karakterden uzundur, begin() çağrılmamıştır veya başarısız olmuştur, ya da ad alanı begin(name, true) ile salt okunur açılmıştır.
ESP32 Preferences ile bir dizgiyi nasıl kaydederim?
Saklamak için prefs.putString("ssid", value), geri okumak için prefs.getString("ssid", "none"); hiç saklanmadıysa "none" döner.
ESP32'de Preferences mı EEPROM mu kullanmalıyım?
Preferences. ESP32'de EEPROM yoktur ve EEPROM.h flash'ta bir EEPROM taklit eder, commit() gerektirir. Preferences tipli değerleri adla saklar.
Arduino IDE için ESP32 preferences bağlantısı nedir?
O, IDE'nin kendi Preferences penceresine girilen kart yöneticisi URL'sidir: https://espressif.github.io/arduino-esp32/package_esp32_index.json, Espressif'in kurulum kılavuzundan.
Devam et
Bu sayfadaki bilgiler nereden geliyor
Bunu gerçekten kur
Düzenleyiciyi aç, bir değeri değiştir ve sayının onunla birlikte değiştiğini izle. Kurulacak bir şey yok, hesaba da gerek yok.