ذاكرة تنجو من إعادة التشغيل
مبتدئ
أو تصفّح كل الدروس.
- 526قطعة على المنضدة
- 46لوحة تعمل الآن
- 1.00xزمن حقيقي، على كل لوحة
كل ما في متغيرات كودك يضيع لحظة إعادة تشغيل Arduino أو انقطاع الطاقة عنه. هذا مناسب لمعظم الأشياء، لكن ليس لنتيجة قياسية عالية أو إعداد أو عدّاد تريد الاحتفاظ به. لهذه، تحتوي لوحة Uno على 1024 بايت من EEPROM داخل شريحتها: ذاكرة تحتفظ بمحتوياتها والطاقة مفصولة.
الدائرة أعلاه مجرد لوحة Uno، لأن EEPROM داخل الشريحة ولا حاجة لأي توصيلات. يكتب الكود قيمة int وقيمة long، ويقرأهما مجددًا، ويعدّ كم مرة اشتغل. افتح الشاشة التسلسلية، واضغط زر إعادة التشغيل على اللوحة، فيزداد العدد واحدًا. يعمل في متصفحك بالكود أدناه.
خمس نداءات تغطي كل شيء
أضف تضمين EEPROM.h فتحصل على خمس نداءات. يعطيك EEPROM.read(address) بايتًا واحدًا، من العنوان 0 إلى 1023 على Uno. ويخزن EEPROM.write(address, value) بايتًا واحدًا. ويخزنه EEPROM.update(address, value) فقط إذا كان مختلفًا عمّا هو موجود أصلًا، وهذا يوفّر التلف. ويخزن EEPROM.put(address, value) قيمة من أي نوع، int أو long أو float أو struct، مستخدمًا ما يحتاجه من البايتات. ويقرأ EEPROM.get(address, variable) قيمة إلى متغير من النوع نفسه.
أنت تختار العناوين بنفسك. حجم int بايتان على Uno وlong أربعة بايتات، ففي المثال تسكن قيمة int في العنوان 0، وlong في العنوان 2، وعداد التشغيلات في العنوان 6. إذا تداخلت قيمتان، تكتب إحداهما فوق الأخرى بصمت، لذا من المفيد كتابة العناوين كثوابت في أعلى الكود.
المثال، خطوة خطوة
يضع الكود القيمة 2000 في العنوان 0 والقيمة 65539 في العنوان 2، ثم يقرأ كلتيهما في متغيرين جديدين. تطبع الشاشة التسلسلية "int read back: 2000" و"long read back: 65539". القيمة 65539 تحتاج إلى أكثر من بايتين، ولهذا فهي long، ولهذا فإن put() وget() هما الطريقة السهلة لتخزينها.
Then it reads one byte at address 6, adds one and saves it with update(). A brand new EEPROM reads 255 at every address, so the sketch treats 255 as zero. The first run prints "this sketch has started 1 time". Press reset and it prints "this sketch has started 2 times", because the byte at address 6 kept its value.
#include <EEPROM.h>
const int INT_ADDRESS = 0;
const int LONG_ADDRESS = 2;
const int COUNT_ADDRESS = 6;
void setup() {
Serial.begin(9600);
Serial.println("Mokxi Uno: EEPROM");
int smallIn = 2000;
long bigIn = 65539;
EEPROM.put(INT_ADDRESS, smallIn);
EEPROM.put(LONG_ADDRESS, bigIn);
int smallOut = 0;
long bigOut = 0;
EEPROM.get(INT_ADDRESS, smallOut);
EEPROM.get(LONG_ADDRESS, bigOut);
Serial.print("int read back: ");
Serial.println(smallOut);
Serial.print("long read back: ");
Serial.println(bigOut);
byte starts = EEPROM.read(COUNT_ADDRESS);
if (starts == 255) starts = 0; // a blank EEPROM reads 255 everywhere
starts++;
EEPROM.update(COUNT_ADDRESS, starts);
Serial.print("this sketch has started ");
Serial.print(starts);
Serial.println(starts == 1 ? " time" : " times");
}إنها تتلف مع الاستخدام، فاكتب بحذر
كل بايت في EEPROM على ATmega328P مصنّف لنحو 100,000 عملية كتابة. يبدو هذا كثيرًا، لكن كودًا يكتب إلى العنوان نفسه في كل دورة للـ loop يمكن أن يستنزفه في دقائق. القراءة مجانية؛ الكتابة وحدها هي التي تتلفه.
لذا اكتب فقط عند تغيّر شيء ما. استخدم update() بدلًا من write()، لأنها تتجاوز الكتابة عندما تكون القيمة هي نفسها أصلًا؛ ودالة put() تعمل بهذه الطريقة أصلًا. احفظ الإعداد عندما يغيّره المستخدم، لا على مؤقّت. ولا تضع أبدًا كتابة إلى EEPROM داخل loop() دون شرط يحيط بها.
الكتابة بطيئة أيضًا، إذ تستغرق نحو 3.3 ميلي ثانية للبايت على Uno، لذا فإن كتابة struct كبير على عجل قد تجعل الكود يتعثّر.
على اللوحات الأخرى
الحجم يعتمد على الشريحة. يوجد في Uno وNano مساحة 1 KB، وفي Mega 2560 مساحة 4 KB. على لوحات AVR تلك تستخدم Mokxi شريحة EEPROM الخاصة بالشريحة نفسها، وتحافظ على بايتاتها عبر إعادة التعيين، كما ترى أعلاه.
ليس في ESP32 أو Pico ومعظم اللوحات الأحدث أي EEPROM على الإطلاق. مكتبة EEPROM الخاصة بها تتظاهر بوجود واحدة عبر الاحتفاظ بنسخة في ذاكرة flash. على تلك اللوحات في Mokxi، يُترجم EEPROM.h ويعمل أثناء تشغيل الكود، لكنه يحتفظ بـ 4 KB في الذاكرة RAM، لذا تُمسح عند إعادة التعيين. على ESP32 حقيقي تحتاج أيضًا إلى EEPROM.begin(size) قبل استخدامه وEEPROM.commit() للحفظ، ومكتبة Preferences هي الخيار المعتاد للكود الجديد.
جرّبه في المحرر
غيّر bigIn إلى 123456 واضغط «تشغيل». ثم خزّن قيمة float باستخدام put() في العنوان 7 واقرأها بـ get(). لاحظ أن float تحتل أربعة بايتات، لذا فالعنوان التالي الفارغ بعدها هو 11.
حوّل العدّاد إلى شيء مفيد: كود يتذكّر سطوع LED بين مرات إعادة التعيين، ويحفظه بـ update() فقط عند تغيير زر له.
أخطاء شائعة
الكتابة في كل دورة للـ loop. هذا يتلف EEPROM. اكتب فقط عند تغيّر القيمة.
تداخل العناوين. قيمة long في العنوان 2 تحتل العناوين 2 و3 و4 و5. ضع القيمة التالية في 6، لا في 3.
نسيان أن البايت الفارغ قيمته 255. في المرة الأولى التي يعمل فيها الكود، يُقرأ كل عنوان بالقيمة 255، لا 0. تحقّق من ذلك، كما يفعل المثال.
استخدام write() لرقم أكبر من 255. write() تخزّن بايتًا واحدًا وترمي الباقي. استخدم put() وget() لأي شيء أكبر.
القراءة بنوع مختلف عن الذي كتبت به. إذا استخدمت put() لقيمة int ثم get() في long، فستقرأ بايتين من شيء آخر معها.
افتح هذه الدائرة في المحرر. Arduino Uno: عدّاد بدء EEPROM، موصّلًا كما يعمل في أعلى هذه الصفحة. غيّر قطعة أو قيمة وشغّلها مرة أخرى.
افتح الدائرةالأسئلة
كم مساحة EEPROM في Arduino Uno؟
1024 بايت، في العناوين من 0 إلى 1023. وفي Nano المساحة نفسها، وفي Mega 2560 مساحة 4096.
ما الفرق بين EEPROM.write وEEPROM.put؟
write() تخزّن بايتًا واحدًا بالضبط. أما put() فتخزّن قيمة كاملة من أي نوع، باستخدام عدد البايتات الذي يحتاجه ذلك النوع، ولا تكتب إلا البايتات التي تغيّرت. اقرأها بـ read() وget() بما يطابق ذلك.
كم مرة يمكنني الكتابة في EEPROM الخاصة بـ Arduino؟
نحو 100,000 مرة لكل بايت على ATmega328P الخاص بـ Uno. القراءات لا تُحسب. استخدم update() أو put() ليتجاوز أي كتابة لن تغيّر شيئًا.
هل تنجو EEPROM من رفع كود جديد؟
نعم عادةً. الرفع يعيد كتابة ذاكرة البرنامج، لا EEPROM، إلا إذا كانت اللوحة مضبوطة على مسحها. في Mokxi، تحافظ لوحات AVR على EEPROM خاصتها عبر زر إعادة التعيين.
واصل
ابنِ هذا على أرض الواقع
افتح المحرر وغيّر قيمة وشاهد الرقم يتحرك معها. لا شيء لتثبّته ولا حاجة إلى حساب.